tt-help-cli-ycl 1.4.74 → 1.4.76

package/package.json

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

package/src/watch/public/app.js

@@ -1,3 +1,9 @@
+// === 2026-08-07 变更 ===
+// 1. renderWatchdogDashboard: 客户端按名称排序（在线优先，离线排最后）
+// 2. renderClientCard / renderOfflineCard: 离线客户端红色标题+红色边框
+// 3. 整体字体调大一号（12px→14px, 14px→16px, 10px→12px 等）
+// 4. 新增 wdClearLlm() + 🧹 按钮（清除指定客户端 LLM 分析提示）
+// 5. renderCmdRows 新增 llmAnalysis 参数，显示 🤖 AI 分析行
 const COLORS = [
   "#fe2c55",
   "#60a5fa",
@@ -3503,27 +3509,52 @@ function renderWatchdogDashboard(clients, clientCommands) {
     return;
   }
 
+  // 排序：按名称升序，离线排最后
+  var sortedClients = clients.slice().sort(function (a, b) {
+    var nameA = (
+      (a.config && a.config.userId) ||
+      a.hostname ||
+      ""
+    ).toLowerCase();
+    var nameB = (
+      (b.config && b.config.userId) ||
+      b.hostname ||
+      ""
+    ).toLowerCase();
+    // 在线优先
+    if (a.online !== b.online) return a.online ? -1 : 1;
+    return nameA.localeCompare(nameB);
+  });
+
   // 构建 userId → 在线客户端 映射
   var userClients = {};
-  clients.forEach(function (c) {
+  sortedClients.forEach(function (c) {
     var uid = (c.config && c.config.userId) || "";
     if (uid) userClients[uid] = c;
   });
 
   // 收集所有卡片：全部注册客户端 + 未上线但有命令配置的 userId
   var allCards = [];
-  clients.forEach(function (c) {
+  sortedClients.forEach(function (c) {
     allCards.push(renderClientCard(c, clientCommands));
   });
+  // 离线卡也按名称排序
+  var offlineUids = [];
   for (var uid in clientCommands) {
     if (
       !userClients[uid] &&
       clientCommands[uid] &&
       clientCommands[uid].length > 0
     ) {
-      allCards.push(renderOfflineCard(uid, clientCommands[uid]));
+      offlineUids.push(uid);
     }
   }
+  offlineUids.sort(function (a, b) {
+    return a.toLowerCase().localeCompare(b.toLowerCase());
+  });
+  offlineUids.forEach(function (uid) {
+    allCards.push(renderOfflineCard(uid, clientCommands[uid]));
+  });
 
   // 数据指纹：只有变化时才重建卡片 HTML
   var fingerprint = JSON.stringify(allCards);
@@ -3570,7 +3601,7 @@ function renderOfflineCard(userId, cmds) {
   var cmdCount = cmds ? cmds.length : 0;
   return styled(
     "div",
-    "background:#1e1e2e;border:1px solid #333;border-radius:12px;padding:16px;opacity:0.9",
+    "background:#1e1e2e;border:2px solid #f87171;border-radius:12px;padding:16px;opacity:0.9",
     styled(
       "div",
       "display:flex;justify-content:space-between;align-items:center;margin-bottom:8px",
@@ -3581,7 +3612,7 @@ function renderOfflineCard(userId, cmds) {
           "span",
           {
             style:
-              "color:#60a5fa;font-size:14px;font-weight:bold;cursor:pointer",
+              "color:#f87171;font-size:16px;font-weight:bold;cursor:pointer",
             onclick: "wdShowConfigModal('" + esc(userId) + "')",
             title: "点击编辑客户端配置",
           },
@@ -3592,28 +3623,38 @@ function renderOfflineCard(userId, cmds) {
             {
               onclick: "wdShowConfigModal('" + esc(userId) + "')",
               style:
-                "padding:1px 5px;font-size:10px;background:transparent;color:#60a5fa;border:1px solid #333;border-radius:3px;cursor:pointer;margin-left:6px",
+                "padding:1px 5px;font-size:12px;background:transparent;color:#f87171;border:1px solid #333;border-radius:3px;cursor:pointer;margin-left:6px",
               title: "编辑客户端配置",
             },
             "⚙️",
           ) +
+          tag(
+            "button",
+            {
+              onclick: "wdClearLlm('" + esc(userId) + "')",
+              style:
+                "padding:1px 5px;font-size:11px;background:transparent;color:#888;border:1px solid #333;border-radius:3px;cursor:pointer;margin-left:6px",
+              title: "清除此客户端的 LLM 分析提示",
+            },
+            "🧹",
+          ) +
           styled(
             "span",
-            "color:#555;font-size:11px;margin-left:8px",
+            "color:#555;font-size:12px;margin-left:8px",
             "(未上线)",
           ),
       ) +
         styled(
           "div",
           "display:flex;gap:10px;align-items:center",
-          styled("span", "color:#f87171", "● 离线") +
-            styled("span", "color:#555;font-size:10px", "—") +
+          styled("span", "color:#f87171;font-size:13px", "● 离线") +
+            styled("span", "color:#555;font-size:12px", "—") +
             tag(
               "button",
               {
                 onclick: "wdDeleteClient('" + esc(userId) + "')",
                 style:
-                  "padding:2px 8px;font-size:10px;background:#991b1b;color:#fff;border:none;border-radius:3px;cursor:pointer",
+                  "padding:2px 8px;font-size:12px;background:#991b1b;color:#fff;border:none;border-radius:3px;cursor:pointer",
                 title: "删除此客户端配置",
               },
               "删除",
@@ -3622,7 +3663,7 @@ function renderOfflineCard(userId, cmds) {
     ) +
       styled(
         "div",
-        "color:#555;font-size:10px",
+        "color:#555;font-size:12px",
         "该机器尚未连接看门狗，配置了 " + cmdCount + " 条命令",
       ) +
       renderCmdRows(cmds || [], userId, [], false),
@@ -3665,6 +3706,7 @@ function renderClientCard(c, clientCommands) {
     procs = c.processes || [];
   var userId = cfg.userId || "";
   var myCmds = userId && clientCommands[userId] ? clientCommands[userId] : [];
+  var online = c.online;
 
   var osStr = [
     os.platform,
@@ -3683,11 +3725,15 @@ function renderClientCard(c, clientCommands) {
     (os.nodeVersion || "?") +
     " | 运行 " +
     (os.uptime != null ? Math.round(os.uptime / 3600) + "h" : "?");
-  var onlineBadge = c.online
+  var onlineBadge = online
     ? styled("span", "color:#4ade80", "● 在线")
     : styled("span", "color:#f87171", "● 离线");
   var lastSeen = new Date(c.lastHeartbeat).toLocaleTimeString("zh-CN");
 
+  // 离线时标题和边框变红
+  var titleColor = online ? "#60a5fa" : "#f87171";
+  var borderColor = online ? "#333" : "#f87171";
+
   var header = styled(
     "div",
     "display:flex;justify-content:space-between;align-items:center;margin-bottom:8px",
@@ -3697,7 +3743,10 @@ function renderClientCard(c, clientCommands) {
       tag(
         "span",
         {
-          style: "color:#60a5fa;font-size:14px;font-weight:bold;cursor:pointer",
+          style:
+            "color:" +
+            titleColor +
+            ";font-size:16px;font-weight:bold;cursor:pointer",
           onclick: "wdShowConfigModal('" + esc(userId) + "')",
           title: "点击编辑客户端配置",
         },
@@ -3708,30 +3757,44 @@ function renderClientCard(c, clientCommands) {
           {
             onclick: "wdShowConfigModal('" + esc(userId) + "')",
             style:
-              "padding:1px 5px;font-size:10px;background:transparent;color:#60a5fa;border:1px solid #333;border-radius:3px;cursor:pointer;margin-left:6px",
+              "padding:1px 5px;font-size:12px;background:transparent;color:" +
+              titleColor +
+              ";border:1px solid #333;border-radius:3px;cursor:pointer;margin-left:6px",
             title: "编辑客户端配置",
           },
           "⚙️",
         ) +
+        (userId
+          ? tag(
+              "button",
+              {
+                onclick: "wdClearLlm('" + esc(userId) + "')",
+                style:
+                  "padding:1px 5px;font-size:11px;background:transparent;color:#888;border:1px solid #333;border-radius:3px;cursor:pointer;margin-left:6px",
+                title: "清除此客户端的 LLM 分析提示",
+              },
+              "🧹",
+            )
+          : "") +
         styled(
           "span",
-          "color:#555;font-size:10px;margin-left:8px",
+          "color:#555;font-size:12px;margin-left:8px",
           c.hostname || "",
         ),
     ) +
       styled(
         "div",
         "display:flex;gap:10px;align-items:center",
-        styled("span", "color:#888;font-size:11px", c.ip) +
+        styled("span", "color:#888;font-size:13px", c.ip) +
           onlineBadge +
-          styled("span", "color:#666;font-size:10px", lastSeen) +
-          (!c.online && userId
+          styled("span", "color:#666;font-size:12px", lastSeen) +
+          (!online && userId
             ? tag(
                 "button",
                 {
                   onclick: "wdDeleteClient('" + esc(userId) + "')",
                   style:
-                    "padding:2px 8px;font-size:10px;background:#991b1b;color:#fff;border:none;border-radius:3px;cursor:pointer;margin-left:6px",
+                    "padding:2px 8px;font-size:12px;background:#991b1b;color:#fff;border:none;border-radius:3px;cursor:pointer;margin-left:6px",
                   title: "删除此客户端配置",
                 },
                 "删除",
@@ -3742,11 +3805,13 @@ function renderClientCard(c, clientCommands) {
 
   return styled(
     "div",
-    "background:#1e1e2e;border:1px solid #333;border-radius:12px;padding:16px",
+    "background:#1e1e2e;border:2px solid " +
+      borderColor +
+      ";border-radius:12px;padding:16px",
     header +
-      styled("div", "color:#888;font-size:10px", osStr) +
-      styled("div", "color:#888;font-size:10px;margin-bottom:6px", infoLine) +
-      renderCmdRows(myCmds, userId, procs, c.online, c.llmAnalysis),
+      styled("div", "color:#888;font-size:12px", osStr) +
+      styled("div", "color:#888;font-size:12px;margin-bottom:6px", infoLine) +
+      renderCmdRows(myCmds, userId, procs, online, c.llmAnalysis),
   );
 }
 
@@ -3761,7 +3826,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
       "display:flex;justify-content:space-between;align-items:center;margin-bottom:6px",
       styled(
         "span",
-        "font-size:11px;color:#888",
+        "font-size:13px;color:#888",
         "命令 (" + myCmds.length + "条)",
       ) +
         tag(
@@ -3769,7 +3834,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
           {
             onclick: "wdShowAddModal('" + esc(userId) + "')",
             style:
-              "padding:4px 10px;background:#4ade80;color:#000;border:none;border-radius:4px;cursor:pointer;font-size:11px;font-weight:600",
+              "padding:4px 10px;background:#4ade80;color:#000;border:none;border-radius:4px;cursor:pointer;font-size:13px;font-weight:600",
           },
           "+ 添加",
         ),
@@ -3779,7 +3844,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
   // 表头
   html += styled(
     "div",
-    "display:grid;grid-template-columns:1fr 50px 55px 55px 50px 80px;gap:4px;padding:4px 0;color:#666;font-size:9px;border-bottom:1px solid #222",
+    "display:grid;grid-template-columns:1fr 50px 55px 55px 50px 80px;gap:4px;padding:4px 0;color:#666;font-size:11px;border-bottom:1px solid #222",
     "<span>命令行</span><span>PID</span><span>内存</span><span>运行</span><span>重启</span><span>操作</span>",
   );
 
@@ -3802,7 +3867,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
     var prefix = "wd-" + esc(userId) + "-" + idx;
     html += styled(
       "div",
-      "display:grid;grid-template-columns:1fr 50px 55px 55px 50px 80px;gap:4px;padding:4px 0;align-items:center;font-size:10px;border-top:1px solid #1a1a2a",
+      "display:grid;grid-template-columns:1fr 50px 55px 55px 50px 80px;gap:4px;padding:4px 0;align-items:center;font-size:12px;border-top:1px solid #1a1a2a",
       styled(
         "span",
         "color:" +
@@ -3818,7 +3883,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
           (c.name
             ? styled(
                 "span",
-                "color:#555;font-size:8px;margin-left:4px;font-family:monospace",
+                "color:#555;font-size:10px;margin-left:4px;font-family:monospace",
                 c.cmd.substring(0, 30) + (c.cmd.length > 30 ? "..." : ""),
               )
             : ""),
@@ -3856,7 +3921,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
                   onclick:
                     "wdToggleClientCmd('" + esc(userId) + "'," + idx + ")",
                   style:
-                    "padding:1px 5px;font-size:9px;background:" +
+                    "padding:1px 5px;font-size:11px;background:" +
                     (c.enabled ? "#f59e0b" : "#4ade80") +
                     ";color:#000;border:none;border-radius:2px;cursor:pointer",
                   title: c.enabled ? "停止" : "启动",
@@ -3869,7 +3934,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
               {
                 onclick: "wdShowEditModal('" + esc(userId) + "'," + idx + ")",
                 style:
-                  "padding:1px 5px;font-size:9px;background:#60a5fa;color:#fff;border:none;border-radius:2px;cursor:pointer",
+                  "padding:1px 5px;font-size:11px;background:#60a5fa;color:#fff;border:none;border-radius:2px;cursor:pointer",
                 title: "编辑",
               },
               "✎",
@@ -3879,7 +3944,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
               {
                 onclick: "wdRemoveClientCmd('" + esc(userId) + "'," + idx + ")",
                 style:
-                  "padding:1px 5px;font-size:9px;background:#991b1b;color:#fff;border:none;border-radius:2px;cursor:pointer",
+                  "padding:1px 5px;font-size:11px;background:#991b1b;color:#fff;border:none;border-radius:2px;cursor:pointer",
                 title: "删除",
               },
               "✕",
@@ -3902,7 +3967,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
           : "";
       html += styled(
         "div",
-        "font-size:9px;color:#666;padding:1px 0 3px 8px;border-top:1px dashed #1a1a2a",
+        "font-size:11px;color:#666;padding:1px 0 3px 8px;border-top:1px dashed #1a1a2a",
         styled("span", "color:" + sevColor, "🤖 " + ai.summary) + tip,
       );
     }
@@ -3915,7 +3980,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
     var opre = "wd-" + esc(userId) + "-orphan-" + esc(String(oid));
     html += styled(
       "div",
-      "display:grid;grid-template-columns:1fr 50px 55px 55px 50px 80px;gap:4px;padding:4px 0;align-items:center;font-size:10px;border-top:1px solid #1a1a2a;opacity:0.5",
+      "display:grid;grid-template-columns:1fr 50px 55px 55px 50px 80px;gap:4px;padding:4px 0;align-items:center;font-size:12px;border-top:1px solid #1a1a2a;opacity:0.5",
       styled(
         "span",
         "color:#666;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-family:monospace",
@@ -3941,7 +4006,7 @@ function renderCmdRows(myCmds, userId, procs, isOnline, llmAnalysis) {
           { style: "color:#555", "data-wd-key": opre + "-rst" },
           "0",
         ) +
-        styled("span", "color:#555;font-size:9px", "孤立"),
+        styled("span", "color:#555;font-size:11px", "孤立"),
     );
   });
 
@@ -4173,6 +4238,32 @@ async function wdSaveClientCmds(userId, commands) {
   }
 }
 
+function wdClearLlm(userId) {
+  if (
+    !confirm(
+      "清除 " +
+        userId +
+        " 的所有 LLM 分析提示？\n\n下次 agent 心跳或分析周期会自动重新生成。",
+    )
+  )
+    return;
+  wdShowSaving();
+  fetch("/api/watchdog/clear-llm", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ userId: userId }),
+  })
+    .then(function () {
+      wdHideSaving();
+      fetchWatchdogData();
+    })
+    .catch(function (e) {
+      wdHideSaving();
+      alert("清除失败: " + e.message);
+      fetchWatchdogData();
+    });
+}
+
 function wdDeleteClient(userId) {
   if (
     !confirm(

package/src/watch/public/style.css

@@ -9,6 +9,7 @@ body {
   background: #0f0f13;
   color: #e0e0e0;
   padding: 16px;
+  font-size: 14px;
 }
 
 .header {
@@ -65,13 +66,13 @@ body {
 }
 
 .stat-card .label {
-  font-size: 12px;
+  font-size: 14px;
   color: #888;
   margin-bottom: 8px;
 }
 
 .stat-card .value {
-  font-size: 28px;
+  font-size: 32px;
   font-weight: 700;
 }
 

package/src/watch/watchdog-server.js

@@ -3,6 +3,11 @@
  *
  * 独立模块。每条命令是完整命令行字符串（如 "tt-help explore --location DE"），
  * 按 userId（~/.tt-help.json 的 userId 字段）分组存储。
+ *
+ * === 2026-08-07 变更 ===
+ * 1. 新增 llmCache 内存缓存，handleAnalyzeLogs 分析完成后写入缓存
+ * 2. getOnlineClients() 优先用缓存填充 llmAnalysis（不再依赖 agent 转发）
+ * 3. 新增 POST /api/watchdog/clear-llm 端点，手动清除指定客户端的 LLM 提示
  */
 
 import { readFileSync, writeFileSync, existsSync } from "fs";
@@ -17,6 +22,10 @@ const clients = new Map();
 const CLIENT_TIMEOUT_MS = 60 * 1000;
 const CLIENT_CLEANUP_MS = 24 * 60 * 60 * 1000; // 离线超过 24h 清理
 
+// LLM 分析缓存：cmdId → { severity, summary, suggestions, cachedAt }
+const llmCache = new Map();
+const LLM_CACHE_TTL = 15 * 60 * 1000; // 15 分钟过期
+
 // ── 配置文件读写 ──
 
 function loadConfig() {
@@ -56,9 +65,24 @@ function getOnlineClients() {
       console.error(`[watchdog] 清理离线客户端: ${clientId}`);
     }
   }
+  // 清理过期缓存
+  for (const [cmdId, entry] of llmCache) {
+    if (now - entry.cachedAt > LLM_CACHE_TTL) llmCache.delete(cmdId);
+  }
   const result = [];
   for (const [clientId, info] of clients) {
     const online = now - info.lastHeartbeat < CLIENT_TIMEOUT_MS;
+    // 合并：agent 上报的 llmAnalysis + 服务端缓存（以服务端缓存为准，更新）
+    const processes = info.processes || [];
+    const cachedAnalysis = [];
+    for (const p of processes) {
+      if (p.cmdId && llmCache.has(p.cmdId)) {
+        cachedAnalysis.push(llmCache.get(p.cmdId));
+      }
+    }
+    // 优先用服务端缓存（更新），fallback 到 agent 上报的
+    const llmAnalysis =
+      cachedAnalysis.length > 0 ? cachedAnalysis : info.llmAnalysis || [];
     result.push({
       clientId,
       hostname: info.hostname || "unknown",
@@ -66,7 +90,8 @@ function getOnlineClients() {
       ttHelpVersion: info.ttHelpVersion || "unknown",
       osInfo: info.osInfo || {},
       config: info.config || {},
-      processes: info.processes || [],
+      processes,
+      llmAnalysis,
       lastHeartbeat: info.lastHeartbeat,
       registeredAt: info.registeredAt,
       online,
@@ -286,6 +311,11 @@ async function handleAnalyzeLogs(params, body, res) {
     console.error(
       `[watchdog] LLM 分析完成: ${llmAnalysis.map((r) => r.severity).join(",")}`,
     );
+    // 写入服务端缓存，前端直接读取，不再依赖 agent 转发
+    const now = Date.now();
+    for (const item of llmAnalysis) {
+      llmCache.set(item.cmdId, { ...item, cachedAt: now });
+    }
     sendJSON(res, 200, { llmAnalysis });
   } catch (e) {
     console.error(`[watchdog] LLM 分析失败: ${e.message}`);
@@ -318,6 +348,35 @@ async function handleDeleteClient(params, body, res) {
   sendJSON(res, 200, { ok: true, removed });
 }
 
+async function handleClearLlmAnalysis(params, body, res) {
+  const userId = body.userId;
+  if (!userId) {
+    sendJSON(res, 400, { error: "缺少 userId" });
+    return;
+  }
+  // 收集该 userId 下所有客户端进程的 cmdId，从缓存中清除
+  let cleared = 0;
+  for (const [clientId, info] of clients) {
+    const uid = (info.config && info.config.userId) || "";
+    if (uid !== userId) continue;
+    for (const p of info.processes || []) {
+      if (p.cmdId && llmCache.has(p.cmdId)) {
+        llmCache.delete(p.cmdId);
+        cleared++;
+      }
+    }
+  }
+  // 同时清除 agent 上报的 llmAnalysis（如果存在）
+  for (const [clientId, info] of clients) {
+    const uid = (info.config && info.config.userId) || "";
+    if (uid === userId && info.llmAnalysis) {
+      info.llmAnalysis = [];
+    }
+  }
+  console.error(`[watchdog] ${userId} LLM 分析已清除（${cleared}条缓存）`);
+  sendJSON(res, 200, { ok: true, cleared });
+}
+
 // ── 公开 ──
 
 export function registerWatchdogRoutes(httpServer) {
@@ -379,5 +438,9 @@ export async function tryHandleWatchdogRoute(
     await handleDeleteClient(params, body, res);
     return true;
   }
+  if (method === "POST" && routePath === "/api/watchdog/clear-llm") {
+    await handleClearLlmAnalysis(params, body, res);
+    return true;
+  }
   return false;
 }

package/src/watchdog/agent.js

@@ -7,7 +7,12 @@
  *   3. 处理信号优雅退出
  */
 
-import { getSystemInfo, getClientConfig, getLocalIP } from "./reporter.js";
+import {
+  getSystemInfo,
+  getClientConfig,
+  getLocalIP,
+  getClashHealth,
+} from "./reporter.js";
 import { ProcessManager } from "./process-manager.js";
 import {
   getVersion,
@@ -16,12 +21,46 @@ import {
   startUpgradeChecker,
 } from "./upgrader.js";
 import { writeFileSync, existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
+import { spawn } from "child_process";
+import { join, dirname } from "path";
+import { homedir, tmpdir } from "os";
+import { fileURLToPath } from "url";
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
 const homeDir = homedir() || process.env.HOME || process.env.USERPROFILE || "";
 const TT_HELP_CONFIG = join(homeDir, ".tt-help.json");
 
+/** 自动发现 daemon.js 路径 */
+function findDaemonPath() {
+  // 1. 从 ~/.tt-help.json 读取配置
+  try {
+    if (existsSync(TT_HELP_CONFIG)) {
+      const cfg = JSON.parse(readFileSync(TT_HELP_CONFIG, "utf-8"));
+      if (cfg.clashDaemonPath && existsSync(cfg.clashDaemonPath)) {
+        return cfg.clashDaemonPath;
+      }
+    }
+  } catch {}
+
+  // 2. 相对于 tiktok-cli 同级目录
+  const candidates = [
+    join(__dirname, "..", "..", "..", "clash-verge-explore", "daemon.js"),
+    join(__dirname, "..", "..", "..", "..", "clash-verge-explore", "daemon.js"),
+    join(process.cwd(), "..", "clash-verge-explore", "daemon.js"),
+  ];
+  for (const p of candidates) {
+    if (existsSync(p)) return p;
+  }
+  return null;
+}
+
+// daemon 路径（启动时解析一次）
+let _daemonPath = null;
+function getDaemonPath() {
+  if (_daemonPath === null) _daemonPath = findDaemonPath();
+  return _daemonPath;
+}
+
 /** 将服务端下发的配置合并写回 ~/.tt-help.json */
 function applyClientConfig(newCfg) {
   try {
@@ -92,6 +131,11 @@ export class WatchdogAgent {
     this._heartbeatSeq = 0; // 心跳序号
     this._lastProcCount = -1; // 上次进程数
     this._lastCmdCount = -1; // 上次命令数
+    // clash daemon 集成
+    this.clashDaemon = null; // daemon 子进程引用
+    this.gracePeriodMs = 120_000; // 启动宽限期 2 分钟
+    this.startTime = 0; // 启动时间戳
+    this._graceEnded = false; // 宽限期是否已结束
   }
 
   /**
@@ -100,6 +144,7 @@ export class WatchdogAgent {
   async start() {
     if (this.running) return;
     this.running = true;
+    this.startTime = Date.now();
 
     console.error(
       `[watchdog] 启动 — 客户端: ${this.clientId}, 版本: ${this.ttHelpVersion}, 间隔: ${this.intervalMs / 1000}s`,
@@ -111,6 +156,9 @@ export class WatchdogAgent {
     // 注册信号处理
     this._setupSignalHandlers();
 
+    // 启动 clash daemon（保代理通道）
+    this._spawnClashDaemon();
+
     // 首次立即发送心跳
     await this._sendHeartbeat();
 
@@ -152,6 +200,8 @@ export class WatchdogAgent {
       this.upgradeChecker.stop();
       this.upgradeChecker = null;
     }
+    // 停止 clash daemon
+    this._killClashDaemon();
     this.processManager.stopAll();
     console.error("[watchdog] 看门狗已停止");
   }
@@ -178,6 +228,7 @@ export class WatchdogAgent {
       config: getClientConfig(),
       processes: this.processManager.getProcessesStatus(),
       llmAnalysis: this._llmResults,
+      clashHealth: getClashHealth(), // daemon 写入的代理健康状态
     };
   }
 
@@ -212,7 +263,7 @@ export class WatchdogAgent {
       // 同步命令
       if (Array.isArray(data.commands)) {
         const prev = this.processManager.runningCount;
-        this.processManager.syncCommands(data.commands);
+        await this.processManager.syncCommands(data.commands);
         const now = this.processManager.runningCount;
         if (prev !== now) {
           console.error(
@@ -244,6 +295,29 @@ export class WatchdogAgent {
       console.error(
         `[watchdog] 心跳失败 (${this.consecutiveFailures}/${this.maxFailures}): ${e.message}`,
       );
+
+      // 启动宽限期：daemon 可能还在切节点，心跳失败不计入自杀计数
+      if (!this._graceEnded) {
+        const elapsed = Date.now() - this.startTime;
+        if (elapsed < this.gracePeriodMs) {
+          const remain = Math.round((this.gracePeriodMs - elapsed) / 1000);
+          // daemon 已报告健康 → 提前结束宽限期
+          const health = getClashHealth();
+          if (health && health.healthy) {
+            this._graceEnded = true;
+            console.error(`[watchdog] 代理已健康，宽限期提前结束`);
+            this.consecutiveFailures = 0;
+            return;
+          }
+          console.error(
+            `[watchdog] 宽限期内 (剩余${remain}s)，等待 daemon 修复代理...`,
+          );
+          return;
+        }
+        this._graceEnded = true;
+        console.error(`[watchdog] 宽限期结束，恢复正常心跳失败计数`);
+      }
+
       if (this.consecutiveFailures >= this.maxFailures) {
         console.error("[watchdog] 连续心跳失败次数过多，看门狗退出");
         await this.stop();
@@ -315,6 +389,76 @@ export class WatchdogAgent {
     });
   }
 
+  /**
+   * 启动 clash daemon 子进程
+   * daemon 负责代理节点健康巡检和故障切换，watchdog 不阻塞等待
+   */
+  _spawnClashDaemon() {
+    const daemonPath = getDaemonPath();
+    if (!daemonPath) {
+      console.error("[watchdog] 未找到 clash daemon (daemon.js)，跳过代理守护");
+      console.error(
+        "[watchdog] 提示: 在 ~/.tt-help.json 中设置 clashDaemonPath",
+      );
+      return;
+    }
+
+    console.error(`[watchdog] 启动代理守护: ${daemonPath}`);
+    try {
+      const child = spawn(process.execPath, [daemonPath], {
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: false,
+      });
+
+      child.stdout?.on("data", (d) => {
+        // daemon 日志通过 stderr 输出，stdout 静默
+      });
+
+      child.stderr?.on("data", (d) => {
+        const msg = d.toString().trim();
+        if (msg) {
+          console.error(`[clash-daemon] ${msg.substring(0, 300)}`);
+        }
+      });
+
+      child.on("exit", (code, signal) => {
+        console.error(
+          `[watchdog] clash daemon 退出 (code=${code}, signal=${signal})`,
+        );
+        this.clashDaemon = null;
+      });
+
+      child.on("error", (err) => {
+        console.error(`[watchdog] clash daemon 启动失败: ${err.message}`);
+        this.clashDaemon = null;
+      });
+
+      this.clashDaemon = child;
+    } catch (e) {
+      console.error(`[watchdog] clash daemon 启动异常: ${e.message}`);
+    }
+  }
+
+  /**
+   * 停止 clash daemon 子进程
+   */
+  _killClashDaemon() {
+    if (!this.clashDaemon) return;
+    try {
+      this.clashDaemon.kill("SIGTERM");
+      setTimeout(() => {
+        try {
+          if (this.clashDaemon && this.clashDaemon.exitCode === null) {
+            this.clashDaemon.kill("SIGKILL");
+          }
+        } catch {}
+      }, 3000);
+    } catch (e) {
+      console.error(`[watchdog] 停止 clash daemon 失败: ${e.message}`);
+    }
+    this.clashDaemon = null;
+  }
+
   /**
    * 信号处理
    */

package/src/watchdog/process-manager.js

@@ -16,9 +16,12 @@ import { writeFileSync, unlinkSync } from "fs";
 import { tmpdir } from "os";
 import { join } from "path";
 
+// === 2026-08-07 变更 ===
+// syncCommands 改为 async，批量启动时每个进程间隔 SPAWN_STAGGER_MS（30s），避免抢网络
 const MAX_RESTART = 3;
 const MAX_LOG_LINES = 500; // 每个进程最多保留的日志行数
 const IS_WIN = process.platform === "win32";
+const SPAWN_STAGGER_MS = 30000; // 批量启动时每个进程间隔 30 秒，避免抢网络
 
 // 从命令行中提取 CDP 端口列表（解析 --base-port 和 --port-count）
 function extractCdpPorts(cmdLine) {
@@ -385,9 +388,10 @@ export class ProcessManager extends EventEmitter {
    * 与期望命令列表同步：
    * - 启动期望列表中已启用但未运行的命令
    * - 停止正在运行但不在期望列表中的命令
+   * - 批量启动时每个进程间隔 SPAWN_STAGGER_MS，避免同时抢网络
    * @param {Array} expectedCmds - 服务端返回的命令列表，格式 [{cmd, maxUptimeSeconds, maxMemoryMB}]
    */
-  syncCommands(expectedCmds) {
+  async syncCommands(expectedCmds) {
     if (!Array.isArray(expectedCmds)) return;
 
     // 标准化：使用服务端分配的 id，无 id 时用命令行截断兜底
@@ -428,12 +432,26 @@ export class ProcessManager extends EventEmitter {
       }
     }
 
-    // 启动缺失的，并更新已有进程的阈值
+    // 收集需要新启动的命令
+    const toStart = normalized.filter((cmd) => !runningIds.has(cmd.id));
+
+    if (toStart.length > 1) {
+      console.error(
+        `[watchdog] 批量启动 ${toStart.length} 个命令（间隔 ${SPAWN_STAGGER_MS / 1000}s）...`,
+      );
+    }
+
+    // 启动缺失的，错峰延迟
+    for (let i = 0; i < toStart.length; i++) {
+      if (i > 0) {
+        await new Promise((r) => setTimeout(r, SPAWN_STAGGER_MS));
+      }
+      this.startCommand(toStart[i]);
+    }
+
+    // 更新已有进程的阈值（可能被管理员修改了）
     for (const cmd of normalized) {
-      if (!runningIds.has(cmd.id)) {
-        this.startCommand(cmd);
-      } else {
-        // 更新阈值（可能被管理员修改了）
+      if (runningIds.has(cmd.id)) {
         const info = this.processes.get(cmd.id);
         if (info) info.thresholds = cmd.thresholds;
       }

package/src/watchdog/reporter.js

@@ -6,10 +6,11 @@
 import os from "os";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
-import { homedir } from "os";
+import { homedir, tmpdir } from "os";
 
 const homeDir = homedir() || process.env.HOME || process.env.USERPROFILE || "";
 const CONFIG_PATH = join(homeDir, ".tt-help.json");
+const CLASH_HEALTH_FILE = join(tmpdir(), "clash-health.json");
 
 /**
  * 获取系统信息
@@ -67,3 +68,25 @@ export function getLocalIP() {
   }
   return "127.0.0.1";
 }
+
+/**
+ * 读取 clash daemon 写入的健康状态文件
+ * @returns {object|null} { node, healthy, httpCode, timeTotal, lastCheck, lastSwitch } 或 null
+ */
+export function getClashHealth() {
+  try {
+    if (existsSync(CLASH_HEALTH_FILE)) {
+      const raw = readFileSync(CLASH_HEALTH_FILE, "utf-8");
+      const data = JSON.parse(raw);
+      // 检查数据是否过期（超过 2 分钟没更新视为 stale）
+      const age = Date.now() - new Date(data.lastCheck || 0).getTime();
+      if (age > 120_000) {
+        return { ...data, stale: true, ageSeconds: Math.round(age / 1000) };
+      }
+      return { ...data, stale: false };
+    }
+  } catch {
+    // 文件不存在或解析失败
+  }
+  return null;
+}