Content Copilot - 内容生成系统

一个基于 AI 的智能内容生成系统，支持知识库管理、模板管理和自动内容生成。

项目结构

ContentCopilot/
├── backend/          # 后端服务 (FastAPI)
│   ├── main.py       # 主应用入口
│   ├── models.py     # 数据模型
│   ├── db.py         # 数据库操作
│   ├── vector_store.py  # 向量存储 (Qdrant)
│   ├── templates.py  # 模板管理
│   ├── generator.py  # 内容生成器
│   └── ...
├── frontend/         # 前端应用 (Vue 3)
│   ├── src/
│   │   ├── views/    # 页面组件
│   │   ├── components/  # 公共组件
│   │   └── api.js    # API 服务
│   └── ...
├── requirements.txt  # Python 依赖
├── run.py           # 后端启动脚本
└── README.md        # 本文件

环境要求

后端

• Python 3.8+
• MySQL 数据库
• Qdrant 向量数据库

前端

• Node.js 16+
• npm 或 yarn

快速开始

1. 安装后端依赖

pip install -r requirements.txt

2. 配置环境变量（可选）

后端使用以下默认配置，如需修改可设置环境变量：

3. 启动后端服务

在项目根目录运行：

python run.py

或者使用 uvicorn：

uvicorn backend.main:app --host 0.0.0.0 --port 8000 --reload

后端将运行在: http://localhost:8000

• API 文档: http://localhost:8000/docs
• 健康检查: http://localhost:8000/health

4. 安装前端依赖

cd frontend
npm install

5. 启动前端服务

npm run dev

前端将运行在: http://localhost:5173

功能特性

知识库管理

• ✅ 创建知识库（支持自定义 schema 结构）
• ✅ 动态表单添加知识条目
• ✅ CSV 批量导入
• ✅ 过滤条件搜索（支持 AND/OR 逻辑）
• ✅ 语义搜索

模板管理

• ✅ 树形结构模板编辑
• ✅ 节点规则配置
• ✅ 全局规则设置
• ✅ 导出模板结构为 Word

内容生成

• ✅ 基于模板自动生成内容
• ✅ 支持自定义创作背景
• ✅ 导出生成的 Word 文档

开发模式

后端开发

启动脚本已配置 reload=True，代码变更会自动重载。

前端开发

Vite 已配置热模块替换（HMR），代码变更会自动刷新。

生产部署

后端

# 构建
# 使用 gunicorn 或 uvicorn 部署
uvicorn backend.main:app --host 0.0.0.0 --port 8000 --workers 4

前端

cd frontend
npm run build
# 将 dist 目录内容部署到静态服务器

注意事项

1. 数据库连接: 确保 MySQL 和 Qdrant 服务已启动并可访问
2. 端口冲突: 确保 8000 和 5173 端口未被占用
3. CORS: 后端已配置允许所有来源，生产环境建议限制
4. 前端代理: 开发模式下，前端通过 Vite 代理访问后端 API

故障排查

后端无法启动

• 检查 Python 版本（需要 3.8+）
• 检查依赖是否安装完整: pip list
• 检查 MySQL 和 Qdrant 连接

前端无法连接后端

• 确认后端服务已启动
• 检查浏览器控制台错误信息
• 确认 Vite 代理配置正确

数据库连接失败

• 检查 MySQL 服务是否运行
• 验证连接信息（host, port, user, password）
• 确认数据库已创建

技术支持

如有问题，请检查：

1. 后端日志输出
2. 浏览器控制台错误
3. API 文档: http://localhost:8000/docs