Agent Board
b798f628ee
Persist PageTree expand state via control-plane view-state and align chevron/DOM with restored expansion; keep Sidex-style shallow page-tree scan and drop the unused recursive scanner that only added cargo noise. Add password vault workbench routes/runtime/skill/CLI, split page_ai_pi into a module package, and retire Hermes/ACP/OpenHub recycle + root harness evidence from the index while gitignoring recycle and local diag dumps. Archive superseded design/bugs docs under old/, point architecture at ARCHITECTURE.md, and refresh smokes for Pi S1–S7, vault, and editor regressions so the working tree can stay clean.
94 lines
6.2 KiB
Markdown
94 lines
6.2 KiB
Markdown
# design 设计稿索引
|
||
|
||
> 更新时间：2026-07-19
|
||
>
|
||
> 当前产品口径：`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Pi Rust Page AI + LightRAG 知识库融合 + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`。
|
||
>
|
||
> 当前上位主线：local-first MVP 已初步完成；local-first workspace 是默认数据形态，本地 `.md` 是页面正文真相，Rust kernel / projection / command 持有语义，Turso/libSQL control-plane 持有默认 auth、membership、share grants、sync state、AI policy、Page AI runtime session 控制面；Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见：
|
||
> `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/process/2-9-turso-control-plane-cutover-v1.md`
|
||
> `/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-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/ARCHITECTURE.md`
|
||
（`CURRENT_ARCHITECTURE.md` 仅为兼容指针，不再写正文）
|
||
- MVP 后阶段架构收口与执行顺序，请看：
|
||
`/mnt/Data1T/mnote/design/10-review/process/21-mvp-post-architecture-closure-checklist-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]` 状态判断
|
||
- 引用时只能作为生态资料或背景材料，不能覆盖 `ARCHITECTURE.md`、`AGENTS.md`、对应主线 `process/` / `done/` 设计稿
|
||
- `old/`
|
||
- 已废弃或被替代的历史稿件，标题统一标记 `[recycle]`
|
||
- 每个大类继续按 `process/` 与 `done/` 分层
|
||
- `design/design/`
|
||
- Wolai / Stitch / icon 等取证素材与静态参考资产；这是当前 `design/` 目录下的素材子目录，不是主线设计稿根目录
|
||
- 不参与 `[done]/[process]/[recycle]` 主线状态判断
|