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.
56 lines
3.0 KiB
Markdown
56 lines
3.0 KiB
Markdown
# [recycle] 11 [done] 当前完整架构 Review v1
|
||
|
||
> 更新时间：2026-05-17
|
||
>
|
||
> 状态：`done`
|
||
>
|
||
> 参考总文档：[CURRENT_ARCHITECTURE.md](../../../CURRENT_ARCHITECTURE.md)
|
||
|
||
## 1. 结论
|
||
|
||
> 2026-05-31 口径补充：本文是 2026-05-17 的阶段性 review 快照。文中关于 `mnote.doc.markdown_edit` “已是简单正文编辑主路径”的表述已被后续 local-first agent 文件编辑控制面覆盖；当前 local-first 普通 Markdown 编辑主路径以 `AGENTS.md`、`CURRENT_ARCHITECTURE.md`、`ARCHITECTURE.md` 与 `design/07-ai/process/7-18-local-first-agent-file-editing-control-plane-v1.md` 为准，即“授权文件引用 + allowed roots + agent 原生 patch/diff + watcher/BufferStore/Page Aggregate 同步”。`mnote.doc.markdown_edit` 只作为 cloud / remote agent / compat fallback 或复杂结构辅助边界。
|
||
|
||
当前 mnote 的主线架构已经成形。本轮 review 识别出的 P0 / 内核优先缺陷已完成代码修复、文档迁移和定向验证。
|
||
|
||
已修复的四个关键冲突：
|
||
|
||
1. Tree realtime 的发布口径与前端消费口径不一致。
|
||
2. FileTree 资源行误走页面命令。
|
||
3. Page Aggregate / AI context 保留前端第二真相。
|
||
4. AI 写入链路在 `markdown_edit`、`apply_block_ops`、Hermes / ACP / Reasonix 之间的合同漂移。
|
||
|
||
仍需后续主线继续推进的不是本轮 P0 bug，而是长期架构收口：Page Aggregate 原生 EditorBlockDocument 落库、正文保存主命令面、`tree.resource.*` 资源生命周期和兼容路由瘦身。
|
||
|
||
## 2. 关键判断
|
||
|
||
- Rust kernel 与 bridge-runtime 已经承担语义主导权。
|
||
- Rust SSR 主壳已默认以 `/api/realtime/ws` 为实时主链，SSE 是 fallback。
|
||
- FileTree 资源行的 owner document 与页面命令目标已分离。
|
||
- AI context 的 page subtree 已只读 Rust Page Aggregate projection。
|
||
- `mnote.doc.markdown_edit` 已是简单正文编辑主路径，`page_ai_workflow` 复用统一 mnote tool executor，`apply_block_ops` / `mnote.block.*` 仅作为结构性辅助。
|
||
- ACP / Reasonix 的 mnote tool payload、response、run context 与幂等字段已同步到当前工具合同。
|
||
|
||
## 3. 已闭合 bug
|
||
|
||
- Rust Web / realtime / ACP：`bugs/03-rust-web/done/3-16` 到 `3-21`
|
||
- Tree domain：`bugs/04-tree-domain/done/4-46`
|
||
- Editor mainline：`bugs/05-editor-mainline/done/5-15` 到 `5-18`
|
||
- AI：`bugs/07-ai/done/7-18` 到 `7-25`
|
||
|
||
## 4. 验证
|
||
|
||
- `find bugs -path '*/process/*' -type f | wc -l`
|
||
- 结果：`0`
|
||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web markdown_edit -- --nocapture`
|
||
- 结果：9 passed
|
||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web page_ai_workflow -- --nocapture`
|
||
- 结果：3 passed
|
||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web acp_client -- --nocapture`
|
||
- 结果：6 passed
|
||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web ssr::pages::layout::tests -- --nocapture`
|
||
- 结果：14 passed
|
||
|
||
## 5. 备注
|
||
|
||
本次审查的详细架构说明已统一写入根目录：[CURRENT_ARCHITECTURE.md](../../../CURRENT_ARCHITECTURE.md)。
|