# 10-review 审查总览

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

执行入口以 [顺序执行清单与验收标准](./06-execution-checklist-and-acceptance.md) 为准；`05-tree.md` 的 Resource Tree / File Tree / Page Tree、ObjectIdentity、mindmap 与 `index.md` 隔离主线已经由 `4-24` 与 `5-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 Kernel / Web 实现偏差审查](./01-rust-kernel-web-review.md)
- [前端编辑器 / 树体验实现偏差审查](./02-frontend-editor-tree-review.md)
- [Convex / Realtime / Storage 实现偏差审查](./03-convex-realtime-storage-review.md)
- [次级域与设计治理实现偏差审查](./04-secondary-domains-and-design-governance-review.md)
- [顺序执行清单与验收标准](./06-execution-checklist-and-acceptance.md)

## 统一判断

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

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