lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
mnote/design/07-ai/done/7-38-page-ai-sidebar-runtime-owner-split-v1.md
T
lix-2026 1882db7681 收口 MNote P0 P1 P2 审查尾项 
- 归档 OnlyOffice live bridge、Page AI、mindmap、design governance 与相关 bug 条目
- 补齐 MinerU OCR 后端 runtime 合同与 smoke/test 基线
- 收口 ChatOnly/Doubao、ObjectIdentity、Page Aggregate compat 与 runtime owner 文档口径

验证：
- cargo test --manifest-path rust/Cargo.toml -p mnote-web local_ocr -- --test-threads=1
- cargo test --manifest-path rust/Cargo.toml -p mnote-web onlyoffice_bridge -- --test-threads=1
- git diff --check
- git diff --cached --check
- codegraph index . --force && codegraph status .
- codegraph sync . && codegraph status .
2026-06-01 09:29:12 +08:00

13 KiB
Raw Permalink Blame History

7-38 Page AI sidebar runtime owner split v1

创建时间：2026-05-25 状态：done 来源：design/03-rust-web/done/3-22-sidebar-tree-runtime-second-stage-split-v1.md Batch A。 2026-05-26 更新：design/10-review/done/16-mnote-web-runtime-module-maintainability-checklist-v1.md 已把 Page AI 主体迁入 browser/sidebar-page-ai-runtime.js；本文件继续作为后续 AI owner 收口 checklist。

1. 背景

rust/crates/mnote-web/browser/sidebar-tree-runtime.js 曾包含大量 Page AI panel 代码：会话、消息、profile、skills、gateway health、ACP runtime、permission dialog、plan/status event、session search/resume 等。2026-05-26 的 runtime 可维护性批次已将主体迁入 browser/sidebar-page-ai-runtime.js；2026-06-01 继续迁出事件 delegate 和 pageAi* 默认状态。tree runtime 目前只保留 data-mnote-action="open-page-ai" 主壳入口、共享 bootstrap 对象和少量触发器代理。

这些代码不是 tree/filetree runtime 的长期 owner。继续把 Page AI 面板放在 03-rust-web 的 sidebar runtime 拆分里，会让 tree shell、local folder、AI session 三条边界继续混在一起。

2. Owner 判断

  • owner：07-ai
  • 运行位置：当前仍可挂在 sidebar UI，但 runtime 模块应独立于 tree/filetree runtime。
  • 当前目标模块：rust/crates/mnote-web/browser/sidebar-page-ai-runtime.js
  • 主壳职责：只加载 asset、提供当前 document/workspace/root/bootstrap。

3. 后续执行建议

  • 只读审计 Page AI panel 的状态入口：pageUiState.pageAi*、storage、session 列表、profile/skills、permission dialog。
  • 建立独立 Page AI sidebar owner runtime：sidebar-page-ai-runtime.js。
  • 从 sidebar-tree-runtime.js 继续迁出 Page AI click/change/input/keydown 委托，tree runtime 只保留 data-mnote-action="open-page-ai" 入口。
  • 将 pageUiState.pageAi* 从通用 sidebar state 中下沉到 Page AI owner runtime，并保留兼容 getter/setter 或明确 bootstrap contract。
  • 若 sidebar-page-ai-runtime.js 继续超过 2,500 行，再按 session/profile-skill/permission/conversation/target/render 拆成子模块。
  • 浏览器验证使用页面 AI / ACP smoke，而不是 tree/filetree smoke 替代。

4. 非目标

  • 不在 03-rust-web 的 sidebar runtime 二阶段里继续扩大 Page AI 实现。
  • 不在 10-review runtime 可维护性收口里继续重构 ACP/Hermes session 语义；这里只记录 owner 边界。
  • 不改变 Hermes / Reasonix ACP runtime 协议。
  • 不把 local-first agent 文件编辑链路改回粗粒度 mnote.page.save。

5. 2026-06-01 复核

本文继续保持 process。只读核查确认 sidebar-page-ai-runtime.js 当时约 4519 行，已经触发第 3 节的 2500 行继续拆分条件；sidebar-tree-runtime.js 当时仍保留 Page AI click/change 委托和 pageUiState.pageAi* 状态壳。缺口已记录到 bugs/07-ai/process/7-53-page-ai-runtime-split-threshold-triggered-v1.md。

下一步最小切片是按 render / conversation / run orchestration 子模块继续拆 sidebar-page-ai-runtime.js，降低单文件职责和公开代理面。

6. 2026-06-01 第一刀执行记录

已完成第一刀：sidebar-tree-runtime.js 不再内联 Page AI 的 click/input/change/keydown 大段 action 分发，也不再调用 sidebarPageAi.handlePageAi* 薄委托；sidebar-page-ai-runtime.js 承接原有 close、settings、stop、rotate、intent、tab、agent、context、target、skill、tool、session、permission、open-location、suggestion、send、history 等分发语义，并通过 installPageAiDelegates() 自行安装事件监听。

