feat: complete page ai hermes control checklist

design/07-ai/done/7-7-page-ai-mini-hermes-control-surface-v1.md

@@ -1,8 +1,8 @@
-# 7-7 [process] 页面 AI Mini Hermes 控制面设计与执行 checklist v1
+# 7-7 [done] 页面 AI Mini Hermes 控制面设计与执行 checklist v1
 
 > 更新时间：2026-05-14
 >
-> 当前状态：`PROCESS`。当前实现已经可以通过 Hermes 返回回复，并已完成 `7-4` 的 session/run/tool/writeback/audit 主链；本稿只承接下一阶段体验与 agent / skill / 设置面的收口。当前已补上 `agent/profile` 选择、`SOUL.md` / `USER.md` / `MEMORY.md` 轻编辑、skill 启停和对应 smoke，但 stop/retry、完整 settings 跳转、tool audit 完整面还未收口。
+> 当前状态：`DONE`。当前实现已经可以通过 Hermes 返回回复，并已完成 `7-4` 的 session/run/tool/writeback/audit 主链；本稿承接的 Mini Hermes 控制面已完成：`agent/profile` 选择、`SOUL.md` / `USER.md` / `MEMORY.md` 轻编辑、skill 启停、Hermes settings 深链、run stop、context scope、mnote tool 可用性和最近 tool call / trace / audit 摘要均已有代码与 smoke 验证。retry、session rename/delete、profile create/rename、skill 上传继续作为 P2，不在本稿 done gate 内。
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -329,21 +329,21 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 
 ### I. 自动化验收
 
-- [ ] I1. 新增或扩展 browser smoke：session 状态条。
+- [x] I1. 新增或扩展 browser smoke：session 状态条。
   - 验收标准：断言 session title/model/run status 可见。
-- [ ] I2. 新增或扩展 browser smoke：agent/profile 选择。
+- [x] I2. 新增或扩展 browser smoke：agent/profile 选择。
   - 验收标准：断言 profile 列表来自 Hermes；切换 profile 后新 run/session 使用目标 profile。
-- [ ] I3. 新增或扩展 browser smoke：agent 人格文件编辑。
+- [x] I3. 新增或扩展 browser smoke：agent 人格文件编辑。
   - 验收标准：保存 `SOUL.md` 或 `USER.md` 后通过 Hermes API 读回一致；运行中保存行为符合禁用或提示规则。
-- [ ] I4. 新增或扩展 browser smoke：skill 启停。
+- [x] I4. 新增或扩展 browser smoke：skill 启停。
   - 验收标准：toggle 后刷新仍保持 Hermes 返回状态；失败时 UI 回滚。
-- [ ] I5. 新增或扩展 browser smoke：run stop/retry。
+- [x] I5. 新增或扩展 browser smoke：run stop/retry。
   - 验收标准：至少覆盖 stop；retry 若未实现则断言按钮不存在或禁用。
-- [ ] I6. 新增或扩展 browser smoke：context scope。
+- [x] I6. 新增或扩展 browser smoke：context scope。
   - 验收标准：选区/当前页上下文能进入 run payload 或 tool audit。
-- [ ] I7. 新增或扩展 browser smoke：tool 可用性与 audit。
+- [x] I7. 新增或扩展 browser smoke：tool 可用性与 audit。
   - 验收标准：能看到 mnote tool 列表、一次 tool call、对应 audit id。
-- [ ] I8. 移动端 smoke。
+- [x] I8. 移动端 smoke。
   - 验收标准：状态条、tool 折叠、输入区在窄屏不重叠。
 
 ---
@@ -352,29 +352,47 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 
 本稿移入 `done/` 前必须同时满足：
 
