tt-help-cli-ycl 1.4.115 → 1.4.119

package/src/watch/data-store.js

@@ -668,7 +668,8 @@ function getTargetRefreshStats(hours = 24) {
     )
     .all(...targetLocations);
 
-  if (!totalRows.length) return { countries: [], total: 0, refreshed: 0 };
+  if (!totalRows.length)
+    return { countries: [], total: 0, refreshed: 0, pendingRefresh: 0 };
 
   // 按国家统计最近 N 小时内刷新过的数量
   const threshold = Date.now() - hours * 3600 * 1000;
@@ -688,17 +689,47 @@ function getTargetRefreshStats(hours = 24) {
   const refreshedMap = new Map();
   for (const r of refreshedRows) refreshedMap.set(r.country, r.cnt);
 
+  // 按国家统计待 Refresh 数量（pending_refresh = 1，等待 refresh 客户端处理）
+  const pendingRows = getDb()
+    .prepare(
+      `
+      SELECT location_created as country, COUNT(*) as cnt
+      FROM jobs
+      WHERE tt_seller = 1
+        AND verified = 0
+        AND pending_refresh = 1
+        AND location_created IN (${placeholders})
+      GROUP BY location_created
+    `,
+    )
+    .all(...targetLocations);
+  const pendingMap = new Map();
+  for (const r of pendingRows) pendingMap.set(r.country, r.cnt);
+
   const results = [];
   let totalAll = 0;
   let refreshedAll = 0;
+  let pendingAll = 0;
   for (const r of totalRows) {
     const refreshed = refreshedMap.get(r.country) || 0;
+    const pendingRefresh = pendingMap.get(r.country) || 0;
     totalAll += r.cnt;
     refreshedAll += refreshed;
-    results.push({ country: r.country, total: r.cnt, refreshed });
+    pendingAll += pendingRefresh;
+    results.push({
+      country: r.country,
+      total: r.cnt,
+      refreshed,
+      pendingRefresh,
+    });
   }
 
-  return { countries: results, total: totalAll, refreshed: refreshedAll };
+  return {
+    countries: results,
+    total: totalAll,
+    refreshed: refreshedAll,
+    pendingRefresh: pendingAll,
+  };
 }
 
 export function createStore(filePath, options = {}) {

package/src/watch/public/app.js

@@ -1706,7 +1706,7 @@ let currentTagsSeq = 0;
 const TAGS_PAGE_SIZE = 200;
 let cachedTagCountries = [];
 let currentRefreshHours = 24;
-let currentTargetRefreshHours = 24;
+let currentTargetRefreshHours = 48;
 
 function showTagsPage() {
   document.getElementById("mainPage").classList.add("hidden");
@@ -2087,6 +2087,7 @@ function renderTargetRefreshStats(data) {
       <thead><tr style="color:#888;text-align:left">
         <th style="padding:4px 8px">国家</th>
         <th style="padding:4px 8px;text-align:right">商家数</th>
+        <th style="padding:4px 8px;text-align:right">待Refresh</th>
         <th style="padding:4px 8px;text-align:right">${currentTargetRefreshHours}h已刷</th>
         <th style="padding:4px 8px;width:120px">进度</th>
       </tr></thead>
@@ -2098,6 +2099,7 @@ function renderTargetRefreshStats(data) {
     html += `<tr style="color:#ccc;border-top:1px solid #222">
       <td style="padding:4px 8px">${c.country}</td>
       <td style="padding:4px 8px;text-align:right">${c.total}</td>
+      <td style="padding:4px 8px;text-align:right;color:${c.pendingRefresh > 0 ? "#fbbf24" : "#9ca3af"}">${c.pendingRefresh || 0}</td>
       <td style="padding:4px 8px;text-align:right;color:${cpct >= 50 ? "#22c55e" : "#facc15"}">${c.refreshed}</td>
       <td style="padding:4px 8px">
         <div style="display:flex;align-items:center;gap:6px">
@@ -3436,6 +3438,7 @@ async function fetchWatchdogData() {
       _wdData.clientCommands || {},
       _wdData.clashCountries || {},
       _wdData.errorTriggers || {},
+      _wdData.loginPorts || {},
     );
   } catch (e) {
     document.getElementById("wdClientsList").textContent =
@@ -3488,6 +3491,7 @@ function renderWatchdogDashboard(
   clientCommands,
   clashCountries,
   errorTriggers,
+  loginPorts,
 ) {
   // 顶栏统计始终更新（textContent 不闪烁）
   var onlineCount = clients.filter(function (c) {
@@ -3546,7 +3550,13 @@ function renderWatchdogDashboard(
   var allCards = [];
   sortedClients.forEach(function (c) {
     allCards.push(
-      renderClientCard(c, clientCommands, clashCountries, errorTriggers),
+      renderClientCard(
+        c,
+        clientCommands,
+        clashCountries,
+        errorTriggers,
+        loginPorts,
+      ),
     );
   });
   // 离线卡也按名称排序
@@ -3570,6 +3580,7 @@ function renderWatchdogDashboard(
         clientCommands[uid],
         clashCountries,
         errorTriggers,
+        loginPorts,
       ),
     );
   });
@@ -3615,7 +3626,13 @@ function renderWatchdogDashboard(
   }
 }
 
-function renderOfflineCard(userId, cmds, clashCountries, errorTriggers) {
+function renderOfflineCard(
+  userId,
+  cmds,
+  clashCountries,
+  errorTriggers,
+  loginPorts,
+) {
   var cmdCount = cmds ? cmds.length : 0;
   return styled(
     "div",
@@ -3686,6 +3703,7 @@ function renderOfflineCard(userId, cmds, clashCountries, errorTriggers) {
       ) +
       renderCountrySection({}, userId, clashCountries) +
       renderErrorTriggerSection({}, userId, errorTriggers) +
+      renderLoginSection({}, userId, loginPorts) +
       renderCmdRows(cmds || [], userId, [], false),
   );
 }
@@ -3720,7 +3738,13 @@ function findAnalysis(llmAnalysis, cmdId) {
   return null;
 }
 
-function renderClientCard(c, clientCommands, clashCountries, errorTriggers) {
+function renderClientCard(
+  c,
+  clientCommands,
+  clashCountries,
+  errorTriggers,
+  loginPorts,
+) {
   var os = c.osInfo || {},
     cfg = c.config || {},
     procs = c.processes || [];
@@ -3833,6 +3857,7 @@ function renderClientCard(c, clientCommands, clashCountries, errorTriggers) {
       styled("div", "color:#888;font-size:12px;margin-bottom:6px", infoLine) +
       renderCountrySection(c, userId, clashCountries) +
       renderErrorTriggerSection(c, userId, errorTriggers) +
+      renderLoginSection(c, userId, loginPorts) +
       renderProxySection(c, userId) +
       renderCmdRows(myCmds, userId, procs, online, c.llmAnalysis),
   );
@@ -3962,6 +3987,137 @@ async function wdSetCountries() {
   }
 }
 
+// ── 登录检测端口配置区域（看门狗面板中每个客户端卡片） ──
+
+function renderLoginSection(c, userId, loginPorts) {
+  if (!userId) return "";
+  var cfgEntry = (loginPorts && loginPorts[userId]) || {};
+  var configured =
+    cfgEntry.ports && cfgEntry.ports.length ? cfgEntry.ports : [];
+  var report = c.loginReport || null;
+  var reportHtml;
+  if (!report) {
+    reportHtml = styled(
+      "span",
+      "color:#555;margin-left:auto",
+      configured.length ? "等待客户端上报..." : "",
+    );
+  } else if (report.error) {
+    var et = report.checkedAt
+      ? new Date(report.checkedAt).toLocaleTimeString("zh-CN")
+      : "?";
+    reportHtml =
+      styled("span", "color:#888;margin-left:auto", "最近检测(" + et + "): ") +
+      styled("span", "color:#f87171", "失败");
+  } else if (report.ports && report.ports.length) {
+    var et2 = report.checkedAt
+      ? new Date(report.checkedAt).toLocaleTimeString("zh-CN")
+      : "?";
+    var badges = report.ports
+      .map(function (r) {
+        var color =
+          r.status === "logged_in"
+            ? "#4ade80"
+            : r.status === "expired"
+              ? "#fbbf24"
+              : r.status === "error"
+                ? "#f87171"
+                : "#888";
+        var label =
+          r.status === "logged_in"
+            ? "已登录"
+            : r.status === "expired"
+              ? "已过期"
+              : r.status === "error"
+                ? "失败"
+                : "未登录";
+        var txt =
+          r.port +
+          " " +
+          label +
+          (r.status === "logged_in" && r.account ? " @" + r.account : "");
+        return styled(
+          "span",
+          "color:" +
+            color +
+            ";background:#0d1117;border:1px solid #333;padding:1px 6px;border-radius:4px",
+          txt,
+        );
+      })
+      .join(" ");
+    reportHtml =
+      styled("span", "color:#888;margin-left:auto", "最近检测(" + et2 + "): ") +
+      badges;
+  } else {
+    reportHtml = styled("span", "color:#555;margin-left:auto", "无结果");
+  }
+  return styled(
+    "div",
+    "margin-top:6px;padding:6px 8px;background:#111;border-radius:6px;" +
+      "display:flex;align-items:center;gap:8px;font-size:12px;flex-wrap:wrap",
+    styled("span", "font-size:14px", "🔑") +
+      styled("span", "color:#888", "登录检测:") +
+      tag(
+        "button",
+        {
+          onclick: "wdShowLoginPortsModal('" + esc(userId) + "')",
+          style:
+            "padding:2px 8px;font-size:11px;background:#333;color:#4ade80;" +
+            "border:1px solid #444;border-radius:3px;cursor:pointer",
+          title: "配置要定期检测登录状态的 CDP 端口（逗号分隔，留空清空）",
+        },
+        (configured.length ? configured.join(",") : "未配置") + " ⚙️",
+      ) +
+      reportHtml,
+  );
+}
+
+// ── 登录检测端口配置弹窗 ──
+
+var _wdLoginPortsUserId = "";
+
+function wdShowLoginPortsModal(userId) {
+  _wdLoginPortsUserId = userId;
+  document.getElementById("wdLoginPortsUserId").textContent = userId;
+  var configured = [];
+  if (_wdData && _wdData.loginPorts && _wdData.loginPorts[userId]) {
+    configured = _wdData.loginPorts[userId].ports || [];
+  }
+  document.getElementById("wdLoginPortsInput").value = configured.join(",");
+  document.getElementById("wdLoginPortsModal").style.display = "flex";
+}
+
+async function wdSetLoginPorts() {
+  var raw = document.getElementById("wdLoginPortsInput").value;
+  var ports = raw
+    .split(",")
+    .map(function (s) {
+      return s.trim();
+    })
+    .filter(Boolean);
+  try {
+    var res = await fetch("/api/watchdog/login-ports", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ userId: _wdLoginPortsUserId, ports: ports }),
+    });
+    var d = await res.json();
+    document.getElementById("wdLoginPortsModal").style.display = "none";
+    if (d.ok) {
+      alert(
+        "已配置检测端口: " +
+          (d.ports.length ? d.ports.join(",") : "无") +
+          "\n\n客户端将在下次心跳时生效，并立即触发一次检测。",
+      );
+    } else {
+      alert("失败: " + (d.error || "未知错误"));
+    }
+    fetchWatchdogData();
+  } catch (e) {
+    alert("保存失败: " + e.message);
+  }
+}
+
 // ── 错误自动切节点配置区域（看门狗面板中每个客户端卡片） ──
 
 function renderErrorTriggerSection(c, userId, errorTriggers) {
@@ -4055,23 +4211,41 @@ async function wdSetErrorTrigger() {
   }
 }
 
-// ── 代理节点区域（看门狗面板中每个客户端卡片） ──
+// ── 代理节点区域（看门狗面板中每个客户端卡片，支持多控制端通道） ──
 
 function renderProxySection(c, userId) {
+  var channels = c.clashHealthChannels || [];
+  if (channels.length > 0) {
+    var html = "";
+    for (var i = 0; i < channels.length; i++) {
+      html += renderProxyChannel(channels[i], userId);
+    }
+    return html;
+  }
+  // 兼容旧版：仅主控制端（legacy clashHealth）
   var h = c.clashHealth;
   if (!h || !h.node) return "";
-
   var nodes = (h.meta && h.meta.healthyNodes) || [];
   var hasNodes = nodes.length > 0;
+  return (
+    renderProxyLine(h, nodes, userId, 0, hasNodes) +
+    renderNodeList(nodes, h.node, userId, 0)
+  );
+}
 
+/** 单个控制端通道的代理区域 */
+function renderProxyChannel(ch, userId) {
+  if (!ch || !ch.node) return "";
+  var nodes = (ch.meta && ch.meta.healthyNodes) || [];
+  var hasNodes = nodes.length > 0;
   return (
-    renderProxyLine(h, nodes, userId, hasNodes) +
-    renderNodeList(nodes, h.node, userId, hasNodes)
+    renderProxyLine(ch, nodes, userId, ch.port || 0, hasNodes) +
+    renderNodeList(nodes, ch.node, userId, ch.port || 0)
   );
 }
 
 /** 代理状态行：当前节点 + 健康状态 + 展开按钮 */
-function renderProxyLine(h, nodes, userId, hasNodes) {
+function renderProxyLine(h, nodes, userId, port, hasNodes) {
   var dot = h.healthy ? "#4ade80" : "#f87171";
   var status = h.healthy
     ? (h.timeTotal || 0).toFixed(1) +
@@ -4079,19 +4253,31 @@ function renderProxyLine(h, nodes, userId, hasNodes) {
       ((h.sizeDownload || 0) / 1024).toFixed(0) +
       "KB"
     : h.error || "异常";
+  var clientTag = port
+    ? h.meta && h.meta.clientName
+      ? h.meta.clientName + " :" + port
+      : "代理 :" + port
+    : "";
 
   return styled(
     "div",
     "margin-top:6px;padding:6px 8px;background:#111;border-radius:6px;" +
       "display:flex;align-items:center;gap:8px;font-size:12px",
     styled("span", "color:" + dot + ";font-size:14px", "●") +
+      (clientTag
+        ? styled(
+            "span",
+            "color:#888;padding:0 4px;border:1px solid #333;border-radius:3px;font-size:10px",
+            clientTag,
+          )
+        : "") +
       styled("span", "color:#e0e0e0;font-weight:bold", h.node) +
       styled("span", "color:#666", "| " + status) +
       (hasNodes
         ? tag(
             "button",
             {
-              onclick: "wdToggleNodes('" + esc(userId) + "')",
+              onclick: "wdToggleNodes('" + esc(userId) + "'," + port + ")",
               style:
                 "margin-left:auto;padding:2px 8px;font-size:11px;background:#333;" +
                 "color:#60a5fa;border:1px solid #444;border-radius:3px;cursor:pointer",
@@ -4104,15 +4290,15 @@ function renderProxyLine(h, nodes, userId, hasNodes) {
 }
 
 /** 节点列表面板（默认隐藏） */
-function renderNodeList(nodes, currentNode, userId, hasNodes) {
-  if (!hasNodes) return "";
+function renderNodeList(nodes, currentNode, userId, port) {
+  if (!nodes || !nodes.length) return "";
 
   var items = "";
   for (var i = 0; i < nodes.length; i++) {
-    items += renderNodeItem(nodes[i], nodes[i] === currentNode, userId);
+    items += renderNodeItem(nodes[i], nodes[i] === currentNode, userId, port);
   }
 
-  var id = "wdNodes-" + wdEscId(userId);
+  var id = "wdNodes-" + wdEscId(userId) + "-" + port;
   return (
     '<div id="' +
     id +
@@ -4124,7 +4310,7 @@ function renderNodeList(nodes, currentNode, userId, hasNodes) {
 }
 
 /** 单个节点行 */
-function renderNodeItem(name, isActive, userId) {
+function renderNodeItem(name, isActive, userId, port) {
   var color = isActive ? "#4ade80" : "#888";
   var bg = isActive ? "background:#1a3a2a;" : "";
   var dot = isActive ? "●" : "○";
@@ -4135,7 +4321,9 @@ function renderNodeItem(name, isActive, userId) {
       esc(userId) +
       "','" +
       esc(name) +
-      "')\" " +
+      "'," +
+      port +
+      ')" ' +
       'style="margin-left:auto;padding:1px 6px;font-size:10px;background:#2563eb;' +
       'color:#fff;border:none;border-radius:2px;cursor:pointer">切换</button>';
 
@@ -4164,18 +4352,23 @@ function wdEscId(s) {
   return (s || "").replace(/[^a-zA-Z0-9_-]/g, "_");
 }
 
-function wdToggleNodes(userId) {
-  var el = document.getElementById("wdNodes-" + wdEscId(userId));
+function wdToggleNodes(userId, port) {
+  var el = document.getElementById(
+    "wdNodes-" + wdEscId(userId) + "-" + (port || 0),
+  );
   if (!el) return;
   el.style.display = el.style.display === "none" ? "block" : "none";
 }
 
-function wdSwitchNode(userId, node) {
+function wdSwitchNode(userId, node, port) {
+  var portLabel = port ? "（代理通道 " + port + "）" : "";
   if (
     !confirm(
       "确定要将 " +
         userId +
-        " 的代理切换到: " +
+        " 的代理" +
+        portLabel +
+        "切换到: " +
         node +
         " ？\n\n切换后自动巡检会继续运行。",
     )
@@ -4185,7 +4378,11 @@ function wdSwitchNode(userId, node) {
   fetch("/api/watchdog/switch-node", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ userId: userId, node: node }),
+    body: JSON.stringify({
+      userId: userId,
+      node: node,
+      proxyPort: port || undefined,
+    }),
   })
     .then(function (r) {
       return r.json();

package/src/watch/public/index.html

@@ -667,7 +667,26 @@
     </div>
   </div>
 
-  <script src="app.js?v=20260811b"></script>
+  <!-- 登录检测端口配置弹窗 -->
+  <div id="wdLoginPortsModal"
+    style="display:none;position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0,0,0,0.6);z-index:9999;align-items:center;justify-content:center">
+    <div style="background:#1e1e2e;border:1px solid #333;border-radius:12px;padding:24px;width:90%;max-width:480px">
+      <div style="font-size:16px;color:#4ade80;margin-bottom:4px">🔑 登录检测端口 — <span id="wdLoginPortsUserId"></span>
+      </div>
+      <div style="color:#888;font-size:12px;margin-bottom:12px">配置该客户端要定期检测登录状态的 CDP 端口（逗号分隔，如 <b
+          style="color:#4ade80">9222,9223,9225</b>）。<br>客户端每隔一段时间自动检测并上报结果，留空保存可清空配置。</div>
+      <input id="wdLoginPortsInput" placeholder="9222,9223,9225"
+        style="width:100%;padding:8px;background:#111;border:1px solid #333;color:#e0e0e0;border-radius:6px;font-size:13px;box-sizing:border-box">
+      <div style="display:flex;justify-content:flex-end;gap:8px;margin-top:16px">
+        <button onclick="document.getElementById('wdLoginPortsModal').style.display='none'"
+          style="padding:8px 16px;background:#333;color:#ccc;border:none;border-radius:6px;cursor:pointer;font-size:12px">取消</button>
+        <button onclick="wdSetLoginPorts()"
+          style="padding:8px 16px;background:#4ade80;color:#000;border:none;border-radius:6px;cursor:pointer;font-size:12px;font-weight:600">保存并下发</button>
+      </div>
+    </div>
+  </div>
+
+  <script src="app.js?v=20260816b"></script>
 </body>
 
 </html>

package/src/watch/watchdog-server.js

@@ -120,6 +120,8 @@ function getOnlineClients() {
       processes,
       llmAnalysis,
       clashHealth: info.clashHealth || null,
+      clashHealthChannels: info.clashHealthChannels || [],
+      loginReport: info.loginReport || null,
       lastHeartbeat: info.lastHeartbeat,
       registeredAt: info.registeredAt,
       online,
@@ -242,6 +244,43 @@ function getAllErrorTriggers() {
   return cfg.errorTriggers || {};
 }
 
+// ── 登录端口检测配置管理（per agent，后端配置要检查的 CDP 端口列表） ──
+
+function getLoginPortsStored(userId) {
+  if (!userId) return [];
+  const cfg = loadConfig();
+  const entry = cfg.loginPorts && cfg.loginPorts[userId];
+  if (entry && Array.isArray(entry.ports)) return entry.ports;
+  return [];
+}
+
+function setLoginPortsStored(userId, ports) {
+  const cleaned = [
+    ...new Set(
+      (Array.isArray(ports) ? ports : [])
+        .map((p) => parseInt(p, 10))
+        .filter((p) => Number.isInteger(p) && p > 0 && p < 65536),
+    ),
+  ];
+  const cfg = loadConfig();
+  if (!cfg.loginPorts) cfg.loginPorts = {};
+  if (cleaned.length === 0) {
+    delete cfg.loginPorts[userId];
+  } else {
+    cfg.loginPorts[userId] = {
+      ports: cleaned,
+      updatedAt: new Date().toISOString(),
+    };
+  }
+  saveConfig(cfg);
+  return cleaned;
+}
+
+function getAllLoginPorts() {
+  const cfg = loadConfig();
+  return cfg.loginPorts || {};
+}
+
 // ── 节点国家配置管理（per agent，默认 US，幂等下发） ──
 
 /** 读取某 agent 的国家配置，未配置时默认 ["US"] */
@@ -324,6 +363,10 @@ async function handleHeartbeat(params, body, res) {
     config: body.config || {},
     processes: body.processes || [],
     clashHealth: body.clashHealth || null,
+    clashHealthChannels: Array.isArray(body.clashHealthChannels)
+      ? body.clashHealthChannels
+      : [],
+    loginReport: body.loginReport || null,
   });
 
   // 按 userId 返回该客户端的专属命令列表
@@ -362,6 +405,7 @@ async function handleHeartbeat(params, body, res) {
     clashCommands: clashCommands.length > 0 ? clashCommands : undefined,
     clientConfig: getClientConfigStored(userId),
     errorTrigger: getErrorTriggerStored(userId),
+    loginPorts: getLoginPortsStored(userId),
     serverTime: Date.now(),
   });
 }
@@ -375,6 +419,7 @@ async function handleGetClients(params, body, res) {
     clashCountries: getAllClientCountries(),
     supportedCountries: SUPPORTED_COUNTRIES,
     errorTriggers: getAllErrorTriggers(),
+    loginPorts: getAllLoginPorts(),
     configPath: WATCHDOG_CONFIG_PATH,
   });
 }
@@ -445,6 +490,7 @@ async function handleDeleteClient(params, body, res) {
   if (cfg.clientConfigs) delete cfg.clientConfigs[userId];
   if (cfg.clashCountries) delete cfg.clashCountries[userId];
   if (cfg.errorTriggers) delete cfg.errorTriggers[userId];
+  if (cfg.loginPorts) delete cfg.loginPorts[userId];
   saveConfig(cfg);
   lastSentCountries.delete(userId);
   clashCmdQueue.delete(userId);
@@ -492,16 +538,22 @@ async function handleClearLlmAnalysis(params, body, res) {
 }
 
 async function handleSwitchNode(params, body, res) {
-  const { userId, node } = body || {};
+  const { userId, node, proxyPort } = body || {};
   if (!userId || !node) {
     sendJSON(res, 400, { error: "缺少 userId 或 node" });
     return;
   }
-  // 加入 Clash 命令队列，客户端下次心跳时取走
+  // 加入 Clash 命令队列，客户端下次心跳时取走（proxyPort 用于路由到对应控制端）
   const queue = clashCmdQueue.get(userId) || [];
-  queue.push({ action: "switchNode", node });
+  queue.push({
+    action: "switchNode",
+    node,
+    proxyPort: proxyPort ? Number(proxyPort) : undefined,
+  });
   clashCmdQueue.set(userId, queue);
-  console.error(`[watchdog] ${userId} 节点切换已入队: → ${node}`);
+  console.error(
+    `[watchdog] ${userId} 节点切换已入队: → ${node}${proxyPort ? ` (通道 ${proxyPort})` : ""}`,
+  );
   sendJSON(res, 200, { ok: true, message: `将在下次心跳时切换到 ${node}` });
 }
 
@@ -558,6 +610,36 @@ async function handleSetErrorTrigger(params, body, res) {
   sendJSON(res, 200, { ok: true, config: cleaned });
 }
 
+/** 配置某 agent 要检测登录状态的 CDP 端口列表（逗号分隔或数组） */
+async function handleSetLoginPorts(params, body, res) {
+  const { userId, ports } = body || {};
+  if (!userId) {
+    sendJSON(res, 400, { error: "缺少 userId" });
+    return;
+  }
+  // 前端可能传字符串 "9222,9223"，统一转数组
+  let portArr = ports;
+  if (typeof ports === "string") {
+    portArr = ports
+      .split(",")
+      .map((s) => s.trim())
+      .filter(Boolean)
+      .map((s) => parseInt(s, 10));
+  }
+  const cleaned = setLoginPortsStored(userId, portArr);
+  const ts = new Date().toLocaleTimeString("zh-CN", { hour12: false });
+  console.error(
+    `[watchdog ${ts}] ${userId} 登录检测端口已更新: ${cleaned.join(",") || "已清空"}`,
+  );
+  sendJSON(res, 200, {
+    ok: true,
+    ports: cleaned,
+    message: cleaned.length
+      ? `已配置检测端口 ${cleaned.join(",")}，客户端将在下次心跳时生效`
+      : "已清空检测端口",
+  });
+}
+
 // ── 公开 ──
 
 export function registerWatchdogRoutes(httpServer) {
@@ -635,5 +717,9 @@ export async function tryHandleWatchdogRoute(
     await handleSetErrorTrigger(params, body, res);
     return true;
   }
+  if (method === "POST" && routePath === "/api/watchdog/login-ports") {
+    await handleSetLoginPorts(params, body, res);
+    return true;
+  }
   return false;
 }