# 2026-07-06 初始上下文记录

## 背景

2026-07-06，项目需求发生较大变化。旧实现主要围绕“大本营答疑资产后台系统”展开，目标是把飞书资料、转写稿或答疑内容经过 AI 清洗、人工审核、标准问答沉淀后，再由人工标记为可调用内容。

新需求包定义的是 **AI 企业知识库问答系统**，核心目标已经变成：基于企业飞书知识库，为内部用户提供按知识库开放状态控制范围的 AI 问答能力，并配套完整后台。

## 资料归档

原始需求资料已经复制到：

`ai_knowledge_base_v2/source_documents/`

为了方便搜索和开发阅读，已经把 Word/Excel 抽取为 Markdown，放到：

`ai_knowledge_base_v2/extracted/`

资料包包含 PRD、SRS、数据库设计、API 设计、RAG 技术方案、后台原型说明、研发实施计划、测试用例、UAT 验收标准、部署运维手册、字段字典和权限矩阵。

## 当前理解

新系统一期以飞书知识库作为唯一知识来源。用户每次提问时，系统应该按下面流程处理：

1. 校验用户账号状态和每日聊天额度。
2. 获取全部已开放且有效的知识库。
3. 基于已开放知识库实时检索飞书内容。
4. 使用系统 Prompt、检索片段、用户问题和上下文组装最终 Prompt。
5. 调用当前启用的大模型。
6. 通过 SSE 流式返回回答。
7. 保存用户问题、AI 回答、检索知识库、检索片段、Prompt、模型、Token 消耗、耗时和状态。

## 已确定事项

- 新建 `ai_knowledge_base_v2/` 工作区，不再把 V2 文档放到旧 `docs/`。
- 保留所有上传文档作为原始需求材料。
- 抽取 Markdown 版本作为开发检索材料。
- 旧代码作为参考，不直接把旧领域模型当作 V2 领域模型。
- 给用户、团队、交接和评审看的文档统一使用中文。

## 待确认问题

- 短信验证码供应商暂未确定，开发阶段需要先做 mock 短信服务。
- 最终大模型供应商、API 地址、鉴权方式和模型名称需要确认。
- 飞书知识库的实时检索方式需要尽早做技术验证，确认当前租户权限、SpaceID、NodeID 和 API 能力是否满足需求。
- V2 是继续在当前仓库中新建应用目录，还是后续拆成独立仓库，需要在架构规划后确认。
