mnote/design/old/07-ai/done/7-60-page-ai-settings-ia-cleanup-v1.md

[recycle] 7-60 Page AI 设置 IA 整理 v1

创建时间：2026-06-10

当前状态：DONE

Owner：07-ai / Page AI / Settings IA / Runtime status

前置完成项：

• design/07-ai/done/7-58-page-ai-reasonix-official-desktop-session-alignment-v1.md
• design/07-ai/done/7-59-page-ai-reasonix-desktop-hermes-web-control-surface-alignment-v1.md

当前问题来源：7-59 后 Page AI 已有 runtime status、queue、jobs、logs、sessions dashboard，但 UI 仍沿用旧的 Common / Hermes / Reasonix / Chat-only / 高级 / Runtime 分层，导致“设置”和“运行态”混在一起。

1. 第一结论

Page AI 设置需要按 owner 分三层：

MNote    = MNote 如何给 AI 上下文、权限、工具、会话历史和审计
Reasonix = Reasonix ACP/native-live/queue/MCP/memory 的专属运行配置
Hermes   = Hermes gateway/profile/model/provider/session-load/replay/skills 的专属运行配置

同时必须把“运行态状态”从“设置”里拆出去：

设置 = 可持久保存或影响后续 run 的配置
状态 = 当前这一轮/当前 session 的 live snapshot

当前截图里的混乱点不是单个控件坏了，而是抽象层级混用：

• 顶部显示 Reasonix，runtime strip 却显示 hermes · new-session，用户会误以为当前 agent 与 runtime 不一致。
• Common 实际是 MNote 自身配置，但名字没有表达 owner。
• 高级 和 Runtime 既有设置项，又有只读状态项。
• Runtime panel 里出现“打开 Hermes 设置”，但当前用户可能正在使用 Reasonix。
• Chat-only 被放成一级设置页，但它本质是 MNote/API Chat/Hermes provider 的一种 runtime/profile 类型，不应和 Reasonix/Hermes 并列为 provider owner。

2. 新信息架构

2.1 Page AI 顶层导航

Page AI 抽屉保留五个一级工作区：

一级区	含义	当前入口
聊天	当前页对话、工具卡、引用、权限决策	默认页
状态	当前 runtime/session/run live snapshot	由 runtime strip 或状态图标打开
设置	MNote / Reasonix / Hermes 三层配置	齿轮
能力	当前 runtime 可用 tools/skills/memory 清单与开关	sparkle/能力图标
历史	MNote session dashboard	搜索/历史图标

原则：

• “状态”不承载长期配置。
• “设置”不展示 transient logs/job/active-run。
• “能力”可以按 runtime 过滤，但 capability owner 仍归 MNote / Reasonix / Hermes。
• “历史”展示 MNote session asset，不等于 Hermes DB 或 Reasonix native session。

2.2 设置页三层结构

设置页只保留三个主 tab：

MNote | Reasonix | Hermes

不再显示：

Common | Chat-only | 高级

旧 tab 映射：

旧 tab / 控件	新归属
Common	MNote
Chat-only	MNote > API Chat / Chat-only profile
高级 里的 context scope	MNote > 默认上下文
高级 里的 runtime status	状态
Runtime panel	状态
打开 Hermes 设置	Hermes tab 内
Reasonix memory / skill filter	Reasonix
Hermes profile / builtin skill filter	Hermes

3. MNote 设置

MNote tab 只放 MNote 自己拥有的控制面：

3.1 授权区域

来源：SQLite directory_grants / current workspace grants。

展示：

• 当前 workspace/root。
• allowed roots 数量。
• read/write 权限。
• 授权来源：manual / smoke / share / system。
• 权限缺失时的修复入口。

不展示：

• Hermes API key。
• Reasonix ACP binary。
• providerConversationId。

3.2 默认上下文

来源：Page AI context refs。

控件：

• 当前页。
• 打开资源。
• 选中文本。
• 页面子树。
• 附件/资源 tab。

