feat: expand page ai hermes control surface

2026-05-14 17:04:17 +08:00
parent d1d19f755c
commit f257b2a014
6 changed files with 1447 additions and 50 deletions
@@ -2,7 +2,7 @@

 > 更新时间：2026-05-14
 >
-> 当前状态：`PROCESS`。当前实现已经可以通过 Hermes 返回回复，并已完成 `7-4` 的 session/run/tool/writeback/audit 主链；本稿只承接下一阶段体验与设置面的收口。
+> 当前状态：`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 完整面还未收口。
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -24,14 +24,20 @@

 下一阶段不要把 mnote 做成第二个 Hermes 管理台，也不要把 Hermes 的 Settings / Profiles / Usage / Logs 全部搬进页面抽屉。正确方向是：

-> **页面 AI 面板成为 Mini Hermes control surface：只展示和当前 mnote 页面会话直接相关的 session、run、model、profile、tool、context scope 与错误恢复；所有全局配置真相仍归 Hermes。**
+> **页面 AI 面板成为 Mini Hermes control surface：只管理和当前 mnote 页面会话直接相关的 session、run、agent/profile、model、skill、tool、context scope 与错误恢复；所有全局配置真相仍归 Hermes。**

 边界继续保持：

 - Hermes 持有 session/message/tool event/usage/model/profile 真相。
 - mnote 只持有页面、树、正文、artifact、edge、Page Aggregate 和 audit 真相。
 - 页面 AI 面板只调用 Hermes，不保存聊天历史，不维护 provider/API key，不重建 plugin registry。
- 需要深层设置时跳转或 deep link 到 Hermes 自己的设置页。
+- 页面 AI 面板可以选择 agent/profile、启停 skill、编辑当前 agent 的轻量人格文件；保存和生效都必须走 Hermes API。
+- provider/API key、账号登录、全局 marketplace、profile 导入导出等深层设置跳转或 deep link 到 Hermes 自己的设置页。
+
+用户提供的参考图只作为能力边界参考，不要求照搬 UI：
+
+- `/mnt/Data1T/mnote/tmp/img_v3_0211m_b7390ad9-a45b-4d94-8126-b7c17f029feg.png`：AI 人格页，包含 `SOUL.md`、`IDENTITY.md`、`USER.md` 类 profile 文件编辑和保存。
+- `/mnt/Data1T/mnote/tmp/img_v3_0211m_0d6e7a60-8c21-4fd1-8cdf-d548dab7532g.png`：技能页，包含搜索、上传、自定义技能额度、单个技能启停和详情查看。

 ---

@@ -53,17 +59,20 @@
 | tool 消息展示 | `packages/client/src/components/hermes/chat/MessageItem.vue` | `message.role === 'tool'`、`formatToolPayload`、`tool-preview`、`tool-details`、`tool-error-badge` | 对齐 tool 结果默认折叠、摘要、错误 badge、详情展开 | 不把 tool result 当正文写入，不扩大为审计详情管理台 |
 | session 列表项 | `packages/client/src/components/hermes/chat/SessionListItem.vue` | `session-item-title`、`session.title`、`session-item-model` | 对齐 session 标题、模型和时间的展示语义 | 不把 Hermes session title 同步为 mnote page title |
 | model 选择展示 | `packages/client/src/components/layout/ModelSelector.vue` | `selectedDisplayName`、`handleSelect`、`model-name`、`model-item` | 对齐模型显示名称、选择行为和禁用态 | 不在 mnote 保存 model/provider/API key 真相 |
+| agent/profile 选择 | `packages/client/src/components/layout/ProfileSelector.vue`、`packages/client/src/api/hermes/profiles.ts`、`packages/client/src/stores/hermes/profiles.ts` | `fetchProfiles`、`switchProfile`、`activeProfileName`、`handleChange` | 对齐 Hermes profile 作为 agent 的选择语义；mnote 面板选择的是 profile，不是自建 agent 表 | 不要求页面刷新；不直接复制 Hermes sidebar profile selector |
+| profile 管理边界 | `packages/client/src/views/hermes/ProfilesView.vue`、`packages/client/src/components/hermes/profiles/ProfileCard.vue`、`ProfileCreateModal.vue`、`ProfileRenameModal.vue`、`packages/server/src/routes/hermes/profiles.ts` | `/api/hermes/profiles`、`/api/hermes/profiles/active`、`rename`、`create`、`delete` | 只参考 profile list/detail/rename 的字段和错误边界 | 第一阶段不做 import/export/delete；不把 mnote 做成完整 ProfilesView |
+| agent 人格文件编辑 | `packages/client/src/views/hermes/MemoryView.vue`、`packages/client/src/api/hermes/skills.ts`、`packages/server/src/routes/hermes/memory.ts`、`packages/server/src/controllers/hermes/memory.ts` | `fetchMemory`、`saveMemory`、`memory/user/soul`、`SOUL.md`、`USER.md`、`MEMORY.md` | 对齐 Hermes 如何读取和保存人格/记忆文件；mnote 可提供当前 agent 的轻量编辑器 | 不在 mnote 直接读写 profile 目录；不绕过 Hermes API 写文件 |
 | run 生命周期与持久化 | `packages/server/src/services/hermes/chat-run-socket.ts` | `handleRun`、`emit`、`applyResponseStreamEvent`、`flushResponseRunToDb`、`markCompleted` | 对齐 queued/running/tool_calling/completed/failed 与 flush 到 Hermes DB 的时机 | 不在 mnote 里重写 Hermes 编排器 |
 | session 存储真相 | `packages/server/src/db/hermes/session-store.ts` | `HermesSessionRow`、`HermesMessageRow`、`getSessionDetail`、`addMessage`、`renameSession` | 明确 session/message/tool call 真相字段来自 Hermes | 不在 mnote 建第二份 chat/session 表 |
 | plugin/tool 发现 | `packages/server/src/services/hermes/plugins.ts` | `PluginManager`、`providesTools`、`listHermesPlugins`、`requiresEnv` | 对齐 mnote tools 作为 Hermes plugin/tool registry 的一部分被发现 | 不把 mnote-web 私有 route 当成最终 plugin registry |
-| skill/plugin API 外观 | `packages/client/src/api/hermes/plugins.ts`、`packages/client/src/api/hermes/skills.ts` | `list`、`get`、`enable`、`disable` 类方法 | 仅用于面板显示 mnote plugin/tool 可用性和缺失状态 | 不实现完整 Hermes plugin/skill 管理页 |
+| skill/plugin API 外观 | `packages/client/src/api/hermes/plugins.ts`、`packages/client/src/api/hermes/skills.ts`、`packages/client/src/views/hermes/SkillsView.vue`、`packages/client/src/components/hermes/skills/SkillList.vue`、`SkillDetail.vue`、`packages/server/src/routes/hermes/skills.ts` | `fetchSkills`、`toggleSkill`、`pinSkillApi`、`fetchSkillContent`、`fetchSkillFiles`、`/api/hermes/skills/toggle` | 对齐 skill 搜索、分类、启停、详情和文件查看；页面 AI 需要能启停技能 | 不实现完整 marketplace、批量安装、复杂上传发布流程 |
 | 不进入 mnote 面板第一阶段 | `packages/client/src/views/hermes/SettingsView.vue`、`ProfilesView.vue`、`UsageView.vue`、`LogsView.vue`、`JobsView.vue`、`FilesView.vue`、`ChannelsView.vue`、`TerminalView.vue`、`GroupChatView.vue` | 页面级管理视图入口 | 用来明确边界：这些属于 Hermes 管理台 | 不搬进 mnote 页面 AI 抽屉 |

 快速定位命令：

 ```bash
 cd /mnt/Data1T/mnote/design/05-editor-mainline/reference-code/hermes-web-ui-0.5.18
-rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunViaSocket|mapHermesMessages|tool\\.started|tool\\.completed|activeSessionTitle|formatToolPayload|selectedDisplayName|handleRun|flushResponseRunToDb|PluginManager|providesTools" packages/client/src packages/server/src
+rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunViaSocket|mapHermesMessages|tool\\.started|tool\\.completed|activeSessionTitle|formatToolPayload|selectedDisplayName|fetchProfiles|switchProfile|fetchMemory|saveMemory|toggleSkill|SkillList|handleRun|flushResponseRunToDb|PluginManager|providesTools" packages/client/src packages/server/src
 ```

 ---
@@ -73,6 +82,9 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 ### 3.1 必须进入 mnote 页面 AI 面板

 - 当前 Hermes session 标题、session id、模型名、profile 名和恢复状态。
+- agent/profile 选择：用户能在页面 AI 面板里选择当前使用的 Hermes profile；profile 等同本设计中的 agent。
+- agent/profile 轻编辑：用户能查看和修改当前 agent 的 `SOUL.md`、`USER.md`、`MEMORY.md`，若 Hermes 后续暴露 `IDENTITY.md` 也按同一文件编辑模型接入。
+- skill 启停：用户能搜索 Hermes skills，查看简要说明，并启用/停用单个 skill。
 - 当前 run 状态：`idle`、`queued`、`running`、`tool_calling`、`completed`、`failed`、`aborted`。
 - 当前页面上下文范围：当前页、当前选区、当前块、全文、页面设置。
 - 当前 mnote tools 可用性：`mnote.page.get`、`mnote.page.save`、`mnote.page.update_title`、`mnote.page.update_options`、`mnote.artifact.create_summary`、`mnote.artifact.create_ai_note`。
@@ -83,8 +95,8 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 ### 3.2 不进入 mnote 页面 AI 面板

 - provider/API key 密钥管理。
- 全局 profile 创建、删除、复杂编辑。
- Hermes plugin marketplace / skill marketplace 管理。
+- 全局 profile 导入导出、删除、批量迁移、凭据清理等危险操作。
+- Hermes plugin marketplace / skill marketplace 的安装、发布、版本管理和批量上传。
 - usage 报表、日志中心、任务中心、文件中心、频道、终端、群聊。
 - Hermes session 数据库迁移、导入导出、conversation 管理台。
 - 独立 mnote 聊天历史存储。
@@ -93,7 +105,9 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi

 - 当前页面最近 sessions 搜索。
 - session 重命名与删除。
- profile/model 下拉切换。
+- profile rename / create。
+- model 下拉切换。
+- skill pin、skill 文件详情查看、单个本地 skill 上传。
 - tool event JSON 详情复制。
 - session deep link 到 Hermes 管理台。

@@ -101,12 +115,13 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi

 ## 4. 目标信息架构

-页面 AI 抽屉保持 Wolai 对齐后的壳层，内部按四层组织：
+页面 AI 抽屉保持 Wolai 对齐后的壳层，内部按五层组织：

-1. 顶部状态条：session 标题、模型/profile、连接状态、设置跳转。
+1. 顶部状态条：session 标题、agent/profile、模型、连接状态、设置跳转。
 2. 消息区：Hermes message list、streaming 回复、tool event 折叠项。
-3. 上下文与工具条：当前 context scope、可用 mnote tools、最近 audit/trace。
-4. 输入区：prompt 输入、发送、停止、重试、继续。
+3. Agent 设置区：profile 选择、SOUL/USER/MEMORY 轻编辑、skill 搜索与启停。
+4. 上下文与工具条：当前 context scope、可用 mnote tools、最近 audit/trace。
+5. 输入区：prompt 输入、发送、停止、重试、继续。

 验收时不要只看 DOM，应以截图和交互为准：

@@ -114,6 +129,7 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 - tool event 折叠项不会撑破抽屉宽度。
 - 失败态能看到可执行动作，不只是一段错误文本。
 - 设置入口不会暗示 mnote 自己持有 API key。
+- agent/profile 选择和 skill 启停必须明确显示“由 Hermes 保存 / 全局生效或当前 profile 生效”的作用域，避免用户误以为只是当前页面临时开关。

 ---

@@ -125,6 +141,10 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 - `GET /api/hermes/client/sessions?documentId=...&limit=...`
 - `GET /api/hermes/client/session/:sessionId`
 - `GET /api/hermes/client/models`
+- `GET /api/hermes/client/profiles`
+- `GET /api/hermes/client/profiles/:profileName`
+- `GET /api/hermes/client/profile-memory?profile=...`
+- `GET /api/hermes/client/skills?profile=...&query=...`
 - `GET /api/hermes/client/tools?scope=mnote`
 - `GET /api/hermes/client/runtime/status`

@@ -138,10 +158,59 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 - `POST /api/hermes/client/session/:sessionId/resume`
 - `POST /api/hermes/client/session/:sessionId/rename`
 - `DELETE /api/hermes/client/session/:sessionId`
+- `PUT /api/hermes/client/profiles/active`
+- `POST /api/hermes/client/profile-memory`
+- `PUT /api/hermes/client/skills/toggle`

-第一阶段可以只完成 `run/stop/resume`，`retry/rename/delete` 可以排到 P2，但 UI 文案不能让用户误以为已经支持。
+第一阶段必须完成 `run/stop/resume`、profile 选择、skill 单项启停、`SOUL.md` / `USER.md` / `MEMORY.md` 轻编辑。`retry/rename/delete`、profile create/rename、skill 上传可以排到 P2，但 UI 文案不能让用户误以为已经支持。

-### 5.3 mnote tool manifest
+### 5.3 Agent / profile 选择语义
+
+在本稿中，“agent” 等同 Hermes profile。页面 AI 不创建 mnote 私有 agent 表。
+
+选择 profile 时必须处理 session 归属：
+
+- 若当前没有 Hermes session，选择 profile 后创建新 session，session 的 `profile` 字段由 Hermes 持有。
+- 若当前 session 已绑定 profile，用户切换 profile 时默认创建一个新的当前页 session；不要原地篡改旧 session 的 profile。
+- 页面可以记住“当前页面最后使用的 session id / profile name”作为 UI 恢复线索，但聊天真相仍以 Hermes session detail 为准。
+- profile 切换不自动改页面正文，不自动触发写入工具。
+
+### 5.4 Agent 人格文件编辑语义
+
+页面 AI 面板允许轻编辑当前 profile 的人格文件：
+
+- `SOUL.md`：核心人格、价值观、行为边界。
+- `USER.md`：用户偏好与长期上下文。
+- `MEMORY.md`：Hermes memory 笔记。
+- `IDENTITY.md`：若 Hermes API 暴露，则作为同类 profile file 接入；未暴露时 UI 不显示假入口。
+
+保存规则：
+
+- 通过 Hermes API 保存，不由 mnote 直接读写 `.hermes` 文件。
+- 保存前显示本次修改作用域：当前 Hermes profile。
+- 保存后只影响后续 run；已完成的 Hermes session/message 不回写。
+- 保存失败必须显示 Hermes 返回的原因，不能静默保留本地草稿并显示成功。
+
+### 5.5 Skill 启停语义
+
+页面 AI 面板允许搜索、查看和启停 skill。
+
+第一阶段只要求：
+
+- 列表来自 Hermes `/api/hermes/skills` 或 mnote-web 同源 proxy。
+- 单个 skill 的 `enabled` 状态由 Hermes 持有。
+- toggle 调用 Hermes `/api/hermes/skills/toggle` 语义。
+- UI 明确展示 skill 来源：builtin / hub / local / modified。
+- 禁用 skill 影响后续 run；正在运行的 run 不强制中断，除非 Hermes upstream 本身返回中断。
+
+不在第一阶段做：
+
+- marketplace 安装/发布。
+- 批量启停。
+- 删除 builtin skill。
+- 上传并发布完整 skill 包。单个本地 skill 上传可排 P2，且仍走 Hermes。
+
+### 5.6 mnote tool manifest

 页面 AI 面板展示 tool 可用性时应优先从 Hermes plugin/tool registry 来，而不是硬编码前端列表。允许 mnote-web 在过渡期提供同源聚合：

@@ -170,7 +239,7 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 ### B. 面板状态模型

 - [ ] B1. 定义 Leptos 侧 `HermesPanelState`。
-  - 验收标准：状态至少包含 `sessionId`、`sessionTitle`、`modelName`、`profileName`、`runStatus`、`connectionStatus`、`contextScope`、`toolAvailability`、`lastAudit`。
+  - 验收标准：状态至少包含 `sessionId`、`sessionTitle`、`agentProfileName`、`profileFilesState`、`skillListState`、`modelName`、`runStatus`、`connectionStatus`、`contextScope`、`toolAvailability`、`lastAudit`。
 - [ ] B2. 明确哪些字段来自 Hermes，哪些字段来自 mnote。
  - 验收标准：session/message/model/profile/run/tool event 来自 Hermes；page title/context/audit 来自 mnote；没有字段把 Hermes session title 当作页面标题。
 - [ ] B3. 增加空态、连接失败态、tool 不可用态。
@@ -180,10 +249,23 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi

 - [ ] C1. 展示当前 session 标题和恢复状态。
  - 验收标准：刷新页面后能从 Hermes session detail 恢复标题和消息，不从 mnote 本地 state 恢复聊天真相。
- [ ] C2. 展示 model/profile 摘要。
-  - 验收标准：能看到当前模型与 profile；缺失时显示“去 Hermes 配置”的动作，而不是在 mnote 内要求填写 API key。
+- [ ] C2. 展示 model/agent profile 摘要。
+  - 验收标准：能看到当前模型与 agent profile；缺失时显示“选择 agent / 去 Hermes 配置”的动作，而不是在 mnote 内要求填写 API key。
 - [ ] C3. 增加设置跳转入口。
  - 验收标准：入口跳到 Hermes 设置或 profile 页面；mnote 页面内不出现 provider/API key 编辑表单。
+- [ ] C4. 支持 agent/profile 选择。
+  - 验收标准：profile 列表来自 Hermes；选择新 profile 后新建或切换到该 profile 的 Hermes session，不原地篡改旧 session profile。
+
+### C5. Agent 人格轻编辑
+
+- [ ] C5.1 展示当前 agent 的人格文件入口。
+  - 验收标准：至少展示 `SOUL.md`、`USER.md`、`MEMORY.md`；`IDENTITY.md` 只在 Hermes API 暴露时展示。
+- [ ] C5.2 支持编辑并保存 `SOUL.md`。
+  - 验收标准：保存调用 Hermes API；保存失败不显示成功；保存后新 run 使用更新后人格。
+- [ ] C5.3 支持编辑并保存 `USER.md` / `MEMORY.md`。
+  - 验收标准：保存作用域显示为当前 Hermes profile；mnote 不直接写 `.hermes` 文件。
+- [ ] C5.4 防止运行中误改。
+  - 验收标准：run 正在进行时编辑器可以查看，但保存按钮禁用或明确提示“保存只影响后续 run”。

 ### D. Run 控制与恢复

@@ -216,6 +298,17 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi
 - [ ] F4. 最近 tool call 关联 audit。
  - 验收标准：能从 UI 或测试输出看到 `sessionId/runId/toolCallId/traceId/auditId` 的串联。

+### F5. Skill 管理最小面
+
+- [ ] F5.1 展示 Hermes skills 列表和搜索。
+  - 验收标准：列表来自 Hermes skills API；能按名称/描述过滤；显示 builtin / hub / local / modified 来源。
+- [ ] F5.2 支持单个 skill 启停。
+  - 验收标准：开关调用 Hermes `toggleSkill` 语义；刷新后状态仍由 Hermes 返回；失败时回滚 UI 开关。
+- [ ] F5.3 支持查看 skill 详情。
+  - 验收标准：能查看 `SKILL.md` 摘要或详情；长内容不撑破抽屉；详情来源于 Hermes API。
+- [ ] F5.4 明确 skill toggle 作用域。
+  - 验收标准：UI 说明启停影响当前 Hermes profile 或 Hermes 全局配置；不把它描述成仅当前 mnote 页面临时开关。
+
 ### G. Session 列表最小面

 - [ ] G1. 支持当前页面最近 Hermes sessions 列表。
@@ -238,13 +331,19 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi

 - [ ] I1. 新增或扩展 browser smoke：session 状态条。
  - 验收标准：断言 session title/model/run status 可见。
- [ ] I2. 新增或扩展 browser smoke：run stop/retry。
+- [ ] I2. 新增或扩展 browser smoke：agent/profile 选择。
+  - 验收标准：断言 profile 列表来自 Hermes；切换 profile 后新 run/session 使用目标 profile。
+- [ ] I3. 新增或扩展 browser smoke：agent 人格文件编辑。
+  - 验收标准：保存 `SOUL.md` 或 `USER.md` 后通过 Hermes API 读回一致；运行中保存行为符合禁用或提示规则。
+- [ ] I4. 新增或扩展 browser smoke：skill 启停。
+  - 验收标准：toggle 后刷新仍保持 Hermes 返回状态；失败时 UI 回滚。
+- [ ] I5. 新增或扩展 browser smoke：run stop/retry。
  - 验收标准：至少覆盖 stop；retry 若未实现则断言按钮不存在或禁用。
- [ ] I3. 新增或扩展 browser smoke：context scope。
+- [ ] I6. 新增或扩展 browser smoke：context scope。
  - 验收标准：选区/当前页上下文能进入 run payload 或 tool audit。
- [ ] I4. 新增或扩展 browser smoke：tool 可用性与 audit。
+- [ ] I7. 新增或扩展 browser smoke：tool 可用性与 audit。
  - 验收标准：能看到 mnote tool 列表、一次 tool call、对应 audit id。
- [ ] I5. 移动端 smoke。
+- [ ] I8. 移动端 smoke。
  - 验收标准：状态条、tool 折叠、输入区在窄屏不重叠。

 ---
@@ -253,13 +352,16 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi

 本稿移入 `done/` 前必须同时满足：

- [ ] 页面 AI 抽屉具备 Mini Hermes 状态条，用户能看见当前 session、model/profile、run 状态。
+- [ ] 页面 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，不创建第二套 plugin registry。
+- [ ] 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，且证据写回本文。
@@ -270,8 +372,9 @@ rg -n "StartRunRequest|RunEvent|registerSessionHandlers|resumeSession|startRunVi

 优先顺序：

-1. 先补顶部 Mini Hermes 状态条和错误态，因为这是当前“能回复但缺 Hermes 设置感”的直接缺口。
-2. 再补 context scope 和 tool 可用性，让用户明确 Hermes 正在调用 mnote 的哪些能力。
-3. 最后补 session 列表、rename/delete/search 等历史管理能力。
+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 能力。

-不要先做 Hermes 全局设置页复刻。API key、provider、全局 profile、usage/logs/jobs/files/channels 仍应留在 Hermes 自己的管理台。
+不要先做 Hermes 全局设置页复刻。API key、provider、usage/logs/jobs/files/channels、profile 导入导出、skill marketplace 发布仍应留在 Hermes 自己的管理台。