-- [ ] 页面 AI 抽屉具备 Mini Hermes 状态条，用户能看见当前 session、model/agent profile、run 状态。
-- [ ] 页面 AI 抽屉能选择 agent/profile；切换 agent 不篡改已有 Hermes session profile。
-- [ ] 页面 AI 抽屉能轻编辑当前 agent 的 `SOUL.md`、`USER.md`、`MEMORY.md`，保存真相在 Hermes。
-- [ ] 页面 AI 抽屉能搜索、查看并启停 Hermes skill，刷新后状态仍以 Hermes 返回为准。
-- [ ] 页面 AI 抽屉具备 context scope 控件，run input 和 tool audit 能反映 scope。
-- [ ] 页面 AI 抽屉能展示 mnote tool 可用性、最近 tool call 和 audit/trace 串联。
-- [ ] stop 至少可用；retry/rename/delete 若未实现，必须明确标为 P2 且 UI 不出现假可用按钮。
-- [ ] Hermes 未启动、模型缺失、plugin/tool 不可用、权限失败至少四类错误有可区分展示。
-- [ ] 页面刷新后仍以 Hermes session detail/resume 为会话真相。
-- [ ] mnote 不保存聊天消息真相，不保存 provider/API key，不创建第二套 profile/skill/plugin registry。
-- [ ] `git diff --check` 通过。
-- [ ] Rust 侧相关测试通过：`cargo test -p mnote-web hermes_client -- --nocapture`、`cargo test -p mnote-web hermes_tools_ -- --nocapture`。
-- [ ] 正式 `3000` smoke 覆盖 session/run/tool/audit/mobile，且证据写回本文。
+- [x] 页面 AI 抽屉具备 Mini Hermes 状态条，用户能看见当前 session、model/agent profile、run 状态。
+- [x] 页面 AI 抽屉能选择 agent/profile；切换 agent 不篡改已有 Hermes session profile。
+- [x] 页面 AI 抽屉能轻编辑当前 agent 的 `SOUL.md`、`USER.md`、`MEMORY.md`，保存真相在 Hermes。
+- [x] 页面 AI 抽屉能搜索、查看并启停 Hermes skill，刷新后状态仍以 Hermes 返回为准。
+- [x] 页面 AI 抽屉具备 context scope 控件，run input 和 tool audit 能反映 scope。
+- [x] 页面 AI 抽屉能展示 mnote tool 可用性、最近 tool call 和 audit/trace 串联。
+- [x] stop 至少可用；retry/rename/delete 若未实现，必须明确标为 P2 且 UI 不出现假可用按钮。
+- [x] Hermes 未启动、模型缺失、plugin/tool 不可用、权限失败至少四类错误有可区分展示。
+- [x] 页面刷新后仍以 Hermes session detail/resume 为会话真相。
+- [x] mnote 不保存聊天消息真相，不保存 provider/API key，不创建第二套 profile/skill/plugin registry。
+- [x] `git diff --check` 通过。
+- [x] Rust 侧相关测试通过：`cargo test -p mnote-web hermes_client -- --nocapture`、`cargo test -p mnote-web hermes_tools_ -- --nocapture`。
+- [x] 正式 `3000` smoke 覆盖 session/run/tool/audit/mobile，且证据写回本文。
 
 ---
 
-## 8. 当前建议的下一步
+## 8. P2 后续项
 
-优先顺序：
+以下能力不阻塞本稿 `done`，后续另开设计或 checklist 推进：
 
-1. 先补顶部 Mini Hermes 状态条、agent/profile 选择和错误态，因为这是当前“能回复但缺 Hermes 设置感”的直接缺口。
-2. 再补 skill 搜索/启停和 agent 人格轻编辑，让用户能在 mnote 页面内完成常用 agent 调整。
-3. 再补 context scope 和 tool 可用性，让用户明确 Hermes 正在调用 mnote 的哪些能力。
-4. 最后补 session 列表、rename/delete/search、profile create/rename、skill 上传等 P2 能力。
+- retry / continue 的更完整 Hermes run lifecycle。
+- session rename / delete / search。
+- profile create / rename / import / export。
+- skill 文件详情、pin、上传与 marketplace 发布。
+- usage / logs / jobs / files / channels / terminal / group chat 等 Hermes 管理台页面。
 
 不要先做 Hermes 全局设置页复刻。API key、provider、usage/logs/jobs/files/channels、profile 导入导出、skill marketplace 发布仍应留在 Hermes 自己的管理台。
+
+---
+
+## 9. 验收证据
+
+- 设计参考已落到本文第 2 节的精确文件索引；人格页参考图为 `/mnt/Data1T/mnote/tmp/img_v3_0211m_b7390ad9-a45b-4d94-8126-b7c17f029feg.png`，技能页参考图为 `/mnt/Data1T/mnote/tmp/img_v3_0211m_0d6e7a60-8c21-4fd1-8cdf-d548dab7532g.png`。
+- 代码入口：`rust/crates/mnote-web/src/ssr/pages/layout.rs`、`rust/crates/mnote-web/src/ssr/styles.rs`、`rust/crates/mnote-web/src/routes/hermes_client.rs`、`rust/crates/mnote-web/src/routes/web_shell.rs`、`rust/crates/mnote-web/src/routes/mod.rs`。
+- 自动化：
+  - `cargo test -p mnote-web hermes_client -- --nocapture`
+  - `cargo test -p mnote-web hermes_tools -- --nocapture`
+  - `cargo test -p mnote-web web_shell -- --nocapture`
+  - `node scripts/task-hermes-page-ai-agent-skill-smoke.js`
+  - `node scripts/task-hermes-page-ai-smoke.js`
+  - `node scripts/task-hermes-page-ai-mobile-smoke.js`
+  - `MNOTE_EXPECTED_HERMES_SETTINGS_URL=http://127.0.0.1:8642/hermes/settings node scripts/task-hermes-page-ai-runtime-controls-smoke.js`
+- 截图证据：`/mnt/Data1T/mnote/tmp/page-ai-mini-hermes-control-surface.png`。
+- 运行约束：上述 smoke 已在正式 `3000` mnote-web 入口执行；`3000` 已重启为当前最新二进制。