ZIP / tarball 下载超时或中断

症状

从 GitHub 下载 zip / tarball 反复超时、中断，无法拿到完整压缩包。

原因

到 GitHub 的下载链路（codeload/github.com）不稳定或带宽差；大文件传输中途断开。

解法

1. 换通道：改用 git clone（浅克隆 `git clone --depth 1 --branch v6.3.0 https://github.com/obra/superpowers.git`）或反向互换。

2. 换网络：切换网络环境 / 开代理后重试；错峰重试。

3. 离线解压：换任意可达的镜像站下载 zip → 手动解压 → 按「症状 6」接入；不依赖 zip 完整性的替代 = 只取 skills 目录（tarball 内含）。

验证证据

- 网页案例：CSDN Codex 桌面端安装（2026-06）——ZIP 下载超时 → git clone / 换网络 / 离线解压的社区解法。

- 本市场实测：codeload tarball 544K 直连稳定（2.1s 完成，），证明该端点当前可用；探针 raw 端点超时，故手册统一避开 raw 路径。