Files
mnote/design/10-review

10-review 审查总览

本目录汇总当前设计与实现的偏差审查结果。四份分域报告分别覆盖 Rust kernel/web、前端编辑器与树体验、Convex/realtime/storage、次级域与设计治理。

结论

当前主线方向总体没有跑偏,但实现仍停留在“主链已切、收口未完”的状态。最需要继续收口的是:

  1. Page Aggregate 的单一真源边界
  2. tree realtime 的统一 live cache 与查询模型
  3. documents.* / tree.* / page.* 的 side effect 一致性
  4. legacy / compat / fallback 的显式退场边界

优先级摘要

P0

  • Rust page write 路由与 artifact 一致性
  • 搜索 / workspace shell / fallback 数据不要再伪装成真实主链

P1

  • pageSubtree 与正文编辑的关系需要明确
  • Sidebar 的 initial / query / tree_stream 三源选择要继续向统一 live cache 收口
  • PageAggregateSource 的 provenance 口径要和真实读链对齐
  • Convex overview 查询要避免全量扫描放大

P2

  • 继续清理或标注 legacy compat、debug host、stale mapping
  • design/90-reference 和次级参考材料保持只读、非上位来源定位

报告文件

统一判断

当前最准确的描述不是“已经完成单一真源收口”,而是:

Rust 已经持有主语义主导权,前端与 Convex 也已切到新主线,但 projection、command、realtime、fallback 仍有若干兼容态残留,需要继续按优先级收口。