tt-help-cli-ycl 1.4.183 → 1.4.185

package/scripts/test-login-pool.mjs

@@ -1,25 +1,32 @@
 /**
  * 共享登录池单元测试 — 模块级直驱（不起 HTTP）
  *
- * 覆盖:
- *   1. 入池（cookies 归一化/username 兜底/去重/池满）+ 视图脱敏（明文永不出）
+ * 覆盖（2026-11-04 对齐 7be35e8 账号中心简化 + 1cda80f 连败计数改算法）:
+ *   1. 入池（cookies 归一化/username 兜底/去重）+ 视图脱敏（明文永不出）
  *   2. 指派独占约束（同账号双租拒绝 / 目标端口占用拒绝 / force 替换 / suspect 需 force）
  *   3. 心跳下发（applyLogin/clearLogin 一次性取走，cookies 仅在心跳响应出现）
- *   4. 续租 + 健康采集（lastBusinessOkAt/emptyStreak）
- *   5. 掉线回收（leaseExpired）+ 命令超时作废（deliveryExpired 回收）
+ *   4. 心跳零状态变更（续租/健康采集已物理删除）+ 节点执行回报写回（applied/applyFailed/cleared）
+ *   5. 僵尸回收（lease.assignedAt 硬顶 2h → zombieReaped，reapZombieLeases）+ 命令超时作废（deliveryExpired）
  *   6. release（含 clearOnNode）+ update 状态迁移 + delete 保护
+ *   7. 取号排序（K1/K2/K3 + 30min 休息窗）· 自动释放（一实例一号）· retired 排除
+ *   8. 登录态导入 import（登记语义 + lastImportFrom）
+ *   9. 重登录 relogin（X 方案：使用中仅换 cookies；suspect 回池 / retired 复活）
+ *   10. 巡检 healthTargets/recordHealth/checkPoolAccounts + prepareRelogin（X 方案守卫同步放宽）
  *
- * 跑法: HOME=$(mktemp -d) node scripts/test-login-pool.mjs
+ * 跑法: node scripts/test-login-pool.mjs
+ *   （自建临时 HOME 并在 import 前覆盖环境变量——绝不读写真实 ~/.tt-help-watchdog-logins.json）
  */
 import assert from "assert";
-import { readFileSync, existsSync } from "fs";
+import { mkdtempSync, readFileSync, writeFileSync, existsSync } from "fs";
+import { tmpdir } from "os";
 import { join } from "path";
 
+// ── 测试基建：临时 HOME 隔离 ──
+// login-pool.js 的 POOL_FILE 在模块加载期由 os.homedir() 计算（POSIX 下 homedir() 实时读
+// process.env.HOME），故必须在动态 import 之前覆盖 HOME/USERPROFILE；生产代码零改动即可隔离。
+process.env.HOME = mkdtempSync(join(tmpdir(), "loginpool-test-"));
+process.env.USERPROFILE = process.env.HOME; // Windows 语义兜底
 const HOME = process.env.HOME;
