embedded-hermes-migration.md 27 KB

内置 Hermes 迁移方案

日期:2026-11-14 状态:已实施(M0–M5),已合并主线

目标:夭夭不再依赖外部 Hermes Dashboard(9119 HTTP/WebSocket),改为与 yaovi-agent 相同的方式,把 Hermes 源码内置在仓库中,由夭夭服务端直接拉起和管理内核进程。

已确认:

  • 先出方案,确认后再动手。
  • 已有外部 Hermes 安装的数据(~/.hermes 的会话、profiles、auth.json、config.yaml)在首次启动时只读导入,不改动原目录。

用户对第 10 节的答复(2026-11-14):

  1. 原生对话:按建议保留,改为内置内核。
  2. 移动端:现在直接使用 Hermes gateway 协议;改协议后要求客户端升级,不做兼容层。
  3. Profile:同意“模板初始化、Bot 独立 home”。
  4. Kanban、cron 等 Dashboard 自带功能:删除。
  5. Hermes 副本:使用现在的 0.23.0(yaovi-agent 的 0.23.0+yaovi)。
  6. 远程节点:同意改为夭夭到夭夭。
  7. 范围:一次做到 M5,在独立分支上开发。

1. 现状:夭夭对外部 Hermes 的依赖面

# 依赖面 现在的实现 主要代码
D1 服务连接与鉴权 服务端用服务账号或回环本机令牌登录 9119,持有 Cookie 和 WS ticket;管理员可在设置里改上游凭据 upstream.ts、localAuth.ts(upstreamCredentials、webSocketCredential)、loopbackAuthorization.ts、config.ts(HERMES_YAOYAO_UPSTREAM*)
D2 Bot 执行 每轮通过 Dashboard 的 gateway WS JSON-RPC:session.create/resume、prompt.submit、approval.respond、clarify.respond、session.interrupt、image.attach_bytes、file.attach workspaceRuntime.ts、workspaceGateway.ts、sessionStop.ts
D3 Bot 工具 Hermes 插件 yaoyao-bot-bridge 安装进 Profile,提供 yaoyao_tools/yaoyao_call,再回调夭夭的电脑、浏览器、手机、团队与应用工具 integrations/hermes-bots-bridge/、hermesBridge.ts、hermesBotRelay.ts、workspaceToolLease.ts、compose.hermes-bridge.yaml
D4 原生(普通)对话 浏览器经夭夭转发直连 Hermes /api/ws,客户端自己说 gateway 协议;历史读 /api/sessions*;归属登记在 chat-cache.sqlite3 realtimeApi.ts、realtimeBroker.ts、chatCache.ts、client/api/realtime.ts、client/stores/chat.ts
D5 Profile、模型与配置 /api/profiles、/api/config、/api/env、/api/model/options、/api/model/set、/api/providers/custom-endpoints、/api/auth/providers routes.ts(模型服务、Profile 模型)、botModelSettings.ts、executionSettings.ts
D6 文件 /api/files、/api/files/download、/api/fs/default-cwd;直接映射 ~/.hermes/{cache,workspace,profiles,attachments,images} 路径 fileAccess.ts、routes.ts 静态文件路由
D7 其他 Dashboard 功能 Kanban 插件(/api/plugins/kanban)、记忆抽取(/api/plugins/yaoyao-bot-bridge/memory-extract)、/api/session-unread,以及兜底转发 all('/api/*gatewayPath') routes.ts、workspaceKnowledge*.ts、chatCache.ts
D8 远程节点 已配对节点经 /node/:deviceID/api/* 转发到另一台 9119;远程 Bot 走 /api/workspace-agents/:id/gateway routes.ts、workspaceGateway.ts、pairing.ts
D9 运维 Dashboard 守护与重启(launchctl/进程)、桥接插件版本检查与安装、Docker 挂载 Hermes 目录 dashboardSupervisor.ts、dashboardCommand.ts、hermesRuntimeEnvironment.ts、Docker/compose 文件

规模:服务端约 45 处 upstream.request,集中在 routes.ts(36 处)、chatCache.ts、realtimeApi.ts、fileAccess.ts;另有 gateway RPC 链路和桌面端的 Dashboard 生命周期代码。

2. 目标架构(对齐 yaovi-agent)

yaovi-agent 的做法:

  • runtime/hermes/:内置 Hermes 源码,当前为 0.23.0+yaovi(commit 2bd378e),约 79MB;去掉了 TUI gateway,Dashboard 路由只作为函数库使用。
  • runtime/worker.py:每个运行中的会话一个进程,NDJSON over stdio。Node 下发模型路由、指令、工具清单和输入;Python 用 Hermes 的 AIAgent 推理,工具调用通过 tool.request 回到 Node 执行。支持插话(steer)、中断、上下文压缩和用量回报。Node 侧入口是 src/server/yaoviKernel.ts,由 src/server/harness/agentRuntime.ts 编排。
  • runtime/hermes_service.py:每个 Hermes home 一个常驻进程,按需启动、空闲退出。复用 Hermes Dashboard 的函数完成供应商目录、OAuth、.env、模型选择、凭据池、媒体生成和辅助模型调用;存储仍是 Hermes 原生的 config.yaml、.env、auth.json。Node 侧入口是 src/server/hermes/service.ts(HermesServicePool)和 src/server/hermes/routes.ts。
  • 目录结构:系统 home 为 <data>/hermes,每个 Bot 的 home 为 <data>/bots/<botId>/runtime,以系统 home 作为父级读取凭据(YAOVI_HERMES_ROOT)。
  • 安装:bin/lib/agent-setup.mjs 用 uv 准备 Python 3.11 和锁定依赖(runtime/requirements.lock),对应 npm run agent:setup、npm postinstall 和 yaovi setup;打包时把 Python 一并放进主机包。

夭夭迁移后的形态:

浏览器 / iOS / Android / 桌面客户端
        │  /api/app/*(契约不变)
        ▼
夭夭服务端(Node)
  ├─ Bot 执行:harness/agentRuntime → yaoyaoKernel → runtime/worker.py(每会话一个进程)
  ├─ 工具:服务端直接执行(替代 yaoyao-bot-bridge 插件回调)
  ├─ 配置/OAuth/模型:hermes/service → runtime/hermes_service.py(每个 home 一个进程)
  ├─ 原生对话:同一内核 + 本地会话存储(替代 /api/ws 直连)
  └─ 数据:~/.yaoyao/hermes(系统)、~/.yaoyao/bots/<id>/runtime(Bot)

运行时不再需要 9119,也不再需要 HERMES_YAOYAO_UPSTREAM。

3. 各依赖面的替代方案

依赖面 替代 从 yaovi-agent 引入 夭夭侧改动
D1 连接与鉴权 删除。内核是子进程,没有上游账号;夭夭自己的 Web 账号继续作为唯一登录 — 删除 upstreamCredentials、webSocketCredential、上游凭据设置页和 /api/app/admin/upstream-*;/auth/password-login、/api/auth/me 等兼容路由改为夭夭本地实现或返回固定结果
D2 Bot 执行 agentRuntime + yaoyaoKernel 替换 WorkspaceGateway yaoviKernel.ts、harness/*、runtime/worker.py、native_authorization.py、tool_discovery.py、dialogue_usage.py 改写 workspaceRuntime.ts 的执行段;保留审批/澄清、停止、插话、附件和用量的现有数据结构和事件
D3 Bot 工具 工具清单在每轮请求中下发,tool.request 回到 Node 执行,不再安装插件 dialogueToolCatalog.ts、workspaceToolLease 的执行方式 把 bridge 插件转发的工具目录直接接到内核;删除 integrations/hermes-bots-bridge、hermesBridge.ts、桥接安装/重启接口和 compose.hermes-bridge.yaml
D4 原生对话 改为内核会话:服务端用同一个 worker 运行,转录存进夭夭的会话存储,通过夭夭自己的事件流推给客户端 会话存储和事件流的做法(yaovi-agent 已删除原生对话,这部分要新写) 新增本地实现的 /api/app/sessions* 和实时事件;client/api/realtime.ts、stores/chat.ts 从 gateway 协议改为夭夭事件协议;chatCache 的 upstream-only/shadow 模式删除,只保留本地
D5 Profile/模型/配置 hermes_service.py 的 config.*、env.*、model.*、endpoints.*、oauth.*、pool.* hermes/service.ts、hermes/config.ts、hermes/routes.ts、hermes/network.ts、runtime/hermes_service.py、hermes_external_auth.py、model_network.py 模型服务、Profile 模型和 Bot 模型设置改调服务池;Profile 概念映射见第 5 节
D6 文件 文件就在本机数据目录,直接读写,不经 HTTP sessionWorkingDirectory.ts、workspaceFiles.ts 的做法 fileAccess.ts 改为本地路径;/Users/:owner/.hermes/* 路由改为指向 ~/.yaoyao/hermes 下对应目录,旧链接保持可用
D7 其他 记忆抽取改为 hermes_service 的 aux.complete;未读改为本地;Kanban 和兜底 /api/* 转发见第 8 节待确认 runtime/native_*、memoryHarness.ts 的抽取方式 删除 all('/api/*gatewayPath')
D8 远程节点 远程节点本身也是内置内核的夭夭实例,节点之间走夭夭协议,不再转发 9119 — /node/:deviceID/api/* 的白名单路由改为对端夭夭的 /api/app/*
D9 运维 删除 Dashboard 守护;新增内核安装检查(yaoyao setup / yaoyao doctor) bin/lib/agent-setup.mjs、scripts/agent-setup.mjs、scripts/verify-hermes-runtime.py、runtime/requirements.* 删除 dashboardSupervisor.ts、dashboardCommand.ts;桌面完整版改为拉起内置内核

4. 旧数据导入(首次启动,只读)

触发:~/.yaoyao/hermes 不存在或为空,并且检测到旧 Hermes 目录(默认 ~/.hermes,可用 YAOYAO_IMPORT_HERMES_HOME 指定;Docker 用户用原来的 HERMES_YAOYAO_HERMES_DIR 挂载)。

内容 处理
config.yaml、.env、auth.json、凭据池 复制到系统 home ~/.yaoyao/hermes,权限 0600
profiles/<name>/ 按第 5 节映射复制到对应 Bot 的 runtime home;没有 Bot 使用的 Profile 只导入到 ~/.yaoyao/hermes/imported-profiles/ 备查
会话数据库(state.db 等) 仅导入夭夭已登记归属的会话(chat-cache.sqlite3 中的 Profile + Session ID)以及 Bot 绑定的会话;其余保留在原目录,不复制
附件、图片、缓存 只复制被导入会话引用的文件
skills、memories 按 Profile 复制到对应 Bot home

规则:

  • 源目录只读,不改名、不删除。导入前检查源 Hermes 是否还在运行;在运行就提示先停掉,避免读到写了一半的 SQLite(也可以用 SQLite 在线备份 API 读快照)。
  • 导入写入 ~/.yaoyao/hermes/.import.json,记录来源路径、时间、Hermes 版本和文件散列。重启不会重复导入;用户可以在设置里手动重新导入。
  • 源 Hermes 版本低于内置版本时,用内置 Hermes 的迁移代码升级副本的 schema。
  • 失败时整个导入回滚,内核从空数据启动,并在系统设置里提示原因。

5. Profile 与 Bot 的映射

现在:Bot 基于一个 Hermes Profile 创建,不复制也不修改基础 Profile;多个 Bot 可以共用同一个基础 Profile。

yaovi-agent:没有 Profile,每个 Bot 有独立 runtime home,以系统 home 为父级。

建议:

  • 系统 home 相当于原来的默认 Profile。
  • 每个 Bot 有独立 runtime home(~/.yaoyao/bots/<id>/runtime)。创建 Bot 时选的“基础 Profile”改为“从模板初始化”:复制该 Profile 的 config.yaml 覆盖项、skills 和 SOUL 到 Bot home,之后各自独立。
  • 现有 Bot 在导入时从各自原 Profile 初始化。
  • /api/profiles 兼容接口返回“系统 + 已导入模板”,旧客户端不报错。

6. 分阶段实施

每个阶段单独提交,都要通过 npm run typecheck、npm test、npm run build,以及新增的 Python 运行时测试。

阶段 内容 验收
M0 引入内核 复制 runtime/(Hermes 源码、worker、service、requirements)、agent-setup 脚本和 yaoyao setup/doctor;补齐许可证与 THIRD_PARTY_NOTICES 干净环境下 npm run agent:setup 成功;hermes_service 能 ping;worker.py 用受控模型跑通一轮
M1 配置与模型 接入 HermesServicePool;模型服务、OAuth、.env、Profile 模型改为本地;实现第 4 节的导入 不启动 9119 时,设置页能读写供应商和模型;导入矩阵测试(空目录、已有数据、源在运行、失败回滚、重复启动)全部通过
M2 Bot 执行 agentRuntime + 内核替换 gateway;工具直连;审批、澄清、停止、插话、附件、用量对齐现有事件 现有 Bot 单聊和群聊的 vitest/Playwright 回归通过;真实内核用受控模型跑通工具调用、审批拒绝、停止和插话
M3 原生对话 本地会话存储 + 夭夭事件流;Web 客户端改协议;保留已导入会话的历史 新建、续聊、搜索、删除、未读、附件下载均不经 9119;旧会话可读
M4 文件与其他 文件本地化;记忆抽取、未读、远程节点协议;删除兜底转发 grep 不到 upstream.request;远程节点用两台夭夭实例验证
M5 清理与打包 删除 upstream.ts、上游配置、桥接插件、Dashboard 守护和相关测试;更新 Dockerfile、compose、npm 打包、桌面完整版和文档 Docker 镜像不带 9119 即可启动;npm 全局安装后 yaoyao doctor 全绿;文档不再要求 9119

建议先做 M0 → M1 → M2,这三步完成后 Bot 功能已经不依赖外部 Hermes;M3 涉及客户端协议,风险最高,单独确认后再做。

7. 打包与部署变化

  • npm:包体积增加约 80MB(Hermes 源码);postinstall 用 uv 下载 Python 3.11 和锁定依赖,需要联网。被 --ignore-scripts 跳过时,可以运行 yaoyao setup,首次启动也会补做。
  • Docker:镜像内置 Python 和依赖(参考 yaovi-agent 的 Dockerfile),去掉 HERMES_YAOYAO_UPSTREAM 和 Hermes 目录挂载;保留一次性导入用的可选只读挂载。
  • macOS 完整版:App 内运行的服务端需要带上 Python 运行时(参考 yaovi-agent 的 build-agent-host.mjs);客户端版不变。
  • 环境变量:废弃 HERMES_YAOYAO_UPSTREAM*、HERMES_YAOYAO_BRIDGE_*、HERMES_YAOYAO_SUPERVISE_DASHBOARD、HERMES_YAOYAO_CHAT_CACHE_MODE;仍设置时启动日志给出警告,不报错。

8. 不随本次迁移带入的 yaovi-agent 改动

yaovi-agent 在内置 Hermes 的同时还做了很多产品层改动,本方案不引入:

  • 删除原生(普通)对话(夭夭保留,见 M3);
  • Bot 运行环境固定为 Host、VM 模型调整(spec 060/090/091);
  • Tailcat 连接、Yaovi 账号与远程访问、Jev Auto 选模;
  • 单用户模型(夭夭保持多用户 Web 账号和用户隔离);
  • 品牌、包名、端口和数据目录(夭夭保持 @lsamien/yaoyao、15300、~/.yaoyao)。

从 yaovi-agent 复制的 Node 代码会去掉对上述功能的引用。

9. 风险

  1. 多用户隔离:yaovi-agent 是单用户,内核进程不区分登录用户。夭夭需要把用户 ID 加进 Bot/会话的 home 路径和工具授权,否则不同用户的 Bot 可能共用凭据和记忆。
  2. 客户端协议:iOS、Android 如果直接使用 /api/ws gateway 协议做原生对话,M3 之后需要兼容层或客户端发新版。要先确认移动端实际用到的接口。
  3. Hermes 版本:yaovi-agent 的副本有 Yaovi 专有修改(+yaovi)。直接复用最省事,但以后升级 Hermes 要两边同步。
  4. 资源占用:每个运行中的会话一个 Python 进程(约 100–200MB),群聊并发多时内存会上升,需要沿用 yaovi-agent 的并发准入(modelAdmission.ts)。
  5. 工作量:M0–M2 预计改动数十个服务端文件,M3 还要改客户端;测试夹具(Playwright 的 hermes-bridge、execution-auth 等配置)需要重写为受控内核。

10. 需要你确认的问题

  1. 原生对话:保留并在 M3 改为内置内核(建议),还是像 yaovi-agent 一样删除?
  2. 移动端:iOS/Android 是否直接说 Hermes gateway 协议?如果是,M3 需要兼容层还是可以要求客户端升级?
  3. Profile:同意按第 5 节改为“模板初始化、Bot 独立 home”吗?
  4. Kanban 与其他 Dashboard 功能(cron、Dashboard 自带页面):删除,还是改用内置 Hermes 的函数重新实现?
  5. Hermes 副本:直接复用 yaovi-agent 的 0.23.0+yaovi(建议),还是从官方 0.23.0 重新内置、只带夭夭需要的修改?
  6. 远程节点:同意节点之间改为夭夭到夭夭(要求对端也升级)吗?
  7. 范围:先只做 M0–M2(Bot 不再依赖外部 Hermes),还是一次做到 M5?

11. 实施记录(2026-11-14)

实际架构

组件 位置 作用
内置 Hermes runtime/hermes、runtime/*.py 取自 yaovi-agent 的 0.23.0+yaovi,仅把对模型的产品身份改为夭夭
内核进程 src/server/hermes/kernel.ts → runtime/worker.py 每轮一个进程;工具调用回到 Node 执行
管理进程 src/server/hermes/service.ts → runtime/hermes_service.py 每个 Hermes home 一个常驻进程;新增 dashboard.call(直接调用 Hermes 原生 Dashboard 处理函数)、botmodels.*
进程内 API src/server/hermes/api.ts 原来发往 9119 的 REST 请求在进程内应答,返回结构与 Dashboard 相同
进程内网关 src/server/hermes/gateway.ts 实现原 TUI 网关的 JSON-RPC 方法与事件;Bot 执行(WorkspaceGateway)和原生对话(realtimeBroker,经 EmbeddedSocket)共用
导入 runtime/hermes_import.py、src/server/hermes/import.ts 首次启动只读导入
技能 src/server/hermes/skills.ts Profile 技能随轮次加载;Bot 自己的技能写入其 runtime home

与方案的差异

  1. 模型服务配置(2026-11-16 用户确认):所有账号共用同一套系统 Hermes 模型服务配置和凭据,不按账号区分;会话、Bot 和原生对话仍按账号隔离,每个 Bot 使用独立 runtime home。

  2. Profile(第 5 节):没有采用“从模板复制”。具名 Profile 保留 Hermes 原生布局(<data>/hermes/profiles/<名称>);每个 Bot 有独立 runtime home(会话、上下文、自有技能),配置、.env 和凭据通过父级读取实时继承所选 Profile。效果上同样是“Bot 独立 home、不修改基础 Profile”,修改 Profile 的模型或凭据后 Bot 下一轮即生效。

  3. 原生对话协议(M3):内置网关实现了与原 Hermes 网关相同的 JSON-RPC 方法和事件,Web 客户端没有改动。移动端使用同一 HTTP+SSE 接口,理论上无需改协议;按你的决定,仍要求客户端升级后使用,旧版未做验证。

  4. /api/* 转发:保留了按白名单(status、profiles、sessions、model、files、attachments)转发的入口,供已配对设备读取会话和文件;现在由进程内 API 应答,不再访问 9119。通用 Dashboard 功能(Kanban、cron 页面等)已删除。

  5. 导入范围(第 4 节):导入整个 Hermes home(跳过 Hermes 程序、venv、日志、缓存、运行时下载和旧工具桥插件),而不是只导入已登记会话,这样历史记录视图能看到全部会话。

  6. 测试传输:createApplication({ fetchImpl }) 仍作为测试用的假 Dashboard 传输保留在 UpstreamClient 中;生产环境始终走进程内 API。

验证

  • npm run typecheck、npm run build 通过。
  • npm test:2224 通过,28 失败;这 28 个在原提交 f433741 上同样失败(凭据保险箱、服务 CLI 版本、时间格式等与本环境相关的用例),没有新增失败。
  • npm run kernel:test:内核 11、模型服务 12、导入 2 个用例全部通过。
  • 新增真实内核 + 受控模型的测试:原生对话流式事件与续聊、授权工具调用、审批允许/拒绝、等待审批时中断、Profile 技能加载与新建、Bot 单聊与工具调用、扫码设备经 HTTP+SSE 对话、进程内 Dashboard API。
  • 桌面测试:93 通过、25 失败,与原提交完全相同(依赖 macOS/Electron 的用例)。
  • 生产构建冒烟:node dist-server/server/index.js 启动后 /healthz、/readyz 返回 200,9119 无监听;首次启动导入成功。

已知限制与未完成项

  • Docker 镜像未实际构建:本环境没有 Docker 守护进程。已确认 pip --require-hashes 在 Python 3.11 下接受 runtime/requirements.lock;镜像构建和容器内运行需在有 Docker 的机器上验证。
  • macOS 完整版桌面:已把 runtime/ 打进 web-service/,内核虚拟环境放在用户数据目录、首次启动自动准备;未实际打包验证。客户端版不受影响。
  • 执行节点(Runner):服务端发起的虚拟机工具会话(toolsOnly)不经过 Hermes;Runner 自身遗留的 Hermes 托管会话路径仍读取 hermesURL,服务端已不再使用该路径,未清理。
  • 未实现的网关方法:session.branch(返回“暂不支持”)、session.events.since(断线重连时改为重置并从转录恢复)。
  • 会话标题:使用首条消息截取,不再调用 Hermes 的标题生成。
  • Hermes 内置 memory 工具:yaovi-agent 版本已停用该工具,长期记忆走夭夭的工作区记忆工具;原生对话不再有 MEMORY.md/USER.md。

12. 精简与性能(2026-11-15,only-0.1 分支)

删除的代码

  • 内核适配:删除 yaoyao 不使用的 hermes_channels.py(消息渠道)、hermes_pairing.py、hermes_ecosystem.py(技能目录)、hermes_mcp.py(Hermes 侧 MCP 管理,夭夭自己管理 MCP)、native_openviking*.py(夭夭的 OpenViking 在 Node 侧),以及 hermes_service.py 中对应的操作;内核中原生记忆提供者分支一并删除。模型服务退出时不再为渠道配对加载 Telegram/Slack/Discord/钉钉 SDK。
  • Hermes 源码:删除 optional-skills/(14 MB)、plugin-catalog/(4.3 MB)和互相引用的独立脚本 batch_runner.py、trajectory_compressor.py、mini_swe_runner.py、toolset_distributions.py。保留 skills/、cli.py、uv.lock 等仍被运行路径引用的文件。
  • Python 依赖:去掉消息渠道 SDK(python-telegram-bot、lark-oapi、dingtalk-stream、alibabacloud-dingtalk、qrcode、slack-bolt、slack-sdk、discord.py)及其传递依赖,锁文件从 105 个包减到 79 个,安装更快、镜像更小。
  • 前端:删除没有任何入口引用的旧页面和组件(旧群组管理、成果库、节点配对、系统更新、远程 Bot 选择等对话框)、对应的 store/api 和只测试这些死代码的用例,以及无人引用的聚合导出文件。
  • 已跟踪的 runtime/ 体积从 68.6 MB 降到 55.4 MB。

判断依据:在所有内核与内置网关测试中记录每个 Python 进程实际加载的模块,再对候选文件逐个检索引用。agent/、tools/、plugins/、hermes_cli/ 内未被测试加载的文件可能在选择特定供应商或功能时才导入,因此没有按覆盖率删除。

性能优化

  • 预启动内核进程:会话打开或一轮结束后,为该会话的 Hermes home 预先启动一个 worker,提前完成 Python 启动和第三方库导入,下一次提交直接使用。最多保留 3 个,空闲 2 分钟退出;设置 YAOYAO_KERNEL_STANDBY=0 关闭。Hermes 模块会在导入时记录 HERMES_HOME,必须在安装运行上下文之后加载,所以不提前导入 Hermes 自身。
  • 配置合并缓存:内置模式下每轮约 80 次读取配置都在重新深拷贝合并,改为每个 worker 合并一次,只读调用直接复用(每轮约 0.6 s → 0.1 s)。
  • 实测(立即返回的假模型,排除模型耗时):每轮从约 2.5 s 降到约 2.0 s。

验证

  • npm run typecheck、npm run build 通过;npm run kernel:test 25 个用例通过;内置网关与 Bot 端到端测试通过。
  • npm test:仍只有原有的 28 个环境相关失败(另有 1 个托管浏览器用例在全量并发时偶发失败,单独运行通过)。
  • 桌面测试结果与原提交一致。

13. 只保留 Bot 模式(2026-11-16,only-0.1 分支)

用户确认:原来的普通模式(直接与 Hermes Profile 对话)不再保留,所有账号只使用 Bot 模式。

行为变化

  • 管理员与子账号使用同一套界面:「聊天」里的 Bot 单聊和群聊,以及工具菜单(电脑接管、自动化等)。设置中心默认打开「我的资料」,不再有模式切换。
  • 旧链接 /、/chat/*、/history/*、/files、/artifacts 及未知路径都跳转到 /conversations。
  • 未读只统计 Bot 会话;为兼容旧客户端,接口仍返回 chat 字段,固定为 0。
  • 升级时没有导入旧 ~/.hermes(例如 Docker 未叠加 compose.hermes-import.yaml、旧数据不在默认目录或导入失败)时,已有 Bot 对话绑定的 Hermes 会话在本机不存在:Bot 会自动新建会话,并把夭夭保存的近期聊天记录作为上下文补给新会话,不再每次报「会话不存在」。
  • /api/app/capabilities 的 features 新增 bot-only-v1。yaoyao-mobile 看到该标记后强制进入 Bot 模式、隐藏「聊天模式」切换、不再加载普通聊天运行时,并拒绝打开普通聊天与旧群组通知;未带该标记的旧服务端保持原有行为。
  • 账号扫码登录保留;设备配对(/api/app/pairings*、/api/app/paired-devices*、/api/pair/v1/*)删除。远程 Bot 已在此前停用,因此已有节点记录只能查看和删除,新的子节点配对会因对端没有配对接口而失败。
  • 不再写入 chat-cache.sqlite3 和 realtime-receipts.sqlite3;已有文件保留在数据目录中,可手动删除。HERMES_YAOYAO_CHAT_CACHE_MODE 已停用。

删除的代码

  • 前端:普通聊天、历史、文件库页面及其 store、实时协议客户端、会话工具函数,MessageTimeline.vue 等仅普通模式使用的组件;Profile 显示名编辑接口改为只读的 /api/profile-identities。
  • 服务端:/api/app/sessions*、/api/sessions/*、/api/realtime/*、/node/:deviceID/api/* 和兜底转发 /api/*;聊天缓存、转录存储、实时代理/回执、普通聊天推送、Hermes 原生 Bot 中继、远程 Bot 导出。所有客户端 WebSocket 升级请求一律拒绝。
  • 测试:只覆盖普通模式的单元测试、Playwright 用例(workspace.spec、ordinary-local、session-deletion、model-confirmation、hermesMedia)和依赖 yaoyao-mobile 普通聊天的 test:pair:mobile;混合用例改为只验证 Bot 时间线。文档 http-sse-realtime.md、ordinary-chat-incremental-sync.md、read-cache.md、hermes-bot-relay.md 删除。

验证

  • npm run typecheck、npm run build 通过。
  • npm test:仍是原有的 28 个环境相关失败(messageTime、credentialVault*、workspaceStopUi、serviceCli),无新增失败。
  • 内置内核多账号测试改为断言普通聊天接口对所有账号返回 403/404。
  • 用构建产物启动服务并在浏览器中创建管理员:旧链接全部跳转到 /conversations,页面无控制台错误,也没有 4xx 请求。
  • 剩余 Playwright 套件仍依赖旧的假 9119 夹具,本次只做了能被 --list 解析的修改,未实际运行。