tt-help-cli-ycl 1.4.159 → 1.4.161

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tt-help-cli-ycl",
-  "version": "1.4.159",
+  "version": "1.4.161",
   "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
   "type": "module",
   "bin": {

package/src/watchdog/agent.js

@@ -296,6 +296,7 @@ export class WatchdogAgent {
     this._switchRestartEnabled = false; // 代理切换重启默认不启用（后端下发开启才生效）
     this._switchRestartConfigKey = null; // 上次配置指纹（幂等打印用）
     this._autoUpgradeEnabled = true; // 自动升级默认开启（后端下发关闭才停用）
+    this._loadedVersion = getVersion(); // 启动时包版本（磁盘版本变化 = 被手动升级，需自动重启）
     this._errorTriggerEnabled = false; // 默认不启用（后端下发开启才生效）
     this._errorTriggerCount = ERROR_TRIGGER_COUNT;
     this._errorTriggerMinMs = ERROR_MIN_MS;
@@ -1068,6 +1069,7 @@ export class WatchdogAgent {
   _startUpgradeChecker() {
     if (!isGlobalInstall()) return;
     if (!this._autoUpgradeEnabled) return;
+    this._startSelfVersionWatcher();
 
     this.upgradeChecker = startUpgradeChecker({
       onUpdateAvailable: async ({ current, latest }) => {
@@ -1082,6 +1084,31 @@ export class WatchdogAgent {
     });
   }
 
+  /**
+   * 磁盘版本自检（每 60s）：发现磁盘包版本 ≠ 本进程加载版本（被手动 npm i -g 升/降级）时，
+   * 自动走 restart-only 重启（杀旧 → 启新 → 校验），无需人工重启。
+   * 只比不等：手动降级同样重启，保证运行代码与磁盘一致。
+   */
+  _startSelfVersionWatcher() {
+    if (this._selfVersionTimer) return;
+    this._selfVersionTimer = setInterval(() => {
+      try {
+        const disk = getVersion();
+        if (disk && disk !== this._loadedVersion) {
+          console.error(
+            `[upgrade] 检测到包版本变化 ${this._loadedVersion} → ${disk}（手动升级），自动重启 watchdog...`,
+          );
+          clearInterval(this._selfVersionTimer);
+          this._selfVersionTimer = null;
+          spawnUpgrader({ ...this._buildRestartParams(), restartOnly: true });
+        }
+      } catch {
+        /* 读版本失败，下轮重试 */
+      }
+    }, 60_000);
+    if (this._selfVersionTimer.unref) this._selfVersionTimer.unref();
+  }
+
   /** 构建新版 watchdog 重启所需参数（透传给独立升级器） */
   _buildRestartParams() {
     return {

package/src/watchdog/upgrader.js

@@ -8,7 +8,7 @@
 
 import { exec, spawn, execFile } from "child_process";
 import { promisify } from "util";
-import { readFileSync, openSync, unlinkSync } from "fs";
+import { readFileSync, writeFileSync, openSync, unlinkSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
 import { homedir, tmpdir } from "os";
@@ -549,19 +549,38 @@ async function listWatchdogPids() {
 }
 
 /**
- * 启动新版 watchdog：
- * - Windows：`cmd.exe /c start cmd /k <node> <cli.js> watchdog ...`
- *   start 弹出【独立交互 cmd 窗口】（与 U 完全解耦），watchdog 日志直接显示在窗口里，
- *   /k 保持窗口打开（watchdog 退出后提示符仍在，便于排障）；中间 cmd 隐藏不闪窗。
- * - 其他平台：直接 detached spawn node，日志落盘 logFd。
+ * 启动新版 watchdog（Windows 方式 2026-09-25 重写 — 214 实测教训）：
+ *
+ * 旧实现（node spawn 直接嵌 start 命令，windowsHide:true）起的 watchdog 会「起而复死」：
+ *   外层 cmd 带 CREATE_NO_WINDOW 隐藏启动，其内 start 弹出的新控制台随外层生命周期
+ *   被系统回收，watchdog 写完存活标记后数秒内消失（1.4.159 自动升级后「看门狗没拉起来」实因）。
+ *
+ * 新实现：写临时 bat，由 cmd /c 执行；bat 内用 start 弹独立交互窗口运行新版 ——
+ *   与运维手动双击/命令行启动完全同构（213/214 实测该方式进程持久不灭）。
+ *   窗口标题含 WINDOW_TITLE_TAG，供下次升级 killOldWatchdogWindow 关窗匹配。
+ *
+ * 其他平台：直接 detached spawn node，日志落盘 logFd。
  * @returns {import("child_process").ChildProcess}
  */
 function spawnNewWatchdog(cliPath, args, logFd) {
   if (process.platform === "win32") {
+    // start 直接执行 node（不经 cmd /k 中转）：cmd /k 后带多个引号段会触发 cmd 的
+    // 引号剥离规则（剥整行首尾引号 → 带空格的 node 路径被截断成 C:\Program → 启动失败）
+    const cmdLine = [cliPath, ...args].map((a) => `"${a}"`).join(" ");
+    const batPath = join(
+      tmpdir(),
+      `tt-help-watchdog-start-${Date.now()}.bat`,
+    );
+    const bat = [
+      "@echo off",
+      `start "${WINDOW_TITLE_TAG}" "${process.execPath}" ${cmdLine}`,
+      "exit",
+    ].join("\r\n");
+    writeFileSync(batPath, bat + "\r\n", "utf-8");
     const child = spawn(
       "cmd.exe",
-      ["/c", "start", "cmd", "/k", process.execPath, cliPath, ...args],
-      // cwd 固定到用户主目录：防止新版 watchdog 继承包目录 CWD 锁死包目录（npm install EBUSY）
+      ["/c", batPath],
+      // 外层 cmd 隐藏且一闪即退；新窗口由 start 创建，独立持久
       { detached: true, stdio: "ignore", windowsHide: true, cwd: homeDir },
     );
     child.unref();
@@ -583,12 +602,94 @@ function buildWatchdogArgs({ serverUrl, clientId, intervalSec, noDaemon }) {
   return args;
 }
 
+/**
+ * 仅重启模式（--restart-only）：由运行中的 watchdog 在检测到磁盘包版本变化时调用。
+ * 复用完整升级模式的 杀旧→启新→存活校验（第 3/4/5 步），跳过下载/验证。
+ */
+async function runRestartOnlyMode(argv) {
+  const get = (f) => (argv.includes(f) ? argv[argv.indexOf(f) + 1] : undefined);
+  const serverUrl = get("--server");
+  const clientId = get("--client-id");
+  const intervalSec = parseInt(get("--interval"), 10) || 15;
+  const noDaemon = argv.includes("--no-daemon");
+  const oldPid =
+    (argv.includes("--old-pid") ? parseInt(get("--old-pid"), 10) : 0) ||
+    process.ppid;
+  if (!oldPid) {
+    console.error(`[restart-only] 无旧 pid，退出`);
+    process.exit(1);
+  }
+  console.error(`[restart-only] 重启 watchdog (旧 pid=${oldPid})...`);
+
+  // 杀旧：与完整模式一致（Ctrl+C 优雅 → 强杀 → 清树 → 孤儿 → 关窗）
+  const procSnapshot = await snapshotAllProcesses();
+  const descPids = listDescendantPids(procSnapshot, oldPid, process.pid);
+  let exited = false;
+  const gracefulSent =
+    process.platform === "win32" && (await sendConsoleCtrlC(oldPid));
+  if (gracefulSent) {
+    console.error(`[restart-only] 已发送 Ctrl+C，等待旧 watchdog 优雅停止业务...`);
+    exited = await waitProcessExit(oldPid, 8000);
+  }
+  if (!exited) {
+    if (gracefulSent)
+      console.error(`[restart-only] 旧 watchdog 未在 8s 内优雅退出，强制终止`);
+    exited = await terminateProcess(oldPid, 5000);
+    await new Promise((r) => setTimeout(r, 1000));
+  }
+  await killPidList(descPids, "[restart-only] 已清理旧 watchdog 进程树");
+  const orphanPids = listOrphanBusinessPids(await snapshotAllProcesses());
+  await killPidList(orphanPids, "[restart-only] 已清理孤儿业务进程");
+  await killOldWatchdogWindow();
+
+  // 启新（与完整模式一致：Windows 弹独立 cmd /k 窗口）
+  console.error(`[restart-only] 启动新版 watchdog ...`);
+  const cliPath = join(__dirname, "..", "..", "cli.js");
+  const args = buildWatchdogArgs({ serverUrl, clientId, intervalSec, noDaemon });
+  const logFd =
+    process.platform === "win32"
+      ? undefined
+      : openLogFile("tt-help-watchdog", "restart-only", "新版 watchdog 日志");
+  if (process.platform === "win32") deleteStartedFile();
+  spawnNewWatchdog(cliPath, args, logFd);
+
+  // 存活校验（与完整模式一致）
+  await new Promise((r) => setTimeout(r, 3000));
+  if (process.platform === "win32") {
+    const deadline = Date.now() + 15_000;
+    let st = null;
+    while (Date.now() < deadline && !st) {
+      const cur = readStartedFile();
+      if (cur && cur.pid > 0 && (await isProcessAlive(cur.pid))) st = cur;
+      if (!st) await new Promise((r) => setTimeout(r, 1000));
+    }
+    if (st) {
+      console.error(`[restart-only] 新版 watchdog 存活确认 (pid=${st.pid})，重启完成`);
+    } else {
+      console.error(`[restart-only] 新版 watchdog 启动后未存活，请查看窗口/日志排障`);
+      process.exit(1);
+    }
+  } else {
+    const newPids = (await listWatchdogPids()).filter((p) => p !== oldPid);
+    if (newPids.length > 0) {
+      console.error(`[restart-only] 新版 watchdog 存活确认 (pid=${newPids.join(",")})，重启完成`);
+    } else {
+      console.error(`[restart-only] 新版 watchdog 启动后未存活，请查看窗口/日志排障`);
+      process.exit(1);
+    }
+  }
+  process.exit(0);
+}
+
 /**
  * 独立升级器主流程（由旧 watchdog 以子进程方式启动）
  * 顺序：下载 → 验证版本 → 杀旧 → 启新。任一步失败都不杀旧，业务不断。
  * @param {string[]} argv - process.argv.slice(2)
  */
 export async function runUpgradeMode(argv) {
+  // 仅重启模式：磁盘包被手动升级（npm i -g）后由运行中的 watchdog 调用，
+  // 跳过下载与版本验证（此时磁盘与线上一致，会误判"未升级"），直接杀旧→启新→校验
+  if (argv.includes("--restart-only")) return runRestartOnlyMode(argv);
   const get = (f) => (argv.includes(f) ? argv[argv.indexOf(f) + 1] : undefined);
   const serverUrl = get("--server");
   const clientId = get("--client-id");
@@ -604,10 +705,22 @@ export async function runUpgradeMode(argv) {
     `[upgrade-proc] 开始下载新版: npm install -g ${PACKAGE}@latest ...`,
   );
   const beforeVersion = getVersion(); // 下载前版本，用于验证 npm install 真正生效
-  const result = await performUpgrade();
+  let result = await performUpgrade();
+  if (!result.success && /EBUSY|resource busy/i.test(result.output)) {
+    // Windows 实测：运行中的 node/watchdog 或其 cwd 在包目录内时，npm 覆盖文件报 EBUSY。
+    // 此刻升级已势在必行（版本差已确认），终止旧 watchdog 释放文件锁后重试安装。
+    console.error(
+      `[upgrade-proc] 包目录被运行进程锁定（EBUSY），终止旧 watchdog 释放锁后重试安装...`,
+    );
+    const lockSnapshot = await snapshotAllProcesses();
+    const lockDescPids = listDescendantPids(lockSnapshot, oldPid, process.pid);
+    await terminateProcess(oldPid, 5000);
+    await killPidList(lockDescPids, "[upgrade-proc] 已停止旧 watchdog 释放包目录锁");
+    result = await performUpgrade();
+  }
   if (!result.success) {
     const err = result.output.substring(0, 300);
-    console.error(`[upgrade-proc] 下载失败，保持当前版本运行: ${err}`);
+    console.error(`[upgrade-proc] 下载失败，保持当前状态: ${err}`);
     process.exit(1);
   }
 
@@ -759,9 +872,11 @@ export function spawnUpgrader({
   intervalSec = 15,
   spawnDaemon = true,
   oldPid = 0,
+  restartOnly = false,
 } = {}) {
   const upgraderPath = fileURLToPath(import.meta.url);
   const args = ["--upgrade", "--old-pid", String(oldPid || process.ppid)];
+  if (restartOnly) args.push("--restart-only");
   if (serverUrl) args.push("--server", serverUrl);
   if (clientId) args.push("--client-id", clientId);
   args.push("--interval", String(intervalSec));