主题
FDS-02 · 原始需求逐层映射(一条不漏)
把原始需求(a-cdm 仓库
docs/requirements/智能会议专题.md)的每一层、每条设计原则都对到本方案,逐条给:期望 → 现状(读真实源码) → 怎么做(对应原子业务/章) → 验收。确保不漏、不跑偏。
1. 全链路六层映射
原始需求主线:
录音 → 口水稿 → 纪要 → 分析 → 待办 → PDCA 闭环。
| 层 | 期望(原始需求要点) | 现状(源码实证) | 怎么做 | 对应章 | 验收(可证伪) |
|---|---|---|---|---|---|
| 录音 | 多来源音频入项目、绑定会议元数据、原始永不删(可逆) | 有文件上传与软删;无完整"会议建档+绑定" | B1 建会议记录、绑项目/参会人、材料入库可逆 | FDS-10 | 建会议+传文件后,能按会议查到材料且可恢复软删 |
| 口水稿 | ASR→说话人分离→时间戳;忠实但啰嗦,给 AI 读;是唯一上游真相,可重跑 | 无 ASR;无精修,现直接拿原始文本喂大提示词 | B2 ASR(后置)+ B3 精修(去口语/分段/归人/长会分块) | FDS-11/12 | 精修产物分段、说话人归一;长会(>1h)中段不丢 |
| 纪要 | LLM 凝练→公司模板 Word;人可改;改后下游失效重算 | 有 docx 生成;无人审回流、无失效联动 | B4 纪要技能+模板渲染;人改→触发该会重抽 | FDS-13 | 人改纪要后,该会抽取自动标记失效并可重算 |
| 分析(insights) | 抽 决策/风险/待办/里程碑/事实,每条带 source_span 回溯原文,防幻觉 | 占位:一个大提示词一次抽全部、串行慢;quote 无校验、可瞎编;类型也不全 | B5 分类型抽取+每条带原文位置;B6 程序校验引文⊂原文 | FDS-14/15 | 随机 20 条 100% 可点回原文且校验通过;无效 0 进库 |
| 待办 | {what,who,due,depends_on,source_meeting,status};AI 产物默认 proposed,人确认才生效;跨会归并;状态机;软删可逆;站内闭环不成孤岛 | 无:无待办表/状态机/归并 | B9 待办池+状态机+跨会归并+站内待办面板;默认 proposed | FDS-18 | 派生待办默认待确认;同事项跨会并一条;状态可流转;站内面板可见可追 |
| PDCA 闭环 | Plan 拆解到人/期;Do 更新进度;Check 下次会自动注入上次进度+偏差;Act 复盘改写项目级洞察 | 无 Check 注入、无复盘特化(仅占位报告) | B11 下次开场自动注入上次待办+偏差;B12 周/月复盘+改进项完成率 | FDS-20/21 | 下次会开场自动出"上次N件:完成/没动/变了";月度出复盘+完成率<50%报警 |
2. 四条设计原则映射(原始需求 §3)
| 原则 | 期望 | 怎么落 | 章 |
|---|---|---|---|
| 单向数据流 + 版本化缓存 | 上游变→下游可感知失效;版本号+内容 hash 双键 | 唯一真相在事实库;纪要/精修变更→该会重抽+受影响项重算并需重新确认 | FDS-17 |
| 全链路可逆 | 录音/纪要/待办软删+回收站;DB 操作可整笔回滚 | 沿用项目已有可逆存储 substrate;事实库写事务、对象软删 | FDS-17/18 |
| AI 与人共写 | AI 产物默认 proposed;可重跑不破坏人已改;所有产物可反查原文杜绝黑箱 | B7 存疑派人确认;待办默认 proposed;B6 强制可回溯出处 | FDS-16/15/18 |
| 跨会聚合=项目级智能 | 单会=叶子,项目=洞察树;多消费方从洞察读不重扫 transcript | B10 跨会看板只读事实库;真实体/语义关联(非按日期) | FDS-19 |
3. 原始需求"数据/产物对照"落点(原始需求 §2)
| 原始需求产物 | 本方案落点 | 章 |
|---|---|---|
| meetings 表 / 音频 | B1 会议建档 + 材料库 | FDS-10 |
| transcript 产物 | B3 精修产物(结构化文本) | FDS-12 |
| minutes.docx + minutes.json | B4:Word 给人 + 结构化入事实库 | FDS-13 |
| 原子(decision/risk/…)+ source 回溯 | B5+B6 → 事实库条目(带出处) | FDS-14/15/17 |
| project_todos | B9 待办池 | FDS-18 |
| 跨会洞察树 / 复盘报告 | B10 看板 + B12 复盘(读事实库) | FDS-19/21 |
结论:原始需求要的"结构化数据落库 + 可追溯 + 可逆 + 跨会聚合"全部对到事实库(FDS-17)为中心的设计;不再像现状"部分在缓存、部分靠重扫"。
4. 本期范围与后置
- 后置专项:B2 录音转文字(ASR)。方式已定:直接接 API,用 Qwen-3ASR 或 fun-ASR(二选一,FDS-11 给取舍);做好前人工上传文字稿兜底,不阻塞其余。
- 不在本期:外部 IM/任务系统(飞书等)。通知与待办闭环全部站内;外部平台留可插拔出口,本期不做不依赖(见 FDS-00 〇)。
- 先做地基:B8 事实库 + B6 出处校验先行,否则后面全是空中楼阁(顺序见 FDS-30)。
- 其余层均在本期范围内,按 FDS-30 路线推进。
5. 防遗漏检查清单(对原始需求逐条打钩)
- [x] 录音多源+元数据+可逆 → B1(FDS-10)
- [x] 口水稿 ASR/分离/时间戳 → B2(FDS-11,后置)+ B3 精修(FDS-12)
- [x] 纪要模板 docx + 人审 + 改后失效 → B4(FDS-13)
- [x] 分析多类型原子 + source 回溯 + 防幻觉 → B5/B6(FDS-14/15)
- [x] 待办结构+proposed+归并+状态机+可逆+进执行系统 → B9(FDS-18)
- [x] PDCA:Plan/Do/Check 注入/Act 复盘 → B11/B12(FDS-20/21)
- [x] 原则:单向数据流/可逆/AI人共写/跨会聚合 → FDS-17/18/16/19
- [x] 业务原子技能(FDS-04)、人机协同模型(FDS-05)、基于 deer-flow 最大复用(FDS-03)、每章给"现状"(基于代码核查)
一条不漏。下一章 FDS-03:二开总览与 deer-flow 扩展点地图(复用/基于/从头 全清单)。