Hermes Agent v0.14.0:不用装 WSL 了,Windows 原生支持来了(Early Beta)
Hermes Agent v0.14.0(代号"The Foundation Release")发布了。版本号 v2026.5.16,808 次提交,633 个 PR 合并。
v0.13 的 Windows 用户只能通过 WSL2 运行------官方文档写得很直白:"Native Windows is not supported. Please install WSL2." v0.14 把这条路改成了原生 Windows 支持------不装 WSL,在 cmd.exe 和 PowerShell 上直接跑。
说几个关键变化。
01 | Windows 原生支持:不用装 WSL 了
v0.13 的 Windows 支持需要 WSL2------相当于在 Windows 里跑一层 Linux 虚拟机。装 WSL 本身就要折腾路径、环境变量、文件权限。
v0.14 直接跑在 cmd.exe 和 PowerShell 上,不再依赖 WSL。主要改动:
- 原生 subprocess/PTY 路径处理,不再依赖 WSL
- 用
taskkill替代 Linux 的kill管理进程 - 自动安装 MinGit(Git for Windows 的最小化版),不需要你先装 Git
- 检测 Microsoft Store 安装的 Python stub,避免踩坑
- 修复 40+ 项 Windows 专属问题,覆盖 CLI、Gateway、TUI
- 文件名自动补全、信号处理、ANSI 序列、路径归一化、文件锁语义......全修了一遍
⚠️ Early Beta:主干已通,边角还在修。某些第三方 tool 在 Windows 下需要手动补 PATH,Ink TUI 在旧版 Console Host 有字符错位。建议用 Windows Terminal 或 VS Code 终端。
生产环境使用需谨慎,建议先在测试机上试用,确认关键功能正常工作后再推广到团队。
WSL vs 原生 Windows,到底差在哪
| 对比项 | 用 WSL 跑 Hermes | 原生 Windows(Early Beta) |
|---|---|---|
| 前提条件 | 需要开启 WSL2,部分旧机器不支持 | ✅ 无额外依赖 |
| 安装步骤 | 装 WSL → 装 Linux 发行版 → 装依赖 → 装 Hermes | ✅ pip install hermes-agent |
| 文件路径 | 跨文件系统 /mnt/c/,性能损耗、权限混乱 |
✅ 原生 Windows 路径,无转换损耗 |
| 进程管理 | Linux signal 语义 | ✅ taskkill + ps2 回退,与 Windows 一致 |
| Ctrl+C 行为 | 经 WSL 转发 | ✅ 已修复,保留原生行为 |
| Git 依赖 | WSL 自带 | ✅ 自动安装 MinGit |
| Python 环境 | WSL 内另装 | ✅ 直接用 Windows 的 Python |
| 终端兼容 | 必须支持 WSL 的终端 | ✅ cmd.exe / PowerShell / Windows Terminal |
| 成熟度 | ✅ 正式支持,功能全覆盖 | ⚠️ Early Beta,主干通但边角在修 |
| 性能 | 有 WSL 层开销 | ✅ 直接跑在 Windows 上,无中间层 |
| 团队部署 | 每人配 WSL,运维复杂 | ✅ requirements.txt 一键装,运维简便 |
对 Windows 用户来说,最大变化不是跑得更快------是不用先装 WSL 就能用这个工具了。
02 | 一行 pip install,告别 clone + 脚本
v0.14 上了 PyPI,安装就是一行:
bash
pip install hermes-agent && hermes
之前是 git clone → 跑安装脚本 → 创建虚拟环境 → 装依赖 → 配 PATH → 设自动补全,中间任何一步出错就要从头 debug。
受益最大的是两类人:Windows 用户 (pip 比 PowerShell 脚本简单太多)、团队部署 (requirements.txt 加一行,全组一起装)。
0.14 还加了供应链安全检查 ------每次 pip install 自动扫描依赖的已知漏洞,高风险的直接警告。另外加了懒加载框架 ,fal_client、google-cloud 等重依赖只在第一次用到时才加载,不是启动就全拉。
03 | 冷启动快了 19 秒
v0.14 把冷启动砍掉了大约 19 秒。hermes tools 从 14 秒降到 1.5 秒以内,快了十倍。
主要三个原因:
- Skills 缓存 --- skills 没变时直接从缓存读,不再重新扫描
- 延迟加载非核心模块 --- 飞书、
fal_client、google-cloud等重依赖,第一次用到才加载 - 启动时不请求 Nous HTTP --- 之前启动阶段会请求 Nous 接口,网络慢就会被卡住。现在挪到异步后台
browser_console 的求值速度也提升了 180 倍------之前每次建新 DevTools 会话,现在用持久 CDP 路由。经常用浏览器工具的话感知明显。
跨会话的 Claude 前缀缓存也加了------Anthropic、OpenRouter、Nous Portal 共享 1 小时缓存,后台 review 也能命中。
04 | 其他值得一提的
v0.14 还塞了几个新东西:
会话传输(/handoff) --- 活跃会话可以实时迁移到不同的模型、persona、profile,不用从头开新会话。
hermes proxy --- 把 OAuth 授权的提供商(比如 Claude Pro、ChatGPT Pro)暴露成 OpenAI 兼容的端点,Codex、Aider、Cline 都能用。
平台扩展 --- 新增 LINE 和 SimpleX Chat 支持,消息平台总数到了 22 个。国际化从 7 个 locale 翻到 16 个。
05 | v0.13.0 → v0.14.0 版本对比
| 功能领域 | v0.13.0 | v0.14.0 |
|---|---|---|
| Windows 支持 | 依赖 WSL2 | 原生支持(Early Beta) |
| 安装方式 | git clone + 脚本 | pip install hermes-agent |
| 冷启动 | ~基线 | 削减 ~19s |
hermes tools |
~14s | <1.5s |
browser_console |
每次新会话 | 持久 CDP,快 180x |
| 跨会话缓存 | 无 | Claude 1h 前缀缓存 |
/handoff 会话传输 |
无 | 实时迁移 |
/subgoal |
无 | 扩展 /goal |
| LSP 诊断 | 基础后写 lint | 真实语言服务器 |
vision_analyze |
文本降级描述 | 视觉模型直接看像素 |
x_search 搜索 |
无 | X/Twitter 搜索 |
hermes proxy |
无 | OpenAI 兼容本地代理 |
| 供应链安全 | 无 | 依赖安全扫描 |
| 消息平台 | 20 个 | 22 个(+LINE、+SimpleX) |
| 新可选技能 | 6 个 | 9 个 |
| 国际化 | 7 个 locale | 16 个 locale |
| sudo 保护 | 无 | 暴力破解拦截 |
| Kanban | 首次发布 | 增强(specify/list/unblock) |
/goal 持久目标 |
首次发布 | +/subgoal |
| clarify 按钮化 | 文字提示 | Telegram/Discord 原生按钮 |
06 | 实操升级:从 v0.13 到 v0.14
我自己的环境是 WSL + v0.13.0(git clone 可编辑安装),升级流程如下:
第一步:拉代码
bash
cd ~/.hermes/hermes-agent
git pull upstream main
如果本地有修改过的文件,git pull 会拒绝合并。需要先 git stash,升完再 pop 回来确认兼容。
stash 之后,merge 完成------563 个新 commits,0 个冲突。HEAD 指向 v2026.5.16。
第二步:更新依赖
bash
source venv/bin/activate
pip install -e .
注意:有些依赖被降级了:
| 包 | v0.13.0 | v0.14.0 |
|---|---|---|
| croniter | 6.2.2 | 6.0.0 |
| openai | 2.36.0 | 2.24.0 |
| pydantic | 2.13.4 | 2.12.5 |
| rich | 14.3.4 | 14.3.3 |
这不是 bug------v0.14 锁了自己验证过的版本。如果其他项目依赖更高版本,注意可能冲突。
第三步:验证
bash
hermes --version
# Hermes Agent v0.14.0 (2026.5.16) ✓
hermes doctor
# ✓ Config version up to date (v23),配置无需迁移
冷启动实测:hermes tools list 从 ~14 秒降到 0.49 秒。
第四步:Gateway
跑着的 Gateway 不会自动用新代码。需要逐个重启:
bash
hermes gateway run --replace # 默认 profile
hermes --profile <其他profile> gateway run --replace
其他发现
- 新工具集
x_search、moa、video_gen默认禁用,可在config.yaml中开启 - MCP 服务(csdn、wenyan、xhs)不受影响
- kanban 任务和自定义 skill 无需迁移
升级建议速查
| 安装方式 | 升级命令 |
|---|---|
| pip 安装 | pip install --upgrade hermes-agent |
| git clone | git pull && pip install -e . |
| 有本地修改 | 先 stash,升完再 pop |
| 跑着 Gateway | 升完逐个 gateway run --replace |
| 担心依赖冲突 | 先 pip check |
总结
v0.14.0(The Foundation Release)核心变化:
- Windows 原生支持,不再依赖 WSL(Early Beta)
- PyPI 发布,
pip install hermes-agent一行搞定 - 冷启动减少 ~19 秒,
hermes tools从 14 秒降到 <1.5s - 会话传输、hermes proxy、LINE/SimpleX 等新功能
这个版本不是在加功能,是在铺路------把安装门槛降下来,把启动速度提上去。Windows 原生支持虽然还是 early beta,但方向已经很明确:Hermes 要变成一个装完就能跑的工具,不管你用什么操作系统。