Skill: lm203688/china-dev-environment (version 1.0.0)

--- name: china-dev-environment description: "Configure development environments for Chinese developers. Teach AI agents how to set up mirrors, proxies, and alternative services for npm/pip/Docker/GitHub/Google that work behind the Great Firewall. Covers: npm/pip/Docker mirror configuration, GitHub acceleration, Google API replacement, VPN/proxy setup for dev tools, and China-friendly project templates. Triggers on: 中国开发者环境, china dev environment, npm镜像, npm mirror, pip镜像, pip mirror, Docker镜像, docker mirror china, GitHub加速, github acceleration, 国内开发环境, china development setup, 翻墙开发, GFW workaround, 中国npm, china npm registry, 开发者代理, developer proxy, 国内Docker, china docker registry" --- # China Dev Environment - 中国开发者环境配置专家 You are an expert at configuring development environments that work reliably in China. You know every mirror, proxy, and alternative service that keeps Chinese developers productive behind the Great Firewall. ## Core Philosophy **A developer in China who can't `npm install` is a developer who can't work.** Your job is to make every package manager, every registry, every cloud service work smoothly — without VPN if possible, with minimal VPN if not. ## Registry Mirrors ### npm (Node.js) ```bash # Set China npm mirror (淘宝镜像) npm config set registry https://registry.npmmirror.com # Or use nrm to switch between mirrors npm install -g nrm nrm use taobao # Verify npm config get registry # Should show: https://registry.npmmirror.com/ # For specific packages not on mirror npm install package-name --registry=https://registry.npmjs.org ``` ### pip (Python) ```bash # Set Tsinghua PyPI mirror (most reliable) pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn # Alternative mirrors # Aliyun: https://mirrors.aliyun.com/pypi/simple/ # Douban: https://pypi.doubanio.com/simple/ # USTC: https://pypi.mirrors.ustc.edu.cn/simple/ # Temporary use pip install package -i https://pypi.tuna.tsinghua.edu.cn/simple ``` ### Docker ```bash # Configure Docker mirror (daemon.json) sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json << 'EOF' { "registry-mirrors": [ "https://docker.1ms.run", "https://docker.xuanyuan.me", "https://docker.m.daocloud.io" ] } EOF sudo systemctl daemon-reload sudo systemctl restart docker # Pull image through mirror docker pull nginx # Will use mirror automatically # For images not on mirror, use proxy # docker pull --platform linux/amd64 nginx ``` ### Maven (Java) ```xml <!-- settings.xml mirror configuration --> <mirrors> <mirror> <id>aliyun</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/central</url> </mirror> </mirrors> ``` ### Go ```bash # Set Go module proxy go env -w GOPROXY=https://goproxy.cn,direct go env -w GONOSUMCHECK=gitlab.company.com # Alternative: https://goproxy.io ``` ### Rust / Cargo ```toml # ~/.cargo/config.toml [source.crates-io] replace-with = "ustc" [source.ustc] registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/" ``` ## GitHub Acceleration ### Method 1: Mirror Sites ```bash # Clone via mirror git clone https://ghproxy.com/https://github.com/user/repo.git git clone https://mirror.ghproxy.com/https://github.com/user/repo.git # Or set URL rewrite git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/" ``` ### Method 2: SSH with Proxy ```bash # ~/.ssh/config Host github.com HostName github.com User git ProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p ``` ### Method 3: Gitee Import ```bash # Import to Gitee first, then clone from Gitee # https://gitee.com/projects/import/url ``` ### Method 4: GitHub Codespaces ```bash # Use GitHub Codespaces (works from China) gh codespace create -r owner/repo gh codespace ssh ``` ## Google API Replacements | Google Service | China Replacement | Setup | |---------------|-------------------|-------| | Google Fonts | fonts.font.im | Replace `fonts.googleapis.com` → `fonts.font.im` | | Google Analytics | Baidu Tongji | `hm.baidu.com/hm.js?xxx` | | Google Maps | Amap/Gaode | `webapi.amap.com/maps?v=2.0` | | reCAPTCHA | Tencent Captcha | `captcha.tencentcloudapi.com` | | Firebase | Tencent CloudBase | `tcb-api.tencentcloudapi.com` | | Google Search | Baidu SEO | Submit at `ziyuan.baidu.com` | | Google Cloud Storage | COS/OSS | Use Tencent/Alibaba SDK | | Gmail SMTP | Aliyun DirectMail | `dm.aliyuncs.com` | ## Workflow 1: New Project Bootstrap (China Edition) ```bash #!/bin/bash # china-project-init.sh — Bootstrap a new project that works in China echo "🔧 Setting up China-friendly dev environment..." # 1. Configure package managers npm config set registry https://registry.npmmirror.com pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple go env -w GOPROXY=https://goproxy.cn,direct # 2. Create .npmrc for project cat > .npmrc << 'EOF' registry=https://registry.npmmirror.com # For packages that fail on mirror, fallback to official # package-name:registry=https://registry.npmjs.org EOF # 3. Create .pip.conf for project mkdir -p ~/.pip cat > ~/.pip/pip.conf << 'EOF' [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn EOF # 4. Docker mirror (if Docker installed) if command -v docker &> /dev/null; then sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json << 'DOCKER' { "registry-mirrors": ["https://docker.1ms.run"] } DOCKER sudo systemctl restart docker fi # 5. Git config for GitHub acceleration git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/" echo "✅ China dev environment configured!" ``` ## Workflow 2: Fix Broken Dependencies When `npm install` or `pip install` fails in China: ```bash # npm: Clear cache and retry with mirror npm cache clean --force rm -rf node_modules package-lock.json npm install --registry=https://registry.npmmirror.com # pip: Clear cache and retry pip cache purge pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple # Docker: Pull with explicit mirror docker pull registry.npmmirror.com/library/nginx:latest docker tag registry.npmmirror.com/library/nginx:latest nginx:latest # Go: Clear module cache go clean -modcache GOPROXY=https://goproxy.cn,direct go mod download ``` ## Workflow 3: CI/CD Pipeline (China) ```yaml # GitHub Actions with China mirrors name: CI China on: [push] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 # Use China npm mirror - run: npm config set registry https://registry.npmmirror.com # Use China pip mirror - run: pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - run: npm ci - run: npm test # Deploy to China cloud - run: npx tccli scf UpdateFunctionCode ... ``` ## Safety Rules 1. **Never commit proxy credentials** — use environment variables 2. **Mirror reliability** — npmmirror.com is backed by Alibaba, most reliable 3. **Security** — official mirrors are safe; unknown mirrors may inject code 4. **Sync delay** — mirrors may lag by minutes to hours; for latest packages, use official registry 5. **Binary packages** — native modules (node-gyp) may still fail; prebuild binaries often unavailable on mirrors 6. **Test without VPN** — always verify your setup works without VPN, as most Chinese devs don't have one ## Quick Reference | Tool | Mirror | Official | |------|--------|----------| | npm | npmmirror.com | npmjs.org | | pip | pypi.tuna.tsinghua.edu.cn | pypi.org | | Docker | docker.1ms.run | hub.docker.com | | Maven | maven.aliyun.com | repo1.maven.org | | Go | goproxy.cn | proxy.golang.org | | Rust | mirrors.ustc.edu.cn | crates.io | | GitHub | ghproxy.com | github.com |


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)