@sfmc-bds/bds-tools 0.2.0-beta.8 → 0.2.0

package/dist/bds-manager.d.ts

@@ -1,23 +1,33 @@
 /**
- * bds-manager.ts — BDS 进程管理器
+ * bds-manager.ts — Bedrock Dedicated Server (BDS) 进程生命周期管理器
  *
- * 改进:
- *  - 优雅 stop (发送 stop 命令 → 等待退出 → SIGTERM → SIGKILL)
- *  - watchdog (崩溃自动重启)
- *  - 单例事件发射器
- *  - 完全异步 (fs/promises)
+ * 核心职责：
+ * - 优雅停服：向标准输入发送 `stop` 命令等待自然退出，超时后逐步升级至 SIGTERM 与 SIGKILL
+ * - 守护监视（watch）：监听进程退出事件并在异常退出时自动延时重启恢复
+ * - 生命周期事件广播：分发启动、停止、崩溃等事件，触发运维告警与状态同步
+ * - 管道交互与探活：检测进程存活状态并向 BDS stdin 投递控制台指令
  */
 import { EventEmitter } from "node:events";
+/** BDS 进程管理器统一操作接口。 */
 export interface BdsManager {
+    /** 启动 BDS 服务进程。 */
     start(): Promise<void>;
+    /** 优雅停止 BDS 服务进程。 */
     stop(): Promise<void>;
+    /** 查询 BDS 进程当前是否处于运行状态。 */
     status(): Promise<boolean>;
+    /** 向 BDS 控制台管道发送指令。 */
     sendCommand(cmd: string): boolean;
+    /** 开启守护监视模式（异常退出时自动拉起）。 */
     watch(): Promise<void>;
+    /** 进程生命周期事件发射器。 */
     events: EventEmitter;
+    /** 当前是否属于主动调用停服。 */
     isManualStop: boolean;
+    /** 获取当前运行中 BDS 进程的 PID。 */
     getPid(): number;
 }
+/** BDS 进程启动选项。 */
 export interface BdsManagerOptions {
     detached?: boolean;
 }

