From 1569699fbb78afa3e17d8118ab16ed81cd5a53d0 Mon Sep 17 00:00:00 2001 From: lix-2026 Date: Thu, 21 May 2026 10:19:02 +0800 Subject: [PATCH] docs: separate design reference queue MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 将不直接执行的 process-reference 文档迁入各域 reference 目录 - 更新 design/README、AGENTS 和总序文档，固定 process/draft/reference/done 目录语义 - 修正活跃文档中指向旧 process 位置的参考链接 验证：git diff --check；codegraph sync . --- AGENTS.md | 10 +++--- ARCHITECTURE.md | 2 +- design/01-05-current-priority-overview.md | 4 +-- ...-first-graph-product-vision-progress-v1.md | 4 +-- ...current-priority-execution-checklist-v1.md | 8 ++--- .../1-4-next-phase-execution-roadmap-v1.md | 2 +- ...phase-sequential-execution-checklist-v1.md | 2 +- ...1-6-next-phase-gap-closure-checklist-v1.md | 2 +- ...1-8-mvp-post-process-execution-order-v1.md | 29 +++++++-------- .../3-17-convex-export-web-entry-v1.md | 2 +- ...l-cloud-explicit-bridge-p3-candidate-v1.md | 4 +-- ...6-page-aggregate-alignment-checklist-v1.md | 2 +- ...5-9-wolai-aline-continuous-checklist-v1.md | 2 +- ...pce-vscode-reference-adoption-matrix-v1.md | 6 ++-- ...tiptap-notion-like-template-adoption-v1.md | 4 +-- ...age-aggregate-single-truth-alignment-v1.md | 4 +-- ...e-main-editor-experience-restoration-v1.md | 12 +++---- ...dmap-kernel-phase6-projection-editor-v1.md | 2 +- ...ase6-leptos-ui-shell-reuse-checklist-v1.md | 8 ++--- ...ndmap-leptos-adapter-reference-notes-v1.md | 4 +-- ...e-ai-acp-agent-runtime-unified-layer-v1.md | 2 +- ...-acp-session-convex-sharing-contract-v1.md | 4 +-- .../7-28-resource-ai-tool-contract-v1.md | 2 +- .../wolai-aline-test-flow-v1.md | 2 +- ...yuan-reference-boundary-and-adoption-v1.md | 6 ++-- ...15-design-governance-mvp-post-review-v1.md | 36 +++++++++---------- ...12-sidex-vscode-workbench-gap-review-v1.md | 2 +- .../13-hermes-vscode-plugin-gap-review-v1.md | 2 +- ...-sidex-workbench-gap-followup-review-v1.md | 2 +- design/README.md | 22 ++++++++---- 30 files changed, 103 insertions(+), 90 deletions(-) rename design/03-rust-web/{process => reference}/3-17-convex-export-web-entry-v1.md (99%) rename design/04-tree-domain/{process => reference}/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md (93%) rename design/05-editor-mainline/{process => reference}/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md (98%) rename design/05-editor-mainline/{process => reference}/5-2-tiptap-notion-like-template-adoption-v1.md (96%) rename design/05-editor-mainline/{process => reference}/5-5-page-aggregate-single-truth-alignment-v1.md (98%) rename design/05-editor-mainline/{process => reference}/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md (98%) rename design/06-mindmap/{process => reference}/6-mindmap-leptos-adapter-reference-notes-v1.md (97%) rename design/07-ai/{process => reference}/7-17-acp-session-convex-sharing-contract-v1.md (99%) rename design/07-ai/{process => reference}/7-28-resource-ai-tool-contract-v1.md (99%) rename design/08-wolai-aline-test-flow/{process => reference}/wolai-aline-test-flow-v1.md (99%) rename design/09-siyuan-reference/{process => reference}/9-siyuan-reference-boundary-and-adoption-v1.md (97%) rename design/10-review/{process => reference}/12-sidex-vscode-workbench-gap-review-v1.md (99%) rename design/10-review/{process => reference}/13-hermes-vscode-plugin-gap-review-v1.md (99%) rename design/10-review/{process => reference}/14-sidex-workbench-gap-followup-review-v1.md (99%) diff --git a/AGENTS.md b/AGENTS.md index 09ab97de..aecfdc9b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 和明确授权。 diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index e7689a1c..808d2d93 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -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` diff --git a/design/01-05-current-priority-overview.md b/design/01-05-current-priority-overview.md index 2a136fc8..e6f5151b 100644 --- a/design/01-05-current-priority-overview.md +++ b/design/01-05-current-priority-overview.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` diff --git a/design/01-tree-first-graph-kernel/process/1-2-tree-first-graph-product-vision-progress-v1.md b/design/01-tree-first-graph-kernel/process/1-2-tree-first-graph-product-vision-progress-v1.md index 3f5ff04a..47e93a40 100644 --- a/design/01-tree-first-graph-kernel/process/1-2-tree-first-graph-product-vision-progress-v1.md +++ b/design/01-tree-first-graph-kernel/process/1-2-tree-first-graph-product-vision-progress-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 未覆盖 diff --git a/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md b/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md index 0acff7ad..8b7e4832 100644 --- a/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md +++ b/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md @@ -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 `；apply 成功后同时写入 `/.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` 同步更新状态，不再把已完成项描述为当前第一优先级。 diff --git a/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md b/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md index ea5ab96f..e1a7c345 100644 --- a/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md +++ b/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.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` > diff --git a/design/01-tree-first-graph-kernel/process/1-5-next-phase-sequential-execution-checklist-v1.md b/design/01-tree-first-graph-kernel/process/1-5-next-phase-sequential-execution-checklist-v1.md index 0f56684c..47835f8e 100644 --- a/design/01-tree-first-graph-kernel/process/1-5-next-phase-sequential-execution-checklist-v1.md +++ b/design/01-tree-first-graph-kernel/process/1-5-next-phase-sequential-execution-checklist-v1.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` > > 目标：给出一份可以顺序执行、每一步都有完成验收、且标明参考源码位置的下一阶段执行清单。 diff --git a/design/01-tree-first-graph-kernel/process/1-6-next-phase-gap-closure-checklist-v1.md b/design/01-tree-first-graph-kernel/process/1-6-next-phase-gap-closure-checklist-v1.md index 28d04bcd..9ced326b 100644 --- a/design/01-tree-first-graph-kernel/process/1-6-next-phase-gap-closure-checklist-v1.md +++ b/design/01-tree-first-graph-kernel/process/1-6-next-phase-gap-closure-checklist-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 执行汇总和本轮核对结果，列出仍不能标完成的缺口，形成可继续顺序执行的补充清单。 diff --git a/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md b/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md index 8f5cabab..169d6520 100644 --- a/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md +++ b/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md @@ -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 默认主存储口径。 diff --git a/design/03-rust-web/process/3-17-convex-export-web-entry-v1.md b/design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md similarity index 99% rename from design/03-rust-web/process/3-17-convex-export-web-entry-v1.md rename to design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md index 4b0fa610..ab959c45 100644 --- a/design/03-rust-web/process/3-17-convex-export-web-entry-v1.md +++ b/design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md @@ -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。 diff --git a/design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md b/design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md similarity index 93% rename from design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md rename to design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md index 21d639ea..2dd6b0e5 100644 --- a/design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md +++ b/design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md @@ -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` diff --git a/design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md b/design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md index b870173c..b2a5ce2d 100644 --- a/design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md +++ b/design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-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` diff --git a/design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md b/design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md index 85952651..2cd14f05 100644 --- a/design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md +++ b/design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-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. 使用方式 diff --git a/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md b/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md similarity index 98% rename from design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md rename to design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md index 6b40e163..cb504819 100644 --- a/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md +++ b/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md @@ -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` diff --git a/design/05-editor-mainline/process/5-2-tiptap-notion-like-template-adoption-v1.md b/design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-v1.md similarity index 96% rename from design/05-editor-mainline/process/5-2-tiptap-notion-like-template-adoption-v1.md rename to design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-v1.md index 792f293a..1d07f2ca 100644 --- a/design/05-editor-mainline/process/5-2-tiptap-notion-like-template-adoption-v1.md +++ b/design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-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。 > > 这份文档已经按当前进展修正： > diff --git a/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md b/design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md similarity index 98% rename from design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md rename to design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md index db4c5759..3946e507 100644 --- a/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md +++ b/design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md @@ -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 视作主数据层。 diff --git a/design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md b/design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md similarity index 98% rename from design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md rename to design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md index 2751a071..637557de 100644 --- a/design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md +++ b/design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md @@ -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` 现行要点： diff --git a/design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md b/design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md index df231ead..00d3a985 100644 --- a/design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md +++ b/design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.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` diff --git a/design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md b/design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md index 77fc4156..8c321237 100644 --- a/design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md +++ b/design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md @@ -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` diff --git a/design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md b/design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md similarity index 97% rename from design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md rename to design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md index 3dc21d89..493cd6b1 100644 --- a/design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md +++ b/design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.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 复刻定界。 diff --git a/design/07-ai/process/7-15-page-ai-acp-agent-runtime-unified-layer-v1.md b/design/07-ai/process/7-15-page-ai-acp-agent-runtime-unified-layer-v1.md index 2fff8c4d..03e4d6b1 100644 --- a/design/07-ai/process/7-15-page-ai-acp-agent-runtime-unified-layer-v1.md +++ b/design/07-ai/process/7-15-page-ai-acp-agent-runtime-unified-layer-v1.md @@ -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/` diff --git a/design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md b/design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md similarity index 99% rename from design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md rename to design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md index 27bb2fba..1182c272 100644 --- a/design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md +++ b/design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md @@ -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。 > diff --git a/design/07-ai/process/7-28-resource-ai-tool-contract-v1.md b/design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md similarity index 99% rename from design/07-ai/process/7-28-resource-ai-tool-contract-v1.md rename to design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md index 7f9881f8..6422b374 100644 --- a/design/07-ai/process/7-28-resource-ai-tool-contract-v1.md +++ b/design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md @@ -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。 diff --git a/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md b/design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md similarity index 99% rename from design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md rename to design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md index 09f9beb5..c358bf95 100644 --- a/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md +++ b/design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md @@ -1,6 +1,6 @@ # Wolai-aline 对标测试流程 v1 -> 状态：process-reference / active workflow +> 状态：reference / active workflow > > 本流程用于所有以 Wolai 体验复刻、对标、aline/alignment 为目标的任务。目标不是只做出类似文案，而是用真实 Wolai 行为和本地 `3000` 行为做可复现对比，形成可回归的 smoke 与截图证据。 diff --git a/design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md b/design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md similarity index 97% rename from design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md rename to design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md index 4b5f87eb..51206ba1 100644 --- a/design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md +++ b/design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md @@ -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` > > 外部参考： diff --git a/design/10-review/done/15-design-governance-mvp-post-review-v1.md b/design/10-review/done/15-design-governance-mvp-post-review-v1.md index 5b1cc023..30ff6fbf 100644 --- a/design/10-review/done/15-design-governance-mvp-post-review-v1.md +++ b/design/10-review/done/15-design-governance-mvp-post-review-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//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 diff --git a/design/10-review/process/12-sidex-vscode-workbench-gap-review-v1.md b/design/10-review/reference/12-sidex-vscode-workbench-gap-review-v1.md similarity index 99% rename from design/10-review/process/12-sidex-vscode-workbench-gap-review-v1.md rename to design/10-review/reference/12-sidex-vscode-workbench-gap-review-v1.md index c652251d..881405cf 100644 --- a/design/10-review/process/12-sidex-vscode-workbench-gap-review-v1.md +++ b/design/10-review/reference/12-sidex-vscode-workbench-gap-review-v1.md @@ -1,6 +1,6 @@ # 12 Sidex / VSCode Workbench 对照审查 v1 -> 状态：process-reference +> 状态：reference > > 归档说明（2026-05-21）：本 review 的 P0/P1/P2 缺口已拆分到 `4-*` / `5-*` 执行 checklist；本文保留为 Sidex / VSCode 对照原始证据，不再作为直接执行清单。 > diff --git a/design/10-review/process/13-hermes-vscode-plugin-gap-review-v1.md b/design/10-review/reference/13-hermes-vscode-plugin-gap-review-v1.md similarity index 99% rename from design/10-review/process/13-hermes-vscode-plugin-gap-review-v1.md rename to design/10-review/reference/13-hermes-vscode-plugin-gap-review-v1.md index 79adb4f4..f06e5b6a 100644 --- a/design/10-review/process/13-hermes-vscode-plugin-gap-review-v1.md +++ b/design/10-review/reference/13-hermes-vscode-plugin-gap-review-v1.md @@ -1,6 +1,6 @@ # 13 Hermes VSCode 插件对照审查 v1 -> 状态：process-reference +> 状态：reference > > 归档说明（2026-05-21）：P0 缺口已拆分到 `7-30` 至 `7-33` 并完成归档；本文保留 Hermes VSCode 插件对照证据和 P1/P2 参考项。 > diff --git a/design/10-review/process/14-sidex-workbench-gap-followup-review-v1.md b/design/10-review/reference/14-sidex-workbench-gap-followup-review-v1.md similarity index 99% rename from design/10-review/process/14-sidex-workbench-gap-followup-review-v1.md rename to design/10-review/reference/14-sidex-workbench-gap-followup-review-v1.md index 07ad577b..c7240a3b 100644 --- a/design/10-review/process/14-sidex-workbench-gap-followup-review-v1.md +++ b/design/10-review/reference/14-sidex-workbench-gap-followup-review-v1.md @@ -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 对照参考，不作为直接执行清单。 > diff --git a/design/README.md b/design/README.md index ca68f5c9..ef5f9068 100644 --- a/design/README.md +++ b/design/README.md @@ -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]`