保存语义：

• 这是 MNote 的默认 run envelope 规则。
• 不直接改 Reasonix/Hermes 的 native memory。

3.3 MNote 工具

范围：

• LightRAG。
• citation/open reference。
• page context。
• local file audit。
• changed files receipt。
• MNote MCP/tool facade。

展示：

• enabled/disabled。
• tool count。
• last failed tool。
• capability source。

3.4 会话与审计

范围：

• MNote history。
• export json/markdown/jsonl。
• delete MNote history。
• changed files audit。
• permission pending queue。

删除文案必须固定：

删除只影响 MNote 历史，不删除外部 Hermes/provider/Reasonix session。

外部删除只能出现在 Hermes tab 的危险区，并需要二次确认。

4. Reasonix 设置

Reasonix tab 只放 Reasonix 专属配置与能力：

4.1 Runtime

展示：

• ACP runtime name：reasonix。
• binary/wrapper：scripts/reasonix-acp-wrapper.mjs 或配置来源。
• workspace key 规则。
• native-live 支持状态。
• supports session/load：false。
• supports replay：false。

4.2 Native-live session

只展示配置和策略，不展示当前 active-run 日志。当前 live binding 细节在“状态”页。

设置项：

• native-live 开关或策略说明。
• cold resume fallback 是否启用。
• short reply without context 的提示策略。

4.3 Queue

设置项：

• busy send 行为：enqueue。
• cancel queued item 策略。
• queue max length。
• queue timeout。

当前 queued count / preview 属于“状态”页。

4.4 MCP / tools / memory

范围：

• Reasonix MCP specs。
• Reasonix tool count。
• Reasonix memory 开关。
• Reasonix skill filter。

不放：

• Hermes profile。
• MNote LightRAG provider 设置。
• Chat-only provider 配置。

5. Hermes 设置

Hermes tab 只放 Hermes 相关配置：

5.1 Gateway

展示：

• MNOTE_WEB_HERMES_UPSTREAM_URL。
• gateway health。
• config source。
• logs link / settings link。

当前“未配置 Hermes 设置入口”错误只应出现在 Hermes tab，不应污染 Reasonix 设置或状态。

5.2 Profile / model / provider

展示：

• profile id。
• resolved model。
• provider kind。
• credential status。
• config source。
• API key masked/missing/configured。

5.3 ACP session load / replay

展示：

• supports session/load：true。
• stored acpSessionId。
• load status：loaded / load-failed-new。
• replaySeen / replaySeq / replayMessageCount。

注意：

• replay 是 history restore/evidence，不进入 assistant final。
• load failed 只影响 runtime continuity，不删除 MNote history。

5.4 Skills / memory

范围：

• Hermes skills。
• hide builtin skills。
• Hermes memory sections：soul/user/memory。
• profile-local skills。

5.5 外部删除危险区

默认隐藏在 Hermes tab 底部。

动作：

• 删除 MNote history：跳回 MNote 会话与审计。
• 删除外部 Hermes/provider 会话：必须二次确认，且需要显式参数 deleteExternalProviderSession=1。

6. 状态页

状态页是 7-59 runtime panel 的重排版，不是设置页。

入口：

• 点击顶部 runtime strip。
• 或 header 增加状态图标。

内容：

区块	字段
Current runtime	runtime / mode / profile / model
Session	mnoteSessionId / acpSessionId / providerConversationId
Run	active run / status / queue
Context	allowed roots / context scope
MCP & tools	mcp status / tool count / failed
Jobs	running/completed/failed / stop all
Logs tail	ACP stderr / tool failed / MCP failed
Usage	last run / session total / cache/cost if available

状态页允许两个操作：

操作	语义
Stop turn	只停止当前 run，不删除 session，不关闭 live binding
Reset current runtime	关闭当前 runtime binding/manager，不删除 MNote history，不删除外部 provider

