tt-help-cli-ycl 1.4.183 → 1.4.185

package/src/watchdog/process-manager.js

@@ -31,8 +31,10 @@ const RESTART_SPAWN_STAGGER_MS = 60000; // 启动错峰 60s
 const STALE_LOG_TIMEOUT_MS = 15 * 60 * 1000; // 15 分钟无日志输出视为假死
 
 // === 控制台日志格式化（仅显示层增强，不影响任何功能链路） ===
-// 目标：多进程日志交错打印时，通过时间戳 + 固定宽度彩色 [cmdId] 前缀方便人眼分流。
+// 目标：多进程日志交错打印时，通过时间戳 + 固定宽度彩色 [程序名:端口] 前缀方便人眼分流。
 // 兼容：Windows（Windows Terminal 彩色 / 旧 conhost 自动降级纯文本）与 macOS（原生 ANSI 彩色）。
+// 前缀标签由 deriveDisplayLabel 从命令行派生（如 [explore:9223]/[explore:9223-9225]），
+// 解析失败退回 cmdDef.name || id。内部 cmdId 完全不动（stop/toggle/日志拉取/LLM 分析按它索引）。
 
 // 每进程固定一种颜色（按 cmdId 哈希取色），新增进程自动分配且不重复
 const PROC_COLORS = [32, 36, 33, 35, 34, 92, 96, 93, 95, 94];
@@ -141,6 +143,61 @@ function splitCommand(cmdLine) {
   return parts;
 }
 
