fix: harden proxied client installation

distribution/agent-install.template.md

@@ -14,10 +14,16 @@
 - 公钥编号：`{{RELEASE_KEY_ID}}`
 - 签名清单：`{{MANIFEST_URL}}`
 - 清单签名：`{{MANIFEST_SIGNATURE_URL}}`
+- 国内备用发布源：
+{{DOWNLOAD_MIRROR_BASE_URLS_MARKDOWN}}
 - 统一网关：`{{GATEWAY_URL}}`
 - Windows 安装引导：`{{BOOTSTRAP_WINDOWS_URL}}`
+- Windows 安装引导备用地址：
+{{BOOTSTRAP_WINDOWS_MIRROR_URLS_MARKDOWN}}
 - Windows 安装引导 SHA-256：`{{BOOTSTRAP_WINDOWS_SHA256}}`
 - Linux/macOS 安装引导：`{{BOOTSTRAP_POSIX_URL}}`
+- Linux/macOS 安装引导备用地址：
+{{BOOTSTRAP_POSIX_MIRROR_URLS_MARKDOWN}}
 - Linux/macOS 安装引导 SHA-256：`{{BOOTSTRAP_POSIX_SHA256}}`
 - 私有 Node.js：`{{NODE_VERSION}}`（最低兼容版本 `{{NODE_MINIMUM_VERSION}}`）
 
@@ -51,6 +57,8 @@
 
 为执行平台安装引导的 Agent 工具调用设置至少 10 分钟超时。引导和安装器会把 `[dingtalk-approval]` 开头的阶段进度写入 stderr，把唯一的最终结果 JSON 写入 stdout；进度文本不是失败，也不能混入 JSON 解析。进程仍在运行时不得并发启动第二次安装。
 
+如果当前环境通过 `HTTPS_PROXY`、`HTTP_PROXY` 或 `ALL_PROXY` 出网，安装引导会在兼容 Node 上自动为下载、登录和 Bridge 启用环境代理，并在离线 npm 展开前隔离 Node 的代理开关。不要设置全局 `NODE_OPTIONS=--use-env-proxy`，也不要手工预装 `node_modules`；这会让 npm 与 Node 的代理机制叠加，并破坏安装器的原子安装与故障恢复。
+
 ### Windows（PowerShell）
 
 无论当前 Agent 默认使用 PowerShell、CMD 还是 Git Bash，Windows 都必须调用普通 PowerShell 执行下面的完整流程。不得从 Git Bash 直接运行内部的 `node dingtalk-approval-installer.mjs ...` 命令；内部安装器不是用户安装入口。
@@ -61,9 +69,20 @@
 $dingBootstrapDir = Join-Path ([System.IO.Path]::GetTempPath()) ("dingmcp-bootstrap-" + [guid]::NewGuid().ToString("N"))
 New-Item -ItemType Directory -Path $dingBootstrapDir -Force | Out-Null
 $dingBootstrap = Join-Path $dingBootstrapDir "dingtalk-approval-bootstrap.ps1"
-Invoke-WebRequest -UseBasicParsing -Uri "{{BOOTSTRAP_WINDOWS_URL}}" -OutFile $dingBootstrap
-$dingBootstrapHash = (Get-FileHash -Algorithm SHA256 $dingBootstrap).Hash.ToLowerInvariant()
-if ($dingBootstrapHash -ne "{{BOOTSTRAP_WINDOWS_SHA256}}") { throw "Windows 安装引导 SHA-256 不匹配，停止安装" }
+$dingBootstrapUrls = @({{BOOTSTRAP_WINDOWS_URLS_POWERSHELL}})
+$dingBootstrapDownloaded = $false
+foreach ($dingBootstrapUrl in $dingBootstrapUrls) {
+  try {
+    Invoke-WebRequest -UseBasicParsing -Uri $dingBootstrapUrl -OutFile $dingBootstrap -TimeoutSec 300
+  } catch {
+    continue
+  }
+  $dingBootstrapHash = (Get-FileHash -Algorithm SHA256 $dingBootstrap).Hash.ToLowerInvariant()
+  if ($dingBootstrapHash -ne "{{BOOTSTRAP_WINDOWS_SHA256}}") { throw "Windows 安装引导 SHA-256 不匹配，停止安装：$dingBootstrapUrl" }
+  $dingBootstrapDownloaded = $true
+  break
+}
+if (-not $dingBootstrapDownloaded) { throw "所有 Windows 安装引导下载源均不可用" }
 $dingInstallJson = & powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File $dingBootstrap
 if ($LASTEXITCODE -ne 0) { throw "钉钉审批安装引导执行失败：$dingInstallJson" }
 $dingInstall = $dingInstallJson | ConvertFrom-Json
