2026-06-26 AI 需求文档

用户目标

• 把围绕 Mindraw AI 的这一套讨论整理成正式需求文档。
• 判断正式文档最合理的落点。
• 重新审视主项目 plan 分期，把这份真实需求纳入计划。

已完成事项

• 新增主项目正式 PRD：02-P/功能任务/ai-frame-workflow-prd.md
• 新增 m4c Round04 已确认语义契约：p.mindrawforcodex/02-P/Round04-AIFrameSemantics/01-confirmed-semantics-contract.md
• 更新 p.mindrawforcodex/02-P/Round04-AIFrameSemantics/README.md
• 更新 p.mindrawforcodex/02-P/Round04-AIFrameSemantics/00-semantics-decision-questions.md
• 更新 p.mindrawforcodex/mindrawforcodex-工作计划.md
• 更新主项目 INDEX.md，登记 AI PRD 入口
• 更新主项目 02-P/plan-progress.markdown：
• 在 .mindraw 总 phase 表中新增 Phase 3.9：AI Frame Workflow MVP
• 新增计划事项 P-20260626-ai-frame-workflow
• 补记 AI 需求基线 Progress Log
• 修正 companion / AI 活动项在计划文档中的章节结构

关键决策

• AI 需求主文档放在主项目 02-P/功能任务/，而不是只放在 p.mindrawforcodex/。
• 原因：这不是单纯 m4c 子项目需求，而是 Mindraw 主产品需求；m4c 只是其中一个外部 AI 入口。
• AI workflow 不并入 Phase 3.7 Companion App 分发就绪。
• 新增独立 Phase 3.9：AI Frame Workflow MVP。
• Phase 3.8 继续只承接外部写入协调 / document lease。
• Phase 4 继续承接 AI 生成资产的长期权威治理，不因本轮需求提前完成。

本轮冻结的 AI 核心语义

• AI 当前只读取“当前选中 Frame”。
• 无论文字还是图片结果，都默认新建 result Frame。
• 同一个 source Frame 多次提交时，每次都新建新的 result Frame。
• result Frame 默认布局在 source Frame 右侧。
• result Frame 默认标题为 AGC-年月日-时间-序号。
• result Frame 固定包含：标题、正文、图片、时间、来源 prompt、状态。
• 来源 prompt 默认显示摘要，并保留完整原文供展开。
• status 固定为 pending / running / done / failed / canceled。
• statusDetail 用于记录简短状态说明；未来如需“是否采纳”应单独设计 reviewStatus。

文件变更

• 02-P/功能任务/ai-frame-workflow-prd.md
• 02-P/plan-progress.markdown
• INDEX.md
• p.mindrawforcodex/02-P/Round04-AIFrameSemantics/01-confirmed-semantics-contract.md
• p.mindrawforcodex/02-P/Round04-AIFrameSemantics/README.md
• p.mindrawforcodex/02-P/Round04-AIFrameSemantics/00-semantics-decision-questions.md
• p.mindrawforcodex/mindrawforcodex-工作计划.md
• p.mindrawforcodex/INDEX.md

未决问题

• source/result 关系存储位置
• jobId / revision / stale / repair
• 删除、移动、复制、嵌套后的关系修复策略
• AI Frame 显式标记方式及普通 Frame 的长期保护规则

后续建议

• 下一轮优先继续收口关系层语义，再决定是否进入主项目 AI workflow 实现分期。
• 若后续要进入生产实现，应先把 Phase 3.9 的 MVP 边界、QA 口径和与 Phase 3.8 / Phase 4 的依赖拆清。