日期:2026-11-14 状态:已实施(M0–M5),已合并主线
目标:夭夭不再依赖外部 Hermes Dashboard(9119 HTTP/WebSocket),改为与 yaovi-agent 相同的方式,把 Hermes 源码内置在仓库中,由夭夭服务端直接拉起和管理内核进程。
已确认:
~/.hermes 的会话、profiles、auth.json、config.yaml)在首次启动时只读导入,不改动原目录。用户对第 10 节的答复(2026-11-14):
0.23.0+yaovi)。| # | 依赖面 | 现在的实现 | 主要代码 |
|---|---|---|---|
| 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 生命周期代码。
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。<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。
| 依赖面 | 替代 | 从 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;桌面完整版改为拉起内置内核 |
触发:~/.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 |
规则:
~/.yaoyao/hermes/.import.json,记录来源路径、时间、Hermes 版本和文件散列。重启不会重复导入;用户可以在设置里手动重新导入。现在:Bot 基于一个 Hermes Profile 创建,不复制也不修改基础 Profile;多个 Bot 可以共用同一个基础 Profile。
yaovi-agent:没有 Profile,每个 Bot 有独立 runtime home,以系统 home 为父级。
建议:
~/.yaoyao/bots/<id>/runtime)。创建 Bot 时选的“基础 Profile”改为“从模板初始化”:复制该 Profile 的 config.yaml 覆盖项、skills 和 SOUL 到 Bot home,之后各自独立。/api/profiles 兼容接口返回“系统 + 已导入模板”,旧客户端不报错。每个阶段单独提交,都要通过 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 涉及客户端协议,风险最高,单独确认后再做。
postinstall 用 uv 下载 Python 3.11 和锁定依赖,需要联网。被 --ignore-scripts 跳过时,可以运行 yaoyao setup,首次启动也会补做。Dockerfile),去掉 HERMES_YAOYAO_UPSTREAM 和 Hermes 目录挂载;保留一次性导入用的可选只读挂载。build-agent-host.mjs);客户端版不变。HERMES_YAOYAO_UPSTREAM*、HERMES_YAOYAO_BRIDGE_*、HERMES_YAOYAO_SUPERVISE_DASHBOARD、HERMES_YAOYAO_CHAT_CACHE_MODE;仍设置时启动日志给出警告,不报错。yaovi-agent 在内置 Hermes 的同时还做了很多产品层改动,本方案不引入:
@lsamien/yaoyao、15300、~/.yaoyao)。从 yaovi-agent 复制的 Node 代码会去掉对上述功能的引用。
/api/ws gateway 协议做原生对话,M3 之后需要兼容层或客户端发新版。要先确认移动端实际用到的接口。+yaovi)。直接复用最省事,但以后升级 Hermes 要两边同步。modelAdmission.ts)。0.23.0+yaovi(建议),还是从官方 0.23.0 重新内置、只带夭夭需要的修改?| 组件 | 位置 | 作用 |
|---|---|---|
| 内置 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 |
模型服务配置(2026-11-16 用户确认):所有账号共用同一套系统 Hermes 模型服务配置和凭据,不按账号区分;会话、Bot 和原生对话仍按账号隔离,每个 Bot 使用独立 runtime home。
Profile(第 5 节):没有采用“从模板复制”。具名 Profile 保留 Hermes 原生布局(<data>/hermes/profiles/<名称>);每个 Bot 有独立 runtime home(会话、上下文、自有技能),配置、.env 和凭据通过父级读取实时继承所选 Profile。效果上同样是“Bot 独立 home、不修改基础 Profile”,修改 Profile 的模型或凭据后 Bot 下一轮即生效。
原生对话协议(M3):内置网关实现了与原 Hermes 网关相同的 JSON-RPC 方法和事件,Web 客户端没有改动。移动端使用同一 HTTP+SSE 接口,理论上无需改协议;按你的决定,仍要求客户端升级后使用,旧版未做验证。
/api/* 转发:保留了按白名单(status、profiles、sessions、model、files、attachments)转发的入口,供已配对设备读取会话和文件;现在由进程内 API 应答,不再访问 9119。通用 Dashboard 功能(Kanban、cron 页面等)已删除。
导入范围(第 4 节):导入整个 Hermes home(跳过 Hermes 程序、venv、日志、缓存、运行时下载和旧工具桥插件),而不是只导入已登记会话,这样历史记录视图能看到全部会话。
测试传输: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 个用例全部通过。node dist-server/server/index.js 启动后 /healthz、/readyz 返回 200,9119 无监听;首次启动导入成功。pip --require-hashes 在 Python 3.11 下接受 runtime/requirements.lock;镜像构建和容器内运行需在有 Docker 的机器上验证。runtime/ 打进 web-service/,内核虚拟环境放在用户数据目录、首次启动自动准备;未实际打包验证。客户端版不受影响。toolsOnly)不经过 Hermes;Runner 自身遗留的 Hermes 托管会话路径仍读取 hermesURL,服务端已不再使用该路径,未清理。session.branch(返回“暂不支持”)、session.events.since(断线重连时改为重置并从转录恢复)。memory 工具:yaovi-agent 版本已停用该工具,长期记忆走夭夭的工作区记忆工具;原生对话不再有 MEMORY.md/USER.md。only-0.1 分支)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。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 等仍被运行路径引用的文件。runtime/ 体积从 68.6 MB 降到 55.4 MB。判断依据:在所有内核与内置网关测试中记录每个 Python 进程实际加载的模块,再对候选文件逐个检索引用。agent/、tools/、plugins/、hermes_cli/ 内未被测试加载的文件可能在选择特定供应商或功能时才导入,因此没有按覆盖率删除。
YAOYAO_KERNEL_STANDBY=0 关闭。Hermes 模块会在导入时记录 HERMES_HOME,必须在安装运行上下文之后加载,所以不提前导入 Hermes 自身。npm run typecheck、npm run build 通过;npm run kernel:test 25 个用例通过;内置网关与 Bot 端到端测试通过。npm test:仍只有原有的 28 个环境相关失败(另有 1 个托管浏览器用例在全量并发时偶发失败,单独运行通过)。only-0.1 分支)用户确认:原来的普通模式(直接与 Hermes Profile 对话)不再保留,所有账号只使用 Bot 模式。
/、/chat/*、/history/*、/files、/artifacts 及未知路径都跳转到 /conversations。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 已停用。MessageTimeline.vue 等仅普通模式使用的组件;Profile 显示名编辑接口改为只读的 /api/profile-identities。/api/app/sessions*、/api/sessions/*、/api/realtime/*、/node/:deviceID/api/* 和兜底转发 /api/*;聊天缓存、转录存储、实时代理/回执、普通聊天推送、Hermes 原生 Bot 中继、远程 Bot 导出。所有客户端 WebSocket 升级请求一律拒绝。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),无新增失败。/conversations,页面无控制台错误,也没有 4xx 请求。--list 解析的修改,未实际运行。