docs: separate design reference queue

- 将不直接执行的 process-reference 文档迁入各域 reference 目录 - 更新 design/README、AGENTS 和总序文档，固定 process/draft/reference/done 目录语义 - 修正活跃文档中指向旧 process 位置的参考链接验证：git diff --check；codegraph sync .
2026-05-21 10:19:02 +08:00
parent 1956a8a21a
commit 1569699fbb
30 changed files with 103 additions and 90 deletions
@@ -60,7 +60,7 @@
  - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`
  - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.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/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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/process/5-6-page-aggregate-alignment-checklist-v1.md`
  - `/mnt/Data1T/mnote/design/07-ai/process/7-10-page-block-ai-tooling-execution-checklist-v1.md`
  - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-6-tree-command-protocol-cutover-stage2-v1.md`
@@ -76,9 +76,11 @@

 ## 设计稿目录规则

- `design/01-*` 到 `design/07-*` 主线大类统一按 `process/` 与 `done/` 分层。
- 主线设计稿在推进中时放到对应大类的 `process/`。
+- `design/01-*` 到 `design/10-*` 主线大类统一按目录表达状态：`process/` 放当前可执行项，`done/` 放已完成项，`reference/` 放参考材料，必要时用 `draft/` 放未成形草稿。
+- 主线设计稿在推进中、且可直接拆 checklist 执行时放到对应大类的 `process/`。
 - 主线设计稿在当前真实代码中已完成后，必须移动到对应大类的 `done/`。
+- 参考实现、review 证据、对照矩阵、候选合同、测试流程基线等不直接执行的材料必须移动到对应大类的 `reference/`，不要继续占用 `process/`。
+- 尚未形成可执行 checklist 的新设想先放 `draft/`；进入实施前必须拆成明确 owner、验收和归档条件。
 - 已被后续实现或更新稿明确覆盖、但又不属于 `done` 的旧主线稿，必须移动到 `design/old/` 并标记为 `[recycle]`，不要继续占用活跃 `process/`。
 - `design/old/` 下的历史废弃稿也统一按 `process/` 与 `done/` 分层，但标题继续标记 `[recycle]`。
 - `design/90-reference/` 只放参考资料，不参与 `process/done` 状态迁移。
@@ -139,7 +141,7 @@

 ## Wolai-aline 对标流程

- 凡任务涉及 `wolai-aline`、Wolai 对标、复刻 Wolai 体验或把 `3000` 行为与 Wolai 页面比对，必须启用 `/home/lix/.codex/skills/wolai-aline` skill，并参考 `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`。
+- 凡任务涉及 `wolai-aline`、Wolai 对标、复刻 Wolai 体验或把 `3000` 行为与 Wolai 页面比对，必须启用 `/home/lix/.codex/skills/wolai-aline` skill，并参考 `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md`。
 - Wolai-aline 任务默认采用“Wolai 基线取证（默认只读，编辑器任务可用 Hermes editable-test mode）-> 本地 RED smoke -> 小范围实现 -> 本地验证 -> subagent 浏览器对标复测 -> 主线程截图复核 -> 汇报剩余差异”的流程。
 - 浏览器对标测试必须使用 subagent 执行；subagent 只做浏览器验证和截图，不修改源码、不还原文件、不清理证据；编辑器任务可在明确声明的 Hermes editable-test mode 下做最小编辑验证。
 - Wolai 默认优先只读；当前 Hermes 测试页 `https://www.wolai.com/liaibo/ikFSSM1a4GgvmHBYFCNfVd` 已授权用于 Wolai-aline 编辑器对标，可做最小范围编辑测试。其他 Wolai 页面写入仍需沙盒页 URL 和明确授权。
@@ -271,7 +271,7 @@ OnlyOffice 仍然是：

 对应设计稿：

- `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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/process/5-6-page-aggregate-alignment-checklist-v1.md`
 - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md`

@@ -71,7 +71,7 @@ P0-P6 已经有最小闭环证据；P7 已完成阶段性瘦身，但还不是

 当前状态：

- `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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/process/5-6-page-aggregate-alignment-checklist-v1.md`
 - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md`

