tt-help-cli-ycl 1.4.183 → 1.4.184

package/src/watch/server.js

@@ -24,6 +24,7 @@ import {
   prepareRelogin,
   clearAccountHistory,
   clearAllAccountHistory,
+  setAccountFace,
 } from "./login-pool.js";
 import { checkPoolAccounts } from "./login-health.js";
 
@@ -738,7 +739,6 @@ async function load() {
       ((b.lastUsedAt || b.createdAt || 0) - (a.lastUsedAt || a.createdAt || 0)));
     const rows = list.map((a, idx) => {
       const l = a.lease;
-      const biz = a.lastBusinessOkAt ? fmt(a.lastBusinessOkAt) : '无记录';
       const expired = a.sessionExpiresAt && a.sessionExpiresAt < Date.now();
       const st = ST[a.status] || [a.status, ''];
       const who = l
@@ -748,16 +748,17 @@ async function load() {
       const lastApp = l ? (a.prevAppName || null) : (a.lastAppName || null);
       const recent = [];
       if (lastApp) recent.push(esc(lastApp));
-      const sw = Object.entries(a.switchStats || {});
-      if (sw.length) recent.push('<span class="muted">' + sw.map(kv => (RS[kv[0]] || esc(kv[0])) + '×' + kv[1]).join(' · ') + '</span>');
+      if (a.lastSwitchReason) recent.push('<span class="muted">' + (RS[a.lastSwitchReason] || esc(a.lastSwitchReason)) + '×' + (a.switchStreak || 1) + '</span>');
       const health = a.lastHealth === 'alive' ? '<span style="color:#16a34a">✓</span>'
         : a.lastHealth === 'dead' ? '<span class="warn">✗</span>'
         : a.lastHealth === 'error' ? '<span class="muted">?</span>'
         : '<span class="muted">—</span>';
+      // （2026-11-03 faceBadge 面标注徽章随 explore/search 列一并移除，数据与 API 保留休眠）
       const meta = [];
       if (a.note) meta.push(esc(a.note));
       if (a.proxyHint) meta.push('出口 ' + esc(a.proxyHint));
       if (a.cookieCount) meta.push('cookies ' + a.cookieCount + ' 条');
+      if (a.errStreak > 0) meta.push('<span class="warn">连败×' + a.errStreak + '</span>');
       return '<tr>' +
         '<td class="muted">' + (idx + 1) + '</td>' +
         '<td><b>' + esc(a.username) + '</b>' +
@@ -765,7 +766,7 @@ async function load() {
         '<td><span class="badge ' + st[1] + '">' + st[0] + '</span></td>' +
         '<td>' + who + '</td>' +
         '<td>' + (recent.length ? recent.join('<br>') : '<span class="muted">—</span>') + '</td>' +
-        '<td title="最后使用: ' + fmt(a.lastUsedAt) + '\\n最后出活: ' + biz + '">' + rel(a.lastUsedAt) + '</td>' +
+        '<td title="最后使用: ' + fmt(a.lastUsedAt) + '">' + rel(a.lastUsedAt) + '</td>' +
         '<td>' + (a.useCount || 0) + '</td>' +
         '<td' + (expired ? ' class="warn"' : '') + ' title="sessionid 到期: ' + fmt(a.sessionExpiresAt) + '（cookie 承诺寿命，非实时有效性）">' + day(a.sessionExpiresAt) + (expired ? '（已过）' : '') + '</td>' +
         '<td title="上次检测: ' + fmt(a.lastHealthAt) + (a.lastHealth === 'dead' ? '\\n死号已标疑似，可重登录复活' : a.lastHealth === 'alive' ? '\\n登录态存活' : '') + '">' + health + ' <span class="muted">' + rel(a.lastHealthAt) + '</span></td>' +
@@ -792,9 +793,10 @@ async function load() {
       '<span class="chip">疑似 <b>' + nSus + '</b></span>' +
       '<span class="chip">已停用 <b>' + nRet + '</b></span>';
     document.getElementById('content').innerHTML =
-      '<table><tr><th>#</th><th>账号</th><th title="状态四态：使用中=租约在身 · 空闲=可被自动取号 · 疑似=检测判死暂不参与自动取号（可重登录复活）· 已停用=退出池">状态</th><th>使用者</th><th title="上次使用的程序：在租=当前取号的前一任（与使用者列对比看切换）；空闲=最近一任。附换号原因聚合（仅显式上报才计数）">上次使用</th><th>最近使用</th><th>次数</th><th title="sessionid cookie 的承诺寿命，非实时有效性">有效期</th><th title="登录态探测（✓/✗/?/—）；真实判据 = 业务出活">检测</th><th>操作</th><th>历史</th></tr>' + rows + '</table>' +
+      '<table><tr><th>#</th><th>账号</th><th title="状态四态：使用中=租约在身 · 空闲=可被自动取号 · 疑似=检测判死暂不参与自动取号（可重登录复活）· 已停用=退出池">状态</th><th>使用者</th><th title="上次使用的程序：在租=当前取号的前一任（与使用者列对比看切换）；空闲=最近一任。附最近换号原因×连续次数（仅显式上报才计数）">上次使用</th><th>最近使用</th><th>次数</th><th title="sessionid cookie 的承诺寿命，非实时有效性">有效期</th><th title="登录态探测（✓/✗/?/—）；真实判据 = 业务出活">检测</th><th>操作</th><th>历史</th></tr>' + rows + '</table>' +
       '<div style="padding: 10px 14px;"><p class="muted" style="margin:0">排序：使用中 → 空闲 → 疑似 → 已停用 · 每 15 秒自动刷新 · 有效期 = sessionid cookie 承诺寿命 · 检测 = 登录态探测（真实判据 = 业务出活）· cookies 明文不出服务端 · 「新增账号/重登录」一键拉起需本机装 tt-help 并执行过 <b>tt-help protocol register</b></p>' +
-      '<p class="muted" style="margin:6px 0 0">检测列图例：✓ 存活 · ✗ 已死（自动标疑似）· ? 探测异常（网络/超时，不代表号死）· — 未检测 · 时间 = 最近探测或续租</p></div>';
+      '<p class="muted" style="margin:6px 0 0">检测列图例：✓ 存活 · ✗ 已死（自动标疑似）· ? 探测异常（网络/超时，不代表号死）· — 未检测 · 时间 = 最近探测</p>' +
+      '<p class="muted" style="margin:6px 0 0">面标注图例：🚫 该面残缺禁用（派号跳过） · ✅ 验证通过 · — 未验证默认可用 · 角标「探」= 探针标注；「标挂/恢复」选面（explore/search），不影响状态与当前租约</p></div>';
   } catch (e) { msg('加载失败: ' + e.message, true); }
 }
 function copyCmd(cmd) {
@@ -1773,11 +1775,19 @@ export function startWatchServer(
             ret = updateAccount(body);
             console.error(`[登录池 ${ts}] UPDATE: ${ret.username} status=${ret.status}`);
           } else if (lpAction === "clear-history") {
-            // 清空日志（账号中心页面按钮）：history 清成一条留痕 + useCount/switchStats 清零
+            // 清空日志（账号中心页面按钮）：history 清成一条留痕 + useCount/换号原因清零
             ret = clearAccountHistory(body);
             console.error(`[登录池 ${ts}] CLEAR-LOGS: ${ret.username} (by ${body.by || "page"})`);
+          } else if (lpAction === "face") {
+            // 面标注（2026-11-02 faceBans）：explore/search 按面标挂/恢复，探针与人工同入口；
+            // leased 号也可标（不动租约，下次派发生效）
+            ret = setAccountFace(body);
+            const fb = ret.faceBans && ret.faceBans[body.face];
+            console.error(
+              `[登录池 ${ts}] FACE: ${ret.username} ${body.face}=${fb && fb.ban ? "禁用" : "恢复"} (${body.source || "manual"}${body.by ? " · " + body.by : ""})`,
+            );
           } else if (lpAction === "clear-history-all") {
-            // 一键清空全部账号日志（页面批量按钮）：各账号留痕一条 + useCount/switchStats 清零
+            // 一键清空全部账号日志（页面批量按钮）：各账号留痕一条 + useCount/换号原因清零
             const sum = clearAllAccountHistory(body);
             console.error(`[登录池 ${ts}] CLEAR-LOGS-ALL: ${sum.cleared} 个账号 (by ${body.by || "page"})`);
             sendJSON(res, 200, { ok: true, cleared: sum.cleared });
@@ -2503,6 +2513,8 @@ export function startWatchServer(
             body.errorStack || "",
             body.hostname || req.headers["x-client-hostname"] || "",
             body.clientId || req.headers["x-watchdog-client-id"] || "",
+            body.poolUsername || "",
+            body.proxyNode || "",
           );
           sendJSON(res, 200, { ok: true });
         } else {
@@ -3655,6 +3667,39 @@ export function startWatchServer(
         `[job] 无国家数据自动回炉已启动: 间隔 ${NO_COUNTRY_MOVE_INTERVAL_MS / 3600000} 小时`,
       );
 
+      // 错误任务自动恢复（B 方案：无次数上限全自动）：
+      // explore 失败任务 status='error' 躺平在 jobs 表，此前全靠页面「批量重新处理」人工重置。
+      // 定时扫龄期超阈的 error 行复用 resetJob 回流（与按钮同语义，含三表迁移/缓存失效/统计置脏）。
+      // 龄期防抖：避开错误风暴进行中 + 客户端可能仍在处理原任务（慢节点单用户可超 10 分钟）。
+      const ERROR_AUTO_RESET_INTERVAL_MS = 5 * 60 * 1000; // 扫描间隔
+      const ERROR_AUTO_RESET_AGE_MS = 10 * 60 * 1000; // error 龄期阈值（「恢复 10 分钟前的错误任务」）
+      const ERROR_AUTO_RESET_BATCH = 500; // 每轮上限，积压大时分轮消化
+      const autoResetStaleErrors = () => {
+        try {
+          const ids = store.listStaleErrorJobs(
+            ERROR_AUTO_RESET_AGE_MS,
+            ERROR_AUTO_RESET_BATCH,
+          );
+          if (ids.length === 0) return;
+          let reset = 0;
+          for (const uid of ids) {
+            const ret = store.resetJob(uid);
+            if (ret && ret.saved) reset++;
+          }
+          const ts = new Date().toLocaleTimeString("zh-CN", { hour12: false });
+          console.error(
+            `[JOB ${ts}] AUTO-RESET-ERROR: reset=${reset}/${ids.length}（龄期>${ERROR_AUTO_RESET_AGE_MS / 60000}min，无次数上限）`,
+          );
+        } catch (e) {
+          console.error(`[JOB] AUTO-RESET-ERROR 定时任务异常: ${e.message}`);
+        }
+      };
+      setInterval(autoResetStaleErrors, ERROR_AUTO_RESET_INTERVAL_MS);
+      setTimeout(autoResetStaleErrors, 60 * 1000); // 启动 1 分钟后先清一轮积压
+      console.error(
+        `[job] 错误任务自动恢复已启动: 间隔 ${ERROR_AUTO_RESET_INTERVAL_MS / 60000} 分钟, 龄期 ${ERROR_AUTO_RESET_AGE_MS / 60000} 分钟, 每轮上限 ${ERROR_AUTO_RESET_BATCH}（重启后 1 分钟首扫）`,
+      );
+
       _resolve({ server, port });
     });
 

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 {