验证记录：

  • node --check rust/crates/mnote-web/browser/sidebar-page-ai-runtime.js
  • node --check rust/crates/mnote-web/browser/sidebar-tree-runtime.js
  • cargo test --manifest-path rust/Cargo.toml -p mnote-web page_ai_acp_runtime_defaults_to_reasonix_and_keeps_hermes_switch -- --test-threads=1
  • cargo test --manifest-path rust/Cargo.toml -p mnote-web page_ai_agent_target_picker_contract_is_visible_and_serialized -- --test-threads=1
  • MNOTE_UI_BASE_URL=http://127.0.0.1:3301 MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3301 node scripts/task490-runtime-surfaces-smoke.js
  • MNOTE_UI_BASE_URL=http://127.0.0.1:3301 MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3301 node scripts/task502-page-ai-agent-selector-context-smoke.js

2026-06-01 续补：

  • sidebar-page-ai-runtime.js 新增并导出 installPageAiDelegates()，内部一次性安装 Page AI click/keydown/input/change delegate。
  • sidebar-tree-runtime.js 仅在自身监听注册后调用 sidebarPageAi.installPageAiDelegates()，不再直接处理 Page AI 内部事件。
  • 已在临时 127.0.0.1:3301 Rust web 实例补跑 task490-runtime-surfaces-smoke.js 与 task502-page-ai-agent-selector-context-smoke.js，验证 drawer、agent/context/target/skills 和发送 payload 链路仍可用。

2026-06-01 state facade 续补：

  • sidebar-page-ai-runtime.js 新增 ensurePageAiStateFacade()，集中初始化 Page AI 默认状态并导出该 facade。
  • sidebar-tree-runtime.js 的 pageUiState 初始对象删除 pageAi*: 默认字段，tree runtime 不再定义 Page AI 状态真相。
  • Rust include/assert 已更新为：Page AI runtime 包含 ensurePageAiStateFacade 与 pageAiAcpRuntime: 'reasonix'，tree runtime 不包含该默认字段。

2026-06-01 conversation helper 续补：

  • 新增 sidebar-page-ai-markdown-runtime.js，抽出 textFromUnknown、renderPageAiMarkdown 和 inline Markdown 渲染 helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiMarkdownRuntime()，保留现有 assistant message 渲染行为。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-markdown-runtime.js 静态 runtime asset，并更新 runtime asset mount 测试。

2026-06-01 profile helper 续补：

  • 新增 sidebar-page-ai-profile-runtime.js，抽出 provider/profile/chat-only profile/history filter/usage helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiProfileRuntime() 并保留同名代理常量，降低调用点扰动。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-profile-runtime.js 静态 runtime asset，并更新 runtime asset mount 测试。
  • 已在临时 127.0.0.1:3301 Rust web 实例补跑 task490-runtime-surfaces-smoke.js 与 task502-page-ai-agent-selector-context-smoke.js，验证二级 import 后 drawer、agent/context/target/skills 和发送 payload 链路仍可用。

2026-06-01 permission helper 续补：

  • 新增 sidebar-page-ai-permission-runtime.js，抽出 ACP permission message、dialog show/hide 和 resolve-permission helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiPermissionRuntime() 并保留同名代理常量，主 runtime 继续负责事件流持久化、会话同步和 conversation 渲染入口。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-permission-runtime.js 静态 runtime asset，并更新 runtime asset mount/layout 断言。
  • 已在临时 127.0.0.1:3301 Rust web 实例补跑 task490-runtime-surfaces-smoke.js 与 task502-page-ai-agent-selector-context-smoke.js，验证新增 permission 二级 import 后 sidebar/Page AI 仍可加载和发送。

2026-06-01 session helper 续补：

  • 新增 sidebar-page-ai-session-runtime.js，抽出 session storage、backend session list/detail/search/resume/delete、session message sync 和 backend runtime event replay helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiSessionRuntime() 并保留同名代理常量，主 runtime 继续负责 Page AI UI render、run orchestration 和事件委托入口。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-session-runtime.js 静态 runtime asset，并更新 runtime asset mount/layout 断言。
  • 已在临时 127.0.0.1:3301 Rust web 实例补跑 task490-runtime-surfaces-smoke.js 与 task502-page-ai-agent-selector-context-smoke.js，验证新增 session 二级 import 后 Page AI drawer、agent/context/target/skills 和发送 payload 链路仍可用。

