mnote/design/01-tree-first-graph-kernel/process/1-2-tree-first-graph-product-vision-progress-v1.md

1-2 [process] Tree-First Graph 产品愿景进展评估 v1

更新时间：2026-05-19

目的：对照原始产品愿景（Wolai 编辑体验 + VSCode 文件树 + simple-mindmap + OnlyOffice + AI 操作一切），评估当前代码在 1.0 MVP 后的实际进展和剩余的缺口。

关联：

• design/01-05-current-priority-overview.md
• design/10-review/done/11-current-full-architecture-review-v1.md
• CURRENT_ARCHITECTURE.md
• design/11-wolai/help-center-reference.md — Wolai 帮助中心功能对照基准

1. 一句话结论

核心链路已经全部立住，但 AI 对思维导图和 Office 文件的操作是明确的功能缺口，其余模块处于"已可用、收口中"状态。

---

2. 各模块状态

2.1 Wolai 编辑体验 + UI — ✅ 收口中

架构层

子能力	状态	关键证据
默认编辑器已切到 leptos-tiptap island	DONE	design/05-editor-mainline/done/5-4-leptos-tiptap-mainline-correction-v1.md
Page Aggregate 读链已切到 Rust projection	DONE	design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md
文档页入口优先消费 Rust page-aggregate 快照	DONE	CURRENT_ARCHITECTURE.md §2.5
前端壳已切换到 Rust SSR（:3000）	DONE	CURRENT_ARCHITECTURE.md §3.1
Page Aggregate 写链（标题/正文/设置）smoke 通过	DONE	scripts/task110-*, task-page-aggregate-*-smoke.js
页面设置运行时语义 / 页头回流 / AI 设置面未完全闭环	PROCESS	design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md
Wolai UI 行为持续对齐	PROCESS	design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md
documents.content 仍是兼容后备而非唯一真源	PARTIAL	CURRENT_ARCHITECTURE.md §3.2

基础块类型覆盖（对照 Wolai 帮助中心）

块类型	Wolai	mnote	备注
文本	✅	✅
标题 H1/H2/H3	✅	✅
无序列表	✅	✅
有序列表	✅	✅
待办列表（checkbox）	✅	✅
折叠列表（toggle）	✅	❌	缺口
页面块（subpage）	✅	Partial	Tiptap 嵌入页
引述文字（blockquote）	✅	✅
着重文字（callout）	✅	❌	缺口
代码片段	✅	✅
数学公式	✅	✅	LaTeX
分割线	✅	✅

进阶块类型覆盖（仅基础级引用）

块类型	Wolai	mnote	备注
简单表格	✅	✅	Tiptap table
数据表格（database）	✅	❌	缺口，类似 Notion DB
统计图表	✅	❌
Mermaid 绘图	✅	❌
思维导图	✅	✅	Phase 6 leptos-mindmap
页面目录（TOC）	✅	❌
网址书签	✅	✅
嵌入第三方应用	✅	Partial	OnlyOffice 已接，其他待定
文件附件	✅	✅	OnlyOffice adapter
按钮 / 进度条 / 仪表数字	✅	❌	基础缺口

基础操作覆盖

操作	Wolai	mnote	备注
基本编辑（输入/换行/拖拽/缩进）	✅	✅
/ 快捷命令菜单	✅	✅	Tiptap slash command
模板创建页面	✅	❌	缺口
页面选项/设置	✅	✅	Page Aggregate 写链已通
页面关系图	✅	❌	缺口
全局搜索（Ctrl+P）	✅	✅	Search modal smoke 通过
导入/导出	✅	❌	缺口（Local/Cloud 桥接仅 P3）
垃圾桶	✅	✅	tree.resource.* 实现
回收站恢复位置+reveal	✅	✅	已实现（design/04-tree-domain/process/4-28）
个人设置（主题/语言）	✅	Partial	暗色模式有，设置 UI 不全
图标/表情选择器	✅	Partial
快捷方式/星标栏	✅	❌	缺口

完整对照表见 design/11-wolai/help-center-reference.md。

2.2 VSCode 文件树 — ✅ 大部完成

子能力	状态	关键证据
VSCode Explorer 对标设计	DONE	design/04-tree-domain/done/4-20-vscode-explorer-file-tree-alignment-v1.md
三层模型（Resource → File → Page Tree）固定	DONE	design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md
tree.* 命令切流（Stage 2）	DONE	design/04-tree-domain/done/4-6-tree-command-protocol-cutover-stage2-v1.md
文件树资源行与页面命令分离	DONE	bugs/04-tree-domain/done/4-46-filetree-resource-row-document-command-leak-v1.md
垃圾箱恢复位置记录 + reveal/focus	DONE	design/04-tree-domain/process/4-28-trash-restore-location-reveal-focus-v1.md §2
资源生命周期命令 tree.resource.*（核心 cutover 已完成，局部尾项由后续文档承接）	DONE/PARTIAL tails	design/04-tree-domain/done/4-27-resource-lifecycle-command-cutover-v1.md，尾项见 4-28 / 4-34 / 4-44 / 4-45
双浏览器 no-refresh（页面 + 文件 + 垃圾箱实时同步）	PROCESS	design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md
Local/Cloud 桥接	P3 CANDIDATE	design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md

