QuestionProject/ai_knowledge_base_v2/README.md

AI 知识库系统 V2 工作区

这个目录用于承载新需求版本：AI 企业知识库问答系统。

它和旧的 hy_qa_asset_backend/docs 目录刻意分开。旧项目的目标是“答疑资产后台系统”，核心是把大本营答疑内容清洗、审核、沉淀成可调用问答；新需求的目标是“企业飞书知识库 AI 问答系统”，核心是登录、权限、知识库、聊天会话、实时飞书检索和 RAG 问答。

目录说明

• source_documents/：保存原始需求资料，包括 PRD、SRS、API、数据库、RAG、后台原型、实施计划、测试、验收、部署、字段字典、权限矩阵。
• extracted/：从原始 Word/Excel 中抽取出的 Markdown，主要用于开发检索和上下文阅读。
• development_records/：保存新项目开发过程记录、范围决策、架构决策、实施计划和阶段性说明。
• reports/：保存评估报告、方案报告和后续技术调研结论。

当前目标

按照已上传的 AI 知识库系统需求包，重新规划和开发一版新系统：

• 用户端：手机号验证码登录、学员名单准入、AI 聊天、多会话、历史聊天、流式回答、停止生成、Markdown 渲染、开放知识库过滤。
• 管理后台：管理员登录、用户管理、学员手动添加、学员批量导入、管理员管理、知识库管理、Prompt 管理、模型管理、聊天记录、数据统计、系统配置、操作日志。
• AI/RAG：一期以飞书知识库作为唯一知识来源；每次提问实时检索；按知识库开放状态过滤；已开放知识库默认所有用户可见；组装 Prompt；调用大模型；通过 SSE 流式输出；记录 AI 请求日志。
• 一期不做：文件上传、图片理解、OCR、联网搜索、向量数据库同步、支付系统、课程系统、自动授权、多租户、多 Prompt、重新生成、编辑消息。

工作原则

• V2 先作为独立工作区推进，避免和旧项目文档混在一起。
• 上传的原始文档是 V2 的需求依据。
• 给用户、团队、交接和评审看的文档统一使用中文。
• extracted/ 里的机器抽取文档可以保留原始语言或工程化表达，优先服务开发检索。
• 旧代码只在领域边界匹配时复用，不把旧的“答疑资产审核模型”硬套到新的“开放知识库问答模型”上。

本地开发启动

阶段二已经提供本地开发编排：

cd ai_knowledge_base_v2
docker compose -f docker-compose.dev.yml up --build

默认访问地址：

• 统一入口：http://127.0.0.1:8080/
• 用户端 H5：http://127.0.0.1:8080/
• 管理后台：http://127.0.0.1:8080/login
• 后端 API：http://127.0.0.1:8080/api/health
• 用户端直连调试：http://127.0.0.1:5173/
• 管理后台直连调试：http://127.0.0.1:5174/login/
• 后端直连调试：http://127.0.0.1:8100/api/health
• MySQL：127.0.0.1:3307

开发阶段 mock 短信验证码为 123456。