lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b798f628ee5a9da86c009ea1626be9a37c8c75ef
mnote/design/old/07-ai/done/7-7-page-ai-mini-hermes-control-surface-v1.md
T
Agent Board b798f628ee chore: land tree view-state, vault, Pi module split, and repo hygiene 
Persist PageTree expand state via control-plane view-state and align
chevron/DOM with restored expansion; keep Sidex-style shallow page-tree
scan and drop the unused recursive scanner that only added cargo noise.

Add password vault workbench routes/runtime/skill/CLI, split page_ai_pi
into a module package, and retire Hermes/ACP/OpenHub recycle + root
harness evidence from the index while gitignoring recycle and local
diag dumps.

Archive superseded design/bugs docs under old/, point architecture at
ARCHITECTURE.md, and refresh smokes for Pi S1–S7, vault, and editor
regressions so the working tree can stay clean.
2026-07-21 05:13:05 +08:00

27 KiB
Raw Blame History

[recycle] 7-7 [done] 页面 AI Mini Hermes 控制面设计与执行 checklist v1

更新时间：2026-05-14

当前状态：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
  • /mnt/Data1T/mnote/design/01-05-current-priority-overview.md
  • /mnt/Data1T/mnote/design/03-rust-web/reference/3-rust-web-long-term-architecture-v1.md
  • /mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md
  • /mnt/Data1T/mnote/design/05-editor-mainline/done/5-6-page-aggregate-alignment-checklist-v1.md
  • /mnt/Data1T/mnote/design/05-editor-mainline/reference-code/hermes-web-ui-0.5.18
  • /mnt/Data1T/mnote/design/07-ai/done/7-3-page-ai-hermes-panel-and-mnote-plugin-v1.md
  • /mnt/Data1T/mnote/design/07-ai/done/7-4-page-ai-hermes-panel-execution-checklist-v1.md
  • /mnt/Data1T/mnote/design/07-ai/done/7-5-hermes-client-proxy-contract-v1.md
  • /mnt/Data1T/mnote/design/07-ai/done/7-6-mnote-hermes-plugin-tool-contract-v1.md

1. 方向判断

当前截图和实现状态说明：页面 AI 已经能回复，但它还更像“能发消息的 Hermes run 面板”，缺少用户自然期待的 Hermes 运行态控制与设置入口。

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

页面 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。
  • 页面 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：技能页，包含搜索、上传、自定义技能额度、单个技能启停和详情查看。

2. Hermes Web UI 参考索引

参考根目录固定为：

/mnt/Data1T/mnote/design/05-editor-mainline/reference-code/hermes-web-ui-0.5.18

只参考下表列出的具体位置。目标是复用 Hermes 的语义与行为边界，仍然用 Leptos 实现 mnote 页面内面板。

mnote 下一步任务 参考文件 搜索点 / 具体位置 参考目的 不采用内容
run 发起、恢复和事件语义 packages/client/src/api/hermes/chat.ts StartRunRequest、RunEvent、registerSessionHandlers、resumeSession、startRunViaSocket 对齐 run 创建、session room 恢复、事件类型和浏览器端分发语义 不直接复用 Vue/TS client，不让浏览器绕过 mnote-web proxy
前端消息归并 packages/client/src/stores/hermes/chat.ts mapHermesMessages、case 'tool.started'、case 'tool.completed'、refreshActiveSession、switchSession 对齐 message/tool event 在前端归并成消息列表的规则 不把归并结果保存到 mnote local/session storage 作为真相
面板分层 packages/client/src/components/hermes/chat/ChatPanel.vue activeSessionTitle、showSessions、handleNewChat、MessageList、ChatInput、SessionListItem 对齐 session list / message list / input 的最小层次 不复制 Hermes 全屏布局、Vue 组件结构或 Naive UI
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、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 抽屉

快速定位命令：

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|fetchProfiles|switchProfile|fetchMemory|saveMemory|toggleSkill|SkillList|handleRun|flushResponseRunToDb|PluginManager|providesTools" packages/client/src packages/server/src

3. 产品边界

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。
  • 最近 tool call 摘要、参数摘要、结果摘要、失败原因和 trace/audit id。
  • 停止、重试、继续、重新读取当前页上下文的最小操作。
  • 跳转 Hermes 设置的入口，说明缺失项应在 Hermes 中配置。

3.2 不进入 mnote 页面 AI 面板

  • provider/API key 密钥管理。
  • 全局 profile 导入导出、删除、批量迁移、凭据清理等危险操作。
  • Hermes plugin marketplace / skill marketplace 的安装、发布、版本管理和批量上传。
  • usage 报表、日志中心、任务中心、文件中心、频道、终端、群聊。
  • Hermes session 数据库迁移、导入导出、conversation 管理台。
  • 独立 mnote 聊天历史存储。

3.3 可选但不阻塞第一阶段

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

4. 目标信息架构

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

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

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

  • 顶部状态在窄屏不挤压输入区。
  • tool event 折叠项不会撑破抽屉宽度。
  • 失败态能看到可执行动作，不只是一段错误文本。
  • 设置入口不会暗示 mnote 自己持有 API key。
  • agent/profile 选择和 skill 启停必须明确显示“由 Hermes 保存 / 全局生效或当前 profile 生效”的作用域，避免用户误以为只是当前页面临时开关。

5. 数据与 API 边界

5.1 mnote-web proxy 需要补齐的读接口

  • GET /api/hermes/client/session/current?documentId=...
  • 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

这些接口只透传或规整 Hermes 状态，不在 mnote 保存真相。

