@sfmc-bds/bds-tools 0.1.0 → 0.2.0-beta.0

package/dist/check-update.js

@@ -1,16 +1,8 @@
-/**
- * check-update.ts — BDS 自动更新器 (主流程)
- *
- *   1. 临时 staging 目录 (mkdtempSync) - 避免污染 SCRIPT_DIR
- *   2. 下载/解压失败 → 自动从备份回滚 preserves
- *   3. 流式 SHA256 校验 - 不把 250MB 文件读入内存
- *   4. 兼容版本白名单 - 不匹配则跳过升级
- *   5. QQ 通知统一加 5s 超时 - 永远不阻塞主流程
- *   6. Rollback marker 落盘 - 跨进程 / 跨重启可恢复
- */
-import { createFileSink, createLogger, createStdoutSink } from "@sfmc-bds/sdk/logs";
-import cliProgress from "cli-progress";
-import JSZip from "jszip";
+import {
+  bindByteProgressToBar,
+  createNodeServiceLogger,
+  createTerminalProgress
+} from "@sfmc-bds/sdk/logs";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -18,425 +10,393 @@ import { createBdsManager } from "./bds-manager.js";
 import { CHANGELOG_BASE, fetchChangelog } from "./changelog.js";
 import { copyDirSync, emptyDirSync, hashFileAsync, rmSafe } from "./fsx.js";
 import { httpDownload } from "./http.js";
+import { isMainModule } from "./is-main.js";
 import { loadConfig, LOG_PATH, resolvePaths } from "./paths.js";
 import { sendText, sendWithImage } from "./qqutil.js";
-import { clearRollbackMarker, getDirSize, rollbackFromBackup, verifyBdsInstall, writeRollbackMarker, } from "./rollback.js";
+import {
+  clearRollbackMarker,
+  getDirSize,
+  rollbackFromBackup,
+  verifyBdsInstall,
+  writeRollbackMarker
+} from "./rollback.js";
+import { ensureEmitServerTelemetry } from "./server-properties.js";
 import { clearTaskbarProgress, isTaskbarSupported, setTaskbarProgress } from "./taskbar.js";
-import { buildDownloadUrls, fetchVersionDetails, getVersionInfo, isVersionCompatible, verifyFileHash, } from "./upstream.js";
+import { emitUpdateResult } from "./update-result.js";
+import {
+  buildDownloadUrls,
+  fetchVersionDetails,
+  getVersionInfo,
+  isVersionCompatible,
+  verifyFileHash
+} from "./upstream.js";
 import { compareVersions, getCurrentVersionAsync, getCurrentVersionSync, saveVersionCache } from "./version.js";
-// 独立入口:source = "updater",与 bds-manager 的 "bds-tools" 区分
-const updaterFileSink = createFileSink(LOG_PATH);
-const log = createLogger({ source: "updater", sinks: [createStdoutSink({ bare: true }), updaterFileSink] });
-const closeLog = () => updaterFileSink.close();
+import { extractZipFileToDir } from "./zipx.js";
+const log = createNodeServiceLogger({ source: "updater", logPath: LOG_PATH });
+const closeLog = () => log.close();
 function parseArgs(argv) {
-    const out = {};
-    for (const a of argv) {
-        const m = a.match(/^--([\w-]+)(?:=(.+))?$/);
-        if (m)
-            out[m[1]] = m[2] || true;
-    }
-    return out;
+  const out = {};
+  for (const a of argv) {
+    const m = a.match(/^--([\w-]+)(?:=(.+))?$/);
+    if (m) out[m[1]] = m[2] || true;
+  }
+  return out;
 }
 function buildContext() {
-    const cfg = loadConfig();
-    const args = parseArgs(process.argv.slice(2));
-    const { bds_path, backup_dir, preserve } = resolvePaths(cfg);
-    const channel = String(args["channel"] || cfg.channel || "release");
-    return {
-        cfg,
-        channel,
-        checkOnly: !!args["check-only"],
-        force: !!args["force"],
-        bdsPath: bds_path,
-        backupDir: backup_dir,
-        preserve,
-        autoRestart: !args["no-start"] && cfg.auto_restart !== false,
-        qqNotify: !!cfg.qq_notify,
-    };
+  const cfg = loadConfig();
+  const args = parseArgs(process.argv.slice(2));
+  const { bds_path, backup_dir, preserve } = resolvePaths(cfg);
+  const channel = String(args["channel"] || cfg.channel || "release");
+  return {
+    cfg,
+    channel,
+    checkOnly: !!args["check-only"],
+    force: !!args["force"],
+    bdsPath: bds_path,
+    backupDir: backup_dir,
+    preserve,
+    autoRestart: !args["no-start"] && cfg.auto_restart !== false,
+    qqNotify: !!cfg.qq_notify
+  };
 }
 async function doBackup(bdsPath, backupDir, preserve) {
-    const dateStr = new Date().toISOString().slice(0, 10);
-    const dest = path.join(backupDir, dateStr);
-    fs.mkdirSync(dest, { recursive: true });
-    let anyCopied = false;
-    for (const item of preserve) {
-        const src = path.join(bdsPath, item);
-        const target = path.join(dest, item);
-        if (!fs.existsSync(src))
-            continue;
-        fs.mkdirSync(path.dirname(target), { recursive: true });
-        if (fs.statSync(src).isDirectory())
-            copyDirSync(src, target);
-        else
-            fs.copyFileSync(src, target);
-        anyCopied = true;
-        log.info(`已备份: ${item}`);
-    }
-    // 即使全部 preserve 都跳过，也让目录存在以便记录时间戳
-    if (!anyCopied) {
-        log.info(`没有需要备份的文件 (preserve 列表为空或全部缺失)`);
-    }
-    return { path: dest, size: getDirSize(dest) };
+  const dateStr = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const dest = path.join(backupDir, dateStr);
+  fs.mkdirSync(dest, { recursive: true });
+  let anyCopied = false;
+  for (const item of preserve) {
+    const src = path.join(bdsPath, item);
+    const target = path.join(dest, item);
+    if (!fs.existsSync(src)) continue;
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    if (fs.statSync(src).isDirectory()) copyDirSync(src, target);
+    else fs.copyFileSync(src, target);
+    anyCopied = true;
+    log.info(`\u5DF2\u5907\u4EFD: ${item}`);
+  }
+  if (!anyCopied) {
+    log.info(`\u6CA1\u6709\u9700\u8981\u5907\u4EFD\u7684\u6587\u4EF6 (preserve \u5217\u8868\u4E3A\u7A7A\u6216\u5168\u90E8\u7F3A\u5931)`);
+  }
+  return { path: dest, size: getDirSize(dest) };
 }