@@ -78,21 +97,31 @@ $dingInstall | ConvertTo-Json -Depth 20
 ```bash
 ding_bootstrap_dir="$(mktemp -d)"
 ding_bootstrap="$ding_bootstrap_dir/dingtalk-approval-bootstrap.sh"
-if command -v curl >/dev/null 2>&1; then
-  curl --fail --location --output "$ding_bootstrap" "{{BOOTSTRAP_POSIX_URL}}"
-elif command -v wget >/dev/null 2>&1; then
-  wget --https-only --output-document="$ding_bootstrap" "{{BOOTSTRAP_POSIX_URL}}"
-else
-  echo '缺少 curl 或 wget，无法下载安装引导' >&2
-  exit 1
-fi
-if command -v sha256sum >/dev/null 2>&1; then
-  ding_bootstrap_hash="$(sha256sum "$ding_bootstrap" | awk '{print $1}')"
-else
-  ding_bootstrap_hash="$(shasum -a 256 "$ding_bootstrap" | awk '{print $1}')"
-fi
-if [ "$ding_bootstrap_hash" != '{{BOOTSTRAP_POSIX_SHA256}}' ]; then
-  echo 'Linux/macOS 安装引导 SHA-256 不匹配，停止安装' >&2
+ding_bootstrap_downloaded=0
+for ding_bootstrap_url in {{BOOTSTRAP_POSIX_URLS_POSIX}}; do
+  rm -f "$ding_bootstrap"
+  if command -v curl >/dev/null 2>&1; then
+    curl --fail --location --connect-timeout 10 --max-time 300 --output "$ding_bootstrap" "$ding_bootstrap_url" || continue
+  elif command -v wget >/dev/null 2>&1; then
+    wget --https-only --timeout=300 --output-document="$ding_bootstrap" "$ding_bootstrap_url" || continue
+  else
+    echo '缺少 curl 或 wget，无法下载安装引导' >&2
+    exit 1
+  fi
+  if command -v sha256sum >/dev/null 2>&1; then
+    ding_bootstrap_hash="$(sha256sum "$ding_bootstrap" | awk '{print $1}')"
+  else
+    ding_bootstrap_hash="$(shasum -a 256 "$ding_bootstrap" | awk '{print $1}')"
+  fi
+  if [ "$ding_bootstrap_hash" != '{{BOOTSTRAP_POSIX_SHA256}}' ]; then
+    echo "Linux/macOS 安装引导 SHA-256 不匹配，停止安装：$ding_bootstrap_url" >&2
+    exit 1
+  fi
+  ding_bootstrap_downloaded=1
+  break
+done
+if [ "$ding_bootstrap_downloaded" -ne 1 ]; then
+  echo '所有 Linux/macOS 安装引导下载源均不可用' >&2
   exit 1
 fi
 ding_install_json="$(sh "$ding_bootstrap")"
@@ -106,9 +135,9 @@ printf '%s\n' "$ding_install_json"
 步骤 2 的平台引导是唯一通用安装入口。它会：
 
 1. 检查系统 Node；缺失或版本不兼容时，根据当前操作系统和 CPU 架构选择私有 Node；
-2. 按“阿里云精确版本 → npmmirror 精确版本 → Node 官方精确版本”的顺序下载。只有网络失败、超时或 404 才切换来源；任一已下载文件的 SHA-256 不匹配都会立即终止；
+2. 按“阿里云精确版本 → npmmirror 精确版本 → Node 官方精确版本”的顺序下载 Node；项目安装引导和发布物则按“主发布源 → 国内 Gitea 备用源 → 其他已配置镜像”回退。网络或 HTTP 下载失败才切换来源，任一已下载文件的签名或 SHA-256 不匹配都会立即终止；
 3. 把私有 Node 放在插件自己的当前用户数据目录，不修改系统 PATH，不要求管理员权限；
-4. 下载并校验首次安装器和发布公钥，再由安装器验证 Ed25519 清单签名与全部客户端发布物；
+4. 下载并校验首次安装器和发布公钥，再由安装器验证 Ed25519 清单签名与全部客户端发布物；下载源不是信任根，备用源不能绕过签名或哈希；
 5. 返回一份 JSON 安装结果。
 
 安装器会在稳定的当前用户数据目录安装客户端与 Skill，不会全局安装 npm 包，也不会修改 Agent 私有配置。保留完整 JSON 结果，后续只使用其中的真实字段，不要猜路径。