Windows 上 herdr 用 PowerShell 安装失败（下载被重置；改直下二进制）

你会遇到什么

Windows 上按官方说明在 PowerShell 里执行安装命令，下载被重置或脚本执行报错，装不上 herdr。你以为是网络不行，其实有两个叠加因素：PowerShell 的 Web 下载对 GitHub release 支持差、易被重置，而且旧安装路径还在流通。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

先给结论：问题在「下载通道」，不在 herdr 本体。官方安装器 2026-08-22 已修（issue #3131 避免 PowerShell web 下载、#3133 增加本地 cmd installer bootstrap），但 issue #3232（open，2026-08-25）仍有人踩旧路径——修复存在，但旧命令/旧文档路径还在流通。

链路：PowerShell 脚本 → Web 下载（Invoke-WebRequest 类）→ GitHub release → 解压安装。断点通常在第二步：国内出口到 GitHub release 直连不稳，PowerShell 内置下载器对重定向/大文件也不如专业下载工具稳，表现就是「下载被重置 / 脚本报错」。

实测对照（2026-08-28，WSL Linux）：走 gh-proxy 直下二进制 → chmod +x → --version 正常（cli-smoke v0.8.2）。Windows PowerShell 路径本环境未实测（如实标注）——但机制上同样可以绕开 PowerShell 下载：直下二进制。

推论：遇到 PowerShell 安装失败，不要反复重试同一条命令；先换通道（浏览器/下载工具/gh-proxy 直下二进制），再验证命令可用。

一步步来

1. 确认是不是「下载层」失败 — 必做

症状特征：命令卡在下载/重置，不是 herdr 报错。换浏览器或下载器下同一个文件，能下 = 下载层问题。

2. 直下二进制（绕开 PowerShell 下载） — 必做

去 release 页拿 Windows 资产；国内加 gh-proxy 前缀。

3. 升级到含修复的安装器 — 按场景

官方 08-22 后的安装器已避免 PowerShell web 下载（#3131/#3133）；如仍用旧命令，先核对官方文档的最新安装方式。

4. 验证 — 必做

herdr --version 输出 v0.8.2 级版本号即成功。

怎么确认修好了

• herdr --version 正常输出版本；
• 后续 herdr / herdr server 命令面可用（见 herdr server 启动条目）。

其它环境的表现

• WSL / Linux：gh-proxy 直下二进制实测可行（2026-08-28）；
• 企业网络（代理）：下载走系统代理；无代理的校园网同样适用 gh-proxy 路径；

症状

Windows 系统用 PowerShell 执行官方安装命令失败（下载被重置/脚本执行报错）。

原因

PowerShell 的 Web 下载对 GitHub release 支持差/易被重置；官方安装器 08-22 已修（issue #3131 避免 PowerShell web 下载、#3133 增加本地 cmd installer bootstrap），但 issue #3232（open 2026-08-25）仍有人踩旧路径。

解法

1. 升级到含修复的安装器，或直接下载二进制（herdr-linux-x86_64 对应 Windows 资产），不用 PowerShell 下载。
2. 国内网络：二进制走 gh-proxy 前缀加速。