lix/mnote

Files

T

lix-2026 1956a8a21a chore: align mvp design governance

- 统一 local-first MVP 后阶段架构口径，补充 process 执行总序和 Reasonix 协作记录

- 归档已完成的 design checklist，标注参考型 process，更新 AGENTS/REASONIX/架构文档

- 补充文件树/主编辑器下载与上下文菜单相关实现、bug 记录和 smoke 脚本

验证：git diff --check；codegraph sync .；cargo test -p mnote-web；node --check scripts/task476-filetree-editor-context-menu-download-smoke.js

2026-05-21 09:04:13 +08:00

15 KiB

Raw Blame History

Design Governance Report — Worker C: 05/06/08/09 Review

Generated: 2026-05-21 Scope: design/05-editor-mainline/process/, design/06-mindmap/process/, design/08-wolai-aline-test-flow/process/, design/09-siyuan-reference/process/

Executive Summary

Of 22 process documents reviewed:

Status	Count	Documents
archive-done	10	5-15, 5-17, 5-18, 5-19, 5-20, 5-21, 5-22, 5-23, 5-24, 5-25
keep-process	4	5-26, 5-9, 5-6 (partial), 6-mindmap-phase6-leptos-ui-shell-reuse-checklist
mark-process-reference	7	5-5, 5-2, 5-7, 5-14, 6-mindmap-leptos-adapter-reference-notes, wolai-aline-test-flow-v1, 9-siyuan-reference
needs-human-confirmation	1	5-16 (minor open items, superseded by later docs)

Highest risk: 5-26 remains unexecuted — convergence plan proposed but never landed. 5-9 Phase F (Page Aggregate items) still shows TODO but the work was done in 5-6 checklists (mild stale reference risk). Mindmap leptos-mindmap checklist is large and has visual parity items that haven't been systematically closed.

1. `design/05-editor-mainline/process/` — 18 files

5-15 — local-markdown-path-identity-unification-checklist-v1

建议状态：archive-done

证据: 所有 P0 (3 items) 和 P1 (1 item) checklist 均已勾选完成。文档末尾 执行状态（2026-05-19） 列出了所有已完成的验收命令和补充清理（删除 ParsedLocalMarkdownPage.mnote_id 字段）。
归档原因: 这是一个单次执行的 checklist，所有目标均已验证通过。后续身份逻辑若有回归需求，可查阅 done/。
补充说明: 验收命令完整可复现，是存档质量良好的 checklist。

5-16 — editor-group-resource-tab-safety-checklist-v1

建议状态：needs-human-confirmation

证据: 核心项已完成：resource tab MRU、关闭 guard、aria-selected/tabindex、task460 smoke。剩余未完成项：正式 MainEditorTabEntry 模型（后被 5-18 的状态模型覆盖）、打开失败 placeholder tab（后被 5-18 完整实现）。
留存原因: 未完成的 2 项已被后续 checklists (5-18) 解决，文档本身已无独立未完成工作。
建议: 若确认 5-18 已完全覆盖 placeholder tab 需求，可归档。需人工确认。

5-17 — resource-editor-kind-and-smoke-matrix-checklist-v1

建议状态：archive-done

证据: 核心项已完成：PDF 独立 badge kind、file fallback badge、smoke 覆盖 markdown/text/code/image/pdf 未知类型。scripts/task461-resource-kind-smoke.js 已通过。
归档原因: 未完成项（正式 resolver 抽象、Office DocumentServer 回源、active-tab/side/new-window 统一 resolver）已由 5-19 和 5-26 覆盖。本文件是 5-17→5-19→5-26 递进的第一层，已完成的历史阶段。

5-18 — main-editor-tab-state-and-error-placeholder-checklist-v1

建议状态：archive-done

证据: 所有 checklist 项已勾选。createResourceSession 已补 lastActiveAt，openResourceInActiveTab 失败时保留 error placeholder tab。task462 smoke 通过。
归档原因: 未完成项（lastActiveAt 未用于排序、dirty guard 无 UI 确认弹窗）属于后续 5-20 的独立主题。本文件闭环了主状态模型和错误占位。

5-19 — resource-open-resolver-and-onlyoffice-checklist-v1

建议状态：archive-done

证据: 所有 checklist 项已执行。resolveResourceOpen 已定义，buildOnlyOfficeOpenUrl 已修正回源 URL，task463 smoke 覆盖 docx/pptx/xlsx badge、iframe、new-window。
归档原因: 唯一未完成项——“未验证真实外部 DocumentServer 协同编辑会话”，这属于外部服务可用性测试而非设计执行，不应阻塞归档。

