2026-07-21 05:13:05 +08:00
# [recycle] 7-59 Page AI Reasonix Desktop / Hermes Web 控制面借鉴设计 v1
2026-06-10 07:09:04 +08:00
> 创建时间：2026-06-10
>
2026-06-13 22:19:44 +08:00
> 当前状态：`DONE`
2026-06-10 07:09:04 +08:00
>
> Owner：
>
> 前置完成项：`design/07-ai/done/7-58-page-ai-reasonix-official-desktop-session-alignment-v1.md`
>
> 参考代码：
> - Reasonix 官方 desktop：
> - Reasonix desktop runtime：
> - Hermes Web UI：
> - Hermes VSCode ACP host：
> - MNote 当前 Page AI：
## 1. 第一结论
`7-58` 已经解决了 Reasonix / Hermes 的底层会话连续性分歧：Reasonix 走 live binding， `session/load` 。
本稿继续处理下一层问题：**Page AI 不应该只是一个聊天抽屉，而应该收敛成“对话 + agent 运行态 + 会话资产 + 配置/权限/工具状态”的轻量控制面。**
Reasonix Desktop 和 Hermes Web 各自值得借鉴的部分不同：
| 参考 | 值得借鉴 | 不应照搬 |
| --- | --- | --- |
| Reasonix Desktop | 运行态事件 reducer、busy/turn complete、queued send、plan/checkpoint/path permission/job/MCP/statusbar | Tauri/Wails 壳、完整桌面布局、Reasonix 专用设置结构 |
| Hermes Web UI | session dashboard、usage/cost、profiles/models/providers、gateway/jobs/logs/config/status、search/export/delete 资产面 | 独立 Web UI IA、Hermes DB 真相、平台 channel 全量管理 |
MNote 的正确方向是：
```text
Page AI drawer = 当前页上下文里的工作面
Page AI session dashboard = MNote 自己的会话资产面
Runtime control surface = Hermes/Reasonix/ChatOnly/API Chat 的统一状态面
External provider/Hermes DB/Reasonix live loop = 外部或进程内 runtime，不是 MNote 长期真相
```
## 2. Reasonix Desktop 对 MNote 的启发
### 2.1 事件不是纯文本流，而是 UI reducer 输入
Reasonix desktop `App.tsx` 将 incoming event 映射为明确状态：
- `$turn_complete` ：解除 busy、清 active skill、驱动 queued send。
- `$path_access_required` / `$confirm_required` / `$choice_required` ：进入前端待决策队列。
- `$plan_required` / `$checkpoint_required` / `$revision_required` / `$step_completed` ：进入 plan/checkpoint UI。
- `$mcp_specs` ：显示 MCP 配置/握手/连接/失败/工具数。
- `$jobs` ：显示后台 job 列表、运行/退出状态、stop/stop all。
- `$ctx_breakdown` / `$balance` / usage：进入 statusbar / context panel。
- `$session_loaded` ：恢复消息、清队列、恢复 carryover usage。
MNote 当前 Page AI 已有 message/tool/permission/session/run 的事件基础，但仍偏“聊天消息优先”。后续应把 Page AI event projection 正式拆成：
| Projection | UI owner | 事件来源 |
| --- | --- | --- |
| final assistant | chat transcript | `message.delta` / final output |
| thought/reasoning | folded reasoning panel | `thought.delta` |
| tool card | tool timeline | `tool.started/completed/failed` |
| permission queue | permission panel/dialog | `permission.*` / ACP decision request |
| plan/checkpoint | plan panel | `plan.updated` / future `checkpoint.*` |
| runtime status | header/statusbar | `session.info.updated` / `run.*` / `usage.updated` |
| MCP/status | runtime control panel | runtime manifest / MCP bridge health |
| background jobs | jobs popover/panel | future `job.*` / tool long-running receipt |
### 2.2 busy 后输入应排队，而不是丢弃或再开 session
Reasonix Desktop 有 `queuedSends` ：busy 时用户继续发送，不直接开新底层 session；
MNote 对 Reasonix 尤其需要这个模型，因为同一 live binding 内必须串行 prompt。当前 `7-58` 对 busy binding 会返回 `acp_reasonix_session_busy` 。后续应该升级为：
```text
Reasonix binding running
-> 新输入进入 MNote Page AI session queue
-> UI 显示 queued count / 可取消
-> 当前 run terminal 后自动启动下一条 run
-> 仍复用同一 live binding / acpSessionId
```
验收不应只是“不报 busy”，而是验证两条快速输入仍同一 `acpSessionId` 且顺序正确。
### 2.3 Stop 语义必须拆三层
Reasonix Desktop 的 stop 更接近“停止当前 turn/job”，不是删除 session。MNote 后续 UI 应明确三个按钮/动作：
| 动作 | 含义 | 默认影响 |
| --- | --- | --- |
| Stop turn | 取消当前 prompt | 保留 MNote session 与 live binding |
| Reset runtime | 关闭 Reasonix live binding / Hermes ACP manager | 保留 MNote history，下一轮 cold/new |
| Delete session | 删除 MNote session history/audit | 不默认删除外部 Hermes DB / provider 会话 |
这能避免用户点击“停止”后误以为历史或底层 session 被删。
### 2.4 MCP / jobs / usage 要进状态条，不进 assistant 正文
Reasonix Desktop 把 MCP specs、jobs、usage、balance 放到 sidebar/statusbar/settings，而不是让模型自然语言解释。
MNote 后续应在 Page AI header 下增加 compact status strip：
```text
runtime: Reasonix native-live | Hermes loadable | ChatOnly provider
session: mnoteSessionId / acpSessionId / mode
model/profile: profile id + resolved model
roots: write/read-only grant count
MCP: connected/failed/tool count
tools: enabled/disabled count
jobs: running count
usage: last run tokens/cost/cache if available
```
## 3. Hermes Web 对 MNote 的启发
Hermes Web UI 的 README 将能力分成 Chat、Platform Channels、Usage、Jobs、Model Management、Multi-Profile/Gateway、File Browser、Group Chat、Skills/Memory、Logs、Auth、Settings、Web Terminal。
MNote 不能照搬完整 dashboard，但可以抽取控制面能力：
### 3.1 Session asset dashboard
Hermes Web 的 session 管理包含：多会话、rename/delete/switch、SQLite session DB、按来源分组、active session pin、搜索、模型 badge、context token usage。
MNote 已有最小 list/detail/search/export/rename/delete。后续应补：
- active session pin：正在 run 的 session 固定到历史列表顶部。
- runtime grouping：
- status filters：
- search fields：
- export profile：
- delete semantics badge：仅删 MNote history，外部 provider/Hermes DB 不默认删除。
### 3.2 Usage / cost / context panel
Hermes Web 有 usage analytics：
MNote 不需要先做全局财务面板，但 Page AI 应先做 session/run 级 usage：
- 当前 run：
- 当前 session：累计 tokens/cost/cache hit。
- 当前 runtime：
- fallback/cold resume：显示 packet 大小和截断原因。
Reasonix Desktop 的 `ctx_breakdown` 与 Hermes Web 的 usage store 可以合并成 MNote 的 `page_ai_usage_projection.v1` 。
### 3.3 Profiles / models / providers
Hermes Web 将 providers/models/profiles 拆成独立设置面，并支持 credential pool、provider presets、default model switching。
MNote 当前 Page AI profile selector 已可用，但缺少“解析后的真实模型与凭据状态”。后续应显示：
| 字段 | 示例 |
| --- | --- |
| profileId | `mnoteai` / `shared_api_deepseek_flash_chat` |
| providerKind | `hermes-acp` / `api-chat` / `web-provider` |
| resolvedModel | `deepseek-v4-flash` / `gpt-5.5` |
| credentialStatus | configured / missing / inherited / masked |
| runtimeBinary | `hermes` / `node scripts/reasonix-acp-wrapper.mjs` |
| configSource | control-plane / env / profile file |
### 3.4 Gateway / logs / jobs
Hermes Web 把 gateway、logs、jobs 作为运维一等公民。MNote 后续应只引入轻量版：
- Runtime health：
- Logs tail：最近 N 条 ACP stderr、tool failed、permission denied、MCP failed。
- Jobs：长任务工具的 running/completed/failed，不把后台进度塞进 assistant final。
### 3.5 Skills / memory
Hermes Web 有 skills/memory 浏览。Reasonix Desktop 也有 skills、memory、MCP specs。
MNote Page AI 后续应把 skill/memory 作为 runtime capability，而不是继续分散在设置页：
- 当前 runtime 可用 skills。
- enabled/disabled user preference。
- inline/subagent 模式。
- project/global/builtin scope。
- memory source：
- 对 Reasonix native-live，不把 MNote memory 强塞到每轮 prompt；只作为 capability manifest 或 cold resume fallback 输入。
## 4. 目标信息架构
### 4.1 Page AI drawer 分区
```text
Header
runtime badge / profile / model / session mode / active-run status
Chat
user / assistant final
folded thought
tool cards
citations
changed files receipt
Runtime
live binding / acpSessionId / load/replay / cold resume
MCP status
allowed roots
tool enablement
permission queue
jobs
usage/context
History
list / search / filters / export / rename / delete
Settings
profile/model/provider
skills/memory
runtime health/logs
```
### 4.2 不同 runtime 的展示差异
| Runtime | Header mode | Runtime panel 必显 | 不显示/禁用 |
| --- | --- | --- | --- |
| Reasonix ACP | `native-live` / `cold-resumed` / `new-session` | live binding、MCP specs、jobs、allowed roots、queued sends | `session/load` 成功率、provider conversation |
| Hermes ACP | `loaded` / `load-failed-new` / `replay-seen` | acpSessionId、load/replay、profile/model、tool locations | Reasonix live binding status |
| ChatOnly Web | `provider-conversation` | providerConversationId、remote delete status | ACP session/load/live binding |
| API Chat | `server-transcript` | model/provider/usage、MNote transcript | provider web conversation binding |
## 5. 后端合同
### 5.1 Runtime status snapshot
新增或收口一个 Page AI runtime status API：
```text
GET /api/page-ai/runtime/status?sessionId=...&workspaceId=...&documentId=...
```
返回：
```json
{
"schema" : "mnote.page_ai_runtime_status.v1" ,
"mnoteSessionId" : "..." ,
"runtime" : "reasonix" ,
"profile" : "reasonix" ,
"mode" : "native_live" ,
"activeRun" : { "runId" : "..." , "status" : "running" },
"acp" : {
"acpSessionId" : "..." ,
"supportsSessionLoad" : false ,
"replaySeen" : false ,
"liveBinding" : { "status" : "idle" , "workspaceKey" : "file://..." }
},
"model" : { "resolvedModel" : "..." , "providerKind" : "..." },
"roots" : { "write" : 1 , "readOnly" : 0 },
"mcp" : { "status" : "connected" , "toolCount" : 8 , "failed" : [] },
"tools" : { "enabled" : 12 , "disabled" : 2 },
"jobs" : { "running" : 0 },
"usage" : { "sessionTokens" : 0 , "lastRunTokens" : 0 }
}
```
规则：
- `acpSessionId` 只作为 runtime reference，不是 MNote 长期真相。
- Reasonix `supportsSessionLoad=false` 必须明确展示。
- Hermes replay 只能影响 `replaySeen/replaySeq` ，不能当当前 answer。
- ChatOnly/API Chat 不返回 ACP binding。
### 5.2 Session search/export 升级
现有 `/api/hermes/client/sessions/search` 与 `/export` 后续收口为 Page AI 命名：
```text
GET /api/page-ai/sessions
GET /api/page-ai/sessions/search?q=...
GET /api/page-ai/sessions/{id}
GET /api/page-ai/sessions/{id}/export?format=json|markdown|jsonl
POST /api/page-ai/sessions/{id}/rename
DELETE /api/page-ai/sessions/{id}
```
`/api/hermes/client/sessions/*` 保留 compat，但前端新代码优先走 `/api/page-ai/*` 。
### 5.3 Queued sends
新增队列表：
```text
page_ai_queued_runs
id
user_id
workspace_id
document_id
session_id
run_id
runtime
profile
payload_json
status: queued | started | cancelled | failed
created_at / updated_at
```
Reasonix live binding busy 时不返回 failed，而是入队。
## 6. 前端实现边界
### 6.1 文件 owner
| 文件 | 改动边界 |
| --- | --- |
| `sidebar-page-ai-runtime.js` | 只保留 orchestration；不要继续塞 dashboard 渲染细节 |
| `sidebar-page-ai-session-runtime.js` | session list/detail/search/export/rename/delete/filters |
| `sidebar-page-ai-render-runtime.js` | Page AI 面板渲染，新增 Runtime / Dashboard 分区 |
| `sidebar-page-ai-profile-runtime.js` | profile/model/provider 解析展示 |
| `sidebar-page-ai-skill-runtime.js` | skill/memory/MCP capability 偏好 |
| `sidebar-page-ai-permission-runtime.js` | permission decision queue |
| 新建议：`sidebar-page-ai-runtime-status-runtime.js` | runtime status polling/event apply，不和 chat streaming 混写 |
### 6.2 UI 原则
- Runtime 状态只做 compact status strip + detail panel，不占 assistant 正文。
- thought/tool/plan/permission/citation 分区渲染，不拼进 final answer。
- history action 永远可点击，不靠 hover 才能完成核心操作。
- stop/reset/delete 三类危险程度不同，按钮必须分开。
- 短回复“可以/继续”在 `new-session` 且无 history 时显示缺上下文提示。
## 7. 执行顺序
### Phase A：
2026-06-13 22:19:44 +08:00
- [x] 后端新增 `/api/page-ai/runtime/status` ，返回 runtime/profile/model/session/acp/mcp/tools/jobs/usage。
- [x] 前端 header 显示 runtime badge、session mode、active-run status。
- [x] Runtime panel 展示 `acpSessionId` 、Reasonix live binding、Hermes load/replay、allowed roots。
- [x] 浏览器 smoke：
2026-06-10 07:09:04 +08:00
### Phase B：
2026-06-13 22:19:44 +08:00
- [x] Reasonix busy binding 改为 queued send，不再直接 failed。
- [x] 队列 UI 显示 queued count、queued text preview、cancel。
- [x] 当前 run terminal 后自动启动下一条 queued run，仍复用同一 live binding。
- [x] Stop turn 不关闭 binding；
- [x] MCP specs/status/toolCount 进入 runtime panel。
- [x] Jobs popover 支持 long-running tool receipt / stop all。（当前无真实后台 job registry 时展示空态和 no-op stop-all，后续长任务接入只需填充 `jobs.items` 。）
- [x] Smoke：快速发送两条消息，验证 FIFO、同一 `acpSessionId` 、无输出中残留。
2026-06-10 07:09:04 +08:00
### Phase C：
2026-06-13 22:19:44 +08:00
- [x] Page AI session API 命名从 `/api/hermes/client/sessions` 收口到 `/api/page-ai/sessions` 。
- [x] session list 支持 runtime grouping、active pin、status filters。
- [x] search 支持 message/tool/citation/changed file/error code。
- [x] export 支持 json/markdown/jsonl 三格式。
- [x] usage panel 展示 session/run/model/cache/cost。
- [x] profile/model/provider panel 展示 resolved model、credential status、config source。
- [x] Smoke：
2026-06-10 07:09:04 +08:00
### Phase D：权限/配置/外部删除边界
2026-06-13 22:19:44 +08:00
- [x] permission decision loop 做成持久 pending queue，刷新后不丢。
- [x] delete session 明确只删除 MNote history；外部 Hermes/provider 删除必须二次确认。
- [x] reset runtime 只关闭 live binding/ACP manager，不删除 MNote history。
- [x] logs tail 显示 ACP stderr、tool failed、MCP failed 最近 N 条。
- [x] Smoke：
2026-06-10 07:09:04 +08:00
## 8. 验收矩阵
### 8.1 Reasonix
2026-06-13 22:19:44 +08:00
- [x] `native-live` 状态清晰可见。
- [x] busy 时第二条输入进入 queue，不开新 session。
- [x] queued send 自动执行后仍同一 `acpSessionId` 。
- [x] Stop turn 后下一轮仍可 native-live。
- [x] Reset runtime 后下一轮显示 `cold_resumed` 或 `new_session` 。
- [x] MCP failed 显示为 status/tool card，不污染 assistant final。
2026-06-10 07:09:04 +08:00
### 8.2 Hermes ACP
2026-06-13 22:19:44 +08:00
- [x] stored `acpSessionId` 先 `session/load` 。
- [x] replay 显示为 replay evidence / history restore，不混入当前回答。
- [x] load failed 明确显示 `load-failed-new` 。
- [x] session dashboard 可按 Hermes profile/model 过滤。
2026-06-10 07:09:04 +08:00
### 8.3 ChatOnly / API Chat
2026-06-13 22:19:44 +08:00
- [x] providerConversationId 与 acpSessionId 不混用。
- [x] API Chat 不写 web provider binding。
- [x] session dashboard 仍可展示/search/export。
- [x] delete MNote history 不默认删除远端 provider 会话。
2026-06-10 07:09:04 +08:00
### 8.4 通用 UI
2026-06-13 22:19:44 +08:00
- [x] 回答完成后无 `AI · 输出中` 。
- [x] history actions 在桌面/移动都可点击。
- [x] runtime status 与当前 session 一致，切 session 后不显示旧 acpSessionId。
- [x] tool/citation/permission/plan/job 不进入 assistant final。
2026-06-10 07:09:04 +08:00
## 9. 不做事项
- 不把 Reasonix Desktop 的 Tauri shell 或完整布局搬进 MNote。
- 不把 Hermes Web UI 作为 MNote 的独立 dashboard 复刻。
- 不把 Hermes DB 当成 MNote session 真相。
- 不把 Reasonix native memory 改造成 MNote 每轮 transcript 注入。
- 不自动删除外部 Hermes/provider session store。
- 不在 Page AI 主路径继续叠加无界轮询；runtime status 优先事件/command result 驱动，短期 fallback 必须有退出条件。
## 10. 首批可执行切片
### 10.1 Slice A1：
目标：先让 Page AI 能回答“当前 agent 是谁、是否还在运行、底层 session 是否连续、MCP/工具是否可用”。
范围：
- 新增 `/api/page-ai/runtime/status` 只读 route。
- 数据先从现有 `PageAiSessionStore` / `AcpSessionManager` / profile resolver / tool registry 组合，不新增长期表。
- Reasonix 返回 `mode=native_live|cold_resumed|new_session` ， `mode=loaded|load_failed_new|replay_seen|new_session` ，
- active run 状态必须来自 event store / terminal reconciliation 后的最终状态，不能只看前端 streaming flag。
验收：
```bash
cargo test -p mnote-web page_ai_runtime_status
```
若 Rust route 暂时没有专名测试，至少补一个 fake store/unit test 覆盖 Reasonix、Hermes、API Chat 三类 snapshot。
### 10.2 Slice A2：
目标：把 runtime status 放到聊天抽屉顶部，而不是让 assistant 正文解释。
范围：
- `sidebar-page-ai-render-runtime.js` 增加 compact status strip。
- `sidebar-page-ai-runtime.js` 只负责加载/应用 status，不塞具体 DOM 细节。
- 回答终止后 status strip 必须同步清理 active-run，避免 `AI · 输出中` 残留。
- 切换 session/document 后先清空旧 status，再加载新 status，避免旧 `acpSessionId` 短暂串线。
验收：
```bash
node scripts/task559-page-ai-terminal-status-reconciliation-smoke.js
```
并补一条真实浏览器 smoke：
### 10.3 Slice B1：
目标：busy binding 不再直接失败，先支持同一 Page AI session 内 FIFO 串行发送。
范围：
- 先实现内存队列或 event-store backed queue；如果实现跨刷新不稳定，再升级 `page_ai_queued_runs` 表。
- queue item 必须记录 `sessionId` 、`runId` 、`runtime` 、`profile` 、`acpSessionId` 、原始 prompt payload。
- 当前 run terminal 后自动 dequeue 下一条，仍复用 Reasonix live binding。
- cancel queued item 只取消队列项，不 stop 当前 run。
验收：
```bash
node scripts/task558-page-ai-reasonix-live-session-context-smoke.js
```
新增/扩展浏览器断言：
- 快速发送两条消息。
- 第二条先显示 queued。
- 两轮完成后 `acpSessionId` 一致。
- 第二轮短回复能引用第一轮上下文。
- 最终无 `AI · 输出中` 。
### 10.4 Slice C1：
目标：前端新主路径不再把 Page AI session dashboard 命名成 Hermes client。
范围：
- 新增 `/api/page-ai/sessions/*` wrapper。
- 复用现有 `/api/hermes/client/sessions/*` handler 或 store，不重复实现。
- 老路由继续保留 compat；测试必须证明老路由仍可用。
- 前端 session runtime 优先请求 `/api/page-ai/sessions/*` 。
验收：
```bash
cargo test -p mnote-web page_ai_sessions
node scripts/task561-page-ai-session-dashboard-smoke.js
```
### 10.5 Slice C2：
目标：把 Hermes ACP `session/load` 与 replay 作为 runtime evidence 展示，而不是混入当前回答。
范围：
- status snapshot 增加 `loadAttempted` 、`loadStatus` 、`replaySeen` 、`replaySeq` 、`replayMessageCount` 。
- UI 显示为 runtime panel evidence。
- 当前 assistant final 只来自当前 run final，不消费 replay 作为回答。
验收：
```bash
node scripts/task560-page-ai-hermes-load-replay-smoke.js
```
覆盖无 replay / 有 replay 两种 fake Hermes ACP fixture。
## 11. Event projection 合同
Page AI 后续统一把 runtime events 规整成下面几类 projection。前端只能消费 projection，不直接按 provider 原始事件猜 UI 状态。
| Projection | 关键字段 | terminal 规则 |
| --- | --- | --- |
| `runProjection` | `runId/status/startedAt/endedAt/errorCode` | `completed/failed/cancelled` 必须清 active-run |
| `messageProjection` | `role/final/thought/toolCalls/citations` | final 与 thought 分离 |
| `sessionProjection` | `mnoteSessionId/runtime/acpSessionId/mode` | 切 session 后旧 projection 不可复用 |
| `runtimeProjection` | `profile/model/provider/binary/configSource` | profile 切换后立即 invalidated |
| `capabilityProjection` | `mcp/tools/skills/memory/roots` | failed capability 不污染 assistant final |
| `decisionProjection` | `permission/choice/confirm/pathAccess` | pending 决策可刷新恢复 |
| `queueProjection` | `queuedCount/items/cancellable` | current terminal 后 FIFO dequeue |
| `usageProjection` | `tokens/cost/cache/contextBreakdown` | usage 缺失时显示 unknown，不伪造 0 |
最低要求：
- `AI · 输出中` 只能绑定 `runProjection.status=running|streaming` 。
- `acpSessionId` 只能来自 `sessionProjection` 。
- replay、load、MCP、job、permission 都不能写进 assistant final。
- provider 原始 event 增加新字段时，未识别字段进入 `rawEvidence` ，不直接影响 UI。
## 12. 风险与边界
### 12.1 上下文连续性的误判风险
短回复“可以/继续”天然依赖历史。UI 必须区分：
| 状态 | 用户提示 |
| --- | --- |
| `native_live` / `loaded` | 显示连续会话 |
| `cold_resumed` | 显示已用 MNote history fallback 恢复 |
| `new_session` 且 history 为空 | 提示当前没有可用上下文 |
| `load_failed_new` | 提示底层 ACP load 失败，已新建 runtime session |
这比单纯把 transcript 拼进 prompt 更重要，因为 Reasonix native-live 与 Hermes load/replay 的真实连续机制不同。
### 12.2 删除与重置边界
删除、重置、停止必须保持三套语义：
- `Stop turn` ：只影响当前 run。
- `Reset runtime` ：只影响 Reasonix live binding / Hermes ACP process 或 manager。
- `Delete session` ：只影响 MNote session history；外部 Hermes DB / provider 会话删除必须另设显式二次确认。
### 12.3 轮询边界
runtime status 首选 event apply / command result refresh。短期允许有界 fallback，但必须满足：
- 仅在 Page AI drawer 可见且当前 session active 时启用。
- interval 有最大时长和 stop 条件。
- run terminal、session switch、drawer close 都必须停止。
- 后续进入 done 前，要记录是否已替换为 event-driven。
## 13. 设计归档规则
本稿进入 `done/` 前必须满足：
- Phase A-D checklist 至少按 slice 完成，并记录每个 slice 的测试命令。
- 浏览器 smoke 证明 Reasonix、Hermes ACP、ChatOnly/API Chat 不串状态。
- 用户最初两个问题已有可见验收：短回复能继承上下文，回答完成不残留 `AI · 输出中` 。
- 若某项因为外部 provider 权限、Hermes DB 删除策略或 Reasonix 官方行为无法完成，必须在本稿末尾追加“归档说明”，不能只留 unchecked TODO。
## 14. 本稿完成条件
- Phase A-D checklist 有真实代码、单测或 browser smoke。
- Reasonix queued send / stop / reset 语义明确可见。
- Hermes-style session dashboard 不再挂在 `/api/hermes/client/*` 命名主路径上。
- Runtime status 能解释用户最关心的四件事：当前 agent 是谁、上下文是否连续、工具/MCP 是否可用、为什么还在输出中或已经结束。
- ChatOnly / API Chat 回归不受 ACP runtime status 改动影响。
2026-06-13 22:19:44 +08:00
## 15. 实施记录
### 2026-06-10 Slice A-D 完成记录
已完成：
- 后端新增 `/api/page-ai/runtime/status` ，返回 `runtime/profile/model/session/acp/mcp/tools/jobs/usage/logs` 。
- 前端 Page AI header 增加 runtime status strip，
- `AI · 输出中` / active-run 清理继续走 terminal reconciliation； `session.created` 不再被判定为 active run。
- Reasonix 前端 busy/queued/running 发送改为 client FIFO queue：当前 run 结束后自动发送下一条，仍复用当前 MNote session 和已保存的 `acpSessionId` 。
- Reasonix live binding 的 direct busy fallback 不再立即返回 `acp_reasonix_session_busy` failed；
- 队列 UI 显示 queued count、preview、cancel；
- 新增 `/api/page-ai/sessions/*` 主命名 route，旧 `/api/hermes/client/sessions/*` 保留 compat。
- 前端 session runtime 已切到 `/api/page-ai/sessions/*` 。
- Hermes replay 继续作为 `adapter_replay` evidence； `replaySeen/replaySeq/replayMessageCount` 。
- permission pending queue 增加 localStorage 恢复，刷新后可恢复未决 permission。
- 新增 `/api/page-ai/runtime/reset` ，只关闭 Reasonix live binding / runtime binding，不删除 MNote history 或外部 provider session。
- session delete 默认只删除 MNote history / 本地 provider binding 标记；外部 provider 远端删除需要 `deleteExternalProviderSession=1` 。
- session dashboard 增加 runtime/status filter、active pin、可见 action，前端主路径使用 `/api/page-ai/sessions/*` 。
- session export 增加 `json/markdown/jsonl` 三格式。
- runtime panel 增加 jobs/logs tail；当前无真实长任务 registry 时显示空态，`Stop all` 不删除 history / runtime，只在无 job 时提示无可停止项。
验证：
```bash
cargo test -p mnote-web page_ai_runtime_status -- --nocapture
cargo test -p mnote-web page_ai_session_active_run -- --nocapture
cargo test -p mnote-web delete_session -- --nocapture
cargo test -p mnote-web hermes_client -- --nocapture
node --check rust/crates/mnote-web/browser/sidebar-page-ai-runtime.js
node --check rust/crates/mnote-web/browser/sidebar-page-ai-render-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 scripts/task559-page-ai-terminal-status-reconciliation-smoke.js
node scripts/task558-page-ai-reasonix-live-session-context-smoke.js
node scripts/task560-page-ai-hermes-load-replay-smoke.js
node 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` ：通过，验证快速连续发送、queued preview、同一 `acpSessionId` 、第二轮“可以”继承上下文、无输出中残留。
- `node scripts/task559-page-ai-terminal-status-reconciliation-smoke.js` ：通过，验证 terminal reconciliation、runtime strip、runtime panel jobs/logs/status 可见。
- `node scripts/task560-page-ai-hermes-load-replay-smoke.js` ：通过，覆盖 no replay / with replay。
- `node scripts/task561-page-ai-session-dashboard-smoke.js` ：通过，验证 `/api/page-ai/sessions/*` 、search、status filter、export `json/markdown/jsonl` 、rename/delete。
归档说明：
- 当前 jobs 面板已经有 `jobs.running/items` 合同、空态和 Stop all 控件；由于 Page AI 还没有真实 long-running job registry，本稿不伪造 job receipt，不接外部 provider job 删除。后续长任务工具接入时只扩充 `jobs.items` 和 stop handler。
- 外部 Hermes/provider 远端删除仍不提供默认 UI 动作；后端只接受显式 `deleteExternalProviderSession=1` ，前端普通 Delete session 只删 MNote history。
