dsh-miloco-bridge 0.1.0 → 0.1.2

package/lib/deploy.js

@@ -5,15 +5,15 @@
  * reach a backend it can:
  *
  * - start an already-installed Miloco (`miloco-cli service start`), or
- * - clone the upstream repository into a configurable directory and run its
- *   own installer (`scripts/install.sh --dev --skip-openclaw`).
+ * - download the official release installer and run it without OpenClaw
+ *   (`install.sh --skip-openclaw`), then install this package's adapter.
  *
- * It then installs this package's `agent_platform` adapter, points Miloco's
- * webhook at DSH, and writes the runtime overlay so the plugin can talk to the
- * new backend immediately.
+ * The release installer is downloaded directly from GitHub first and then
+ * through the configured mirrors. It is a self-contained script and downloads
+ * its own release assets through the mirrors embedded in its manifest.
  *
- * This module never vendors upstream code: the clone and install happen at
- * runtime, on the owner's machine, after an explicit button press.
+ * This module never vendors upstream code: the release installer download and
+ * install happen at runtime, on the owner's machine, after a button press.
  *
  * @module dsh-miloco-bridge/deploy
  */
@@ -21,11 +21,17 @@
 import { spawn } from 'node:child_process'
 import { randomBytes } from 'node:crypto'
 import { constants, existsSync } from 'node:fs'