5.2 mnote-web proxy 需要补齐的操作接口

  • POST /api/hermes/client/run
  • POST /api/hermes/client/run/:runId/stop
  • POST /api/hermes/client/run/:runId/retry
  • 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、profile 选择、skill 单项启停、SOUL.md / USER.md / MEMORY.md 轻编辑。retry/rename/delete、profile create/rename、skill 上传可以排到 P2，但 UI 文案不能让用户误以为已经支持。

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 在过渡期提供同源聚合：

  • tool name
  • description
  • read/write 分类
  • required scope
  • permission 状态
  • last call summary
  • last audit id
  • unavailable reason

6. 顺序执行 checklist

A. 设计与现状审计

  • A1. 打开当前 3000 页面 AI 抽屉，记录“能回复但缺设置/运行态控制”的截图到 tmp/。
    • 验收标准：截图能看到回复链路、顶部或设置区域缺失点、当前 session/run 状态展示缺口。
  • A2. 用 rg 确认活跃设计稿中页面 AI 主线已经指向 Hermes session/run/events。
    • 验收标准：design/07-ai/process 只剩本 7-7 作为 AI 活跃稿；7-2 到 7-6 位于 done/。
  • A3. 对照 Hermes Web UI 参考索引打开精确文件，不整目录通读。
    • 验收标准：实现任务说明中写明参考了哪个 packages/... 文件和哪个搜索点。

B. 面板状态模型

  • B1. 定义 Leptos 侧 HermesPanelState。
    • 验收标准：状态至少包含 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 不可用态。
    • 验收标准：Hermes 未启动、未配置模型、mnote plugin 缺失、权限不足分别有不同 UI 状态。

C. 顶部 Mini Hermes 状态条

  • C1. 展示当前 session 标题和恢复状态。
    • 验收标准：刷新页面后能从 Hermes session detail 恢复标题和消息，不从 mnote 本地 state 恢复聊天真相。
  • 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 控制与恢复

  • D1. 显示 run 状态。
    • 验收标准：发送后能依次看到 running/tool_calling/completed 或 failed；状态来自 Hermes run event。
  • D2. 支持停止当前 run。
    • 验收标准：点击停止后 Hermes run 进入 aborted/failed 的明确终止态，输入框恢复可用。
  • D3. 支持失败后重试或继续。
    • 验收标准：失败态有明确按钮；重试不会创建 mnote 本地聊天副本。
  • D4. 刷新后恢复进行中或已完成 session。
    • 验收标准：刷新页面不丢失 Hermes 消息；若 run 已结束，状态显示 completed/failed 而不是一直 loading。

E. Context Scope

  • E1. 增加 context scope 控件。
    • 验收标准：至少支持当前页、当前选区、当前块、页面设置四类；无选区时选区项禁用。
  • E2. run input 只携带当前 scope 的上下文摘要。
    • 验收标准：正文大对象不长期写进 Hermes session；Hermes 需要最新正文时通过 mnote.page.get 回读。
  • E3. tool call audit 记录 context scope。
    • 验收标准：mnote.page.save、artifact 写入等 audit 能看到本次来源是 page/selection/block/options 哪种 scope。

F. Tool 可用性与最近调用

  • F1. 展示 mnote tools 清单。
    • 验收标准：清单来源于 Hermes plugin/tool registry 或 mnote-web 过渡聚合，不能只写死在前端。
  • F2. 区分只读工具和写入工具。
    • 验收标准：mnote.page.get 明确为只读；mnote.page.save、mnote.page.update_title、mnote.artifact.* 明确为写入。
  • F3. tool event 默认折叠，支持展开详情。
    • 验收标准：交互参考 MessageItem.vue 的 tool-preview / tool-details，但使用 Leptos 实现；长 JSON 不撑破布局。
  • 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 列表。
    • 验收标准：列表来自 Hermes session API；只过滤/标注当前 document context，不复制 session 到 mnote。
  • G2. 支持切换 session。
    • 验收标准：切换后 message list 从 Hermes detail 恢复；页面正文不因切换 session 被自动修改。
  • G3. P2 支持 rename/delete/search。
    • 验收标准：若未实现，UI 不出现可点击假按钮；若实现，操作调用 Hermes session API。

H. 错误与权限

  • H1. Hermes 未启动或 proxy 502 时显示可诊断状态。
    • 验收标准：错误能区分 upstream unavailable、auth/permission、model missing、tool unavailable。
  • H2. 写入工具权限失败不泄露正文。
    • 验收标准：tool error 展示摘要、trace/audit id 和恢复动作，不展示不必要的正文 payload。
  • H3. 旧 /api/ai-agent/run 继续保持退场 guard。
    • ���收标准：新页面 AI 主链不会调用旧入口；retirement smoke 继续通过。

I. 自动化验收

  • I1. 新增或扩展 browser smoke：session 状态条。
    • 验收标准：断言 session title/model/run status 可见。
  • 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 若未实现则断言按钮不存在或禁用。
  • I6. 新增或扩展 browser smoke：context scope。
    • 验收标准：选区/当前页上下文能进入 run payload 或 tool audit。
  • I7. 新增或扩展 browser smoke：tool 可用性与 audit。
    • 验收标准：能看到 mnote tool 列表、一次 tool call、对应 audit id。
  • I8. 移动端 smoke。
    • 验收标准：状态条、tool 折叠、输入区在窄屏不重叠。

7. Done Gate

本稿移入 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，且证据写回本文。

8. P2 后续项

以下能力不阻塞本稿 done，后续另开设计或 checklist 推进：

  • 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 已重启为当前最新二进制。
Reference in New Issue View Git Blame Copy Permalink