状态页不允许：

• 删除 session history。
• 删除外部 provider/Hermes 会话。
• 改 Hermes API key。
• 改 Reasonix memory。

7. UI 文案规则

7.1 Runtime badge

顶部 badge 应按 owner 明确表达：

Reasonix · native-live
Reasonix · cold-resumed
Hermes · loaded
Hermes · replay-seen
API Chat · server-transcript
Chat-only · provider-conversation

禁止出现“header 是 Reasonix，但 badge 是 hermes new-session”的短暂串线。切换 agent/profile 时必须先清空旧 runtime status，再加载新 status。

7.2 设置 tab 文案

使用：

MNote
Reasonix
Hermes

不用：

Common
高级
Chat-only
Runtime

7.3 危险动作文案

Stop turn：

停止当前输出，不关闭 runtime，不删除历史。

Reset runtime：

重置当前 runtime。MNote 历史保留，外部 provider 会话不删除。

Delete session：

删除 MNote 历史。外部 Hermes/provider 会话不会删除。

External delete：

这会请求删除外部 provider/Hermes 会话，可能不可恢复。需要二次确认。

8. 实施顺序

Phase A：IA rename / no behavior change

• 将设置主 tab 收口为 MNote / Reasonix / Hermes。
• Common 改名 MNote。
• 移除一级 Chat-only tab；Chat-only 配置迁入 MNote > API Chat / Chat-only profile。
• 高级/Runtime 不再作为设置 tab 名称。
• 保持现有 DOM action 与后端合同不变，先只做布局与文案重排。

验证：

node --check rust/crates/mnote-web/browser/sidebar-page-ai-render-runtime.js
node scripts/task559-page-ai-terminal-status-reconciliation-smoke.js

Phase B：状态页从设置页拆出

• 新增或重排 status panel。
• runtime strip 点击打开状态页。
• runtime status、queue、jobs、logs、usage 移到状态页。
• MNote/Reasonix/Hermes 设置页不再显示 transient active-run logs。
• Stop turn / Reset current runtime 只在状态页显示。

验证：

node scripts/task559-page-ai-terminal-status-reconciliation-smoke.js
node scripts/task558-page-ai-reasonix-live-session-context-smoke.js

Phase C：MNote 设置 owner 收口

• 授权区域、默认上下文、MNote 工具、会话与审计进入 MNote tab。
• Chat-only/API Chat profile 的入口进入 MNote tab。
• delete session 文案固定为只删 MNote history。
• permission pending queue 刷新恢复仍可见。

验证：

node scripts/task561-page-ai-session-dashboard-smoke.js
cargo test -p mnote-web api_chat -- --nocapture

Phase D：Reasonix / Hermes 设置 owner 收口

• Reasonix tab 只展示 Reasonix runtime/native-live/queue/MCP/memory。
• Hermes tab 只展示 Hermes gateway/profile/model/provider/load/replay/skills。
• Hermes gateway 未配置错误只出现在 Hermes tab。
• Reasonix 页面不出现 Hermes upstream/API key 错误。
• Hermes 页面不出现 Reasonix native-live queue 当前状态。

验证：

node scripts/task558-page-ai-reasonix-live-session-context-smoke.js
node scripts/task560-page-ai-hermes-load-replay-smoke.js

Phase E：截图与移动端收口

• 桌面宽度下设置 tab 不换行、不挤压。
• 移动宽度下三 tab 可点击，状态页内容可滚动。
• Runtime strip 不遮挡 header action。
• history actions 在移动宽度仍可点击。

验证：

node scripts/task559-page-ai-terminal-status-reconciliation-smoke.js
node scripts/task561-page-ai-session-dashboard-smoke.js

需要补截图断言：

• MNote / Reasonix / Hermes 三 tab 可见。
• 状态页打开后可见 Current runtime / Session / Queue / Logs tail。
• Reasonix 设置页无 Hermes API key 错误。
• Hermes 设置页显示 gateway/profile/model/provider。