-import { access, copyFile, mkdir, readFile, writeFile } from 'node:fs/promises'
+import { access, chmod, copyFile, mkdir, readFile, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { readMilocoConfig } from './miloco-client.js'
+import {
+  DEFAULT_GITHUB_MIRRORS,
+  normalizeRepo,
+  releaseInstallerUrls,
+  viaMirror,
+} from './github-release.js'
 
 /** Upstream source repository used when no local checkout exists. */
 export const MILOCO_REPO = 'https://github.com/XiaoMi/xiaomi-miloco'
@@ -48,6 +54,46 @@ function expandHome(value) {
   return text
 }
 
+/**
+ * Mask credentials in command logs.
+ * @param {string[]} args - Command arguments.
+ * @returns {string[]} Arguments safe to log.
+ */
+export function redactCommandArgs(args) {
+  const out = [...args]
+  const secretFlags = new Set(['agent.auth_bearer', 'auth_bearer', '--token', '--bearer'])
+  for (let index = 0; index < out.length - 1; index += 1) {
+    if (secretFlags.has(out[index])) out[index + 1] = '<redacted>'
+  }
+  return out
+}
+
+/**
+ * Force release-installer arguments.
+ *
+ * The old source flow used `--dev`; a release installer rejects it. OpenClaw is
+ * used only to satisfy upstream platform detection, while `--skip-openclaw`
+ * prevents its plugin from being installed.
+ * @param {string[]} [raw] - Configured arguments.
+ * @returns {string[]} Safe release-installer arguments.
+ */
+function normalizeInstallArgs(raw) {
+  const args = Array.isArray(raw) ? raw.map(String) : []
+  const filtered = args.filter(arg =>
+    arg !== '--dev'
+    && !arg.startsWith('--dev=')
+    && !arg.startsWith('--agent-prepare')
+    && !arg.startsWith('--agent-finish'))
+  if (!filtered.includes('--skip-openclaw')) filtered.push('--skip-openclaw')
+  if (!filtered.some(arg => arg === '--agent-platform' || arg.startsWith('--agent-platform='))) {
+    filtered.push('--agent-platform=openclaw')
+  }
+  if (!filtered.some(arg => arg === '--lang' || arg.startsWith('--lang='))) {
+    filtered.push('--lang=zh')
+  }
+  return filtered
+}
+
 /**
  * Create a directory and prove the DSH process can write to it.
  * @param {string} dir - Directory path.
@@ -85,22 +131,45 @@ export function createDeployService(options) {
   )
   const milocoHome = expandHome(config.home || '~/.miloco')
   const repo = String(deployConfig.repo || MILOCO_REPO)
-  const installArgs = Array.isArray(deployConfig.installArgs) && deployConfig.installArgs.length
-    ? deployConfig.installArgs.map(String)
-    : ['--dev', '--skip-openclaw']
+  const githubMirrors = Array.isArray(deployConfig.githubMirrors) && deployConfig.githubMirrors.length
+    ? deployConfig.githubMirrors.map(String)
+    : DEFAULT_GITHUB_MIRRORS
+  const installArgs = normalizeInstallArgs(deployConfig.installArgs)
+  const repoUrl = `https://github.com/${normalizeRepo(repo)}`
+  const downloadSite = String(deployConfig.downloadSite || '').trim()
+    || (githubMirrors[0] ? viaMirror(githubMirrors[0], `${repoUrl}/releases/download`) : '')
+  const installEnv = {
+    UV_CACHE_DIR: join(milocoHome, '.uv-cache'),
+    UV_INDEX: String(deployConfig.uvIndex || 'https://pypi.org/simple'),
+    ...(downloadSite ? { MILOCO_DOWNLOAD_URL: downloadSite } : {}),
+  }
   const logPath = expandHome(deployConfig.logPath || join(milocoHome, 'log', 'dsh-miloco-deploy.log'))
+  const upgradeLogPath = expandHome(
+    deployConfig.upgradeLogPath || join(milocoHome, 'log', 'dsh-miloco-upgrade.log'),
+  )
 
   /** @type {{running: boolean, step: string, startedAt: string | null, exitCode: number | null}} */
   const state = { running: false, step: 'idle', startedAt: null, exitCode: null }
+  /** @type {{running: boolean, step: string, startedAt: string | null, exitCode: number | null}} */
+  const upgradeState = { running: false, step: 'idle', startedAt: null, exitCode: null }
+
+  /**
+   * Write a line into a log file.
+   * @param {string} path - Log path.
+   * @param {string} text - The line.
+   */
+  async function logTo(path, text) {
+    const stamp = new Date().toISOString().replace('T', ' ').slice(0, 19)
+    await mkdir(dirname(path), { recursive: true })
+    await writeFile(path, `[${stamp}] ${text}\n`, { flag: 'a' })
+  }
 
   /**
    * Write a line into the deployment log.
    * @param {string} text - The line.
    */
   async function logLine(text) {
-    const stamp = new Date().toISOString().replace('T', ' ').slice(0, 19)
-    await mkdir(dirname(logPath), { recursive: true })
-    await writeFile(logPath, `[${stamp}] ${text}\n`, { flag: 'a' })
+    return logTo(logPath, text)
   }
 
   /**
@@ -112,16 +181,27 @@ export function createDeployService(options) {
    */
   function run(command, args, extra = {}) {
     return new Promise(resolve => {
-      void logLine(`$ ${command} ${args.join(' ')}`)
+      const secrets = (extra.secrets ?? []).filter(Boolean)
+      const sanitize = value => secrets.reduce(
+        (text, secret) => text.split(secret).join('<redacted>'),
+        String(value),
+      )
+      const commandLog = extra.logPath || logPath
+      void logTo(commandLog, `$ ${command} ${redactCommandArgs(args).join(' ')}`)
       const child = spawn(command, args, {
         cwd: extra.cwd,
-        env: { ...process.env, MILOCO_HOME: milocoHome, ...(extra.env ?? {}) },
+        env: {
+          ...process.env,
+          PATH: [join(homedir(), '.local', 'bin'), process.env.PATH].filter(Boolean).join(':'),
+          MILOCO_HOME: milocoHome,
+          ...(extra.env ?? {}),
+        },
         stdio: ['ignore', 'pipe', 'pipe'],
       })
       const pump = stream => {
         stream.on('data', chunk => {
-          for (const line of String(chunk).split('\n')) {
-            if (line.trim() !== '') void logLine(line.trim())
+          for (const line of sanitize(chunk).split('\n')) {
+            if (line.trim() !== '') void logTo(commandLog, line.trim())
           }
         })
       }
@@ -191,6 +271,37 @@ export function createDeployService(options) {
     return false
   }
 
+  /**
+   * Download the self-contained official release installer.
+   * @returns {Promise<string>} Path to the installer script.
+   */
+  async function downloadReleaseInstaller(logTarget = logPath) {
+    const target = join(milocoHome, '.dsh-release-install.sh')
+    const urls = releaseInstallerUrls({ repo, mirrors: githubMirrors })
+    const failures = []
+    for (const url of urls) {
+      await logTo(logTarget, `downloading release installer: ${url}`)
+      try {
+        const response = await fetch(url, {
+          headers: { 'user-agent': 'dsh-miloco-bridge' },
+          redirect: 'follow',
+          signal: AbortSignal.timeout(30_000),
+        })
+        if (!response.ok) throw new Error(`HTTP ${response.status}`)
+        const text = await response.text()
+        if (!text.startsWith('#!')) throw new Error('响应不是 shell 安装脚本')
+        await writeFile(target, text, { encoding: 'utf8', mode: 0o700 })
+        await chmod(target, 0o700)
+        return target
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        failures.push(`${url}: ${message}`)
+        await logTo(logTarget, `download failed: ${message}`)
+      }
+    }
+    throw new Error(`无法下载 Miloco release 安装器：${failures.join('; ')}`)
+  }
+
   /**
    * Resolve the effective Miloco URL/token from `$MILOCO_HOME/config.json`.
    * @returns {Promise<{baseUrl: string, token: string}>} Connection settings.
@@ -244,10 +355,13 @@ export function createDeployService(options) {
   async function wireMiloco(opts) {
     const webhook = `${opts.origin}/miloco/webhook`
     if (opts.cli) {
-      await run(opts.cli, ['config', 'set', 'agent.platform', 'dsh'], { cwd: sourceDir })
-      await run(opts.cli, ['config', 'set', 'agent.webhook_url', webhook], { cwd: sourceDir })
-      await run(opts.cli, ['config', 'set', 'agent.auth_bearer', opts.token], { cwd: sourceDir })
-      await run(opts.cli, ['service', 'restart'], { cwd: sourceDir })
+      await run(opts.cli, ['config', 'set', 'agent.platform', 'dsh'], { cwd: milocoHome })
+      await run(opts.cli, ['config', 'set', 'agent.webhook_url', webhook], { cwd: milocoHome })
+      await run(opts.cli, ['config', 'set', 'agent.auth_bearer', opts.token], {
+        cwd: milocoHome,
+        secrets: [opts.token],
+      })
+      await run(opts.cli, ['service', 'restart'], { cwd: milocoHome })
     }
     if (options.overlay) {
       const current = await options.overlay.current()
@@ -279,7 +393,6 @@ export function createDeployService(options) {
     void (async () => {
       try {
         await ensureWritableDir(milocoHome, 'MILOCO_HOME')
-        await ensureWritableDir(dirname(sourceDir), 'deploy.sourceDir 的父目录')
         await logLine('=== dsh-miloco-bridge: 一键部署 Miloco 开始 ===')
 
         if (await healthy()) {
@@ -290,28 +403,28 @@ export function createDeployService(options) {
           if (cli && existsSync(join(milocoHome, 'config.json'))) {
             state.step = 'starting-existing'
             await logLine(`检测到已安装的 Miloco，尝试启动：${cli}`)
-            await run(cli, ['service', 'start'], { cwd: sourceDir })
+            await run(cli, ['service', 'start'], { cwd: milocoHome })
             await waitHealthy(DEFAULT_MILOCO_URL, 45_000)
           }
 
           if (!await healthy()) {
-            state.step = 'preparing-source'
-            if (!existsSync(join(sourceDir, 'scripts', 'install.sh'))) {
-              if (!/^https:\/\//i.test(repo)) {
-                throw new Error('deploy.repo 必须是 https:// 地址')
-              }
-              await mkdir(dirname(sourceDir), { recursive: true })
-              await logLine(`cloning ${repo} -> ${sourceDir}`)
-              const clone = await run('git', ['clone', '--depth', '1', repo, sourceDir], { cwd: homedir() })
-              if (clone !== 0) throw new Error(`git clone 失败（exit ${clone}）`)
-            }
+            state.step = 'downloading-installer'
+            const installer = await downloadReleaseInstaller()
             state.step = 'installing'
-            const install = await run('bash', ['scripts/install.sh', ...installArgs], { cwd: sourceDir })
-            if (install !== 0) throw new Error(`Miloco 安装器返回 ${install}`)
+            const prepare = await run('bash', [installer, '--agent-prepare', ...installArgs], {
+              cwd: milocoHome,
+              env: installEnv,
+            })
+            if (prepare !== 0) throw new Error(`Miloco release 安装器 prepare 返回 ${prepare}`)
+            const finish = await run('bash', [installer, '--agent-finish', ...installArgs], {
+              cwd: milocoHome,
+              env: installEnv,
+            })
+            if (finish !== 0) throw new Error(`Miloco release 安装器 finish 返回 ${finish}`)
             state.step = 'starting-service'
             const cliAfter = await findMilocoCli()
-            if (cliAfter) await run(cliAfter, ['service', 'start'], { cwd: sourceDir })
-            if (!await waitHealthy(DEFAULT_MILOCO_URL, 90_000)) {
+            if (cliAfter) await run(cliAfter, ['service', 'start'], { cwd: milocoHome })
+            if (!await waitHealthy(DEFAULT_MILOCO_URL, 120_000)) {
               throw new Error('Miloco 安装完成但没有在 127.0.0.1:1810 上响应')
             }
           }
@@ -346,6 +459,88 @@ export function createDeployService(options) {
     return { started: true, logPath }
   }
 
+  /**
+   * Run a mirror-backed upgrade through the same release installer as deploy.
+   * @param {{origin?: string}} [opts] - Request origin.
+   * @returns {Promise<{started: boolean, reason?: string, logPath?: string}>} Outcome.
+   */
+  async function startUpgrade(opts = {}) {
+    if (upgradeState.running) {
+      return { started: false, reason: 'already-running', logPath: upgradeLogPath }
+    }
+    if (state.running) {
+      return { started: false, reason: 'deploy-running', logPath: upgradeLogPath }
+    }
+    upgradeState.running = true
+    upgradeState.step = 'starting'
+    upgradeState.startedAt = new Date().toISOString()
+    upgradeState.exitCode = null
+    const origin = String(opts.origin || '').replace(/\/+$/, '') || 'http://127.0.0.1:3080'
+
+    void (async () => {
+      try {
+        await ensureWritableDir(milocoHome, 'MILOCO_HOME')
+        await logTo(upgradeLogPath, '=== Miloco 升级开始 ===')
+        upgradeState.step = 'downloading-installer'
+        const installer = await downloadReleaseInstaller(upgradeLogPath)
+        upgradeState.step = 'installing'
+        const installOpts = { cwd: milocoHome, env: installEnv, logPath: upgradeLogPath }
+        const prepare = await run('bash', [installer, '--agent-prepare', ...installArgs], installOpts)
+        if (prepare !== 0) throw new Error(`Miloco release 安装器 prepare 返回 ${prepare}`)
+        const finish = await run('bash', [installer, '--agent-finish', ...installArgs], installOpts)
+        if (finish !== 0) throw new Error(`Miloco release 安装器 finish 返回 ${finish}`)
+        upgradeState.step = 'starting-service'
+        const cli = await findMilocoCli()
+        if (cli) {
+          await run(cli, ['service', 'start'], { cwd: milocoHome, logPath: upgradeLogPath })
+        }
+        if (!await waitHealthy(DEFAULT_MILOCO_URL, 120_000)) {
+          throw new Error('Miloco 升级后没有在 127.0.0.1:1810 上响应')
+        }
+        upgradeState.step = 'wiring'
+        const connection = await localConnection()
+        const fileConfig = await readMilocoConfig(milocoHome)
+        const existingToken = String(fileConfig?.agent?.auth_bearer ?? '').trim()
+        const pushToken = existingToken || randomBytes(32).toString('base64url')
+        await installAdapter({ origin, token: pushToken })
+        await wireMiloco({ cli, origin, token: pushToken, connection })
+        upgradeState.step = 'done'
+        upgradeState.exitCode = 0
+        await logTo(upgradeLogPath, '=== 升级完成 ===')
+      } catch (error) {
+        upgradeState.step = 'failed'
+        upgradeState.exitCode = 1
+        await logTo(upgradeLogPath, `升级异常：${error instanceof Error ? error.message : String(error)}`)
+      } finally {
+        upgradeState.running = false
+      }
+    })()
+
+    return { started: true, logPath: upgradeLogPath }
+  }
+
+  /**
+   * @returns {any} Upgrade state for the settings API.
+   */
+  function upgradeStateView() {
+    return { ...upgradeState, logPath: upgradeLogPath, milocoHome }
+  }
+
+  /**
+   * Read the tail of the upgrade log.
+   * @param {number} [lines] - Number of trailing lines.
+   * @returns {Promise<string>} The log tail.
+   */
+  async function upgradeTail(lines = 60) {
+    try {
+      const text = await readFile(upgradeLogPath, 'utf8')
+      const all = text.split('\n').filter(line => line.trim() !== '')
+      return all.slice(-lines).join('\n')
+    } catch {
+      return ''
+    }
+  }
+
   /**
    * Read the tail of the deployment log.
    * @param {number} [lines] - Number of trailing lines.
@@ -371,5 +566,8 @@ export function createDeployService(options) {
     }),
     tail,
     start,
+    upgradeState: upgradeStateView,
+    upgradeTail,
+    startUpgrade,
   }
 }

package/lib/github-release.js

@@ -0,0 +1,162 @@
+/**
+ * GitHub release lookup with mirror fallback.
+ *
+ * Miloco only publishes on GitHub. Direct GitHub access is preferred; when it
+ * is unavailable, the same API/installer URLs are requested through public
+ * pull-through mirrors.
+ *
+ * @module dsh-miloco-bridge/github-release
+ */
+
+export const DEFAULT_GITHUB_REPO = 'XiaoMi/xiaomi-miloco'
+export const DEFAULT_GITHUB_API = 'https://api.github.com'
+export const DEFAULT_GITHUB_MIRRORS = [
+  'https://gh-proxy.com/',
+  'https://gh-proxy.org/',
+]
+
+/**
+ * Normalise an owner/repo or GitHub URL to `owner/repo`.
+ * @param {string} [repo] - Repository URL or slug.
+ * @returns {string} Repository slug.
+ */
+export function normalizeRepo(repo) {
+  const text = String(repo ?? '').trim().replace(/\/+$/, '').replace(/\.git$/i, '')
+  const match = /^(?:https?:\/\/github\.com\/)?([^/\s]+\/[^/\s]+)$/i.exec(text)
+  return match ? match[1] : DEFAULT_GITHUB_REPO
+}
+
+/**
+ * Prefix a URL with a mirror, or expand a `{url}` template.
+ * @param {string} mirror - Mirror base or template.
+ * @param {string} url - Original URL.
+ * @returns {string} Mirrored URL.
+ */
+export function viaMirror(mirror, url) {
+  const base = String(mirror ?? '').trim()
+  if (!base) return url
+  if (base.includes('{url}')) return base.replaceAll('{url}', url)
+  return `${base.replace(/\/+$/, '')}/${url}`
+}
+
+/**
+ * Build direct + mirrored URLs for the latest-release API.
+ * @param {{repo?: string, apiBase?: string, mirrors?: string[]}} [opts] - Options.
+ * @returns {string[]} Candidate URLs, direct first.
+ */
+export function releaseApiUrls(opts = {}) {
+  const repo = normalizeRepo(opts.repo)
+  const apiBase = String(opts.apiBase || DEFAULT_GITHUB_API).replace(/\/+$/, '')
+  const direct = `${apiBase}/repos/${repo}/releases/latest`
+  const mirrors = (opts.mirrors ?? DEFAULT_GITHUB_MIRRORS).map(mirror => viaMirror(mirror, direct))
+  return [...new Set([direct, ...mirrors])]
+}
+
+/**
+ * Build direct + mirrored URLs for the release installer script.
+ * @param {{repo?: string, mirrors?: string[]}} [opts] - Options.
+ * @returns {string[]} Candidate URLs, direct first.
+ */
+export function releaseInstallerUrls(opts = {}) {
+  const repo = normalizeRepo(opts.repo)
+  const direct = `https://github.com/${repo}/releases/latest/download/install.sh`
+  const mirrors = (opts.mirrors ?? DEFAULT_GITHUB_MIRRORS).map(mirror => viaMirror(mirror, direct))
+  return [...new Set([direct, ...mirrors])]
+}
+
+/**
+ * Fetch the latest release, trying direct GitHub then mirrors.
+ * @param {{repo?: string, apiBase?: string, mirrors?: string[], timeoutMs?: number, fetchImpl?: typeof fetch}} [opts] - Options.
+ * @returns {Promise<{tag: string, html_url: string, source: 'github'|'mirror', mirror: string|null, release_url: string, request_url: string}>} Latest release.
+ */
+export async function fetchLatestRelease(opts = {}) {
+  const doFetch = opts.fetchImpl ?? fetch
+  const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 6_000
+  const urls = releaseApiUrls(opts)
+  const errors = []
+  for (const [index, url] of urls.entries()) {
+    try {
+      const response = await doFetch(url, {
+        headers: {
+          accept: 'application/vnd.github+json',
+          'user-agent': 'dsh-miloco-bridge',
+        },
+        redirect: 'follow',
+        signal: AbortSignal.timeout(timeoutMs),
+      })
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
+      const body = await response.json()
+      const tag = String(body?.tag_name ?? '').trim()
+      if (!tag) throw new Error('响应缺少 tag_name')
+      const htmlUrl = String(body?.html_url ?? '').trim()
+      const mirrored = index > 0
+      const mirror = mirrored ? (opts.mirrors ?? DEFAULT_GITHUB_MIRRORS)[index - 1] : null
+      return {
+        tag,
+        html_url: htmlUrl,
+        source: mirrored ? 'mirror' : 'github',
+        mirror,
+        release_url: mirrored && htmlUrl ? viaMirror(mirror, htmlUrl) : htmlUrl,
+        request_url: url,
+      }
+    } catch (error) {
+      errors.push(`${url}: ${error instanceof Error ? error.message : String(error)}`)
+    }
+  }
+  throw new Error(`最新版本查询失败：${errors.join('; ')}`)
+}
+
+/**
+ * Parse a CalVer/PEP440-style release string.
+ * @param {string} value - Version string.
+ * @returns {{parts: number[], post: number, dev: number|null}|null} Parsed version.
+ */
+export function parseReleaseVersion(value) {
+  const text = String(value ?? '').trim().replace(/^v/i, '').split('+')[0]
+  const match = /^(\d+(?:\.\d+)*)(?:\.post(\d+))?(?:\.dev(\d+))?$/.exec(text)
+  if (!match) return null
+  return {
+    parts: match[1].split('.').map(Number),
+    post: Number(match[2] ?? 0),
+    dev: match[3] === undefined ? null : Number(match[3]),
+  }
+}
+
+/**
+ * Normalise a release tag for display.
+ * @param {string} value - Tag or version.
+ * @returns {string} Version without a leading `v`.
+ */
+export function normalizeReleaseVersion(value) {
+  return String(value ?? '').trim().replace(/^v/i, '')
+}
+
+/**
+ * Whether `latest` is strictly newer than `current`.
+ * Dev builds and unparseable versions are treated conservatively as "no update".
+ * @param {string} current - Current version.
+ * @param {string} latest - Latest release tag.
+ * @returns {boolean} Whether an update is available.
+ */
+export function isNewerRelease(current, latest) {
+  const left = parseReleaseVersion(current)
+  const right = parseReleaseVersion(latest)
+  if (!left || !right) return false
+  if (left.dev !== null) return false
+  const length = Math.max(left.parts.length, right.parts.length)
+  for (let index = 0; index < length; index += 1) {
+    const a = left.parts[index] ?? 0
+    const b = right.parts[index] ?? 0
+    if (b !== a) return b > a
+  }
+  return right.post > left.post
+}
+
+/**
+ * Infer release/dev deployment kind from a package version.
+ * @param {string} version - Package version.
+ * @returns {'release'|'dev'} Deployment kind.
+ */
+export function inferDeployKind(version) {
+  return /\.dev\d*|\+/.test(String(version ?? '')) ? 'dev' : 'release'
+}

package/lib/index.js

@@ -96,7 +96,17 @@ export function normalizeConfig(raw) {
         : join(resolveDshHome(), 'plugin-data', 'dsh-miloco-bridge', 'xiaomi-miloco'),
       installArgs: Array.isArray(deployRaw.installArgs)
         ? deployRaw.installArgs.map(String)
-        : ['--dev', '--skip-openclaw'],
+        : ['--skip-openclaw', '--agent-platform=openclaw', '--lang=zh'],
+      githubMirrors: Array.isArray(deployRaw.githubMirrors)
+        ? deployRaw.githubMirrors.map(String).filter(Boolean)
+        : ['https://gh-proxy.com/', 'https://gh-proxy.org/'],
+      githubApi: typeof deployRaw.githubApi === 'string' && deployRaw.githubApi
+        ? deployRaw.githubApi
+        : 'https://api.github.com',
+      downloadSite: typeof deployRaw.downloadSite === 'string' ? deployRaw.downloadSite : '',
+      uvIndex: typeof deployRaw.uvIndex === 'string' && deployRaw.uvIndex
+        ? deployRaw.uvIndex
+        : 'https://pypi.org/simple',
       logPath: typeof deployRaw.logPath === 'string' ? deployRaw.logPath : '',
     },
   }