github-mirror
自动寻找当前网络环境下最快的 GitHub 代理镜像,用于克隆仓库、下载文件或获取 Release 资产。当需要从 github.com 下载任何内容时使用本 skill——包括 git clone、wget/curl 下载、Release 资产获取等。
SKILL.mdskills/github-mirror/SKILL.md
GitHubGitHub 镜像加速 — 自动寻找并使用最快的 GitHub 代理
当需要从 GitHub 下载代码时,直连可能很慢或被阻断。本 skill 自动寻找当前网络环境下最快的 GitHub 代理镜像,然后使用它完成下载。
使用场景
以下任何涉及从 GitHub 下载的操作均应使用本 skill:
git cloneGitHub 仓库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
该工具会:
- 从
mirrors-github.txt加载已知镜像 - (可选)从内置来源爬取更多候选镜像
- 通过每个镜像下载测试文件并测量实际速度
- 按下载速度排名并展示前 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