@@ -119,7 +119,7 @@ P0-P6 已经有最小闭环证据；P7 已完成阶段性瘦身，但还不是
 - `/mnt/Data1T/mnote/design/03-rust-web/process/3-1-rust-web-long-term-checklist-v2.md`
 - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-sidebar-pagetree-filetree-rust-web-rebuild-v1.md`
 - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-2-sidebar-pagetree-filetree-product-interaction-contract-v1.md`
- `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-2-tiptap-notion-like-template-adoption-v1.md`
+- `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-v1.md`
 - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-4-leptos-tiptap-mainline-correction-v1.md`
 - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-35-convex-filetree-title-md-source-alignment-v1.md`

@@ -29,7 +29,7 @@
 | 文档页入口优先消费 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/process/5-5-page-aggregate-single-truth-alignment-v1.md` |
+| 页面设置运行时语义 / 页头回流 / 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 |

@@ -95,7 +95,7 @@
 | 垃圾箱恢复位置记录 + 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/process/4-23-local-cloud-explicit-bridge-p3-candidate-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 未覆盖

@@ -309,9 +309,9 @@
 ### 6.2 AI 资源工具

 - [x] 设计 `mnote.mindmap.*` 工具：读取结构、增删改节点、移动节点、导出 markdown summary。
-  - 设计：`design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`。
+  - 设计：`design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`。
 - [x] 设计 `mnote.office.*` 工具：读取文本摘要、写入建议、导出变更摘要；真实编辑优先复用 officecli / OnlyOffice 保存链。
-  - 设计：`design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`。
+  - 设计：`design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`。
 - [x] AI 资源工具必须走授权 root 和 resource capability。
  - 实现：Hermes manifest 已暴露 `mnote.mindmap.fetch` / `mnote.mindmap.apply_ops` / `mnote.office.fetch_summary` / `mnote.office.propose_changes`；执行侧统一校验 `rootUri` 本地授权与 `allowedResourceIds` / object identity。
  - 验证：`cargo test -p mnote-web hermes_tools_resource -- --nocapture`；`cargo test -p mnote-web hermes_tools_mindmap -- --nocapture`；`cargo test -p mnote-web hermes_tools_office -- --nocapture`；`cargo test -p mnote-web hermes_tools_manifest_returns_first_batch_tools -- --nocapture`。
@@ -338,7 +338,7 @@
 ### 7.1 导出与备份

 - [x] 设计 Web 导出入口：选择 Convex workspace，选择目标本地 root。
-  - 设计：`design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`；当前 CLI fixture 入口已支持 dry-run / apply / manifest / conflict report / rollback，Web route 与 admin 面板仍按该设计后续落码。
+  - 设计：`design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`；当前 CLI fixture 入口已支持 dry-run / apply / manifest / conflict report / rollback，Web route 与 admin 面板仍按该设计后续落码。
 - [x] 导出前创建 manifest，记录迁移计划、目标 root、workspace、操作列表、冲突、created files、backup dir 与索引刷新结果。
  - 实现：`scripts/export-convex-workspace-to-local.js --manifest <file>`；apply 成功后同时写入 `<root>/.mnote/migration-manifest.json`。
 - [x] 导出页面为 `.md`，资源写为本地文件，附件保持相对路径。
@@ -467,7 +467,7 @@
 - [x] P5 simplemindmap / office 资源模型完成 Resource Tree 产品化。
  - 证据：资源命令面、资源对象壳、AI resource tools 与 changed-files 审计已闭环；`node scripts/task456-resource-object-shell-sync-smoke.js` 已通过。
 - [x] P6 Convex 导出到本地 workspace 有 dry run、备份、冲突报告和回滚。
-  - 证据：`node scripts/task444-convex-workspace-export-local-fixture-smoke.js`；`node scripts/task455-convex-export-plan-rollback-smoke.js`；Web 入口设计见 `design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`。
+  - 证据：`node scripts/task444-convex-workspace-export-local-fixture-smoke.js`；`node scripts/task455-convex-export-plan-rollback-smoke.js`；Web 入口设计见 `design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`。
 - [x] P7 Page Aggregate / tree command / realtime 兼容链完成阶段性瘦身，并把被替代 process 稿移入 `old/` 或 `done/`。
  - 证据：Page Aggregate refresh、tree command、local folder projection refresh 与 realtime 双浏览器 smoke 均有验证；`5-5`、`5-6`、`3-3`、`4-34` 仍作为未完全 kernel-native / local-folder no-refresh 深水区过程稿保留在 `process/`，本 checklist 记录阶段性瘦身结果。
 - [x] `01-05-current-priority-overview.md` 同步更新状态，不再把已完成项描述为当前第一优先级。
@@ -6,7 +6,7 @@
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-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`
 >
