GitHub 镜像加速 — 自动寻找并使用最快的 GitHub 代理

当需要从 GitHub 下载代码时，直连可能很慢或被阻断。本 skill 自动寻找当前网络环境下最快的 GitHub 代理镜像，然后使用它完成下载。

使用场景

以下任何涉及从 GitHub 下载的操作均应使用本 skill：

• git clone GitHub 仓库
• wget/curl 下载 github.com 或 raw.githubusercontent.com 的文件
• 下载 Release 资产（tarball、二进制文件）
• 获取 GitHub 仓库中的原始文件
• 任何缓慢或超时的 GitHub API 下载

工作流程

第一步：检查缓存，直接使用已知镜像

先读取缓存文件 {skill_dir}/scripts/mirrors-github.txt：

cat {skill_dir}/scripts/mirrors-github.txt

• 如果文件存在且有内容：取第一行作为 BEST_MIRROR，直接跳到第三步使用它。无需测速，无需爬取。
• 如果文件不存在或为空：进入第二步，运行完整的测速流程来填充缓存。

第二步（仅在缓存不可用时）：运行 Mirror Scout 测速

运行 mirror-scout 工具对可用的 GitHub 代理镜像进行测速排名：

python3 {skill_dir}/scripts/mirror-scout.py --github --no-scrape --top 5

默认加 --no-scrape 跳过网页爬取以节省时间，仅测试内置可靠镜像和缓存中的镜像。

如果缓存为空且 --no-scrape 没有找到可用镜像，去掉该参数进行完整爬取：

python3 {skill_dir}/scripts/mirror-scout.py --github --top 5

该工具会：

1. 从 mirrors-github.txt 加载已知镜像
2. （可选）从内置来源爬取更多候选镜像
3. 通过每个镜像下载测试文件并测量实际速度
4. 按下载速度排名并展示前 5 个
5. 将结果保存回 mirrors-github.txt，下次直接使用缓存

第二步附：解析输出并选择最佳镜像

输出会展示排名结果，类似：

=== Ranking by download speed  ===
Rank  Speed          Latency      Mirror
1     12.34 MiB/s    0.234s       https://ghfast.top
2      8.21 MiB/s    0.512s       https://ghproxy.link

选择排名第 1 的镜像（速度最快）。

第三步：使用最佳镜像进行下载

git clone：

# 原始命令：git clone https://github.com/user/repo.git
git clone https://BEST_MIRROR/https://github.com/user/repo.git

wget/curl 原始文件：

# 原始命令：wget https://raw.githubusercontent.com/user/repo/main/file.txt
wget https://BEST_MIRROR/https://raw.githubusercontent.com/user/repo/main/file.txt

Release 资产：

# 原始命令：wget https://github.com/user/repo/releases/download/v1.0/file.tar.gz
wget https://BEST_MIRROR/https://github.com/user/repo/releases/download/v1.0/file.tar.gz

规律： 在完整的 https://github.com/... 或 https://raw.githubusercontent.com/... URL 前面加上 BEST_MIRROR/ 即可。

参数说明

参数	默认值	说明
--github	False	启用 GitHub 镜像模式（必须）
--no-scrape	False	跳过网页爬取，仅测试已知镜像
--top N	0（全部）	仅展示前 N 个结果
--mirror URL	—	手动添加待测镜像（可重复使用）
--timeout N	10	下载超时（秒）
--connect-timeout N	3	连接超时（秒）
--workers N	8	并发测试线程数
--max-mb N	1	每个镜像最大测试下载量（MB）
--source URL	内置	额外爬取的来源页面（可重复使用）

错误处理

• 如果缓存中的镜像下载失败：尝试缓存文件中的下一个镜像（第二行、第三行……）。
• 如果所有缓存镜像都失败：运行完整测速重新筛选：

  python3 {skill_dir}/scripts/mirror-scout.py --github --top 5
  

• 如果仍无可用镜像，手动添加后重新测速：

  python3 {skill_dir}/scripts/mirror-scout.py --github --mirror https://ghproxy.net --mirror https://mirror.ghproxy.com --top 5
  

• 测速结果会自动保存到 mirrors-github.txt，后续使用无需重复测速。

依赖

本工具需要 Python 3.6+ 和 requests 库。如未安装，先执行：

pip install requests