Files
mnote/bugs/07-ai/process/7-18-ai-markdown-edit-phase-state-contract-drift-v1.md
T

36 lines
1.6 KiB
Markdown
Raw Normal View History

# 7-18 [process][bug] AI markdown_edit 阶段状态合同漂移 v1
> 发现时间:2026-05-17
>
> 状态:`[process]`
>
> 关联主线:`07-ai`
## 1. 问题定义
当前仓库的顶层协作口径仍描述 AI 侧“当前只做 Phase APhase B 退役 `local_rule` planner 仍未实施”,但 `design/07-ai/process/7-14-online-local-ai-markdown-editing-convergence-v1.md` 与源码已经把 `mnote.doc.markdown_edit` 推到实际运行链路。
这造成阶段合同漂移:文档与实现同时在表达“仍处 Phase A”和“Phase A / B 已开始切主”两种状态。
## 2. 影响
- 后续开发者无法判断 `page_ai_workflow` 是否应继续保留 `local_rule` 快路径。
- AI 编辑验收标准会混乱:到底验 `apply_block_ops`,还是验 `markdown_edit` 回读一致性。
- 新功能容易继续堆到过渡路径,而不是收敛到正式工具合同。
## 3. 证据
- `rust/crates/mnote-web/src/routes/page_ai_workflow.rs` 已直接调用 `doc::doc_markdown_edit`
- `design/07-ai/process/7-14-online-local-ai-markdown-editing-convergence-v1.md` 已记录在线 / 本地 markdown 编辑收敛方向。
- 根目录协作口径仍强调 Phase B 退役 `local_rule` planner 属于后续项。
## 4. 建议修复
- 明确当前真实阶段:`markdown_edit` 是否已经是页面 AI 简单编辑主路径。
- 若已切主,应把 `page_ai_workflow`、Hermes guidance、manifest 和 smoke 都同步到该口径。
- 若未切主,应限制 `markdown_edit` 的 runtime 使用面,并把设计稿状态回退为实验态。
## 5. 状态
已确认设计口径与源码使用状态不一致,尚未完成统一。