@@ -7,7 +7,7 @@
 > 上位依据：
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md`
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
 >
 > 目标：给出一份可以顺序执行、每一步都有完成验收、且标明参考源码位置的下一阶段执行清单。

@@ -7,7 +7,7 @@
 > 上位依据：
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-5-next-phase-sequential-execution-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
 >
 > 目的：基于 Reasonix 执行汇总和本轮核对结果，列出仍不能标完成的缺口，形成可继续顺序执行的补充清单。

@@ -4,7 +4,7 @@
 >
 > 当前状态：`PROCESS`
 >
-> 目标：把本轮 design governance 后剩余的主线 `process/` 文档排成可执行顺序，避免后续 worker 在 40 份 process 中自行猜优先级。
+> 目标：把本轮 design governance 后剩余的主线 `process/` 文档排成可执行顺序，避免后续 worker 在 active process 中自行猜优先级。
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -33,9 +33,9 @@
 - 或者是当前主线架构入口，仍会指导后续实现。
 - 或者有明确阻塞项、smoke 缺口、compat 瘦身缺口。

-### 2.2 Process Reference
+### 2.2 Reference

-保留在 `process/`，但不是当前直接执行 checklist。
+放在对应大类的 `reference/`，不是当前直接执行 checklist。

 典型文档：

@@ -47,6 +47,7 @@
 处理规则：

 - 不迁入 `done/`，因为不是“当前代码已完成”的实现文档。
+- 不保留在 `process/`，避免干扰后续执行队列。
 - 不当作当前 sprint 的任务源。
 - 需要转实施时，新建更小的执行 checklist。

@@ -165,7 +166,7 @@
 入口文档：

 - `design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md`
- `design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md`（reference）
+- `design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md`
 - `design/03-rust-web/process/3-13-rust-web-local-markdown-gfm-ast-parser-migration-v1.md`

 执行目标：
@@ -286,7 +287,7 @@

 - `design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md`
 - `design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md`
- `design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md`（reference）
+- `design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md`

 执行目标：

@@ -304,8 +305,8 @@
 入口文档：

 - `design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md`
- `design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`（workflow reference）
- `design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`（reference）
+- `design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md`
+- `design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`

 执行目标：

@@ -321,17 +322,17 @@

 这些文档不进入当前直接执行序列，只有当产品优先级明确时再拆 checklist：

- `design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`
+- `design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`
  - CLI 已有迁移闭环；Web 管理入口未排期。
- `design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md`
+- `design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md`
  - P3 候选，不能进入 local-first 默认主链。
- `design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md`
+- `design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md`
  - Future sharing contract。
- `design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`
+- `design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`
  - mindmap / office Resource AI tool 草案。
- `design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md`
+- `design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md`
  - 参考边界，不是实施入口。
- `design/10-review/process/12-*`、`13-*`、`14-*`
+- `design/10-review/reference/12-*`、`13-*`、`14-*`
  - 原始 review 证据；执行项已拆出或归档。

 ## 9. 推荐执行批次
@@ -407,7 +408,7 @@
 ## 11. 不做事项

 - 不按文件编号顺序清空 process。
- 不把 `process-reference` 当作当前实现任务。
+- 不把 `reference/` 下的资料当作当前实现任务。
 - 不因为文档老就移动到 `done/`；必须有真实完成证据。
 - 不把 Phase C / Review Mode / cloud sync / sharing future 合同提前实现。
 - 不恢复旧 Next / BlockNote / Convex 默认主存储口径。
@@ -1,6 +1,6 @@
 # 3-17 Convex Export Web Entry v1

-状态：process-reference
+状态：reference

 归档说明（2026-05-21）：CLI 迁移闭环已具备并有 smoke 证据；本文只保留为后续 Web 管理入口设计参考，当前不作为 active implementation checklist。若决定短期落地 Web UI，应新建执行 checklist。

@@ -1,8 +1,8 @@
-# 4-23 [process] Local / Cloud 显式桥接 P3 候选合同 v1
+# 4-23 [reference] Local / Cloud 显式桥接 P3 候选合同 v1

 > 更新时间：2026-05-07
 >
-> 当前状态：`process-reference / P3 candidate`。本文只冻结 Local / Cloud 显式桥接候选合同，未进入当前实施；不得把它当作 local-first 默认读写路径。
+> 当前状态：`reference / P3 candidate`。本文只冻结 Local / Cloud 显式桥接候选合同，未进入当前实施；不得把它当作 local-first 默认读写路径。
 >
 > 关联：
 > - `4-21-local-folder-convex-unified-tree-source-v1.md`
@@ -12,7 +12,7 @@
 > - AI 直改文件、tiptap autosave、外部编辑器修改必须共用 VSCode-like 文件版本冲突模型。
 >
 > 关联文档：
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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-4-leptos-tiptap-mainline-correction-v1.md`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md`
 > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-4-tree-projection-protocol-contract-v1.md`
