# design 设计稿索引

> 更新时间：2026-05-26
>
> 当前产品口径：`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Hermes/Reasonix agent + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`。
>
> 当前上位主线：local-first MVP 已初步完成；local-first workspace 是默认数据形态，本地 `.md` 是页面正文真相，Rust kernel / projection / command 持有语义，Rust SQLite control-plane 持有默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 控制面；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`
> `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md`
>
> 后续新增设计默认以 MVP 后阶段为基线：优先推进 `WorkspacePath/ObjectIdentity`、`DocumentBuffer/BufferStore`、Page Aggregate compat 瘦身、tree command context、live cache 统一、agent diff / 冲突合并 / 本地索引 / 分享同步产品化；不要再把旧 Convex / Next / BlockNote 主链、根 `convex/` functions 源码或 Convex Auth 默认控制面当作新增能力默认方向。
>
> Runtime 可维护口径：`3-19`、`3-20`、`3-21`、`3-22`、`5-28`、`5-29` 与 `10-review/done/16` 已完成第一轮前端 runtime 模块级拆分。`layout.rs` / `tree.rs` / `web_shell.rs` 大型 raw string 问题不再是当前主问题；浏览器 JS 默认从 `rust/crates/mnote-web/browser/*.js` 定位，tiptap island 默认从 `rust/spikes/leptos-tiptap-spike/src/editor_runtime/*.rs` 定位。剩余 runtime 专项按 owner 分流：local folder/resource 编排看 `03-rust-web/process/3-23`，Page AI sidebar owner 看 `07-ai/process/7-38`。
>
> Smoke 口径：当前分类与默认基线以 `/mnt/Data1T/mnote/scripts/TESTING_REFERENCE.md` 为准；退役 Convex / Next / 3104 / BlockNote 脚本不再占用默认 smoke 基线。
>
> 状态口径以当前仓库真实代码为准：
> - `[done]`：对应阶段或收口目标已经在当前主线代码中成立
> - `[process]`：方向已进入主线，且当前可以直接拆 checklist / owner / 验收继续执行
> - `[draft]`：方向尚未成形，不能直接派发实现
> - `[reference]`：参考流程、候选合同、对照证据、review 原始材料或长期设计边界；不代表当前可直接执行的 checklist
> - `[recycle]`：已废弃、已被后续稿件替代，统一归档到 `old/`

## 当前优先级入口

- 当前有效架构口径，请先看：
  `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
- MVP 后阶段剩余 `process/` 的执行顺序，请看：
  `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`
- Runtime 模块级拆分完成态，请看：
  `/mnt/Data1T/mnote/design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md`
- 历史 `01-05-current-priority-overview` 已迁入 `design/old/`，只能作为归档快照，不再作为当前入口。

## 主线顺序

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/`
   - `reference/` 放 Wolai 对标流程基线；具体执行任务应拆到对应主线 `process/`
9. `09-siyuan-reference/`
   - `reference/` 放思源参考、借鉴边界与能力盘点稿
10. `10-review/`
   - `done/` 放阶段性代码 / 架构审查证据和结论
   - `reference/` 放对照审查原始证据、参考矩阵和后续候选项
   - 只作为当前实现状态证据和历史审查归档，不作为新的主线优先级入口

## 迁移规则

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

## 辅助目录

- `90-reference/`
  - 跨域生态参考资料，不参与 `[done]/[process]/[draft]/[reference]/[recycle]` 状态判断
  - 引用时只能作为生态资料或背景材料，不能覆盖 `CURRENT_ARCHITECTURE.md`、`ARCHITECTURE.md`、`AGENTS.md`、`1-8` 当前执行顺序或对应主线 `process/` / `done/` 设计稿
- `old/`
  - 已废弃或被替代的历史稿件，标题统一标记 `[recycle]`
  - 每个大类继续按 `process/` 与 `done/` 分层
- `design/design/`
  - Wolai / Stitch / icon 等取证素材与静态参考资产；这是当前 `design/` 目录下的素材子目录，不是主线设计稿根目录
  - 不参与 `[done]/[process]/[recycle]` 主线状态判断
