lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
mnote/bugs/07-ai/done/7-53-page-ai-runtime-split-threshold-triggered-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-53 Page AI runtime 已触发继续拆分阈值

状态

  • 状态：done
  • Owner：07-ai / Page AI sidebar runtime
  • 发现时间：2026-06-01

现象

rust/crates/mnote-web/browser/sidebar-page-ai-runtime.js 曾约 3458 行，已经超过 design/07-ai/process/7-38-page-ai-sidebar-runtime-owner-split-v1.md 中设定的 2500 行继续拆分阈值。文件内仍混合 UI render、run orchestration 等多类职责。

同时，sidebar-tree-runtime.js 已不再初始化 pageUiState.pageAi* 状态，Page AI 默认值由 sidebar-page-ai-runtime.js 的 ensurePageAiStateFacade() 集中兜底；但 tree runtime 仍传入共享 pageUiState 对象并保留少量 Page AI 代理函数，后续子模块拆分仍未闭环。

证据

  • sidebar-page-ai-runtime.js 曾约 3458 行；2026-06-01 render helper 续补后降至 2498 行。
  • sidebar-page-ai-markdown-runtime.js 已承接 Page AI Markdown / conversation 文本渲染 helper。
  • sidebar-page-ai-profile-runtime.js 已承接 provider/profile/history filter/usage helper。
  • sidebar-page-ai-permission-runtime.js 已承接 ACP permission message/dialog/resolve helper。
  • sidebar-page-ai-session-runtime.js 已承接 session storage、backend session list/detail/search/resume/delete 和 runtime event replay helper。
  • sidebar-page-ai-skill-runtime.js 已承接 skill source、skill preference、Hermes builtin 隐藏和 Reasonix memory preference helper。
  • sidebar-page-ai-target-runtime.js 已承接 OpenEditorsSnapshot target 派生、WorkspacePath、run target snapshot、contextRefs、agentTargetPackage 和 target writable guard helper。
  • sidebar-page-ai-runtime.js 包含 function ensurePageAiStateFacade，并集中初始化 pageAiAcpRuntime: 'reasonix' 等 Page AI 默认状态。
  • sidebar-tree-runtime.js 不再包含 pageAiAcpRuntime: 'reasonix' 等 pageAi*: 默认字段，只保留 open-page-ai 主壳入口和代理函数。
  • design/07-ai/process/7-38-page-ai-sidebar-runtime-owner-split-v1.md 第 3 节仍将以下项列为未完成：
    • 若 sidebar-page-ai-runtime.js 超过 2500 行，再按 render / conversation / run orchestration 继续拆成子模块。

影响

  • Page AI 行为继续占用 tree runtime 委托面，tree/filetree 和 AI session owner 边界仍混杂。
  • 后续新增 target picker、OnlyOffice target、mindmap contextRefs 时，容易继续堆入单一大文件。
  • 浏览器事件委托散落在 tree runtime 与 Page AI runtime 之间，增加回归风险。

下一步建议

  • 若后续再次超过 2500 行，继续按 conversation / run orchestration 分子模块拆，降低 sidebar-page-ai-runtime.js 单文件职责。
  • 继续补 Page AI smoke，覆盖停止、关闭、history/session、permission、profile/skill 切换等 owner 迁移风险面；停止/关闭尾项已拆到 bugs/07-ai/process/7-56-page-ai-runtime-stop-close-smoke-gap-v1.md。

验收

  • sidebar-tree-runtime.js 不再包含 [data-page-ai-action=...] click/change 分发。
  • sidebar-page-ai-runtime.js 导出并安装 installPageAiDelegates()。
  • pageUiState.pageAi* 从通用 sidebar state 下沉或有明确兼容 getter/setter。
  • Page AI smoke 覆盖打开 drawer、切换 tab、切换 agent和发送；停止/关闭完整断言已拆到 bugs/07-ai/process/7-56-page-ai-runtime-stop-close-smoke-gap-v1.md，不阻塞本文拆分阈值归档。

2026-06-01 第一刀验证

已完成第一刀：sidebar-tree-runtime.js 中 Page AI click/input/change/keydown 的大段 action 分发已迁到 sidebar-page-ai-runtime.js 的 handlePageAiClick、handlePageAiKeyDown、handlePageAiInput、handlePageAiChange，并由 installPageAiDelegates() 在 Page AI owner runtime 内安装事件监听。tree runtime 仅保留 data-mnote-action="open-page-ai" 主壳入口。

已通过验证：

  • 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.handlePageAi*，只在自身监听注册后调用 sidebarPageAi.installPageAiDelegates()。
  • 已在临时 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 断言，避免浏览器 ES module import 404。
  • sidebar-page-ai-runtime.js 当前 2498 行，已低于 7-38 设定的 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。

最终验证：

  • 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
  • MNOTE_UI_BASE_URL=http://127.0.0.1:3301 MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3301 node scripts/task504-page-ai-history-agent-filter-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/task520-page-ai-raw-resource-target-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/task525-page-ai-mindmap-resource-target-smoke.js

本文已满足归档条件：sidebar-page-ai-runtime.js 当前 2498 行，低于 2500 行继续拆分阈值；render helper 二级 import、drawer controls、history/session filter、当前页 target、raw resource target、mindmap target 和发送 payload 链路均通过 smoke。

Reference in New Issue View Git Blame Copy Permalink