@@ -6,7 +6,7 @@
 > - 本 checklist 的 Wolai 体验对标仍有效，但数据真相口径跟随 local-first workspace：本地 `.md` 是默认正文真相，Convex-backed 路径只作为兼容 / cloud source。
 > - 历史条目中“写回 Convex-backed 持久化底座”的表述只代表当时 smoke 的在线路径，不再作为新增编辑能力默认目标。
 >
-> 本清单拆自 `5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`。它不是新的测试方案；执行口径统一服从 `/home/lix/.codex/skills/wolai-aline` 与 `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`。
+> 本清单拆自 `5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`。它不是新的测试方案；执行口径统一服从 `/home/lix/.codex/skills/wolai-aline` 与 `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md`。

 ## 1. 使用方式

@@ -1,12 +1,12 @@
-# 5-14 [process] Zed / Lapce / VS Code 参考采用矩阵 v1
+# 5-14 [reference] Zed / Lapce / VS Code 参考采用矩阵 v1

 > 更新时间：2026-05-19
 >
-> 当前状态：`process-reference`。本文是参考实现采用矩阵，不是当前执行 checklist；具体实现任务应拆到对应 domain 的 process/done 文档。
+> 当前状态：`reference`。本文是参考实现采用矩阵，不是当前执行 checklist；具体实现任务应拆到对应 domain 的 process/done 文档。
 >
 > 关联背景：
 > - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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/process/5-6-page-aggregate-alignment-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/07-ai/process/7-14-online-local-ai-markdown-editing-convergence-v1.md`
 > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md`
@@ -1,8 +1,8 @@
-# 5-2 [process] Tiptap Notion-Like 模板裁剪与 `leptos-tiptap` 映射分析 v1
+# 5-2 [reference] Tiptap Notion-Like 模板裁剪与 `leptos-tiptap` 映射分析 v1

 > 更新时间：2026-04-19
 >
-> 当前状态：`process-reference`。本文只作为 tiptap / Notion-like 行为模型参考，不再作为当前执行 checklist；默认主编辑器已是页面内 `leptos-tiptap` island。
+> 当前状态：`reference`。本文只作为 tiptap / Notion-like 行为模型参考，不再作为当前执行 checklist；默认主编辑器已是页面内 `leptos-tiptap` island。
 >
 > 这份文档已经按当前进展修正：
 >
@@ -1,8 +1,8 @@
-# 5-5 [process] 主编辑区与树域单一真源对齐方案 v1
+# 5-5 [reference] 主编辑区与树域单一真源对齐方案 v1

 > 更新时间：2026-05-18
 >