+// === 显示层标签派生（仅显示层增强，不影响任何功能链路；2026-11-04 定稿） ===
+// 规则：[程序名:端口]，端口解析不到就只显示程序名，程序名也解析不到退回 fallbackId。
+// 端口提取复用 extractCdpPorts 原样逻辑（多端口区间压缩为 首-尾，端口天然连续）。
+
+// 启动器 token（basename 去掉 .exe/.cmd/.bat 后比对）：其后的 token 才是程序名/子命令
+const LAUNCHER_RE = /^(?:tt-help|node|npx)(?:\.(?:exe|cmd|bat))?$/i;
+const SCRIPT_EXT_RE = /\.(?:mjs|cjs|js)$/i;
+
+// 跨平台 basename（同时处理 / 与 Windows \）
+function pathBaseName(p) {
+  const s = String(p || "");
+  const idx = Math.max(s.lastIndexOf("/"), s.lastIndexOf("\\"));
+  return idx >= 0 ? s.slice(idx + 1) : s;
+}
+
+/**
+ * 从拆分后的 token 中解析程序名。
+ * token[0] 为启动器（tt-help/node/npx）时取 token[1]；
+ * 取到的 token 是脚本文件路径（.js/.mjs/.cjs）时：
+ *   - 后面还有非 flag token（子命令）→ 取子命令（node src/main.js watch → watch）
+ *   - 否则取 basename 去扩展名（node scraper.js --port X → scraper）
+ * 解析不出返回 null（调用方退回 fallbackId）。
+ */
+function deriveProgramName(tokens) {
+  if (!Array.isArray(tokens) || tokens.length === 0) return null;
+  let idx = 0;
+  const firstBase = pathBaseName(tokens[0]).replace(/\.(?:exe|cmd|bat)$/i, "");
+  if (LAUNCHER_RE.test(firstBase) && tokens.length > 1) idx = 1;
+  const base = pathBaseName(tokens[idx]);
+  if (SCRIPT_EXT_RE.test(base)) {
+    const next = tokens[idx + 1];
+    if (next && !next.startsWith("-")) return next;
+    return base.replace(SCRIPT_EXT_RE, "") || null;
+  }
+  return base || null;
+}
+
+/**
+ * 派生日志前缀显示标签：[程序名:端口]（纯函数，导出供单测覆盖全部分支）。
+ *   - tt-help explore --base-port 9223 --port-count 3 → "explore:9223-9225"
+ *   - tt-help refresh-mini --port 5222               → "refresh-mini:5222"（单端口仅浏览器类命令提取）
+ *   - tt-help comments（无端口参数）                  → "comments"（不猜默认端口，避免误导）
+ *   - 全部解析不出                                    → fallbackId（即 cmdDef.name || id，兜底回现状）
+ */
+export function deriveDisplayLabel(cmdLine, fallbackId) {
+  const tokens = splitCommand(String(cmdLine || ""));
+  if (tokens.length === 0) return fallbackId;
+  const prog = deriveProgramName(tokens);
+  if (!prog) return fallbackId;
+  const ports = extractCdpPorts(String(cmdLine || ""));
+  if (ports.length === 1) return `${prog}:${ports[0]}`;
+  if (ports.length > 1) return `${prog}:${ports[0]}-${ports[ports.length - 1]}`;
+  return prog;
+}
+
 function getProcessStats(pid) {
   try {
     if (IS_WIN) {
@@ -244,7 +301,7 @@ function getChildPid(parentPid) {
 export class ProcessManager extends EventEmitter {
   constructor() {
     super();
-    /** @type {Map<string, {cmdId:string, cmdDef:object, child:ChildProcess, startTime:number, restartCount:number, thresholds:object, stopped:boolean}>} */
+    /** @type {Map<string, {cmdId:string, cmdDef:object, displayLabel:string, child:ChildProcess, startTime:number, restartCount:number, thresholds:object, stopped:boolean}>} */
     this.processes = new Map();
     /** @type {Map<string, number>} cmdId → 连续异常重启次数（跨实例累计；稳定运行后清零）
      *  2026-09-25 修复: 原先计数存在每个实例的 info 上，自动重启重建 info 后归零，
@@ -258,6 +315,12 @@ export class ProcessManager extends EventEmitter {
    */
   startCommand(cmdDef) {
     let { id, command, args = [] } = cmdDef;
+    // 显示层标签（仅显示用；cmdId 不动）。在 splitCommand 改写 command/args 前派生，
+    // 重启路径（自动重启/假死/阈值）都经 startCommand，标签随之重建。
+    const displayLabel = deriveDisplayLabel(
+      [command, ...(Array.isArray(args) ? args : [])].join(" "),
+      (cmdDef && cmdDef.name) || id,
+    );
     if (this.processes.has(id)) {
       // 已有进程在运行（或 stopCommand 还未清理），跳过
       const existing = this.processes.get(id);
@@ -309,6 +372,7 @@ export class ProcessManager extends EventEmitter {
       this.processes.set(id, {
         cmdId: id,
         cmdDef,
+        displayLabel,
         child: null,
         startTime,
         restartCount: 0,
@@ -327,9 +391,8 @@ export class ProcessManager extends EventEmitter {
       if (msg) {
         const short = msg.substring(0, 200);
         // 仅显示层格式化：时间戳 + 彩色固定宽度前缀，内容不变。
-        // 前缀优先用命令名（如 explore-F1），未命名时退回 cmdId。
-        const displayId = (cmdDef && cmdDef.name) || id;
-        printProcessLine(displayId, short);
+        // 前缀用启动时派生的 [程序名:端口] 标签，解析失败已退回 name||id。
+        printProcessLine(displayLabel, short);
         // 环形缓冲：保留最近 N 行供 LLM 分析
         const info = this.processes.get(id);
         if (info) {
@@ -388,6 +451,7 @@ export class ProcessManager extends EventEmitter {
     this.processes.set(id, {
       cmdId: id,
       cmdDef,
+      displayLabel,
       child,
       startTime,
       restartCount: 0,
@@ -466,7 +530,8 @@ export class ProcessManager extends EventEmitter {
 
       result.push({
         cmdId,
-        name: info.cmdDef.name || cmdId,
+        // 显示层 name 与日志前缀同源（[程序名:端口]），web 页面进程列表与日志一致
+        name: info.displayLabel || info.cmdDef.name || cmdId,
         pid,
         status: info.child
           ? info.child.exitCode === null

package/src/watchdog/reporter.js

@@ -88,6 +88,8 @@ export function getClientConfig() {
         maxComments: cfg.maxComments,
         maxFollowing: cfg.maxFollowing,
         maxFollowers: cfg.maxFollowers,
+        // 内存阈值覆盖（HealthChecker 用；顶层级键——cfg.browser 是 Edge 路径字符串，无法嵌套）
+        memoryThreshold: cfg.memoryThreshold,
       };
     }
   } catch {