hermes 桌面版来了，看完再升

大家好我是六六爸比，一个85后科技IT爱好者。

我以为 v0.16.0 这次又是个例行补丁。结果装上 Windows 桌面版、试了"远程连 WSL 后端"那一下，界面直接卡死报 403——这不是 bug，这是 Issue #38412 早就埋好的雷，release notes 里一个字符都没提。这篇文章就把这次的史诗级更新拆给你看，看完你再决定要不要升级。

2026 年 6 月 5 日，Hermes Agent 发了 v0.16.0，代号 "Surface Release"。这次和 v0.15.x 那种小修小补完全不是一个量级，我看完 release notes 真实感受是——Nous Research 这次是把整个项目的"皮肤"换了一层。

先看几个数字感受一下规模：

1. 落后一个版本（v0.15.2 到 v0.16.0）有 874 个 commit

2. 合并了 542 个 PR

3. 改动了 1962 个文件，新增 20.5 万行，删除 4.6 万行

4. 170 个贡献者参与

5. 关闭了 2 个 P0 bug + 62 个 P1 bug，外加 16 个安全相关修复

这体量说实话，已经赶得上 OpenClaw、Hermes、GenericAgent 之间互相追赶时那种跨大版本号才有的动静了。

三大变化必须知道

变化 1：原生桌面应用终于来了——Hermes 之前只有 CLI（命令行）和 TUI（终端 UI），要在 Windows 上用，你得开个 WSL 跑 hermes 命令行。v0.16.0 新增了 Electron 桌面应用，macOS / Linux / Windows 三端同时支持，一键安装、in-app 自更新、拖文件进聊天、Cmd+K 命令面板。release notes 原话是 "None of this existed a week ago"——一周前什么都没有。

强调一句（重要）：这是 Nous Research 官方出的桌面应用，不是第三方 fork，不是社区魔改版。GitHub 仓库是 NousResearch/hermes-agent（32k forks / 186k stars），Hermes Agent 创始人 Teknium（teknium1）亲手签的 v2026.6.5 tag，commit 3c231eb verified signature。从 GitHub releases 页面下载的 Windows exe（hermes-agent-desktop-windows.exe）就是官方版本，不要去第三方网站下，不要相信任何"汉化版/破解版/绿色版"——v0.16.0 是发布 24 小时内的全新桌面应用，市面上不会有"民间版"比官方版先出来。

变化 2：Web Dashboard 从"半成品"变"全功能管理面板"——之前 dashboard 只能看基本信息，要配飞书 / 钉钉 / 微信 channel 还得 SSH 改 config.yaml。现在 channels / MCP / 凭证 / webhook / 记忆配置全在浏览器里搞定，彻底告别 SSH + 编辑 yaml。

变化 3：模糊模型选择器 + /undo 命令——之前选模型要输入完整的 model id，现在输入 "v4fl" 就能找到 deepseek-v4-flash。新增的 /undo 命令能撤回最后 N 轮对话（CLI / TUI / 飞书 / 微信都生效），这是个我等了很久的功能。

我自己 WSL 里跑的是 v0.15.2（2026.5.29.2），用了一年多，踩过的坑得一个一个说。按我自己的体感，分成"真问题"和"我自己没搞懂"两类——前者是系统设计缺陷，后者是我自己偷懒没研究清楚。

真问题（系统缺陷，和会不会用无关）

1. 没有 GUI，CLI 装不下完整工作流

我 WSL 里的 hermes 跑了一年多，平时 90% 时间在 WSL 终端里敲命令。但偶尔想给老婆演示个功能、想让团队同事临时用一下、想在 Windows 桌面双击图标就能开聊——这些全做不到。CLI 是给开发者用的，GUI 是给日常用的，缺一不可。

2. 配个飞书 bot 要 SSH 改 yaml

v0.15.2 的飞书/钉钉/微信 channel 接入，必须 SSH 到 WSL 改 `~/.hermes/config.yaml`，配完还得 `hermes gateway restart`。我每次给一个新同事装 hermes，光飞书那 5 个字段（app_id / app_secret / chat_id / verify_token / 签名密钥）就要手敲 5 分钟，错一个就 restart 失败查半天。

3. /undo 不存在，撤回只能重写

我自己 WSL 跑 hermes 让它帮忙处理法考笔记相关问题时，偶尔会遇到模型抽风开始瞎编法条，没意识到"等下"就按了回车，等响应出来才发现要撤回——没办法，只能 `/reset` 整个会话重来，前面几轮的精炼分析全没了。/undo 没出来前，这是个常见痛点。

可能是我自己没搞懂（建议读者自查）

4. 模型选择器要输入完整 model id