-> 当前状态：`process-reference`。本文作为 Page Aggregate 单一真源长期方案保留；当前执行进度与剩余项以 `5-6` 及 MVP 后阶段 checklist 为准。
+> 当前状态：`reference`。本文作为 Page Aggregate 单一真源长期方案保留；当前执行进度与剩余项以 `5-6` 及 MVP 后阶段 checklist 为准。
 >
 > 2026-05-18 口径补充：
 > - 页面聚合的默认 source 已开始向 local-first workspace 收口；页面正文、标题、设置和上传资源不应再默认把 Convex 视作主数据层。
@@ -1,10 +1,10 @@
-# 5-7 [process] Wolai 页面树与主编辑器体验复刻方案 v1
+# 5-7 [reference] Wolai 页面树与主编辑器体验复刻方案 v1

 > 更新时间：2026-04-30
 >
-> 当前状态：`process-reference`。本文只保留 Wolai 体验复刻目标和取证基线；持续执行与安全边界以 `08-wolai-aline-test-flow` 和 `wolai-aline` skill 为准。
+> 当前状态：`reference`。本文只保留 Wolai 体验复刻目标和取证基线；持续执行与安全边界以 `08-wolai-aline-test-flow` 和 `wolai-aline` skill 为准。

-> **Wolai-aline 执行口径更新（2026-04-30）：** 本文只保留体验复刻任务拆解和产品目标。所有 Wolai 对标测试、浏览器取证、编辑权限、安全边界、subagent 使用、截图复核和 smoke 补齐，统一以 `/home/lix/.codex/skills/wolai-aline` 与 `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md` 为准。若本文旧段落与该 skill 冲突，以 skill 为准。
+> **Wolai-aline 执行口径更新（2026-05-21）：** 本文只保留体验复刻任务拆解和产品目标。所有 Wolai 对标测试、浏览器取证、编辑权限、安全边界、subagent 使用、截图复核和 smoke 补齐，统一以 `/home/lix/.codex/skills/wolai-aline` 与 `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md` 为准。若本文旧段落与该 skill 冲突，以 skill 为准。
 >
 > 关联文档：
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -16,9 +16,9 @@
 > - `/mnt/Data1T/mnote/design/03-rust-web/process/3-3-rust-web-tree-realtime-event-stream-v1.md`
 > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-2-sidebar-pagetree-filetree-product-interaction-contract-v1.md`
 > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-6-tree-command-protocol-cutover-stage2-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-2-tiptap-notion-like-template-adoption-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-v1.md`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-4-leptos-tiptap-mainline-correction-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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/process/5-6-page-aggregate-alignment-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md`
@@ -151,7 +151,7 @@
 本节旧版“published / owner readonly / sandbox mutation”分层已经收口到 `wolai-aline` skill。后续执行不再从本文推导测试策略，统一遵循：

 - Codex skill：`/home/lix/.codex/skills/wolai-aline`
- 流程文档：`/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`
+- 流程文档：`/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md`
 - 失败模式：`/home/lix/.codex/skills/wolai-aline/references/failure-patterns.md`

 现行要点：
@@ -11,7 +11,7 @@
 > - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.md`
 > - `/mnt/Data1T/mnote/design/03-rust-web/process/3-rust-web-long-term-architecture-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.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/reference-code/lx-doc/mind-map`
@@ -37,7 +37,7 @@ Rust kernel truth
 ### 当前主线文档

 - `design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md`
- `design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md`
+- `design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md`
 - `docs/superpowers/plans/2026-05-10-mindmap-phase6-projection-editor-checklist.md`

 ### lx-doc / KMind 参考
@@ -137,7 +137,7 @@ Rust kernel truth
 - Inspect: `wolai-frontend/src/components/editor/blocks/MindmapMiniMap.tsx`
 - Inspect: `wolai-frontend/src/components/editor/blocks/MindmapCount.tsx`
 - Inspect: `wolai-frontend/src/components/editor/blocks/MindmapContextMenu.tsx`
- Output: `design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md`
+- Output: `design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md`

 - [x] 列出历史 toolbar 分组：历史操作、节点操作、插入扩展、样式、结构、导入导出、视图操作。
 - [x] 列出每个 toolbar action 的旧实现来源、旧 runtime 调用、禁用条件、是否需要 active node。