2.3 Simple-mindmap — ✅ 编辑器完成，AI 未覆盖

子能力	状态	关键证据
Phase 6 口径修正（Rust kernel + simple-mind-map adapter）	DONE	design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md §2
Leptos UI shell	DONE	git c64487c6
即时显示修复	DONE	git 3be102a4
Filetree 切换稳定	DONE	git b300562a
KMind 级详细验收	DONE	design/06-mindmap/done/6-mindmap-phase6-kmind-parity-detail-checklist-v1.md
AI 读写思维导图（增删改节点）	GAP	Hermes manifest 无 mnote.mindmap.* 工具

2.4 OnlyOffice — ✅ 打开/链路完成，AI 未覆盖

子能力	状态	关键证据
adapter-onlyoffice crate	DONE	rust/crates/adapter-onlyoffice/
Rust 路由	DONE	rust/crates/mnote-web/src/routes/onlyoffice.rs
Docker 部署	DONE	infra/onlyoffice/docker-compose.yml
附件打开链路修复	DONE	git 7bd0c9e9
Kernel 工具（session/签名/proxy/callback/forcesave）	DONE	core-protocol/src/tool.rs ONLYOFFICE_TOOL_*
AI 读写 Office 文件内容（.docx/.xlsx/.pptx）	GAP	无 mnote.office.* Hermes 工具

2.5 AI 操作文档 — ✅ 主线已完成

子能力	状态	关键证据
在线文档 markdown 级读写	DONE	mnote.doc.markdown_edit + mnote.doc.fetch，smoke 验证通过
本地 .md 文件读/写	DONE/PARTIAL	mnote.doc.fetch 已支持本地文件，写侧仍在过渡（design/03-rust-web/process/3-13）
结构性块操作（移动/插入/删除）	DONE	mnote.block.* 工具群，Hermes 完整 smoke
工具权限 / dryRun / 幂等 / revision 约束	DONE	bugs/07-ai/done/7-22 ~ 7-30
ACP runtime + UI	DONE	design/07-ai/done/7-25-acp-session-runtime-enhancement-plan-v1.md
Phase C（流式 apply / review session）	FROZEN	design/07-ai/process/7-14 — 当前不实施

---

3. 缺口汇总

缺口	分类	说明
AI 操作思维导图	功能缺失	Hermes 13 个工具没有 mindmap 操作。AI 无法在导图中增删改节点
AI 操作 Office 文件	功能缺失	无 mnote.office.* 工具。OnlyOffice 可手动编辑，但 AI 无法读写 .docx/.xlsx/.pptx 内容

用户确认 "日记" 即当前主编辑区（Tiptap / .md 文件），不构成独立缺口。

---

4. 当前架构收口主线（已完成进度 ~70%）

第一优先：Page Aggregate 单一真源        ████████████░░░░░░  70%
  └─ EditorBlockDocument 原生落库         ██████░░░░░░░░░░░░  40%
  └─ 页面设置运行时闭环                   ████████░░░░░░░░░░  50%
  └─ AI 写入链走统一 markdown_edit 口径   ██████████████░░░░  80%

第二优先：Tree Command Cutover            ████████████░░░░░░  70%
  └─ tree.resource.* 命令收口             ██████████░░░░░░░░  60%
  └─ 资源 rename 补全                     ████░░░░░░░░░░░░░░  30%

第三优先：Tree Realtime Event Stream      ██████████████░░░░  80%
  └─ WS 主链已上线 (57ec8322)             ████████████████░░  90%
  └─ 双浏览器 no-refresh 统一 live cache  ██████░░░░░░░░░░░░  45%
  └─ SSE fallback / 补偿链减少            ██████████░░░░░░░░  60%

---

5. 后续方向建议

1. 继续推进三条架构收口主线（Page Aggregate → Tree Command → Tree Realtime），这是当前最优先的工程投入点。
2. 确认两个功能缺口是否需要本轮填补：AI 操作思维导图和 Office 文件。如果需要在 MVP 后立即补齐，需要为 mnote.mindmap.* 和 mnote.office.* 工具做设计；如果可推迟，则当前架构收口完成后再说。
3. Local/Cloud 桥接（P3 candidate）和 Phase C AI（流式 apply）属于明确的"下一轮"范围，不在此轮冲刺内。