Files
mnote/bugs/07-ai/process/7-19-hermes-tool-guidance-markdown-edit-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.5 KiB

7-19 [process][bug] Hermes 工具指导仍优先 apply_block_ops 而非 markdown_edit v1

发现时间:2026-05-17

状态:[process]

关联主线:07-ai

1. 问题定义

mnote.doc.markdown_edit 已被设计为普通页面正文编辑的主路径,但 Hermes run 的工具指导仍要求简单正文编辑优先调用 mnote_doc_apply_block_ops

这导致模型策略与工具主线冲突。

2. 证据

3. 影响

  • Hermes 与 page AI fast-path 会走不同编辑工具。
  • markdown 级 search/replace 的收敛设计无法成为唯一验收口径。
  • apply_block_ops 的 revision / conflictDetectionKey 合同缺陷会被继续放大。

4. 建议修复

  • 将普通正文 search/replace、局部段落替换、全文 markdown 替换统一引导到 mnote_doc_markdown_edit
  • 仅在需要结构性块移动、资源块、复杂定位时才引导模型使用 apply_block_opsmnote.block.*
  • 同步更新 smoke:模型生成工具调用时应优先产出 mnote_doc_markdown_edit

5. 状态

已确认源码指导文本与当前设计主线不一致,尚未修复。