lix-2026
5f97800489
- wire SQLite control-plane access/session paths into Rust web local-folder routes - preserve local Markdown attachment semantics across upload, reload, and secondary-pane resource tabs - refresh design governance docs, Reasonix task templates, and bug records - retire root .mcp.json local MCP config
132 lines
9.3 KiB
Markdown
132 lines
9.3 KiB
Markdown
# 15 Design Governance MVP 后阶段 Review v1
|
||
|
||
> 状态：done
|
||
>
|
||
> 归档说明（2026-05-21）：四个 Reasonix worker 审查、Codex 复核、done 归档与 reference 迁移已完成；本文归档为本轮 design governance 事实源。
|
||
>
|
||
> 创建时间：2026-05-21
|
||
>
|
||
> 目标：在 local-first MVP 已初步完成、架构方向基本稳定后，统一 `design/` 目录口径，归档过时 process 文档，并明确仍需继续执行的 process 文档。
|
||
|
||
## 1. 当前统一口径
|
||
|
||
MNote 当前已进入 local-first MVP 后阶段：
|
||
|
||
- 本地 workspace folder 是默认数据真相。
|
||
- 本地 `.md` 是页面正文真相。
|
||
- Rust kernel / projection / command 持有树、页面、资源和权限语义。
|
||
- `mnote-web` 是 3000 主 Web 执行面。
|
||
- Rust SQLite control-plane 承接 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 等默认控制面；Convex / 服务端仅保留历史迁移源、显式 cloud source、compat 和 sync replica 边界。
|
||
- 旧 Next / React / wolai-frontend、BlockNote 默认主链、Convex 默认正文/附件/AI 会话全文主存储口径均为 legacy / recycle / compat 背景。
|
||
|
||
## 2. 本轮整理原则
|
||
|
||
1. 仍代表长期方向或当前执行入口的文档保留在 `process/`，但必须叠加 MVP 后阶段口径。
|
||
2. 已完成、已有真实代码或 smoke 证据的执行清单移动到同域 `done/`，并补充归档说明。
|
||
3. 被后续文档覆盖、但不代表已完成的旧稿移动到 `design/old/<domain>/process/`，标题或开头标记 `[recycle]`。
|
||
4. 参考资料、外部产品取证、长期方向说明可以保留在 `process/`，但需要明确“不作为当前执行 checklist”。
|
||
5. 不把旧 Convex / Next / BlockNote 说法改写成当前主线；若保留，必须标注为历史快照或反例。
|
||
|
||
## 3. 并行审查切片
|
||
|
||
- Worker A：`01` / `02` / `03`，重点判断 long-term 架构稿和 Rust Web process 是否仍应继续执行。
|
||
- Worker B：`04-tree-domain`，重点判断 file tree / resource lifecycle / trash / open target 相关 process 是否已由近期 bug/smoke 完成。
|
||
- Worker C：`05-editor-mainline` / `06-mindmap` / `08-wolai` / `09-siyuan`，重点判断编辑器 tab、OnlyOffice、mindmap 和对标流程文档是否仍活跃。
|
||
- Worker D：`07-ai` / `10-review`，重点判断 AI process 与 review process 是否已被后续 Hermes/ACP/local-first 文件编辑口径覆盖。
|
||
|
||
## 4. Codex 归档判定状态
|
||
|
||
本轮使用以下状态：
|
||
|
||
- `keep-process`：继续留在 `process/`，后续仍需执行。
|
||
- `mark-reference`：留在 `reference/`，但只作为长期方向、流程或参考基线，不作为当前直接执行 checklist。
|
||
- `archive-done`：移动到同域 `done/`，因为目标已完成或当前代码已覆盖。
|
||
- `archive-old-process`：移动到 `design/old/<domain>/process/` 并标 `[recycle]`，因为被后续稿覆盖或口径过时但未必完成。
|
||
- `needs-human-confirmation`：证据不足，暂不移动。
|
||
|
||
## 5. 初步本地发现
|
||
|
||
- `design/01-tree-first-graph-kernel/process/1-1-*` 与 `design/03-rust-web/process/3-1-*` 已自述为全景参考，当前优先级应由 `01-05` 和后续 MVP 后阶段 checklist 驱动。
|
||
- `design/03-rust-web/process/3-15-*` 已写明代码、单测和 HTTP smoke 完成，仅真实浏览器 smoke 待补；需要核对是否已有后续真实浏览器证据。
|
||
- `design/04-tree-domain/process/4-38` 到 `4-45` 是 2026-05-20 之后针对资源生命周期、open target、下载、拖拽上传等 bug 的近期 checklist，可能有部分已经由当前未提交 smoke / bug done 覆盖。
|
||
- `design/05-editor-mainline/process/5-15` 到 `5-26` 初始盘点时大多是近期 main editor tab/resource open/OnlyOffice 收口 checklist；本轮已按真实代码和 smoke 证据逐项判定，`5-15` 到 `5-25` 中除继续执行项外已归档到 `done/`，`5-26` 继续保留为 active process。
|
||
- `design/07-ai/process/7-15` 已包含大量完成记录，但仍有 HTTP proxy compat、session resume、permission loop、tool location 等后续切片，不能仅凭完成项归档。
|
||
|
||
## 6. 本轮不做事项
|
||
|
||
- 不改 `design/11-wolai/` 和 `design/90-reference/` 的参考资料归类。
|
||
- 不删除历史文档。
|
||
- 不把 `old/` 下历史稿移动回主线。
|
||
- 不改代码，不跑浏览器 smoke；本轮只做设计文档治理。
|
||
|
||
## 7. Reasonix 并行审查结果
|
||
|
||
本轮已派发四个只读 Reasonix worker，报告路径如下：
|
||
|
||
- Worker A（01/02/03）：`.codex/reasonix-tasks/results/design-governance-worker-a-01-03.md`
|
||
- Worker B（04 tree-domain）：`.codex/reasonix-tasks/results/design-governance-worker-b-04-tree.md`
|
||
- Worker C（05/06/08/09）：`.codex/reasonix-tasks/results/design-governance-worker-c-05-06-08-09.md`
|
||
- Worker D（07/10）：`.codex/reasonix-tasks/results/design-governance-worker-d-07-10.md`
|
||
|
||
Codex 已复核 worker 输出，并额外核对 `3-15` 的真实浏览器 smoke 证据。
|
||
|
||
## 8. 本轮归档到 done
|
||
|
||
以下文档已从 `process/` 移动到对应 `done/`，并在文件头部补充 `done` 状态或归档说明：
|
||
|
||
- `design/01-tree-first-graph-kernel/done/1-7-local-workspace-root-page-bundle-checklist-v1.md`
|
||
- `design/02-convex-rust-long-term-architecture/done/2-3-local-workspace-access-control-productization-v1.md`
|
||
- `design/03-rust-web/done/3-15-local-markdown-asset-upload-relative-path-v1.md`
|
||
- `design/04-tree-domain/done/4-27-resource-lifecycle-command-cutover-v1.md`
|
||
- `design/04-tree-domain/done/4-39-filetree-open-target-resource-identity-checklist-v1.md`
|
||
- `design/04-tree-domain/done/4-40-resource-lifecycle-command-cutover-smoke-checklist-v1.md`
|
||
- `design/04-tree-domain/done/4-41-filetree-bulk-resource-command-cutover-v1.md`
|
||
- `design/04-tree-domain/done/4-42-filetree-open-target-rooturi-contract-v1.md`
|
||
- `design/04-tree-domain/done/4-43-local-folder-sort-order-persistence-v1.md`
|
||
- `design/05-editor-mainline/done/5-15-local-markdown-path-identity-unification-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-16-editor-group-resource-tab-safety-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-17-resource-editor-kind-and-smoke-matrix-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-18-main-editor-tab-state-and-error-placeholder-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-19-resource-open-resolver-and-onlyoffice-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-20-resource-tab-close-confirm-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-21-editor-tab-url-active-identity-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-22-mindmap-main-editor-tab-kind-v1.md`
|
||
- `design/05-editor-mainline/done/5-23-editor-side-target-secondary-pane-v1.md`
|
||
- `design/05-editor-mainline/done/5-24-open-editors-lightweight-view-checklist-v1.md`
|
||
- `design/05-editor-mainline/done/5-25-editor-tab-keyboard-and-mru-checklist-v1.md`
|
||
- `design/07-ai/done/7-16-page-block-ai-real-smoke-followup-matrix-v1.md`
|
||
- `design/07-ai/done/7-30-acp-session-load-resume-checklist-v1.md`
|
||
- `design/07-ai/done/7-31-acp-permission-decision-loop-checklist-v1.md`
|
||
- `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. 本轮迁入 reference
|
||
|
||
以下文档已迁入 `reference/`，不再作为当前直接执行 checklist：
|
||
|
||
- `design/old/03-rust-web/process/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
|
||
|
||
本轮保留为 active process 的主要文档与原因：
|
||
|
||
- `01`：`1-tree-first-graph-kernel-v1`、`1-1`、`1-2`、`1-3`、`1-4`、`1-5`、`1-6` 仍分别承担长期主线、全景参考、产品愿景、持续执行与下一阶段缺口跟踪。
|
||
- `03`：`3-rust-web-long-term-architecture-v1`、`3-1`、`3-3`、`3-13` 仍有架构或未完成迁移项。
|
||
- `04`：`4-28`、`4-34`、`4-38`、`4-44`、`4-45` 仍有 restore focus、local folder no-refresh、open target 前端 cutover、action-layer smoke 和 open editors lifecycle 验证缺口。
|
||
- `05`：`5-6`、`5-9`、`5-26` 仍分别跟踪 Page Aggregate 小尾项、Wolai-aline 持续项和 resource open resolver 收敛。
|
||
- `06`：`6-mindmap-kernel-phase6-projection-editor-v1` 与 `6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1` 仍保留 mindmap 内核/视觉尾项。
|
||
- `07`：`7-10`、`7-12`、`7-14`、`7-15`、`7-27` 仍分别承担 Phase 8 冻结缺口、Hermes tool routing、online/local markdown convergence、ACP 统一层和 final markdown truth 后续修复。
|