create-dwy 0.5.1 → 0.6.1

package/templates/claude-global/skills/dwy-mirror-source/SKILL.md

@@ -0,0 +1,275 @@
+---
+name: dwy-mirror-source
+description: "国内镜像源加速配置检查与修复：扫描 pip/uv/poetry/npm/pnpm/yarn/Docker/Go/Cargo/Maven/Gradle/Homebrew/Flutter 等 13 类工具的用户级和项目级配置，识别使用境外默认源或缺失配置的项，提供阿里云/清华/中科大镜像源切换。触发条件：用户说'检查镜像源'、'配置加速'、'换镜像源'、'mirror 检查'、'安装慢'、'下载慢' 时。"
+---
+
+# 镜像源加速配置（mirror-source）
+
+国内开发环境下，pip/npm/Docker 等工具默认境外源会让安装/拉取拖慢数倍甚至失败。本 skill 统一检查所有支持工具的镜像源配置，识别问题并辅助切换到国内加速源。
+
+**脚本目录：** `~/.claude/skills/dwy-mirror-source/scripts/`（以下简称 `{scripts}`）
+
+---
+
+## 强制原则
+
+1. **检查与修复分离** — 默认只检查输出报告，修复必须由用户**显式确认**。禁止自动改用户配置文件。
+2. **先 diff 后落盘** — 任何配置文件修改前必须输出 diff 让用户审阅。
+3. **保留私服配置** — 检测到企业内网私服（如 `nexus.company.com`、`pypi.internal`、`registry.company.com` 等非公网域名）时跳过修改，避免覆盖团队配置。
+4. **不自动重启 Docker daemon** — 修改 `daemon.json` 后只**提示**用户重启，禁止自动跑 `systemctl restart docker` / 重启 Docker Desktop。
+5. **不动 CI/CD 配置** — 本 skill 只处理本地开发环境，不修改 `.github/workflows/` / `.gitlab-ci.yml` 等。
+
+---
+
+## 默认首选镜像源
+
+**阿里云**（覆盖最全，BGP 多线，全国质量稳定）。
+
+可通过 `~/.claude/skills/dwy-mirror-source/preference.json` 修改：
+
+```json
+{
+  "preferred_provider": "aliyun"
+}
+```
+
+可选值：`aliyun` / `tsinghua` / `ustc`。详细 URL 表见 `references/mirror-providers.md`。
+
+---
+
+## 支持的工具范围
+
+| 类别 | 工具 | 用户级配置 | 项目级配置 |
+|------|------|-----------|-----------|
+| **Python** | pip | `~/.config/pip/pip.conf` 或 macOS 的 `~/Library/Application Support/pip/pip.conf` | — |
+| | uv（**双源**） | `~/.config/uv/uv.toml` 同时含 `[[index]]` + `python-install-mirror` | `pyproject.toml` 的 `[[tool.uv.index]]` |
+| | poetry | `~/Library/Application Support/pypoetry/auth.toml` 等 | `pyproject.toml` 的 `[[tool.poetry.source]]` |
+| **Node** | npm | `~/.npmrc` | `.npmrc` |
+| | pnpm | `~/.npmrc`（共用） | `.npmrc` |
+| | yarn | `~/.yarnrc.yml` 或 `~/.yarnrc` | 同名项目级文件 |
+| **Docker（双层）** | daemon registry-mirrors（**仅对 docker.io 生效**） | `~/.docker/daemon.json`（macOS Docker Desktop）/ `/etc/docker/daemon.json`（Linux） | — |
+| | gcr/ghcr/quay/k8s 等其他 registry 加速（必须改 image 引用） | 用户在 Dockerfile / k8s yaml 中直接换前缀 | 同左 |
+| **Go** | GOPROXY | `~/.config/go/env` 或 `~/Library/Application Support/go/env` | — |
+| **Rust** | cargo | `~/.cargo/config.toml` | `.cargo/config.toml` |
+| **JVM** | Maven | `~/.m2/settings.xml` | — |
+| | Gradle | `~/.gradle/init.gradle.kts` 或 `init.gradle` | — |
+| **macOS** | Homebrew | `git -C $(brew --repo) remote` + `HOMEBREW_BOTTLE_DOMAIN` | — |
+| **Flutter** | PUB_HOSTED_URL | `~/.zshrc` / `~/.bashrc` 环境变量 | — |
+
+**Linux 包管理（apt/apk/yum/dnf）** 不在自动检查范围。它们一般出现在 Dockerfile 内，是代码而非用户配置。如需在 Dockerfile 中换源，参考 `references/dockerfile-snippets.md`。
+
+---
+
+## 工作流
+
+### 模式 A：检查（check）
+
+用户说「检查镜像源」时执行。
+
+```bash
+python3 {scripts}/check_mirrors.py [--scope user|project|both] [--project-path .]
+```
+
+**默认行为**：扫描用户级 + 当前项目，输出分级报告。
+
+**状态分级：**
+
+| 状态 | 含义 | 处理 |
+|------|------|------|
+| ✅ ok | 已用国内推荐源 | 无需操作 |
+| ⚠️ warn | 用了官方默认源（境外） | 提示可切换 |
+| ⚠️ private | 用了企业私服 | 跳过，不动 |
+| ❌ missing | 工具已安装但无配置 | 提示创建 |
+| ➖ not_installed | 工具未安装 | 跳过 |
+
+输出示例：
+
+```
+=================== 镜像源检查报告 ===================
+[Python]
+  pip       (user)     ⚠️ warn      默认 PyPI    → 建议: aliyun
+  uv        (user)     ✅ ok        aliyun
+  uv        (project)  ➖ no_config  pyproject.toml 未声明 [[tool.uv.index]]
+
+[Node]
+  npm       (user)     ✅ ok        npmmirror.com
+  pnpm      (project)  ⚠️ warn      默认 registry → 建议: aliyun
+
+[Docker]
+  daemon                ❌ missing   ~/.docker/daemon.json 不存在 registry-mirrors
+
+...
+
+汇总: 13 项检查 / 5 项需修复 / 2 项私服跳过
+
+下一步: 让 Claude 帮你逐项修复，或运行
+  python3 apply_mirrors.py --dry-run
+```
+
+### 模式 B：修复（apply）
+
+用户确认后执行。**不允许在用户没看 diff 之前直接落盘**。
+
+```bash
+# 第一步：dry-run 输出 diff
+python3 {scripts}/apply_mirrors.py --dry-run [--tools pip,npm,docker] [--scope user]
+
+# 第二步：用户确认后落盘
+python3 {scripts}/apply_mirrors.py [--tools pip,npm,docker] [--scope user]
+```
+
+**参数：**
+- `--tools` — 逗号分隔的工具列表（`pip,uv,npm,pnpm,docker,go,cargo,maven,gradle,brew,flutter`），默认全部
+- `--scope` — `user` / `project` / `both`，默认 `both`
+- `--provider` — `aliyun` / `tsinghua` / `ustc`，默认读 preference.json
+- `--dry-run` — 只输出 diff，不写文件
+- `--project-path` — 项目级配置的根目录，默认当前目录
+
+**修复行为：**
+- 文件不存在 → 创建
+- 文件存在但缺字段 → 追加（保留其他配置）
+- 文件存在且字段已存在但是境外源 → 替换
+- 检测到私服 → 跳过该项，输出 `[skipped: private registry]`
+
+### 模式 C：诊断单个工具（debug）
+
+```bash
+python3 {scripts}/check_mirrors.py --only npm --verbose
+```
+
+输出该工具所有相关配置位置、当前值、解析结果，用于诊断「我配过了为什么还是慢」类问题。
+
+---
+
+## Claude 调用流程
+
+用户说「检查镜像源」/「配置加速」时：
+
+1. 跑 `check_mirrors.py` 输出报告
+2. 把报告里 `warn` / `missing` 项列出来给用户看
+3. 询问要修复哪些（默认全部 `warn` + `missing`，私服项不动）
+4. 跑 `apply_mirrors.py --dry-run --tools <user-selected>` 输出 diff
+5. 等用户确认 → 跑去掉 `--dry-run` 的版本写入
+6. 修改了 Docker daemon.json → 提示用户**重启 Docker**，本 skill 不自动重启
+7. 修改了 shell rc 文件（Flutter / Homebrew）→ 提示用户 `source ~/.zshrc` 或重开终端
+
+**禁止行为：**
+- ❌ 不询问就修改用户全局配置
+- ❌ 不输出 diff 就 apply
+- ❌ 自动跑 `systemctl restart docker` / `osascript -e 'quit app "Docker"'`
+- ❌ 替换企业私服 URL
+
+---
+
+## uv 镜像源（多层）
+
+uv 实际有 **3 个独立的镜像源**，缺一个都会拖慢：
+
+| 层 | 配置项 | 作用 | 国内推荐源 |
+|----|--------|------|-----------|
+| 1. 包索引 | `[[index]]` 或 `UV_DEFAULT_INDEX` | 装 PyPI 包 | `https://mirrors.aliyun.com/pypi/simple/` |
+| 2. **Python 解释器下载** ⭐ | `python-install-mirror` 或 `UV_PYTHON_INSTALL_MIRROR` | `uv python install 3.12` 时下载解释器 | `https://registry.npmmirror.com/-/binary/python-build-standalone` |
+| 3. PyPy 解释器下载 | `pypy-install-mirror` 或 `UV_PYPY_INSTALL_MIRROR` | 下载 PyPy 解释器 | 国内**无可用镜像**，保留默认 |
+
+**关键点：** 第 2 层（Python 解释器）默认走 `github.com/astral-sh/python-build-standalone/releases`，国内不挂代理几乎无法下载。这是 `uv venv --python 3.12` 卡住的常见原因。
+
+完整 `~/.config/uv/uv.toml` 示例：
+
+```toml
+python-install-mirror = "https://registry.npmmirror.com/-/binary/python-build-standalone"
+
+[[index]]
+url = "https://mirrors.aliyun.com/pypi/simple/"
+default = true
+```
+
+`apply_mirrors.py --tools uv` 会同时写入这两层。第 3 层 PyPy 不强制配置（国内无源）。
+
+---
+
+## Docker 镜像源（多层）
+
+Docker 镜像加速分**两类，互不替代**：
+
+### 类型 1：docker.io 加速 — `registry-mirrors`
+
+唯一作用于 `docker.io`（Docker Hub）。配置在 `~/.docker/daemon.json`：
+
+```json
+{
+  "registry-mirrors": [
+    "https://docker.m.daocloud.io",
+    "https://docker.mirrors.ustc.edu.cn"
+  ]
+}
+```
+
+`apply_mirrors.py --tools docker` 自动配置这一层。
+
+### 类型 2：gcr / ghcr / quay / k8s 等加速 — 改 image 引用
+
+**`registry-mirrors` 字段对它们完全无效**。必须把 image 名改前缀域名：
+
+| 源 registry | 镜像域名 | 用途 |
+|-------------|---------|------|
+| `gcr.io` | `gcr.m.daocloud.io` | Google Container Registry |
+| `ghcr.io` | `ghcr.m.daocloud.io` | GitHub Container Registry |
+| `quay.io` | `quay.m.daocloud.io` | Red Hat Quay |
+| `registry.k8s.io` | `k8s.m.daocloud.io` | Kubernetes 当前官方 registry |
+| `k8s.gcr.io` | `k8s-gcr.m.daocloud.io` | Kubernetes 旧仓库 |
+| `mcr.microsoft.com` | `mcr.m.daocloud.io` | Microsoft Container Registry |
+| `nvcr.io` | `nvcr.m.daocloud.io` | NVIDIA Container Registry |
+| `docker.elastic.co` | `elastic.m.daocloud.io` | Elastic 官方镜像 |
+| `registry.ollama.ai` | `ollama.m.daocloud.io` | Ollama 模型 |
+
+完整列表见 `references/mirror-providers.md`。
+
+**用法：**
+
+```bash
+# 原本（国内拉不动）
+docker pull gcr.io/google-containers/pause:3.9
+docker pull ghcr.io/astral-sh/uv:0.5.0
+
+# 改前缀域名走加速
+docker pull gcr.m.daocloud.io/google-containers/pause:3.9
+docker pull ghcr.m.daocloud.io/astral-sh/uv:0.5.0
+```
+
+```dockerfile
+# Dockerfile 同理
+FROM ghcr.m.daocloud.io/astral-sh/uv:0.5.0 AS uv
+FROM gcr.m.daocloud.io/distroless/python3:nonroot
+```
+
+**为什么不能自动配置？** 这层加速无法在 daemon.json 实现透明代理，必须显式改 image 字符串。Claude 在用户写 Dockerfile / k8s yaml 时，如发现使用了 gcr/ghcr/quay 等域名，**应主动提示**改前缀（可与 dwy-docker-image skill 协同：固定 tag 时一并替换 registry 域名）。
+
+> 提示：containerd（不是 Docker）支持 `[plugins."io.containerd.grpc.v1.cri".registry.mirrors]` 全局映射；Kubernetes 节点用 containerd 时可写到 `/etc/containerd/config.toml` 实现透明代理。Docker 引擎本身不支持。
+
+---
+
+## 与其他 skill 的关系
+
+- **dwy-docker-image**：固定镜像版本（FROM 指令的 tag）
+- **本 skill**：配置 docker pull 时走哪个 registry mirror
+- **dwy-deploy-audit**：检查生产服务器的镜像源配置
+
+三者协作：本地用 dwy-mirror-source 配好镜像加速 → 写代码用 dwy-docker-image 固定 tag → 部署后用 dwy-deploy-audit 检查线上
+
+---
+
+## 违规检测速查
+
+| 检测项 | 严重程度 | 说明 |
+|--------|---------|------|
+| Python pip 用 `pypi.org/simple` 默认源 | warn | 改 `mirrors.aliyun.com/pypi/simple/` |
+| uv 缺 `python-install-mirror` | warn | `uv python install` 卡顿，添加 npmmirror 二进制源 |
+| uv 用了不稳定 GitHub 代理（如 ghfast/gh-proxy） | warn | 改用更稳定的 npmmirror.com/-/binary |
+| npm/pnpm 用 `registry.npmjs.org` | warn | 改 `registry.npmmirror.com` |
+| Docker 无 `registry-mirrors` | warn | 添加 `docker.m.daocloud.io` |
+| Dockerfile / k8s 用 `gcr.io/...`、`ghcr.io/...`、`registry.k8s.io/...` | warn | 改前缀为 `gcr.m.daocloud.io/...` 等（改 image 字符串） |
+| Go 未设 GOPROXY 或为 `direct` | warn | 改 `https://goproxy.cn,direct` |
+| Maven 默认 Central | warn | 添加 aliyun mirror |
+| Cargo 默认 crates.io | warn | 改 `rsproxy.cn` |
+| 用 npm registry 但没用 https | high | 安全问题，强制换 https |
+| 镜像源 URL 已弃用（如 `npm.taobao.org`） | high | 已 EOL，必须迁移到 npmmirror.com |