5-20 — resource-tab-close-confirm-checklist-v1

建议状态：archive-done

证据: 所有 checklist 项已勾选并验证。showResourceTabCloseGuardNotice 对 dirty/saving/hasExternalConflict 输出可见提示，task460 断言可见提示不堆叠。
归档原因: 单次执行 checklist，已完成闭环。

5-21 — editor-tab-url-active-identity-checklist-v1

建议状态：archive-done

证据: 所有项已勾选。resource tab 激活写入 resourceTab=<canonical identity> URL state，filetree row 设 data-active=true，task457 覆盖全路径。
归档原因: 单次执行 checklist，已验证。

5-22 — mindmap-main-editor-tab-kind-v1

建议状态：archive-done

证据: 所有项已勾选。kind=mindmap resource tab 使用 resource:mindmap:... identity，task169 从旧 object shell 口径切到 main editor resource tab 口径。
归档原因: 已执行完成。旧 task169 realtime 深测被标记为 retiredRealtimeTopicEditing，不含未完成工作。

5-23 — editor-side-target-secondary-pane-v1

建议状态：archive-done

证据: 所有项已勾选。openResourceAsSideTarget，资源侧栏目标显示 unsupported placeholder，task472 smoke 通过。
归档原因: 已完成闭环。

5-24 — open-editors-lightweight-view-checklist-v1

建议状态：archive-done

证据: 所有项已勾选。mnote.open_editors_snapshot.v1 已暴露 snapshot 合同。cargo test -p mnote-web web_shell 通过。
归档原因: 执行记录清晰，UI 当前阶段保持为可观测模型（无 sidebar UI 新增）。

5-25 — editor-tab-keyboard-and-mru-checklist-v1

建议状态：archive-done

证据: 所有项已勾选。bindMainEditorTabStrip() keyboard roving focus、Enter/Space 激活、关闭后 MRU focus 迁移已实现。cargo test 通过。
归档原因: Reasonix Worker B 输出 proposal，Codex 实现最小安全集。闭环。

5-26 — resource-open-resolver-convergence-checklist-v1

建议状态：keep-process

证据: 执行记录明确记载 "Worker C 进程停留在计划提交阶段，没有生成 final.md"。"审查...重复判断" 和 "给出最小收敛方案" 未完成。Checklist 第 4 节 2 个主项未勾选。
留存原因: 仍有收敛正文附件与 FileTree 资源打开策略的实际工作待做。但 5-17/5-19 已完成了第一轮 resolver 建设，5-26 的收敛优先级较低。
补充建议: 可降级为 Low Priority process，或在 next sprint 以 1-2 小时限时任务完成。

5-5 — page-aggregate-single-truth-alignment-v1

建议状态：mark-process-reference

证据: 这是战略设计文档，非 checklist。定义了 Page Aggregate 的 Phase F-J 方向和长期架构目标。文档末尾明确结论 leptos-tiptap 主编辑区已基本可用，但页面聚合仍未收口。
保留原因: 作为长期架构参考仍有效。不应归档为 done（聚合未完全闭环），但也不需要作为 process 继续执行（方向已定）。
建议补充说明: 建议在文档头部加注 参考: 当前执行进度见 5-6。

5-6 — page-aggregate-alignment-checklist-v1

建议状态：keep-process (partial)

证据: 大部分 Phase (F/G/H/I/J) 已基本完成。仍有较小缺口：Phase G 退出标准第 2 项（新增字段不散落 props）未勾选；Phase H 页面设置分类第 2 项（哪些项降级/隐藏）未勾选。
留存原因: 文档非常大（34KB+），大部分已完成但仍有小缺口。可将这些微小项转到新的浓缩 checklist，或在本文件内更新状态后归档。
建议: 考虑将已完成的 Phase F/G/H/I/J 子项标记 final，剩余的微量工作移至更轻量文档继续。

5-2 — tiptap-notion-like-template-adoption-v1

建议状态：mark-process-reference

证据: 这不是 checklist，是策略分析文档。结论是 以后续主编辑器开发继续以 Tiptap 官方能力模型为体验上限...已完成主编辑器接入和 Rust truth 落地。
保留原因: 作为 tiptap 编辑器的设计参考和 P0.5 边界定义仍有价值。不应继续视为 process 执行清单。

5-7 — wolai-page-tree-main-editor-experience-restoration-v1

建议状态：mark-process-reference

