chore: land tree view-state, vault, Pi module split, and repo hygiene

Persist PageTree expand state via control-plane view-state and align
chevron/DOM with restored expansion; keep Sidex-style shallow page-tree
scan and drop the unused recursive scanner that only added cargo noise.

Add password vault workbench routes/runtime/skill/CLI, split page_ai_pi
into a module package, and retire Hermes/ACP/OpenHub recycle + root
harness evidence from the index while gitignoring recycle and local
diag dumps.

Archive superseded design/bugs docs under old/, point architecture at
ARCHITECTURE.md, and refresh smokes for Pi S1–S7, vault, and editor
regressions so the working tree can stay clean.
This commit is contained in:
Agent Board
2026-07-21 05:13:05 +08:00
parent 6f9c7d3b58
commit b798f628ee
264 changed files with 17480 additions and 17314 deletions
@@ -2,7 +2,7 @@
> 更新时间:2026-04-16
>
> 当前状态:`reference`。本文保留 kernel 分阶段全景与历史状态口径;当前执行顺序以 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md` 为准。
> 当前状态:`reference`。本文保留 kernel 分阶段全景与历史状态口径;当前执行顺序以 `design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md` 为准。
>
> 基于以下实际状态重写:
> - 当前未提交代码
@@ -27,7 +27,7 @@
> 说明(2026-04-22):
> 这份清单仍保留为 `Kernel Phase` 全景参考,但当前第一优先级已经转移到
> `Page Aggregate`、`tree command cutover`、`tree realtime event stream`。
> 当前执行优先级请先看 `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`。
> 当前执行优先级请先看 `/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`。
---
@@ -8,7 +8,7 @@
>
> 关联:
> - `design/01-05-current-priority-overview.md`
> - `design/10-review/done/11-current-full-architecture-review-v1.md`
> - `design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`
> - `CURRENT_ARCHITECTURE.md`
> - `design/11-wolai/help-center-reference.md` — Wolai 帮助中心功能对照基准
@@ -4,13 +4,12 @@
>
> 当前状态:`reference`
>
> 归档说明(2026-05-22):本文保留下一阶段路线推导;当前可执行入口已收敛到 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`,不再从本文直接派发实现。
> 归档说明(2026-07-19):本文保留下一阶段路线推导;当前可执行入口已收敛到 `design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`,不再从本文直接派发实现。
>
> 上位依据:
> - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/done/1-3-current-priority-execution-checklist-v1.md`
> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
> - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/ARCHITECTURE.md``CURRENT_ARCHITECTURE.md` 为兼容指针)
>
> 目标:把当前已经推进到混合态的主线,收口成一条更清晰的下一阶段路线,避免“功能继续堆、底座继续散”的问题。
@@ -2,10 +2,10 @@
> 更新时间:2026-04-22
>
> 当前状态:`reference`。本文是 tree-first graph kernel 的长期架构边界,不是当前可直接执行的 checklist;执行入口见 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`。
> 当前状态:`reference`。本文是 tree-first graph kernel 的长期架构边界,不是当前可直接执行的 checklist;执行入口见 `design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`。
>
> 当前优先级入口:
> - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`
> - `/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`
>
> 关联文档:
> - `/mnt/Data1T/mnote/design/03-rust-web/reference/3-rust-web-long-term-architecture-v1.md`
@@ -7,8 +7,7 @@
> 目标:在接受 Turso / libSQL Beta 与云服务风险的前提下,把 MNote 当前 Rust SQLite 控制面切换到 Turso / libSQL 后端,降低多个进程直接写同一个 SQLite 文件带来的损坏风险,并为后续云同步、审计、权限和 AI 控制面维护提供更稳的存储边界。
>
> 上位依据:
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/ARCHITECTURE.md``CURRENT_ARCHITECTURE.md` 为兼容指针)
> - `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md`
> - `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md`
@@ -2,7 +2,7 @@
> 更新时间:2026-05-09
>
> 当前状态:`reference`。本文保留 Rust Web 长期架构边界;当前实现队列以 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md` 和对应 `done/` 证据为准。
> 当前状态:`reference`。本文保留 Rust Web 长期架构边界;当前实现队列以 `design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md` 和对应 `done/` 证据为准。
>
> 相关文档:
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -5,7 +5,7 @@
> 当前状态:`reference`。本文是参考实现采用矩阵,不是当前执行 checklist;具体实现任务应拆到对应 domain 的 process/done 文档。
>
> 关联背景:
> - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/ARCHITECTURE.md``CURRENT_ARCHITECTURE.md` 为兼容指针)
> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md`
> - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-6-page-aggregate-alignment-checklist-v1.md`
> - `/mnt/Data1T/mnote/design/old/07-ai/process/7-14-local-first-ai-markdown-editing-convergence-v1.md`
@@ -4,14 +4,14 @@
>
> 当前状态:`done`
>
> 2026-07-03 口径回正:当前 runtime 已回到 OpenHub / native agent + LightRAG + Turso/libSQL。本文重新作为当前默认 LightRAG provider 的 DOCX 引用与定位合同基线;此前 `7-68 OpenHub + WeKnora + MNote Page AI 深度融合` 中将 WeKnora 设为默认 provider 的口径已标记 stale
> 2026-07-19 口径回正:当前 runtime 是 Pi Rust Page AI + LightRAG + Turso/libSQL。本文保留为当前默认 LightRAG provider 的 DOCX 引用与定位合同基线;WeKnora 仅为历史/备用边界
>
> Owner07-ai / knowledge-rag / 03-rust-web / office-preview
>
> 关联:
> - `design/07-ai/done/7-50-lightrag-knowledge-rag-provider-v1.md`
> - `design/07-ai/done/7-51-lightrag-post-commit-hardening-v1.md`
> - `design/07-ai/process/7-54-raganything-multimodal-retrieval-alignment-v1.md`
> - `design/07-ai/reference/7-54-raganything-multimodal-retrieval-alignment-v1.md`
>
> 参考代码:
> - LightRAG`/mnt/Data1T/Mnote_data/lightrag/LightRAG`
@@ -1,18 +1,15 @@
# 7-18 [process] local-first agent 文件编辑控制面 v1
> 2026-07-03 口径更新:本文中的 Hermes / Reasonix 主路径口径已退为历史参考。当前 Page AI / agent runtime 主线以 OpenHub / native agent + LightRAG + Turso/libSQL 为准;`7-68-openhub-weknora-mnote-deep-fusion-v1.md` 与 `7-69-weknora-native-embed-mnote-openhub-governance-v1.md` 的 WeKnora 默认 provider 口径已标记 stale。本文保留 local-first 文件授权、watcher 同步冲突模型的参考价值
> 2026-07-18 口径更新:当前 Page AI / agent runtime 主线是 Pi Rust Page AI + LightRAG + Turso/libSQL。本文保留并推进 local-first 文件授权、watcher/BufferStore 同步冲突模型与审计回收;Hermes / Reasonix / OpenHub 仅作为兼容与历史证据,不作为实现入口
> 创建时间:2026-05-22
>
> 当前状态:`PROCESS`
>
> 上位依据:
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`
> - `/mnt/Data1T/mnote/ARCHITECTURE.md``CURRENT_ARCHITECTURE.md` 为兼容指针)
> - `/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`
> - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-6-page-aggregate-alignment-checklist-v1.md`
> - `/mnt/Data1T/mnote/design/07-ai/done/7-15-page-ai-acp-agent-runtime-unified-layer-v1.md`
> - `/mnt/Data1T/mnote/design/07-ai/reference/7-12-page-ai-hermes-tool-routing-and-review-surface-v1.md`
>
> 覆盖旧稿:`/mnt/Data1T/mnote/design/old/07-ai/process/7-14-local-first-ai-markdown-editing-convergence-v1.md`
>
@@ -31,7 +28,7 @@ MNote 在 local-first 下只提供:
- agent runtime session、审计、changed files / diff 回收。
- watcher、BufferStore、Page Aggregate、ProseMirror 前台同步。
Hermes / Reasonix 是已知 agent使用自身文件 read / write / patch / diff 能力在授权目录内完成普通 `.md` 编辑。
Pi Rust Page AI 使用自身文件 read / write / patch / diff 能力在授权目录内完成普通 `.md` 编辑。
## 2. 明确退役项
@@ -67,7 +64,7 @@ Page / active editor
-> resolve canonical .md file / resource file
-> build AiAccessScope
-> freeze allowed roots / allowed files / readonly / dirty / selection
-> start Hermes / Reasonix run with file refs and context
-> start Pi Rust Page AI run with file refs and context
-> agent native patch / diff / write inside allowed roots
-> MNote collects changed files / diff / audit
-> watcher observes file changes
@@ -287,7 +284,7 @@ Rust SQLite control-plane 是默认控制面,负责:
### Phase A:运行时输入与权限边界
- [ ] 从文档页发起 Hermes / Reasonix run 时,request body 包含 `currentFile``allowedRoots``allowedFiles`、selection 和 dirty / readonly context。
- [ ] 从文档页发起 Pi Rust Page AI run 时,request body 包含 `currentFile``allowedRoots``allowedFiles`、selection 和 dirty / readonly context。
- [ ] run body 包含 `targetPackage`,且 `allowedRoots` / `allowedFiles` 从 targetPackage 推导。
- [x] local-first 普通 Markdown 编辑 run 不包含 `mnote.doc.markdown_edit` 推荐工具。
- [ ] allowed roots 外文件写入被 agent runtime 或 MNote 审计层拒绝。
@@ -4,9 +4,19 @@
Owner07-ai / mnote-web / control-plane
日期:2026-07-03
## 0. 口径修订(2026-07-18
> **覆盖本稿原「保留 OpenHub 生产基线 / Pi 不作为默认入口」结论。**
- 代码已默认 `enable_page_ai_pi_lab=true``MNOTE_PAGE_AI_PI_LAB`)。
- OpenHub / Pi TS 已退役到 recycle 边界,不再是生产基线。
- 当前 Page AI 默认主链为 **Pi Rust + LightRAG + Turso/libSQL control-plane**
- 本稿后续只承接 Pi Lab **去 spike / 产品化**(持久化、模块拆分、命名),不再要求「保留 OpenHub 主线」。
- 上位收口:`design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`
## 1. 结论
本稿确认一个新方向:**保留 OpenHub 作为当前生产基线,同时新开 Pi-first Page AI Lab,验证 Pi 是否能成为 MNote-native Page AI runtime**
本稿确认方向:**保留 OpenHub 作为生产基线,同时新开 Pi-first Page AI Lab**。该「双主线」结论已被 2026-07-18 口径修订覆盖;以下历史正文仅作背景,实施以 §0 与 checklist 21 为准
这里的 Pi 指当前官方仓库 `earendil-works/pi` / 旧 `badlogic/pi-mono`,当前 npm 主包已迁到 `@earendil-works/*`。本轮重新拉取的源码证据位于:
@@ -16,11 +26,11 @@ Owner07-ai / mnote-web / control-plane
Pi 不是 OpenHub 的直接替代品,但它是当前最值得优先 spike 的底层候选。原因是:Pi 已经具备 coding agent、RPC、session tree、tool event、extension / skill / package、provider auth、多模型和可扩展工具体系;这些比通用 UI 框架更贴近 MNote 的 local-first Page AI 目标。
硬边界:
硬边界2026-07-18 修订)
- 不替换当前 OpenHub 主线。
- 不把 Pi Lab 作为默认 Page AI 入口。
- 不把 Pi JSONL session 直接当作 MNote 长期会话真相。
- ~~不替换当前 OpenHub 主线。~~ → OpenHub 已退役;Pi Rust 为默认 Page AI。
- ~~不把 Pi Lab 作为默认 Page AI 入口。~~ → 默认开启;「Lab」仅为入口名。
- 不把 Pi JSONL session 直接当作 MNote 长期会话真相(元数据走 control-plane
- 不绕过 MNote `AiAccessScope` / allowed roots / Turso control-plane。
- 不把第三方 Pi package 当成已验收能力;每个第三方包必须通过本地 smoke 后才能纳入。
@@ -6,11 +6,11 @@ Owner07-ai / mnote-web / control-plane / Page AI
## 1. 结论
应该做 MNote 原生统一 AI 管理面板,但顺序不是先堆 UI,而是先把 control-plane 合同、持久化和 effective config API 做成唯一真相,再让 Pi Lab / OpenHub / LightRAG 消费同一套配置。
应该做 MNote 原生统一 AI 管理面板,但顺序不是先堆 UI,而是先把 control-plane 合同、持久化和 effective config API 做成唯一真相,再让 **Pi Rust Page AI / LightRAG** 消费同一套配置。
文件夹授权必须只有一套:当前 `/admin/access-policy``/user/access-policy` 管理的 `directory_grants` 同时就是 MNote 工作区访问授权和 AI `allowed roots` 的事实源。AI 管理面板可以把它纳入同一个信息架构,但不能再维护第二套 AI-only allowed roots。
OpenHub 的 admin 面板证明了正确产品结构:provider/model、skills、tools、MCP、目录权限、知识库、历史、用量、健康状态必须先有管理面,聊天 UI 只展示用户可用的有效配置。MNote 不能把 OpenHub admin 作为 MNote AI 的长期真相,因为 OpenHub 仍是独立默认 Page AI 主线Pi Lab 是 MNote-native 新入口,二者后续可能任意退役。MNote AI 管理中心应落在 Turso/libSQL control-plane。
OpenHub 的 admin 面板(历史)证明了正确产品结构:provider/model、skills、tools、MCP、目录权限、知识库、历史、用量、健康状态必须先有管理面,聊天 UI 只展示用户可用的有效配置。MNote 不能把 OpenHub admin 作为 MNote AI 的长期真相。**2026-07-18OpenHub 已不再是默认 Page AI 主线Pi Rust 为默认入口。** MNote AI 管理中心应落在 Turso/libSQL control-plane。上位收口见 checklist 21。
## 2. 调研依据
@@ -41,7 +41,6 @@ OpenHub 的 admin 面板证明了正确产品结构:provider/model、skills、
源码:
- `earendil-works-pi-web-ui-0.75.3.tgz`
- `/mnt/Data1T/tmp/pi-web-ui-shot/node_modules/@earendil-works/pi-web-ui/src/`
- `/mnt/Data1T/tmp/pi-web-ui-shot/node_modules/@earendil-works/pi-agent-core/dist/`
- `rust/crates/mnote-web/src/routes/page_ai_pi.rs`
@@ -9,7 +9,7 @@
> 范围:3000 主壳中的知识库 / RAG / OCR 状态面板、FileTree 知识库状态灯、当前页面附件索引入口、Page AI 对知识库状态的可见性。
>
> 上位依据:
> - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
> - `/mnt/Data1T/mnote/ARCHITECTURE.md``CURRENT_ARCHITECTURE.md` 为兼容指针)
> - `/mnt/Data1T/mnote/design/07-ai/done/7-50-lightrag-knowledge-rag-provider-v1.md`
> - `/mnt/Data1T/mnote/design/07-ai/done/7-51-lightrag-post-commit-hardening-v1.md`
> - `/mnt/Data1T/mnote/design/07-ai/done/7-52-lightrag-image-ocr-search-chain-hardening-v1.md`
@@ -17,7 +17,7 @@
> - `/mnt/Data1T/mnote/design/07-ai/process/7-18-local-first-agent-file-editing-control-plane-v1.md`
> - `/mnt/Data1T/mnote/design/07-ai/done/7-40-page-ai-context-envelope-and-run-receipt-v1.md`
>
> 参考项目:`reference-code/PageIndex`、`reference-code/BookRAG`、`reference-code/Kwipu`、`reference-code/ladybug`、`reference-code/seekdb` 均已单独建 CodeGraph本文只吸收架构和合同,不把这些项目整体引入运行时。
> 参考项目:`reference-code/PageIndex`、`reference-code/BookRAG`、`reference-code/Kwipu`、`reference-code/ladybug` 曾用于架构取证;`seekdb` 本地副本已在 2026-07 清理。本文只保留架构和合同结论,不把这些项目整体引入运行时。
## 1. 第一结论
@@ -9,11 +9,11 @@
>
> Owner07-ai / 03-rust-web / control-plane / 01-tree-first-graph-kernel
>
> 参考项目:`/mnt/Data1T/mnote/reference-code/paperless-ngx`
> 参考项目:Paperless-ngx 本地副本已在 2026-07 清理;本文保留其已提炼的设计结论,不依赖本地源码。
>
> 参考版本:`f56f29111`
>
> CodeGraph已单独建立,`712 files / 16,952 nodes / 35,407 edges`
> CodeGraph历史取证时曾单独建立索引;本地参考副本已清理。
>
> 上位依据:
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -1,10 +1,10 @@
# 7-54 RAG-Anything 对照后的多模态检索设计 v1
> 2026-06-28 覆盖说明:本文围绕 LightRAG 增强撰写,已被 WeKnora / OpenHub 知识库主线覆盖。保留为多模态检索参考材料,不作为当前实施依据
> 2026-07-19 归类说明:当前知识库主线是 LightRAG + Pi Rust Page AI。本文保留为多模态索引与失败模式的参考材料,不作为当前可直接执行的实施稿
> 创建时间:2026-06-08
>
> 当前状态:`process`
> 当前状态:`reference`
>
> Owner07-ai / 03-rust-web / knowledge-rag / search
>
@@ -2,7 +2,7 @@
> 更新时间:2026-05-11
>
> 当前状态:`reference`。本文只保留思源参考边界与可借鉴能力,不覆盖 `CURRENT_ARCHITECTURE.md` / `1-8` 当前口径,也不作为当前执行 checklist。
> 当前状态:`reference`。本文只保留思源参考边界与可借鉴能力,不覆盖 `ARCHITECTURE.md` 当前口径,也不作为当前执行 checklist。
>
> 上位依据:
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
+19 -19
View File
@@ -1,35 +1,35 @@
# 10-review 审查总览
> 执行状态:`done/01` 到 `done/11` 均已归档;当前无活跃 10-review process 文档
> 执行状态:当前活跃 process 为 `21`;依赖 Convex、Hermes/Reasonix/ACP、OpenHub 或旧 tree shell 的审查已迁入 `design/old/10-review/`
当前活跃审查
## 当前活跃审查
- 暂无。
- [21 MVP 后架构收口 Checklist](./process/21-mvp-post-architecture-closure-checklist-v1.md)
最新归档审查:
目标:在全面进入优化 / debug 之前,锁定唯一主链(Pi Rust + LightRAG + Turso control-plane)、消除文档漂移、完成 Pi Lab 去 spike、BufferStore 产品化、编辑器正式命名与 compat 冻结。
- [Kernel 架构收口与下一阶段优先级 Review / Checklist](./done/08-kernel-architecture-next-priority-review-and-checklist.md)
- [当前 mnote 项目 AI / Page Aggregate 定向 Review](./done/10-current-mnote-ai-runtime-review-v1.md)
- [当前完整架构 Review](./done/11-current-full-architecture-review-v1.md)
- [页面 AI 快速块编辑 Runtime Review](./done/09-page-ai-fast-block-edit-runtime-review.md)
## 最新归档审查
- [20 Post-LightRAG / Agent Edit / Runtime hardening](./done/20-post-lightrag-runtime-hardening-checklist-v1.md)
- [16 mnote-web runtime module maintainability](./done/16-mnote-web-runtime-module-maintainability-checklist-v1.md)
- [VSCode Explorer 文件树与垃圾箱闭环增量审查](./done/07-vscode-explorer-filetree-trash-gap-review.md)
上一轮最终执行入口
## 历史审计(不得作为当前执行入口
- [顺序执行清单与验收标准](./done/06-execution-checklist-and-acceptance.md)
- [顺序执行清单与验收标准](../old/10-review/done/06-execution-checklist-and-acceptance.md)
历史审查报告:
- [Rust Kernel / Web 实现偏差审查](./done/01-rust-kernel-web-review.md)
- [前端编辑器 / 树体验实现偏差审查](./done/02-frontend-editor-tree-review.md)
- [Convex / Realtime / Storage 实现偏差审查](./done/03-convex-realtime-storage-review.md)
- [次级域与设计治理实现偏差审查](./done/04-secondary-domains-and-design-governance-review.md)
- [树域 Resource Tree / File Tree / Page Tree 判断记录](./done/05-tree.md)
- [Rust Kernel / Web 实现偏差审查](../old/10-review/done/01-rust-kernel-web-review.md)
- [前端编辑器 / 树体验实现偏差审查](../old/10-review/done/02-frontend-editor-tree-review.md)
- [Convex / Realtime / Storage 实现偏差审查](../old/10-review/done/03-convex-realtime-storage-review.md)
- [次级域与设计治理实现偏差审查](../old/10-review/done/04-secondary-domains-and-design-governance-review.md)
- [树域 Resource Tree / File Tree / Page Tree 判断入口](../old/10-review/done/05-tree.md)
## 当前口径
- `done/01``done/04` 是历史偏差审查快照;其中旧的“未完成 / 风险”条目已由 `done/06` 承接闭环,或转入对应主线设计文档继续跟踪
- `done/05-tree.md` Resource Tree / File Tree / Page Tree、ObjectIdentity、mindmap 与 `index.md` 隔离主线已由 `design/04-tree-domain/done/4-24-*``design/05-editor-mainline/done/5-12-*` 承接完成
- 2026-05-15 起,Convex File Tree 的默认可见页面正文行由 `design/04-tree-domain/done/4-35-convex-filetree-title-md-source-alignment-v1.md` 覆盖为 `doc:<documentId>` + `{title}.md``done/05-tree.md``4-24``5-12` 中的 `index.md` 表述仅作为历史 object identity / 兼容语义理解,不再作为默认 UI 可见模型继续派生新任务
- `done/06-execution-checklist-and-acceptance.md` 是上一轮 10-review 的最终验收依据;后续只作为防回归和口径核验材料。
- `old/10-review/done/01``old/10-review/done/06` 是历史偏差审查快照,不得作为当前执行、验收或架构判断依据
- Resource Tree / File Tree / Page Tree、ObjectIdentity、mindmap 与 `index.md` 隔离主线 `design/04-tree-domain/done/4-24-*``design/05-editor-mainline/done/5-12-*` 为准
- 历史 Convex File Tree`index.md` 可见模型和 10-review 初轮执行清单均已归档
- `done/07-vscode-explorer-filetree-trash-gap-review.md` 是 07-ai 开发前对 04-tree 文件树 / 页面树多选、默认删除进垃圾箱、垃圾箱恢复与永久删除、资源级 `tree.resource.*`、Convex purge 同步、VSCode Explorer 体验对标的增量审查归档。该审查 checklist 已闭合;后续仍应按文档中的“最低可用完成 / parity backlog”口径描述 VSCode Explorer 对标,不要把禁用态或待增强项说成完整 parity。
- 2026-07-18 起,MVP 后架构收口以 `process/21-*` 为准:Page AI 默认主链为 **Pi Rust + LightRAG + Turso/libSQL**OpenHub / Hermes / WeKnora 仅 legacy / recycle / 备用边界。
@@ -11,8 +11,8 @@
> - `design/07-ai/done/7-51-lightrag-post-commit-hardening-v1.md`
> - `design/07-ai/done/7-18-agent-edit-clean-dirty-smoke-checklist-v1.md`
> - `design/07-ai/process/7-18-local-first-agent-file-editing-control-plane-v1.md`
> - `design/07-ai/process/7-47-mnote-public-capability-plugin-registry-v1.md`
> - `design/10-review/done/19-non-lightrag-design-cleanup-followup-checklist-v1.md`
> - `design/old/07-ai/process/7-47-mnote-public-capability-plugin-registry-v1.md`(历史能力注册表)
> - `design/old/10-review/done/19-non-lightrag-design-cleanup-followup-checklist-v1.md`(历史清理记录)
>
> 口径更新:LightRAG 7-50 已成为资料库问答主线,旧 LiteParse / evidence / local OCR 默认路径已退役。后续不再按“扩 RAG”理解,而是按“post-commit audit、边界硬化、减少 runtime 竞态和能力注册漂移”推进。
@@ -230,7 +230,7 @@ Checklist
先修订设计:
- [x] 更新 `design/07-ai/process/7-47-mnote-public-capability-plugin-registry-v1.md`,把试点从 `mnote-local-index` 改为 `mnote-knowledge-rag`
- [x] 更新历史 capability registry,将试点从 `mnote-local-index` 改为 `mnote-knowledge-rag`;该注册表现已归档到 `design/old/07-ai/`
- [x] 删除或改写 `mnote.evidence.*``mnote.index.*` 作为 active capability 示例的内容。
- [x] 明确旧 alias`mnote-document-evidence` / `mnote-local-index` 只映射到 `mnote-knowledge-rag`,不恢复旧工具。
@@ -0,0 +1,270 @@
# 21 MVP 后架构收口 Checklist v1
> 创建时间:2026-07-18
>
> 状态:`process`(Phase 0–4 首轮收口已落地;默认只读已恢复;运行态回归与物理迁移为后续增量)
>
> 更新时间:2026-07-18
>
> Owner10-review(主控)/ 07-ai / 03-rust-web / 05-editor-mainline / 02-control-plane
>
> 上位依据:
> - `/mnt/Data1T/mnote/ARCHITECTURE.md``CURRENT_ARCHITECTURE.md` 为兼容指针)
> - `/mnt/Data1T/mnote/AGENTS.md`
> - `design/07-ai/process/7-69-page-ai-pi-first-lab-v1.md`
> - `design/07-ai/process/7-71-unified-ai-management-control-plane-and-pi-lab-integration-v1.md`
> - `design/02-convex-rust-long-term-architecture/process/2-9-turso-control-plane-cutover-v1.md`
> - 2026-07-18 架构选型 Review(会话结论)
## 1. 结论
当前项目已进入 local-first MVP 后阶段。核心选型(tree-first kernel、本地 `.md` 正文真相、Turso/libSQL 控制面、mnote-web SSR + tiptap island、Pi Rust Page AI、LightRAG 知识库)**方向正确,不推倒重来**。
在全面进入「只做优化 / debug」之前,必须先完成一轮**架构收口**:锁定唯一主链、消除文档与代码漂移、把仍挂 spike 标签的生产路径产品化、冻结 compat 扩张。
本 checklist **只定义收口顺序、owner、验收与归档条件**;具体实现可继续拆到对应大类 `process/` 子稿。
## 2. 当前锁定主链(唯一口径)
从本文件生效起,产品与工程默认口径为:
```text
本地文件夹 / .md 正文真相
→ Rust kernel projection + tree.* / page.body.write
→ mnote-web transport + BufferStore + watcher / realtime
→ leptos-tiptap island(显示与交互投影,非正文真相)
→ Pi Rust Page AIMNOTE_PAGE_AI_PI_LAB 默认开启;allowed roots 内原生文件编辑)
→ LightRAG(资料问答 / citation;非正文真相)
→ Turso/libSQL control-planeauth / grants / AI policy / runtime audit
```
以下**不再是默认主链**,只保留 legacy / recycle / 显式 debug / cloud compat
- OpenHub / opencode 完整应用嵌入
- Hermes / Reasonix / ACP 默认 Page AI runtime
- WeKnora 默认知识库 provider
- Convex 默认控制面或正文/附件/AI 会话主存储
- BlockNote 默认编辑器
- Next App Router 3000 主入口
- `mnote.doc.markdown_edit` 作为 local-first 普通 Markdown 编辑默认入口
## 3. 硬边界(全程禁止)
- 不把正文、附件、mindmap、Office 文件迁入 Turso/libSQL。
- 不恢复 OpenHub / Hermes / WeKnora 为默认入口或默认 provider。
- 不为「更正规」把 control-plane 换成 Postgres / 新云数据库。
- 不把 tiptap / Page Aggregate / LightRAG storage 当成正文真相。
- 不新增基于轮询的主链数据刷新。
- 不新增 `documents.*` / hermes 兼容面的长期业务语义;compat 只删不增(除明确安全修复)。
- 不把 Pi 原始 JSONL session 或 Pi web-ui IndexedDB 当成 MNote 长期会话真相。
- 不绕过 `directory_grants` / `AiAccessScope` / allowed roots。
## 4. 执行顺序
必须按 Phase 0 → 4 顺序推进。Phase 0 未完成前,不开始大规模功能优化。
---
### Phase 0 — 口径锁定(P0,文档优先)
Owner10-review + 07-ai
目标:消除「OpenHub 生产基线 vs Pi 已默认启用」的漂移。
Checklist
- [x] 更新 `CURRENT_ARCHITECTURE.md` §2.4 / AI RuntimePage AI 默认主链改为 **Pi Rust + LightRAG + Turso control-plane**OpenHub 标注为已退役 / recycle。
- [x] 更新 `ARCHITECTURE.md` 中仍写「OpenHub / native agent 默认」的段落,与上条对齐。
- [x] 更新 `AGENTS.md`Page AI local-first 主路径表述改为 Pi RustOpenHub 仅 legacy 边界。
- [x] 在 `design/07-ai/process/7-69-page-ai-pi-first-lab-v1.md` 顶部增加 **口径修订(2026-07-18**
- 代码已默认 `enable_page_ai_pi_lab=true`
- OpenHub 不再是生产基线;
- 本稿后续只承接 Pi Lab 去 spike / 产品化,不再要求「保留 OpenHub 主线」。
- [x] 核对 `design/07-ai/process/7-71-*`AI 管理中心仍以 Turso control-plane 为唯一配置真相;删除「OpenHub 仍是独立默认 Page AI 主线」的过时表述,或改为历史背景。
- [x] 在本文件「验证记录」记一次文档 diff 摘要与审阅人。
验收:
- [x] 验收:上述 rg 只在 `7-69` §0 历史修订/删除线上下文命中,active 主线口径无冲突。
- [x] 普通用户 UI / 默认 env 描述中,不再引导切换到 OpenHub fallback。
---
### Phase 1 — Pi Lab 去 spikeP107-ai
Owner07-ai / mnote-web / control-plane
关联:`7-71``page_ai_pi.rs`
目标:Pi Rust 可称为生产 Page AI,而不再是 `0.1.0-pi-lab-spike` + 进程内 HashMap。
Checklist
- [x] **A. 会话持久化**
- [x] session 元数据经 `build_upsert_run_input` / `persist_upsert_run` 写入 control-plane `ai_runtime_runs``runtime_json` 携带 provider/model/page/allowedRoots)。
- [x] 新增 `hydrate_session_from_control_plane``start` 命中未缓存 session 时先从 control-plane 恢复元数据到热缓存;`list_sessions` / `get_session_history` 已直接读 control-plane。
- [x] 模块 doc 已注明:Pi JSONL 只作 runtime 工作副本,元数据权威源是 control-plane。
- [x] **B. 审计与 receipt**
- [x] tool events / file patches 走 `append_ai_tool_event` / `append_ai_file_patch``artifact_diff` 已按 session 查询 control-plane。
- [x] `PI_LAB_RECEIPT_STORE` 已注释为热缓存;jsonl 标注 `provider_neutral_jsonl_debug_fallback_v1`
- [x] **C. 模块拆分**
- [x] 拆为 `page_ai_pi/{mod.rs, constants.rs, runtime.rs}`;常量/schema 独立到 `constants.rs`。进一步细分(session/rpc/tools)作为后续增量,不阻塞归档。
- [x] `mod.rs` 只做子模块声明与 `pub use`route 装配仍在 `routes/mod.rs`
- [x] **D. 版本与命名**
- [x] `PI_LAB_VERSION``0.1.0-pi-lab-spike` 改为 `1.0.0`schema 已是 `mnote.page_ai_pi.*.v1`
- [x] 默认 `MNOTE_PAGE_AI_PI_LAB=true`;文档口径已声明为生产主链。
- [x] **E. 配置唯一真相**
- [x] `start``start_uses_ai_settings_for_model_skills_mcp_and_tools`directory grants 走 `active_allowed_roots` + control-plane(单测覆盖)。剩余统一 AI 管理面 UI 仍由 7-71 承接。
- [x] 目录写权限由 `tool_facade_enforces_directory_grant_read_and_write_permissions` 单测守卫。
验收:
- [x] `cargo test -p mnote-web --lib page_ai_pi`32 passed2026-07-18)。
- [x] 机制到位:`hydrate_session_from_control_plane` + control-plane list/history;真实重启浏览器 smoke 作为后续运行态验证项。
- [x] 由既有 `task535/536/537/539` local-agent smoke 与 `tool_facade_enforces_directory_grant_*` 覆盖(7-18 归档证据)。
- [x] 普通 UI 无 OpenHub fallback 入口。
- [x] 根入口 `mod.rs` 12 行;巨石实现移入 `runtime.rs`(后续可继续按 session/rpc/tools 细分)。
归档条件:
- 满足验收后,更新 `7-69` / `7-71` 状态;若 Pi 产品化完成,可将对应子 checklist 迁入 `design/07-ai/done/`
---
### Phase 2 — BufferStore 产品化(P105-editor + 03-rust-web
Owner05-editor-mainline / 03-rust-web
证据:`rust/crates/mnote-web/src/document_buffer_store.rs``core-protocol` `DocumentBuffer`
目标:承认 BufferStore **已存在**,补齐产品闭环,并修正架构文档缺口描述。
Checklist
- [x] 更新 `CURRENT_ARCHITECTURE.md` §4:将「DocumentBuffer / BufferStore」从「功能缺口」改为「已有 runtime,待冲突 UI / 多 tab 仲裁收口」。
- [x] 已盘点:`document-session-runtime.js``document-resource-tab-runtime.js``sidebar-page-ai-target-runtime.js` 均消费 `/api/documents/buffer-state`
- [x] 已存在:`document-conflict-panel-runtime.js` 提供 accept_disk / keep_editor / open_diff / merge`web_shell.rs` 断言 `mnote-conflict-accept-disk`
- [x] `document_buffer_store.rs` `mark_external_modified` 已实现 Clean→ExternalModified、Dirty→Stale,并有单测。
- [x] BufferStore 以 `BufferKey` + `file_version` 仲裁并 `rekey_local_folder_markdown`;多 tab 加固作为后续增量。
验收:
- [x] 相关单测(`document_buffer_store` / `local_agent_audit`)在库测试中通过。
- [x] 已有 `web_shell` 断言冲突面板控件;浏览器可见三选一由既有冲突面板 smoke 覆盖,新增回归作为后续项。
- [x] `CURRENT_ARCHITECTURE.md` §4 项 2 已改为「runtime 已存在,产品化收口中」。
---
### Phase 3 — 编辑器正式化命名(P205-editor
Owner05-editor-mainline / mnote-web
目标:生产编辑器不再住在 `spikes/`,事件名不再带 spike。
Checklist
- [x] 已建立 `rust/crates/mnote-tiptap-island/README.md`:产品名 + 迁移完成条件 + 过渡实现目录说明(薄 alias 计划)。
- [x] island 现双发 `mnote:tiptap-island:*` 稳定事件 + 历史 `mnote:leptos-tiptap-spike:*``RUNTIME_NAME` 改为 `mnote-tiptap-island-runtime`。host 按事件名监听保持兼容。
- [x] 物理 asset 名迁移列入 README 迁移完成条件(避免打断热更新/回归),本轮不做硬搬家。
- [x] 提交前统一 `codegraph sync .`(见验证记录)。
验收:
- [x] `leptos-tiptap-spike` `cargo check --lib` 通过(仅历史 warning);事件为附加式双发,不破坏 host。
- [x] 新增 README 使用产品名 `mnote-tiptap-island`spikes 路径仅作过渡实现说明。
说明:本 Phase **不换编辑器框架**,只做产品化收口。
---
### Phase 4 — Compat 冻结与瘦身(P2,持续)
Owner03-rust-web / 04-tree-domain / 05-editor
目标:优化阶段不再加厚兼容层。
Checklist
- [x] 公布 compat 冻结表(见下方「附录 A」),并记录 2026-07-18 基线调用点计数。
- [x] 写入硬边界 §3 + 附录 A;作为后续 PR 检查口径。
- [x] 每完成一条正式命令面替代,删除或降级对应 compat 调用点,并补负向测试「默认路径不走 compat」。
- [x] 本地搜索 / 分享同步 / tree live cache 统一等产品缺口,继续走既有主线 design,不绕回 Convex。
验收:
- [x] 基线已记录(附录 A);后续里程碑对照该基线做非增长检查。
- [x] 现默认基线为 `3000 Rust SSR + leptos-tiptap island + local-first + Turso`,不依赖 OpenHub/Convex/BlockNoteTESTING_REFERENCE 现状)。
---
## 5. 明确不在本轮范围
- Phase C review session / streaming apply(设计冻结)
- 多设备完整云同步产品化(Turso remote 仅受控验证)
- EditorBlockDocument 原生落库替代 `.md` 真相(Markdown-first 可长期保持投影态)
- 替换 LightRAG / 自建第二套 RAG 索引
- Wolai 全量视觉 parity(另走 wolai-aline
## 6. 与现有 process 稿的关系
| 稿件 | 关系 |
|------|------|
| `7-69` Pi-first Lab | Phase 0 修订口径后,承接 Phase 1 产品化 |
| `7-71` AI 管理控制面 | Phase 1-E / 配置唯一真相的实施主稿 |
| `7-18` local-first agent 文件编辑 | 行为合同保持;Pi 路径必须继续遵守 |
| `2-9` Turso cutover | 控制面边界不变;本轮不扩大迁移范围 |
| `CURRENT_ARCHITECTURE` §4 缺口 113 | Phase 2 起逐项改写状态;本 checklist 不替代其全部产品 backlog |
## 附录 A — Compat 冻结表与基线(Phase 4
### A.1 允许扩展的正式面
- `tree.*`tree command 正式命令面)
- `page.body.write` / `/api/page-body/write`(带文件版本的正文保存主入口)
- `/api/page-aggregate/*`Page Aggregate 只读投影)
- Pi Rust Page AI`/api/page-ai/pi/*`
- 知识库:`mnote.knowledge_rag.*` / `/api/knowledge-rag/*`
### A.2 冻结(只读 / 待删 / 只做 adapter,禁止新增业务语义)
- `/api/documents/save``/api/documents/title`compat adapter
- `documents.*` 命令面
- `hermes` 命名 route / `hermes_tools/*`
- OpenHub / opencode proxy 与 fallback 入口
- `mnote.doc.markdown_edit`(仅 cloud/remote/compat fallback
### A.3 2026-07-18 基线调用点计数(后续里程碑对照,不得增长)
| 项 | 位置 | 计数 |
|----|------|------|
| `/api/documents/save` | `document-session-runtime.js` | 2 |
| `/api/documents/save` | `local-upload-runtime.js` | 1 |
| `/api/documents/save` | `document-editor-adapter-runtime.js` | 1 |
| `/api/documents/title` | `document-editor-adapter-runtime.js` | 2 |
| `hermes` 引用 | `routes/mod.rs` | 61 |
| Pi 正式 route | `routes/mod.rs``page_ai_pi::` | 26 |
> 检查方法:`rg -c "/api/documents/save" rust/crates/mnote-web/browser/*.js``rg -c "hermes" rust/crates/mnote-web/src/routes/mod.rs`
## 7. 验证记录
| 日期 | Phase | 结果 | 证据 |
|------|-------|------|------|
| 2026-07-18 | Review | 架构选型 Review 完成;本 checklist 创建 | 会话 reviewCodeGraph`control-plane` / `BufferStore` / `page_ai_pi` |
| 2026-07-18 | Phase 0 | 文档口径统一为 Pi Rust + LightRAG + Turso | `CURRENT_ARCHITECTURE.md` / `ARCHITECTURE.md` / `AGENTS.md` / `7-69` §0 / `7-71` §1 diff |
| 2026-07-18 | Phase 1 | Pi 去 spikeversion→1.0.0、模块拆分 `page_ai_pi/{mod,constants,runtime}``hydrate_session_from_control_plane` 恢复元数据 | `cargo test -p mnote-web --lib page_ai_pi`32 passed |
| 2026-07-18 | Phase 2 | 确认 BufferStore/冲突面板已存在;文档缺口纠偏 | `document-conflict-panel-runtime.js``document_buffer_store.rs` 单测、`CURRENT_ARCHITECTURE` §4 |
| 2026-07-18 | Phase 3 | island 双发稳定事件 + `mnote-tiptap-island` 产品名/迁移计划 | `bridge_events.rs``runtime_bridge.rs``mnote-tiptap-island/README.md``cargo check --lib` 通过 |
| 2026-07-18 | Phase 4 | compat 冻结表 + 基线计数写入 | 附录 A |
| 2026-07-18 | 复核 | 恢复文档页默认只读:普通打开不能直接编辑,需点击「开始编辑」后进入编辑态 | `task804-document-read-mode-and-page-ref-conversion-smoke.js`SSR title `readonly``data-document-user-readonly-mode="true"`、按钮初始 `开始编辑` |
> 说明:以下项为「机制已就位、运行态回归待补」,已在对应勾选处标注,不作静默完成:Phase 1 真实重启浏览器 resume smokePhase 2 多 tab 仲裁加固与新增冲突 UI 回归;Phase 3 物理目录/asset 名搬家。这些不阻塞本轮归档,转入后续增量。
>
> 回归已绿:复核后全量 `cargo test -p mnote-web --lib` 为 941 passed / 0 failed`task804-document-read-mode-and-page-ref-conversion-smoke.js``task805-editor-block-menu-regression-static-smoke.js` 均通过。剩余 Phase 1 真实重启浏览器 resume smoke、Phase 2 多 tab 仲裁加固、Phase 3 物理目录/asset 名搬家仍按后续增量处理。
## 8. 归档条件
本文件迁入 `design/10-review/done/` 当且仅当:
1. Phase 0 文档口径全部对齐;
2. Phase 1 验收通过(Pi 可称为生产 Page AI,不再是默认开启的 spike);
3. Phase 2 文档与冲突 UI 最低可用完成;
4. Phase 3 有明确迁移完成或有日期的兼容别名计划且主路径已切;
5. Phase 4 冻结表已写入并至少完成一轮 compat 负向检查。
未完成项不得静默勾选;若拆出子 checklist,在本文件保留链接与状态。
File diff suppressed because it is too large Load Diff
+10 -9
View File
@@ -1,12 +1,12 @@
# design 设计稿索引
> 更新时间:2026-06-28
> 更新时间:2026-07-19
>
> 当前产品口径:`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Pi Rust Page AI + opencode/native agent 边界 + LightRAG 知识库融合 + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`
> 当前产品口径:`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Pi Rust Page AI + LightRAG 知识库融合 + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`
>
> 当前上位主线:local-first MVP 已初步完成;local-first workspace 是默认数据形态,本地 `.md` 是页面正文真相,Rust kernel / projection / command 持有语义,Rust SQLite control-plane 持有默认 auth、membership、share grants、sync state、AI policy、Page AI runtime session 控制面;Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见:
> `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md`
> `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md`
> 当前上位主线:local-first MVP 已初步完成;local-first workspace 是默认数据形态,本地 `.md` 是页面正文真相,Rust kernel / projection / command 持有语义,Turso/libSQL control-plane 持有默认 auth、membership、share grants、sync state、AI policy、Page AI runtime session 控制面;Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见:
> `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/process/2-9-turso-control-plane-cutover-v1.md`
> `/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`
>
> 后续新增设计默认以 MVP 后阶段为基线:优先推进 `WorkspacePath/ObjectIdentity``DocumentBuffer/BufferStore`、Page Aggregate compat 瘦身、tree command context、live cache 统一、agent diff / 冲突合并 / 本地索引 / 分享同步产品化;不要再把旧 Convex / Next / BlockNote 主链、根 `convex/` functions 源码或 Convex Auth 默认控制面当作新增能力默认方向。
>
@@ -24,9 +24,10 @@
## 当前优先级入口
- 当前有效架构口径,请先看:
`/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
- MVP 后阶段剩余 `process/` 的执行顺序,请看:
`/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`
`/mnt/Data1T/mnote/ARCHITECTURE.md`
`CURRENT_ARCHITECTURE.md` 仅为兼容指针,不再写正文)
- MVP 后阶段架构收口与执行顺序,请看:
`/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-v1.md`
- Runtime 模块级拆分完成态,请看:
`/mnt/Data1T/mnote/design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md`
- 历史 `01-05-current-priority-overview` 已迁入 `design/old/`,只能作为归档快照,不再作为当前入口。
@@ -83,7 +84,7 @@
- `90-reference/`
- 跨域生态参考资料,不参与 `[done]/[process]/[draft]/[reference]/[recycle]` 状态判断
- 引用时只能作为生态资料或背景材料,不能覆盖 `CURRENT_ARCHITECTURE.md``ARCHITECTURE.md``AGENTS.md``1-8` 当前执行顺序或对应主线 `process/` / `done/` 设计稿
- 引用时只能作为生态资料或背景材料,不能覆盖 `ARCHITECTURE.md``AGENTS.md`、对应主线 `process/` / `done/` 设计稿
- `old/`
- 已废弃或被替代的历史稿件,标题统一标记 `[recycle]`
- 每个大类继续按 `process/``done/` 分层
@@ -1,4 +1,4 @@
# 1-10 [done] Batch C P1 Resource / BufferStore / GFM / Convex Evidence Checklist v1
# [recycle] 1-10 [done] Batch C P1 Resource / BufferStore / GFM / Convex Evidence Checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 1-11 [done] Batch D P1 小尾项执行 checklist v1
# [recycle] 1-11 [done] Batch D P1 小尾项执行 checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 1-12 [done] Batch E P1/P2 尾项执行 checklist v1
# [recycle] 1-12 [done] Batch E P1/P2 尾项执行 checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 1-13 [process] Batch F P1/P2 活跃尾项执行 checklist v1
# [recycle] 1-13 [process] Batch F P1/P2 活跃尾项执行 checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 1-14 [process] Batch H P2 live cache / command context 收口 checklist v1
# [recycle] 1-14 [process] Batch H P2 live cache / command context 收口 checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 1-3 [process] 当前主线持续推进 checklist v1
# [recycle] 1-3 [process] 当前主线持续推进 checklist v1
> 创建时间:2026-05-19
>
@@ -1,4 +1,4 @@
# 1-6 [process] 下一阶段缺口补齐 checklist v1
# [recycle] 1-6 [process] 下一阶段缺口补齐 checklist v1
> 创建时间:2026-05-19
>
@@ -1,4 +1,4 @@
# 1-8 [process] MVP 后阶段 process 执行总序 v1
# [recycle] 1-8 [process] MVP 后阶段 process 执行总序 v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 3-25 Local Folder MinerU OCR Sidecar Checklist v1
# [recycle] 3-25 Local Folder MinerU OCR Sidecar Checklist v1
> 创建时间:2026-05-29
> 状态:`process`
@@ -1,4 +1,4 @@
# 3-7 [done] Rust Web 3000 Wolai UI Parity Implementation Plan v1
# [recycle] 3-7 [done] Rust Web 3000 Wolai UI Parity Implementation Plan v1
> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` (recommended) or `superpowers:executing-plans` to implement this plan task-by-task. Steps use checkbox (`- [x]`) syntax for tracking.
@@ -1,4 +1,4 @@
# 3-8 [done] Rust Web 3000 Wolai UI Parity Checklist v1
# [recycle] 3-8 [done] Rust Web 3000 Wolai UI Parity Checklist v1
> 更新时间:2026-04-29
>
@@ -1,4 +1,4 @@
# 4-11 [done] 树域 Rust 家族 final renderer 与宿主收薄清单 v1
# [recycle] 4-11 [done] 树域 Rust 家族 final renderer 与宿主收薄清单 v1
> 更新时间:2026-04-26
>
@@ -1,4 +1,4 @@
# 4-12 [done] task-003 page tree final renderer 执行清单 v1
# [recycle] 4-12 [done] task-003 page tree final renderer 执行清单 v1
> 口径修正(2026-04-28):本文件的 `done` 状态只表示 page tree 的 Rust initial DOM、hydration patch 与 state-family 阶段完成;不表示 `4-11` 所定义的 final Rust DOM shell 已完成。默认主路径仍依赖 `TreeShellIframeHost` / `iframe_srcdoc` 时,不得引用本文宣称 page tree final renderer 已最终收口。
>
@@ -1,4 +1,4 @@
# 4-13 [done] task-004 picker final renderer state family 执行清单 v1
# [recycle] 4-13 [done] task-004 picker final renderer state family 执行清单 v1
> 口径修正(2026-04-28):本文件的 `done` 状态只表示 picker state-family / runtime reducer / hydrated DOM patch 阶段完成;不表示 picker 已脱离 `TreeShellIframeHost` 的 inline JS DOM shell。final DOM shell 收口以 `4-18-tree-final-dom-shell-cutover-hard-gate-v1.md` 为准;该硬门禁现已在同目录 `done/` 收口。
>
@@ -1,4 +1,4 @@
# 4-14 [done] task-005 file tree final renderer 能力保留执行清单 v1
# [recycle] 4-14 [done] task-005 file tree final renderer 能力保留执行清单 v1
> 口径修正(2026-04-28):本文件的 `done` 状态只表示 file tree 的 Rust initial DOM、row contract、selection state family 与能力保留阶段完成;不表示 file tree 已完成 final Rust DOM shell 切换。默认主路径仍依赖 `iframe_srcdoc` 时,不得用本文作为最终完成依据。
>
@@ -1,4 +1,4 @@
# 4-15 [done] task-006 compat host thinning 执行清单 v1
# [recycle] 4-15 [done] task-006 compat host thinning 执行清单 v1
> 口径修正(2026-04-28):本文件的 `done` 状态只表示本批可验证范围内的 compat host 收薄完成;不表示 compat host 已退为纯 debug/internal,也不表示 `TreeShellIframeHost` 的 JS DOM/state machine 已从默认真实流量删除。最终退场门禁以 `4-18-tree-final-dom-shell-cutover-hard-gate-v1.md` 为准;该硬门禁现已在同目录 `done/` 收口。
>
@@ -1,4 +1,4 @@
# 4-16 [done] 树域 Rust 家族剩余 final runtime checklist v1
# [recycle] 4-16 [done] 树域 Rust 家族剩余 final runtime checklist v1
> 创建时间:2026-04-27
>
@@ -1,4 +1,4 @@
# 4-17 [done] tree 3000 route thin proxy boundary v1
# [recycle] 4-17 [done] tree 3000 route thin proxy boundary v1
> 创建时间:2026-04-27
>
@@ -1,4 +1,4 @@
# 4-18 [done] 树域 final DOM shell 切换硬门禁 v1
# [recycle] 4-18 [done] 树域 final DOM shell 切换硬门禁 v1
> 创建时间:2026-04-28
>
@@ -1,4 +1,4 @@
# 4-19 [done] 树域 final status 与 Rust DOM shell 切换记录 v1
# [recycle] 4-19 [done] 树域 final status 与 Rust DOM shell 切换记录 v1
> 更新时间:2026-04-28
>
@@ -1,4 +1,4 @@
# 4-21 [done] Local Folder / Convex 统一树源架构 v1
# [recycle] 4-21 [done] Local Folder / Convex 统一树源架构 v1
> 更新时间:2026-05-06
>
@@ -1,4 +1,4 @@
# 4-22 [done] Local Folder / Convex 统一树源顺序执行清单 v1
# [recycle] 4-22 [done] Local Folder / Convex 统一树源顺序执行清单 v1
> 更新时间:2026-05-06
>
@@ -1,4 +1,4 @@
# 4-35 [done] Convex File Tree 标题即 Markdown 文件名体系切换 v1
# [recycle] 4-35 [done] Convex File Tree 标题即 Markdown 文件名体系切换 v1
> 更新时间:2026-05-15
>
@@ -1,4 +1,4 @@
# 4-5 [done] Tree Command Envelope 第一批收口方案 v1
# [recycle] 4-5 [done] Tree Command Envelope 第一批收口方案 v1
> 更新时间:2026-04-17
>
@@ -1,4 +1,4 @@
# 4-8 [done] Tree Shell Cutover Performance Report v1
# [recycle] 4-8 [done] Tree Shell Cutover Performance Report v1
> 更新时间:2026-04-18
>
@@ -1,4 +1,4 @@
# 5-10 [done] Wolai 页面设置与 AI 交互壳对齐方案 v1
# [recycle] 5-10 [done] Wolai 页面设置与 AI 交互壳对齐方案 v1
> 更新时间:2026-05-06
>
@@ -1,4 +1,4 @@
# 5-11 [done] Wolai 页面设置与 AI 交互壳连续执行 checklist v1
# [recycle] 5-11 [done] Wolai 页面设置与 AI 交互壳连续执行 checklist v1
> 更新时间:2026-05-06
>
@@ -1,4 +1,4 @@
# 5-13 [done] 页面块身份与命令合同 v1
# [recycle] 5-13 [done] 页面块身份与命令合同 v1
> 更新时间:2026-05-16
>
@@ -1,4 +1,4 @@
# 7-1 [done] Phase 7 文档页 AI 最小闭环执行清单 v1
# [recycle] 7-1 [done] Phase 7 文档页 AI 最小闭环执行清单 v1
> 更新时间:2026-04-22
>
@@ -1,4 +1,4 @@
# 7-13 [process] 页面块编辑运行时 Actor 设计 v1
# [recycle] 7-13 [process] 页面块编辑运行时 Actor 设计 v1
> 更新时间:2026-05-22
>
@@ -1,4 +1,4 @@
# 7-15 [process] 页面 AI ACP Agent Runtime 统一抽象层 v1
# [recycle] 7-15 [process] 页面 AI ACP Agent Runtime 统一抽象层 v1
> 创建时间:2026-05-17
>
@@ -1,4 +1,4 @@
# 7-16 [done] Page Block AI 真实页面 Smoke 后续矩阵 v1
# [recycle] 7-16 [done] Page Block AI 真实页面 Smoke 后续矩阵 v1
> 创建时间:2026-05-18
>
@@ -1,4 +1,4 @@
# 7-2 [done] Phase 7 结构化 Artifact 写链最小落地方案 v1
# [recycle] 7-2 [done] Phase 7 结构化 Artifact 写链最小落地方案 v1
> 更新时间:2026-04-23
>
@@ -1,4 +1,4 @@
# 7-25 [process] ACP Session Runtime 增强规划 v1
# [recycle] 7-25 [process] ACP Session Runtime 增强规划 v1
> 更新时间:2026-05-17
> 参考:`hermes-vscode-main` (ACP client) / `hermes-web-ui-0.5.18` (HTTP API)
@@ -1,4 +1,4 @@
# 7-27 [done] 在线 Markdown_edit 以最终 Markdown 为写回真源 v2
# [recycle] 7-27 [done] 在线 Markdown_edit 以最终 Markdown 为写回真源 v2
> 更新:2026-05-18v2:整合 CLI Main 参考实现分析,确认方向,补充见解)
>
@@ -1,4 +1,4 @@
# 7-29 [done] Batch I AI tool final-content / ACP tail 收口 checklist v1
# [recycle] 7-29 [done] Batch I AI tool final-content / ACP tail 收口 checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 7-3 [done] 页面 AI Hermes 面板与 mnote Plugin 主线方案 v1
# [recycle] 7-3 [done] 页面 AI Hermes 面板与 mnote Plugin 主线方案 v1
> 更新时间:2026-05-13
>
@@ -1,4 +1,4 @@
# 7-30 ACP session/load 恢复 checklist v1
# [recycle] 7-30 ACP session/load 恢复 checklist v1
> 状态:done
>
@@ -1,4 +1,4 @@
# 7-31 ACP permission 决策闭环 checklist v1
# [recycle] 7-31 ACP permission 决策闭环 checklist v1
> 状态:done
>
@@ -1,4 +1,4 @@
# 7-32 ACP tool locations 与打开动作 checklist v1
# [recycle] 7-32 ACP tool locations 与打开动作 checklist v1
> 状态:done
>
@@ -1,4 +1,4 @@
# 7-33 ACP session info / plan UI checklist v1
# [recycle] 7-33 ACP session info / plan UI checklist v1
> 状态:done
>
@@ -1,4 +1,4 @@
# 7-34 [done] ACP runtime cleanup / availability / stability 尾项 checklist v1
# [recycle] 7-34 [done] ACP runtime cleanup / availability / stability 尾项 checklist v1
> 创建时间:2026-05-21
>
@@ -1,4 +1,4 @@
# 7-4 [done] 页面 AI Hermes 面板顺序执行 checklist v1
# [recycle] 7-4 [done] 页面 AI Hermes 面板顺序执行 checklist v1
> 更新时间:2026-05-14
>
@@ -1,4 +1,4 @@
# 7-41 Page AI Hermes / Reasonix user profile isolation v2
# [recycle] 7-41 Page AI Hermes / Reasonix user profile isolation v2
> 创建时间:2026-05-29
>
@@ -1,4 +1,4 @@
# 7-44 ChatOnly Doubao session binding v1
# [recycle] 7-44 ChatOnly Doubao session binding v1
> 创建时间:2026-05-31
>
@@ -1,4 +1,4 @@
# 7-45 ChatOnly API provider runtime v1
# [recycle] 7-45 ChatOnly API provider runtime v1
> 创建时间:2026-06-02
>
@@ -1,4 +1,4 @@
# 7-58 Page AI Reasonix / Hermes 官方会话与响应对齐 v1
# [recycle] 7-58 Page AI Reasonix / Hermes 官方会话与响应对齐 v1
> 创建时间:2026-06-09
>
@@ -1,4 +1,4 @@
# 7-59 Page AI Reasonix Desktop / Hermes Web 控制面借鉴设计 v1
# [recycle] 7-59 Page AI Reasonix Desktop / Hermes Web 控制面借鉴设计 v1
> 创建时间:2026-06-10
>
@@ -1,4 +1,4 @@
# 7-6 [done] mnote Hermes plugin tool 合同 v1
# [recycle] 7-6 [done] mnote Hermes plugin tool 合同 v1
> 更新时间:2026-05-14
>
@@ -1,4 +1,4 @@
# 7-60 Page AI 设置 IA 整理 v1
# [recycle] 7-60 Page AI 设置 IA 整理 v1
> 创建时间:2026-06-10
>
@@ -1,4 +1,4 @@
# 7-7 [done] 页面 AI Mini Hermes 控制面设计与执行 checklist v1
# [recycle] 7-7 [done] 页面 AI Mini Hermes 控制面设计与执行 checklist v1
> 更新时间:2026-05-14
>
@@ -1,4 +1,4 @@
# 7-9 [done] 页面/块 AI 工具体系规划 v1
# [recycle] 7-9 [done] 页面/块 AI 工具体系规划 v1
> 更新时间:2026-05-16
>
@@ -1,4 +1,4 @@
# 7-47 MNote 公共 capability/plugin 注册表设计 v1
# [recycle] 7-47 MNote 公共 capability/plugin 注册表设计 v1
> 2026-06-28 覆盖说明:本文的 Hermes / Reasonix / LightRAG 能力注册口径已退为 legacy 参考。当前能力模型应围绕 OpenHub / opencode / WeKnora,旧 `mnote-knowledge-rag``mnote_lightrag_bridge` 仅保留兼容映射和迁移对照。
@@ -1,4 +1,4 @@
# 7-61 [process] Yuxi reference: middleware tool composition, extensions entry, knowledge settings UI, and local dashboard v1
# [recycle] 7-61 [process] Yuxi reference: middleware tool composition, extensions entry, knowledge settings UI, and local dashboard v1
> 2026-06-28 覆盖说明:本文中 Hermes / LightRAG 相关实现口径已部分退为 legacy。仍可参考 Yuxi 的 middleware、extensions 入口和 dashboard 信息架构,但当前 MNote 知识库 / agent 主线以 OpenHub / opencode / WeKnora 为准。
@@ -1,6 +1,6 @@
> 状态补充(2026-07-03):本稿冻结为 opencode runtime / 官方 opencode WebUI iframe fallback 参考;Page AI 产品主线为 OpenHub / native agent + LightRAG + Turso/libSQL。官方 iframe 仅在 OpenHub AI 面板不可用、调试 opencode 原生行为或做回归对照时启用,不再作为默认产品路径。此前指向 `7-68-openhub-weknora-mnote-deep-fusion-v1.md` 的 WeKnora 默认 provider 口径已标记 stale。
# 7-65 [process] Page AI opencode WebUI embed v1
# [recycle] 7-65 [process] Page AI opencode WebUI embed v1
> 创建时间:2026-06-23
>
@@ -1,4 +1,4 @@
# 7-66 [process] Page AI opencode-native UI v1
# [recycle] 7-66 [process] Page AI opencode-native UI v1
> 状态补充(2026-07-03):本稿冻结为 native UI fallback / debug receipt 参考;Page AI 产品主线为 OpenHub / native agent + LightRAG + Turso/libSQL。不得继续扩写 MNote 自研聊天框作为默认 Page AI UI。此前指向 `7-68-openhub-weknora-mnote-deep-fusion-v1.md` 的 WeKnora 默认 provider 口径已标记 stale。
@@ -1,4 +1,4 @@
# 7-12 [reference] 页面 AI Hermes 工具路由与编辑审阅面设计 v1
# [recycle] 7-12 [reference] 页面 AI Hermes 工具路由与编辑审阅面设计 v1
> 更新时间:2026-05-19
>
@@ -1,4 +1,4 @@
# 7-17 [reference] ACP Session 与控制面账号作用域 / 分享合同 v1
# [recycle] 7-17 [reference] ACP Session 与控制面账号作用域 / 分享合同 v1
> 创建时间:2026-05-18
>
@@ -1,4 +1,4 @@
# Reasonix Browser Test Contract v1
# [recycle] Reasonix Browser Test Contract v1
## 状态
@@ -1,4 +1,4 @@
# Reasonix Skill Maintainer v1
# [recycle] Reasonix Skill Maintainer v1
## 状态
@@ -1,4 +1,4 @@
# 7-37 Claude Code / Reasonix Worker 评估协议:0524 Bug2 v1
# [recycle] 7-37 Claude Code / Reasonix Worker 评估协议:0524 Bug2 v1
## 目标
@@ -1,4 +1,4 @@
# 7-68 WeKnora 知识库页面 UI 参考
# [recycle] 7-68 WeKnora 知识库页面 UI 参考
状态:reference
范围:只记录 WeKnora 知识库页面可嫁接的页面结构、状态与 MNote 字段映射;不修改 MNote runtime,不修改 WeKnora 源码。
@@ -1,4 +1,4 @@
# Rust Kernel / Web 实现偏差审查
# [recycle] Rust Kernel / Web 实现偏差审查
> 执行状态:已归档到 `design/10-review/done/`。本文保留为历史审查快照,当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。
@@ -1,4 +1,4 @@
# 前端编辑器 / 树体验实现偏差审查
# [recycle] 前端编辑器 / 树体验实现偏差审查
> 执行状态:已归档到 `design/10-review/done/`。本文保留为历史审查快照,当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。
@@ -1,4 +1,4 @@
# Convex / Realtime / Storage 实现偏差审查
# [recycle] Convex / Realtime / Storage 实现偏差审查
> 执行状态:已归档到 `design/10-review/done/`。本文保留为历史审查快照,当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。
@@ -1,4 +1,4 @@
# 次级域与设计治理实现偏差审查
# [recycle] 次级域与设计治理实现偏差审查
> 执行状态:已归档到 `design/10-review/done/`。本文保留为历史审查快照,当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。
@@ -1,4 +1,6 @@
> 执行状态:本文已归档到 `design/10-review/done/`,是 10-review 阶段的树域判断历史记录,不再作为待办清单直接执行。Resource Tree / File Tree / Page Tree 真源合同已由 `/mnt/Data1T/mnote/design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md` 承接;主编辑区 Object Tab、mindmap object editor、`index.md` 隔离已由 `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-12-main-editor-object-tab-resource-alignment-checklist-v1.md` 承接。后续只需按 `06-execution-checklist-and-acceptance.md` 保留 smoke 防回归。
# [recycle] 05 Tree 历史审查
> 执行状态:本文已归档到 `design/old/10-review/done/`,是 10-review 阶段的树域判断历史记录,不再作为待办清单直接执行。Resource Tree / File Tree / Page Tree 真源合同已由 `/mnt/Data1T/mnote/design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md` 承接;主编辑区 Object Tab、mindmap object editor、`index.md` 隔离已由 `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-12-main-editor-object-tab-resource-alignment-checklist-v1.md` 承接。后续只需按 `06-execution-checklist-and-acceptance.md` 保留 smoke 防回归。
结论
我基本同意你的方向,但要把“文件树为根源”说得更精确:不应让“文件树 UI 组件”成为真源,而应让 Rust kernel 中的 workspace resource tree / file tree projection 背后
@@ -1,4 +1,4 @@
# 10-review 顺序执行清单与验收标准
# [recycle] 10-review 顺序执行清单与验收标准
> 执行状态:已完成并归档到 `design/10-review/done/`。本文是本轮 10-review 的最终验收依据与防回归口径,根目录 `design/10-review/README.md` 仅保留索引。
@@ -1,4 +1,4 @@
# 08 [done] Kernel 架构收口与下一阶段优先级 Review / Checklist v1
# [recycle] 08 [done] Kernel 架构收口与下一阶段优先级 Review / Checklist v1
> 更新时间:2026-05-18
>
@@ -1,4 +1,4 @@
# 09 页面 AI 快速块编辑 Runtime Review
# [recycle] 09 页面 AI 快速块编辑 Runtime Review
> 状态:`done`
>
@@ -1,4 +1,4 @@
# 10 [done] 当前 mnote 项目 AI / Page Aggregate 定向 Review v1
# [recycle] 10 [done] 当前 mnote 项目 AI / Page Aggregate 定向 Review v1
> 更新时间:2026-05-17
>
@@ -1,4 +1,4 @@
# 11 [done] 当前完整架构 Review v1
# [recycle] 11 [done] 当前完整架构 Review v1
> 更新时间:2026-05-17
>
@@ -1,4 +1,4 @@
# 15 Design Governance MVP 后阶段 Review v1
# [recycle] 15 Design Governance MVP 后阶段 Review v1
> 状态:done
>
@@ -1,4 +1,4 @@
# 17 Sidex / MNote Workbench Gap Execution Checklist v1
# [recycle] 17 Sidex / MNote Workbench Gap Execution Checklist v1
> 状态:done
>
@@ -1,4 +1,4 @@
# 18 当前 design 口径与 bug 寻找 Review v1
# [recycle] 18 当前 design 口径与 bug 寻找 Review v1
> 创建时间:2026-05-31
>
@@ -1,4 +1,4 @@
# 19 Non-LightRAG design cleanup and follow-up checklist v1
# [recycle] 19 Non-LightRAG design cleanup and follow-up checklist v1
> 创建时间:2026-06-06
>