package/templates/claude-global/skills/dwy-mirror-source/references/dockerfile-snippets.md

@@ -0,0 +1,228 @@
+# Dockerfile 内换源代码片段
+
+Linux 包管理（apt/apk/yum/dnf）和 Python pip 在 Dockerfile 内的换源代码片段。这些是**镜像构建时**的源，与本机用户配置无关，需要写到 Dockerfile 里。
+
+## 通用原则
+
+1. **基础镜像确定后再换源** — 不同 base image 用不同包管理（Ubuntu/Debian 用 apt，Alpine 用 apk，CentOS/RockyLinux 用 yum/dnf）
+2. **多阶段构建只在需要安装包的阶段换** — 最终运行阶段如果不装包，不必加这些
+3. **CI/CD 镜像构建可能不需要换源** — 部分 CI 已在境内或自建 mirror，按团队约定
+
+---
+
+## Debian / Ubuntu (apt)
+
+### Ubuntu 22.04 / 24.04（Noble / Jammy）
+
+Ubuntu 24.04 起 sources.list 改为 deb822 格式（`/etc/apt/sources.list.d/ubuntu.sources`），22.04 仍是老格式。
+
+```dockerfile
+# Ubuntu 22.04 (jammy)
+RUN sed -i 's|http://archive.ubuntu.com/ubuntu/|https://mirrors.aliyun.com/ubuntu/|g; \
+            s|http://security.ubuntu.com/ubuntu/|https://mirrors.aliyun.com/ubuntu/|g' \
+        /etc/apt/sources.list \
+    && apt-get update
+```
+
+```dockerfile
+# Ubuntu 24.04 (noble)
+RUN sed -i 's|http://archive.ubuntu.com/ubuntu/|https://mirrors.aliyun.com/ubuntu/|g; \
+            s|http://security.ubuntu.com/ubuntu/|https://mirrors.aliyun.com/ubuntu/|g' \
+        /etc/apt/sources.list.d/ubuntu.sources \
+    && apt-get update
+```
+
+### Debian 11 / 12（Bullseye / Bookworm）
+
+Debian 12 起也用了 deb822 格式（`/etc/apt/sources.list.d/debian.sources`）。
+
+```dockerfile
+# Debian 11 (bullseye)
+RUN sed -i 's|http://deb.debian.org|https://mirrors.aliyun.com|g; \
+            s|http://security.debian.org|https://mirrors.aliyun.com/debian-security|g' \
+        /etc/apt/sources.list \
+    && apt-get update
+```
+
+```dockerfile
+# Debian 12 (bookworm)
+RUN sed -i 's|http://deb.debian.org|https://mirrors.aliyun.com|g' \
+        /etc/apt/sources.list.d/debian.sources \
+    && apt-get update
+```
+
+---
+
+## Alpine (apk)
+
+```dockerfile
+RUN sed -i 's|https://dl-cdn.alpinelinux.org|https://mirrors.aliyun.com|g' \
+        /etc/apk/repositories \
+    && apk update
+```
+
+---
+
+## CentOS / RockyLinux / AlmaLinux (yum / dnf)
+
+### RockyLinux 9 / AlmaLinux 9
+
+```dockerfile
+RUN sed -e 's|^mirrorlist=|#mirrorlist=|g' \
+        -e 's|^#baseurl=http://dl.rockylinux.org/$contentdir|baseurl=https://mirrors.aliyun.com/rockylinux|g' \
+        -i.bak /etc/yum.repos.d/rocky-*.repo \
+    && dnf clean all
+```
+
+### CentOS 7（已 EOL，仍有遗留）
+
+```dockerfile
+RUN curl -o /etc/yum.repos.d/CentOS-Base.repo \
+        https://mirrors.aliyun.com/repo/Centos-7.repo \
+    && yum clean all && yum makecache
+```
+
+---
+
+## Python pip 在 Dockerfile 内
+
+不依赖容器内 `~/.config/pip/pip.conf`，直接在 RUN 命令中指定 `-i`：
+
+```dockerfile
+RUN pip install --no-cache-dir -i https://mirrors.aliyun.com/pypi/simple/ \
+        --trusted-host mirrors.aliyun.com \
+        -r requirements.txt
+```
+
+或写到环境变量供后续 RUN 沿用：
+
+```dockerfile
+ENV PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
+ENV PIP_TRUSTED_HOST=mirrors.aliyun.com
+RUN pip install --no-cache-dir -r requirements.txt
+```
+
+---
+
+## uv 在 Dockerfile 内
+
+```dockerfile
+ENV UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
+RUN uv pip install --system -r requirements.txt
+```
+
+---
+
+## Node 在 Dockerfile 内
+
+```dockerfile
+RUN npm config set registry https://registry.npmmirror.com \
+    && npm install --production
+```
+
+或 pnpm：
+
+```dockerfile
+RUN pnpm config set registry https://registry.npmmirror.com \
+    && pnpm install --frozen-lockfile
+```
+
+---
+
+## Go 在 Dockerfile 内
+
+```dockerfile
+ENV GOPROXY=https://goproxy.cn,direct
+RUN go mod download
+```
+
+---
+
+## Rust / Cargo 在 Dockerfile 内
+
+```dockerfile
+RUN mkdir -p ~/.cargo \
+    && echo '[source.crates-io]'                                  >  ~/.cargo/config.toml \
+    && echo 'replace-with = "rsproxy-sparse"'                     >> ~/.cargo/config.toml \
+    && echo ''                                                    >> ~/.cargo/config.toml \
+    && echo '[source.rsproxy-sparse]'                             >> ~/.cargo/config.toml \
+    && echo 'registry = "sparse+https://rsproxy.cn/index/"'       >> ~/.cargo/config.toml
+```
+
+---
+
+## Maven 在 Dockerfile 内
+
+```dockerfile
+COPY <<'EOF' /root/.m2/settings.xml
+<settings>
+  <mirrors>
+    <mirror>
+      <id>aliyun</id>
+      <mirrorOf>*</mirrorOf>
+      <url>https://maven.aliyun.com/repository/public</url>
+    </mirror>
+  </mirrors>
+</settings>
+EOF
+```
+
+---
+
+## 完整组合示例：Python 后端镜像
+
+```dockerfile
+FROM python:3.12-slim-bookworm
+
+# 1. apt 换源
+RUN sed -i 's|http://deb.debian.org|https://mirrors.aliyun.com|g' \
+        /etc/apt/sources.list.d/debian.sources \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends gcc libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# 2. pip 换源
+ENV PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ \
+    PIP_TRUSTED_HOST=mirrors.aliyun.com
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+CMD ["python", "main.py"]
+```
+
+---
+
+## 完整组合示例：Node 前端镜像
+
+```dockerfile
+FROM node:20.18.0-bookworm-slim AS builder
+
+# 1. apt 换源（可选，build stage 用得多就加）
+RUN sed -i 's|http://deb.debian.org|https://mirrors.aliyun.com|g' \
+        /etc/apt/sources.list.d/debian.sources
+
+# 2. pnpm 换源
+RUN corepack enable && pnpm config set registry https://registry.npmmirror.com
+
+WORKDIR /app
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile
+
+COPY . .
+RUN pnpm build
+
+FROM nginx:1.26.2-alpine
+COPY --from=builder /app/dist /usr/share/nginx/html
+```
+
+---
+
+## 注意事项
+
+1. **不要在 Dockerfile 里写 `latest` 镜像 tag** — 见 `dwy-docker-image` skill
+2. **`--trusted-host` 仅在 http 镜像源时需要** — https 镜像不需要这个参数，但加上无害
+3. **多阶段构建复制配置** — 如果 builder 阶段配了源，runtime 阶段需要再配一次（不会自动继承）
+4. **生产构建不要把 token / 私服密码写进 Dockerfile** — 用 BuildKit secrets 或 build-args

