Files
mnote/design/10-review
lix-2026 e9188716e6 docs(design): 固化 3000 主文档壳刷新验收口径
明确 File Tree / Page Tree 的 no-refresh 验收必须在 3000 /documents/<id> 主文档壳执行,不能再用 3001/Next 或 /tree debug route 替代。

补充页面 tree.node.create、页面 delete/purge、页面内 mindmap create 三条链路的独立验收;mindmap create 按 /api/mindmap/<doc>/<mindmap> 资产写入链路单独验证。

记录 task426 主入口 smoke 作为后续回归入口。
2026-05-14 10:18:31 +08:00
..

10-review 审查总览

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

执行入口以 顺序执行清单与验收标准 为准;05-tree.md 的 Resource Tree / File Tree / Page Tree、ObjectIdentity、mindmap 与 index.md 隔离主线已经由 4-245-12 承接到 done/,后续只保留防回归验证。

结论

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

  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 仍有若干兼容态残留,需要继续按优先级收口。