@asiainfo-sdd/multica-cli 0.2.1 → 0.3.2

package/lib/install.js

@@ -1,333 +1,337 @@
-'use strict';
-
-// postinstall 主流程：按平台下载 multica CLI 二进制（-tags agentfoundry
-// 构建，含 daemon 主机线能力）并落位到包内 vendor/。
-// 只管安装：不读写 ~/.multica 配置、不登录、不启动/停止 daemon。
-
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-const { spawnSync } = require('child_process');
-
-const { detectPlatform, manifestKey, vendorBinaryPath } = require('./platform');
-const { applyServerConfig } = require('./server-config');
-const http = require('./http');
-
-const pkg = require('../package.json');
-
-// 下载源基址，可被环境变量覆盖。指向 Nexus raw 仓库或 Jenkins 产物目录。
-const DEFAULT_DOWNLOAD_BASE = 'https://aido.asiainfo.com/aird-api/business/api/v1/external/daemon-download';
-const LOCK_STALE_MS = 5 * 60 * 1000;
-
-function log(msg) {
-  process.stdout.write(`${msg}\n`);
-}
-
-function downloadBase() {
-  return (process.env.MULTICA_DOWNLOAD_BASE || DEFAULT_DOWNLOAD_BASE).replace(/\/+$/, '');
-}
-
-function vendorDir() {
-  return path.join(__dirname, '..', 'vendor');
-}
-
-function installedMarkerPath() {
-  return path.join(vendorDir(), '.installed.json');
-}
-
-function readInstalled() {
-  try {
-    return JSON.parse(fs.readFileSync(installedMarkerPath(), 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-// ---------- manifest ----------
-
-function fallbackManifest() {
-  try {
-    return JSON.parse(
-      fs.readFileSync(path.join(__dirname, 'manifest.fallback.json'), 'utf8'),
-    );
-  } catch {
-    return null;
-  }
-}
-
-async function loadManifest() {
-  const base = downloadBase();
-  try {
-    const text = await http.fetchText(`${base}/manifest.json`, { timeoutMs: 10000 });
-    return { manifest: JSON.parse(text), source: base };
-  } catch (err) {
-    log(`⚠ 无法从 ${base} 获取 manifest（${err.message}），改用包内置兜底清单`);
-    const fb = fallbackManifest();
-    if (fb) return { manifest: fb, source: 'fallback' };
-    return { manifest: null, source: 'none' };
-  }
-}
-
-function pickEntry(manifest, version) {
-  return manifest?.versions?.[version] || null;
-}
-
-// ---------- 锁 ----------
-
-function acquireLock(dir) {
-  const lockPath = path.join(dir, '.lock');
-  fs.mkdirSync(dir, { recursive: true });
-  for (let attempt = 0; ; attempt++) {
-    try {
-      const fd = fs.openSync(lockPath, 'wx');
-      fs.writeSync(fd, String(process.pid));
-      fs.closeSync(fd);
-      return { release: () => fs.rmSync(lockPath, { force: true }) };
-    } catch (err) {
-      if (err.code !== 'EEXIST') throw err;
-      try {
-        const st = fs.statSync(lockPath);
-        if (Date.now() - st.mtimeMs > LOCK_STALE_MS) {
-          fs.rmSync(lockPath, { force: true });
-          continue; // 陈旧锁已破，重试获取
-        }
-      } catch {
-        continue; // 锁文件刚被对方释放
-      }
-      if (attempt > 60) {
-        throw new Error('另一进程正在下载 multica 二进制，等待超时；请稍后重试 npm rebuild');
-      }
-      const until = Date.now() + 2000;
-      while (Date.now() < until) {} // 同步安装脚本内简短等待
-    }
-  }
-}
-
-// ---------- 下载与校验 ----------
-
-function progressPrinter(isTTY) {
-  if (!isTTY) {
-    let announced = false;
-    return (done, total) => {
-      if (!announced) {
-        announced = true;
-        log(`… 开始下载${total ? `（共 ${(total / 1048576).toFixed(1)} MB）` : ''}，完成后报告`);
-      }
-    };
-  }
-  return (done, total) => {
-    const mb = (n) => (n / 1048576).toFixed(1);
-    const pct = total ? ` (${Math.floor((done / total) * 100)}%)` : '';
-    process.stdout.write(`\r  下载中 ${mb(done)}${total ? `/${mb(total)} MB` : ' MB'}${pct}   `);
-  };
-}
-
-function sha256Of(filePath) {
-  return new Promise((resolve, reject) => {
-    const hash = crypto.createHash('sha256');
-    const stream = fs.createReadStream(filePath);
-    stream.on('error', reject);
-    stream.on('data', (c) => hash.update(c));
-    stream.on('end', () => resolve(hash.digest('hex')));
-  });
-}
-
-async function downloadOnce(url, tmpPath, expectedSize) {
-  await new Promise((resolve, reject) => {
-    fs.mkdirSync(path.dirname(tmpPath), { recursive: true });
-    const out = fs.createWriteStream(tmpPath);
-    const onProgress = progressPrinter(process.stdout.isTTY);
-    http
-      .downloadToStream(url, out, { onProgress })
-      .then(resolve, reject);
-  });
-  if (process.stdout.isTTY) process.stdout.write('\n');
-  if (expectedSize && fs.statSync(tmpPath).size !== expectedSize) {
-    throw new Error(`大小不符：期望 ${expectedSize}，实际 ${fs.statSync(tmpPath).size}`);
-  }
-}
-
-function hintRunRebuild() {
-  log('  修复方式：稍后执行  npm rebuild @asiainfo-sdd/multica-cli');
-}
-
-// 把部署级配置(server_url/app_url)写入 ~/.multica/config.json（覆盖式）。
-// manifest 失败时传 null,退回 env > 包内置默认值。
-function applyServerConfigSafe(manifest) {
-  let result;
-  try {
-    result = applyServerConfig(manifest);
-  } catch (err) {
-    log(`⚠ 写入服务器配置失败（${err.message}），请手工执行 aido config set server_url <地址>`);
-    return;
-  }
-  if (!result) return;
-  for (const { key, value } of result.written) {
-    log(`✓ 已写入 ${key} = ${value}（${require('./server-config').multicaConfigPath()}）`);
-  }
-  for (const { key, from, to } of result.updated) {
-    log(`✓ 已更新 ${key}：${from} → ${to}（环境切换；token 需重新登录生成）`);
-  }
-}
-
-async function install() {
-  if (process.env.MULTICA_SKIP_BINARY_INSTALL === '1') {
-    log('ℹ MULTICA_SKIP_BINARY_INSTALL=1，跳过二进制下载。');
-    log('  需要时执行 npm rebuild @asiainfo-sdd/multica-cli 完成下载。');
-    return;
-  }
-
-  const plat = detectPlatform();
-  if (!plat) {
-    log(`⚠ 当前平台 ${process.platform}/${process.arch} 不在支持矩阵（darwin/linux/windows × amd64/arm64），跳过下载。`);
-    log('  如需在其他机器安装，请确认平台受支持后重试。');
-    return;
-  }
-
-  const version = pkg.version;
-  const key = manifestKey(plat);
-  const { manifest } = await loadManifest();
-  const versionEntry = pickEntry(manifest, version);
-  const entry = versionEntry?.[key];
-
-  if (!entry) {
-    log(`⚠ 下载清单中未找到 v${version} 的 ${key} 产物，暂不下载。`);
-    log(`  下载源：${downloadBase()}（可用 MULTICA_DOWNLOAD_BASE 覆盖）`);
-    hintRunRebuild();
-    return;
-  }
-
-  const dir = vendorDir();
-  const target = vendorBinaryPath(dir, plat);
-
-  // 幂等：已装同版本且校验通过则跳过。
-  const installed = readInstalled();
-  if (
-    installed &&
-    installed.version === version &&
-    installed.sha256 === entry.sha256 &&
-    fs.existsSync(target)
-  ) {
-    log(`✓ aido v${version} 已就绪（${path.basename(target)}，无需重复下载）`);
-    applyServerConfigSafe(manifest);
-    printUsage(version);
-    return;
-  }
-
-  const url = `${downloadBase()}/${entry.path.replace(/^\/+/, '')}`;
-  log(`→ 安装 aido（daemon 客户端）v${version}（${key}）`);
-  log(`  下载源：${url}`);
-
-  const lock = acquireLock(dir);
-  try {
-    // 拿到锁后复查：等锁期间对方可能已完成安装。
-    const recheck = readInstalled();
-    if (
-      recheck &&
-      recheck.version === version &&
-      recheck.sha256 === entry.sha256 &&
-      fs.existsSync(target)
-    ) {
-      log(`✓ aido v${version} 已就绪（并发安装合并，跳过下载）`);
-      printUsage(version);
-      return;
-    }
-
-    const tmpPath = path.join(dir, `.tmp-${process.pid}`);
-    let lastErr = null;
-    for (let attempt = 1; attempt <= 2; attempt++) {
-      try {
-        await downloadOnce(url, tmpPath, entry.size);
-        const actual = await sha256Of(tmpPath);
-        if (actual.toLowerCase() !== entry.sha256.toLowerCase()) {
-          throw new Error(`sha256 校验失败：期望 ${entry.sha256}，实际 ${actual}`);
-        }
-        lastErr = null;
-        break;
-      } catch (err) {
-        lastErr = err;
-        fs.rmSync(tmpPath, { force: true });
-        if (attempt === 1) log(`  下载/校验失败（${err.message}），重试一次…`);
-      }
-    }
-    if (lastErr) {
-      log(`✗ 二进制下载失败：${lastErr.message}`);
-      log(`  请检查网络与下载源 ${downloadBase()} 是否可达（代理变量 http_proxy/https_proxy 会被识别）`);
-      hintRunRebuild();
-      process.exitCode = 1;
-      return;
-    }
-
-    try {
-      fs.rmSync(target, { force: true });
-      fs.renameSync(tmpPath, target);
-    } catch (err) {
-      if (err.code === 'EPERM' || err.code === 'EBUSY' || err.code === 'EACCES') {
-        log('✗ 无法替换二进制文件：文件被占用（通常是 daemon 正在运行）。');
-        log('  请先执行 multica daemon stop，再运行 npm rebuild @asiainfo-sdd/multica-cli。');
-      } else {
-        log(`✗ 落位失败：${err.message}`);
-      }
-      hintRunRebuild();
-      process.exitCode = 1;
-      return;
-    }
-
-    if (process.platform !== 'win32') fs.chmodSync(target, 0o755);
-    if (process.platform === 'darwin') {
-      // ad-hoc 签名，避免 Gatekeeper 拦截 spawn；失败不致命。
-      const r = spawnSync('codesign', ['-s', '-', '--force', target], { stdio: 'ignore' });
-      if (r.status !== 0) log('  （codesign ad-hoc 签名失败，可忽略）');
-    }
-
-    fs.writeFileSync(
-      installedMarkerPath(),
-      JSON.stringify(
-        { version, sha256: entry.sha256, installedAt: new Date().toISOString() },
-        null,
-        2,
-      ),
-    );
-    log(`✓ aido v${version} 安装完成：${target}`);
-    applyServerConfigSafe(manifest);
-    printUsage(version);
-  } finally {
-    lock.release();
-  }
-}
-
-function printUsage(version) {
-  log('');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  log(`  aido（daemon 客户端）v${version} 已就绪`);
-  const configPath = require('./server-config').multicaConfigPath();
-  // 以用户配置文件里最终的 server_url 为准（含此前手工配置过的场景）。
-  let effectiveServerUrl = '';
-  try {
-    effectiveServerUrl =
-      JSON.parse(require('fs').readFileSync(configPath, 'utf8')).server_url || '';
-  } catch {
-    // 文件缺失/损坏：走三步指引
-  }
-  if (effectiveServerUrl) {
-    log(`  ✓ 服务器地址已就绪：${configPath}（server_url = ${effectiveServerUrl}）`);
-    log('  接下来请自行完成两步：');
-    log('    1. aido login --token mul_<个人令牌>   ← 令牌在 Web 端“设置→令牌”生成');
-    log('    2. aido daemon start   ← 需本机已装至少一个 agent CLI（claude/codex/opencode…）');
-  } else {
-    log('  接下来请自行完成三步：');
-    log('    1. aido config set server_url https://<服务器地址>');
-    log('    2. aido login --token mul_<个人令牌>   ← 令牌在 Web 端“设置→令牌”生成');
-    log('    3. aido daemon start   ← 需本机已装至少一个 agent CLI（claude/codex/opencode…）');
-  }
-  log('  日常管理：aido daemon status / logs / stop');
-  log('  提示“aido 不是命令” → 重新打开终端，或用 npx aido ...');
-  log('  本包只负责安装与部署级配置：不会写 token、不会登录、不会启动 daemon。');
-  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-}
-
-install().catch((err) => {
-  log(`✗ 安装脚本异常：${err.stack || err.message}`);
-  hintRunRebuild();
-  process.exitCode = 1;
-});
+'use strict';
+
+// postinstall 主流程：按平台下载 multica CLI 二进制（-tags agentfoundry
+// 构建，含 daemon 主机线能力）并落位到包内 vendor/。
+// 只管安装：不读写 ~/.multica 配置、不登录、不启动/停止 daemon。
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const { spawnSync } = require('child_process');
+
+const { detectPlatform, manifestKey, vendorBinaryPath } = require('./platform');
+const { applyServerConfig } = require('./server-config');
+const http = require('./http');
+
+const pkg = require('../package.json');
+
+// 下载源兜底基址（生产）。实际取值：MULTICA_DOWNLOAD_BASE 环境变量
+// > lib/dist-config.json 的 download_base（发布脚本按 profile 注入）> 此默认值。
+const DEFAULT_DOWNLOAD_BASE = 'https://aido.asiainfo.com/aird-api/business/api/v1/external/daemon-download';
+const LOCK_STALE_MS = 5 * 60 * 1000;
+
+function log(msg) {
+  process.stdout.write(`${msg}\n`);
+}
+
+function downloadBase() {
+  const fromConfig = require('./dist-config.json').download_base;
+  return (
+    process.env.MULTICA_DOWNLOAD_BASE || fromConfig || DEFAULT_DOWNLOAD_BASE
+  ).replace(/\/+$/, '');
+}
+
+function vendorDir() {
+  return path.join(__dirname, '..', 'vendor');
+}
+
+function installedMarkerPath() {
+  return path.join(vendorDir(), '.installed.json');
+}
+
+function readInstalled() {
+  try {
+    return JSON.parse(fs.readFileSync(installedMarkerPath(), 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+// ---------- manifest ----------
+
+function fallbackManifest() {
+  try {
+    return JSON.parse(
+      fs.readFileSync(path.join(__dirname, 'manifest.fallback.json'), 'utf8'),
+    );
+  } catch {
+    return null;
+  }
+}
+
+async function loadManifest() {
+  const base = downloadBase();
+  try {
+    const text = await http.fetchText(`${base}/manifest.json`, { timeoutMs: 10000 });
+    return { manifest: JSON.parse(text), source: base };
+  } catch (err) {
+    log(`⚠ 无法从 ${base} 获取 manifest（${err.message}），改用包内置兜底清单`);
+    const fb = fallbackManifest();
+    if (fb) return { manifest: fb, source: 'fallback' };
+    return { manifest: null, source: 'none' };
+  }
+}
+
+function pickEntry(manifest, version) {
+  return manifest?.versions?.[version] || null;
+}
+
+// ---------- 锁 ----------
+
+function acquireLock(dir) {
+  const lockPath = path.join(dir, '.lock');
+  fs.mkdirSync(dir, { recursive: true });
+  for (let attempt = 0; ; attempt++) {
+    try {
+      const fd = fs.openSync(lockPath, 'wx');
+      fs.writeSync(fd, String(process.pid));
+      fs.closeSync(fd);
+      return { release: () => fs.rmSync(lockPath, { force: true }) };
+    } catch (err) {
+      if (err.code !== 'EEXIST') throw err;
+      try {
+        const st = fs.statSync(lockPath);
+        if (Date.now() - st.mtimeMs > LOCK_STALE_MS) {
+          fs.rmSync(lockPath, { force: true });
+          continue; // 陈旧锁已破，重试获取
+        }
+      } catch {
+        continue; // 锁文件刚被对方释放
+      }
+      if (attempt > 60) {
+        throw new Error('另一进程正在下载 multica 二进制，等待超时；请稍后重试 npm rebuild');
+      }
+      const until = Date.now() + 2000;
+      while (Date.now() < until) {} // 同步安装脚本内简短等待
+    }
+  }
+}
+
+// ---------- 下载与校验 ----------
+
+function progressPrinter(isTTY) {
+  if (!isTTY) {
+    let announced = false;
+    return (done, total) => {
+      if (!announced) {
+        announced = true;
+        log(`… 开始下载${total ? `（共 ${(total / 1048576).toFixed(1)} MB）` : ''}，完成后报告`);
+      }
+    };
+  }
+  return (done, total) => {
+    const mb = (n) => (n / 1048576).toFixed(1);
+    const pct = total ? ` (${Math.floor((done / total) * 100)}%)` : '';
+    process.stdout.write(`\r  下载中 ${mb(done)}${total ? `/${mb(total)} MB` : ' MB'}${pct}   `);
+  };
+}
+
+function sha256Of(filePath) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256');
+    const stream = fs.createReadStream(filePath);
+    stream.on('error', reject);
+    stream.on('data', (c) => hash.update(c));
+    stream.on('end', () => resolve(hash.digest('hex')));
+  });
+}
+
+async function downloadOnce(url, tmpPath, expectedSize) {
+  await new Promise((resolve, reject) => {
+    fs.mkdirSync(path.dirname(tmpPath), { recursive: true });
+    const out = fs.createWriteStream(tmpPath);
+    const onProgress = progressPrinter(process.stdout.isTTY);
+    http
+      .downloadToStream(url, out, { onProgress })
+      .then(resolve, reject);
+  });
+  if (process.stdout.isTTY) process.stdout.write('\n');
+  if (expectedSize && fs.statSync(tmpPath).size !== expectedSize) {
+    throw new Error(`大小不符：期望 ${expectedSize}，实际 ${fs.statSync(tmpPath).size}`);
+  }
+}
+
+function hintRunRebuild() {
+  log(`  修复方式：稍后执行  npm rebuild ${pkg.name}`);
+}
+
+// 把部署级配置(server_url/app_url)写入 ~/.multica/config.json（覆盖式）。
+// manifest 失败时传 null,退回 env > 包内置默认值。
+function applyServerConfigSafe(manifest) {
+  let result;
+  try {
+    result = applyServerConfig(manifest);
+  } catch (err) {
+    log(`⚠ 写入服务器配置失败（${err.message}），请手工执行 multica config set server_url <地址>`);
+    return;
+  }
+  if (!result) return;
+  for (const { key, value } of result.written) {
+    log(`✓ 已写入 ${key} = ${value}（${require('./server-config').multicaConfigPath()}）`);
+  }
+  for (const { key, from, to } of result.updated) {
+    log(`✓ 已更新 ${key}：${from} → ${to}（环境切换；token 需重新登录生成）`);
+  }
+}
+
+async function install() {
+  if (process.env.MULTICA_SKIP_BINARY_INSTALL === '1') {
+    log('ℹ MULTICA_SKIP_BINARY_INSTALL=1，跳过二进制下载。');
+    log(`  需要时执行 npm rebuild ${pkg.name} 完成下载。`);
+    return;
+  }
+
+  const plat = detectPlatform();
+  if (!plat) {
+    log(`⚠ 当前平台 ${process.platform}/${process.arch} 不在支持矩阵（darwin/linux/windows × amd64/arm64），跳过下载。`);
+    log('  如需在其他机器安装，请确认平台受支持后重试。');
+    return;
+  }
+
+  const version = pkg.version;
+  const key = manifestKey(plat);
+  const { manifest } = await loadManifest();
+  const versionEntry = pickEntry(manifest, version);
+  const entry = versionEntry?.[key];
+
+  if (!entry) {
+    log(`⚠ 下载清单中未找到 v${version} 的 ${key} 产物，暂不下载。`);
+    log(`  下载源：${downloadBase()}（可用 MULTICA_DOWNLOAD_BASE 覆盖）`);
+    hintRunRebuild();
+    return;
+  }
+
+  const dir = vendorDir();
+  const target = vendorBinaryPath(dir, plat);
+
+  // 幂等：已装同版本且校验通过则跳过。
+  const installed = readInstalled();
+  if (
+    installed &&
+    installed.version === version &&
+    installed.sha256 === entry.sha256 &&
+    fs.existsSync(target)
+  ) {
+    log(`✓ multica v${version} 已就绪（${path.basename(target)}，无需重复下载）`);
+    applyServerConfigSafe(manifest);
+    printUsage(version);
+    return;
+  }
+
+  const url = `${downloadBase()}/${entry.path.replace(/^\/+/, '')}`;
+  log(`→ 安装 multica（daemon 客户端）v${version}（${key}）`);
+  log(`  下载源：${url}`);
+
+  const lock = acquireLock(dir);
+  try {
+    // 拿到锁后复查：等锁期间对方可能已完成安装。
+    const recheck = readInstalled();
+    if (
+      recheck &&
+      recheck.version === version &&
+      recheck.sha256 === entry.sha256 &&
+      fs.existsSync(target)
+    ) {
+      log(`✓ multica v${version} 已就绪（并发安装合并，跳过下载）`);
+      printUsage(version);
+      return;
+    }
+
+    const tmpPath = path.join(dir, `.tmp-${process.pid}`);
+    let lastErr = null;
+    for (let attempt = 1; attempt <= 2; attempt++) {
+      try {
+        await downloadOnce(url, tmpPath, entry.size);
+        const actual = await sha256Of(tmpPath);
+        if (actual.toLowerCase() !== entry.sha256.toLowerCase()) {
+          throw new Error(`sha256 校验失败：期望 ${entry.sha256}，实际 ${actual}`);
+        }
+        lastErr = null;
+        break;
+      } catch (err) {
+        lastErr = err;
+        fs.rmSync(tmpPath, { force: true });
+        if (attempt === 1) log(`  下载/校验失败（${err.message}），重试一次…`);
+      }
+    }
+    if (lastErr) {
+      log(`✗ 二进制下载失败：${lastErr.message}`);
+      log(`  请检查网络与下载源 ${downloadBase()} 是否可达（代理变量 http_proxy/https_proxy 会被识别）`);
+      hintRunRebuild();
+      process.exitCode = 1;
+      return;
+    }
+
+    try {
+      fs.rmSync(target, { force: true });
+      fs.renameSync(tmpPath, target);
+    } catch (err) {
+      if (err.code === 'EPERM' || err.code === 'EBUSY' || err.code === 'EACCES') {
+        log('✗ 无法替换二进制文件：文件被占用（通常是 daemon 正在运行）。');
+        log(`  请先执行 multica daemon stop，再运行 npm rebuild ${pkg.name}。`);
+      } else {
+        log(`✗ 落位失败：${err.message}`);
+      }
+      hintRunRebuild();
+      process.exitCode = 1;
+      return;
+    }
+
+    if (process.platform !== 'win32') fs.chmodSync(target, 0o755);
+    if (process.platform === 'darwin') {
+      // ad-hoc 签名，避免 Gatekeeper 拦截 spawn；失败不致命。
+      const r = spawnSync('codesign', ['-s', '-', '--force', target], { stdio: 'ignore' });
+      if (r.status !== 0) log('  （codesign ad-hoc 签名失败，可忽略）');
+    }
+
+    fs.writeFileSync(
+      installedMarkerPath(),
+      JSON.stringify(
+        { version, sha256: entry.sha256, installedAt: new Date().toISOString() },
+        null,
+        2,
+      ),
+    );
+    log(`✓ multica v${version} 安装完成：${target}`);
+    applyServerConfigSafe(manifest);
+    printUsage(version);
+  } finally {
+    lock.release();
+  }
+}
+
+function printUsage(version) {
+  log('');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  log(`  multica（daemon 客户端）v${version} 已就绪`);
+  const configPath = require('./server-config').multicaConfigPath();
+  // 以用户配置文件里最终的 server_url 为准（含此前手工配置过的场景）。
+  let effectiveServerUrl = '';
+  try {
+    effectiveServerUrl =
+      JSON.parse(require('fs').readFileSync(configPath, 'utf8')).server_url || '';
+  } catch {
+    // 文件缺失/损坏：走三步指引
+  }
+  if (effectiveServerUrl) {
+    log(`  ✓ 服务器地址已就绪：${configPath}（server_url = ${effectiveServerUrl}）`);
+    log('  接下来请自行完成两步：');
+    log('    1. multica login --token mul_<个人令牌>   ← 令牌在 Web 端“设置→令牌”生成');
+    log('    2. multica daemon start   ← 需本机已装至少一个 agent CLI（claude/codex/opencode…）');
+  } else {
+    log('  接下来请自行完成三步：');
+    log('    1. multica config set server_url https://<服务器地址>');
+    log('    2. multica login --token mul_<个人令牌>   ← 令牌在 Web 端“设置→令牌”生成');
+    log('    3. multica daemon start   ← 需本机已装至少一个 agent CLI（claude/codex/opencode…）');
+  }
+  log('  日常管理：multica daemon status / logs / stop');
+  log('  提示“multica 不是命令” → 重新打开终端，或用 npx multica ...');
+  log('  本包只负责安装与部署级配置：不会写 token、不会登录、不会启动 daemon。');
+  log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+}
+
+install().catch((err) => {
+  log(`✗ 安装脚本异常：${err.stack || err.message}`);
+  hintRunRebuild();
+  process.exitCode = 1;
+});