通用全链路镜像加速

要解决什么问题

在国内或受限网络里做开发，常见场景不是「不会配镜像」，而是 Agent 或脚本在 git clone、pip install、docker pull 已经超时或报 DNS/连接错误后仍反复直连，甚至直接结束进程。本技能针对的是 16 个品类的可达性与速度：GitHub / HuggingFace / PyPI / npm / Docker / Go / Rust / Homebrew / Maven / Conda / APT / RubyGems / CocoaPods / Flutter / Chromium 相关下载，以及任意 HTTPS 文件的通用代理回退。

技能如何工作

核心是三层脚本分工：

• mirror_fetch.sh：运行时引擎。对 URL 做延迟探测；官方源不可达时按品类遍历 mirrors_config.sh 中的镜像，v3.0 并行探测后按实测延迟排序，结果可缓存到 /tmp/.mirror_latency_cache（TTL 约 5 分钟）。Git 类 URL 用 git ls-remote 探测，不走无效的 HTTP HEAD。
• mirror_health_check.sh：批量输出各镜像 HTTP 状态、延迟与通过/失败汇总；--update 可从多源回退链拉取最新镜像列表并做内容校验（避免把 404 HTML 当配置）。
• setup_system_mirrors.sh：一键写入 pip、npm、Docker、Maven、Conda 等系统/用户级镜像配置；APT 采用 sed 域名替换，保留 PPA 与自定义源，并修复 /ubuntu/、/debian/ 路径问题。

GitHub 另有分层策略：优先镜像 clone，大仓库可浅克隆，部分 CDN 域名直连，最后再走 gh-proxy 类通用代理。技能文档要求 Agent：一旦检测到超时或典型网络错误，应自动切换镜像，而不是等用户提醒或单纯 kill 进程。

适用边界与注意

• 解决的是 「通不通、慢不慢」，不替代权限审查、证书策略或官方签名校验；生产或敏感制品仍建议高校/大厂镜像并核对摘要。
• 镜像存在同步延迟，不要手动拼镜像 URL；自定义源应放在 ~/.mirrors_custom.sh，优先级高于默认配置。
• 与 VPN/代理可共存：官方源可达时优先直连（往往走代理通道），不可达再回退国内镜像。