tt-help-cli-ycl 1.4.181 → 1.4.182

package/src/cli/explore.js

@@ -49,6 +49,17 @@ const MAX_REBUILD_ATTEMPTS = 5; // 账户切换后导航恢复：连续重启浏
 const STARTUP_TIKTOK_URL = "https://www.tiktok.com/@ycl5007";
 const PAGE_GOTO_TIMEOUT = 60000; // 页面导航超时 60 秒（账户切换后需要更长时间）
 
+// 换号原因受控 code（2026-10-30 定稿：服务端 switchStats 按账号聚合展示；
+// 只用这组固定值上报，不传自由文本；startup 首次取号不带 reason）
+const SWITCH_REASON = {
+  BANNED: "banned", // 关注/粉丝功能被封、被封累计
+  RECOVER_FAIL: "recover_fail", // 浏览器重启/登录态恢复失败
+  SCHEDULED: "scheduled", // 48min 周期例行换号
+  INJECT_FAIL: "inject_fail", // 候选号注入验证失败后的再取号
+  CAPTCHA: "captcha", // 验证码累计超时未解决
+  NETWORK: "network", // CDN 限流累计（网络侧限流）
+};
+
 async function withRetry(label, fn) {
   let backoff = 1000;
   while (true) {
@@ -349,13 +360,15 @@ export async function handleExplore(options) {
      * 换号（以号为主键）：先取新号（旧号仍在手，无空窗）→ 注入验证 → 还旧号。
      * 候选最多试 5 个（注入失败的释放回池）；池空/服务器不可达 → 保旧号返回 false，
      * 由主循环「无在手账号」补取逻辑兑底。
+     * @param code 受控换号原因（SWITCH_REASON，上报服务端 switchStats；可选）；
+     *             首选按外层 call site 上报，候选注入失败后的再取号 = inject_fail
      */
-    async function switchPoolAccount(reason) {
+    async function switchPoolAccount(reason, code) {
       console.error(`\n[换号] ${reason}，从账号中心取新账号...`);
       for (let attempt = 0; attempt < 5; attempt++) {
         let next = null;
         try {
-          next = await poolClient.acquire();
+          next = await poolClient.acquire(attempt === 0 ? code : SWITCH_REASON.INJECT_FAIL);
         } catch (e) {
           console.error(
             `[换号] 取新号失败（${e.message}）${poolAccount ? `，保留当前账号 @${poolAccount.username}` : "，将在主循环补取"}`,
@@ -419,7 +432,10 @@ export async function handleExplore(options) {
         return true;
       }
       console.error(`[登录池] 登录态恢复失败（${r.reason}），转入换号流程`);
-      return await switchPoolAccount(`浏览器重启后无法恢复 @${poolAccount.username} 的登录态`);
+      return await switchPoolAccount(
+        `浏览器重启后无法恢复 @${poolAccount.username} 的登录态`,
+        SWITCH_REASON.RECOVER_FAIL,
+      );
     }
 
     /** 内存超限：同号重启浏览器（不换号——内存是浏览器进程问题，不是账号问题） */
@@ -434,14 +450,17 @@ export async function handleExplore(options) {
         Object.assign(page, rebuiltPage);
       } catch (e) {
         console.error(`[浏览器] 重启失败: ${e.message}，转入换号流程`);
-        return await switchPoolAccount(`浏览器重启失败（${e.message}）`);
+        return await switchPoolAccount(
+          `浏览器重启失败（${e.message}）`,
+          SWITCH_REASON.RECOVER_FAIL,
+        );
       }
       return await restorePoolLogin();
     }
 
-    async function handleAccountSwitch(reason) {
+    async function handleAccountSwitch(reason, code) {
       if (poolMode) {
-        await switchPoolAccount(reason);
+        await switchPoolAccount(reason, code);
         return;
       }
       console.error(`\n[健康检查] ${reason}，切换到下一个账户...`);
@@ -560,7 +579,7 @@ export async function handleExplore(options) {
             errorStack: result.errorStack || "",
           }),
         ),
-      switchAccount: (reason) => handleAccountSwitch(reason),
+      switchAccount: (reason) => handleAccountSwitch(reason, SWITCH_REASON.NETWORK),
     });
 
     /** 等待人工在浏览器中解决验证码：轮询检测，解决即继续；超时返回 false */
@@ -652,6 +671,7 @@ export async function handleExplore(options) {
           } else if (elapsedMs >= ROTATE_INTERVAL_MS) {
             await handleAccountSwitch(
               `当前账号已运行 ${Math.round(elapsedMs / 60000)} 分钟`,
+              SWITCH_REASON.SCHEDULED,
             );
           } else if (processedCount % 10 === 0) {
             const remainMin = Math.max(
@@ -713,6 +733,7 @@ export async function handleExplore(options) {
             if (captchaCount >= 3) {
               await handleAccountSwitch(
                 `验证码累计 ${captchaCount} 次（超时未解决）`,
+                SWITCH_REASON.CAPTCHA,
               );
               captchaCount = 0;
             }
@@ -729,7 +750,7 @@ export async function handleExplore(options) {
             console.error(
               `\n[封禁检测] 关注/粉丝功能已 ${minutes} 分钟未成功获取，切换到下一个账户...`,
             );
-            await handleAccountSwitch(`关注/粉丝功能被封`);
+            await handleAccountSwitch(`关注/粉丝功能被封`, SWITCH_REASON.BANNED);
           }
         }
 
@@ -914,7 +935,10 @@ export async function handleExplore(options) {
               // 触发代理切换（api-interceptor 已内置 30/40/50s 重试，到这里仍封直接切代理）
               await triggerProxySwitch(`账号被封 @${username}`, proxyPort);
               if (blockedCount >= 3) {
-                await handleAccountSwitch(`账号被封累计 ${blockedCount} 次`);
+                await handleAccountSwitch(
+                  `账号被封累计 ${blockedCount} 次`,
+                  SWITCH_REASON.BANNED,
+                );
                 blockedCount = 0;
               }
               continue;
@@ -952,6 +976,7 @@ export async function handleExplore(options) {
             // 累计3次验证码（均超时未解决），切换账户
             await handleAccountSwitch(
               `验证码累计 ${captchaCount} 次（超时未解决）`,
+              SWITCH_REASON.CAPTCHA,
             );
             captchaCount = 0;
           }

package/src/lib/login-pool-client.js

@@ -37,9 +37,14 @@ async function poolPost(url, body) {
 export function createLoginPoolClient({ serverUrl, userId, port, appName = "explore" }) {
   const base = `${String(serverUrl).replace(/\/+$/, "")}/api/login-pool`;
   return {
-    /** 取号：挑最久未用的空闲号，响应带明文 cookies。失败抛错（池空/服务器不可达） */
-    async acquire() {
-      const r = await poolPost(`${base}/acquire`, { userId, port, appName });
+    /** 取号：按服务端排序规则（2026-10-30：休息窗+同类/非同类）挑空闲号，响应带明文 cookies。
+     *  失败抛错（池空/服务器不可达）。
+     *  reason 可选：换号原因受控 code（banned/recover_fail/scheduled/inject_fail/captcha/network），
+     *  服务端按账号聚合 switchStats；不带则不计（仅显式上报才计数，旧客户端兼容） */
+    async acquire(reason) {
+      const body = { userId, port, appName };
+      if (reason) body.reason = String(reason);
+      const r = await poolPost(`${base}/acquire`, body);
       return r.account;
     },
     /** 还号：以号为主键，按 id 释放（谁持账号谁还） */

package/src/watch/login-pool.js

@@ -232,6 +232,9 @@ function publicView(acc) {
     lastHealth: acc.lastHealth || null,
     lastBusinessOkAt: acc.lastBusinessOkAt || null,
     lastUsedAt: acc.lastUsedAt || null,
+    lastAppName: acc.lastAppName || null,
+    prevAppName: acc.prevAppName || null,
+    switchStats: acc.switchStats || {},
     lease,
     history: acc.history || [],
     createdAt: acc.createdAt,
@@ -356,8 +359,17 @@ export function heartbeatLoginPool(userId, body) {
   }
 
   // 1) 续租该节点持有的所有租约 + 采集健康数据
+  //    续租匹配（2026-10-30 修复）：心跳 userId 是纯节点名（如 F-11），业务实例租约 userId
+  //    带实例后缀（F-11-8222-2 = {节点}-{端口}-{实例}）→ 精确相等 + "-" 边界前缀匹配都续。
+  //    边界防节点名互为前缀："F-1" 不得续 "F-11-*"（startsWith("F-1-") 为 false）。
+  //    ⚠️ 铁律：acquireAccount 里「自动释放同使用者旧租约」必须保持精确相等
+  //    （一实例一号不变量），与本处续租匹配是两套语义，不许跟着改成前缀。
   for (const acc of _accounts) {
-    if (acc.status === "leased" && acc.lease && acc.lease.userId === userId) {
+    if (
+      acc.status === "leased" &&
+      acc.lease &&
+      (acc.lease.userId === userId || acc.lease.userId.startsWith(userId + "-"))
+    ) {
       acc.lease.lastHealthAt = t;
       acc.lastHealthAt = t; // 镜像到账号本体，释放后仍可查
       acc.lastUsedAt = t;
@@ -467,6 +479,9 @@ export function updateAccount({ id, note, proxyHint, status } = {}) {
     if (!VALID_STATUS.includes(status)) throw new Error(`非法 status: ${status}`);
     if (acc.status === "leased" && status === "pool") {
       pushHistory(acc, "released", "手动释放");
+      // 手动释放也盖 lastUsedAt（2026-10-30 补洞）：持有节点掉线等场景下 lastUsedAt
+      // 停在取号时刻，不盖的话释放后立刻可被取走，绕过 30 分钟休息窗
+      acc.lastUsedAt = now();
       acc.lease = null;
       purgeCommandsFor(acc.id);
     } else if (acc.status === "leased" && status !== "pool") {
@@ -482,6 +497,38 @@ export function updateAccount({ id, note, proxyHint, status } = {}) {
   return publicView(acc);
 }
 
+/** 清空日志（账号中心页面按钮）：history 清成一条留痕 + useCount 归零 + switchStats 清空。
+ *  不动 lastUsedAt/lastAppName（30min 休息窗与非同类排序不受清日志影响）。 */
+export function clearAccountHistory({ id, by } = {}) {
+  ensureLoaded();
+  const acc = _accounts.find((a) => a.id === id);
+  if (!acc) throw new Error(`账号不存在: ${id}`);
+  acc.history = [];
+  acc.useCount = 0;
+  acc.switchStats = {};
+  acc.updatedAt = now();
+  pushHistory(acc, "clearLogs", `清除日志与计数（来源 ${String(by || "page").slice(0, 80)}）`);
+  scheduleSave();
+  return publicView(acc);
+}
+
+/** 一键清空全部账号日志（页面批量按钮）：与单账号同语义——各账号 history 清成一条
+ *  留痕 + useCount/switchStats 清零；不动 lastUsedAt/lastAppName。返回清空数量。 */
+export function clearAllAccountHistory({ by } = {}) {
+  ensureLoaded();
+  const t = now();
+  for (const acc of _accounts) {
+    acc.history = [];
+    acc.useCount = 0;
+    acc.switchStats = {};
+    acc.updatedAt = t;
+    pushHistory(acc, "clearLogs", `清除日志与计数（来源 ${String(by || "page").slice(0, 80)} · 批量）`);
+  }
+  const cleared = _accounts.length;
+  if (cleared > 0) scheduleSave();
+  return { cleared };
+}
+
 /** 删除（retired 才可删；其余先 retired） */
 export function deleteAccount(id) {
   ensureLoaded();
@@ -613,14 +660,16 @@ export function takeAccount({ userId, port, username, force } = {}) {
  * 在自有浏览器实例上原地注入，不经心跳命令队列、不依赖节点 watchdog。
  *
  * 语义（2026-10-26 用户定稿：以号为主键，无幂等/无端口键）:
- *   - 取号 = 挑最久未用的空闲号 → 标 leased → 响应带明文 cookies
+ *   - 取号 = 按 2026-10-30 定稿排序挑空闲号 → 标 leased → 响应带明文 cookies
  *   - 独占由池状态机保证（take 即 leased，同号不双机并行）；
  *     切换 = 先取新号、验证通过后再还旧号（无空窗，池空保旧）
  *   - 崩溃/异常未还号的租约由 TTL 兑底回收（或账号中心手动释放），不做幂等恢复
  *   - port 可选：仅作展示元数据（浏览器口），不参与任何键/约束
- *   - appName: 租约元数据仅记录展示（explore/search...），不参与分配
+ *   - appName: 记录在租约与账号本体（lastAppName，释放后保留），参与取号排序 K2 非同类优先
+ *   - reason: 可选换号原因受控 code（banned/recover_fail/scheduled/inject_fail/captcha/network），
+ *     仅显式上报才计入 switchStats 聚合（无「未上报」桶）；未知 code 原样存不拒绝（旧客户端兼容）
  */
-export function acquireAccount({ userId, port, appName } = {}) {
+export function acquireAccount({ userId, port, appName, reason } = {}) {
   ensureLoaded();
   reapExpiredLeases();
   if (!userId) throw new Error("userId 必填");
@@ -632,20 +681,38 @@ export function acquireAccount({ userId, port, appName } = {}) {
     }
   }
   const t = now();
-
-  // ⑥ 双键排序：先用次数少的优先（永不用过的最优先），同次数再按最近使用时间升序
+  const appNameKey = appName ? String(appName).slice(0, 50) : null;
+  // reason：换号原因受控 code；未知原样存不拒绝（旧客户端不带 → 不计）
+  const reasonKey = reason ? String(reason).slice(0, 50) : null;
+
+  // 取号排序（2026-10-30 定稿，替换旧「useCount 升序 + 10min 冷却」）：
+  //   eligible = 从未用过（lastUsedAt 空）或 now − lastUsedAt ≥ MIN_IDLE_MS（30 分钟休息窗）；
+  //   eligible 空集 → 全池同排序兑底（有得用总比没用好），池空才报错。
+  //   排序键（useCount 退出排序，仅留展示）:
+  //     K1 从未用过最前（lastUsedAt null = 无限冷）
+  //     K2 非同类优先（lastAppName ≠ 本次 appName；lastAppName 空按非同类；
+  //        请求无 appName 时该键中性化全等，不参与）
+  //     K3 lastUsedAt 升序（从未用过组内退化为 createdAt 升序，兼容旧排序）
+  const MIN_IDLE_MS = 30 * 60 * 1000;
   const pool = _accounts.filter((a) => a.status === "pool");
-  const sortFn =
-    (a, b) =>
-      (a.useCount || 0) - (b.useCount || 0) ||
-      (a.lastUsedAt || a.createdAt) - (b.lastUsedAt || b.createdAt);
-  // ⑥ 错峰冷却：刚归还的号（lastUsedAt 在冷却窗内）先排除，避免同号被连续调用；
-  //   全部在冷却时退化为全池排序（有得用总比没用好）。从未用过的号无 lastUsedAt，不受冷却影响
-  const COOLDOWN_MS = 10 * 60 * 1000;
-  const cooled = pool
-    .filter((a) => !a.lastUsedAt || a.lastUsedAt <= t - COOLDOWN_MS)
+  const sortFn = (a, b) => {
+    // K1: 从未用过最前
+    const aUsed = a.lastUsedAt != null ? 1 : 0;
+    const bUsed = b.lastUsedAt != null ? 1 : 0;
+    if (aUsed !== bUsed) return aUsed - bUsed;
+    // K2: 非同类优先（仅当本次请求带 appName）
+    if (appNameKey) {
+      const aSame = a.lastAppName && a.lastAppName === appNameKey ? 1 : 0;
+      const bSame = b.lastAppName && b.lastAppName === appNameKey ? 1 : 0;
+      if (aSame !== bSame) return aSame - bSame;
+    }
+    // K3: lastUsedAt 升序
+    return (a.lastUsedAt ?? a.createdAt ?? 0) - (b.lastUsedAt ?? b.createdAt ?? 0);
+  };
+  const eligible = pool
+    .filter((a) => !a.lastUsedAt || t - a.lastUsedAt >= MIN_IDLE_MS)
     .sort(sortFn);
-  const acc = cooled[0] || pool.slice().sort(sortFn)[0];
+  const acc = eligible[0] || pool.slice().sort(sortFn)[0];
   if (!acc) {
     const leased = _accounts.filter((a) => a.status === "leased").length;
     throw new Error(`池中暂无空闲账号（共 ${_accounts.length} 个，其中 ${leased} 个在租约中）`);
@@ -654,10 +721,21 @@ export function acquireAccount({ userId, port, appName } = {}) {
   acc.status = "leased";
   acc.useCount = (acc.useCount || 0) + 1;
   acc.lastUsedAt = t; // 最近使用时间（取号即「开始使用」）
+  if (appNameKey) {
+    // B1: 账号本体记录最近一次租用程序（K2 排序依据，释放后保留；请求不带 appName 不改写）
+    // prevAppName = 覆盖前的前一任（页面「上次使用」列展示，供在租账号看切换对比）
+    acc.prevAppName = acc.lastAppName || null;
+    acc.lastAppName = appNameKey;
+  }
+  if (reasonKey) {
+    // C2: 换号原因聚合（仅显式上报才计数，无「未上报」桶）
+    acc.switchStats = acc.switchStats || {};
+    acc.switchStats[reasonKey] = (acc.switchStats[reasonKey] || 0) + 1;
+  }
   acc.lease = {
     userId,
     port: portNum,
-    appName: appName ? String(appName).slice(0, 50) : null,
+    appName: appNameKey,
     assignedAt: t,
     expireAt: t + LEASE_TTL_MS,
     lastHealthAt: t,
@@ -665,7 +743,11 @@ export function acquireAccount({ userId, port, appName } = {}) {
     emptyStreak: null,
   };
   acc.updatedAt = t;
-  pushHistory(acc, "acquired", `${userId}${portNum ? ":" + portNum : ""} 直接取号`);
+  pushHistory(
+    acc,
+    "acquired",
+    `${userId}${portNum ? ":" + portNum : ""} 直接取号${appNameKey ? " · " + appNameKey : ""}${reasonKey ? " · 原因 " + reasonKey : ""}`,
+  );
 
   // ③ 一程序实例恒持一号：自动释放该使用者名下的其他旧租约
   //   （换号 = 取新+还旧一步完成；崩溃重启后的首次取号自愈清僵尸租约；

package/src/watch/server.js

@@ -22,6 +22,8 @@ import {
   importAccount,
   reloginAccount,
   prepareRelogin,
+  clearAccountHistory,
+  clearAllAccountHistory,
 } from "./login-pool.js";
 import { checkPoolAccounts } from "./login-health.js";
 
@@ -687,7 +689,15 @@ function serveLoginPoolPage(res) {
 <div class="bar">
   <button onclick="load()">刷新</button>
   <button onclick="addCmdDlg()" title="一键拉起本机 tt-help：弹出 Edge 登录 TikTok 后自动入池（本机需已安装 tt-help 并执行过 tt-help protocol register；未注册时自动回退为复制命令）">新增账号</button>
-  <button id="btn-check" class="primary" onclick="checkNow()" title="逐号 HTTP 探测登录态（空闲+疑似），死号自动标疑似">批量检测</button>
+  <div style="position:relative;display:inline-block;">
+    <button id="btn-check" class="primary" onclick="toggleCheckMenu()" title="逐号 HTTP 探测登录态，死号自动标疑似；范围限空闲+疑似（使用中的由业务自验兑底）">批量检测 ▾</button>
+    <div id="check-menu" style="display:none;position:absolute;top:100%;left:0;z-index:20;background:#fff;border:1px solid #e5e7eb;border-radius:8px;box-shadow:0 4px 12px rgba(0,0,0,.10);min-width:220px;overflow:hidden;">
+      <button style="display:block;width:100%;border:none;border-radius:0;text-align:left;padding:8px 12px;" onclick="checkNow('all')">所有（空闲+疑似）</button>
+      <button style="display:block;width:100%;border:none;border-radius:0;text-align:left;padding:8px 12px;border-top:1px solid #f0f1f3;" onclick="checkNow('abnormal')">有异常（✗死 / ?探测异常）</button>
+      <button style="display:block;width:100%;border:none;border-radius:0;text-align:left;padding:8px 12px;border-top:1px solid #f0f1f3;" onclick="checkNow('stale')">超 48h 未检测（含从未检测）</button>
+    </div>
+  </div>
+  <button onclick="clearAllHist()" title="一键清空全部账号的日志与计数：各留一条留痕，useCount/换号统计清零（不影响休息窗/最近程序）">清空全部日志</button>
   <span id="msg"></span>
   <span class="chips" id="stats"></span>
 </div>
@@ -697,6 +707,7 @@ const esc = s => String(s ?? '').replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt
 const fmt = t => t ? new Date(t).toLocaleString('zh-CN', {hour12:false}) : '—';
 const day = t => t ? new Date(t).toLocaleDateString('zh-CN') : '—';
 const ST = { leased: ['使用中','b-leased'], pool: ['空闲','b-pool'], suspect: ['疑似异常','b-suspect'], retired: ['已停用','b-retired'] };
+const RS = { banned: '被封', inject_fail: '注入失败', scheduled: '例行换号', captcha: '验证码', network: '网络', recover_fail: '恢复失败' };
 const ORDER = { leased: 0, pool: 1, suspect: 2, retired: 3 };
 const rel = t => {
   if (!t) return '—';
@@ -733,6 +744,12 @@ async function load() {
       const who = l
         ? esc(l.userId) + (l.port ? ':' + esc(l.port) : '') + (l.appName ? ' <span class="muted">· ' + esc(l.appName) + '</span>' : '')
         : '<span class="muted">—</span>';
+      // 上次使用列：在租=前一任程序（与使用者列对比看切换）；空闲=最近一任
+      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>');
       const health = a.lastHealth === 'alive' ? '<span style="color:#16a34a">✓</span>'
         : a.lastHealth === 'dead' ? '<span class="warn">✗</span>'
         : a.lastHealth === 'error' ? '<span class="muted">?</span>'
@@ -747,18 +764,18 @@ async function load() {
           (meta.length ? '<div class="muted">' + meta.join(' · ') + '</div>' : '') + '</td>' +
         '<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>' + (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>' +
         '<td>' +
-          (a.status === 'leased' ? '<button onclick="releaseDlg(\\'' + a.id + '\\',\\'' + esc(a.username) + '\\')">释放</button> ' : '') +
-          (a.status === 'pool' ? '<button onclick="assignDlg(\\'' + a.id + '\\',\\'' + esc(a.username) + '\\')" title="手动指派给节点端口（watchdog 注入流）">指派</button> ' : '') +
+          <!-- 释放/指派按钮已隐藏（2026-10-29：自动流转全覆盖、指派为 Phase-1 遗物零使用）；API 与 releaseDlg/assignDlg 函数保留，随时可恢复 -->
           (a.status === 'suspect' ? '<button onclick="enable(\\'' + a.id + '\\',\\'' + esc(a.username) + '\\',true)">启用</button> ' : '') +
           (a.status === 'retired' ? '<button onclick="enable(\\'' + a.id + '\\',\\'' + esc(a.username) + '\\',false)">启用</button> ' : '') +
           (a.status !== 'retired' ? '<button onclick="disable(\\'' + a.id + '\\',\\'' + esc(a.username) + '\\',' + (a.status === 'leased') + ')">停用</button> ' : '') +
           (a.status === 'retired' ? '<button onclick="del(\\'' + a.id + '\\')">删除</button> ' : '') +
-          '<button onclick="reloginDlg(\\'' + esc(a.username) + '\\')" title="一键拉起本机 tt-help 检测：窗口打开账号当前登录态，可退出重登或保持，回终端按回车提交更新池内 cookies">检测</button>' +
+          '<button onclick="reloginDlg(\\'' + esc(a.username) + '\\')" title="一键拉起本机 tt-help 重登录：窗口打开账号当前登录态，可退出重登或保持，回终端按回车提交更新池内 cookies">重登录</button>' +
         '</td>' +
         '<td><details data-acc="' + esc(a.id) + '" ' + (openHist.has(a.id) ? 'open' : '') + ' ontoggle="onHistToggle(this)"><summary class="muted">' + (a.history ? a.history.length : 0) + ' 条</summary>' +
           (a.history || []).slice(0, 8).map(h => '<div class="muted">' + fmt(h.at) + ' ' + esc(h.event) + ' ' + esc(h.detail) + '</div>').join('') + '</details></td>' +
@@ -775,8 +792,9 @@ 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>状态</th><th>使用者</th><th>最近使用</th><th>次数</th><th>有效期</th><th>检测</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></div>';
+      '<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>';
   } catch (e) { msg('加载失败: ' + e.message, true); }
 }
 function copyCmd(cmd) {
@@ -817,15 +835,28 @@ function setProgress(t) {
   el.style.color = '#2563eb';
 }
 let checking = false;
-async function checkNow() {
+// 批量检测三选范围（2026-10-30）：均仍限 pool+suspect（leased 不探，业务自验兑底）
+const CHECK_SCOPES = {
+  all: { label: '所有（空闲+疑似）', pick: () => true },
+  abnormal: { label: '有异常（✗死 / ?探测异常）', pick: a => a.lastHealth === 'dead' || a.lastHealth === 'error' },
+  stale: { label: '超 48h 未检测（含从未检测）', pick: a => !a.lastHealthAt || a.lastHealthAt < Date.now() - 48 * 3600 * 1000 },
+};
+function toggleCheckMenu() {
+  const m = document.getElementById('check-menu');
+  m.style.display = m.style.display === 'none' ? 'block' : 'none';
+}
+async function checkNow(scope) {
+  const sc = CHECK_SCOPES[scope] || CHECK_SCOPES.all;
+  const menu = document.getElementById('check-menu');
+  if (menu) menu.style.display = 'none';
   if (checking) return;
   let targets;
   try {
     const j = await api('/api/login-pool');
-    targets = j.accounts.filter(a => a.status === 'pool' || a.status === 'suspect');
+    targets = j.accounts.filter(a => (a.status === 'pool' || a.status === 'suspect') && sc.pick(a));
   } catch (e) { msg('加载失败: ' + e.message, true); return; }
-  if (!targets.length) { msg('没有待检测账号（空闲+疑似为空，使用中的由业务自验）'); return; }
-  if (!confirm('批量检测 ' + targets.length + ' 个账号的登录态？（死号自动标疑似）')) return;
+  if (!targets.length) { msg('所选范围（' + sc.label + '）没有待检测账号（限空闲+疑似，使用中的由业务自验）'); return; }
+  if (!confirm('批量检测 ' + sc.label + '：共 ' + targets.length + ' 个账号？（死号自动标疑似）')) return;
   checking = true;
   const btn = document.getElementById('btn-check');
   btn.disabled = true; btn.textContent = '检测中…';
@@ -848,9 +879,16 @@ async function checkNow() {
     msg('巡检完成: 探测 ' + done + '，活 ' + alive + ' / 死 ' + dead + ' / 异常 ' + err + (mig ? '，死号标疑似 ' + mig + ' 个' : ''));
   } finally {
     checking = false;
-    btn.disabled = false; btn.textContent = '批量检测';
+    btn.disabled = false; btn.textContent = '批量检测 ▾';
   }
 }
+async function clearAllHist() {
+  if (!confirm('清空所有账号的日志与计数？各账号留一条留痕，useCount/换号统计清零（不影响休息窗/最近程序）')) return;
+  try {
+    const r = await api('/api/login-pool/clear-history-all', { by: 'page' });
+    msg('已清空 ' + (r.cleared || 0) + ' 个账号的日志'); load();
+  } catch (e) { msg('清空失败: ' + e.message, true); }
+}
 async function assignDlg(id, name) {
   const userId = prompt('指派给节点 userId（如 F-11）:'); if (!userId) return;
   const port = prompt('端口:'); if (!port) return;
@@ -1692,7 +1730,7 @@ export function startWatchServer(
             // Phase 2 直取（以号为主键）：响应含明文 cookies（业务进程自注入，不经心跳命令队列）
             ret = acquireAccount(body);
             console.error(
-              `[登录池 ${ts}] ACQUIRE: ${ret.username} → ${body.userId}${body.port ? ":" + body.port : ""} (${ret.cookieCount} 条 cookies)`,
+              `[登录池 ${ts}] ACQUIRE: ${ret.username} → ${body.userId}${body.port ? ":" + body.port : ""} (${ret.cookieCount} 条 cookies)${body.reason ? " 原因=" + body.reason : ""}`,
             );
           } else if (lpAction === "import") {
             // 节点登录态导入（以号为主键，导入=入池登记为空闲，不自动租）：按 username 去重
@@ -1734,6 +1772,16 @@ export function startWatchServer(
           } else if (lpAction === "update") {
             ret = updateAccount(body);
             console.error(`[登录池 ${ts}] UPDATE: ${ret.username} status=${ret.status}`);
+          } else if (lpAction === "clear-history") {
+            // 清空日志（账号中心页面按钮）：history 清成一条留痕 + useCount/switchStats 清零
+            ret = clearAccountHistory(body);
+            console.error(`[登录池 ${ts}] CLEAR-LOGS: ${ret.username} (by ${body.by || "page"})`);
+          } else if (lpAction === "clear-history-all") {
+            // 一键清空全部账号日志（页面批量按钮）：各账号留痕一条 + useCount/switchStats 清零
+            const sum = clearAllAccountHistory(body);
+            console.error(`[登录池 ${ts}] CLEAR-LOGS-ALL: ${sum.cleared} 个账号 (by ${body.by || "page"})`);
+            sendJSON(res, 200, { ok: true, cleared: sum.cleared });
+            return;
           } else if (lpAction === "delete") {
             ret = deleteAccount(body.id);
             console.error(`[登录池 ${ts}] DELETE: ${ret.username}`);