Files
mnote/bugs/07-ai/process/7-18-ai-markdown-edit-phase-state-contract-drift-v1.md
T
lix-2026 3311bd0366 chore: document architecture gaps and add dev hot reload
- add npm dev:hot wrapper using cargo-watch and page reload polling

- add mnote-web dev hot reload endpoint and coverage

- record current architecture review and tracked bug findings across realtime, tree, editor, and AI runtimes

Verification:

- node scripts/task-dev-hot-plan-test.js

- node --check scripts/dev-hot.js

- cargo test -p mnote-web dev_hot -- --nocapture
2026-05-17 23:09:56 +08:00

1.6 KiB
Raw Blame 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. 状态

已确认设计口径与源码使用状态不一致,尚未完成统一。