证据: 文档自身已声明执行口径转交 5-9 checklist 和 wolai-aline skill。包含大量 Wolai 参考截图路径和差异矩阵，是重要的取证基线。
保留原因: 宝贵的 Wolai 对标取证基线记录和交互合同定义，作为 reference 保留。不应继续作为执行 checklist。

5-9 — wolai-aline-continuous-checklist-v1

建议状态：keep-process

证据: 这是活跃的 checklist 文档。Phase A-E 大部分项目已完成（GREEN/PARITY），但存在未完成项：
- A4 (字体栈与基础 token): 仍为 TODO
- E18 (Clipboard/Paste): 仍为 TODO
- F1-F5 (Page Aggregate 相关): 仍为 TODO — 但这些在 5-6 中已大部分完成
- Phase 已退役 段落记录了一些退役项
留存原因: 仍有少量待办项 (A4, E18, F1-F5)。但 F1-F5 的内容实际已在 5-6 中完成，这里存在陈旧风险。
建议: 审查 F1-F5 是否应追认完成或引用 5-6 的进展；A4 和 E18 可考虑转入低优先级或归档。

5-14 — zed-lapce-vscode-reference-adoption-matrix-v1

建议状态：mark-process-reference

证据: 这是参考采用矩阵设计文档，非 checklist。定义了 Zed/Lapce/VS Code/SideX 各自的参考职责和 P0-P3 实施建议。
保留原因: 作为代码引用架构的权威参考文档很有价值。不应作为执行 checklist，但推荐作为后续 BufferStore、WorkspacePath 等模块设计时的引用入口。
补充说明: 文档质量高、边界清晰，建议在 done/ 也做一份副本或在 05-mainline README 中交叉引用。

2. `design/06-mindmap/process/` — 3 files

6-mindmap-kernel-phase6-projection-editor-v1

建议状态：keep-process

证据: 这是 Phase 6 mindmap 的主架构设计文档。Phase 6.1 (真实 simple-mind-map runtime cutover) 已于 2026-05-10 完成。但文档定义的长期方向（Rust-native engine 路线）仍是未来可选项。
留存原因: 定义了三路线定位和 Rust 内核+KMind-like 编辑器的当前主线。仍有 10.1 现实复核差距 中记录的 Phase 6.1 尾项（view_data_change 持久化、toolbar zoom 绑定、RichText 插件）。
补充说明: 有 1 份对应的 done checklist (6-mindmap-phase6-kmind-parity-detail-checklist-v1.md)，建议在 process 文档头部加注引用。

6-mindmap-leptos-adapter-reference-notes-v1

建议状态：mark-process-reference

证据: 这是审计参考笔记，非执行 checklist。详细记录了 lx-doc/mind-map 的 Vue 组件到 kernel command 的映射，以及历史 React UI 壳的能力清单（8 个表格）。
保留原因: 作为 adapter 实现和命令映射的详细参考，在后续 rust-native UI shell 开发时仍有价值。不应作为执行清单。

6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1

建议状态：keep-process

证据: 这是活跃的执行 checklist。Task 1-7 和 Task 8 (Context Menu) 大部分已完成。Task 9 (KMind visual parity) 的 9 个子项中有未封闭的项（node style panel、base style panel 等详细面板界面仍有差距）。
留存原因: 仍有未完成的 visual parity 细节项。KMind 视觉对齐是一个持续的收口过程（对应 done/ 下的 detail checklist）。
补充说明: 文档很大（43KB+），建议将已完成 Task 移入 done/，只保留未完成的 Task 9+ 视觉差异项。

3. `design/08-wolai-aline-test-flow/process/` — 1 file

wolai-aline-test-flow-v1

建议状态：mark-process-reference

证据: 这是对标测试流程的方法论文档，非 checklist。定义了标准流程（明确小任务→取 Wolai 基线→写 RED smoke→实现→本地验证→subagent 复测→主线程复核）、安全边界、资源路径和 subagent 模板。
保留原因: 作为 Wolai 对标的标准流程参考仍有效。不应归档（仍在持续使用），也不应作为 process checklist（不是执行清单）。
补充说明: 文档质量高，应保持为 process/ 中唯一的流程定义文件。

4. `design/09-siyuan-reference/process/` — 1 file

9-siyuan-reference-boundary-and-adoption-v1

建议状态：mark-process-reference

