https://blog.kalend.top/tags/native-support/Recent content in Native-Support on Kalend's BlogHugo -- gohugo.iozhThu, 14 May 2026 00:00:00 +0800https://blog.kalend.top/2026/05/14/hermes-windows-support.html/Thu, 14 May 2026 00:00:00 +0800https://blog.kalend.top/2026/05/14/hermes-windows-support.html/<h2 id="windows-原生支持来了">Windows 原生支持，来了 </h2><p>2026年5月8日，一个 255 个文件、新增 7675 行代码的 PR 被合并进 Hermes Agent 主分支。</p> <p>PR #21561，标题很简单：<strong>「feat(windows): native Windows support (early beta)」</strong>。</p> <p>从这一天起，Hermes 不再只属于 Linux/macOS 用户。你可以直接在 PowerShell 里一行命令装好，不需要 WSL，不需要虚拟机，不需要任何 Linux 基础。</p> <h2 id="先说结论能用了但还早">先说结论：能用了，但还早 </h2><p>目前的状态是** Early Beta**——官方自己标的。什么意思？</p> <p>**能用的：**CLI 终端、Gateway 消息网关、定时任务、浏览器自动化、MCP 工具链、Ollama 本地模型对接、Web 管理面板，这些全部在原生 Windows 上跑通了。</p> <p>**还不行的：**Web 面板里的嵌入式终端（需要 POSIX PTY，Windows 暂不支持）；另外还有一些路径编码、进程管理的小 bug 在持续修复中。</p> <h2 id="安装一行命令">安装：一行命令 </h2><div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="nb">irm </span><span class="n">https</span><span class="err">:</span><span class="p">//</span><span class="n">raw</span><span class="p">.</span><span class="py">githubusercontent</span><span class="p">.</span><span class="n">com</span><span class="p">/</span><span class="n">NousResearch</span><span class="p">/</span><span class="nb">hermes-agent</span><span class="p">/</span><span class="n">main</span><span class="p">/</span><span class="n">scripts</span><span class="p">/</span><span class="n">install</span><span class="p">.</span><span class="py">ps1</span> <span class="p">|</span> <span class="nb">iex </span></span></span></code></pre></td></tr></table> </div> </div><p>打开 PowerShell，粘贴回车。安装脚本会自动处理 Python 环境（通过 uv）、Node.js 和 Git Bash 的依赖。</p> <p>Linux/macOS 用户原有的 curl 安装方式不变：</p> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh <span class="p">|</span> bash </span></span></code></pre></td></tr></table> </div> </div><h2 id="为什么这件事值得说">为什么这件事值得说 </h2><p>在 PR #21561 合并之前，Windows 用户想用 Hermes，只有两条路：</p> <ol> <li><strong>WSL2</strong>——能用，但你得懂 Linux，得装 WSL，得处理网络桥接，折腾门槛不低。</li> <li><strong>自己硬上</strong>——有人在 Windows 直接跑，但到处报错：fcntl 导入失败、GBK 编码崩溃、进程探测 OSError……体验一言难尽。</li> </ol> <p>GitHub 上与 Windows 相关的 issue 超过 <strong>1100 个</strong>。排在前面的全是：<code>os.kill(pid, 0)</code> 在 Windows 上抛 SystemError、终端工具输出为空、<code>.env</code> 文件编码损坏、cp1252 导致 UnicodeEncodeError……</p> <p>说白了，Hermes 之前是按 POSIX 标准写的，Windows 是个「二等公民」。</p> <p>这次合并把这些问题做了系统性的修复：</p> <ul> <li><strong>进程管理</strong>：重写了 Windows 进程检测逻辑，用 kernel32.OpenProcess 替代了 POSIX 信号量探测</li> <li><strong>路径处理</strong>：新增路径归一化函数，统一处理反斜杠、驱动器号、WSL 路径互转</li> <li><strong>编码问题</strong>：全局强制 UTF-8 输出，解决 cp1252/GBK 崩溃</li> <li><strong>安装体验</strong>：PowerShell 一键安装器，自动绑定 Python + Node.js + Git Bash</li> <li><strong>CI 门禁</strong>：新增 <code>check-windows-footguns.py</code>，每个 PR 都自动检测 Windows 兼容性问题</li> </ul> <h2 id="功能对比原生-windows-vs-wsl2">功能对比：原生 Windows vs WSL2 </h2><table> <thead> <tr> <th>功能</th> <th style="text-align: center">原生 Windows</th> <th style="text-align: center">WSL2</th> </tr> </thead> <tbody> <tr> <td>CLI / TUI</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>Gateway 消息网关</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>定时任务</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>浏览器自动化</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>MCP 工具链</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>Ollama 本地模型</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>Web 管理面板</td> <td style="text-align: center">✅</td> <td style="text-align: center">✅</td> </tr> <tr> <td>面板内嵌终端</td> <td style="text-align: center">❌</td> <td style="text-align: center">✅</td> </tr> <tr> <td>开机自启</td> <td style="text-align: center">✅ (schtasks)</td> <td style="text-align: center">✅ (systemd)</td> </tr> </tbody> </table> <p>除了面板内嵌终端这一个点，其他功能已经和 WSL2 平齐。</p> <h2 id="背后做了什么">背后做了什么 </h2><p>这次合并不是简单加几个 if-else。CONTRIBUTING.md 里新增了 16 条跨平台兼容性规范，覆盖了你在 Windows 上能想到的每一个坑：</p> <ul> <li>禁止使用 <code>os.kill(pid, 0)</code>（Windows 会抛 SystemError）</li> <li>禁止直接调用 <code>wmic</code>、<code>ps</code>、<code>grep</code> 等 Unix 命令</li> <li><code>fcntl</code>/<code>termios</code> 必须 ImportError 保护</li> <li>文件读取必须显式指定 UTF-8 编码</li> <li>进程管理要用 <code>CREATE_NEW_PROCESS_GROUP</code> 替代 <code>os.setsid</code></li> <li>路径必须用 <code>pathlib.Path</code>，不能硬编码斜杠</li> <li>符号链接在 Windows 需要管理员权限</li> <li>OneDrive 重定向路径的兼容处理</li> <li>CRLF/LF 行尾符一致性</li> </ul> <p>配套的 CI 检查脚本会在每个 PR 提交时自动扫描这些「Windows 地雷」，防止新代码引入兼容性问题。</p> <h2 id="如果你想试试">如果你想试试 </h2><ol> <li><strong>环境要求</strong>：Windows 10/11，PowerShell 5.1+</li> <li><strong>安装</strong>：一行命令搞定，安装脚本自带 Python 环境</li> <li><strong>配置模型</strong>：安装完成后运行 <code>hermes setup</code>，配置你的 API Key（支持智谱GLM、DeepSeek、通义千问等国内模型）</li> <li><strong>启动</strong>：<code>hermes</code> 回车，进入交互式终端</li> </ol> <p>遇到问题可以直接去 GitHub 搜 issue，1100 多个 Windows 相关 issue 说明社区很活跃，维护者在密集修复。</p> <h2 id="值得关注的信号">值得关注的信号 </h2><p>几个细节说明这次不是玩票：</p> <ul> <li><strong>创始人亲自提交</strong>：PR #21561 的合并者是 @teknium1（Nous Research 创始人），不是随便一个社区贡献者</li> <li><strong>文档同步上线</strong>：README 首页直接加了 Windows 安装入口，文档站新增了完整的 Windows 专属页面</li> <li><strong>安装脚本锁定</strong>：CONTRIBUTING.md 要求 install.sh 和 install.ps1 必须同步更新，不是加完就不管</li> <li><strong>社区参与度高</strong>：合并当天就有多个新 issue 和 PR 提交，说明已经有用户在原生 Windows 上实际使用了</li> </ul> <h2 id="一句话总结">一句话总结 </h2><p>Windows 原生支持从「完全不能用」变成了「能用但还粗糙」。对 Windows 用户来说，门槛从「先学 Linux」降到了「一行命令安装」。对项目来说，用户池一下子从 Linux/macOS 开发者扩展到了全球最大的桌面操作系统用户群。</p> <p>Beta 就是 Beta，但方向是对的。</p>