tt-help-cli-ycl 1.4.177 → 1.4.178

package/package.json

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

package/scripts/test-login-pool-ui.mjs

@@ -150,14 +150,23 @@ await page.waitForFunction(() => document.querySelector("#content table"), { tim
 const headers = await page.textContent("#content table tr:first-child");
 check(
   "独立页新列齐全",
-  ["账号", "状态", "使用者", "最近使用", "次数", "有效期", "操作", "历史"].every((h) => headers.includes(h)),
+  ["账号", "状态", "使用者", "最近使用", "次数", "有效期", "检测", "操作", "历史"].every((h) => headers.includes(h)),
 );
 const row1 = await page.textContent("#content table tr:nth-child(2)");
 check("状态徽章=使用中", row1.includes("使用中"));
 check("使用者=机器:口", row1.includes("F-11:9222"));
 const poolSrc = await page.content();
 check("独立页无 cookie 明文", !poolSrc.includes("SECRET-SID-XYZ"));
-check("独立页含重登录置灰按钮", await page.$$eval("#content button[disabled]", (bs) => bs.some((b) => b.textContent.includes("重登录"))));
+check("独立页重登录按钮已点亮（不再是置灰占位）", await page.$$eval("#content button:not([disabled])", (bs) => bs.some((b) => b.textContent.includes("重登录"))));
+check("独立页含新增账号/批量检测按钮", await page.$$eval(".bar button", (bs) => {
+  const t = bs.map((b) => b.textContent).join();
+  return t.includes("新增账号") && t.includes("批量检测");
+}));
+const barSrc = await page.content();
+check("页面含命令化文案（协议桥后置，先复制命令）", barSrc.includes("tt-help login-pool"));
+check("模拟取号/入池粘cookies按钮已移除", !barSrc.includes("模拟取号") && !barSrc.includes("入池(粘cookies)"));
+check("自动刷新无条件化（无勾选框）", !barSrc.includes('id="auto"'));
+check("统计 chips 存在", await page.$$eval("#stats .chip", (cs) => cs.length >= 5));
 
 // 有效期归一显示：应为 ~90 天后的日期（而非 1970）
 const day90 = new Date(Date.now() + 90 * 86400000).toLocaleDateString("zh-CN");

package/scripts/test-login-pool.mjs

@@ -32,7 +32,13 @@ const {
   importAccount,
   heartbeatLoginPool,
   reapExpiredLeases,
+  reloginAccount,
+  prepareRelogin,
+  healthTargets,
+  recordHealth,
+  _accountsInternal,
 } = await import("../src/watch/login-pool.js");
+const { checkPoolAccounts } = await import("../src/watch/login-health.js");
 
 let pass = 0;
 let fail = 0;
@@ -377,5 +383,108 @@ console.log("\n[8] 登录态导入 import");
   check("缺 cookies 确实抛错", threw);
 }
 
+console.log("\n[9] 重登录 relogin（覆盖刷新 + 守卫）");
+{
+  for (const a of getLoginPoolView().accounts) {
+    try { releaseAccount({ id: a.id }); } catch {}
+    try { updateAccount({ id: a.id, status: "retired" }); } catch {}
+    try { deleteAccount(a.id); } catch {}
+  }
+  const D1 = [
+    { name: "sessionid", value: "sid-d-old", domain: ".tiktok.com", expires: Math.floor(Date.now() / 1000) + 86400 },
+    { name: "unique_id", value: "userD", domain: ".tiktok.com" },
+  ];
+  importAccount({ userId: "F-9", username: "userD", cookies: D1 });
+  const D2 = [
+    { name: "sessionid", value: "sid-d-new", domain: ".tiktok.com", expires: Math.floor(Date.now() / 1000) + 86400 * 2 },
+    { name: "unique_id", value: "userD", domain: ".tiktok.com" },
+    { name: "poc_marker", value: "x", domain: ".tiktok.com" },
+  ];
+
+  let r = reloginAccount({ username: "userD", cookies: D2, userId: "cli", note: "单测" });
+  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");
+
+  let threw = false;
+  try { reloginAccount({ username: "ghost", cookies: D2, userId: "cli" }); } catch (e) { threw = /不在池中/.test(e.message); }
+  check("不在池拒绝", threw);
+  threw = false;
+  try { reloginAccount({ username: "userD", cookies: D2 }); } catch (e) { threw = /userId/.test(e.message); }
+  check("缺 userId 拒绝", threw);
+  threw = false;
+  try { reloginAccount({ username: "userD", userId: "cli" }); } catch (e) { threw = /cookies/.test(e.message); }
+  check("缺 cookies 拒绝", threw);
+
+  acquireAccount({ userId: "T1", port: 9400 });
+  threw = false;
+  try { reloginAccount({ username: "userD", cookies: D2, userId: "cli" }); } catch (e) { threw = /使用中/.test(e.message); }
+  check("使用中拒绝重登录", threw);
+  releaseAccount({ id: getLoginPoolView().accounts.find((a) => a.username === "userD").id });
+
+  updateAccount({ id: getLoginPoolView().accounts.find((a) => a.username === "userD").id, status: "suspect" });
+  r = reloginAccount({ username: "userD", cookies: D2, userId: "cli" });
+  check("suspect → 刷新后回 pool", r.wasSuspect === true && r.account.status === "pool");
+
+  updateAccount({ id: getLoginPoolView().accounts.find((a) => a.username === "userD").id, status: "retired" });
+  r = reloginAccount({ username: "userD", cookies: D2, userId: "cli" });
+  check("retired → 重登录复活", r.revived === true && r.account.status === "pool");
+}
+
+console.log("\n[10] 巡检 healthTargets/recordHealth/checkPoolAccounts（注入假探测）");
+{
+  for (const a of getLoginPoolView().accounts) {
+    try { releaseAccount({ id: a.id }); } catch {}
+    try { updateAccount({ id: a.id, status: "retired" }); } catch {}
+    try { deleteAccount(a.id); } catch {}
+  }
+  const mk = (sid) => [
+    { name: "sessionid", value: sid, domain: ".tiktok.com", expires: Math.floor(Date.now() / 1000) + 86400 },
+    { name: "unique_id", value: "u-" + sid, domain: ".tiktok.com" },
+  ];
+  importAccount({ userId: "F-9", username: "u-alive", cookies: mk("alive-1") });
+  importAccount({ userId: "F-9", username: "u-dead", cookies: mk("dead-1") });
+  const retired = importAccount({ userId: "F-9", username: "u-retired", cookies: mk("ret-1") });
+  updateAccount({ id: retired.account.id, status: "retired" });
+
+  const targets = healthTargets();
+  check("巡检目标默认含 pool/suspect 排除 retired", targets.length === 2 && targets.every((t) => t.username !== "u-retired"));
+  check("巡检目标带 cookies/proxyHint", targets.every((t) => Array.isArray(t.cookies) && t.cookies.length > 0));
+
+  // 假探测：u-alive 判活，u-dead 判死（带标记 cookie 验证探测拿到的是池内 cookies）
+  const fakeProbe = async (cookies) => {
+    const isAlive = JSON.stringify(cookies).includes("alive-1");
+    check(isAlive ? "探测[活]拿到的是池内 cookies" : "探测[死]拿到的是池内 cookies", Array.isArray(cookies));
+    return isAlive
+      ? { alive: true, username: "u-alive", expired: false, httpStatus: 200, error: null, ms: 5 }
+      : { alive: false, username: null, expired: true, httpStatus: 200, error: null, ms: 5 };
+  };
+  const sum = await checkPoolAccounts({ probeFn: fakeProbe, pacingMs: 0 });
+  check("巡检计数 alive/dead", sum.checked === 2 && sum.alive === 1 && sum.dead === 1);
+  check("死号自动 pool→suspect", sum.migrated === 1 && sum.results.find((x) => x.username === "u-dead").migrated === true);
+
+  const deadAcc = getLoginPoolView().accounts.find((a) => a.username === "u-dead");
+  check("死号 lastHealth=dead + 时间戳", deadAcc.lastHealth === "dead" && deadAcc.lastHealthAt > 0);
+  check("死号历史含 health 事件", (deadAcc.history || []).some((h) => h.event === "health"));
+  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 者）
+  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);
+
+  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);
+  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);
+}
+
 console.log(`\n═══ 结果: ${pass} 通过, ${fail} 失败 ═══`);
 process.exit(fail > 0 ? 1 : 0);