我想换个 deepseek 模型，得输入 "deepseek-chat" 这种完整字符串，搜 "ds" 没反应。后来才知道可以先 `hermes model` 进交互式选择——这个可能是我自己没读文档，v0.15.2 实际是有的。

5. Web Dashboard 不能配 channel，只能看

v0.15.2 的 Dashboard（9119 端口那个）只能看 session 列表、看 log、看 token 用量。要配飞书 / 钉钉 channel 它做不到，必须回 SSH——这条是我自己没搞清 Dashboard 的边界，v0.15.2 实际就是只读的。

总结一下：1-3 是真问题（系统设计缺陷），4-5 混合问题（我自己的认知 + v0.15.2 的设计边界各占一半）。

上面那些问题，v0.16.0 一次打包解决。我挑三个我立刻用得上的说，其他的（精简默认 skill 集、简体中文翻译、NVIDIA/skills 作为可信 tap）我先把不踩坑的部分讲清楚，剩下的踩坑点下一节单独说。

/undo 命令（实锤来源：issue #21910 真实历史）

v0.16.0 新增的 /undo [N] 命令，能撤回最后 N 轮对话，CLI / TUI / 飞书 / 微信都生效，closes issue #21910。我查了下 issue 真实数据：#21910 标题是 "Feature: rewind/edit-and-resubmit (like Claude Code's double-Esc)"，2026-05-08 创建 → 2026-06-01 关闭，挂起 23 天，不是 release notes 那个虚的"long-standing"——23 天是真实数字。我现在跑法考笔记再也不怕模型抽风了——它瞎编法条，我 /undo 1，整段退回，模型上下文干净了重新生成。

Windows 桌面版（重点）

v0.16.0 桌面应用是 Electron 原生，macOS / Linux / Windows 三端同时发布，从 GitHub release 页面下 Windows 安装包（exe）双击装就行。装好之后：拖文件进聊天、Cmd+K 命令面板、状态栏直接切模型、in-app 自更新——这些全是我以前在 WSL 终端里敲半天命令才能完成的事，现在双击图标就行。

Web Dashboard 终于能配 channel 了

v0.15.2 dashboard 只能看，v0.16.0 把 channels / MCP / 凭证 / webhook / 记忆配置全搬到浏览器里。我以后给新同事装 hermes，直接把 dashboard 链接发过去，他点开填 app_id / app_secret 就完事——不用再 SSH 到我 WSL 了。这条对团队协作是真利好。

看起来很美好对吧？接下来这条才是我写这篇文章的真正原因——

先说场景：你想让 Windows 桌面版当 GUI 壳子，背后继续跑你 WSL 里的 hermes gateway（这样飞书 / 微信 / QQ 还是用 WSL 那套配置，session 也能继续用）。这个想法很自然，v0.16.0 桌面版的 release notes 也明明白白写了 "Connect desktop to remote Hermes (homelab, hosted, teammate's server) over secure WebSocket"。

我装上桌面版、配置好 Remote URL、Token 也填了——UI 直接卡死 "Could not connect to Hermes gateway."

去 GitHub 一查，这是个已知问题，Issue #38412（Open / P2 / 多人复现），关联修复 PR 是 #40408，**目前还在 review 没合并**。

这个 bug 的根因不是单一的，是 4 个互相绑死的"门禁"：

1. Origin 头不对——打包的 Electron 渲染器走 `file://` 协议，发出来的 Origin 是 `null`，gateway 的 origin 守卫直接 403 拒掉

2. Token 不匹配——dashboard 默认生成 per-process 随机 token 注入 HTML，桌面拿不到，UI 里让你输的 token 永远猜不对

3. Bind 限制——loopback bind 只允许 loopback peer；非 loopback bind 又被 origin 检查卡住；两个互斥，4 个组合里 3 个失败

4. 缺 --tui 标志——dashboard 不带 `--tui` 或 `HERMES_DASHBOARD_TUI=1` 跑，`/api/ws` 端点直接 403，谁来都拒

我实测下来，唯一能跑通"远程连 WSL 后端"的方法是同时满足这 4 个条件——WSL 端改 dashboard 跑 `--tui` + 0.0.0.0 bind、用 curl 去 `/__session__` HTML 里 scrape token、手动喂给桌面版。能跑通，但 token 每次重启都变。

这就是"史诗级更新"没在 release notes 里提的暗坑——很多读者看 v0.16.0 的"桌面 + 远程"功能就冲了，结果装上发现根本连不上。

既然远程连接有 bug，那要不要升、怎么升，我把 3 个真实方案列出来给你看：

方案 A：先升 WSL 端 v0.16.0，手动 hack token 配桌面

适合：你想桌面当 WSL 壳子，飞书 / 微信 / QQ 都用 WSL 那套。

坑：874 commit 大版本升级自带 breaking change 风险；token 每次 dashboard 重启要重新 scrape；PR #40408 合并后整个流程会变。

