Agent Skills
返回列表
快速镜像源

快速镜像源

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的说明,在你的 AI 助手中安装 @user_f42753f5/fast-mirror-skill。

技能介绍

问题背景

在国内网络环境下,npm install、pip install、brew install 等命令经常卡在 registry 或 CDN 上:下载慢、超时、CI 里反复失败。手动查文档改 .npmrc、pip.conf、sources.list 又容易漏项,且不同项目混用 Node、Python、Rust 时配置分散,很难在「先装依赖」这一刻快速对齐。

技能如何工作

fast-mirror-skill 面向「马上要装包」的场景:从用户输入或当前目录里的 package.json、requirements.txt、Gemfile、go.mod、Cargo.toml 等线索,推断实际用到的包管理器;若无法确定,会先问清楚再动手,避免误改无关工具链。

确认范围后,技能会生成只包含所需管理器的 shell 镜像脚本,按 SKILL 约定优先选用清华、阿里、腾讯、中科大等常见国内源(如 npm 的 registry.npmmirror.com、pip 的清华 PyPI、goproxy.cn 等)。脚本设计强调可逆:需要时可按同样思路恢复官方源。加载方式通常是 source 当前会话后再执行原始安装命令;若要做永久生效,需写入 .bashrc、.zshrc 或各包管理器自有配置文件——技能会区分「当前 shell 临时生效」与「持久化」的差异。

流程上可概括为:检测管理器 → 生成镜像脚本 → 加载环境 → 执行原安装命令。多栈项目(例如同时有 Node 与 Python 依赖)会按检测到的文件为各管理器分别出脚本,再统一加载后安装。镜像失效时,应换源或回退官方源,并排查网络而非盲目重试。

适用边界与注意点

  • 覆盖范围以 SKILL 所列为准:npm/yarn/pnpm、pip、Homebrew、apt/yum、gem、cargo、Go modules、Docker registry mirror 等;未列出的工具不会自动配置。
  • 保守原则:只改用户当前任务需要的管理器,加载前说明脚本会改哪些环境变量或配置。
  • 需要自选镜像组合时,可配合 theaiera.cn/mirrors 交互生成脚本;本技能侧重在对话里自动推断与生成。
  • 临时 source 仅影响当前终端会话;新开 shell 或 CI job 需单独处理或写入持久配置。

使用场景

  • 克隆 Node 仓库后执行 `npm install` 反复超时,需要在当前终端切到 npmmirror 再装依赖
  • 用 `pip install -r requirements.txt` 搭 Python 虚拟环境,官方 PyPI 下载过慢或中断
  • 在 Ubuntu/Debian 上跑 `apt update` 与 `apt install` 前,要把软件源换成清华或阿里镜像
  • 新机器上要装 Homebrew、cargo、Docker 等多套工具链,希望按项目文件一次性生成对应镜像脚本

适合人员

  • 在国内维护含 `package.json` 与 `requirements.txt` 的全栈项目、频繁装依赖的后端工程师
  • 负责给团队配 Mac/Linux 新机、要加速 brew 与 apt 安装的工程负责人
  • CI 或内网构建里 `docker pull`、`go mod download` 常失败的平台/DevOps 维护者
  • 刚拉开源 Rust/Go 仓库、需要用 cargo 或 goproxy 镜像完成首次编译的本地贡献者