手把手教你给「AI 助手」升级,以及官方版和第三方版UI界面到底选哪个

折腾了一晚上才搞明白，我把踩过的坑全写出来了

开头说两句

最近我把我的 AI 助手（Hermes Agent）升级了一次。说简单也简单，就点个按钮的事；说麻烦也麻烦，遇到了一堆奇奇怪怪的报错。折腾了大半夜，踩了无数坑，终于搞定了。

今天这篇文章，我就把这个过程写下来，电脑小白也能看懂。同时，我还会聊聊官方界面和第三方界面的区别——这也是很多人关心的问题。

第一部分：升级 AI 助手，我遇到了什么？

🌟 我的 AI 助手叫什么？

它叫 Hermes Agent（可以理解成「赫耳墨斯助手」），是一个开源的 AI 助手，可以在电脑上本地运行。开发者们不断给它添加新功能、修 Bug，所以时不时就需要升级。

❗ 升级提示来了

有一天我打开它的控制面板，看到一行字：

⬆ 有新版本可用！v2026.5.29 → v2026.5.29.2

看起来就是个普通的版本更新对吧？我点了一下「升级」按钮——

结果弹了个红红的错误提示：

Update failed（升级失败）

git history mismatch（版本历史对不上）

啥意思呢？就是 AI 助手检查代码的时候发现：「咦，你本地的代码历史和我服务器上记录的不一样，我没法给你升级。」

我当时就想：完了，又要折腾了。

🛑 第一个大坑：GitHub 连不上

很多人可能不知道，在中国大陆访问 GitHub（全球最大的代码托管网站）经常会连不上或者巨慢无比。

我试了各种办法：

试了 4 次，全失败。 GitHub 直连这条路，堵死了。

💡 换个思路：手动下载

既然在线升级不行，那我自己动手行不行？

GitHub 提供了一个功能——可以把整个项目打包下载（叫 tarball，类似 .zip）。我直接用命令行下载：

curl -L -o hermes-update.tar.gz "https://github.com/.../v2026.5.29.2.tar.gz"

这次成功了！31MB 的压缩包，几十秒下完。

下载下来了，然后呢？解压，覆盖旧文件：

rsync -av --delete /tmp/hermes-update/ ~/.hermes/hermes-agent/

如果你看不懂命令没关系，可以理解为：把新文件搬过来，把旧文件扔掉。

🚨 第二个大坑：整坏了！

问题出在那个 --delete 参数上——它把不该删的东西也删了：

1. 删掉了 .git 目录（Git 版本控制的信息）
2. 删掉了 venv 目录（Python 虚拟环境，相当于 AI 助手的「发动机」）

结果就是：

• 代码版本检查报错
• AI 助手启动不起来——因为发动机被拆了

教训：千万不要用 rsync --delete 来覆盖程序文件，特别是里面有虚拟环境目录的时候。

🔧 怎么修好的？

修了两步：

第一步：重建版本历史

因为 .git 目录被删了，我得重新初始化一个 Git 仓库：

cd ~/.hermes/hermes-agentgit initgit add -Agit commit -m "重建版本记录"git tag v2026.5.29.2

第二步：重建「发动机」（Python 虚拟环境）

python3 -m venv venvsource venv/bin/activatepip install -e .

这两步做完，AI 助手又能正常启动了。前后折腾了大概半小时。

📝 总结：正确的升级方法

如果你也用 Hermes Agent，正确的升级流程应该是：

1️⃣ 下载最新版本压缩包（用 curl 下载 tarball）2️⃣ 用 rsync 覆盖，但要跳过 .git 和 venv 目录   └── rsync -av --exclude=.git --exclude=venv /新版本/ /hermes目录/3️⃣ 重建虚拟环境   └── pip install -e .4️⃣ 重启 AI 助手

我用大白话翻译一下：

第一步：下载新版 → 第二步：覆盖旧文件（别删发动机和版本记录）→ 第三步：重装依赖 → 第四步：重启

第二部分：官方界面 vs 第三方界面，到底哪个好用？

升级完了之后，我发现我的 AI 助手其实有两个「脸面」——两个控制界面。

🏛️ 官方界面（Dashboard）

全称：Hermes Dashboard

这是官方团队做的管理面板，长这样：

官方 Dashboard 本质上是一个 「控制面板」——你想看 AI 助手运行得怎么样、日志有没有报错、配置有没有问题，用它非常合适。

但如果你是想和 AI 聊天、查看对话历史，它的体验就比较一般了。聊天功能需要开启一个特殊模式（--tui），而且经常提示什么「events feed disconnected」——翻译过来就是「连接不稳定」。

🎨 第三方界面（WebUI）

全称：nesquena/hermes-webui

这是一个第三方开发者做的界面。啥叫第三方？就是不是官方团队做的，而是热心网友自己做的。

它的特点是：

它的聊天体验和 ChatGPT 网页版非常像——左边是对话列表，中间是聊天窗口，下面是输入框，用起来很舒服。

⚖️ 一句话总结区别

第三方 WebUI = 聊天室（日常对话用）

官方 Dashboard = 控制室（管理配置用）

🤝 能不能两个一起用？

可以！完全不冲突！

它们跑在不同的「门牌号」上：

• 第三方 WebUI
   → http://localhost:9099
• 官方 Dashboard
   → http://localhost:9119

你可以在浏览器里开两个标签页，聊天用 9099，管理用 9119，互不干扰。

不过要注意一点：官方 Dashboard 的聊天功能没有第三方做得好，所以 「用第三方聊天，用官方管理」是最佳方案。

第三部分：给新手的实用小贴士

① 升级前先备份

# 备份配置文件cp -r ~/.hermes ~/.hermes.backup

② GitHub 连不上怎么办？

不要用 git pull，改用手动下载压缩包。GitHub 的 tarball 下载通常比 git 协议快得多。

③ 不要把虚拟环境删了

虚拟环境（venv 目录）是 AI 助手的运行依赖，删了就得重新装，很麻烦。覆盖文件时一定记得排除它。

④ 两个界面都开着

第三方 WebUI → 聊天对话官方 Dashboard → 看状态、改配置

这不是「二选一」，而是「一加一」。

⑤ 遇到报错别慌

大部分报错都能在网上找到答案。或者直接问你的 AI 助手——它就是干这个的。

结尾

这次升级经历让我觉得：

技术进步的时候，跟上它有时候比想象中麻烦。

一个简单的「点一下升级按钮」背后，可能有网络问题、版本兼容问题、环境配置问题……但这些坑踩过一次之后，下次就再也不会犯了。

现在我的 AI 助手跑着最新版本，官方 Dashboard 和第三方 WebUI 同时开着，想聊天就聊天，想管理就管理。虽然过程曲折，但结果很香。

如果你也在用类似的开源 AI 工具，希望这篇文章能帮你少走一些弯路。

如果你觉得这篇文章有用，可以收藏备用，或者分享给同样折腾 AI 的朋友～ 🚀

附录：常用命令速查