tt-help-cli-ycl 1.4.134 → 1.4.136

package/src/watchdog/agent.js

@@ -26,6 +26,36 @@ import { spawn } from "child_process";
 import { join, dirname } from "path";
 import { homedir, tmpdir } from "os";
 import { fileURLToPath } from "url";
+import { pushSelfLog, getSelfLogs } from "./self-log-buffer.js";
+
+// ── 看门狗自身日志入环（供后台页面按需拉取，经 report-logs 回传落盘） ──
+// 包装 console.error：本进程所有 [watchdog]/[llm-analyzer]/[upgrade] 等日志
+// 在正常输出的同时进共享环形缓冲（与托管进程日志同环，见 self-log-buffer.js）。
+const _origConsoleError = console.error.bind(console);
+console.error = (...args) => {
+  try {
+    const line = args
+      .map((a) =>
+        typeof a === "string"
+          ? a
+          : a instanceof Error
+            ? a.stack || a.message
+            : typeof a === "object"
+              ? JSON.stringify(a)
+              : String(a),
+      )
+      .join(" ");
+    pushSelfLog(line);
+  } catch {
+    /* 缓冲失败不影响原始输出 */
+  }
+  _origConsoleError(...args);
+};
+
+/** 取最近 tail 行看门狗自身日志（含托管进程日志，只读） */
+export function getWatchdogSelfLogs(tail = 500) {
+  return getSelfLogs(tail);
+}
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const homeDir = homedir() || process.env.HOME || process.env.USERPROFILE || "";
@@ -566,6 +596,11 @@ export class WatchdogAgent {
         }
       }
 
+      // 后台页面按需拉取日志（request-logs 入队 → 本心跳取走 → 收集后回传落盘）
+      if (Array.isArray(data.logRequests) && data.logRequests.length > 0) {
+        this._handleLogRequests(data.logRequests);
+      }
+
       // 服务端下发的客户端配置（远程修改 ~/.tt-help.json）
       if (data.clientConfig) {
         applyClientConfig(data.clientConfig);
@@ -754,6 +789,47 @@ export class WatchdogAgent {
     }
   }
 
+  /**
+   * 处理服务端下发的日志拉取请求（后台页面点击"日志"按钮触发）
+   * 收集本机日志（watchdog 自身环形缓冲 / 进程日志只读快照）→ POST 回传服务端落盘
+   * @param {Array<{cmdId:string, tail?:number}>} requests
+   */
+  async _handleLogRequests(requests) {
+    for (const req of requests) {
+      const cmdId = req && req.cmdId ? String(req.cmdId) : "";
+      if (!cmdId) continue;
+      const tail = Math.max(1, Math.min(Number(req.tail) || 500, 500));
+      let logs = [];
+      if (cmdId === "__watchdog__") {
+        logs = getWatchdogSelfLogs(tail);
+      } else {
+        logs = this.processManager.getProcessLogSnapshot(cmdId, tail);
+      }
+      try {
+        const resp = await fetch(`${this.serverUrl}/api/watchdog/report-logs`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            clientId: this.clientId,
+            cmdId,
+            logs,
+            capturedAt: Date.now(),
+          }),
+          signal: AbortSignal.timeout(20000),
+        });
+        if (!resp.ok) {
+          console.error(
+            `[watchdog] 日志回传失败: ${cmdId} HTTP ${resp.status}`,
+          );
+          continue;
+        }
+        console.error(`[watchdog] 日志回传完成: ${cmdId} (${logs.length}行)`);
+      } catch (e) {
+        console.error(`[watchdog] 日志回传失败: ${cmdId}: ${e.message}`);
+      }
+    }
+  }
+
   /**
    * 启动 LLM 日志分析定时器（每 10 分钟调服务端接口）
    */

package/src/watchdog/process-manager.js

@@ -15,6 +15,7 @@ import { killEdgeProcesses } from "../lib/browser/cdp.js";
 import { writeFileSync, unlinkSync } from "fs";
 import { tmpdir } from "os";
 import { join } from "path";
+import { pushSelfLog } from "./self-log-buffer.js";
 
 // === 2026-08-07 变更 ===
 // syncCommands 改为 async，批量启动时每个进程间隔 SPAWN_STAGGER_MS（30s），避免抢网络
@@ -60,6 +61,7 @@ function fmtClock(d = new Date()) {
 /**
  * 打印子进程日志行（替代裸 console.error）。
  * 只改显示形态，msg 内容一行不少；多行消息逐行加前缀。
+ * 同时以纯文本（无 ANSI 颜色）写入共享环形缓冲，供后台按需拉取。
  */
 function printProcessLine(id, msg) {
   const lines = String(msg).split(/\r?\n/);
@@ -68,6 +70,8 @@ function printProcessLine(id, msg) {
   const useColor = canUseColor();
   for (const line of lines) {
     const clock = fmtClock();
+    // 环形缓冲：与 cmd 窗口同格式（时间 [cmdId] 内容），无颜色
+    pushSelfLog(`${clock} ${prefixId} ${line}`);
     if (useColor) {
       process.stderr.write(
         `\x1b[90m${clock}\x1b[0m \x1b[${color}m${prefixId}\x1b[0m ${line}\n`,
@@ -525,6 +529,23 @@ export class ProcessManager extends EventEmitter {
     return result;
   }
 
+  /**
+   * 只读获取某进程最近 tail 行日志快照（不清空，与 LLM 链路互不影响）
+   * 供后台页面点击"日志"按钮时按需拉取
+   * @param {string} cmdId - 命令 ID
+   * @param {number} [tail=500] - 取最近多少行
+   * @returns {string[]}
+   */
+  getProcessLogSnapshot(cmdId, tail = 500) {
+    const info = this.processes.get(cmdId);
+    if (!info || !info.logs || info.logs.length === 0) return [];
+    const n = Math.max(
+      1,
+      Math.min(Number(tail) || 500, MAX_LOG_LINES, info.logs.length),
+    );
+    return info.logs.slice(-n);
+  }
+
   /**
    * 检测假死进程：超过 STALE_LOG_TIMEOUT_MS 无日志输出则自动重启
    * @returns {Array<{cmdId:string, silentMinutes:number}>} 被重启的进程列表

package/src/watchdog/self-log-buffer.js

@@ -0,0 +1,25 @@
+/**
+ * 看门狗客户端本机日志环形缓冲（供后台页面按需拉取，经 report-logs 回传落盘）
+ *
+ * 两路来源：
+ *   1. watchdog 自身日志 —— agent.js 包装 console.error 写入（[watchdog]/[llm-analyzer]/[upgrade] 等）
+ *   2. 托管进程日志   —— process-manager.js 的 printProcessLine 写入（纯文本，无 ANSI 颜色）
+ *
+ * 独立成模块是为了避免 agent.js ↔ process-manager.js 相互 import 形成循环依赖。
+ */
+
+const MAX_LINES = 500; // 最多保留行数
+
+const ring = [];
+
+/** 追加一行（超容量丢弃最旧） */
+export function pushSelfLog(line) {
+  ring.push(String(line));
+  if (ring.length > MAX_LINES) ring.shift();
+}
+
+/** 取最近 tail 行（只读） */
+export function getSelfLogs(tail = MAX_LINES) {
+  const n = Math.max(1, Math.min(Number(tail) || MAX_LINES, ring.length));
+  return ring.slice(-n);
+}