2026-06-01 skill helper 续补：

  • 新增 sidebar-page-ai-skill-runtime.js，抽出 skill source、skill preference、Hermes builtin 隐藏和 Reasonix memory preference helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiSkillRuntime() 并保留同名代理常量，主 runtime 继续负责 skill 异步加载、target/run orchestration 和 UI render。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-skill-runtime.js 静态 runtime asset，并更新 runtime asset mount/layout 断言。
  • 已通过 node --check 覆盖 Page AI 主 runtime、skill/session/permission/profile/markdown helper 和 sidebar-tree-runtime.js。
  • 已通过 cargo test --manifest-path rust/Cargo.toml -p mnote-web mnote_browser_runtime_assets_are_explicitly_mounted -- --test-threads=1、page_ai_acp_runtime_defaults_to_reasonix_and_keeps_hermes_switch、page_ai_agent_target_picker_contract_is_visible_and_serialized。
  • 已在临时 127.0.0.1:3301 Rust web 实例补跑 task490-runtime-surfaces-smoke.js 与 task502-page-ai-agent-selector-context-smoke.js，验证新增 skill 二级 import 后 Page AI drawer、agent/context/target/skills 和发送 payload 链路仍可用。

2026-06-01 target helper 续补：

  • 新增 sidebar-page-ai-target-runtime.js，抽出 OpenEditorsSnapshot target 派生、WorkspacePath、run target snapshot、contextRefs、agentTargetPackage 和 target writable guard helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiTargetRuntime() 并保留同名代理常量，主 runtime 继续负责 target popover UI、事件分发和 run orchestration 顺序。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-target-runtime.js 静态 runtime asset，并更新 runtime asset mount/layout 断言；target picker 合同测试改为在 target helper 中断言 primaryTargetId / targets / policy。
  • 已通过 node --check 覆盖 Page AI 主 runtime、target/skill/session/permission/profile/markdown helper 和 sidebar-tree-runtime.js。
  • 已通过 cargo test --manifest-path rust/Cargo.toml -p mnote-web mnote_browser_runtime_assets_are_explicitly_mounted -- --test-threads=1、page_ai_uses_backend_acp_session_runtime_store、page_ai_agent_target_picker_contract_is_visible_and_serialized、page_ai_acp_runtime_defaults_to_reasonix_and_keeps_hermes_switch。
  • 已在临时 127.0.0.1:3301 Rust web 实例补跑 task490-runtime-surfaces-smoke.js、task502-page-ai-agent-selector-context-smoke.js、task520-page-ai-raw-resource-target-smoke.js、task525-page-ai-mindmap-resource-target-smoke.js，验证新增 target 二级 import 后 Page AI drawer、agent/context/target/skills、raw resource target、mindmap target 和发送 payload 链路仍可用。

2026-06-01 render helper 续补：

  • 新增 sidebar-page-ai-render-runtime.js，抽出 target/context display helper、agent/profile/model label、skill filter、drawer shell、controls render、suggestions render、conversation render 和 response humanize helper。
  • sidebar-page-ai-runtime.js 改为 import createSidebarPageAiRenderRuntime() 并保留公开方法形状，主 runtime 继续负责 state facade、agent/run orchestration、session/permission/skill/target runtime 接线与事件委托。
  • 补注册 /api/mnote-browser-runtime/sidebar-page-ai-render-runtime.js 静态 runtime asset，并更新 runtime asset mount/layout 断言。
  • sidebar-page-ai-runtime.js 当前 2498 行，已低于 2500 行继续拆分阈值。
  • 已通过 node --check 覆盖 Page AI 主 runtime、render/target/skill/session/permission/profile/markdown helper 和 sidebar-tree-runtime.js。
  • 已通过 cargo test --manifest-path rust/Cargo.toml -p mnote-web mnote_browser_runtime_assets_are_explicitly_mounted -- --test-threads=1、page_ai_uses_backend_acp_session_runtime_store、page_ai_agent_target_picker_contract_is_visible_and_serialized、page_ai_acp_runtime_defaults_to_reasonix_and_keeps_hermes_switch。

本文已满足本轮 owner split checklist 归档条件；后续只在 runtime 再次超过阈值或 run orchestration 继续膨胀时开新缺陷 / 新设计。

2026-06-01 smoke 复核：

  • 已通过 task490-runtime-surfaces-smoke.js、task502-page-ai-agent-selector-context-smoke.js、task504-page-ai-history-agent-filter-smoke.js、task520-page-ai-raw-resource-target-smoke.js、task525-page-ai-mindmap-resource-target-smoke.js。
  • bugs/07-ai/process/7-53-page-ai-runtime-split-threshold-triggered-v1.md 已归档到 bugs/07-ai/done/7-53-page-ai-runtime-split-threshold-triggered-v1.md。
  • 本轮 smoke 额外发现并修复当前页 target 继承 stale workspacePath 的缺陷，记录到 bugs/07-ai/done/7-55-page-ai-current-page-target-stale-workspace-v1.md。
Reference in New Issue View Git Blame Copy Permalink