# BorderlessClassAi

**Repository Path**: snowh1te/BorderlessClassAi

## Basic Information

- **Project Name**: BorderlessClassAi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-27
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 无界课堂（BorderlessClass AI）
---

## 目录

1. [简介](#1-简介)
2. [安装部署](#2-安装部署)
3. [快速开始](#3-快速开始)
4. [管理后台使用指南](#4-管理后台使用指南)
5. [提示词生成器使用指南](#5-提示词生成器使用指南)
6. [配置说明](#6-配置说明)
7. [常见问题](#7-常见问题)

---

## 1. 简介

### 1.1 项目介绍

**无界课堂（BorderlessClass AI）** 是一款专为学校课堂教学场景设计的AI教学助手平台。

### 1.2 核心特性

- **零门槛使用**：无需学生账号登录，直接打开即可使用
- **多Key负载均衡**：支持配置多个API Key，解决并发卡顿问题
- **提示词即服务**：内置提示词生成器，快速创建学科专属AI助手
- **一键部署**：搭配phpstudy可在局域网内快速部署
- **可视化配置**：Web管理后台，配置一目了然

### 1.3 系统要求

| 项目 | 要求 |
|-----|------|
| PHP版本 | PHP 7.0 或更高版本 |
| Web服务器 | Apache/Nginx（phpstudy集成） |
| 扩展要求 | cURL扩展（用于API请求） |
| 操作系统 | Windows / Linux 均可 |

---

## 2. 安装部署

### 2.1 方式一：phpstudy一键部署（推荐）

#### 步骤1：下载phpstudy

访问 [phpstudy官网](https://www.xp.cn/) 下载安装包并安装。

#### 步骤2：配置网站

1. 打开phpstudy，点击"网站"→"创建网站"
2. 设置网站目录，指向项目文件夹
3. 设置域名（如 classroom.local）
4. 选择PHP版本（建议PHP 7.4或8.0）

#### 步骤3：导入项目文件

将本项目所有文件（api.php、admin.php、config.json等）复制到网站根目录。

#### 步骤4：设置目录权限

确保 `config.json` 文件具有写入权限（Windows下一般无需特殊设置）。

#### 步骤5：启动服务

在phpstudy中启动Apache/Nginx服务，访问配置的域名即可。

### 2.2 方式二：传统服务器部署

#### Linux (Apache) 示例

```bash
# 1. 安装Apache和PHP
sudo apt update
sudo apt install apache2 php php-curl

# 2. 复制项目文件到/var/www/html/
sudo cp -r borderless-class-ai /var/www/html/

# 3. 设置权限
sudo chown -R www-data:www-data /var/www/html/borderless-class-ai
sudo chmod -R 755 /var/www/html/borderless-class-ai

# 4. 确保config.json可写
sudo chmod 666 /var/www/html/borderless-class-ai/config.json

# 5. 重启Apache
sudo systemctl restart apache2
```

#### Nginx 配置示例

```nginx
server {
    listen 80;
    server_name your-domain.com;
    root /var/www/html/borderless-class-ai;
    index index.html index.php;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
```

---

## 3. 快速开始

### 3.1 首次配置

1. 打开浏览器，访问 `http://你的域名/admin.php`
2. 默认密码：`admin123`
3. 登录后进入管理后台

### 3.2 配置API

在管理后台"API配置"标签页中填写：

| 配置项 | 说明 | 示例 |
|-------|------|------|
| API地址 | LLM的BaseURL | `https://api.openai.com/v1/chat/completions` |
| API Keys | 支持多行多Key | `sk-xxxxx`（每行一个） |
| 模型名称 | 使用的模型 | `gpt-3.5-turbo` |
| 最大Token | 单次回复最大字数 | `400` |
| 温度值 | 生成随机性（0-1） | `0.7` |

### 3.3 自定义界面

在"界面配置"标签页中设置：

- 页面标题、副标题
- Logo图标（支持emoji）
- 主题颜色
- 背景颜色
- 初始欢迎语
- 输入框占位符
- 快捷按钮

### 3.4 开始使用

保存配置后，访问 `http://你的域名/index.html` 即可开始使用。

---

## 4. 管理后台使用指南

### 4.1 登录管理后台

访问地址：`http://你的域名/admin.php`

初始密码：`admin123`（可在配置中修改）

### 4.2 基础配置

| 配置项 | 说明 |
|-------|------|
| 页面标题 | 浏览器标签和主标题显示的文字 |
| 副标题 | 主标题下方的说明文字 |
| Logo图标 | 头像区域显示的emoji图标 |
| 主题色 | 按钮、链接等元素的主色调 |

### 4.3 API配置

**API地址格式**：
- OpenAI：`https://api.openai.com/v1/chat/completions`
- NVIDIA：`https://integrate.api.nvidia.com/v1/chat/completions`
- 硅基流动：`https://api.siliconflow.cn/v1/chat/completions`
- 其他兼容API请参考服务商文档

**多Key配置**：
每行填写一个Key，支持配置多个Key实现负载均衡：
```
sk-key-1
sk-key-2
sk-key-3
```

### 4.4 系统提示词配置

系统提示词是AI角色设定的核心，定义AI的身份、行为规则和引导方式。

建议使用"提示词生成器"功能快速生成规范提示词。

### 4.5 快捷按钮配置

快捷按钮可以帮助学生快速提问，格式为：
- 按钮文字：显示在按钮上的文字
- 按钮问题：点击后自动发送的问题

### 4.6 修改密码

在页面底部可修改管理员密码。

---

## 5. 提示词生成器使用指南

### 5.1 功能入口

在管理后台点击"提示词生成器"标签。

### 5.2 使用步骤

1. 输入教学主题（如"春天的植物"）
2. 点击"生成提示词"按钮
3. 等待AI按照规范生成提示词
4. 复制生成的提示词
5. 粘贴到"系统提示词"配置项中
6. 保存配置

### 5.3 生成规范

生成的提示词严格遵循五段式结构：

| 部分 | 说明 |
|-----|------|
| **角色设定** | 明确AI扮演的身份和定位 |
| **核心引导内容** | 定义AI需要覆盖的知识点（3-5个） |
| **教学方法** | 规定具体的引导方式 |
| **示例对话** | 提供1-3组标准问答示例 |
| **禁令** | 明确AI不可做的事情 |

### 5.4 使用示例

**场景：创建"植物朋友写作助手"**

1. 输入主题：`植物朋友写作助手`
2. 生成后得到完整的教学提示词
3. 配置到系统中
4. 学生即可与AI"植物专家"对话学习

---

## 6. 配置说明

### 6.1 配置文件结构（config.json）

```json
{
    "api": {
        "url": "API地址",
        "keys": ["Key1", "Key2"],
        "model": "模型名称",
        "max_tokens": 400,
        "temperature": 0.7
    },
    "system_prompt": "系统提示词内容",
    "ui": {
        "title": "页面标题",
        "subtitle": "副标题",
        "logo_icon": "🤗",
        "primary_color": "#BF4E0F",
        "page_background_color": "#e8f5e9",
        "initial_message": "初始欢迎语",
        "placeholder": "输入框占位符",
        "quick_buttons": [
            {"text": "按钮文字", "question": "对应问题"}
        ],
        "footer_text": "页脚文字"
    },
    "admin_password": "admin123",
    "last_updated": 1234567890
}
```

### 6.2 各配置项详解

#### API相关

| 配置项 | 说明 | 推荐值 |
|-------|------|-------|
| max_tokens | 单次回复最大Token数，影响回复长度 | 300-800 |
| temperature | 随机性参数，越低越稳定 | 0.5-0.8 |

#### 界面相关

| 配置项 | 说明 |
|-------|------|
| primary_color | 主题色，影响按钮、链接等 |
| page_background_color | 页面背景色 |
| icon_background_color | 图标背景色 |

### 6.3 安全建议

1. **修改默认密码**：首次使用后立即修改admin密码
2. **限制API Key权限**：尽量使用只读权限的API Key
3. **内网访问**：建议仅在内网环境部署使用

---

## 7. 常见问题

### 7.1 页面显示"加载配置中..."

**原因**：无法获取api_config.php的配置

**解决方法**：
1. 检查Apache/Nginx是否正常运行
2. 检查config.json是否存在且格式正确
3. 检查php是否有读取文件的权限

### 7.2 发送消息后无响应或显示错误

**原因**：API配置错误或网络问题

**解决方法**：
1. 检查API地址是否正确
2. 检查API Key是否有效
3. 检查服务器网络能否访问API服务器
4. 查看curl_error.log日志文件

### 7.3 响应很慢或超时

**原因**：API服务器响应慢或网络延迟

**解决方法**：
1. 配置多个API Key实现负载均衡
2. 降低max_tokens值
3. 检查服务器网络状况

### 7.4 管理后台登录失败

**原因**：密码错误或session问题

**解决方法**：
1. 确认密码是否正确（默认admin123）
2. 清除浏览器缓存后重试
3. 检查phpstudy中的PHP版本

### 7.5 提示词生成失败

**原因**：API配置不完整或超出配额

**解决方法**：
1. 确保API配置正确
2. 检查API Key是否还有配额
3. 查看错误信息针对性解决

### 7.6 流式输出不工作

**原因**：服务器缓冲设置问题

**解决方法**：
- Nginx服务器确保配置了 `X-Accel-Buffering: no`
- Apache服务器确保没有启用mod_deflate

---

## 附录

### A. 技术支持

如遇问题，请检查：
1. phpstudy是否正常启动
2. config.json是否可读可写
3. PHP cURL扩展是否启用

### B. 更新日志

**v2.0 (2026年4月)**
- 初始版本发布
- 支持多Key负载均衡
- 内置提示词生成器
- 可视化配置管理后台

---

*无界课堂（BorderlessClass AI）- 让AI教学触手可及*