2026-06-26 AI需求语义-04

用户目标

• 最终锁定 AI 结果 frame 中 status 字段的设计方案。

本轮关键决策

1. status 固定采用：

• pending
• running
• done
• failed
• canceled

1. 建议状态流固定为：

• pending -> running -> done / failed / canceled

1. 增加配套字段 statusDetail，用于保存简短细节说明，例如：

• 等待 MCP
• 模型超时
• 图片生成失败
• 用户取消

1. 若未来需要表达“用户是否采纳结果”，单独设计 reviewStatus，不混入 status。

累积后的 AI 语义基线

• 当前选中 frame 是输入源 / 上下文源。
• AI 默认不改写当前选中 frame。
• 无论文字还是图片，AI 都默认新建结果 frame。
• 同一个源 frame 多次提交时，每次都新建一个结果 frame。
• 结果 frame 默认布局固定在源 frame 右侧。
• 后续允许在设置中配置布局策略：右侧 / 下方 / 自动排布。
• 结果 frame 固定包含：标题、正文、图片、时间、来源 prompt、状态。
• AI 当前只读取“当前选中 frame”。
• 结果 frame 默认标题固定为：AGC-年月日-时间-序号。
• 来源 prompt 默认显示摘要，并提供完整原文的可展开查看。
• status 固定为：pending / running / done / failed / canceled。
• statusDetail 用于保存简短状态说明。
• 若未来需要表达“是否被用户采纳”，应单独使用 reviewStatus。

文件变更

• 新增会话记录：.codex-sessionhistory/2026-06-26-AI需求语义-04.md

未决问题

• AI 结果 frame 的核心语义已基本闭合，下一步应进入正式契约文档整理。

后续建议

• 下一轮把以上语义整理成正式需求契约，落到主项目或 Round04 语义文档，而不是继续停留在零散会话结论。