@@ -146,7 +146,7 @@ Rust kernel truth
 - [x] 列出历史 context menu 能力：插入、删除、复制、粘贴、展开折叠、概要、关联线、样式。
 - [x] 标注哪些能力第一阶段必须迁移，哪些只保留 schema 但暂不显示。
 - [x] 验证：输出表格至少覆盖 toolbar、sidebar、navigator、context menu 四类能力，并能追溯到具体文件名。
-  - 2026-05-11 输出：`design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md` 第 8 节。
+  - 2026-05-11 输出：`design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md` 第 8 节。

 ### Task 3: 建立中立 UI Schema

@@ -450,7 +450,7 @@ Rust kernel truth

 **Files:**
 - Modify: `design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md`
- Modify: `design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md`
+- Modify: `design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md`
 - Modify: `design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md`
 - Modify: `docs/superpowers/plans/2026-05-10-mindmap-phase6-projection-editor-checklist.md`

@@ -1,8 +1,8 @@
-# 6 [process] Mindmap leptos adapter reference notes v1
+# 6 [reference] Mindmap leptos adapter reference notes v1

 > 日期：2026-05-10
 >
-> 当前状态：`process-reference`。本文是 adapter/reference 审计笔记，不作为当前执行 checklist；mindmap 实施状态以 `6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1` 和 `done/6-mindmap-phase6-kmind-parity-detail-checklist-v1.md` 为准。
+> 当前状态：`reference`。本文是 adapter/reference 审计笔记，不作为当前执行 checklist；mindmap 实施状态以 `6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1` 和 `done/6-mindmap-phase6-kmind-parity-detail-checklist-v1.md` 为准。
 >
 > 目的：记录 `lx-doc/mind-map` 与 KMind 插件审计结果，为 Phase 6 `leptos-mindmap` 的 simple-mind-map bridge、command bridge 和第一阶段 UI 复刻定界。

@@ -14,7 +14,7 @@
 > - `/mnt/Data1T/mnote/recycle/design/07-ai/retired-http-hermes/7-5-hermes-client-proxy-contract-v1.md`（已退役历史背景）
 > - `/mnt/Data1T/mnote/design/07-ai/process/7-10-page-block-ai-tooling-execution-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/07-ai/process/7-14-online-local-ai-markdown-editing-convergence-v1.md`
-> - `/mnt/Data1T/mnote/design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md`
+> - `/mnt/Data1T/mnote/design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/reference-code/hermes-vscode-main/`
 > - `/mnt/Data1T/mnote/design/05-editor-mainline/reference-code/DeepSeek-Reasonix-main/`

@@ -1,8 +1,8 @@
-# 7-17 [process] ACP Session 与控制面账号作用域 / 分享合同 v1
+# 7-17 [reference] ACP Session 与控制面账号作用域 / 分享合同 v1

 > 创建时间：2026-05-18
 >
-> 当前状态：`process-reference / future`
+> 当前状态：`reference / future`
 >
 > 归档说明（2026-05-21）：本文冻结 ACP session 与控制面分享/账号作用域远期合同；当前只作为 future reference，不作为 MVP 后阶段 active implementation checklist。
 >
@@ -1,6 +1,6 @@
 # 7-28 Resource AI Tool Contract v1

-状态：process-reference
+状态：reference

 说明（2026-05-21）：本文冻结 mindmap / office 等 Resource AI tool 合同草案；当前不是 local-first 普通 Markdown 编辑主路径，也不是 active implementation checklist。

@@ -1,6 +1,6 @@
 # Wolai-aline 对标测试流程 v1

-> 状态：process-reference / active workflow
+> 状态：reference / active workflow
 >
 > 本流程用于所有以 Wolai 体验复刻、对标、aline/alignment 为目标的任务。目标不是只做出类似文案，而是用真实 Wolai 行为和本地 `3000` 行为做可复现对比，形成可回归的 smoke 与截图证据。

@@ -1,8 +1,8 @@
-# 9 [process] SiYuan 参考边界与可借鉴能力 v1
+# 9 [reference] SiYuan 参考边界与可借鉴能力 v1

 > 更新时间：2026-05-11
 >
