# 软件镜像源对照表

本文档记录了各软件在不同镜像设置下的版本列表获取源和下载源。

## 总览

| 软件 | 镜像选项 | 选项值 | 版本列表获取源 | 下载源 |
|------|----------|--------|----------------|--------|
| Node.js | 华为云镜像 | `huaweicloud` | mirrors.huaweicloud.com | mirrors.huaweicloud.com |
| Node.js | 官方 | `official` | nodejs.org | nodejs.org |
| VS Code | Azure 中国 CDN | `azure-china` | update.code.visualstudio.com | vscode.cdn.azure.cn |
| VS Code | 官方 | `official` | update.code.visualstudio.com | code.visualstudio.com |
| Git | 华为云镜像 | `huaweicloud` | mirrors.huaweicloud.com | mirrors.huaweicloud.com |
| Git | GitHub 官方 | `github` | api.github.com | github.com |

## 详细说明

### Node.js

| 镜像选项 | 选项值 | 版本列表 API | 下载 URL 模板 |
|----------|--------|--------------|---------------|
| 华为云镜像（国内推荐） | `huaweicloud` | `https://mirrors.huaweicloud.com/nodejs/index.json` | `https://mirrors.huaweicloud.com/nodejs/{version}/node-{version}-x64.msi` |
| Node.js 官方 | `official` | `https://nodejs.org/dist/index.json` | `https://nodejs.org/dist/{version}/node-{version}-x64.msi` |

**说明**：
- 版本列表和下载源完全对应镜像设置
- 华为云镜像同步自 Node.js 官方，提供 JSON 格式的版本列表

### VS Code

| 镜像选项 | 选项值 | 版本列表 API | 下载 URL |
|----------|--------|--------------|----------|
| Azure 中国 CDN（国内推荐） | `azure-china` | `https://update.code.visualstudio.com/api/releases/stable` | `https://vscode.cdn.azure.cn/stable/{commit_hash}/VSCodeSetup-x64-{version}.exe` |
| VS Code 官方 | `official` | `https://update.code.visualstudio.com/api/releases/stable` | `https://code.visualstudio.com/sha/download?build=stable&os=win32-x64` |

**说明**：
- 版本列表 API 只有一个源（微软官方 update.code.visualstudio.com），因为 Azure 中国 CDN 没有提供版本列表 API
- 两个下载源都是微软的服务：
  - `update.code.visualstudio.com` - 微软官方更新 API 服务
  - `code.visualstudio.com` - 微软官方下载站
  - `vscode.cdn.azure.cn` - 微软 Azure 中国 CDN
- Azure 中国 CDN 下载需要先从官方 API 获取 commit_hash 和 version，然后拼接下载 URL

### Git

| 镜像选项 | 选项值 | 版本列表获取方式 | 下载 URL 模板 |
|----------|--------|------------------|---------------|
| 华为云镜像（国内推荐） | `huaweicloud` | 解析 `https://mirrors.huaweicloud.com/git-for-windows/` 页面 HTML | `https://mirrors.huaweicloud.com/git-for-windows/v{version}.windows.1/Git-{version}-64-bit.exe` |
| GitHub 官方（需代理） | `github` | `https://api.github.com/repos/git-for-windows/git/releases` | 从 GitHub Releases API 获取 `browser_download_url` |

**说明**：
- 华为云镜像没有提供 JSON 格式的版本列表，需要解析 HTML 目录页面提取版本号
- GitHub 官方使用 GitHub Releases API 获取版本列表和下载链接
- 如果版本列表获取失败，会使用预设的备用版本列表

## 缓存机制

前端按 `软件类型:镜像源` 格式缓存版本列表数据，例如：
- `nodejs:huaweicloud`
- `nodejs:official`
- `vscode:azure-china`
- `git:github`

缓存特性：
- 内存缓存，应用关闭后清除
- 切换镜像时，如果目标镜像已有缓存，直接使用缓存数据
- 可通过 `forceRefresh` 参数强制刷新

## 默认配置

| 软件 | 默认镜像 |
|------|----------|
| Node.js | 华为云镜像 (`huaweicloud`) |
| VS Code | Azure 中国 CDN (`azure-china`) |
| Git | 华为云镜像 (`huaweicloud`) |

默认配置针对国内用户优化，选择访问速度较快的镜像源。