Files
mnote/design/README.md
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

75 lines
4.1 KiB
Markdown

# design 设计稿索引
> 更新时间:2026-05-21
>
> 当前产品口径:`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Hermes/Reasonix agent + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`。
>
> 当前上位主线:local-first MVP 已初步完成;local-first workspace 是默认数据形态,本地 `.md` 是页面正文真相,Rust kernel / projection / command 持有语义,Convex / 服务端只作为控制面、cloud source、compat 和 sync replica。入口设计见:
> `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md`
>
> 后续新增设计默认以 MVP 后阶段为基线:优先推进 `WorkspacePath/ObjectIdentity`、`DocumentBuffer/BufferStore`、Page Aggregate compat 瘦身、tree command context、live cache 统一、agent diff / 冲突合并 / 本地索引 / 分享同步产品化;不要再把旧 Convex / Next / BlockNote 主链当作新增能力默认方向。
>
> 状态口径以当前仓库真实代码为准:
> - `[done]`:对应阶段或收口目标已经在当前主线代码中成立
> - `[process]`:方向已进入主线,但仍在推进中
> - `[process-reference]`:仍在 `process/` 下保留,但只作为参考流程、候选合同、对照证据或长期设计边界;不代表当前可直接执行的 checklist
> - `[recycle]`:已废弃、已被后续稿件替代,统一归档到 `old/`
## 当前优先级入口
- `01-05` 当前有效主线与优先级,请先看:
`/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`
- MVP 后阶段剩余 `process/` 的执行顺序,请看:
`/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`
## 主线顺序
1. `01-tree-first-graph-kernel/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
2. `02-convex-rust-long-term-architecture/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
3. `03-rust-web/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
4. `04-tree-domain/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
5. `05-editor-mainline/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
- `reference-code/` 放编辑器参考代码
6. `06-mindmap/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
7. `07-ai/`
- `process/` 放推进中的主线稿
- `done/` 放已在真实代码中成立的主线稿
8. `08-wolai-aline-test-flow/`
- `process/` 放推进中的测试流程与对标执行稿
9. `09-siyuan-reference/`
- `process/` 放思源参考、借鉴边界与能力盘点稿
10. `10-review/`
- `done/` 放阶段性代码 / 架构审查证据和结论
- 只作为当前实现状态证据和历史审查归档,不作为新的主线优先级入口
## 迁移规则
- 主线设计稿完成后,必须从对应大类的 `process/` 移动到 `done/`
- 仅以当前真实代码为准判断是否完成,不能只按稿件自述判断。
- 对于未完成但当前不排期的候选设计、参考矩阵、对标流程和 review 原始证据,不移动到 `done/`,必须在文件头部标记 `process-reference` 并说明当前不作为 active implementation checklist。
- 废弃稿统一移动到 `old/` 对应大类下,再按历史成熟度放入 `process/``done/`
## 辅助目录
- `90-reference/`
- 参考资料,不参与 `[done]/[process]/[recycle]` 状态判断
- 引用时只能作为生态资料或背景材料,不能覆盖 `ARCHITECTURE.md``AGENTS.md``01-05` 当前优先级或对应主线 `process/` / `done/` 设计稿
- `old/`
- 已废弃或被替代的历史稿件,标题统一标记 `[recycle]`
- 每个大类继续按 `process/``done/` 分层
- `design/design/`
- Wolai / Stitch / icon 等取证素材与静态参考资产;这是当前 `design/` 目录下的素材子目录,不是主线设计稿根目录
- 不参与 `[done]/[process]/[recycle]` 主线状态判断