9. 不做事项

• 不改变 7-59 的后端 runtime/session API 合同。
• 不新增第二套 runtime truth。
• 不把 Hermes Web UI 作为完整 dashboard 搬进 MNote。
• 不把 Reasonix Desktop settings 全量复制进 MNote。
• 不自动删除外部 Hermes/provider/Reasonix session。
• 不把 runtime logs/job/tool status 拼进 assistant final。

10. 完成条件

• 设置页只剩 MNote / Reasonix / Hermes 三个 owner tab。
• Runtime status 从设置页拆出为独立状态页或 runtime strip popover。
• MNote tab 不出现 Hermes API key / Reasonix binary 这类外部 runtime 配置。
• Reasonix tab 不出现 Hermes upstream 未配置错误。
• Hermes tab 不出现 Reasonix native-live 当前 queue。
• Stop turn / Reset runtime / Delete session 三类动作仍语义分离。
• Reasonix queued send、Hermes load/replay、API Chat、ChatOnly 现有 smoke 全部通过。
• 移动截图中 tab、按钮、状态卡不重叠。

11. 实施记录

2026-06-10 Phase A-E

已完成：

• 设置页 tab 收口为 MNote / Reasonix / Hermes。
• 移除一级 Common / Chat-only / 高级 / Runtime 设置 tab。
• runtime strip 改为可点击入口，点击打开独立 status panel。
• status panel 展示 Current runtime / Session / Queue / Jobs / Logs tail / Usage，并保留 Stop turn / Reset current runtime。
• MNote tab 展示授权区域、默认上下文、会话与审计、API Chat / Chat-only profile、MNote 工具。
• Reasonix tab 只保留 ACP runtime、Reasonix descriptor、Reasonix memory 等专属内容。
• Hermes tab 展示 Hermes gateway、profile/model/provider、Hermes skills/memory，并承载 Hermes gateway 未配置提示。
• 扩展浏览器 smoke，增加设置 IA、状态页、移动宽度 tab 可点性、Hermes/Reasonix owner 边界断言。

验证：

node --check rust/crates/mnote-web/browser/sidebar-page-ai-render-runtime.js
node --check rust/crates/mnote-web/browser/sidebar-page-ai-runtime.js
node --check rust/crates/mnote-web/browser/sidebar-page-ai-profile-runtime.js
node --check rust/crates/mnote-web/browser/sidebar-page-ai-session-runtime.js
node --check rust/crates/mnote-web/browser/sidebar-page-ai-permission-runtime.js
node --check scripts/task558-page-ai-reasonix-live-session-context-smoke.js
node --check scripts/task559-page-ai-terminal-status-reconciliation-smoke.js
node --check scripts/task561-page-ai-session-dashboard-smoke.js
cargo test -p mnote-web hermes_client -- --nocapture
node scripts/task558-page-ai-reasonix-live-session-context-smoke.js
node scripts/task559-page-ai-terminal-status-reconciliation-smoke.js
node scripts/task560-page-ai-hermes-load-replay-smoke.js
node scripts/task561-page-ai-session-dashboard-smoke.js

浏览器截图证据：

• tmp/task559-terminal-status-fpUZi3/task559-runtime-panel.png：状态页展示 Current runtime、Queue、Jobs、Logs tail、Usage。
• tmp/task559-terminal-status-fpUZi3/task559-settings-mobile.png：移动宽度下 MNote / Reasonix / Hermes 三 tab 可点击且不重叠。
• tmp/task561-session-dashboard-ttJKyq/task561-settings-ia.png：Hermes tab 展示 Hermes gateway/profile/skills，不显示 Reasonix queue。

归档说明：

• 本稿只重排 Page AI 设置 IA 与状态页，不改变 7-59 后端 runtime/session API 合同。
• 外部 Hermes/provider 删除仍需显式二次确认；本稿没有新增默认外部删除入口。