-if (!HOME || HOME === "/") {
-  console.error("请用隔离 HOME 运行: HOME=$(mktemp -d) node scripts/test-login-pool.mjs");
-  process.exit(1);
-}
 
 const {
   getLoginPoolView,
@@ -31,7 +38,7 @@ const {
   acquireAccount,
   importAccount,
   heartbeatLoginPool,
-  reapExpiredLeases,
+  reapZombieLeases,
   reloginAccount,
   prepareRelogin,
   healthTargets,
@@ -197,19 +204,27 @@ console.log("\n[3] 心跳下发");
   check("GET 视图持续无明文", !JSON.stringify(getLoginPoolView()).includes("sid-b"));
 }
 
-// ── 4. 续租 + 健康采集 + 节点执行回报 ──
-console.log("\n[4] 续租 + 健康采集 + 节点执行回报");
+// ── 4. 心跳零状态变更 + 节点执行回报（7be35e8：续租/健康采集已删，心跳唯一写路径=applied 写回） ──
+console.log("\n[4] 心跳零状态变更 + 节点执行回报");
 {
-  const okAt = Date.now() - 60000;
-  heartbeatLoginPool("F-2", {
-    loginPool: { ports: { 9224: { username: "userC", lastBusinessOkAt: okAt, emptyStreak: 2 } } },
+  const cBefore = getLoginPoolView().accounts.find((x) => x.username === "userC"); // 在租（F-2:9224）
+  const snapBefore = JSON.stringify(getLoginPoolView());
+
+  // 无命令、无回报的心跳（携带旧版健康采集 payload）→ 返回 undefined 且池状态一个字节都不动
+  const hb = heartbeatLoginPool("F-ZERO", {
+    loginPool: { ports: { 9224: { username: "userC", lastBusinessOkAt: Date.now() - 60000, emptyStreak: 2 } } },
   });
+  check("无命令无回报的心跳返回 undefined", hb === undefined, JSON.stringify(hb));
+  const snapAfter = JSON.stringify(getLoginPoolView());
+  check("心跳零状态变更（整池快照逐字节一致）", snapBefore === snapAfter);
+
   let b = getLoginPoolView().accounts.find((x) => x.username === "userC");
-  check("业务出活时间入库", b.lease.lastBusinessOkAt === okAt);
-  check("空响应连击入库", b.lease.emptyStreak === 2);
-  check("续租刷新 lastHealthAt", b.lease.lastHealthAt > 0);
+  check("健康采集已删：lastBusinessOkAt/emptyStreak 不再入库",
+    b.lease.lastBusinessOkAt === undefined && b.lease.emptyStreak === undefined);
+  check("心跳不刷新 lastUsedAt/lastHealthAt（盖章/镜像已删）",
+    b.lastUsedAt === cBefore.lastUsedAt && b.lastHealthAt === (cBefore.lastHealthAt || null));
 
-  // 节点 applyLogin 成功回报（含持久化）
+  // 节点 applyLogin 成功回报（含持久化）→ 写回租约（心跳唯一写路径）
   heartbeatLoginPool("F-2", {
     loginPool: {
       applied: [{ action: "applyLogin", accountId: b.id, port: 9224, username: "userC", ok: true, persisted: true, at: Date.now() }],
@@ -228,31 +243,55 @@ console.log("\n[4] 续租 + 健康采集 + 节点执行回报");
   b = getLoginPoolView().accounts.find((x) => x.username === "userC");
   check("失败回报覆盖状态（最新为准）", b.lease.lastAppliedOk === false);
   check("历史记录 applyFailed", b.history.some((h) => h.event === "applyFailed"));
+
+  // clearLogin 执行回报
+  heartbeatLoginPool("F-2", {
+    loginPool: {
+      applied: [{ action: "clearLogin", accountId: b.id, port: 9224, at: Date.now() }],
+    },
+  });
+  b = getLoginPoolView().accounts.find((x) => x.username === "userC");
+  check("clearLogin 回报记 cleared", b.history.some((h) => h.event === "cleared"));
 }
 
-// ── 5. 掉线回收 + 命令超时作废 ──
-console.log("\n[5] 掉线回收 + 命令超时作废");
+// ── 5. 僵尸回收（assignedAt 硬顶 2h，reapZombieLeases）+ 命令超时作废 ──
+console.log("\n[5] 僵尸回收（2h 硬顶）+ 命令超时作废");
 {
-  // 直接改内存时间不可行（模块内部 now），改用字段注入验证 reap 逻辑：
-  // 给 A 重新指派，然后人为把 lease.lastHealthAt 拨回 13 小时前
+  // 5.1 边界内（≤2h）不回收
   const aLeased = assignAccount({ id: accA.id, userId: "F-3", port: 9225 });
   check("A 再指派成功", aLeased.status === "leased");
-  // 取走 F-3 的命令，避免干扰
-  heartbeatLoginPool("F-3", {});
-
-  // 内部状态篡改：用 update 不行（不暴露 lease 写），通过文件回写模拟时间流逝
-  const file = join(HOME, ".tt-help-watchdog-logins.json");
-  // 强制落盘：scheduleSave 是 3s debounce；reapExpiredLeases 内部 ensureLoaded 读文件，
-  // 这里直接改文件 + 清模块缓存不可行（ESM 无缓存清理）→ 用 lastHealthAt 拨回方式：
-  // 模块导出 _accountsInternal 供测试直改内存
-  const internal = (await import("../src/watch/login-pool.js"))._accountsInternal();
-  const aInternal = internal.find((x) => x.username === "userA");
-  aInternal.lease.lastHealthAt = Date.now() - 13 * 60 * 60 * 1000; // 13h 前
-  const reaped = reapExpiredLeases();
-  check("超时租约被回收", reaped === 1, `reaped=${reaped}`);
+  heartbeatLoginPool("F-3", {}); // 取走 F-3 命令，避免干扰
+
+  // 内部状态直改（_accountsInternal 供测试直改内存）：assignedAt 拨回 1h59m
+  const aInternal = _accountsInternal().find((x) => x.username === "userA");
+  aInternal.lease.assignedAt = Date.now() - (2 * 60 * 60 * 1000 - 60 * 1000);
+  check("持有 1h59m 未超顶不回收", reapZombieLeases() === 0);
+  check("边界内租约保持", getLoginPoolView().accounts.find((x) => x.username === "userA").status === "leased");
+
+  // 5.2 超顶（>2h）→ zombieReaped 回收回池
+  aInternal.lease.assignedAt = Date.now() - (2 * 60 * 60 * 1000 + 60 * 1000);
+  const reaped = reapZombieLeases();
+  check("超 2h 租约被回收", reaped === 1, `reaped=${reaped}`);
   const aView = getLoginPoolView().accounts.find((x) => x.username === "userA");
   check("回收后回池", aView.status === "pool" && !aView.lease);
-  check("历史记录 leaseExpired", aView.history.some((h) => h.event === "leaseExpired"));
+  check("历史留痕 zombieReaped", aView.history.some((h) => h.event === "zombieReaped"));
+  check("回收盖 lastUsedAt（休息窗从回收起算）", aView.lastUsedAt > 0 && Math.abs(aView.lastUsedAt - Date.now()) < 60000);
+
+  // 5.3 命令 10min 未被取走 → deliveryExpired + 租约回收（区别于僵尸路径）
+  assignAccount({ id: aView.id, userId: "F-5", port: 9227 }); // 排队命令，故意不心跳取走
+  await new Promise((r) => setTimeout(r, 3200)); // 等防抖落盘，保证磁盘=内存（外部改文件前的安全窗）
+  const file = join(HOME, ".tt-help-watchdog-logins.json");
+  const disk = JSON.parse(readFileSync(file, "utf-8"));
+  const cmd = disk.queue.find((c) => c.userId === "F-5");
+  check("待发命令已随池文件持久化", !!cmd);
+  cmd.queuedAt = Date.now() - 11 * 60 * 1000; // 拨回 11 分钟前（mtime 变化 → 模块自动重载）
+  writeFileSync(file, JSON.stringify(disk, null, 2), "utf-8");
+  const zombieCount = reapZombieLeases(); // 内部先 dropStaleCommands
+  check("超时命令走 deliveryExpired 路径（僵尸计数 0）", zombieCount === 0, `zombie=${zombieCount}`);
+  const aAfter = getLoginPoolView().accounts.find((x) => x.username === "userA");
+  check("超时命令作废并回收租约回池", aAfter.status === "pool" && !aAfter.lease, `status=${aAfter.status}`);
+  check("历史留痕 deliveryExpired", aAfter.history.some((h) => h.event === "deliveryExpired"));
+  check("作废后 F-5 心跳收不到命令", heartbeatLoginPool("F-5", {}) === undefined);
 }
 
 // ── 6. release / update / delete ──
@@ -294,7 +333,7 @@ console.log("\n[6] release / update / delete");
   }
 }
 
-// ── 7. 取号排序（双键+冷却）· 自动释放（一实例一号）· retired 排除 ──
+// ── 7. 取号排序（K1/K2/K3 + 30min 休息窗）· 自动释放（一实例一号）· retired 排除 ──
 console.log("\n[7] 取号·导入·自动释放");
 {
   // 清池重建：全量 release→retired→delete，再导入 4 个新号（uc 全 0，createdAt 递增）
@@ -311,25 +350,25 @@ console.log("\n[7] 取号·导入·自动释放");
   mk("userE"); mk("userF"); mk("userG"); mk("userH");
   check("重建后池=4", getLoginPoolView().total === 4);
 
-  // 7.1 双键排序：uc 全 0 → createdAt 升序 → userE
+  // 7.1 K1 从未用过最前（组内 K3 退化为 createdAt 升序）→ userE
   const t1 = acquireAccount({ userId: "n1" });
   check("永不用过的优先（userE）", t1.username === "userE", `got ${t1.username}`);
   check("取号次数 +1", t1.useCount === 1);
 
-  // 7.2 第二低（userF）[自动释放：n2 无旧租约，无操作]
+  // 7.2 其次 userF [自动释放：n2 无旧租约，无操作]
   const t2 = acquireAccount({ userId: "n2" });
   check("其次取 userF", t2.username === "userF", `got ${t2.username}`);
 
-  // 7.3 错峰冷却：还回 userE（lastUsedAt=now → 10min 冷却）→ 不立即复用
+  // 7.3 休息窗（30min）：还回 userE（lastUsedAt=now → 窗内不可领取）→ 不立即复用
   releaseAccount({ id: t1.id });
   const t3 = acquireAccount({ userId: "n3" });
   check("刚还的号不立即复用（取 userG）", t3.username === "userG", `got ${t3.username}`);
 
-  // 7.4 最后一个非冷却空闲号（userH）
+  // 7.4 最后一个非休息窗空闲号（userH）
   const t4 = acquireAccount({ userId: "n4" });
   check("取 userH", t4.username === "userH", `got ${t4.username}`);
 
-  // 7.5 ③ 自动释放：池内放入新号 → n1 再取 → 拿新号 + n1 名下旧租约（userE）自动归还
+  // 7.5 自动释放：池内放入新号 → n1 再取 → 拿新号 + n1 名下旧租约（userE）自动归还
   importAccount({ userId: "x", username: "userZ", cookies: [{ name: "sessionid", value: "sid-z" }] });
   const t5 = acquireAccount({ userId: "n1" });
   check("n1 取到新放入的 userZ", t5.username === "userZ", `got ${t5.username}`);
@@ -343,7 +382,7 @@ console.log("\n[7] 取号·导入·自动释放");
 
   // 7.7 retired 不参与取号：停用 userZ → 取号拿到别的
   const zId = getLoginPoolView().accounts.find((x) => x.username === "userZ").id;
-  releaseAccount({ id: zId }).account; // 若在租则释放
+  releaseAccount({ id: zId });
   updateAccount({ id: zId, status: "retired" });
   const t6 = acquireAccount({ userId: "n5" });
   check("retired 不被取用", t6.username !== "userZ", `got ${t6.username}`);
@@ -383,7 +422,7 @@ console.log("\n[8] 登录态导入 import");
   check("缺 cookies 确实抛错", threw);
 }
 
-console.log("\n[9] 重登录 relogin（覆盖刷新 + 守卫）");
+console.log("\n[9] 重登录 relogin（X 方案：使用中仅换 cookies + 守卫 + 复活）");
 {
   for (const a of getLoginPoolView().accounts) {
     try { releaseAccount({ id: a.id }); } catch {}
@@ -405,7 +444,7 @@ console.log("\n[9] 重登录 relogin（覆盖刷新 + 守卫）");
   const after = JSON.parse(JSON.stringify(_accountsInternal().find((a) => a.username === "userD")));
   check("覆盖刷新（新 cookies 落池）", JSON.stringify(after.cookies).includes("sid-d-new") && JSON.stringify(after.cookies).includes("poc_marker"));
   check("历史含 relogin 事件", (after.history || []).some((h) => h.event === "relogin"));
-  check("正常刷新不改状态不复活", r.revived === false && r.wasSuspect === false && r.account.status === "pool");
+  check("空闲刷新不改状态不复活", r.revived === false && r.wasSuspect === false && r.account.status === "pool");
 
   let threw = false;
   try { reloginAccount({ username: "ghost", cookies: D2, userId: "cli" }); } catch (e) { threw = /不在池中/.test(e.message); }
@@ -417,10 +456,14 @@ console.log("\n[9] 重登录 relogin（覆盖刷新 + 守卫）");
   try { reloginAccount({ username: "userD", userId: "cli" }); } catch (e) { threw = /cookies/.test(e.message); }
   check("缺 cookies 拒绝", threw);
 
+  // X 方案（2026-11-03）：使用中也可重登录——仅替换池内 cookies，状态与租约原样保留
   acquireAccount({ userId: "T1", port: 9400 });
-  threw = false;
-  try { reloginAccount({ username: "userD", cookies: D2, userId: "cli" }); } catch (e) { threw = /使用中/.test(e.message); }
-  check("使用中拒绝重登录", threw);
+  r = reloginAccount({ username: "userD", cookies: D2, userId: "cli", note: "使用中刷新" });
+  check("使用中可重登录（X 方案）", !!r && r.account.status === "leased", JSON.stringify(r && r.account && r.account.status));
+  check("使用中重登录不动租约", r.account.lease && r.account.lease.userId === "T1" && r.account.lease.port === 9400);
+  const afterUse = JSON.parse(JSON.stringify(_accountsInternal().find((a) => a.username === "userD")));
+  check("使用中重登录 cookies 已覆盖", JSON.stringify(afterUse.cookies).includes("poc_marker"));
+  check("使用中重登录历史注明仅换 cookies", (afterUse.history || []).some((h) => h.event === "relogin" && h.detail.includes("使用中")));
   releaseAccount({ id: getLoginPoolView().accounts.find((a) => a.username === "userD").id });
 
   updateAccount({ id: getLoginPoolView().accounts.find((a) => a.username === "userD").id, status: "suspect" });
@@ -470,7 +513,7 @@ console.log("\n[10] 巡检 healthTargets/recordHealth/checkPoolAccounts（注入
   const aliveAcc = getLoginPoolView().accounts.find((a) => a.username === "u-alive");
   check("活号不写 history（防刷屏）", !(aliveAcc.history || []).some((h) => h.event === "health"));
 
-  acquireAccount({ userId: "T2", port: 9401 }); // 租走最久未用的（u-alive 或 u-dead 中 LRU 者）
+  acquireAccount({ userId: "T2", port: 9401 }); // 租走空闲号（u-alive；u-dead 是 suspect 不会被取）
   const leased = getLoginPoolView().accounts.find((a) => a.status === "leased");
   const rec = recordHealth({ id: leased.id, ok: "dead", detail: "单测" });
   check("leased 死号仅记录不迁移状态", rec.status === "leased" && leased.username === rec.username);
@@ -478,10 +521,10 @@ console.log("\n[10] 巡检 healthTargets/recordHealth/checkPoolAccounts（注入
   const notLeased = getLoginPoolView().accounts.find((a) => a.status !== "leased").username;
   const prep = prepareRelogin({ username: notLeased });
   check("prepare 返回明文 cookies", Array.isArray(prep.account.cookies) && prep.account.cookies.length > 0);
+  // X 方案：prepareRelogin 守卫与 reloginAccount 同步放宽——使用中也放行（仅在池即可）
+  const prepLeased = prepareRelogin({ username: leased.username });
+  check("prepare 使用中也返回 cookies（X 方案守卫放宽）", Array.isArray(prepLeased.account.cookies) && prepLeased.account.cookies.length > 0);
   let threw = false;
-  try { prepareRelogin({ username: leased.username }); } catch (e) { threw = /使用中/.test(e.message); }
-  check("prepare 使用中拒绝", threw);
-  threw = false;
   try { prepareRelogin({ username: "ghost" }); } catch (e) { threw = /不在池中/.test(e.message); }
   check("prepare 不在池拒绝", threw);
 }

package/scripts/test-process-manager-label.mjs

@@ -0,0 +1,145 @@
+/**
+ * watchdog 进程日志前缀标签单测 — deriveDisplayLabel 纯函数直驱
+ *
+ * 覆盖（2026-11-04 定稿规则表全部 5 条分支 + 引号/路径边界）:
+ *   1. --base-port 单端口        → [explore:9223]
+ *   2. --port 单端口（仅浏览器类）→ [refresh-mini:5222]；webserver/watch 的 --port 不吃
+ *   3. --base-port --port-count  → 区间压缩 [explore:9223-9225]
+ *   4. 解析不到端口              → [comments]（不猜默认端口）
+ *   5. 程序名也解析不出          → 兜底 fallbackId（即 cmdDef.name || id）
+ *   边界: 引号形态 "tt-help" "explore" / node+脚本路径取子命令 / 脚本本体即程序 /
+ *         Windows 启动器（.cmd/.exe）/ 值含引号空格不影响端口提取
+ *
+ * 跑法: node scripts/test-process-manager-label.mjs
+ */
+import assert from "assert";
+import { deriveDisplayLabel } from "../src/watchdog/process-manager.js";
+
+let pass = 0;
+let fail = 0;
+function check(name, actual, expected) {
+  try {
+    assert.strictEqual(actual, expected);
+    pass++;
+    console.log(`  ✓ ${name}`);
+  } catch {
+    fail++;
+    console.error(`  ✗ ${name}\n    期望: ${expected}\n    实际: ${actual}`);
+  }
+}
+
+console.log("规则 1：--base-port 单端口");
+check(
+  "explore --base-port 9223",
+  deriveDisplayLabel("tt-help explore --base-port 9223 --server http://127.0.0.1:3001", "1793630915534"),
+  "explore:9223",
+);
+check(
+  "refresh --base-port 8222（无 port-count 默认 1 个端口）",
+  deriveDisplayLabel("tt-help refresh --base-port 8222", "r1"),
+  "refresh:8222",
+);
+
+console.log("规则 2：--port 单端口（仅浏览器类命令提取，防误吃服务端口）");
+check(
+  "refresh-mini --port 5222",
+  deriveDisplayLabel("tt-help refresh-mini --port 5222 --headless", "m1"),
+  "refresh-mini:5222",
+);
+check(
+  "webserver --port 3000 不吃端口（非浏览器类命令）",
+  deriveDisplayLabel("tt-help webserver --port 3000", "w1"),
+  "webserver",
+);
+check(
+  "watch --port 3000 不吃端口（非浏览器类命令）",
+  deriveDisplayLabel("tt-help watch --port 3000 -o data.db", "w2"),
+  "watch",
+);
+
+console.log("规则 3：--base-port + --port-count 区间压缩");
+check(
+  "explore --base-port 9223 --port-count 3 → 9223-9225",
+  deriveDisplayLabel("tt-help explore --base-port 9223 --port-count 3", "e1"),
+  "explore:9223-9225",
+);
+check(
+  "attach --base-port 9222 --port-count 5 → 9222-9226",
+  deriveDisplayLabel("tt-help attach --base-port 9222 --port-count 5", "a1"),
+  "attach:9222-9226",
+);
+
+console.log("规则 4：解析不到端口 → 只显示程序名（不猜默认端口）");
+check("comments 无端口参数", deriveDisplayLabel("tt-help comments --server http://127.0.0.1:3001", "c1"), "comments");
+check("videostats 无端口参数", deriveDisplayLabel("tt-help videostats data/result.db -p 3", "v1"), "videostats");
+check("recheck 无端口参数", deriveDisplayLabel("tt-help recheck", "rc1"), "recheck");
+
+console.log("规则 5：程序名也解析不出 → 兜底 fallbackId");
+check("空命令行", deriveDisplayLabel("", "1793630915534"), "1793630915534");
+check("纯空白", deriveDisplayLabel("   ", "fallback-id"), "fallback-id");
+check("null 命令行", deriveDisplayLabel(null, "fb"), "fb");
+check("裸路径分隔符解析不出程序名", deriveDisplayLabel("/ --base-port 9223", "fb2"), "fb2");
+
+console.log("边界：引号形态");
+check(
+  '"tt-help" "explore" 全引号',
+  deriveDisplayLabel('"tt-help" "explore" --base-port 9223', "q1"),
+  "explore:9223",
+);
+check(
+  "引号值含空格不影响端口提取",
+  deriveDisplayLabel('tt-help explore --name "my explore" --base-port 9223', "q2"),
+  "explore:9223",
+);
+check(
+  "单引号启动器",
+  deriveDisplayLabel("'tt-help' refresh-mini --port 5222", "q3"),
+  "refresh-mini:5222",
+);
+
+console.log("边界：node/路径启动形态");
+check(
+  "node + 脚本路径 → 取子命令 token",
+  deriveDisplayLabel("node /usr/local/lib/cli.js explore --base-port 9223", "p1"),
+  "explore:9223",
+);
+check(
+  "node src/main.js watch → 取子命令 watch（--port 不吃，watch 非浏览器类）",
+  deriveDisplayLabel("node src/main.js watch --port 3000 -o tmp.db", "p2"),
+  "watch",
+);
+check(
+  "node scraper.js --port 9222 → 脚本本体即程序；scraper 不属浏览器类词表，--port 不吃",
+  deriveDisplayLabel("node scraper.js --port 9222", "p3"),
+  "scraper",
+);
+check(
+  "node explore.js --port 9222 → 脚本名属浏览器类词表，吃端口",
+  deriveDisplayLabel("node explore.js --port 9222", "p3b"),
+  "explore:9222",
+);
+check(
+  "node.exe + 相对脚本路径",
+  deriveDisplayLabel("node.exe cli.js refresh-mini --port 5222", "p4"),
+  "refresh-mini:5222",
+);
+check(
+  "Windows 完整路径 tt-help.cmd 启动器",
+  deriveDisplayLabel("C:\\tools\\tt-help.cmd explore --base-port 9223 --port-count 2", "p5"),
+  "explore:9223-9224",
+);
+check(
+  "裸命令（无启动器）直接取 token[0]",
+  deriveDisplayLabel("explore --base-port 9223", "p6"),
+  "explore:9223",
+);
+
+console.log("边界：cmdDef.args 数组形态（startCommand join 后派生）");
+check(
+  "args 数组 join 成命令行后解析",
+  deriveDisplayLabel(["tt-help", "explore", "--base-port", "9223"].join(" "), "ar1"),
+  "explore:9223",
+);
+
+console.log(`\n结果: ${pass} 通过, ${fail} 失败`);
+process.exit(fail > 0 ? 1 : 0);