证据: 这是参考边界与采用策略文档，非 checklist。明确区分了思源值得参考的层级（块引用/属性视图/本地工作区心智/导图插件）和不建议照搬的部分（.sy 真相层/SQL 主接口/前端运行时）。
保留原因: 作为块式笔记能力参考的权威边界稿很有价值。当前无 process 待办项。
补充说明: 建议在 process 文档头部或设计根目录 README 中交叉引用，让后续设计者知道“思源参考应当落在哪层”。

5. Cross-Cutting Observations

5.1 主要风险

5-26 计划未落地: 资源打开 resolver 收敛方案由 Worker C 提出但从未实现。这是本次审查中唯一有"提议但未实施"记录的文件。风险较低（基本功能已由 5-17/5-19 覆盖），但历史记录显示有一轮未闭环的工作流。
5-9 F1-F5 陈旧风险: 5-9 的 F1-F5 (Page Aggregate 相关项) 标记为 TODO，但实际工作在 5-6 中已大部分完成。存在同一工作两处记录不一致的问题。建议审查 5-9 F1-F5 是否应追认或标注 "参见 5-6"。
6-mindmap 视觉差距无限延伸: 6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1 最后阶段（Task 9+）的 KMind visual parity 项目可能变成无限尾随工程。建议明确一个 "足够好" 的退出标准。

5.2 建议立即行动项

将 5-15/5-17/5-18/5-19/5-20/5-21/5-22/5-23/5-24/5-25 共 10 个文件移至 done/
将 5-5/5-2/5-7/5-14 标记或移动为 reference/ 类文档（当前 mnote 无统一 reference/ 目录，可另议）
为 5-26 决定是否在下一 sprint 收敛或正式废案
解决 5-9 F1-F5 的状态不一致问题
将 6-mindmap 的 3 个文件在 phase 里程碑间做一次已完成/进行中/参考的切分

5.3 无需变更的文档

06-mindmap/done/6-mindmap-phase6-kmind-parity-detail-checklist-v1.md — 已经是正确位置
08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md — 保持在 process/ 作为流程定义
09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md — 保持在 process/ 作为参考边界稿

报告说明

路径: .codex/reasonix-tasks/results/design-governance-worker-c-05-06-08-09.md

只读约束：本文只创建了报告文件，未移动、修改或删除任何 design/ 文件。上述归档/移动建议需由人工或后续 Worker 执行。

验证命令：

# 确认报告文件存在
find .codex/reasonix-tasks/results/ -name '*worker-c*'

# 确认未修改任何设计文件
git diff --stat design/

15 KiB Raw Blame History Unescape Escape

Design Governance Report — Worker C: 05/06/08/09 Review

Executive Summary

1. design/05-editor-mainline/process/ — 18 files

5-15 — local-markdown-path-identity-unification-checklist-v1

5-16 — editor-group-resource-tab-safety-checklist-v1

5-17 — resource-editor-kind-and-smoke-matrix-checklist-v1

5-18 — main-editor-tab-state-and-error-placeholder-checklist-v1

5-19 — resource-open-resolver-and-onlyoffice-checklist-v1

5-20 — resource-tab-close-confirm-checklist-v1

5-21 — editor-tab-url-active-identity-checklist-v1

5-22 — mindmap-main-editor-tab-kind-v1

5-23 — editor-side-target-secondary-pane-v1

5-24 — open-editors-lightweight-view-checklist-v1

5-25 — editor-tab-keyboard-and-mru-checklist-v1

5-26 — resource-open-resolver-convergence-checklist-v1

5-5 — page-aggregate-single-truth-alignment-v1

5-6 — page-aggregate-alignment-checklist-v1

5-2 — tiptap-notion-like-template-adoption-v1

5-7 — wolai-page-tree-main-editor-experience-restoration-v1

5-9 — wolai-aline-continuous-checklist-v1

5-14 — zed-lapce-vscode-reference-adoption-matrix-v1

2. design/06-mindmap/process/ — 3 files

6-mindmap-kernel-phase6-projection-editor-v1

6-mindmap-leptos-adapter-reference-notes-v1

6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1

3. design/08-wolai-aline-test-flow/process/ — 1 file

wolai-aline-test-flow-v1

4. design/09-siyuan-reference/process/ — 1 file

9-siyuan-reference-boundary-and-adoption-v1

5. Cross-Cutting Observations

5.1 主要风险

5.2 建议立即行动项

5.3 无需变更的文档

报告说明

15 KiB

Raw Blame History

1. `design/05-editor-mainline/process/` — 18 files

2. `design/06-mindmap/process/` — 3 files

3. `design/08-wolai-aline-test-flow/process/` — 1 file

4. `design/09-siyuan-reference/process/` — 1 file