中国国内镜像源配置技能（Agent 自执行版）

核心设计理念：本技能不附带任何预置脚本。Agent 应根据本文档的指导，直接在用户计算机上编写并执行配置命令，实现镜像源配置功能。

工作流程（Agent 必须遵循）

Phase 1: 需求检测与环境分析

当触发本技能时，Agent 按以下步骤操作：

1.1 触发条件识别

• 用户明确提及：下载慢、安装依赖慢、配置镜像、加速下载、设置国内源
• 检测到项目包含依赖文件：package.json、requirements.txt、Cargo.toml、go.mod、Gemfile、.nuspec、environment.yml、build.gradle、pom.xml、composer.json

1.2 与用户确认

询问内容：
1. 需要配置哪些包管理器？（如未指定，根据项目依赖文件自动判断）
2. 有偏好的镜像源吗？（默认推荐阿里云或华为云）
3. 配置范围：全局配置 or 项目级配置？

1.3 环境检测命令 Agent 执行以下命令检测已安装的工具：

# Windows PowerShell 检测
python --version 2>$null; node --version 2>$null; npm --version 2>$null
cargo --version 2>$null; go version 2>$null; dotnet --version 2>$null
ruby --version 2>$null; conda --version 2>$null; gradle --version 2>$null
brew --version 2>$null

# Linux/Mac Bash 检测
for cmd in python node npm cargo go dotnet ruby conda gradle brew; do
    $cmd --version 2>/dev/null && echo "✓ $cmd available"
done

Phase 2: 选择镜像源

根据下表为用户选择最优镜像。标记 ⭐ 的为当前推荐。

Phase 3: 执行配置（Agent 直接运行命令）

重要：Agent 根据用户选择的包管理器和镜像，直接在终端执行以下对应命令。 不要创建临时脚本文件，直接使用原生命令或 Shell 命令完成配置。

3.1 Python pip 配置

Windows 全局配置：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\pip"
Set-Content -Path "$env:USERPROFILE\pip\pip.ini" -Value @"
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

[install]
trusted-host = mirrors.aliyun.com
"@ -Encoding UTF8
Write-Host "✓ pip 已配置为阿里云镜像"

Linux/Mac 全局配置：

mkdir -p ~/.pip
cat > ~/.pip/pip.conf \x3C\x3C 'EOF'
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

[install]
trusted-host = mirrors.aliyun.com
EOF
echo "✓ pip 已配置为阿里云镜像"

项目级配置（在项目根目录）：

# 创建 .piprc 或 setup.cfg
cat > pip.conf \x3C\x3C 'EOF'
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com
EOF
echo "✓ pip 项目级配置已完成"

验证：

pip config list

3.2 Node.js npm/yarn/pnpm 配置

全局配置：

# npm
npm config set registry https://registry.npmmirror.com

# yarn（如已安装）
yarn config set registry https://registry.npmmirror.com 2>/dev/null || true

# pnpm（如已安装）
pnpm config set registry https://registry.npmmirror.com 2>/dev/null || true

echo "✓ Node.js 包管理器已配置"

项目级配置（创建 .npmrc）：

echo "registry=https://registry.npmmirror.com" > .npmrc
echo "✓ npm 项目级配置已完成"

验证：

npm config get registry

3.3 Rust cargo 配置

全局配置：

mkdir -p ~/.cargo
cat > ~/.cargo/config.toml \x3C\x3C 'EOF'
[source.crates-io]
replace-with = 'aliyun'

[source.aliyun]
registry = "https://mirrors.aliyun.com/crates.io-index/"
EOF
echo "✓ cargo 已配置为阿里云镜像"

验证：

cat ~/.cargo/config.toml

3.4 Go mod 配置

Windows PowerShell：

[Environment]::SetEnvironmentVariable("GOPROXY", "https://mirrors.aliyun.com/goproxy/,direct", "User")
$env:GOPROXY = "https://mirrors.aliyun.com/goproxy/,direct"
Write-Host "✓ Go GOPROXY 已配置"

Linux/Mac：

echo 'export GOPROXY=https://mirrors.aliyun.com/goproxy/,direct' >> ~/.bashrc
export GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
echo "✓ Go GOPROXY 已配置"

验证：

go env GOPROXY

3.5 NuGet (.NET) 配置

Windows：

$nugetPath = "$env:APPDATA\NuGet"
New-Item -ItemType Directory -Force -Path $nugetPath
Set-Content -Path "$nugetPath\NuGet.Config" -Value @"
\x3C?xml version="1.0" encoding="utf-8"?>
\x3Cconfiguration>
  \x3CpackageSources>
    \x3Cclear />
    \x3Cadd key="huawei" value="https://repo.huaweicloud.com/repository/nuget/v3/index.json" />
    \x3Cadd key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  \x3C/packageSources>