package/src/cli/login-pool.js

@@ -0,0 +1,207 @@
+/**
+ * handleLoginPool — 账号中心一条命令：新登录收号 / 重登录 / 巡检触发
+ *
+ * 用法:
+ *   tt-help login-pool add     [--server URL] [--proxy URL|--no-proxy] [--note S] [--dir D] [--timeout S]
+ *   tt-help login-pool relogin <username> [--server URL] [--proxy URL|--no-proxy] [--dir D] [--timeout S]
+ *   tt-help login-pool check   [--server URL] [--proxy URL] [--ids id1,id2] [--json]
+ *
+ * add:      起独立 Edge（临时目录+代理）→ 人工在窗口里登录 TikTok → 轮询 passport 检出
+ *           → 导出 cookies → POST /api/login-pool/import（幂等，同号跳过）
+ * relogin:  POST /prepare 取池内旧 cookies → 注入本机 Edge 试复活（快路径零操作）
+ *           → 会话已死则提示人工在窗口登录目标账号 → 身份校验 → POST /relogin 覆盖刷新
+ * check:    服务端无浏览器 HTTP 探测各号登录态（默认空闲+疑似），死号自动标疑似
+ *
+ * 协议桥（页面一键拉起本命令）为独立后续项，本命令即其执行端。
+ */
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { chromium } from "playwright";
+import { gotoTiktok, whoAmI } from "../lib/login-pool-client.js";
+import { proxy as configuredProxy } from "../lib/constants.js";
+
+const POLL_INTERVAL_MS = 3000;
+const CDP_FALLBACK_NOTE = "（关掉窗口或 Ctrl+C 可中止）";
+
+function log(t) {
+  console.error(`[登录池] ${t}`);
+}
+
+/** HTTP POST，默认 30s 超时（check 场景调用方自带更长超时） */
+async function post(base, path, body, timeoutMs = 30 * 1000) {
+  const res = await fetch(`${String(base).replace(/\/+$/, "")}/api/login-pool/${path}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body || {}),
+    signal: AbortSignal.timeout(timeoutMs),
+  });
+  const j = await res.json().catch(() => null);
+  if (!res.ok || !j || j.error) throw new Error((j && j.error) || `HTTP ${res.status}`);
+  return j;
+}
+
+/** 起独立 Edge 会话（launchPersistentContext: 跨平台自动找 Edge；临时目录随用随清） */
+async function openEdgeSession({ proxy, dir } = {}) {
+  const userDataDir = dir || mkdtempSync(join(tmpdir(), "tt-login-pool-"));
+  const context = await chromium.launchPersistentContext(userDataDir, {
+    channel: "msedge",
+    headless: false,
+    ...(proxy ? { proxy: { server: proxy } } : {}),
+    viewport: { width: 1280, height: 900 },
+    args: ["--no-first-run", "--no-default-browser-check", "--disable-sync"],
+  });
+  const page = context.pages()[0] || (await context.newPage());
+  return {
+    context,
+    page,
+    userDataDir,
+    cleanup: async () => {
+      await context.close().catch(() => {}); // persistent context close = 关浏览器
+      if (!dir) rmSync(userDataDir, { recursive: true, force: true });
+    },
+  };
+}
+
+/** 轮询等登录：注入 preCookies（重登录快路径）后循环 passport 检测 */
+async function waitForLogin({ page, preCookies, toPlaywrightCookies, timeoutMs }) {
+  const t0 = Date.now();
+  if (preCookies) {
+    await page.context().addCookies(preCookies);
+  }
+  await gotoTiktok(page);
+  for (;;) {
+    const id = await whoAmI(page);
+    if (id.hasAccount) return id;
+    if (Date.now() - t0 > timeoutMs) {
+      throw new Error(`等待登录超时（${Math.round(timeoutMs / 1000)}s）${CDP_FALLBACK_NOTE}`);
+    }
+    await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+  }
+}
+
+/** add 子命令 */
+async function cmdAdd(opts) {
+  const { serverUrl, proxy, note, timeoutMs, dir } = opts;
+  log("启动 Edge，请在打开的窗口里登录 TikTok（等待中，随时可关窗口中止）…");
+  const session = await openEdgeSession({ proxy, dir });
+  try {
+    const id = await waitForLogin({ page: session.page, timeoutMs });
+    log(`检测到登录: @${id.username}，导出 cookies 并入池…`);
+    const cookies = await session.context.cookies();
+    const r = await post(serverUrl, "import", {
+      userId: "cli-login-pool",
+      username: id.username,
+      cookies,
+      note: note || "命令行新登录收号",
+    });
+    if (r.dedup) {
+      log(`✓ @${id.username} 已在池，幂等跳过（不覆盖）`);
+    } else {
+      log(`✓ @${id.username} 新入池（空闲），共 ${r.account.cookieCount} 条 cookies`);
+    }
+    log(`完成。服务端: ${serverUrl}`);
+  } finally {
+    await session.cleanup();
+  }
+}
+
+/** relogin 子命令 */
+async function cmdRelogin(opts) {
+  const { serverUrl, proxy, username, timeoutMs, dir } = opts;
+  if (!username) throw new Error("用法: tt-help login-pool relogin <username>");
+  const prep = await post(serverUrl, "prepare", { username });
+  const oldCookies = prep.account.cookies;
+  log(`目标 @${username}（池内 ${oldCookies.length} 条 cookies）。启动 Edge，先试旧登录态复活…`);
+  const toPlaywrightCookies = (cookies) =>
+    (cookies || []).map((c) => ({
+      name: c.name,
+      value: c.value,
+      domain: c.domain || ".tiktok.com",
+      path: c.path || "/",
+      secure: c.secure !== false,
+      httpOnly: c.httpOnly !== false,
+      ...(typeof c.expires === "number" && c.expires > 0 ? { expires: c.expires } : {}),
+    }));
+  const session = await openEdgeSession({ proxy, dir });
+  try {
+    let id = await waitForLogin({ page: session.page, preCookies: toPlaywrightCookies(oldCookies), timeoutMs: 20000 });
+    if (id.hasAccount && id.username === username) {
+      log("✓ 旧登录态仍存活（快路径，零操作）");
+    } else {
+      // 死号分支：清掉死 cookies，提示人工在窗口登录目标账号
+      log(`旧登录态已失效（${id.expired ? "会话过期" : "未登录"}）。请在窗口里登录 @${username}…`);
+      await session.context.clearCookies();
+      await gotoTiktok(session.page);
+      id = await waitForLogin({ page: session.page, timeoutMs });
+    }
+    if (id.username !== username) {
+      throw new Error(`身份不符：窗口登录的是 @${id.username}，目标是 @${username}，已中止（不更新池）`);
+    }
+    const cookies = await session.context.cookies();
+    const r = await post(serverUrl, "relogin", { username, cookies, userId: "cli-login-pool", note: "命令行重登录" });
+    log(
+      `✓ @${username} 重登录完成: cookies 已覆盖刷新（${r.account.cookieCount} 条）${r.revived ? "，已停用账号复活回池" : r.wasSuspect ? "，疑似已清回池" : ""}`,
+    );
+  } finally {
+    await session.cleanup();
+  }
+}
+
+/** check 子命令：触发服务端巡检（探测在服务端做，cookies 不出服务端） */
+async function cmdCheck(opts) {
+  const { serverUrl, proxy, ids, json } = opts;
+  log(`触发服务端巡检${proxy ? `（出口 ${proxy}）` : ""}…`);
+  const r = await post(serverUrl, "check", { ids: ids || undefined, proxy: proxy || undefined }, 15 * 60 * 1000);
+  if (json) {
+    console.log(JSON.stringify(r, null, 2));
+    return;
+  }
+  log(`巡检完成: 探测 ${r.checked}，活 ${r.alive} / 死 ${r.dead} / 异常 ${r.error}${r.migrated ? `，死号标疑似 ${r.migrated} 个` : ""}`);
+  for (const x of r.results || []) {
+    if (x.health !== "alive") {
+      log(`  ${x.health === "dead" ? "✗" : "?"} @${x.username} → ${x.status}${x.migrated ? "（pool→suspect）" : ""}`);
+    }
+  }
+}
+
+/**
+ * @param {object} parsed parseLoginPoolArgs 结果
+ *   { action, username, serverUrl, proxy(null=用配置默认), noProxy, note, dir, timeoutSec, ids, showHelp, json }
+ */
+export async function handleLoginPool(parsed) {
+  const {
+    action,
+    username,
+    serverUrl,
+    proxy: proxyArg,
+    noProxy,
+    note,
+    dir,
+    timeoutSec = 300,
+    ids,
+    json,
+    showHelp,
+  } = parsed;
+  if (showHelp || !action) {
+    console.error(
+      [
+        "用法:",
+        "  tt-help login-pool add     [--server URL] [--proxy URL|--no-proxy] [--note S] [--dir D] [--timeout S]",
+        "  tt-help login-pool relogin <username> [--server URL] [--proxy URL|--no-proxy] [--dir D] [--timeout S]",
+        "  tt-help login-pool check   [--server URL] [--proxy URL] [--ids id1,id2] [--json]",
+        "",
+        "  add     新登录收号：弹出 Edge 人工登录 TikTok，检出后自动入池（幂等）",
+        "  relogin 重登录：先试旧登录态复活（零操作），死了引导人工登录，身份校验后覆盖刷新",
+        "  check   巡检：服务端 HTTP 探测各号登录态，死号自动标疑似",
+      ].join("\n"),
+    );
+    return;
+  }
+  const proxy = noProxy ? null : proxyArg || configuredProxy || null;
+  const opts = { serverUrl, proxy, note, dir, timeoutMs: timeoutSec * 1000, ids, json };
+  if (action === "add") return cmdAdd(opts);
+  if (action === "relogin") return cmdRelogin({ ...opts, username: username || parsed.username });
+  if (action === "check") return cmdCheck(opts);
+  throw new Error(`未知子命令: ${action}（支持 add / relogin / check）`);
+}

package/src/lib/args.js

@@ -1167,6 +1167,71 @@ function parseLoginCheckArgs(args) {
   };
 }
 
+function parseLoginPoolArgs(args) {
+  let action = null;
+  let username = null;
+  let serverUrl = defaultServer;
+  let proxy = null;
+  let noProxy = false;
+  let note = null;
+  let dir = null;
+  let timeoutSec = 300;
+  let ids = null;
+  let json = false;
+  let showHelp = false;
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--server" && i + 1 < args.length) {
+      serverUrl = args[++i];
+    } else if (arg === "--proxy" && i + 1 < args.length) {
+      proxy = args[++i];
+    } else if (arg === "--no-proxy") {
+      noProxy = true;
+    } else if (arg === "--note" && i + 1 < args.length) {
+      note = args[++i];
+    } else if (arg === "--dir" && i + 1 < args.length) {
+      dir = args[++i];
+    } else if (arg === "--timeout" && i + 1 < args.length) {
+      timeoutSec = parseInt(args[++i], 10) || 300;
+    } else if (arg === "--ids" && i + 1 < args.length) {
+      ids = args[++i].split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (arg === "--json") {
+      json = true;
+    } else if (arg === "-h" || arg === "--help") {
+      showHelp = true;
+    } else if (!arg.startsWith("-")) {
+      if (!action) action = arg;
+      else if (!username) username = arg;
+    }
+  }
+
+  return {
+    subcommand: "login-pool",
+    action,
+    username,
+    serverUrl,
+    proxy,
+    noProxy,
+    note,
+    dir,
+    timeoutSec,
+    ids,
+    json,
+    showHelp,
+    urls: [],
+    outputFormat: "json",
+    exploreCount: 0,
+    showConfig: false,
+    showVersion: false,
+    customProxy: null,
+    configAction: null,
+    configValue: null,
+    pipeMode: false,
+    filterStr: null,
+  };
+}
+
 function parseOpenArgs(args) {
   let openPort = null;
   let openList = false;
@@ -1721,6 +1786,10 @@ export function parseArgs() {
     return parseLoginCheckArgs(args.slice(1));
   }
 
+  if (args.length > 0 && args[0] === "login-pool") {
+    return parseLoginPoolArgs(args.slice(1));
+  }
+
   if (args.length > 0 && args[0] === "comments") {
     return parseCommentsArgs(args.slice(1));
   }

package/src/lib/constants.js

@@ -291,10 +291,21 @@ const HELP_TEXT = [
   "    示例: tt-help login-check 9222,9223,9224 --proxy http://127.0.0.1:7897",
   "          tt-help login-check --json",
   "",
-  "  videostats  <db路径> -p <并发数>",
-  "    批量刷新视频统计数据（playCount, diggCount, commentCount, shareCount, collectCount）",
-  "    直接读取并更新 SQLite videos 表",
-  "    -p, --parallel <N>       并发数（默认: 3）",
+  "  tt-help login-pool <add|relogin|check> [选项]",
+  "    账号中心：新登录收号 / 重登录 / 巡检（与网页 /login-pool 同一套账号库）",
+  "    add     弹出独立 Edge，人工登录 TikTok 后自动导出登录态入池（幂等）",
+  "    relogin <username>  先试旧登录态复活（零操作），失效则引导人工登录，覆盖刷新池内 cookies",
+  "    选项:",
+  "      --server <URL>            账号中心地址（watch 服务端）",
+  "      --proxy <地址>            Edge/探测代理，默认配置文件 proxy；--no-proxy 直连",
+  "      --note <备注>             add 备注信息",
+  "      --dir <路径>              自定义 Edge 用户目录（默认临时目录用后即清）",
+  "      --timeout <秒>            等待人工登录上限，默认 300",
+  "      --ids <id1,id2>           check 只探测指定账号",
+  "      --json                    check 输出 JSON",
+  "    示例: tt-help login-pool add --server http://172.18.154.201:3011",
+  "          tt-help login-pool relogin user8868337530661 --server http://172.18.154.201:3011",
+  "          tt-help login-pool check --server http://172.18.154.201:3011 --proxy http://127.0.0.1:7897",
   "    示例: tt-help videostats data/result.db -p 3",
   "",
   "  db-import  --db <db路径> [--users users.json] [--done done.json] [--videos videos.json]",

package/src/main.js

@@ -27,6 +27,7 @@ import { handleSearch } from "./cli/search.js";
 import { handleWatchdog } from "./cli/watchdog.js";
 import { handleClashDaemon } from "./cli/clash-daemon.js";
 import { handleLoginCheck } from "./cli/login-check.js";
+import { handleLoginPool } from "./cli/login-pool.js";
 
 async function main() {
   const parsed = parseArgs();
@@ -80,6 +81,8 @@ async function main() {
       return handleClashDaemon(parsed);
     case "login-check":
       return handleLoginCheck(parsed);
+    case "login-pool":
+      return handleLoginPool(parsed);
   }
 
   const {

package/src/npm-main.js

@@ -23,6 +23,7 @@ import { handleRawSync } from "./cli/raw-sync.js";
 import { handleSearch } from "./cli/search.js";
 import { handleWatchdog } from "./cli/watchdog.js";
 import { handleLoginCheck } from "./cli/login-check.js";
+import { handleLoginPool } from "./cli/login-pool.js";
 
 function exitUnsupportedCommand(command) {
   console.error(
@@ -79,6 +80,8 @@ async function main() {
       return handleWatchdog(parsed);
     case "login-check":
       return handleLoginCheck(parsed);
+    case "login-pool":
+      return handleLoginPool(parsed);
   }
 
   const {

package/src/watch/login-health.js

@@ -0,0 +1,108 @@
+/**
+ * 登录态批量巡检（账号中心）— 服务端无浏览器纯 HTTP 探测
+ *
+ * 原理（POC 实证 2026-10-28，见知识库 worklog）：
+ *   undici + Cookie 头 + 真实 UA + 代理出口，直探 passport/web/account/info/。
+ *   浏览器里必须页面上下文 fetch（CORS），服务端无此限制。阳性对照（真实 cookies）
+ *   判活 / 阴性对照（垃圾 sessionid）判死均已验证，单次 ~700ms。
+ *
+ * 判据边界：探测只回答「登录态还活着吗」，不回答「号还能不能干活」——
+ *   风控限流/影子封禁只有真实业务出活能暴露。
+ */
+import { request, ProxyAgent } from "undici";
+import { healthTargets, recordHealth } from "./login-pool.js";
+
+const ACCOUNT_INFO_URL = "https://www.tiktok.com/passport/web/account/info/";
+const UA =
+  "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36 Edg/155.0.0.0";
+const DEFAULT_TIMEOUT_MS = 20 * 1000;
+const DEFAULT_PACING_MS = 250;
+
+/** proxyHint 归一化：纯数字 → http://127.0.0.1:<port>；http(s):// 开头 → 原样；其余忽略 */
+function normalizeProxy(hint) {
+  const s = String(hint || "").trim();
+  if (!s) return null;
+  if (/^\d{2,5}$/.test(s)) return `http://127.0.0.1:${s}`;
+  if (/^https?:\/\//.test(s)) return s;
+  return null;
+}
+
+/**
+ * 无浏览器探测单个账号登录态
+ * @param {Array} cookies 池内 cookies 数组 [{name,value,domain?...}]
+ * @param {object} opts { proxy?: string|null, timeoutMs?: number }
+ * @returns {Promise<{alive: boolean, username: ?string, expired: boolean, httpStatus: number, error: ?string, ms: number}>}
+ */
+export async function probeLogin(cookies, { proxy = null, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const cookieHeader = (cookies || [])
+    .filter((c) => c && c.name && c.value != null)
+    .filter((c) => !c.domain || String(c.domain).includes("tiktok"))
+    .map((c) => `${c.name}=${c.value}`)
+    .join("; ");
+  const t0 = Date.now();
+  try {
+    const res = await request(ACCOUNT_INFO_URL, {
+      method: "GET",
+      headers: {
+        cookie: cookieHeader,
+        "user-agent": UA,
+        accept: "application/json",
+        "accept-language": "en-US,en;q=0.9",
+      },
+      ...(proxy ? { dispatcher: new ProxyAgent(proxy) } : {}),
+      headersTimeout: timeoutMs,
+      bodyTimeout: timeoutMs,
+    });
+    const body = await res.body.json().catch(() => null);
+    const ms = Date.now() - t0;
+    const d = (body && body.data) || null;
+    return {
+      httpStatus: res.status,
+      alive: !!d && !!(d.username || d.user_id || d.sec_user_id),
+      username: (d && d.username) || null,
+      expired: (d && d.name === "session_expired") || (body && body.error_code === 13),
+      error: body && !d ? JSON.stringify(body).slice(0, 120) : null,
+      ms,
+    };
+  } catch (e) {
+    return { httpStatus: 0, alive: false, username: null, expired: false, error: String(e).slice(0, 120), ms: Date.now() - t0 };
+  }
+}
+
+/**
+ * 批量巡检：默认探 pool+suspect（leased 由消费方验证兜底、retired 不探测），指定 ids 精确取。
+ * 结果逐号 recordHealth 落账（dead 且在池 → suspect）；串行 + pacing，对 TikTok 友好。
+ * @param {object} opts { ids?: string[], proxy?: string|null(缺省用各号 proxyHint), pacingMs?, probeFn?(测试注入) }
+ * @returns {Promise<{checked: number, alive: number, dead: number, error: number, migrated: number, results: Array}>}
+ */
+export async function checkPoolAccounts(opts = {}) {
+  const { ids, proxy = null, pacingMs = DEFAULT_PACING_MS, probeFn = probeLogin } = opts;
+  const targets = healthTargets({ ids });
+  const summary = { checked: 0, alive: 0, dead: 0, error: 0, migrated: 0, results: [] };
+  for (let i = 0; i < targets.length; i++) {
+    const t = targets[i];
+    const exit = proxy || normalizeProxy(t.proxyHint);
+    const r = await probeFn(t.cookies, { proxy: exit });
+    const ok = r.error ? "error" : r.alive ? "alive" : "dead";
+    let rec = { username: t.username, health: ok, status: t.status, ms: r.ms };
+    try {
+      const applied = recordHealth({
+        id: t.id,
+        ok,
+        detail: r.error ? `探测异常 ${r.error}` : r.alive ? "" : r.expired ? "会话过期" : "未登录",
+      });
+      rec.status = applied.status;
+      if (applied.migrated) rec.migrated = true;
+    } catch (e) {
+      rec.error = e.message;
+    }
+    summary[ok]++;
+    summary.checked++;
+    if (rec.migrated) summary.migrated++;
+    summary.results.push(rec);
+    if (i < targets.length - 1 && pacingMs > 0) {
+      await new Promise((res) => setTimeout(res, pacingMs));
+    }
+  }
+  return summary;
+}

package/src/watch/login-pool.js

@@ -229,6 +229,7 @@ function publicView(acc) {
     lastImportFrom: acc.lastImportFrom || null,
     // 最近使用镜像（脱离 lease 独立存在，释放/回收后仍可见）
     lastHealthAt: acc.lastHealthAt || null,
+    lastHealth: acc.lastHealth || null,
     lastBusinessOkAt: acc.lastBusinessOkAt || null,
     lastUsedAt: acc.lastUsedAt || null,
     lease,
@@ -754,6 +755,108 @@ export function importAccount({ userId, port, username, cookies, note, proxyHint
 /** 来源元数据（供节点热路径跳过 + 账号中心展示），非租约；新入池与幂等补写共用此定义 */
 const importMeta = (userId, portNum, at) => ({ userId, port: portNum, at });
 
+/**
+ * 重登录：按 username 覆盖刷新 cookies（区别于 import 的「已在池即幂等跳过」）。
+ * 守卫：目标必须已在池（新号走 import/add）；使用中（leased）拒绝——先等节点换号/手动释放；
+ *   retired 重登录=复活回 pool；suspect 刷新后回 pool；空闲则原地刷新。
+ * username 必须来自 passport 活体验证（调用方已验，且须与目标一致——身份不符由调用方拦截），
+ * cookies 必须非空。
+ */
+export function reloginAccount({ username, cookies, userId, note } = {}) {
+  ensureLoaded();
+  reapExpiredLeases();
+  if (!username) throw new Error("username 必填（重登录目标）");
+  if (!userId) throw new Error("userId 必填（操作来源）");
+  const norm = normalizeCookies(cookies);
+  if (!norm) throw new Error("cookies 必须是非空数组，且每项含 name/value");
+  const acc = _accounts.find((a) => a.username === username);
+  if (!acc) throw new Error(`账号 ${username} 不在池中（重登录仅针对已有账号，新号走 import/add）`);
+  if (acc.status === "leased") {
+    const w = acc.lease;
+    throw new Error(
+      `账号 ${username} 使用中（${w?.userId || "?"}${w?.port ? ":" + w.port : ""}），先释放再重登录`,
+    );
+  }
+  const revived = acc.status === "retired";
+  const wasSuspect = acc.status === "suspect";
+  acc.cookies = norm;
+  acc.status = "pool";
+  acc.updatedAt = now();
+  pushHistory(
+    acc,
+    "relogin",
+    `${revived ? "重登录复活（已停用→池）" : wasSuspect ? "重登录（疑似→池）" : "重登录刷新"} · ${userId}${note ? ` · ${String(note).slice(0, 80)}` : ""}`,
+  );
+  scheduleSave();
+  return { account: publicView(acc), revived, wasSuspect };
+}
+
+/**
+ * 巡检目标：默认取 pool+suspect（leased 由消费方验证兜底、retired 不探测）；
+ * 指定 ids 时按 id 精确取（仍排除 retired）。返回含明文 cookies，仅限服务端进程内使用。
+ */
+export function healthTargets({ ids } = {}) {
+  ensureLoaded();
+  reapExpiredLeases();
+  const idSet = Array.isArray(ids) && ids.length ? new Set(ids) : null;
+  return _accounts
+    .filter((a) => a.status !== "retired")
+    .filter((a) => (idSet ? idSet.has(a.id) : a.status === "pool" || a.status === "suspect"))
+    .map((a) => ({
+      id: a.id,
+      username: a.username,
+      status: a.status,
+      proxyHint: a.proxyHint || "",
+      cookies: a.cookies,
+    }));
+}
+
+/**
+ * 巡检结果落账：lastHealthAt + lastHealth('alive'|'dead'|'error')。
+ * dead 且在池 → 迁移 suspect（业务不再自动取到死号）；alive 不写 history（避免刷屏，
+ * HISTORY_MAX 只有 20 条）；dead/error 才记 history。leased/retired 仅记录不迁移状态。
+ */
+export function recordHealth({ id, ok, detail } = {}) {
+  ensureLoaded();
+  const acc = _accounts.find((x) => x.id === id);
+  if (!acc) throw new Error(`账号不存在: ${id}`);
+  acc.lastHealthAt = now();
+  acc.lastHealth = ok; // 'alive' | 'dead' | 'error'
+  let migrated = false;
+  if (ok === "dead" && acc.status === "pool") {
+    acc.status = "suspect";
+    migrated = true;
+  }
+  if (ok !== "alive" || migrated) {
+    pushHistory(
+      acc,
+      "health",
+      `${ok}${detail ? ` · ${String(detail).slice(0, 80)}` : ""}${migrated ? " · pool→suspect" : ""}`,
+    );
+  }
+  scheduleSave();
+  return { username: acc.username, status: acc.status, migrated };
+}
+
+/**
+ * 重登录预备：返回目标账号明文 cookies（relogin 命令注入旧登录态用）。
+ * 守卫与 reloginAccount 一致：必须在池、使用中拒绝。
+ */
+export function prepareRelogin({ username } = {}) {
+  ensureLoaded();
+  reapExpiredLeases();
+  if (!username) throw new Error("username 必填");
+  const acc = _accounts.find((a) => a.username === username);
+  if (!acc) throw new Error(`账号 ${username} 不在池中`);
+  if (acc.status === "leased") {
+    const w = acc.lease;
+    throw new Error(
+      `账号 ${username} 使用中（${w?.userId || "?"}${w?.port ? ":" + w.port : ""}），先释放再重登录`,
+    );
+  }
+  return { account: fullView(acc) };
+}
+
 /** 内部：注入账号（测试/迁移工具用，跳过命令队列直接改状态） */
 export function _accountsInternal() {
   ensureLoaded();

package/src/watch/public/app.js

@@ -6044,7 +6044,14 @@ function renderProxySection(c, userId) {
   if (wdSubsConfigured(userId).length > 0) {
     return renderSubsOverview(c, userId, [], []);
   }
-  return renderProxyLegacy(c, userId);
+  var legacy = renderProxyLegacy(c, userId);
+  if (legacy) return legacy;
+  // 新节点引导（2026-10-28）：无通道 + 未配置订阅 + daemon 未跑过 clash 时，原逻辑返回 ""，
+  // 后台看不到任何订阅配置入口——而 proxySettings[userId] 条目只有配置动作才会创建
+  // （注册/心跳从不建，订阅分配器对无条目直接 return null），构成死环（F-11/IB-1 都踩过）。
+  // 渲染最小引导行：配置弹窗对空条目天然兼容（手动列表 / 切自动分配均可用），
+  // 建条目后客户端下个心跳拿到订阅并自动拉起 mihomo，本区块随之变为正常视图。
+  return renderSubsBootstrap(userId);
 }
 
 /** 兼容旧版：仅主控制端（legacy clashHealth） */
@@ -6061,6 +6068,27 @@ function renderProxyLegacy(c, userId) {
   );
 }
 
+/** 新节点引导行：订阅完全未配置且 daemon 无 clash 数据时，仍保留配置入口（打破 UI 死环） */
+function renderSubsBootstrap(userId) {
+  return styled(
+    "div",
+    "margin-top:6px;padding:6px 10px;background:#111;border-radius:6px;display:flex;align-items:center;gap:8px;font-size:12px;flex-wrap:wrap",
+    styled("span", "color:#888", "🛜 订阅配置:") +
+      styled("span", "color:#6b7280", "未配置（保存后下个心跳自动下发并拉起 mihomo）") +
+      tag(
+        "button",
+        {
+          onclick: "wdShowProxyModal('" + esc(userId) + "')",
+          style:
+            "padding:2px 8px;font-size:11px;background:#333;color:#fbbf24;" +
+            "border:1px solid #444;border-radius:3px;cursor:pointer",
+          title: "配置该客户端的代理订阅地址（保存后自动热应用，无需重启）",
+        },
+        "配置 ⚙️",
+      ),
+  );
+}
+
 /** 外部代理通道（Verge 等非内置实例）：节点行 + 节点列表 + 自身订阅摘要 */
 function renderExternalChannel(ch, userId, withConfig) {
   if (!ch || !ch.node) return "";

package/src/watch/server.js

@@ -20,7 +20,10 @@ import {
   takeAccount,
   acquireAccount,
   importAccount,
+  reloginAccount,
+  prepareRelogin,
 } from "./login-pool.js";
+import { checkPoolAccounts } from "./login-health.js";
 
 const __filename = fileURLToPath(import.meta.url);
 
@@ -643,37 +646,52 @@ function serveLoginPoolPage(res) {
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>账号中心 · 登录池</title>
 <style>
-  body { font-family: system-ui, sans-serif; margin: 20px; background: #f7f8fa; color: #1f2329; }
-  h1 { font-size: 20px; }
-  .bar { margin: 12px 0; display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
-  button { padding: 4px 10px; border: 1px solid #d0d3d9; border-radius: 6px; background: #fff; cursor: pointer; font-size: 12px; }
-  button:hover { background: #f0f2f5; }
-  button:disabled { color: #c0c4cc; cursor: not-allowed; background: #fafafa; }
-  table { border-collapse: collapse; width: 100%; background: #fff; }
-  th, td { border: 1px solid #e5e7eb; padding: 6px 10px; font-size: 13px; text-align: left; vertical-align: top; }
-  th { background: #f2f3f5; white-space: nowrap; }
-  .badge { display: inline-block; padding: 1px 8px; border-radius: 10px; font-size: 12px; font-weight: 600; }
+  body { font-family: system-ui, sans-serif; margin: 0; background: #f3f4f6; color: #1f2329; }
+  .wrap { max-width: 1280px; margin: 0 auto; padding: 22px 24px 48px; }
+  h1 { font-size: 20px; margin: 0 0 2px; }
+  .sub { color: #9ca3af; font-size: 12px; margin-bottom: 14px; }
+  .bar { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; margin-bottom: 12px; }
+  button { padding: 6px 14px; border: 1px solid #d0d3d9; border-radius: 8px; background: #fff; cursor: pointer; font-size: 13px; transition: all .15s; }
+  button:hover { background: #f0f2f5; border-color: #b8bdc7; }
+  button:disabled { color: #9ca3af; cursor: not-allowed; background: #f5f5f5; border-color: #e5e7eb; }
+  button.primary { background: #2563eb; border-color: #2563eb; color: #fff; font-weight: 600; }
+  button.primary:hover:not(:disabled) { background: #1d4ed8; }
+  .chips { display: inline-flex; gap: 6px; margin-left: auto; flex-wrap: wrap; }
+  .chip { background: #fff; border: 1px solid #e5e7eb; border-radius: 999px; padding: 3px 12px; font-size: 12px; color: #6b7280; }
+  .chip b { color: #1f2329; }
+  .card { background: #fff; border: 1px solid #e5e7eb; border-radius: 12px; overflow: auto; box-shadow: 0 1px 2px rgba(0,0,0,.04); }
+  table { border-collapse: collapse; width: 100%; }
+  th, td { padding: 9px 12px; font-size: 13px; text-align: left; vertical-align: top; border-bottom: 1px solid #f0f1f3; }
+  thead th { background: #f9fafb; color: #6b7280; font-weight: 600; white-space: nowrap; border-bottom: 1px solid #e5e7eb; }
+  tbody tr:hover { background: #f8faff; }
+  tbody tr:last-child td { border-bottom: none; }
+  .badge { display: inline-block; padding: 1px 9px; border-radius: 999px; font-size: 12px; font-weight: 600; }
   .b-leased { background: #dbeafe; color: #2563eb; }
   .b-pool { background: #dcfce7; color: #16a34a; }
   .b-suspect { background: #fef3c7; color: #d97706; }
   .b-retired { background: #e5e7eb; color: #6b7280; }
   .muted { color: #9ca3af; font-size: 12px; }
   .warn { color: #dc2626; }
-  #msg { margin: 0 8px; }
+  #msg { font-size: 13px; color: #16a34a; }
+  .spin { display: inline-block; width: 12px; height: 12px; border: 2px solid #cbd5e1; border-top-color: #2563eb; border-radius: 50%; animation: spin .8s linear infinite; vertical-align: -2px; margin-right: 6px; }
+  @keyframes spin { to { transform: rotate(360deg); } }
   details { margin-top: 2px; }
   summary { cursor: pointer; }
+  td button { padding: 3px 10px; font-size: 12px; border-radius: 6px; margin: 1px 0; }
 </style>
 </head>
 <body>
+<div class="wrap">
 <h1>账号中心 · 登录池</h1>
+<div class="sub">登录态统一存放与租借：业务取号注入 / 节点启动导入 / 巡检与重登录</div>
 <div class="bar">
   <button onclick="load()">刷新</button>
-  <label><input type="checkbox" id="auto" checked> 自动刷新(15s)</label>
-  <button onclick="addDlg()">入池</button>
-  <button onclick="takeDlg()" title="调试：走命令队列的 take（watchdog 注入流）">模拟取号</button>
+  <button onclick="addCmdDlg()" title="生成一条命令，在任意装有 tt-help 的机器执行：弹出 Edge 人工登录 TikTok 后自动入池">新增账号</button>
+  <button id="btn-check" class="primary" onclick="checkNow()" title="逐号 HTTP 探测登录态（空闲+疑似），死号自动标疑似">批量检测</button>
   <span id="msg"></span>
+  <span class="chips" id="stats"></span>
 </div>
-<div id="content">加载中…</div>
+<div id="content" class="card">加载中…</div>
 <script>
 const esc = s => String(s ?? '').replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;','\\'':'&#39;'}[c]));
 const fmt = t => t ? new Date(t).toLocaleString('zh-CN', {hour12:false}) : '—';
@@ -715,6 +733,10 @@ 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 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>';
       const meta = [];
       if (a.note) meta.push(esc(a.note));
       if (a.proxyHint) meta.push('出口 ' + esc(a.proxyHint));
@@ -728,6 +750,7 @@ async function load() {
         '<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> ' : '') +
@@ -735,7 +758,7 @@ async function load() {
           (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 disabled title="开发中：引导重新登录并更新池内登录态">重登录</button>' +
+          '<button onclick="reloginDlg(\\'' + esc(a.username) + '\\')" title="生成重登录命令：本机执行后旧登录态自动复活（或人工登录），验证身份后覆盖刷新池内 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>' +
@@ -743,27 +766,70 @@ async function load() {
     }).join('');
     const nLeased = j.accounts.filter(a => a.status === 'leased').length;
     const nFree = j.accounts.filter(a => a.status === 'pool').length;
+    const nSus = j.accounts.filter(a => a.status === 'suspect').length;
+    const nRet = j.accounts.filter(a => a.status === 'retired').length;
+    document.getElementById('stats').innerHTML =
+      '<span class="chip">共 <b>' + j.total + '</b></span>' +
+      '<span class="chip">使用中 <b>' + nLeased + '</b></span>' +
+      '<span class="chip">空闲 <b>' + nFree + '</b></span>' +
+      '<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></tr>' + rows + '</table>' +
-      '<p class="muted">共 ' + j.total + ' 个 · 使用中 ' + nLeased + ' · 空闲 ' + nFree + ' · 排序：使用中 → 空闲 → 疑似 → 已停用 · 有效期 = sessionid cookie 承诺寿命（非实时有效性，真实判据 = 业务出活）· cookies 明文不出服务端</p>';
+      '<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 明文不出服务端</p></div>';
   } catch (e) { msg('加载失败: ' + e.message, true); }
 }
-async function addDlg() {
-  const username = prompt('账号名(uniqueId，可留空自动从 cookies 提取):'); if (username === null) return;
-  const cookiesRaw = prompt('cookies JSON 数组（可直接粘 export.mjs 导出的整个 JSON，会自动取 cookies 字段）:'); if (!cookiesRaw) return;
-  try {
-    let cookies = JSON.parse(cookiesRaw);
-    if (cookies && !Array.isArray(cookies) && Array.isArray(cookies.cookies)) cookies = cookies.cookies;
-    const note = prompt('备注(可空，如来源 F-11:9223):');
-    await api('/api/login-pool/add', { username: username || undefined, cookies, note: note || undefined });
-    msg('入池成功'); load();
-  } catch (e) { msg('入池失败: ' + e.message, true); }
+function copyCmd(cmd) {
+  if (navigator.clipboard) navigator.clipboard.writeText(cmd).catch(() => {});
+  prompt('复制命令（在装有 tt-help 的机器上执行）:', cmd);
 }
-async function takeDlg() {
-  const userId = prompt('节点 userId（如 F-11）:'); if (!userId) return;
-  const port = prompt('端口:'); if (!port) return;
-  try { const j = await api('/api/login-pool/take', { userId, port: Number(port) }); msg('已取号: ' + j.account.username); load(); }
-  catch (e) { msg('取号失败: ' + e.message, true); }
+function addCmdDlg() {
+  copyCmd('tt-help login-pool add --server ' + location.origin);
+  msg('命令已生成：执行成功后点刷新查看新号');
+}
+function reloginDlg(name) {
+  copyCmd('tt-help login-pool relogin ' + name + ' --server ' + location.origin);
+  msg('重登录命令已生成（' + name + '）：执行成功后点刷新');
+}
+function setProgress(t) {
+  const el = document.getElementById('msg');
+  el.innerHTML = '<span class="spin"></span>' + esc(t);
+  el.style.color = '#2563eb';
+}
+let checking = false;
+async function checkNow() {
+  if (checking) return;
+  let targets;
+  try {
+    const j = await api('/api/login-pool');
+    targets = j.accounts.filter(a => a.status === 'pool' || a.status === 'suspect');
+  } catch (e) { msg('加载失败: ' + e.message, true); return; }
+  if (!targets.length) { msg('没有待检测账号（空闲+疑似为空，使用中的由业务自验）'); return; }
+  if (!confirm('批量检测 ' + targets.length + ' 个账号的登录态？（死号自动标疑似）')) return;
+  checking = true;
+  const btn = document.getElementById('btn-check');
+  btn.disabled = true; btn.textContent = '检测中…';
+  let done = 0, alive = 0, dead = 0, err = 0, mig = 0;
+  try {
+    for (const a of targets) {
+      setProgress('巡检中 ' + (done + 1) + '/' + targets.length + ' · 正在检测 @' + a.username + ' …');
+      let health = 'error';
+      try {
+        const r = await api('/api/login-pool/check', { ids: [a.id] });
+        const x = r.results && r.results[0];
+        if (x) { health = x.health; if (x.migrated) mig++; }
+      } catch (e) { health = 'error'; }
+      if (health === 'alive') alive++; else if (health === 'dead') dead++; else err++;
+      done++;
+      setProgress('巡检中 ' + done + '/' + targets.length + ' · 活 ' + alive + ' / 死 ' + dead + ' / 异常 ' + err);
+      load();
+      if (done < targets.length) await new Promise(r => setTimeout(r, 300));
+    }
+    msg('巡检完成: 探测 ' + done + '，活 ' + alive + ' / 死 ' + dead + ' / 异常 ' + err + (mig ? '，死号标疑似 ' + mig + ' 个' : ''));
+  } finally {
+    checking = false;
+    btn.disabled = false; btn.textContent = '批量检测';
+  }
 }
 async function assignDlg(id, name) {
   const userId = prompt('指派给节点 userId（如 F-11）:'); if (!userId) return;
@@ -795,8 +861,9 @@ async function del(id) {
   catch (e) { msg('失败: ' + e.message, true); }
 }
 load();
-setInterval(() => { if (document.getElementById('auto').checked) load(); }, 15000);
+setInterval(() => load(), 15000);
 </script>
+</div>
 </body>
 </html>`;
   res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
@@ -1616,6 +1683,28 @@ export function startWatchServer(
             );
             sendJSON(res, 200, { ok: true, dedup: imp.dedup, account: ret });
             return;
+          } else if (lpAction === "relogin") {
+            // 重登录覆盖刷新（以号为主键）：目标必须已在池；使用中拒绝；retired 复活、suspect 回池
+            const rel = reloginAccount(body);
+            ret = rel.account;
+            console.error(
+              `[登录池 ${ts}] RELOGIN: ${ret.username} ← ${body.userId}${rel.revived ? "（复活）" : rel.wasSuspect ? "（疑似→池）" : ""} (${ret.cookieCount} 条 cookies)`,
+            );
+            sendJSON(res, 200, { ok: true, revived: rel.revived, wasSuspect: rel.wasSuspect, account: ret });
+            return;
+          } else if (lpAction === "prepare") {
+            // 重登录预备：返回目标账号明文 cookies（relogin 命令注入旧登录态用；与 acquire 同级信任）
+            const prep = prepareRelogin(body);
+            sendJSON(res, 200, { ok: true, account: prep.account });
+            return;
+          } else if (lpAction === "check") {
+            // 巡检：无浏览器纯 HTTP 探测登录态（默认 pool+suspect，指定 ids 精确取）
+            const sum = await checkPoolAccounts({ ids: body.ids, proxy: body.proxy });
+            console.error(
+              `[登录池 ${ts}] CHECK: 探测 ${sum.checked}，alive ${sum.alive} / dead ${sum.dead} / error ${sum.error}，migrated ${sum.migrated}`,
+            );
+            sendJSON(res, 200, { ok: true, ...sum });
+            return;
           } else if (lpAction === "assign") {
             ret = assignAccount(body);
             console.error(`[登录池 ${ts}] ASSIGN: ${ret.username} → ${body.userId}:${body.port}`);