-> 当前状态：`process-reference`。本文只保留思源参考边界与可借鉴能力，不覆盖 `01-05` 当前优先级，也不作为当前执行 checklist。
+> 当前状态：`reference`。本文只保留思源参考边界与可借鉴能力，不覆盖 `01-05` 当前优先级，也不作为当前执行 checklist。
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -10,7 +10,7 @@
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.md`
 > - `/mnt/Data1T/mnote/design/03-rust-web/process/3-rust-web-long-term-architecture-v1.md`
 > - `/mnt/Data1T/mnote/design/03-rust-web/process/3-3-rust-web-tree-realtime-event-stream-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md`
 > - `/mnt/Data1T/mnote/design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md`
 >
 > 外部参考：
@@ -2,7 +2,7 @@

 > 状态：done
 >
-> 归档说明（2026-05-21）：四个 Reasonix worker 审查、Codex 复核、done 归档与 process-reference 标注已完成；本文归档为本轮 design governance 事实源。
+> 归档说明（2026-05-21）：四个 Reasonix worker 审查、Codex 复核、done 归档与 reference 迁移已完成；本文归档为本轮 design governance 事实源。
 >
 > 创建时间：2026-05-21
 >
@@ -39,7 +39,7 @@ MNote 当前已进入 local-first MVP 后阶段：
 本轮使用以下状态：

 - `keep-process`：继续留在 `process/`，后续仍需执行。
- `mark-process-reference`：留在 `process/`，但只作为长期方向、流程或参考基线，不作为当前直接执行 checklist。
+- `mark-reference`：留在 `reference/`，但只作为长期方向、流程或参考基线，不作为当前直接执行 checklist。
 - `archive-done`：移动到同域 `done/`，因为目标已完成或当前代码已覆盖。
 - `archive-old-process`：移动到 `design/old/<domain>/process/` 并标 `[recycle]`，因为被后续稿覆盖或口径过时但未必完成。
 - `needs-human-confirmation`：证据不足，暂不移动。
@@ -100,24 +100,24 @@ Codex 已复核 worker 输出，并额外核对 `3-15` 的真实浏览器 smoke
 - `design/07-ai/done/7-32-acp-tool-location-and-open-action-checklist-v1.md`
 - `design/07-ai/done/7-33-acp-session-info-plan-ui-checklist-v1.md`

-## 9. 本轮标记为 process-reference
+## 9. 本轮迁入 reference

-以下文档仍保留在 `process/`，但已标注为 `process-reference`，不再作为当前直接执行 checklist：
+以下文档已迁入 `reference/`，不再作为当前直接执行 checklist：

- `design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`
- `design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md`
- `design/05-editor-mainline/process/5-2-tiptap-notion-like-template-adoption-v1.md`
- `design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md`
- `design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`
- `design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
- `design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md`
- `design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md`
- `design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`
- `design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`
- `design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md`
- `design/10-review/process/12-sidex-vscode-workbench-gap-review-v1.md`
- `design/10-review/process/13-hermes-vscode-plugin-gap-review-v1.md`
- `design/10-review/process/14-sidex-workbench-gap-followup-review-v1.md`
+- `design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`
+- `design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md`
+- `design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-v1.md`
+- `design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md`
+- `design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`
+- `design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
+- `design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md`
+- `design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md`
+- `design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`
+- `design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md`
+- `design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md`
+- `design/10-review/reference/12-sidex-vscode-workbench-gap-review-v1.md`
+- `design/10-review/reference/13-hermes-vscode-plugin-gap-review-v1.md`
+- `design/10-review/reference/14-sidex-workbench-gap-followup-review-v1.md`

 ## 10. 仍需继续执行的 process

@@ -1,6 +1,6 @@
 # 12 Sidex / VSCode Workbench 对照审查 v1

-> 状态：process-reference
+> 状态：reference
 >
 > 归档说明（2026-05-21）：本 review 的 P0/P1/P2 缺口已拆分到 `4-*` / `5-*` 执行 checklist；本文保留为 Sidex / VSCode 对照原始证据，不再作为直接执行清单。
 >
@@ -1,6 +1,6 @@
 # 13 Hermes VSCode 插件对照审查 v1

-> 状态：process-reference
+> 状态：reference
 >
 > 归档说明（2026-05-21）：P0 缺口已拆分到 `7-30` 至 `7-33` 并完成归档；本文保留 Hermes VSCode 插件对照证据和 P1/P2 参考项。
 >
@@ -1,6 +1,6 @@
 # 14 Sidex / MNote Workbench Gap Follow-up Review v1

-> 状态：process-reference
+> 状态：reference
 >
 > 归档说明（2026-05-21）：本 follow-up review 已拆分出 `5-24`、`5-25`、`5-26`、`4-45` 等执行项；本文保留为后续 workbench 对照参考，不作为直接执行清单。
 >
@@ -11,8 +11,9 @@
 >
 > 状态口径以当前仓库真实代码为准：
 > - `[done]`：对应阶段或收口目标已经在当前主线代码中成立
-> - `[process]`：方向已进入主线，但仍在推进中
-> - `[process-reference]`：仍在 `process/` 下保留，但只作为参考流程、候选合同、对照证据或长期设计边界；不代表当前可直接执行的 checklist
+> - `[process]`：方向已进入主线，且当前可以直接拆 checklist / owner / 验收继续执行
+> - `[draft]`：方向尚未成形，不能直接派发实现
+> - `[reference]`：参考流程、候选合同、对照证据、review 原始材料或长期设计边界；不代表当前可直接执行的 checklist
 > - `[recycle]`：已废弃、已被后续稿件替代，统一归档到 `old/`

 ## 当前优先级入口
@@ -27,44 +28,53 @@
 1. `01-tree-first-graph-kernel/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
 2. `02-convex-rust-long-term-architecture/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
 3. `03-rust-web/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
 4. `04-tree-domain/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
 5. `05-editor-mainline/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
   - `reference-code/` 放编辑器参考代码
 6. `06-mindmap/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
 7. `07-ai/`
   - `process/` 放推进中的主线稿
   - `done/` 放已在真实代码中成立的主线稿
+   - `reference/` 放参考材料；`draft/` 放未成形草稿
 8. `08-wolai-aline-test-flow/`
-   - `process/` 放推进中的测试流程与对标执行稿
+   - `reference/` 放 Wolai 对标流程基线；具体执行任务应拆到对应主线 `process/`
 9. `09-siyuan-reference/`
-   - `process/` 放思源参考、借鉴边界与能力盘点稿
+   - `reference/` 放思源参考、借鉴边界与能力盘点稿
 10. `10-review/`
   - `done/` 放阶段性代码 / 架构审查证据和结论
+   - `reference/` 放对照审查原始证据、参考矩阵和后续候选项
   - 只作为当前实现状态证据和历史审查归档，不作为新的主线优先级入口

 ## 迁移规则

 - 主线设计稿完成后，必须从对应大类的 `process/` 移动到 `done/`。
 - 仅以当前真实代码为准判断是否完成，不能只按稿件自述判断。
- 对于未完成但当前不排期的候选设计、参考矩阵、对标流程和 review 原始证据，不移动到 `done/`，必须在文件头部标记 `process-reference` 并说明当前不作为 active implementation checklist。
+- 对于未完成但当前不排期的候选设计、参考矩阵、对标流程和 review 原始证据，不移动到 `done/`，必须移动到对应大类的 `reference/` 并在文件头部标记 `[reference]`。
+- 只有能直接执行的 checklist 才允许留在 `process/`；如果只是想法但还没形成 owner / 验收 / 归档条件，先放 `draft/`。
 - 废弃稿统一移动到 `old/` 对应大类下，再按历史成熟度放入 `process/` 或 `done/`。

 ## 辅助目录

 - `90-reference/`
-  - 参考资料，不参与 `[done]/[process]/[recycle]` 状态判断
+  - 跨域生态参考资料，不参与 `[done]/[process]/[draft]/[reference]/[recycle]` 状态判断
  - 引用时只能作为生态资料或背景材料，不能覆盖 `ARCHITECTURE.md`、`AGENTS.md`、`01-05` 当前优先级或对应主线 `process/` / `done/` 设计稿
 - `old/`
  - 已废弃或被替代的历史稿件，标题统一标记 `[recycle]`