Hermes Agent 部署用户最关心的是升级后还会不会追 main本地配置和补丁会不会丢本文按 Linux 源代码安装记录版本变化、升级命令和验收结果也把本机遇到的两个边界情况讲清楚。文中提到的 Windows 桌面安装资料已整理在查看 Windows 安装资料先看结论这次升级主要改了什么v0.21.7 是 2026 年 10 月 11 日发布的补丁版。官方说明称它把 v0.21.6 之后约 204 个 PR 汇总到稳定版本完整整理版变更记录预计随 v0.22.0 发布。别把“204 个 PR”理解成 204 个新功能。对源代码安装用户最直观的变化是更新通道默认只跟正式发布标签。若仍要逐提交体验 main可以显式切换。桌面端也增加了通道选择此外恢复会话时的推理内容处理得到修复。源代码版怎么升级先确认当前版本再用官方更新命令结束后重新查看版本并跑健康检查hermes --version hermes update hermes --version hermes doctorhermes update负责更新程序第二次--version用来确认当前代码版本doctor检查配置和依赖。若本机改过 Hermes 源代码或维护了本地补丁先备份并检查工作区状态不要直接覆盖。源代码安装想继续追逐每次提交可使用官方发布说明给出的通道命令hermes update --set-channel main稳定通道适合希望版本固定、变更可追溯的日常使用main 通道适合愿意承担频繁变化的测试环境。Fork 和镜像仓库仍跟随 mainStore、MSIX 和已打包桌面版的更新方式不因这个通道设置改变。若需要手动切换源代码仓库到明确版本标签可按下面流程。先备份配置并记录升级前的完整提交号git status --short有输出时先停下备份或处理本地修改不要强制覆盖$ cd ~/.hermes/hermes-agent $ git status --short $ git rev-parse HEAD $ git fetch origin tag v0.21.7 $ git checkout --detach v0.21.7 $ ./venv/bin/pip install -e . $ ./venv/bin/pip check $ ./venv/bin/hermes --versionfetch拉取指定发布标签checkout --detach让工作目录固定在这个版本pip install -e .按当前代码更新依赖pip check检查依赖冲突最后用--version确认程序显示目标版本。本次本机升级是按发布标签切换后重新安装依赖再完成下方验收。本机升级验收记录本次实测对象是 Linux 源代码安装代码从 v2026.9.24 切换到v0.21.7再按项目依赖重新安装。验收不是只看版本号$ ./venv/bin/hermes --version $ ./venv/bin/pip check $ ./venv/bin/python -c import hermes_cli, agent, tools.registry, gateway.run, cron.scheduler; print(核心模块导入通过)实际结果版本命令报告v0.21.7pip check返回No broken requirements foundhermes_cli、agent、tools.registry、gateway.run、cron.scheduler五个核心模块都能导入。若升级后确认不符合预期代码回退点是升级前记录的提交号在本地工作区干净时执行git checkout --detach 升级前提交号再运行./venv/bin/pip install -e .最后重新检查版本与依赖。这只回退代码不会回退用户配置、会话或插件状态若依赖也需回退应按本机备份恢复不能把 Git 回退当成全量回滚。同一轮还把 Python 版 WebUI 从exp-v0.52.379更新到exp-v0.52.46814 行本地定制补丁成功重贴server.py和api/config.py语法检查通过。WebUI 与 Agent 是两个独立仓库版本号不要混成一个。两个容易误判的地方第一配置里的session_reset.mode: both并不是这次升级才失效。上游在 2026 年 9 月 7 日已经停止按空闲时长或每日时间轮换会话升级前的 v2026.9.24 已包含该提交。v0.21.7 新增的是提示让doctor和启动日志明确指出这项设置不再生效。它只说明旧行为早已改变不代表这次升级突然改了会话。第二本机虚拟环境是Python 3.11.0rc1。调用插件搜索时自动依赖补全报TarFile.extractall() got an unexpected keyword argument filter检查确认当前解释器的extractall不接受filter参数。这个现象出现在预览版 Python 环境不能直接推成所有用户都会遇到。它与pip check通过、核心模块可导入是不同层面的检查若遇到同类报错先看 Python 的实际版本。是否值得升级如果您使用源代码安装想让更新默认停在正式标签或需要恢复会话时保留推理内容这个补丁版值得评估。升级后至少核对版本、依赖和核心模块服务重启后还要再确认 WebUI、Gateway 和实际会话能正常工作命令返回成功不等于业务验证完成。本文记录的是 Linux 源代码版升级不是 Windows 安装教程。首次在 Windows 桌面端安装的读者可从这里查看整理好的安装资料Hermes Agent Windows 安装资料官方发布记录Hermes Agent v0.21.7 Release