命令：`hermes backup` → `hermes update` → 杀旧进程（用 `pkill -f "hermes-agent.v"` 别用泛 pkill）→ dashboard 加 `--tui` + 0.0.0.0 跑 → 桌面版配 Remote URL。

方案 B：桌面版当独立 instance（不连 WSL）

适合：你想要个 Windows 本地的 hermes 玩玩，WSL 那边继续跑自己的事。

坑：API key / 80+ skills / cron / 飞书 session 全部不互通；飞书 bot 别在桌面端配（不然和 WSL 飞书 bot 双收消息）。

命令：桌面版走 Quick Setup / Nous Portal，**只**配模型和 API key，**不**勾飞书 / 微信 / QQ channel。

方案 C：等 PR #40408 合并再上（最稳）

适合：你不急，CLI 用得挺顺。

坑：可能要等 1-2 周（v0.16.1 / v0.16.2 出来），期间 WSL 端继续 v0.15.2。

命令：什么都不用做，CLI 继续。

如果你已经在 WSL 跑 hermes v0.15.2，CLI 用得挺顺

→ 走方案 C，等 PR #40408 合并。期间把 hermes 升级到 v0.15.x 最后一个 patch 版就够用。

如果你想桌面当 WSL 壳子、想 GUI 但不想丢 WSL 后端

→ 走方案 A。先 `hermes backup` 全量备份（配置 + session + state.db + skills 都得 cp），再 `hermes update`，然后按"方案 A"的命令配对。token 要手动 scrape 这个事实你得接受。

如果你就想在 Windows 桌面双击图标用 hermes，不在乎后端连不连

→ 走方案 B。桌面版走 Quick Setup 配 Nous Portal 账号，**飞书 / 微信 / QQ 千万别勾**（否则和 WSL 那边的 channel 双收消息）。

如果你是团队负责人，想给同事发个统一安装包

→ 等方案 C。远程连接没修好之前，给同事装的桌面版会让他们以为"hermes 桌面版是坏的"，反而劝退。等 PR #40408 合并再批量推。

如果你是 hermes 重度用户，874 commit 都想自己过一遍

→ 直接 `hermes update`，看 release notes 重点过 `agent/` 和 `gateway/platforms/` 这两个目录的 diff。v0.16.0 的精简默认 skill 集移除了 spotify / linear / kanban-codex-lane / debugging-hermes-tui-commands，如果你依赖这些要自己装回。

先说结论：这次 v0.16.0 是个跨大版本，874 commit 一次升过来——不急着升。

两个具体原因（写稿时查过 GitHub API）：

① Issue #38412 桌面版远程连接 P2 bug 还在，PR #40408 写稿时未合并，现在升上来桌面版连 WSL 后端就是 403。

② v0.16.0 精简了默认 skill 集，移除 spotify / linear / kanban-codex-lane / debugging-hermes-tui-commands 这几个，从 v0.15.2 升上来要重新装回来。

如果你还是决定要升，请先做完下面这 4 件事：

① 全量备份 hermes 数据目录（最重要）

cp -a ~/.hermes ~/.hermes.backup_$(date +%Y%m%d_%H%M%S)

这一条 cp -a 把你的配置、所有 session 文件、state.db、skills、cron 任务、memory 全部打包。升完之后出问题，rm -rf ~/.hermes && mv ~/.hermes.backup_xxx ~/.hermes 就能秒级回滚。

② 单独备份四个核心子目录（不放心的话）

cp -a ~/.hermes/skills ~/hermes_skills_backup
cp -a ~/.hermes/profiles ~/hermes_profiles_backup
cp -a ~/.hermes/cron ~/hermes_cron_backup
cp -a ~/.hermes/memories ~/hermes_memories_backup

skills / profiles / cron / memories 是 hermes 里改动比较多的四个目录，单独 cp 一份心里踏实。

③ 记一下当前版本号，方便回滚

hermes --version > ~/hermes_version_backup.txt
pip show hermes-agent | grep Version >> ~/hermes_version_backup.txt

万一升级出问题，可以 pip install hermes-agent==<v0.15.x 具体小版本> 回退（你 v0.15.x 安装时的小版本号看 ② 步保存的 txt）。

④ 数据迁移检查清单（升级后第一件事）

升级完不要直接 `hermes gateway start`，按这个清单一项一项过：

• hermes --version 确认升级生效

• hermes skills list 看自己加的 skill 还在不在

• hermes cron list 看 cron 任务还在不在

• hermes memory list 看 holographic memory 还在不在

• hermes gateway start 启动 gateway，看 channel（飞书 / 微信 / QQ）有没有断连

• 手机发一条消息 测下 channel 实际能不能收到回复