# V2 待确认问题清单

日期：2026-07-06

## 目的

这份文档记录阶段一暂时无法从现有资料中完全确定的问题。它不是阻塞开发的借口，而是为了把风险显性化：能先 mock 的先 mock，必须确认的在进入真实接入前确认。

## 必须尽早确认

| 编号 | 问题 | 影响 | 建议处理 |
| --- | --- | --- | --- |
| Q-001 | V2 是否长期放在当前仓库，还是后续拆独立仓库？ | 影响目录结构、CI/CD 和部署方式。 | 当前先在 `ai_knowledge_base_v2/` 下推进，后续如拆仓库再迁移。 |
| Q-002 | 数据库是否严格使用 MySQL 8.x？ | 影响 ORM、迁移、Docker 和部署。 | 建议按文档使用 MySQL 8.x。 |
| Q-004 | 短信验证码供应商是谁？ | 影响登录真实接入、费用和安全策略。 | 开发阶段先 mock，生产前确认供应商。 |
| Q-005 | 大模型供应商、API URL、模型名和鉴权方式是什么？ | 影响模型配置和流式输出兼容性。 | 先按 OpenAI 兼容接口设计，真实供应商确认后适配。 |
| Q-006 | 飞书知识库实时检索 API 是否满足需求？ | 是 RAG 主链路最大外部风险。 | 阶段二前做技术验证脚本。 |

## 已关闭问题

| 编号 | 问题 | 结论 |
| --- | --- | --- |
| Q-003 | 用户端技术栈是否采用 uni-app + Vue 3？ | 已确认：不用 uni-app，用户端直接使用 Vue 3 H5。 |

## 需要产品确认

| 编号 | 问题 | 影响 | 建议处理 |
| --- | --- | --- | --- |
| Q-101 | 普通用户的姓名是否必须填写？ | 首次手机号登录时可能没有姓名。 | 首次登录可默认使用手机号后四位或空姓名，后台再补。 |
| Q-102 | 每日聊天次数是自然日重置还是 24 小时窗口？ | 影响额度计算。 | 建议按 Asia/Shanghai 自然日重置。 |
| Q-103 | 删除会话是否允许用户恢复？ | 影响数据模型。 | 一期按逻辑删除、不提供恢复入口。 |
| Q-104 | 引用来源默认是否展示？ | 影响用户端回答样式。 | 建议默认后台关闭，管理员可开启。 |
| Q-105 | 知识冲突是否需要明显提示样式？ | 影响 H5 展示。 | 建议回答底部展示“存在不同知识库观点”的提示。 |

## 需要技术验证

| 编号 | 问题 | 影响 | 建议处理 |
| --- | --- | --- | --- |
| Q-201 | 飞书 SpaceID/NodeID 能否直接实时检索文本？ | 决定 FeishuKnowledgeService 实现方式。 | 做最小脚本验证。 |
| Q-202 | 飞书接口响应是否包含来源标题/链接？ | 影响引用来源展示和日志。 | 验证返回结构。 |
| Q-203 | 模型流式输出是否兼容标准 SSE？ | 影响前后端流式实现。 | 选定模型后测试。 |
| Q-204 | 停止生成如何取消上游模型请求？ | 影响 `/chat/stop` 可靠性。 | 后端记录生成任务状态，优先实现软停止，再优化硬取消。 |
| Q-205 | API Key 如何安全保存？ | 影响生产安全。 | 建议优先环境变量引用或加密存储。 |

## 暂不阻塞开发的默认假设

1. V2 暂时继续放在当前仓库的 `ai_knowledge_base_v2/` 下。
2. 后端使用 FastAPI，数据库按文档使用 MySQL 8.x。
3. 短信、飞书和大模型先做 mock provider。
4. 用户端直接使用 Vue 3 H5，手机端体验优先；后续小程序转换单独评估。
5. 后台管理端优先保证功能完整和可维护，不追求复杂视觉效果。