package/dist/bds-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bds-manager.d.ts","sourceRoot":"","sources":["../src/bds-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAqED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA0K5E;AAED,eAAO,MAAM,SAAS,EAAE,YAAiC,CAAC;AAC1D,eAAO,MAAM,iBAAiB,QAAO,IAA2C,CAAC"}
+{"version":3,"file":"bds-manager.d.ts","sourceRoot":"","sources":["../src/bds-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C,uBAAuB;AACvB,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,qBAAqB;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,2BAA2B;IAC3B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,uBAAuB;IACvB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mBAAmB;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,kBAAkB;AAClB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+BD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAkM5E;AAED,eAAO,MAAM,SAAS,EAAE,YAAiC,CAAC;AAC1D,eAAO,MAAM,iBAAiB,QAAO,IAEpC,CAAC"}

package/dist/bds-manager.js

@@ -1,52 +1,28 @@
-import { spawn, exec } from "node:child_process";
-import { promisify } from "node:util";
+import { spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { EventEmitter } from "node:events";
+import { bdsExePath, bdsSpawnEnvExtra, ensureBdsExecutable } from "./host-platform.js";
 import { isMainModule } from "./is-main.js";
-import { ensureStateDir, loadConfig, PID_FILE } from "./paths.js";
+import { loadConfig, ROOT_DIR } from "./paths.js";
 import { log } from "./log.js";
-import { ensureEmitServerTelemetry } from "./server-properties.js";
-const execAsync = promisify(exec);
+import { postBdsLifecycleEvent } from "./qq-events-notify.js";
+import { ensureEmitServerTelemetry, ensureNetherNetTransport, localizeServerProperties } from "./server-properties.js";
+import {
+  clearBdsPidFile,
+  findBedrockServerPids,
+  isProcessAlive,
+  isProcessAliveSync,
+  killBedrockServerByImage,
+  readBdsPidFile,
+  writeBdsPidFile
+} from "./process-probe.js";
 let cached = null;
-function readPid() {
-  try {
-    return parseInt(fs.readFileSync(PID_FILE, "utf-8").trim(), 10) || 0;
-  } catch {
-    return 0;
-  }
-}
-function writePid(pid) {
-  try {
-    ensureStateDir();
-    fs.writeFileSync(PID_FILE, String(pid));
-  } catch {
-  }
-}
-function clearPid() {
-  try {
-    if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);
-  } catch {
-  }
-}
-async function isAlive(pid) {
-  if (!pid) return false;
-  try {
-    if (process.platform === "win32") {
-      const { stdout } = await execAsync(`tasklist /fi "PID eq ${pid}" /nh`, { windowsHide: true });
-      return stdout.includes(String(pid));
-    }
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
 function ensureProc() {
   if (cached) return cached;
   const cfg = loadConfig();
   const bds_path = path.resolve(cfg.bds_path || process.cwd());
-  const exePath = path.join(bds_path, "bedrock_server.exe");
+  const exePath = bdsExePath(bds_path);
   cached = {
     process: null,
     isManualStop: false,
@@ -62,8 +38,8 @@ function createBdsManager(options = {}) {
   events.setMaxListeners(100);
   const sendCommand = (cmd) => {
     const p = ensureProc();
-    const pid = readPid();
-    if (!pid || !isAlive(pid)) {
+    const pid = readBdsPidFile(ROOT_DIR);
+    if (!pid || !isProcessAliveSync(pid)) {
       log.warn("BDS \u672A\u8FD0\u884C");
       return false;
     }
@@ -81,14 +57,25 @@ function createBdsManager(options = {}) {
   };
   const stop = async () => {
     const p = ensureProc();
-    const pid = readPid();
-    if (!pid || !await isAlive(pid)) {
+    p.isManualStop = true;
+    const pid = readBdsPidFile(ROOT_DIR);
+    if (!pid || !await isProcessAlive(pid)) {
+      const externalPids = await findBedrockServerPids();
+      if (externalPids.length > 0) {
+        log.info("\u68C0\u6D4B\u5230\u5916\u90E8\u8FD0\u884C\u7684 BDS \u8FDB\u7A0B\uFF0C\u4F7F\u7528 taskkill \u7EC8\u6B62...");
+        await killBedrockServerByImage();
+        clearBdsPidFile(ROOT_DIR);
+        p.process = null;
+        log.info("BDS \u5DF2\u505C\u6B62");
+        void postBdsLifecycleEvent("stop");
+        return;
+      }
       log.info("BDS \u672A\u8FD0\u884C");
-      clearPid();
+      clearBdsPidFile(ROOT_DIR);
+      p.isManualStop = false;
       return;
     }
     if (p.process && p.process.pid === pid && p.process.stdin) {
-      p.isManualStop = true;
       log.info("\u6B63\u5728\u5173\u95ED BDS...");
       try {
         p.process.stdin.write("stop\n");
@@ -117,42 +104,42 @@ function createBdsManager(options = {}) {
       }
     } else {
       log.info("BDS \u7531\u5916\u90E8\u542F\u52A8\uFF0C\u4F7F\u7528 taskkill...");
-      try {
-        if (process.platform === "win32") {
-          await execAsync("taskkill /f /im bedrock_server.exe", { windowsHide: true });
-        } else {
-          await execAsync("pkill -f bedrock_server", { windowsHide: true });
-        }
-      } catch {
-      }
+      await killBedrockServerByImage();
+      void postBdsLifecycleEvent("stop");
     }
-    clearPid();
+    clearBdsPidFile(ROOT_DIR);
     p.process = null;
     log.info("BDS \u5DF2\u505C\u6B62");
   };
   const start = async () => {
     const p = ensureProc();
-    const existing = readPid();
-    if (existing && await isAlive(existing)) {
+    const existing = readBdsPidFile(ROOT_DIR);
+    if (existing && await isProcessAlive(existing)) {
       log.info("BDS \u5DF2\u5728\u8FD0\u884C\u4E2D");
       return;
     }
     if (!fs.existsSync(p.exePath)) {
       log.error(`\u672A\u627E\u5230 ${p.exePath}`);
-      throw new Error(`bedrock_server.exe \u4E0D\u5B58\u5728: ${p.exePath}`);
+      throw new Error(`BDS \u53EF\u6267\u884C\u6587\u4EF6\u4E0D\u5B58\u5728: ${p.exePath}`);
     }
     ensureEmitServerTelemetry(p.bdsPath, log);
+    ensureNetherNetTransport(p.bdsPath, log);
+    localizeServerProperties(p.bdsPath, { logger: log, rootDir: ROOT_DIR });
+    ensureBdsExecutable(p.exePath);
     log.info("\u6B63\u5728\u542F\u52A8 BDS...");
+    p.isManualStop = false;
     const child = spawn(p.exePath, [], {
       cwd: p.bdsPath,
+      env: { ...process.env, ...bdsSpawnEnvExtra(p.bdsPath) },
       stdio: options.detached ? "ignore" : ["pipe", "pipe", "pipe"],
       detached: options.detached,
       windowsHide: true
     });
     if (options.detached) child.unref();
     p.process = child;
-    writePid(child.pid ?? 0);
+    writeBdsPidFile(child.pid ?? 0, ROOT_DIR);
     log.info(`BDS \u5DF2\u542F\u52A8 (PID: ${child.pid})`);
+    void postBdsLifecycleEvent("start", `pid=${child.pid ?? 0}`);
     child.stdout?.on("data", (chunk) => {
       const text = chunk.toString();
       events.emit("output", text);
@@ -165,9 +152,15 @@ function createBdsManager(options = {}) {
     });
     child.on("exit", (code) => {
       log.info(`BDS \u5DF2\u9000\u51FA (code: ${code})`);
-      clearPid();
+      clearBdsPidFile(ROOT_DIR);
       p.process = null;
-      if (!p.isManualStop && p.crashRestart && isMain()) {
+      const wasManual = p.isManualStop;
+      if (!wasManual) {
+        void postBdsLifecycleEvent("crash", `code=${code ?? "?"}`);
+      } else {
+        void postBdsLifecycleEvent("stop");
+      }
+      if (!wasManual && p.crashRestart && isMain()) {
         log.info(`BDS \u610F\u5916\u9000\u51FA\uFF0C${p.crashDelayMs / 1e3}s \u540E\u81EA\u52A8\u91CD\u542F...`);
         setTimeout(() => {
           start().catch((e) => log.error(`\u81EA\u52A8\u91CD\u542F\u5931\u8D25: ${e.message}`));
@@ -177,21 +170,21 @@ function createBdsManager(options = {}) {
     });
   };
   const status = async () => {
-    const pid = readPid();
-    const alive = pid > 0 && await isAlive(pid);
+    const pid = readBdsPidFile(ROOT_DIR);
+    const alive = pid > 0 && await isProcessAlive(pid);
     if (alive) {
       console.log(`BDS \u8FD0\u884C\u4E2D (PID: ${pid})`);
     } else {
       console.log("BDS \u672A\u8FD0\u884C");
-      clearPid();
+      clearBdsPidFile(ROOT_DIR);
     }
     return alive;
   };
   const watch = async () => {
     log.info("\u542F\u52A8\u76D1\u62A4\u6A21\u5F0F...");
     while (true) {
-      const pid = readPid();
-      if (!pid || !await isAlive(pid)) {
+      const pid = readBdsPidFile(ROOT_DIR);
+      if (!pid || !await isProcessAlive(pid)) {
         try {
           await start();
         } catch (e) {
@@ -203,7 +196,7 @@ function createBdsManager(options = {}) {
   };
   const getPid = () => {
     const p = ensureProc();
-    return p.process?.pid ?? readPid();
+    return p.process?.pid ?? readBdsPidFile(ROOT_DIR);
   };
   return {
     start,

package/dist/bds-manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bds-manager.ts"],
-  "sourcesContent": ["/**\n * bds-manager.ts \u2014 BDS \u8FDB\u7A0B\u7BA1\u7406\u5668\n *\n * \u6539\u8FDB:\n *  - \u4F18\u96C5 stop (\u53D1\u9001 stop \u547D\u4EE4 \u2192 \u7B49\u5F85\u9000\u51FA \u2192 SIGTERM \u2192 SIGKILL)\n *  - watchdog (\u5D29\u6E83\u81EA\u52A8\u91CD\u542F)\n *  - \u5355\u4F8B\u4E8B\u4EF6\u53D1\u5C04\u5668\n *  - \u5B8C\u5168\u5F02\u6B65 (fs/promises)\n */\n\nimport { spawn, exec } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { EventEmitter } from \"node:events\";\nimport { isMainModule } from \"./is-main.js\";\nimport { ensureStateDir, loadConfig, PID_FILE } from \"./paths.js\";\nimport { log } from \"./log.js\";\nimport { ensureEmitServerTelemetry } from \"./server-properties.js\";\n\nconst execAsync = promisify(exec);\n\nexport interface BdsManager {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  status(): Promise<boolean>;\n  sendCommand(cmd: string): boolean;\n  watch(): Promise<void>;\n  events: EventEmitter;\n  isManualStop: boolean;\n  getPid(): number;\n}\n\nexport interface BdsManagerOptions {\n  detached?: boolean;\n}\n\ninterface CachedProc {\n  process: ReturnType<typeof spawn> | null;\n  isManualStop: boolean;\n  crashRestart: boolean;\n  crashDelayMs: number;\n  exePath: string;\n  bdsPath: string;\n}\n\nlet cached: CachedProc | null = null;\n\nfunction readPid(): number {\n  try {\n    return parseInt(fs.readFileSync(PID_FILE, \"utf-8\").trim(), 10) || 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction writePid(pid: number): void {\n  try {\n    ensureStateDir();\n    fs.writeFileSync(PID_FILE, String(pid));\n  } catch {\n    /* ignore */\n  }\n}\n\nfunction clearPid(): void {\n  try {\n    if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);\n  } catch {\n    /* ignore */\n  }\n}\n\nasync function isAlive(pid: number): Promise<boolean> {\n  if (!pid) return false;\n  try {\n    if (process.platform === \"win32\") {\n      const { stdout } = await execAsync(`tasklist /fi \"PID eq ${pid}\" /nh`, { windowsHide: true });\n      return stdout.includes(String(pid));\n    }\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction ensureProc(): CachedProc {\n  if (cached) return cached;\n  const cfg = loadConfig();\n  const bds_path = path.resolve(cfg.bds_path || process.cwd());\n  const exePath = path.join(bds_path, \"bedrock_server.exe\");\n\n  cached = {\n    process: null,\n    isManualStop: false,\n    crashRestart: cfg.crash_restart !== false,\n    crashDelayMs: (cfg.crash_restart_delay ?? 5) * 1000,\n    exePath,\n    bdsPath: bds_path,\n  };\n  return cached;\n}\n\nexport function createBdsManager(options: BdsManagerOptions = {}): BdsManager {\n  const events = new EventEmitter();\n  events.setMaxListeners(100);\n\n  const sendCommand = (cmd: string): boolean => {\n    const p = ensureProc();\n    const pid = readPid();\n    if (!pid || !isAlive(pid)) {\n      log.warn(\"BDS \u672A\u8FD0\u884C\");\n      return false;\n    }\n    if (p.process && p.process.pid === pid && p.process.stdin) {\n      try {\n        p.process.stdin.write(cmd + \"\\n\");\n        log.info(`\u5DF2\u53D1\u9001\u547D\u4EE4: ${cmd}`);\n        return true;\n      } catch {\n        return false;\n      }\n    }\n    log.warn(\"BDS \u7531\u5916\u90E8\u542F\u52A8\uFF0C\u65E0\u6CD5\u53D1\u9001\u547D\u4EE4\u5230 stdin\");\n    return false;\n  };\n\n  const stop = async (): Promise<void> => {\n    const p = ensureProc();\n    const pid = readPid();\n    if (!pid || !(await isAlive(pid))) {\n      log.info(\"BDS \u672A\u8FD0\u884C\");\n      clearPid();\n      return;\n    }\n\n    if (p.process && p.process.pid === pid && p.process.stdin) {\n      p.isManualStop = true;\n      log.info(\"\u6B63\u5728\u5173\u95ED BDS...\");\n      try {\n        p.process.stdin.write(\"stop\\n\");\n      } catch (e) {\n        log.warn(`\u53D1\u9001 stop \u547D\u4EE4\u5931\u8D25: ${(e as Error).message}`);\n      }\n\n      await Promise.race([\n        new Promise<void>((resolve) => p.process?.once(\"exit\", () => resolve())),\n        new Promise<void>((resolve) =>\n          setTimeout(() => {\n            log.warn(\"30s \u8D85\u65F6\uFF0C\u5F3A\u5236\u7EC8\u6B62...\");\n            try { p.process?.kill(\"SIGTERM\"); } catch {}\n            setTimeout(resolve, 5000);\n          }, 30_000)\n        ),\n      ]);\n\n      if (p.process && p.process.exitCode === null) {\n        log.warn(\"\u5F3A\u5236\u7ED3\u675F\u8FDB\u7A0B...\");\n        try { p.process.kill(\"SIGKILL\"); } catch {}\n      }\n    } else {\n      // \u5916\u90E8\u542F\u52A8\u7684 BDS \u2014 fallback \u4F7F\u7528 taskkill / pkill\n      log.info(\"BDS \u7531\u5916\u90E8\u542F\u52A8\uFF0C\u4F7F\u7528 taskkill...\");\n      try {\n        if (process.platform === \"win32\") {\n          await execAsync(\"taskkill /f /im bedrock_server.exe\", { windowsHide: true });\n        } else {\n          await execAsync(\"pkill -f bedrock_server\", { windowsHide: true });\n        }\n      } catch {\n        /* ignore */\n      }\n    }\n\n    clearPid();\n    p.process = null;\n    log.info(\"BDS \u5DF2\u505C\u6B62\");\n  };\n\n  const start = async (): Promise<void> => {\n    const p = ensureProc();\n    const existing = readPid();\n    if (existing && (await isAlive(existing))) {\n      log.info(\"BDS \u5DF2\u5728\u8FD0\u884C\u4E2D\");\n      return;\n    }\n\n    if (!fs.existsSync(p.exePath)) {\n      log.error(`\u672A\u627E\u5230 ${p.exePath}`);\n      throw new Error(`bedrock_server.exe \u4E0D\u5B58\u5728: ${p.exePath}`);\n    }\n\n    // \u542F\u52A8\u524D\u5E42\u7B49\u786E\u4FDD\u9065\u6D4B\u5F00\u5173\uFF08\u5B89\u88C5\u9636\u6BB5\u4E5F\u4F1A\u5199\uFF1B\u65E7\u76EE\u5F55\u9996\u6B21\u542F\u52A8\u65F6\u8865\u4E0A\uFF09\n    ensureEmitServerTelemetry(p.bdsPath, log);\n\n    log.info(\"\u6B63\u5728\u542F\u52A8 BDS...\");\n    const child = spawn(p.exePath, [], {\n      cwd: p.bdsPath,\n      stdio: options.detached ? \"ignore\" : [\"pipe\", \"pipe\", \"pipe\"],\n      detached: options.detached,\n      windowsHide: true,\n    });\n\n    if (options.detached) child.unref();\n\n    p.process = child;\n    writePid(child.pid ?? 0);\n    log.info(`BDS \u5DF2\u542F\u52A8 (PID: ${child.pid})`);\n\n    child.stdout?.on(\"data\", (chunk: Buffer) => {\n      const text = chunk.toString();\n      events.emit(\"output\", text);\n      if (isMain()) process.stdout.write(text);\n    });\n    child.stderr?.on(\"data\", (chunk: Buffer) => {\n      const text = `[STDERR] ${chunk.toString()}`;\n      events.emit(\"output\", text);\n      if (isMain()) process.stderr.write(text);\n    });\n\n    child.on(\"exit\", (code) => {\n      log.info(`BDS \u5DF2\u9000\u51FA (code: ${code})`);\n      clearPid();\n      p.process = null;\n      if (!p.isManualStop && p.crashRestart && isMain()) {\n        log.info(`BDS \u610F\u5916\u9000\u51FA\uFF0C${p.crashDelayMs / 1000}s \u540E\u81EA\u52A8\u91CD\u542F...`);\n        setTimeout(() => {\n          start().catch((e) => log.error(`\u81EA\u52A8\u91CD\u542F\u5931\u8D25: ${e.message}`));\n        }, p.crashDelayMs);\n      }\n      p.isManualStop = false;\n    });\n  };\n\n  const status = async (): Promise<boolean> => {\n    const pid = readPid();\n    const alive = pid > 0 && (await isAlive(pid));\n    if (alive) {\n      console.log(`BDS \u8FD0\u884C\u4E2D (PID: ${pid})`);\n    } else {\n      console.log(\"BDS \u672A\u8FD0\u884C\");\n      clearPid();\n    }\n    return alive;\n  };\n\n  const watch = async (): Promise<void> => {\n    log.info(\"\u542F\u52A8\u76D1\u62A4\u6A21\u5F0F...\");\n    while (true) {\n      const pid = readPid();\n      if (!pid || !(await isAlive(pid))) {\n        try { await start(); }\n        catch (e) { log.error(`\u81EA\u52A8\u542F\u52A8\u5931\u8D25: ${(e as Error).message}`); }\n      }\n      await new Promise((r) => setTimeout(r, 5_000));\n    }\n  };\n\n  const getPid = (): number => {\n    const p = ensureProc();\n    return p.process?.pid ?? readPid();\n  };\n\n  return {\n    start,\n    stop,\n    status,\n    sendCommand,\n    watch,\n    events,\n    isManualStop: false,\n    getPid,\n  };\n}\n\nexport const bdsEvents: EventEmitter = new EventEmitter();\nexport const bdsEvents_enabled = (): void => { bdsEvents.setMaxListeners(100); };\nbdsEvents_enabled();\n\n/** \u5224\u65AD\u5F53\u524D\u662F\u5426\u4F5C\u4E3A CLI \u4E3B\u5165\u53E3\u8FD0\u884C\uFF08\u88AB check-update \u7B49 import \u65F6\u4E3A false\uFF09 */\nfunction isMain(): boolean {\n  // sfmc supervisor \u901A\u8FC7 SFMC_SERVICE \u62C9\u8D77\u5B50\u8FDB\u7A0B\u65F6\u4F18\u5148\u5224\u5B9A\uFF08\u4E0E check-update \u5BF9\u79F0\uFF09\n  if (process.env.SFMC_SERVICE === \"manager\") return true;\n  return isMainModule(import.meta.url);\n}\n\n// CLI \u5165\u53E3\nif (isMain()) {\n  const cmd = process.argv[2];\n  const bds = createBdsManager();\n  const args = process.argv.slice(3);\n\n  switch (cmd) {\n    case \"start\":\n      bds.start().catch((e) => log.error(`\u542F\u52A8\u5931\u8D25: ${e.message}`));\n      break;\n    case \"stop\":\n      bds.stop().catch((e) => log.error(`\u505C\u6B62\u5931\u8D25: ${e.message}`));\n      break;\n    case \"restart\":\n      bds.stop()\n        .then(() => bds.start())\n        .catch((e) => log.error(`\u91CD\u542F\u5931\u8D25: ${e.message}`));\n      break;\n    case \"status\":\n      bds.status();\n      break;\n    case \"send\":\n      if (args[0]) bds.sendCommand(args.join(\" \"));\n      else console.log(\"\u7528\u6CD5: node bds-manager.js send <command>\");\n      break;\n    case \"watch\":\n      bds.watch().catch((e) => log.error(`\u76D1\u62A4\u5F02\u5E38: ${e.message}`));\n      break;\n    default:\n      console.log(`\u7528\u6CD5:\n  start         \u542F\u52A8 BDS\n  stop          \u505C\u6B62\n  restart       \u91CD\u542F\n  status        \u68C0\u67E5\u72B6\u6001\n  send <cmd>    \u53D1\u9001\u547D\u4EE4\n  watch         \u76D1\u62A4\u6A21\u5F0F\uFF08\u5D29\u6E83\u81EA\u52A8\u91CD\u542F\uFF09`);\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * bds-manager.ts \u2014 Bedrock Dedicated Server (BDS) \u8FDB\u7A0B\u751F\u547D\u5468\u671F\u7BA1\u7406\u5668\n *\n * \u6838\u5FC3\u804C\u8D23\uFF1A\n * - \u4F18\u96C5\u505C\u670D\uFF1A\u5411\u6807\u51C6\u8F93\u5165\u53D1\u9001 `stop` \u547D\u4EE4\u7B49\u5F85\u81EA\u7136\u9000\u51FA\uFF0C\u8D85\u65F6\u540E\u9010\u6B65\u5347\u7EA7\u81F3 SIGTERM \u4E0E SIGKILL\n * - \u5B88\u62A4\u76D1\u89C6\uFF08watch\uFF09\uFF1A\u76D1\u542C\u8FDB\u7A0B\u9000\u51FA\u4E8B\u4EF6\u5E76\u5728\u5F02\u5E38\u9000\u51FA\u65F6\u81EA\u52A8\u5EF6\u65F6\u91CD\u542F\u6062\u590D\n * - \u751F\u547D\u5468\u671F\u4E8B\u4EF6\u5E7F\u64AD\uFF1A\u5206\u53D1\u542F\u52A8\u3001\u505C\u6B62\u3001\u5D29\u6E83\u7B49\u4E8B\u4EF6\uFF0C\u89E6\u53D1\u8FD0\u7EF4\u544A\u8B66\u4E0E\u72B6\u6001\u540C\u6B65\n * - \u7BA1\u9053\u4EA4\u4E92\u4E0E\u63A2\u6D3B\uFF1A\u68C0\u6D4B\u8FDB\u7A0B\u5B58\u6D3B\u72B6\u6001\u5E76\u5411 BDS stdin \u6295\u9012\u63A7\u5236\u53F0\u6307\u4EE4\n */\n\nimport { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { EventEmitter } from \"node:events\";\nimport { bdsExePath, bdsSpawnEnvExtra, ensureBdsExecutable } from \"./host-platform.js\";\nimport { isMainModule } from \"./is-main.js\";\nimport { loadConfig, ROOT_DIR } from \"./paths.js\";\nimport { log } from \"./log.js\";\nimport { postBdsLifecycleEvent } from \"./qq-events-notify.js\";\nimport { ensureEmitServerTelemetry, ensureNetherNetTransport, localizeServerProperties } from \"./server-properties.js\";\nimport {\n  clearBdsPidFile,\n  findBedrockServerPids,\n  isProcessAlive,\n  isProcessAliveSync,\n  killBedrockServerByImage,\n  readBdsPidFile,\n  writeBdsPidFile,\n} from \"./process-probe.js\";\n\n/** BDS \u8FDB\u7A0B\u7BA1\u7406\u5668\u7EDF\u4E00\u64CD\u4F5C\u63A5\u53E3\u3002 */\nexport interface BdsManager {\n  /** \u542F\u52A8 BDS \u670D\u52A1\u8FDB\u7A0B\u3002 */\n  start(): Promise<void>;\n  /** \u4F18\u96C5\u505C\u6B62 BDS \u670D\u52A1\u8FDB\u7A0B\u3002 */\n  stop(): Promise<void>;\n  /** \u67E5\u8BE2 BDS \u8FDB\u7A0B\u5F53\u524D\u662F\u5426\u5904\u4E8E\u8FD0\u884C\u72B6\u6001\u3002 */\n  status(): Promise<boolean>;\n  /** \u5411 BDS \u63A7\u5236\u53F0\u7BA1\u9053\u53D1\u9001\u6307\u4EE4\u3002 */\n  sendCommand(cmd: string): boolean;\n  /** \u5F00\u542F\u5B88\u62A4\u76D1\u89C6\u6A21\u5F0F\uFF08\u5F02\u5E38\u9000\u51FA\u65F6\u81EA\u52A8\u62C9\u8D77\uFF09\u3002 */\n  watch(): Promise<void>;\n  /** \u8FDB\u7A0B\u751F\u547D\u5468\u671F\u4E8B\u4EF6\u53D1\u5C04\u5668\u3002 */\n  events: EventEmitter;\n  /** \u5F53\u524D\u662F\u5426\u5C5E\u4E8E\u4E3B\u52A8\u8C03\u7528\u505C\u670D\u3002 */\n  isManualStop: boolean;\n  /** \u83B7\u53D6\u5F53\u524D\u8FD0\u884C\u4E2D BDS \u8FDB\u7A0B\u7684 PID\u3002 */\n  getPid(): number;\n}\n\n/** BDS \u8FDB\u7A0B\u542F\u52A8\u9009\u9879\u3002 */\nexport interface BdsManagerOptions {\n  detached?: boolean;\n}\n\n\ninterface CachedProc {\n  process: ReturnType<typeof spawn> | null;\n  isManualStop: boolean;\n  crashRestart: boolean;\n  crashDelayMs: number;\n  exePath: string;\n  bdsPath: string;\n}\n\nlet cached: CachedProc | null = null;\n\nfunction ensureProc(): CachedProc {\n  if (cached) return cached;\n  const cfg = loadConfig();\n  const bds_path = path.resolve(cfg.bds_path || process.cwd());\n  const exePath = bdsExePath(bds_path);\n\n  cached = {\n    process: null,\n    isManualStop: false,\n    crashRestart: cfg.crash_restart !== false,\n    crashDelayMs: (cfg.crash_restart_delay ?? 5) * 1000,\n    exePath,\n    bdsPath: bds_path,\n  };\n  return cached;\n}\n\nexport function createBdsManager(options: BdsManagerOptions = {}): BdsManager {\n  const events = new EventEmitter();\n  events.setMaxListeners(100);\n\n  const sendCommand = (cmd: string): boolean => {\n    const p = ensureProc();\n    const pid = readBdsPidFile(ROOT_DIR);\n    if (!pid || !isProcessAliveSync(pid)) {\n      log.warn(\"BDS \u672A\u8FD0\u884C\");\n      return false;\n    }\n    if (p.process && p.process.pid === pid && p.process.stdin) {\n      try {\n        p.process.stdin.write(cmd + \"\\n\");\n        log.info(`\u5DF2\u53D1\u9001\u547D\u4EE4: ${cmd}`);\n        return true;\n      } catch {\n        return false;\n      }\n    }\n    log.warn(\"BDS \u7531\u5916\u90E8\u542F\u52A8\uFF0C\u65E0\u6CD5\u53D1\u9001\u547D\u4EE4\u5230 stdin\");\n    return false;\n  };\n\n  const stop = async (): Promise<void> => {\n    const p = ensureProc();\n    // \u65E0\u8BBA\u81EA\u7BA1 / \u5916\u90E8\u8FDB\u7A0B\uFF0C\u624B\u52A8 stop \u90FD\u4E0D\u62A5 crash\n    p.isManualStop = true;\n    const pid = readBdsPidFile(ROOT_DIR);\n    if (!pid || !(await isProcessAlive(pid))) {\n      const externalPids = await findBedrockServerPids();\n      if (externalPids.length > 0) {\n        log.info(\"\u68C0\u6D4B\u5230\u5916\u90E8\u8FD0\u884C\u7684 BDS \u8FDB\u7A0B\uFF0C\u4F7F\u7528 taskkill \u7EC8\u6B62...\");\n        await killBedrockServerByImage();\n        clearBdsPidFile(ROOT_DIR);\n        p.process = null;\n        log.info(\"BDS \u5DF2\u505C\u6B62\");\n        void postBdsLifecycleEvent(\"stop\");\n        return;\n      }\n      log.info(\"BDS \u672A\u8FD0\u884C\");\n      clearBdsPidFile(ROOT_DIR);\n      p.isManualStop = false;\n      return;\n    }\n\n    if (p.process && p.process.pid === pid && p.process.stdin) {\n      log.info(\"\u6B63\u5728\u5173\u95ED BDS...\");\n      try {\n        p.process.stdin.write(\"stop\\n\");\n      } catch (e) {\n        log.warn(`\u53D1\u9001 stop \u547D\u4EE4\u5931\u8D25: ${(e as Error).message}`);\n      }\n\n      await Promise.race([\n        new Promise<void>((resolve) => p.process?.once(\"exit\", () => resolve())),\n        new Promise<void>((resolve) =>\n          setTimeout(() => {\n            log.warn(\"30s \u8D85\u65F6\uFF0C\u5F3A\u5236\u7EC8\u6B62...\");\n            try {\n              p.process?.kill(\"SIGTERM\");\n            } catch {}\n            setTimeout(resolve, 5000);\n          }, 30_000)\n        ),\n      ]);\n\n      if (p.process && p.process.exitCode === null) {\n        log.warn(\"\u5F3A\u5236\u7ED3\u675F\u8FDB\u7A0B...\");\n        try {\n          p.process.kill(\"SIGKILL\");\n        } catch {}\n      }\n    } else {\n      // \u5916\u90E8\u542F\u52A8\u7684 BDS \u2014 fallback \u4F7F\u7528 taskkill / pkill\n      log.info(\"BDS \u7531\u5916\u90E8\u542F\u52A8\uFF0C\u4F7F\u7528 taskkill...\");\n      await killBedrockServerByImage();\n      void postBdsLifecycleEvent(\"stop\");\n    }\n\n    clearBdsPidFile(ROOT_DIR);\n    p.process = null;\n    log.info(\"BDS \u5DF2\u505C\u6B62\");\n  };\n\n  const start = async (): Promise<void> => {\n    const p = ensureProc();\n    const existing = readBdsPidFile(ROOT_DIR);\n    if (existing && (await isProcessAlive(existing))) {\n      log.info(\"BDS \u5DF2\u5728\u8FD0\u884C\u4E2D\");\n      return;\n    }\n\n    if (!fs.existsSync(p.exePath)) {\n      log.error(`\u672A\u627E\u5230 ${p.exePath}`);\n      throw new Error(`BDS \u53EF\u6267\u884C\u6587\u4EF6\u4E0D\u5B58\u5728: ${p.exePath}`);\n    }\n\n    // \u542F\u52A8\u524D\u8865\u9F50\u5FC5\u8981\u914D\u7F6E\u5E76\u672C\u5730\u5316\u6CE8\u91CA\uFF08\u5B89\u88C5\u9636\u6BB5\u4E5F\u4F1A\u5199\uFF1B\u65E7\u76EE\u5F55\u9996\u6B21\u542F\u52A8\u65F6\u8865\u4E0A\uFF09\n    ensureEmitServerTelemetry(p.bdsPath, log);\n    ensureNetherNetTransport(p.bdsPath, log);\n    localizeServerProperties(p.bdsPath, { logger: log, rootDir: ROOT_DIR });\n    ensureBdsExecutable(p.exePath);\n\n    log.info(\"\u6B63\u5728\u542F\u52A8 BDS...\");\n    p.isManualStop = false;\n    const child = spawn(p.exePath, [], {\n      cwd: p.bdsPath,\n      env: { ...process.env, ...bdsSpawnEnvExtra(p.bdsPath) },\n      stdio: options.detached ? \"ignore\" : [\"pipe\", \"pipe\", \"pipe\"],\n      detached: options.detached,\n      windowsHide: true,\n    });\n\n    if (options.detached) child.unref();\n\n    p.process = child;\n    writeBdsPidFile(child.pid ?? 0, ROOT_DIR);\n    log.info(`BDS \u5DF2\u542F\u52A8 (PID: ${child.pid})`);\n    void postBdsLifecycleEvent(\"start\", `pid=${child.pid ?? 0}`);\n\n    child.stdout?.on(\"data\", (chunk: Buffer) => {\n      const text = chunk.toString();\n      events.emit(\"output\", text);\n      if (isMain()) process.stdout.write(text);\n    });\n    child.stderr?.on(\"data\", (chunk: Buffer) => {\n      const text = `[STDERR] ${chunk.toString()}`;\n      events.emit(\"output\", text);\n      if (isMain()) process.stderr.write(text);\n    });\n\n    child.on(\"exit\", (code) => {\n      log.info(`BDS \u5DF2\u9000\u51FA (code: ${code})`);\n      clearBdsPidFile(ROOT_DIR);\n      p.process = null;\n      const wasManual = p.isManualStop;\n      if (!wasManual) {\n        void postBdsLifecycleEvent(\"crash\", `code=${code ?? \"?\"}`);\n      } else {\n        void postBdsLifecycleEvent(\"stop\");\n      }\n      if (!wasManual && p.crashRestart && isMain()) {\n        log.info(`BDS \u610F\u5916\u9000\u51FA\uFF0C${p.crashDelayMs / 1000}s \u540E\u81EA\u52A8\u91CD\u542F...`);\n        setTimeout(() => {\n          start().catch((e) => log.error(`\u81EA\u52A8\u91CD\u542F\u5931\u8D25: ${e.message}`));\n        }, p.crashDelayMs);\n      }\n      p.isManualStop = false;\n    });\n  };\n\n  const status = async (): Promise<boolean> => {\n    const pid = readBdsPidFile(ROOT_DIR);\n    const alive = pid > 0 && (await isProcessAlive(pid));\n    if (alive) {\n      console.log(`BDS \u8FD0\u884C\u4E2D (PID: ${pid})`);\n    } else {\n      console.log(\"BDS \u672A\u8FD0\u884C\");\n      clearBdsPidFile(ROOT_DIR);\n    }\n    return alive;\n  };\n\n  const watch = async (): Promise<void> => {\n    log.info(\"\u542F\u52A8\u76D1\u62A4\u6A21\u5F0F...\");\n    while (true) {\n      const pid = readBdsPidFile(ROOT_DIR);\n      if (!pid || !(await isProcessAlive(pid))) {\n        try {\n          await start();\n        } catch (e) {\n          log.error(`\u81EA\u52A8\u542F\u52A8\u5931\u8D25: ${(e as Error).message}`);\n        }\n      }\n      await new Promise((r) => setTimeout(r, 5_000));\n    }\n  };\n\n  const getPid = (): number => {\n    const p = ensureProc();\n    return p.process?.pid ?? readBdsPidFile(ROOT_DIR);\n  };\n\n  return {\n    start,\n    stop,\n    status,\n    sendCommand,\n    watch,\n    events,\n    isManualStop: false,\n    getPid,\n  };\n}\n\nexport const bdsEvents: EventEmitter = new EventEmitter();\nexport const bdsEvents_enabled = (): void => {\n  bdsEvents.setMaxListeners(100);\n};\nbdsEvents_enabled();\n\n/** \u5224\u65AD\u5F53\u524D\u662F\u5426\u4F5C\u4E3A CLI \u4E3B\u5165\u53E3\u8FD0\u884C\uFF08\u88AB check-update \u7B49 import \u65F6\u4E3A false\uFF09 */\nfunction isMain(): boolean {\n  // sfmc supervisor \u901A\u8FC7 SFMC_SERVICE \u62C9\u8D77\u5B50\u8FDB\u7A0B\u65F6\u4F18\u5148\u5224\u5B9A\uFF08\u4E0E check-update \u5BF9\u79F0\uFF09\n  if (process.env.SFMC_SERVICE === \"manager\") return true;\n  return isMainModule(import.meta.url);\n}\n\n// CLI \u5165\u53E3\nif (isMain()) {\n  const cmd = process.argv[2];\n  const bds = createBdsManager();\n  const args = process.argv.slice(3);\n\n  switch (cmd) {\n    case \"start\":\n      bds.start().catch((e) => log.error(`\u542F\u52A8\u5931\u8D25: ${e.message}`));\n      break;\n    case \"stop\":\n      bds.stop().catch((e) => log.error(`\u505C\u6B62\u5931\u8D25: ${e.message}`));\n      break;\n    case \"restart\":\n      bds\n        .stop()\n        .then(() => bds.start())\n        .catch((e) => log.error(`\u91CD\u542F\u5931\u8D25: ${e.message}`));\n      break;\n    case \"status\":\n      bds.status();\n      break;\n    case \"send\":\n      if (args[0]) bds.sendCommand(args.join(\" \"));\n      else console.log(\"\u7528\u6CD5: node bds-manager.js send <command>\");\n      break;\n    case \"watch\":\n      bds.watch().catch((e) => log.error(`\u76D1\u62A4\u5F02\u5E38: ${e.message}`));\n      break;\n    default:\n      console.log(`\u7528\u6CD5:\n  start         \u542F\u52A8 BDS\n  stop          \u505C\u6B62\n  restart       \u91CD\u542F\n  status        \u68C0\u67E5\u72B6\u6001\n  send <cmd>    \u53D1\u9001\u547D\u4EE4\n  watch         \u76D1\u62A4\u6A21\u5F0F\uFF08\u5D29\u6E83\u81EA\u52A8\u91CD\u542F\uFF09`);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/changelog.d.ts

@@ -1,9 +1,13 @@
-/**
- * changelog.ts — 更新日志抓取 (官方页面)
- */
+/** changelog.ts — 按 BDS 版本查找 Minecraft 官方更新日志。 */
 import type { ChangelogPayload } from "./types.js";
-declare const CHANGELOG_BASE = "https://feedback.minecraft.net/hc/en-us/sections/360001186971";
-/** 抓取当前版本的更新说明 (文本 + 首张图 base64) */
-export declare function fetchChangelog(channel: string): Promise<ChangelogPayload | null>;
-export { CHANGELOG_BASE };
+interface FeedbackArticle {
+    title: string;
+    html_url: string;
+    body: string;
+}
+export declare function changelogSectionUrl(channel: string): string;
+export declare function findMatchingChangelogArticle(articles: FeedbackArticle[], channel: string, version: string): FeedbackArticle | null;
+/** 只返回与目标版本匹配的文章；找不到时由调用方给出对应频道的目录。 */
+export declare function fetchChangelog(channel: string, version: string): Promise<ChangelogPayload | null>;
+export {};
 //# sourceMappingURL=changelog.d.ts.map

package/dist/changelog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,QAAA,MAAM,cAAc,kEAAkE,CAAC;AAUvF,oCAAoC;AACpC,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwCtF;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAKlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAuBD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,eAAe,GAAG,IAAI,CAYxB;AAED,uCAAuC;AACvC,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoCvG"}

package/dist/changelog.js

@@ -1,48 +1,74 @@
 import { parse as parseHtml } from "node-html-parser";
-import { fetchJsonWithFallback, httpGetText } from "./http.js";
+import { httpGetJson, httpRequest } from "./http.js";
 import { log } from "./log.js";
-const CHANGELOG_BASE = "https://feedback.minecraft.net/hc/en-us/sections/360001186971";
-function firstElement(root, selector) {
-  return root.querySelector(selector);
+const FEEDBACK_BASE = "https://feedback.minecraft.net";
+const RELEASE_SECTION = "360001186971";
+const PREVIEW_SECTION = "360001185332";
+function changelogSectionUrl(channel) {
+  const section = channel === "preview" ? PREVIEW_SECTION : RELEASE_SECTION;
+  return `${FEEDBACK_BASE}/hc/en-us/sections/${section}`;
 }
-async function fetchChangelog(channel) {
+function versionCandidates(version, channel) {
+  const parts = version.split(".");
+  if (parts[0] === "1" && Number(parts[1]) >= 26) parts.shift();
+  const full = parts.join(".");
+  if (channel === "preview") return [full];
+  return [full, parts.slice(0, 3).join("."), parts.slice(0, 2).join(".")];
+}
+function articleVersions(title) {
+  const found = [];
+  for (const match of title.matchAll(/\b(?:1\.)?\d+\.\d+(?:\.\d+)?(?:\/\d+)*\b/g)) {
+    const [first, ...rest] = match[0].split("/");
+    found.push(first);
+    const prefix = first.slice(0, first.lastIndexOf(".") + 1);
+    for (const suffix of rest) found.push(prefix + suffix);
+  }
+  return found;
+}
+function findMatchingChangelogArticle(articles, channel, version) {
+  const candidates = versionCandidates(version, channel);
+  return articles.find((article) => {
+    const title = article.title.toLowerCase();
+    const expectedChannel = channel === "preview" ? /\b(beta|preview)\b/.test(title) : /\bbedrock\b/.test(title) && !/\b(beta|preview)\b/.test(title);
+    return expectedChannel && articleVersions(title).some((v) => candidates.includes(v));
+  }) ?? null;
+}
+async function fetchChangelog(channel, version) {
+  const section = channel === "preview" ? PREVIEW_SECTION : RELEASE_SECTION;
   try {
-    const url = `https://www.minecraft.net/en-us/article/${channel === "preview" ? "bedrock-beta" : "bedrock"}-update`;
-    const html = await httpGetText(url);
-    const root = parseHtml(html);
-    const article = firstElement(root, "article") ?? firstElement(root, ".article-content") ?? firstElement(root, '[class*="content"]');
-    if (!article) return null;
-    const paragraphs = [];
-    for (const el of article.querySelectorAll("p, h2, h3, li")) {
-      const t = el.text.trim();
-      if (t) paragraphs.push(t);
-    }
-    const text = paragraphs.join("\n").slice(0, 2e3);
-    let imageBase64 = null;
-    const firstImg = article.querySelector("img");
-    if (firstImg) {
-      const imgSrc = firstImg.getAttribute("src") ?? firstImg.getAttribute("data-src") ?? void 0;
-      if (imgSrc) {
-        try {
-          const imgUrl = imgSrc.startsWith("http") ? imgSrc : `https://www.minecraft.net${imgSrc}`;
-          const res = await fetchJsonWithFallback([], 15e3).catch(() => null);
-          void res;
-          const { httpRequest } = await import("./http.js");
-          const img = await httpRequest(imgUrl);
-          imageBase64 = img.body.toString("base64");
-        } catch (e) {
-          log.warn(`\u83B7\u53D6\u56FE\u7247\u5931\u8D25: ${e.message}`);
+    for (let page = 1; page <= 5; page++) {
+      const url = `${FEEDBACK_BASE}/api/v2/help_center/en-us/sections/${section}/articles.json?per_page=10&page=${page}`;
+      const result = await httpGetJson(url, { totalTimeoutMs: 15e3 });
+      const article = findMatchingChangelogArticle(result.articles, channel, version);
+      if (article) {
+        const root = parseHtml(article.body);
+        const paragraphs = root.querySelectorAll("p, h2, h3, li").map((el) => el.text.trim()).filter(Boolean);
+        const text = paragraphs.join("\n").slice(0, 2e3);
+        if (!text) return null;
+        let imageBase64 = null;
+        const imgSrc = root.querySelector("img")?.getAttribute("src");
+        if (imgSrc) {
+          try {
+            const imgUrl = new URL(imgSrc, article.html_url).href;
+            const image = await httpRequest(imgUrl, { totalTimeoutMs: 15e3 });
+            imageBase64 = image.body.toString("base64");
+          } catch (e) {
+            log.warn(`\u83B7\u53D6\u66F4\u65B0\u65E5\u5FD7\u56FE\u7247\u5931\u8D25: ${e.message}`);
+          }
         }
+        return { text, imageBase64, url: article.html_url };
       }
+      if (!result.next_page) break;
     }
-    return { text: text.slice(0, 2e3), imageBase64 };
+    log.warn(`\u672A\u627E\u5230 BDS ${version} (${channel}) \u5BF9\u5E94\u7684\u5B98\u65B9\u66F4\u65B0\u65E5\u5FD7`);
   } catch (e) {
     log.warn(`\u83B7\u53D6\u66F4\u65B0\u65E5\u5FD7\u5931\u8D25: ${e.message}`);
-    return null;
   }
+  return null;
 }
 export {
-  CHANGELOG_BASE,
-  fetchChangelog
+  changelogSectionUrl,
+  fetchChangelog,
+  findMatchingChangelogArticle
 };
 //# sourceMappingURL=changelog.js.map

package/dist/changelog.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/changelog.ts"],
-  "sourcesContent": ["/**\n * changelog.ts \u2014 \u66F4\u65B0\u65E5\u5FD7\u6293\u53D6 (\u5B98\u65B9\u9875\u9762)\n */\n\nimport { parse as parseHtml, HTMLElement } from \"node-html-parser\";\nimport { fetchJsonWithFallback, httpGetText } from \"./http.js\";\nimport type { ChangelogPayload } from \"./types.js\";\nimport { log } from \"./log.js\";\n\nconst CHANGELOG_BASE = \"https://feedback.minecraft.net/hc/en-us/sections/360001186971\";\n\n/**\n * node-html-parser \u7684 API \u4E0E cheerio \u7565\u4E0D\u540C:\u5B83\u6CA1\u6709 first/length \u94FE\u5F0F\u5224\u65AD,\n * \u800C\u662F\u7528 querySelector + \u8282\u70B9\u5C5E\u6027\u3002\u8FD9\u91CC\u5305\u4E00\u5C42\u5C0F\u5DE5\u5177\u8BA9\u9009\u62E9\u5B50\u8BED\u4E49\u96C6\u4E2D\u3002\n */\nfunction firstElement(root: HTMLElement, selector: string): HTMLElement | null {\n  return root.querySelector(selector);\n}\n\n/** \u6293\u53D6\u5F53\u524D\u7248\u672C\u7684\u66F4\u65B0\u8BF4\u660E (\u6587\u672C + \u9996\u5F20\u56FE base64) */\nexport async function fetchChangelog(channel: string): Promise<ChangelogPayload | null> {\n  try {\n    const url = `https://www.minecraft.net/en-us/article/${channel === \"preview\" ? \"bedrock-beta\" : \"bedrock\"}-update`;\n    const html = await httpGetText(url);\n    const root = parseHtml(html);\n    const article = firstElement(root, \"article\")\n      ?? firstElement(root, \".article-content\")\n      ?? firstElement(root, '[class*=\"content\"]');\n    if (!article) return null;\n\n    const paragraphs: string[] = [];\n    for (const el of article.querySelectorAll(\"p, h2, h3, li\")) {\n      const t = el.text.trim();\n      if (t) paragraphs.push(t);\n    }\n    const text = paragraphs.join(\"\\n\").slice(0, 2000);\n\n    let imageBase64: string | null = null;\n    const firstImg = article.querySelector(\"img\");\n    if (firstImg) {\n      const imgSrc: string | undefined = firstImg.getAttribute(\"src\") ?? firstImg.getAttribute(\"data-src\") ?? undefined;\n      if (imgSrc) {\n        try {\n          const imgUrl = imgSrc.startsWith(\"http\") ? imgSrc : `https://www.minecraft.net${imgSrc}`;\n          const res = await fetchJsonWithFallback([], 15_000).catch(() => null);\n          void res;\n          const { httpRequest } = await import(\"./http.js\");\n          const img = await httpRequest(imgUrl);\n          imageBase64 = img.body.toString(\"base64\");\n        } catch (e) {\n          log.warn(`\u83B7\u53D6\u56FE\u7247\u5931\u8D25: ${(e as Error).message}`);\n        }\n      }\n    }\n\n    return { text: text.slice(0, 2000), imageBase64 };\n  } catch (e) {\n    log.warn(`\u83B7\u53D6\u66F4\u65B0\u65E5\u5FD7\u5931\u8D25: ${(e as Error).message}`);\n    return null;\n  }\n}\n\nexport { CHANGELOG_BASE };\n"],
-  "mappings": "AAIA,SAAS,SAAS,iBAA8B;AAChD,SAAS,uBAAuB,mBAAmB;AAEnD,SAAS,WAAW;AAEpB,MAAM,iBAAiB;AAMvB,SAAS,aAAa,MAAmB,UAAsC;AAC7E,SAAO,KAAK,cAAc,QAAQ;AACpC;AAGA,eAAsB,eAAe,SAAmD;AACtF,MAAI;AACF,UAAM,MAAM,2CAA2C,YAAY,YAAY,iBAAiB,SAAS;AACzG,UAAM,OAAO,MAAM,YAAY,GAAG;AAClC,UAAM,OAAO,UAAU,IAAI;AAC3B,UAAM,UAAU,aAAa,MAAM,SAAS,KACvC,aAAa,MAAM,kBAAkB,KACrC,aAAa,MAAM,oBAAoB;AAC5C,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,aAAuB,CAAC;AAC9B,eAAW,MAAM,QAAQ,iBAAiB,eAAe,GAAG;AAC1D,YAAM,IAAI,GAAG,KAAK,KAAK;AACvB,UAAI,EAAG,YAAW,KAAK,CAAC;AAAA,IAC1B;AACA,UAAM,OAAO,WAAW,KAAK,IAAI,EAAE,MAAM,GAAG,GAAI;AAEhD,QAAI,cAA6B;AACjC,UAAM,WAAW,QAAQ,cAAc,KAAK;AAC5C,QAAI,UAAU;AACZ,YAAM,SAA6B,SAAS,aAAa,KAAK,KAAK,SAAS,aAAa,UAAU,KAAK;AACxG,UAAI,QAAQ;AACV,YAAI;AACF,gBAAM,SAAS,OAAO,WAAW,MAAM,IAAI,SAAS,4BAA4B,MAAM;AACtF,gBAAM,MAAM,MAAM,sBAAsB,CAAC,GAAG,IAAM,EAAE,MAAM,MAAM,IAAI;AACpE,eAAK;AACL,gBAAM,EAAE,YAAY,IAAI,MAAM,OAAO,WAAW;AAChD,gBAAM,MAAM,MAAM,YAAY,MAAM;AACpC,wBAAc,IAAI,KAAK,SAAS,QAAQ;AAAA,QAC1C,SAAS,GAAG;AACV,cAAI,KAAK,yCAAY,EAAY,OAAO,EAAE;AAAA,QAC5C;AAAA,MACF;AAAA,IACF;AAEA,WAAO,EAAE,MAAM,KAAK,MAAM,GAAG,GAAI,GAAG,YAAY;AAAA,EAClD,SAAS,GAAG;AACV,QAAI,KAAK,qDAAc,EAAY,OAAO,EAAE;AAC5C,WAAO;AAAA,EACT;AACF;",
+  "sourcesContent": ["/** changelog.ts \u2014 \u6309 BDS \u7248\u672C\u67E5\u627E Minecraft \u5B98\u65B9\u66F4\u65B0\u65E5\u5FD7\u3002 */\n\nimport { parse as parseHtml } from \"node-html-parser\";\nimport { httpGetJson, httpRequest } from \"./http.js\";\nimport { log } from \"./log.js\";\nimport type { ChangelogPayload } from \"./types.js\";\n\nconst FEEDBACK_BASE = \"https://feedback.minecraft.net\";\nconst RELEASE_SECTION = \"360001186971\";\nconst PREVIEW_SECTION = \"360001185332\";\n\ninterface FeedbackArticle {\n  title: string;\n  html_url: string;\n  body: string;\n}\n\ninterface FeedbackPage {\n  articles: FeedbackArticle[];\n  next_page: string | null;\n}\n\nexport function changelogSectionUrl(channel: string): string {\n  const section = channel === \"preview\" ? PREVIEW_SECTION : RELEASE_SECTION;\n  return `${FEEDBACK_BASE}/hc/en-us/sections/${section}`;\n}\n\n/** BDS \u7248\u672C\u591A\u4E00\u4E2A\u6784\u5EFA\u53F7\uFF1B\u6B63\u5F0F\u7248\u6587\u7AE0\u901A\u5E38\u53EA\u5199\u524D\u4E09\u6BB5\uFF0C\u9884\u89C8\u7248\u9700\u4FDD\u7559\u6784\u5EFA\u53F7\u3002 */\nfunction versionCandidates(version: string, channel: string): string[] {\n  const parts = version.split(\".\");\n  if (parts[0] === \"1\" && Number(parts[1]) >= 26) parts.shift();\n  const full = parts.join(\".\");\n  if (channel === \"preview\") return [full];\n  return [full, parts.slice(0, 3).join(\".\"), parts.slice(0, 2).join(\".\")];\n}\n\n/** \u517C\u5BB9 26.44/45 \u548C 1.21.93/94 \u8FD9\u7C7B\u5408\u5E76\u53D1\u5E03\u7684\u5B98\u65B9\u6807\u9898\u3002 */\nfunction articleVersions(title: string): string[] {\n  const found: string[] = [];\n  for (const match of title.matchAll(/\\b(?:1\\.)?\\d+\\.\\d+(?:\\.\\d+)?(?:\\/\\d+)*\\b/g)) {\n    const [first, ...rest] = match[0].split(\"/\");\n    found.push(first!);\n    const prefix = first!.slice(0, first!.lastIndexOf(\".\") + 1);\n    for (const suffix of rest) found.push(prefix + suffix);\n  }\n  return found;\n}\n\nexport function findMatchingChangelogArticle(\n  articles: FeedbackArticle[],\n  channel: string,\n  version: string\n): FeedbackArticle | null {\n  const candidates = versionCandidates(version, channel);\n  return (\n    articles.find((article) => {\n      const title = article.title.toLowerCase();\n      const expectedChannel =\n        channel === \"preview\"\n          ? /\\b(beta|preview)\\b/.test(title)\n          : /\\bbedrock\\b/.test(title) && !/\\b(beta|preview)\\b/.test(title);\n      return expectedChannel && articleVersions(title).some((v) => candidates.includes(v));\n    }) ?? null\n  );\n}\n\n/** \u53EA\u8FD4\u56DE\u4E0E\u76EE\u6807\u7248\u672C\u5339\u914D\u7684\u6587\u7AE0\uFF1B\u627E\u4E0D\u5230\u65F6\u7531\u8C03\u7528\u65B9\u7ED9\u51FA\u5BF9\u5E94\u9891\u9053\u7684\u76EE\u5F55\u3002 */\nexport async function fetchChangelog(channel: string, version: string): Promise<ChangelogPayload | null> {\n  const section = channel === \"preview\" ? PREVIEW_SECTION : RELEASE_SECTION;\n  try {\n    for (let page = 1; page <= 5; page++) {\n      const url = `${FEEDBACK_BASE}/api/v2/help_center/en-us/sections/${section}/articles.json?per_page=10&page=${page}`;\n      const result = await httpGetJson<FeedbackPage>(url, { totalTimeoutMs: 15_000 });\n      const article = findMatchingChangelogArticle(result.articles, channel, version);\n      if (article) {\n        const root = parseHtml(article.body);\n        const paragraphs = root\n          .querySelectorAll(\"p, h2, h3, li\")\n          .map((el) => el.text.trim())\n          .filter(Boolean);\n        const text = paragraphs.join(\"\\n\").slice(0, 2000);\n        if (!text) return null;\n\n        let imageBase64: string | null = null;\n        const imgSrc = root.querySelector(\"img\")?.getAttribute(\"src\");\n        if (imgSrc) {\n          try {\n            const imgUrl = new URL(imgSrc, article.html_url).href;\n            const image = await httpRequest(imgUrl, { totalTimeoutMs: 15_000 });\n            imageBase64 = image.body.toString(\"base64\");\n          } catch (e) {\n            log.warn(`\u83B7\u53D6\u66F4\u65B0\u65E5\u5FD7\u56FE\u7247\u5931\u8D25: ${(e as Error).message}`);\n          }\n        }\n        return { text, imageBase64, url: article.html_url };\n      }\n      if (!result.next_page) break;\n    }\n    log.warn(`\u672A\u627E\u5230 BDS ${version} (${channel}) \u5BF9\u5E94\u7684\u5B98\u65B9\u66F4\u65B0\u65E5\u5FD7`);\n  } catch (e) {\n    log.warn(`\u83B7\u53D6\u66F4\u65B0\u65E5\u5FD7\u5931\u8D25: ${(e as Error).message}`);\n  }\n  return null;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/check-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-update.d.ts","sourceRoot":"","sources":["../src/check-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuJH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAyRjD"}
+{"version":3,"file":"check-update.d.ts","sourceRoot":"","sources":["../src/check-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkKH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CA6SjD"}