\x3C/configuration>
"@ -Encoding UTF8
Write-Host "✓ NuGet 已配置为华为云镜像"

Linux/Mac：

mkdir -p ~/.nuget
cat > ~/.nuget/NuGet.Config \x3C\x3C 'EOF'
\x3C?xml version="1.0" encoding="utf-8"?>
\x3Cconfiguration>
  \x3CpackageSources>
    \x3Cclear />
    \x3Cadd key="huawei" value="https://repo.huaweicloud.com/repository/nuget/v3/index.json" />
    \x3Cadd key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  \x3C/packageSources>
\x3C/configuration>
EOF
echo "✓ NuGet 已配置为华为云镜像"

验证：

dotnet nuget list source

3.6 RubyGems 配置

全局配置：

gem sources --remove https://rubygems.org/ 2>/dev/null || true
gem sources -a https://mirrors.tuna.tsinghua.edu.cn/rubygems/
echo "✓ RubyGems 已配置为清华镜像"

Bundler 项目级配置：

bundle config mirror.https://rubygems.org https://mirrors.tuna.tsinghua.edu.cn/rubygems/
echo "✓ Bundler 镜像已配置"

验证：

gem sources -l

3.7 Conda 配置

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes
echo "✓ Conda 已配置为清华镜像"

验证：

conda config --show channels

3.8 Maven 配置

mkdir -p ~/.m2
cat > ~/.m2/settings.xml \x3C\x3C 'EOF'
\x3C?xml version="1.0" encoding="UTF-8"?>
\x3Csettings>
  \x3Cmirrors>
    \x3Cmirror>
      \x3Cid>aliyun\x3C/id>
      \x3CmirrorOf>central\x3C/mirrorOf>
      \x3Cname>Aliyun Maven\x3C/name>
      \x3Curl>https://maven.aliyun.com/repository/public\x3C/url>
    \x3C/mirror>
  \x3C/mirrors>
\x3C/settings>
EOF
echo "✓ Maven 已配置为阿里云镜像"

3.9 Gradle 配置

方式一：环境变量

# 添加到 init.gradle 或环境变量
echo 'GRADLE_USER_HOME=~/.gradle' >> ~/.bashrc
mkdir -p ~/.gradle/init.d
cat > ~/.gradle/init.d/mirror.init.gradle \x3C\x3C 'EOF'
allprojects {
    repositories {
        all { ArtifactRepository repo ->
            if (repo instanceof MavenArtifactRepository) {
                def url = repo.url.toString()
                if (url.startsWith("https://repo.maven.apache.org/maven2") ||
                    url.startsWith("https://jcenter.bintray.com")) {
                    project.logger.lifecycle "Repository ${repo.url} replaced with Tencent mirror."
                    remove repo
                }
            }
        }
        maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        mavenCentral()
    }
}
EOF
echo "✓ Gradle 已配置"

方式二：项目级 settings.gradle

dependencyResolutionManagement {
    repositories {
        maven { url = uri('https://mirrors.cloud.tencent.com/gradle/') }
        mavenCentral()
    }
}

3.10 Homebrew 配置 (macOS)

export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
echo "✓ Homebrew 已配置为中科大镜像"

3.11 Composer 配置 (PHP)

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
echo "✓ Composer 已配置为阿里云镜像"

Phase 4: 验证与反馈

4.1 执行验证命令

配置完成后，Agent 自动运行对应的验证命令（见各小节末尾），并向用户展示结果。

4.2 向用户报告

报告格式示例：
─────────────────────────────────────
✅ 配置完成！已为您配置以下镜像源：

  • pip (Python)     → 阿里云 ⚡ 0.02s
  • npm (Node.js)    → 华为云 ⚡ 0.04s  
  • cargo (Rust)     → 阿里云 ⚡ 0.05s

📋 下次操作建议：
  • 运行 pip install / npm install 测试速度
  • 如需恢复默认配置，请告知我
─────────────────────────────────────

常见问题处理（Agent 参考）

恢复默认配置命令速查

Agent 执行规范

1. 直接执行：不要创建脚本文件，直接运行 Shell 命令
2. 幂等性：配置命令可重复执行，不会产生副作用
3. 用户确认：修改前简要告知用户将要做什么
4. 错误处理：如果某个工具未安装，跳过并告知用户
5. 平台适配：自动检测操作系统，选择正确的命令格式（PowerShell vs Bash）