package/templates/claude-global/skills/dwy-mirror-source/references/mirror-providers.md

@@ -0,0 +1,150 @@
+# 镜像源 URL 对照表
+
+各加速服务的 URL 由 `check_mirrors.py` / `apply_mirrors.py` 中的 `MIRRORS` 字典维护。本文件作为**人类可读的索引**，便于审阅、迁移、扩展新工具。
+
+如需更新 URL，请同时改脚本里的 `MIRRORS` 字典和本文档，保持一致。
+
+## 默认推荐：阿里云
+
+阿里云覆盖最全、BGP 多线、对外网无依赖、稳定性高，故作默认。
+
+| 工具 | URL | 说明 |
+|------|-----|------|
+| pip | `https://mirrors.aliyun.com/pypi/simple/` | PyPI 镜像 |
+| uv | `https://mirrors.aliyun.com/pypi/simple/` | 与 pip 共用 |
+| poetry | `https://mirrors.aliyun.com/pypi/simple/` | 同上 |
+| npm | `https://registry.npmmirror.com` | npmmirror（原 npm.taobao 已迁移） |
+| pnpm | `https://registry.npmmirror.com` | 共用 |
+| yarn | `https://registry.npmmirror.com` | 共用 |
+| Docker | `https://docker.m.daocloud.io` | DaoCloud 加速器，免登录 |
+| Go (GOPROXY) | `https://goproxy.cn,direct` | 七牛云维护 |
+| Cargo | `sparse+https://rsproxy.cn/index/` | 字节跳动维护 |
+| Maven | `https://maven.aliyun.com/repository/public` | 综合公共仓库 |
+| Gradle plugin | `https://maven.aliyun.com/repository/gradle-plugin` | gradle 插件库 |
+| Homebrew brew.git | `https://mirrors.aliyun.com/homebrew/brew.git` | brew 仓库 |
+| Homebrew core | `https://mirrors.aliyun.com/homebrew/homebrew-core.git` | core formulae |
+| Homebrew bottles | `https://mirrors.aliyun.com/homebrew/homebrew-bottles` | 二进制包 |
+| Flutter PUB | `https://pub.flutter-io.cn` | flutter pub |
+| Flutter STORAGE | `https://storage.flutter-io.cn` | flutter SDK |
+
+## 备选：清华 TUNA
+
+教育网友好，混合源最完整。Homebrew 上清华源比阿里维护更新更勤。
+
+| 工具 | URL |
+|------|-----|
+| pip | `https://pypi.tuna.tsinghua.edu.cn/simple` |
+| npm | `https://registry.npmmirror.com`（清华无 npm 镜像，回退 npmmirror） |
+| Docker | `https://docker.m.daocloud.io`（清华无 docker 镜像，回退 daocloud） |
+| Go | `https://goproxy.cn,direct`（清华无 GOPROXY，回退 goproxy.cn） |
+| Cargo | `sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/` |
+| Maven | `https://maven.aliyun.com/repository/public`（清华无 maven，回退 aliyun） |
+| Homebrew brew.git | `https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git` |
+| Homebrew core | `https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git` |
+| Homebrew bottles | `https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles` |
+| Flutter PUB | `https://pub.flutter-io.cn`（沿用） |
+
+## 备选：中科大 USTC
+
+| 工具 | URL |
+|------|-----|
+| pip | `https://mirrors.ustc.edu.cn/pypi/simple/` |
+| npm | `https://registry.npmmirror.com` |
+| Docker | `https://docker.m.daocloud.io` |
+| Go | `https://goproxy.cn,direct` |
+| Cargo | `sparse+https://mirrors.ustc.edu.cn/crates.io-index/` |
+| Maven | `https://maven.aliyun.com/repository/public` |
+| Homebrew brew.git | `https://mirrors.ustc.edu.cn/brew.git` |
+| Homebrew core | `https://mirrors.ustc.edu.cn/homebrew-core.git` |
+| Homebrew bottles | `https://mirrors.ustc.edu.cn/homebrew-bottles` |
+| Flutter PUB | `https://pub.flutter-io.cn` |
+
+## 已弃用（必须迁移）
+
+| 旧 URL | 状态 | 替代 |
+|--------|------|------|
+| `https://registry.npm.taobao.org` | 2022-05 已停止维护，证书过期 | `https://registry.npmmirror.com` |
+| `https://registry.npmjs.cf` | 已停止 | `https://registry.npmmirror.com` |
+| `https://mirrors.aliyun.com/pypi/`（无 `simple/`）| 路径错误 | `https://mirrors.aliyun.com/pypi/simple/` |
+| `http://...` 任何镜像源 | 不安全 | 一律 `https://` |
+
+## Docker 加速器（重点）
+
+Docker 镜像加速分**两类**，互不替代：
+
+### 类型 1：docker.io 加速（registry-mirrors）
+
+仅作用于 Docker Hub（`docker.io`）。配置在 `~/.docker/daemon.json`：
+
+```json
+{
+  "registry-mirrors": [
+    "https://docker.m.daocloud.io",
+    "https://docker.mirrors.ustc.edu.cn"
+  ]
+}
+```
+
+可选加速器：
+
+| 加速器 | URL | 备注 |
+|--------|-----|------|
+| DaoCloud | `https://docker.m.daocloud.io` | **首选**，免登录、稳定 |
+| 中科大 | `https://docker.mirrors.ustc.edu.cn` | 高校镜像 |
+| 网易 | `https://hub-mirror.c.163.com` | 偶尔波动 |
+| 阿里云专属 | `https://<your-id>.mirror.aliyuncs.com` | 阿里云用户专属，需登录获取 |
+| 腾讯云 | `https://mirror.ccs.tencentyun.com` | 仅腾讯云内网 |
+
+### 类型 2：非 docker.io registry 加速
+
+**`registry-mirrors` 字段对 gcr/ghcr/quay/k8s/mcr/nvcr 等其他 registry 完全无效**。要加速这类 image，必须**改 image 引用本身**。
+
+DaoCloud 维护的 11 个 registry 镜像（实测全部可达）：
+
+| 源 registry | 镜像域名 | 用途 |
+|-------------|---------|------|
+| `docker.io` | `docker.m.daocloud.io` | Docker Hub（也可走 registry-mirrors） |
+| `gcr.io` | `gcr.m.daocloud.io` | Google Container Registry |
+| `ghcr.io` | `ghcr.m.daocloud.io` | GitHub Container Registry |
+| `quay.io` | `quay.m.daocloud.io` | Red Hat Quay |
+| `k8s.gcr.io` | `k8s-gcr.m.daocloud.io` | Kubernetes 旧仓库（已迁出） |
+| `registry.k8s.io` | `k8s.m.daocloud.io` | Kubernetes 当前官方 registry |
+| `mcr.microsoft.com` | `mcr.m.daocloud.io` | Microsoft Container Registry |
+| `nvcr.io` | `nvcr.m.daocloud.io` | NVIDIA Container Registry |
+| `docker.elastic.co` | `elastic.m.daocloud.io` | Elastic 官方镜像 |
+| `dhi.io` | `dhi.m.daocloud.io` | Docker Hub Images |
+| `registry.ollama.ai` | `ollama.m.daocloud.io` | Ollama 模型（beta） |
+
+**用法示例：**
+
+```bash
+# 原本（拉不动）
+docker pull gcr.io/google-containers/pause:3.9
+docker pull ghcr.io/astral-sh/uv:latest
+docker pull registry.k8s.io/kube-apiserver:v1.30.0
+
+# 走加速（改前缀域名）
+docker pull gcr.m.daocloud.io/google-containers/pause:3.9
+docker pull ghcr.m.daocloud.io/astral-sh/uv:0.5.0
+docker pull k8s.m.daocloud.io/kube-apiserver:v1.30.0
+```
+
+```dockerfile
+# Dockerfile 内同样改前缀
+FROM ghcr.m.daocloud.io/astral-sh/uv:0.5.0 AS uv
+FROM gcr.m.daocloud.io/distroless/python3:nonroot
+```
+
+**关键限制：**
+- 这套加速**不能配在 daemon.json 里实现透明代理**（registry-mirrors 字段只识别 docker.io）
+- 必须显式写入 image 引用，无法自动改写
+- containerd / Kubernetes 可以用 `mirrors` 配置全局映射，但 Docker 不行
+
+## 私服识别规则
+
+`check_mirrors.py` 检测到以下模式时识别为企业私服，**不修改**：
+
+- 域名包含 `nexus`、`artifactory`、`harbor`、`internal`、`corp`、`company`、`pypi.local`、`registry.local`
+- IP 地址形式（不论公网还是内网）
+- 端口 `8081`、`8082`、`5000`（Nexus / Harbor 常见端口）
+- 路径包含 `/repository/`（Nexus 标志路径）