-/** 异步恢复 preserves 从备份到 BDS 路径 */
 async function restorePreserves(bdsPath, backupDir, preserve) {
-    for (const item of preserve) {
-        const src = path.join(backupDir, item);
-        const dest = path.join(bdsPath, item);
-        if (!fs.existsSync(src))
-            continue;
-        try {
-            if (fs.statSync(src).isDirectory()) {
-                if (fs.existsSync(dest))
-                    emptyDirSync(dest);
-                copyDirSync(src, dest);
-            }
-            else {
-                fs.mkdirSync(path.dirname(dest), { recursive: true });
-                fs.copyFileSync(src, dest);
-            }
-            log.info(`已恢复: ${item}`);
-        }
-        catch (e) {
-            log.warn(`恢复失败 ${item}: ${e.message}`);
-        }
+  for (const item of preserve) {
+    const src = path.join(backupDir, item);
+    const dest = path.join(bdsPath, item);
+    if (!fs.existsSync(src)) continue;
+    try {
+      if (fs.statSync(src).isDirectory()) {
+        if (fs.existsSync(dest)) emptyDirSync(dest);
+        copyDirSync(src, dest);
+      } else {
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.copyFileSync(src, dest);
+      }
+      log.info(`\u5DF2\u6062\u590D: ${item}`);
+    } catch (e) {
+      log.warn(`\u6062\u590D\u5931\u8D25 ${item}: ${e.message}`);
     }
+  }
 }
-/** 把 srcDir 下的内容移动到 destDir (覆盖) */
 async function extractZipToBds(zipPath, destDir) {
-    const data = await fs.promises.readFile(zipPath);
-    const zip = await JSZip.loadAsync(data);
-    // 抽出到临时目录，避免旧内容干扰
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "bds-extract-"));
-    try {
-        const entries = Object.values(zip.files);
-        for (const e of entries) {
-            const out = path.join(tmpDir, e.name);
-            if (e.dir) {
-                fs.mkdirSync(out, { recursive: true });
-                continue;
-            }
-            fs.mkdirSync(path.dirname(out), { recursive: true });
-            const buf = await e.async("nodebuffer");
-            fs.writeFileSync(out, buf);
-        }
-        // 把临时目录里的内容复制到 BDS 路径
-        for (const entry of fs.readdirSync(tmpDir)) {
-            const srcPath = path.join(tmpDir, entry);
-            const destPath = path.join(destDir, entry);
-            if (fs.statSync(srcPath).isDirectory()) {
-                if (fs.existsSync(destPath))
-                    emptyDirSync(destPath);
-                copyDirSync(srcPath, destPath);
-            }
-            else {
-                fs.copyFileSync(srcPath, destPath);
-            }
-        }
-    }
-    finally {
-        rmSafe(tmpDir);
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "bds-extract-"));
+  try {
+    await extractZipFileToDir(zipPath, tmpDir);
+    for (const entry of fs.readdirSync(tmpDir)) {
+      const srcPath = path.join(tmpDir, entry);
+      const destPath = path.join(destDir, entry);
+      if (fs.statSync(srcPath).isDirectory()) {
+        if (fs.existsSync(destPath)) emptyDirSync(destPath);
+        copyDirSync(srcPath, destPath);
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+      }
     }
+  } finally {
+    rmSafe(tmpDir);
+  }
 }
