Files
mnote/bugs/07-ai/process/7-24-markdown-edit-online-write-does-not-use-final-markdown-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.7 KiB

7-24 [process][bug] 在线 markdown_edit 写回不以最终 Markdown 为真源 v1

发现时间:2026-05-17

状态:[process]

关联主线:07-ai

1. 问题定义

在线 Convex 文档的 mnote.doc.markdown_edit 先在 md 字符串上顺序应用 search/replace,但写回时没有用最终 md 生成新的文档真相,而是重新读取原始 blocks,并用原始 operations 反推 apply_block_ops

因此 markdown 层已经算出的最终结果不一定能被忠实落库。

2. 证据

  • doc.rsmd 上执行 search/replace。
  • doc.rs 写回前重新读取 aggregate / blocks。
  • doc.rs 使用原始 operations 构造 block ops,而不是解析最终 md

3. 影响

  • 跨块替换、全文替换、标题 / 列表格式变化可能在 markdown 层成功,但无法正确转换成 block ops。
  • 部分失败仍可能返回成功写入,用户看到的正文与工具返回摘要不一致。
  • 该问题与 7-17 的同块多操作覆盖同源,但影响面更宽。

4. 建议修复

  • 在线分支应明确选择一种真源:要么最终 md 可被解析并完整生成 EditorBlockDocument,要么限制 markdown_edit 只支持可安全映射的单块操作。
  • 对 full_content、跨块 search/replace、列表/标题变更增加回读一致性测试。
  • route 成功条件必须从“operationsApplied > 0”提升为“Page Aggregate 回读等于预期最终 markdown”。

5. 状态

已确认写回层没有使用最终 markdown 真相,尚未修复。