Hermes Agent 国内安装教程：学生党也能 5 分钟搞定
先搞清楚：这玩意是干啥的？
Hermes Agent = 装在你自己电脑上的 AI 编程助手。
跟 Cursor、GitHub Copilot 是同类产品，但它是免费开源的，你可以用自己的 API Key（比如 DeepSeek 的，10 块钱能用一个月），不用给任何人交订阅费。
它能帮你干嘛：
- 在终端里用自然语言让它写代码、改 Bug
- 自动搜索网页、读文档
- 帮你部署项目、管理 Git
- 连到微信 / QQ / Discord 上，像跟人聊天一样指挥它干活
而且它有桌面版了——双击安装就行，不再需要手敲命令。
为什么你在国内装不上？
下载的安装文件Hermes-Setup.exe只有7.6 MB，它是一个"下载器"。安装过程会在线拉取大约400-500MB的依赖：
| 依赖 | 多大 | 从哪下 | 国内能通吗 |
|---|---|---|---|
| Electron 桌面框架 | ~200MB | GitHub | ❌ 被墙，必卡 |
| Python | ~30MB | PyPI | ⚠️ 慢但能通 |
| Node.js | ~40MB | nodejs.org | ✅ 能通 |
| npm 包 | ~150MB | npm registry | ✅ 能通 |
罪魁祸首就是那个 200MB 的 Electron，它存在 GitHub 上，国内直接下载基本没戏。
解决方案：一行命令搞定
打开PowerShell（在开始菜单搜索"PowerShell"，右键"以管理员身份运行"），粘贴下面这行，回车：
# 1. Electron 镜像[Environment]::SetEnvironmentVariable("ELECTRON_MIRROR","https://npmmirror.com/mirrors/electron/","User")# 2. Python 依赖走清华镜像（uv 读 UV_INDEX_URL，不是 PIP_INDEX_URL！）[Environment]::SetEnvironmentVariable("UV_INDEX_URL","https://pypi.tuna.tsinghua.edu.cn/simple","User")# 3. Git clone 走 GitCode 镜像@" [url "https://gitcode.com/GitHub_Trending/he/"] insteadOf = https://github.com/NousResearch/ "@|Out-File-FilePath"$env:USERPROFILE\.gitconfig"-Encoding ASCII# 4. npm 走阿里镜像（不依赖 npm 命令）@" registry=https://registry.npmmirror.com "@|Out-File-FilePath"$env:USERPROFILE\.npmrc"-Encoding ASCII这一行是干嘛的？它告诉安装器：“Electron 别去 GitHub 下了，去阿里的镜像站下”。
执行完没有任何输出，这是正常的——变量已经写入了。关掉这个窗口。
接下来，两步走：
第一步：下载安装器
我已经帮你把最新的安装器打包好了，放在蓝奏云上（不限速下载）：
下载地址 → CSDN 资源
资源里包含
Hermes-Setup-0.18.2.exe（官方最新版）+ 本文的操作说明书（解压密码csdn2026）
第二步：双击安装
下载完Hermes-Setup-0.18.2.exe，直接双击运行。
安装过程会自动完成：
✅ 安装 Python（通过 uv，国内能通） ✅ 安装 Node.js ✅ 安装 Git ✅ 克隆源码 ✅ 安装 npm 依赖 ✅ 下载 Electron（这次走阿里镜像，不会再卡！） ✅ 构建桌面应用全程5-10 分钟，中间会有一个进度条在跑，等着就行。不需要你做任何操作。
跑完之后，桌面会自动弹出 Hermes 的聊天窗口 👇
装完第一步：选 AI 模型
Hermes 弹出来后，会先让你选模型。对学生党来说推荐：
| 提供商 | 花多少钱 | 怎么搞 | 推荐指数 |
|---|---|---|---|
| DeepSeek | ¥1/百万 token | 去 platform.deepseek.com 注册，创建 API Key 填进去 | ⭐⭐⭐⭐⭐ |
| 硅基流动 | 注册送 14 元 | 去 siliconflow.cn 注册，拿到 Key | ⭐⭐⭐⭐ |
| 通义千问 | 有免费额度 | 去 dashscope.aliyun.com | ⭐⭐⭐ |
DeepSeek 最便宜，写一天代码可能就花几分钱。充值 10 块能用一个月。
选完模型就可以开始用了。在聊天框里直接说"帮我写一个 Python 爬虫"，它就开始干活。
常见问题（学生党专属）
Q1：校园网能装吗？
能。校园网虽然限速，但阿里镜像（npmmirror.com）在国内任何网络下都能通。唯一可能慢的是 200MB 的 Electron 下载，校园网下可能要 5-10 分钟。
Q2：安装到一半报错了怎么办？
关掉安装器，删掉已安装的文件，重来一次。
删除命令（PowerShell 粘贴）：
Remove-Item-Recurse-Force"$env:LOCALAPPDATA\hermes"-ErrorAction SilentlyContinue然后重新双击Hermes-Setup.exe。
Q3：提示「无法识别 hermes 命令」
安装器会自动把hermes加到系统 PATH。如果没生效，关掉 PowerShell 重开一次。
Q4：宿舍网速太慢，能不能让别人帮我下？
让有快网的同学装好之后，把%LOCALAPPDATA%\hermes\整个文件夹拷给你就行。放回同样的位置，直接能用。
Q5：32 位电脑能用吗？
不能。Hermes 桌面版只支持64 位 Windows 10/11。如果你不确定自己的电脑是多少位：右键「此电脑」→「属性」→ 看「系统类型」。
Q6：macOS 怎么装？
macOS 不会被墙（走的是苹果 CDN），直接从官网下载.dmg拖进 Applications 就行。
（懒得看的）备选方案
如果上面那行命令都不想敲，还有两个社区打包好的"懒人版"：
| 版本 | 内核 | 说明 |
|---|---|---|
| sir1st/hermes-desktop | Hermes v0.14.0 | 全量离线包，不需要下载任何东西 |
| Hermes-CN-Desktop | 社区自研 | 中文社区维护，Tauri 框架更轻量 |
⚠️ 注意：这两个版本都比官方旧很多，功能少、Bug 多。建议还是用方案 A。
总结
1. 打开 PowerShell，粘贴那行 ELECTRON_MIRROR 变量 2. 下载安装器双击运行 3. 等 5-10 分钟 4. 选 DeepSeek 5. 开始指挥 AI 写代码完事。如果有问题，评论区留言，我看到会回。
版本信息：Hermes Agent v0.18.2 · 2026.7.7.2 · Windows 10/11 x64 · 免费开源 MIT