-export async function runUpdate() {
-    const startTime = Date.now();
-    const ctx = buildContext();
-    const { cfg, channel, checkOnly, force, bdsPath, backupDir, preserve, autoRestart, qqNotify } = ctx;
-    log.info(`===== 开始检查更新 (${channel}) =====`);
-    fs.mkdirSync(bdsPath, { recursive: true });
-    fs.mkdirSync(backupDir, { recursive: true });
-    // 1. 当前版本
-    const exePath = path.join(bdsPath, "bedrock_server.exe");
-    const currentVer = await getCurrentVersionAsync(exePath).catch(() => getCurrentVersionSync(exePath));
-    log.info(`当前版本: ${currentVer}`);
-    // 2. 获取最新版本
-    let latestVer;
-    try {
-        const info = await getVersionInfo(cfg, channel);
-        latestVer = info.version;
-        log.info(`最新版本: ${latestVer}`);
-        const cmp = compareVersions(latestVer, currentVer);
-        if (cmp <= 0 && !force) {
-            log.info("已是最新版本，无需更新");
-            if (qqNotify) {
-                await sendText(`✅ BDS 已是最新版本\n\n当前: ${currentVer}\n最新: ${latestVer}`);
-            }
-            console.log(`CURRENT=${currentVer}`);
-            console.log(`LATEST=${latestVer}`);
-            return 0;
-        }
+async function runUpdate() {
+  const startTime = Date.now();
+  const ctx = buildContext();
+  const { cfg, channel, checkOnly, force, bdsPath, backupDir, preserve, autoRestart, qqNotify } = ctx;
+  log.info(`===== \u5F00\u59CB\u68C0\u67E5\u66F4\u65B0 (${channel}) =====`);
+  fs.mkdirSync(bdsPath, { recursive: true });
+  fs.mkdirSync(backupDir, { recursive: true });
+  const exePath = path.join(bdsPath, "bedrock_server.exe");
+  const currentVer = await getCurrentVersionAsync(exePath).catch(() => getCurrentVersionSync(exePath));
+  log.info(`\u5F53\u524D\u7248\u672C: ${currentVer}`);
+  let latestVer;
+  try {
+    const info = await getVersionInfo(cfg, channel);
+    latestVer = info.version;
+    log.info(`\u6700\u65B0\u7248\u672C: ${latestVer}`);
+    const cmp = compareVersions(latestVer, currentVer);
+    if (cmp <= 0 && !force) {
+      log.info("\u5DF2\u662F\u6700\u65B0\u7248\u672C\uFF0C\u65E0\u9700\u66F4\u65B0");
+      if (qqNotify) {
+        await sendText(`\u2705 BDS \u5DF2\u662F\u6700\u65B0\u7248\u672C
+
+\u5F53\u524D: ${currentVer}
+\u6700\u65B0: ${latestVer}`);
+      }
+      console.log(`CURRENT=${currentVer}`);
+      console.log(`LATEST=${latestVer}`);
+      emitUpdateResult("uptodate");
+      return 0;
     }
-    catch (e) {
-        log.error(`获取版本信息失败: ${e.message}`);
-        await sendText(`❌ BDS 更新失败\n\n无法获取版本信息: ${e.message}`);
-        return 1;
-    }
-    // 兼容性检查
-    if (!force && !isVersionCompatible(cfg, latestVer)) {
-        log.warn(`${latestVer} 不在兼容版本白名单中，跳过升级`);
-        if (qqNotify) {
-            await sendText(`⚠️ BDS ${latestVer} 不在兼容性白名单，已跳过升级。请人工确认。`);
-        }
-        return 2;
-    }
-    // 3. 取下载链接
-    let downloadUrls;
-    let hash;
-    try {
-        const details = await fetchVersionDetails(cfg, channel, latestVer);
-        downloadUrls = buildDownloadUrls(cfg, channel, latestVer, details);
-        hash = { sha1: details.sha1, sha256: details.sha256 };
-    }
-    catch (e) {
-        log.error(`获取下载详情失败: ${e.message}`);
-        await sendText(`❌ BDS 更新失败\n\n下载详情获取失败: ${e.message}`);
-        return 1;
-    }
-    if (checkOnly) {
-        console.log(`CURRENT=${currentVer}`);
-        console.log(`LATEST=${latestVer}`);
-        console.log(`CHANNEL=${channel}`);
-        console.log(`URLS=${downloadUrls.length}`);
-        return 0;
-    }
-    log.info(`发现新版本: ${currentVer} → ${latestVer}`);
-    // 4. QQ 预告
+  } catch (e) {
+    log.error(`\u83B7\u53D6\u7248\u672C\u4FE1\u606F\u5931\u8D25: ${e.message}`);
+    await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u65E0\u6CD5\u83B7\u53D6\u7248\u672C\u4FE1\u606F: ${e.message}`);
+    return 1;
+  }
+  if (!force && !isVersionCompatible(cfg, latestVer)) {
+    log.warn(`${latestVer} \u4E0D\u5728\u517C\u5BB9\u7248\u672C\u767D\u540D\u5355\u4E2D\uFF0C\u8DF3\u8FC7\u5347\u7EA7`);
     if (qqNotify) {
-        await sendText(`𝐌𝐢𝐧𝐞𝐜𝐫𝐚𝐟𝐭 𝐁𝐃𝐒 更新通知\n\n` +
-            `检测到新版本！\n\n` +
-            `当前: ${currentVer}\n` +
-            `最新: ${latestVer}\n` +
-            `频道: ${channel === "preview" ? "预览版" : "正式版"}\n\n` +
-            `服务器即将开始更新~ 请耐心等待^(*￣(oo)￣)^`);
-        const cl = await fetchChangelog(channel);
-        if (cl) {
-            const text = `📋 更新内容概要\n\n${cl.text.slice(0, 1500)}\n\n完整日志: ${CHANGELOG_BASE}`;
-            if (cl.imageBase64)
-                await sendWithImage(text, cl.imageBase64);
-            else
-                await sendText(text);
-        }
-        else {
-            await sendText(`📋 更新日志: ${CHANGELOG_BASE}`);
-        }
-    }
-    // 5. 备份
-    let backupInfo;
-    try {
-        backupInfo = await doBackup(bdsPath, backupDir, preserve);
-        log.info(`备份完成: ${backupInfo.path} (${(backupInfo.size / 1024 / 1024).toFixed(1)} MB)`);
-        if (qqNotify) {
-            await sendText(`✅ 备份完成\n\n大小: ${(backupInfo.size / 1024 / 1024).toFixed(1)} MB\n位置: ${backupInfo.path}`);
-        }
+      await sendText(`\u26A0\uFE0F BDS ${latestVer} \u4E0D\u5728\u517C\u5BB9\u6027\u767D\u540D\u5355\uFF0C\u5DF2\u8DF3\u8FC7\u5347\u7EA7\u3002\u8BF7\u4EBA\u5DE5\u786E\u8BA4\u3002`);
     }
-    catch (e) {
-        log.error(`备份失败: ${e.message}`);
-        await sendText(`❌ BDS 更新失败\n\n备份失败: ${e.message}\n操作已中止`);
-        return 1;
+    emitUpdateResult("skipped");
+    return 2;
+  }
+  let downloadUrls;
+  let hash;
+  try {
+    const details = await fetchVersionDetails(cfg, channel, latestVer);
+    downloadUrls = buildDownloadUrls(cfg, channel, latestVer, details);
+    hash = { sha1: details.sha1, sha256: details.sha256 };
+  } catch (e) {
+    log.error(`\u83B7\u53D6\u4E0B\u8F7D\u8BE6\u60C5\u5931\u8D25: ${e.message}`);
+    await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u4E0B\u8F7D\u8BE6\u60C5\u83B7\u53D6\u5931\u8D25: ${e.message}`);
+    return 1;
+  }
+  if (checkOnly) {
+    console.log(`CURRENT=${currentVer}`);
+    console.log(`LATEST=${latestVer}`);
+    console.log(`CHANNEL=${channel}`);
+    console.log(`URLS=${downloadUrls.length}`);
+    emitUpdateResult("check-only");
+    return 0;
+  }
+  log.info(`\u53D1\u73B0\u65B0\u7248\u672C: ${currentVer} \u2192 ${latestVer}`);
+  if (qqNotify) {
+    await sendText(
+      `\u{1D40C}\u{1D422}\u{1D427}\u{1D41E}\u{1D41C}\u{1D42B}\u{1D41A}\u{1D41F}\u{1D42D} \u{1D401}\u{1D403}\u{1D412} \u66F4\u65B0\u901A\u77E5
+
+\u68C0\u6D4B\u5230\u65B0\u7248\u672C\uFF01
+
+\u5F53\u524D: ${currentVer}
+\u6700\u65B0: ${latestVer}
+\u9891\u9053: ${channel === "preview" ? "\u9884\u89C8\u7248" : "\u6B63\u5F0F\u7248"}
+
+\u670D\u52A1\u5668\u5373\u5C06\u5F00\u59CB\u66F4\u65B0~ \u8BF7\u8010\u5FC3\u7B49\u5F85^(*\uFFE3(oo)\uFFE3)^`
+    );
+    const cl = await fetchChangelog(channel);
+    if (cl) {
+      const text = `\u{1F4CB} \u66F4\u65B0\u5185\u5BB9\u6982\u8981
+
+${cl.text.slice(0, 1500)}
+
+\u5B8C\u6574\u65E5\u5FD7: ${CHANGELOG_BASE}`;
+      if (cl.imageBase64) await sendWithImage(text, cl.imageBase64);
+      else await sendText(text);
+    } else {
+      await sendText(`\u{1F4CB} \u66F4\u65B0\u65E5\u5FD7: ${CHANGELOG_BASE}`);
     }
-    // 6. 写回滚标记 (跨进程可恢复)
-    writeRollbackMarker({
-        timestamp: Date.now(),
-        bds_path: bdsPath,
-        backup_dir: backupInfo.path,
-        preserve,
-        previous_version: currentVer,
-    });
-    // 7. 停服
-    const bds = createBdsManager({ detached: true });
-    try {
-        log.info("停止 BDS 服务...");
-        await bds.stop();
-        log.info("BDS 已停止");
+  }
+  let backupInfo;
+  try {
+    backupInfo = await doBackup(bdsPath, backupDir, preserve);
+    log.info(`\u5907\u4EFD\u5B8C\u6210: ${backupInfo.path} (${(backupInfo.size / 1024 / 1024).toFixed(1)} MB)`);
+    if (qqNotify) {
+      await sendText(`\u2705 \u5907\u4EFD\u5B8C\u6210
+
+\u5927\u5C0F: ${(backupInfo.size / 1024 / 1024).toFixed(1)} MB
+\u4F4D\u7F6E: ${backupInfo.path}`);
     }
-    catch (e) {
-        log.warn(`BDS 停止异常: ${e.message}`);
+  } catch (e) {
+    log.error(`\u5907\u4EFD\u5931\u8D25: ${e.message}`);
+    await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u5907\u4EFD\u5931\u8D25: ${e.message}
+\u64CD\u4F5C\u5DF2\u4E2D\u6B62`);
+    return 1;
+  }
+  writeRollbackMarker({
+    timestamp: Date.now(),
+    bds_path: bdsPath,
+    backup_dir: backupInfo.path,
+    preserve,
+    previous_version: currentVer
+  });
+  const bds = createBdsManager({ detached: true });
+  try {
+    log.info("\u505C\u6B62 BDS \u670D\u52A1...");
+    await bds.stop();
+    log.info("BDS \u5DF2\u505C\u6B62");
+  } catch (e) {
+    log.warn(`BDS \u505C\u6B62\u5F02\u5E38: ${e.message}`);
+  }
+  const stagingDir = fs.mkdtempSync(path.join(os.tmpdir(), "bds-update-"));
+  const zipPath = path.join(stagingDir, `bedrock-server-${latestVer}.zip`);
+  let downloaded = false;
+  try {
+    log.info(`\u5F00\u59CB\u4E0B\u8F7D ${latestVer}...`);
+    if (qqNotify) await sendText(`\u{1F4E5} \u6B63\u5728\u4E0B\u8F7D BDS ${latestVer}...`);
+    let lastErr = null;
+    const downloadTimeoutMs = (cfg.download_timeout ?? 120) * 1e3;
+    if (isTaskbarSupported() && process.stdout.isTTY) {
+      log.info("\u68C0\u6D4B\u5230 Windows Terminal,\u4EFB\u52A1\u680F\u8FDB\u5EA6\u5DF2\u542F\u7528 (OSC 9;4)");
     }
-    // 8. 下载 (全部失败则回滚)
-    // 用 mkdtempSync 创建临时 staging 目录 - 避免污染 SCRIPT_DIR
-    const stagingDir = fs.mkdtempSync(path.join(os.tmpdir(), "bds-update-"));
-    const zipPath = path.join(stagingDir, `bedrock-server-${latestVer}.zip`);
-    let downloaded = false;
-    try {
-        log.info(`开始下载 ${latestVer}...`);
-        if (qqNotify)
-            await sendText(`📥 正在下载 BDS ${latestVer}...`);
-        let lastErr = null;
-        const downloadTimeoutMs = (cfg.download_timeout ?? 120) * 1000;
-        const progressBar = new cliProgress.SingleBar({
-            format: "下载进度 | {bar} | {percentage}% | {value}/{total} MB | 速度: {speed}",
-            barCompleteChar: "\u2588",
-            barIncompleteChar: "\u2591",
-            hideCursor: true,
-            clearOnComplete: false, // 保留进度条
-        }, cliProgress.Presets.shades_classic);
-        let lastTime = Date.now();
-        let lastLoaded = 0;
-        let barStarted = false; // 标记是否已启动
-        if (isTaskbarSupported()) {
-            log.info("检测到 Windows Terminal,任务栏进度已启用 (OSC 9;4)");
-        }
-        for (const url of downloadUrls) {
-            try {
-                await httpDownload(url, zipPath, {
-                    totalTimeoutMs: Math.max(downloadTimeoutMs, 600_000), // 不少于 10 分钟
-                    onProgress: (dl, total) => {
-                        // 第一次触发时启动进度条
-                        if (!barStarted) {
-                            progressBar.start(total, 0, { speed: "0 KB/s" });
-                            barStarted = true;
-                            setTaskbarProgress(0); // 启动任务栏进度(0%)
-                        }
-                        const now = Date.now();
-                        const timeDelta = (now - lastTime) / 1000; // 秒
-                        const bytesDelta = dl - lastLoaded;
-                        const speed = timeDelta > 0 ? bytesDelta / timeDelta : 0;
-                        const speedStr = speed > 1024 * 1024
-                            ? `${(speed / 1024 / 1024).toFixed(1)} MB/s`
-                            : speed > 1024
-                                ? `${(speed / 1024).toFixed(1)} KB/s`
-                                : `${speed.toFixed(0)} B/s`;
-                        progressBar.update(dl, { speed: speedStr });
-                        // 同步任务栏进度(0-100)。httpDownload 内部已做 100ms 节流,
-                        // 这里再 set 一次,getSnapshot 比较,相同值直接跳过
-                        setTaskbarProgress((dl / total) * 100);
-                        lastLoaded = dl;
-                        lastTime = now;
-                    },
-                });
-                progressBar.stop();
-                // 下载完成,任务栏收到 100% 绿条后清掉
-                setTaskbarProgress(100);
-                clearTaskbarProgress();
-                downloaded = true;
-                lastErr = null;
-                break;
-            }
-            catch (e) {
-                if (barStarted)
-                    progressBar.stop();
-                // 下载失败,任务栏亮红
-                setTaskbarProgress(100, "error");
-                clearTaskbarProgress();
-                lastErr = e;
-                log.warn(`${url} 不可用: ${lastErr.message}，尝试备用地址...`);
-            }
+    for (const url of downloadUrls) {
+      const progressBar = createTerminalProgress({
+        stream: process.stderr,
+        logger: (msg) => log.info(msg.startsWith("\u8FDB\u5EA6") ? `\u4E0B\u8F7D${msg.slice(2)}` : msg),
+        format: "\u4E0B\u8F7D\u8FDB\u5EA6 | {bar} | {percentage}% | {value}/{total} MB | \u901F\u5EA6: {speed}"
+      });
+      const onByteProgress = bindByteProgressToBar(progressBar, {
+        speedSampleMs: 0,
+        onProgress: (dl, total) => {
+          const pct = total > 0 ? dl / total * 100 : 0;
+          setTaskbarProgress(pct);
         }
-        if (!downloaded && lastErr)
-            throw lastErr;
-        const zipSizeMB = (fs.statSync(zipPath).size / 1024 / 1024).toFixed(1);
-        log.info(`下载完成 (${zipSizeMB} MB)`);
-        // 流式哈希校验
-        if (hash.sha1 || hash.sha256) {
-            const algo = hash.sha256 ? "SHA256" : "SHA1";
-            log.info(`校验文件完整性 (${algo})...`);
-            const ok = await verifyFileHash(zipPath, hash.sha1, hash.sha256);
-            if (!ok)
-                throw new Error(`${algo} 校验不通过，文件可能损坏`);
-            log.info(`${algo} 校验通过`);
-        }
-    }
-    catch (e) {
-        log.error(`下载失败: ${e.message}`);
-        await sendText(`❌ BDS 更新失败\n\n下载失败: ${e.message}\nBDS 已停止，请手动恢复`);
-        // 自动回滚
-        rollbackFromBackup({
-            timestamp: Date.now(),
-            bds_path: bdsPath,
-            backup_dir: backupInfo.path,
-            preserve,
-            previous_version: currentVer,
+      });
+      try {
+        setTaskbarProgress(0);
+        await httpDownload(url, zipPath, {
+          totalTimeoutMs: Math.max(downloadTimeoutMs, 6e5),
+          // 不少于 10 分钟
+          onProgress: onByteProgress
         });
-        rmSafe(stagingDir);
-        return 1;
-    }
-    // 9. 解压 + 部署
-    try {
-        log.info("解压中...");
-        // 先清空 BDS 目录
-        emptyDirSync(bdsPath);
-        await extractZipToBds(zipPath, bdsPath);
-        log.info("解压完成");
-    }
-    catch (e) {
-        log.error(`解压失败: ${e.message}`);
-        await sendText(`❌ BDS 更新失败\n\n解压失败: ${e.message}\nBDS 已停止，请手动恢复`);
-        // 回滚: 清空 + 从备份恢复 preserves
-        emptyDirSync(bdsPath);
-        await restorePreserves(bdsPath, backupInfo.path, preserve);
-        rmSafe(stagingDir);
-        return 1;
-    }
-    finally {
-        rmSafe(zipPath); // 清掉 staging zip
+        if (progressBar.active) progressBar.stop();
+        setTaskbarProgress(100);
+        clearTaskbarProgress();
+        downloaded = true;
+        lastErr = null;
+        break;
+      } catch (e) {
+        if (progressBar.active) progressBar.stop();
+        setTaskbarProgress(100, "error");
+        clearTaskbarProgress();
+        lastErr = e;
+        log.warn(`${url} \u4E0D\u53EF\u7528: ${lastErr.message}\uFF0C\u5C1D\u8BD5\u5907\u7528\u5730\u5740...`);
+      }
     }
-    // 10. 完整性检查 (避免解压出空/缺文件的病态包)
-    const verify = verifyBdsInstall(bdsPath, [
-        "bedrock_server.exe",
-        /*"bedrock_server_symbols.debug",*/ "permissions.json",
-    ]);
-    if (!verify.ok) {
-        log.error(`解压后的 BDS 不完整，缺失文件: ${verify.missing.join(", ")}`);
-        await sendText(`❌ BDS 更新失败\n\n部署后缺失关键文件: ${verify.missing.join(", ")}`);
-        emptyDirSync(bdsPath);
-        await restorePreserves(bdsPath, backupInfo.path, preserve);
-        rmSafe(stagingDir);
-        return 1;
+    if (!downloaded && lastErr) throw lastErr;
+    const zipSizeMB = (fs.statSync(zipPath).size / 1024 / 1024).toFixed(1);
+    log.info(`\u4E0B\u8F7D\u5B8C\u6210 (${zipSizeMB} MB)`);
+    if (hash.sha1 || hash.sha256) {
+      const algo = hash.sha256 ? "SHA256" : "SHA1";
+      log.info(`\u6821\u9A8C\u6587\u4EF6\u5B8C\u6574\u6027 (${algo})...`);
+      const ok = await verifyFileHash(zipPath, hash.sha1, hash.sha256);
+      if (!ok) throw new Error(`${algo} \u6821\u9A8C\u4E0D\u901A\u8FC7\uFF0C\u6587\u4EF6\u53EF\u80FD\u635F\u574F`);
+      log.info(`${algo} \u6821\u9A8C\u901A\u8FC7`);
     }
-    // 11. 恢复 preserves (zip 解压时这些目录可能被覆盖)
+  } catch (e) {
+    log.error(`\u4E0B\u8F7D\u5931\u8D25: ${e.message}`);
+    await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u4E0B\u8F7D\u5931\u8D25: ${e.message}
+BDS \u5DF2\u505C\u6B62\uFF0C\u8BF7\u624B\u52A8\u6062\u590D`);
+    rollbackFromBackup({
+      timestamp: Date.now(),
+      bds_path: bdsPath,
+      backup_dir: backupInfo.path,
+      preserve,
+      previous_version: currentVer
+    });
+    rmSafe(stagingDir);
+    return 1;
+  }
+  try {
+    log.info("\u89E3\u538B\u4E2D...");
+    emptyDirSync(bdsPath);
+    await extractZipToBds(zipPath, bdsPath);
+    log.info("\u89E3\u538B\u5B8C\u6210");
+  } catch (e) {
+    log.error(`\u89E3\u538B\u5931\u8D25: ${e.message}`);
+    await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u89E3\u538B\u5931\u8D25: ${e.message}
+BDS \u5DF2\u505C\u6B62\uFF0C\u8BF7\u624B\u52A8\u6062\u590D`);
+    emptyDirSync(bdsPath);
     await restorePreserves(bdsPath, backupInfo.path, preserve);
-    // 12. 写入版本缓存
-    const newExeHash = await hashFileAsync(exePath, "sha256").catch(() => "");
-    if (newExeHash) {
-        saveVersionCache(latestVer, newExeHash);
-        log.info(`已记录版本 ${latestVer} 的 SHA256`);
-    }
-    // 13. 启动 BDS
-    if (autoRestart) {
-        try {
-            log.info("启动 BDS...");
-            await bds.start();
-        }
-        catch (e) {
-            log.error(`启动失败: ${e.message}`);
-            await sendText(`❌ BDS 更新失败\n\n启动失败: ${e.message}\n请手动启动 BDS`);
-            // 注意: 此时 BDS 已经部署完成，启动失败 → 启动问题，不做文件级回滚
-            rmSafe(stagingDir);
-            clearRollbackMarker();
-            return 1;
-        }
-    }
     rmSafe(stagingDir);
-    clearRollbackMarker();
-    // 14. QQ 通知结果
-    const durationMs = Date.now() - startTime;
-    if (qqNotify) {
-        await sendText(`✅ BDS 更新完成\n\n` +
-            `${currentVer} → ${latestVer}\n` +
-            `耗时: ${(durationMs / 1000).toFixed(1)}s\n` +
-            `${autoRestart ? "服务器已重新启动" : "请手动重启服务器"}`);
+    return 1;
+  } finally {
+    rmSafe(zipPath);
+  }
+  const verify = verifyBdsInstall(bdsPath, [
+    "bedrock_server.exe",
+    /*"bedrock_server_symbols.debug",*/
+    "permissions.json"
+  ]);
+  if (!verify.ok) {
+    log.error(`\u89E3\u538B\u540E\u7684 BDS \u4E0D\u5B8C\u6574\uFF0C\u7F3A\u5931\u6587\u4EF6: ${verify.missing.join(", ")}`);
+    await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u90E8\u7F72\u540E\u7F3A\u5931\u5173\u952E\u6587\u4EF6: ${verify.missing.join(", ")}`);
+    emptyDirSync(bdsPath);
+    await restorePreserves(bdsPath, backupInfo.path, preserve);
+    rmSafe(stagingDir);
+    return 1;
+  }
+  await restorePreserves(bdsPath, backupInfo.path, preserve);
+  ensureEmitServerTelemetry(bdsPath, log);
+  const newExeHash = await hashFileAsync(exePath, "sha256").catch(() => "");
+  if (newExeHash) {
+    saveVersionCache(latestVer, newExeHash);
+    log.info(`\u5DF2\u8BB0\u5F55\u7248\u672C ${latestVer} \u7684 SHA256`);
+  }
+  if (autoRestart) {
+    try {
+      log.info("\u542F\u52A8 BDS...");
+      await bds.start();
+    } catch (e) {
+      log.error(`\u542F\u52A8\u5931\u8D25: ${e.message}`);
+      await sendText(`\u274C BDS \u66F4\u65B0\u5931\u8D25
+
+\u542F\u52A8\u5931\u8D25: ${e.message}
+\u8BF7\u624B\u52A8\u542F\u52A8 BDS`);
+      rmSafe(stagingDir);
+      clearRollbackMarker();
+      return 1;
     }
-    log.info(`===== 更新完成 (${(durationMs / 1000).toFixed(1)}s) =====`);
-    return 0;
+  }
+  rmSafe(stagingDir);
+  clearRollbackMarker();
+  const durationMs = Date.now() - startTime;
+  if (qqNotify) {
+    await sendText(
+      `\u2705 BDS \u66F4\u65B0\u5B8C\u6210
+
+${currentVer} \u2192 ${latestVer}
+\u8017\u65F6: ${(durationMs / 1e3).toFixed(1)}s
+${autoRestart ? "\u670D\u52A1\u5668\u5DF2\u91CD\u65B0\u542F\u52A8" : "\u8BF7\u624B\u52A8\u91CD\u542F\u670D\u52A1\u5668"}`
+    );
+  }
+  log.info(`===== \u66F4\u65B0\u5B8C\u6210 (${(durationMs / 1e3).toFixed(1)}s) =====`);
+  emitUpdateResult("deployed");
+  return 0;
 }
 function isMain() {
-    if (process.env.SFMC_SERVICE === "update")
-        return true;
-    if (require.main === module)
-        return true;
-    const entry = process.argv[1] ?? "";
-    return entry.endsWith("check-update.js") || entry.endsWith("check-update.ts");
+  if (process.env.SFMC_SERVICE === "update") return true;
+  return isMainModule(import.meta.url);
 }
 if (isMain()) {
-    runUpdate()
-        .then((code) => {
-        closeLog();
-        process.exit(code);
-    })
-        .catch((e) => {
-        log.error(`未捕获错误: ${e.message}`);
-        closeLog();
-        process.exit(1);
-    });
+  runUpdate().then((code) => {
+    closeLog();
+    process.exit(code);
+  }).catch((e) => {
+    log.error(`\u672A\u6355\u83B7\u9519\u8BEF: ${e.message}`);
+    closeLog();
+    process.exit(1);
+  });
 }
-//# sourceMappingURL=check-update.js.map
+export {
+  runUpdate
+};
+//# sourceMappingURL=check-update.js.map