feat: 初始化考培练系统项目
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
This commit is contained in:
116
知识库/安装指南.md
Normal file
116
知识库/安装指南.md
Normal file
@@ -0,0 +1,116 @@
|
||||
# 快速设置指南
|
||||
|
||||
## 1. 配置Coze API认证
|
||||
|
||||
### 步骤1: 创建本地配置文件
|
||||
复制示例配置文件:
|
||||
|
||||
```bash
|
||||
cd coze-chat-backend
|
||||
cp local_config.py.example local_config.py
|
||||
```
|
||||
|
||||
### 步骤2: 配置API Token
|
||||
编辑 `local_config.py` 文件,配置您的PAT Token:
|
||||
|
||||
```python
|
||||
# Coze API 配置
|
||||
COZE_API_BASE = "https://api.coze.cn"
|
||||
COZE_WORKSPACE_ID = "7474971491470688296"
|
||||
COZE_API_TOKEN = "your_pat_token_here" # 替换为您的PAT Token
|
||||
```
|
||||
|
||||
## 2. 启动系统
|
||||
|
||||
### 方式1: 使用启动脚本 (推荐)
|
||||
```bash
|
||||
./start.sh
|
||||
```
|
||||
|
||||
### 方式2: 手动启动
|
||||
|
||||
**启动后端:**
|
||||
```bash
|
||||
cd coze-chat-backend
|
||||
python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
pip install -r requirements.txt
|
||||
python main.py
|
||||
```
|
||||
|
||||
> 网络与代理(重要):若公司网络有 HTTP/HTTPS 代理,可能导致访问 `https://api.coze.cn` 失败(如 `500 Internal Privoxy Error`)。建议在启动前执行:
|
||||
|
||||
```bash
|
||||
unset http_proxy https_proxy all_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY
|
||||
export NO_PROXY=localhost,127.0.0.1,api.coze.cn,.coze.cn
|
||||
```
|
||||
|
||||
`./start.sh` 已默认设置上述环境,手动启动时请自行执行。
|
||||
|
||||
**启动前端:**
|
||||
```bash
|
||||
cd coze-chat-frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## 3. 访问系统
|
||||
|
||||
- **前端页面**: http://localhost:3001
|
||||
- **后端API**: http://localhost:8000
|
||||
- **API文档**: http://localhost:8000/docs
|
||||
|
||||
## 4. 功能说明
|
||||
|
||||
### 首页 - 智能体列表
|
||||
- 自动加载工作空间 `7474971491470688296` 内的所有智能体
|
||||
- 点击任意智能体卡片进入聊天界面
|
||||
- 显示智能体名称、描述和头像
|
||||
|
||||
### 聊天页面 - 对话界面
|
||||
- 实时流式聊天对话
|
||||
- 消息气泡展示
|
||||
- 支持对话中断
|
||||
- 显示智能体建议问题
|
||||
|
||||
## 5. 故障排除
|
||||
|
||||
### 问题1: 后端启动失败
|
||||
```
|
||||
检查 local_config.py 文件配置是否正确
|
||||
确认PAT Token有效
|
||||
查看终端错误信息
|
||||
```
|
||||
|
||||
### 问题2: 前端API调用失败
|
||||
```
|
||||
确认后端服务已启动 (http://localhost:8000)
|
||||
检查浏览器控制台错误信息
|
||||
确认 utils/api.ts 中的API地址配置
|
||||
```
|
||||
|
||||
### 问题3: 智能体列表为空
|
||||
```
|
||||
确认工作空间ID正确
|
||||
检查Coze API认证是否成功
|
||||
查看后端日志中的详细错误信息
|
||||
```
|
||||
|
||||
## 6. 开发说明
|
||||
|
||||
### 添加新功能
|
||||
1. 后端API: 在 `coze-chat-backend/main.py` 中添加新接口
|
||||
2. 前端调用: 在 `coze-chat-frontend/src/server/api.ts` 中添加API方法
|
||||
3. 状态管理: 在相应的Store中添加业务逻辑
|
||||
|
||||
### 自定义样式
|
||||
- 主页样式: `coze-chat-frontend/src/pages/Home/index.scss`
|
||||
- 聊天界面: `coze-chat-frontend/src/components/MessageList/index.scss`
|
||||
|
||||
### Docker部署
|
||||
```bash
|
||||
cd coze-chat-backend
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
前端需要单独部署,或者构建静态文件后配置nginx。
|
||||
Reference in New Issue
Block a user