mcp-log-query-server 3.5.1 → 3.5.3

package/index.js

@@ -27,6 +27,7 @@ import {
 
 import { queryLog, testConnection, executeKubectl } from './ssh-client.js';
 import { findService, getAllServices, DEFAULTS, DEFAULT_NAMESPACE, SERVICES, NAMESPACES, detectContextFromPath, isLokiEnv, resolveLokiEnvName, LOKI_ENVIRONMENTS } from './config.js';
+import { log, getLogFilePath } from './logger.js';
 import {
   queryLoki, queryLokiAutoRange, parseTimeStr,
   extractTraceIds, parseServiceFromFilename, groupLogsByService,
@@ -47,16 +48,26 @@ function withTimeout(promise, ms, label) {
   ]);
 }
 
+// 安全序列化工具参数（截断超长值，容错循环引用）
+function safeStringify(obj, maxLen = 200) {
+  try {
+    const s = JSON.stringify(obj);
+    return s.length > maxLen ? s.slice(0, maxLen) + '...' : s;
+  } catch {
+    return '<unserializable>';
+  }
+}
+
 // 进程级安全网：只记录日志，不退出进程
 // 退出会导致 stdio 断开，整个 MCP 不可用直到 IDE 重启；单次请求错误不应拖死服务
-process.on('unhandledRejection', (err) => console.error('[unhandledRejection]', err));
-process.on('uncaughtException', (err) => console.error('[uncaughtException]', err));
+process.on('unhandledRejection', (err) => log(`[unhandledRejection] ${err && err.stack || err}`));
+process.on('uncaughtException', (err) => log(`[uncaughtException] ${err && err.stack || err}`));
 
 // 创建 MCP Server
 const server = new Server(
   {
     name: 'mcp-log-query',
-    version: '3.5.1',
+    version: '3.5.3',
   },
   {
     capabilities: {
@@ -339,11 +350,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
   const startTime = Date.now();
+  log(`[Tool] → ${name} start args=${safeStringify(args)}`);
 
   // 看门狗：仅记录长时间未完成的请求，不再退出进程
   // withTimeout(REQUEST_TIMEOUT) 已经保证单次请求超时会抛错
   const watchdog = setTimeout(() => {
-    console.error(`[Watchdog] ${name} 仍在运行超过 ${WATCHDOG_WARN_TIMEOUT}ms（仅记录，不退出进程）`);
+    log(`[Watchdog] ${name} 仍在运行超过 ${WATCHDOG_WARN_TIMEOUT}ms（仅记录，不退出进程）`);
   }, WATCHDOG_WARN_TIMEOUT);
   watchdog.unref();
 
@@ -354,11 +366,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       name
     );
     clearTimeout(watchdog);
-    console.error(`[MCP] ${name} ${Date.now() - startTime}ms`);
+    log(`[Tool] ✓ ${name} done ${Date.now() - startTime}ms`);
     return result;
   } catch (error) {
     clearTimeout(watchdog);
-    console.error(`[Error] ${name} ${Date.now() - startTime}ms: ${error.message}`);
+    log(`[Tool] ✗ ${name} FAIL ${Date.now() - startTime}ms: ${error.message}`);
     return {
       content: [{ type: 'text', text: `## 执行错误\n\n❌ ${error.message}` }],
       isError: true
@@ -834,20 +846,22 @@ process.on('SIGTERM', gracefulShutdown);
 async function main() {
   // 对齐 auggie: 监听 stdin end/close，宿主进程断开时优雅关闭
   process.stdin.on('end', () => {
-    console.error('[MCP] stdin end, initiating graceful shutdown');
+    log('[MCP] stdin end, initiating graceful shutdown');
     gracefulShutdown();
   });
   process.stdin.on('close', () => {
-    console.error('[MCP] stdin close, initiating graceful shutdown');
+    log('[MCP] stdin close, initiating graceful shutdown');
     gracefulShutdown();
   });
 
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error('[MCP] Log Query Server v3.5.1 已启动 (超时保护 + SSH 并发限制 + 排队超时 + 进程不自杀 + stdin 优雅关闭)');
+  const logPath = getLogFilePath();
+  log(`[MCP] Log Query Server v3.5.3 已启动 (SSH排队超时 + Loki体超时 + 文件日志)`);
+  if (logPath) log(`[MCP] 本地日志文件: ${logPath}`);
 }
 
 main().catch((error) => {
-  console.error('[MCP] 启动失败:', error);
+  log(`[MCP] 启动失败: ${error && error.stack || error}`);
   process.exit(1);
 });

package/logger.js

@@ -0,0 +1,91 @@
+/**
+ * 轻量日志模块：console.error + 本地文件追加
+ *
+ * 为什么需要文件日志？
+ * Windsurf 不会把 MCP server 的 stderr 落盘到 %APPDATA%\Windsurf\logs，
+ * 只在 Output 面板实时显示。一旦进程重启、面板关闭，信息就丢了。
+ *
+ * 用法：
+ *   import { log } from './logger.js';
+ *   log('[SSH-Sem] acquire ...');
+ *
+ * 诊断卡住时：
+ *   Get-Content $env:TEMP\mcp-log-query.log -Tail 20 -Wait   (Windows)
+ *   tail -F /tmp/mcp-log-query.log                           (Linux/Mac)
+ *
+ * 环境变量：
+ * - MCP_LOG_FILE: 自定义日志文件路径（默认 <tmpdir>/mcp-log-query.log）
+ * - MCP_LOG_MAX_BYTES: 单文件最大字节数（默认 10MB，超过则轮转到 .1）
+ * - MCP_LOG_DISABLE: 设为 '1' 则禁用文件日志（只走 stderr）
+ */
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+const LOG_FILE = process.env.MCP_LOG_FILE || path.join(os.tmpdir(), 'mcp-log-query.log');
+const MAX_BYTES = parseInt(process.env.MCP_LOG_MAX_BYTES || `${10 * 1024 * 1024}`, 10);
+const DISABLED = process.env.MCP_LOG_DISABLE === '1';
+
+// 懒初始化：首次写入时再检查目录
+let initialized = false;
+
+function ensureInit() {
+  if (initialized) return;
+  initialized = true;
+  if (DISABLED) return;
+  try {
+    fs.mkdirSync(path.dirname(LOG_FILE), { recursive: true });
+    // 启动时打一条 banner，方便判断是不是新进程
+    fs.appendFileSync(
+      LOG_FILE,
+      `\n========== [${new Date().toISOString()}] MCP log-query 进程启动 pid=${process.pid} ==========\n`
+    );
+  } catch (err) {
+    console.error('[logger] 初始化文件日志失败，仅使用 stderr:', err.message);
+  }
+}
+
+function rotateIfNeeded() {
+  try {
+    const st = fs.statSync(LOG_FILE);
+    if (st.size < MAX_BYTES) return;
+    const backup = `${LOG_FILE}.1`;
+    try { fs.rmSync(backup, { force: true }); } catch {}
+    try { fs.renameSync(LOG_FILE, backup); } catch {}
+  } catch {
+    // 文件不存在等错误忽略
+  }
+}
+
+/**
+ * 写一条日志：stderr + 可选本地文件
+ * @param {string} msg - 日志内容（不需要带时间戳，本函数自动加）
+ */
+export function log(msg) {
+  // stderr 永远写，兼容 Windsurf Output 面板实时查看
+  console.error(msg);
+
+  if (DISABLED) return;
+
+  ensureInit();
+
+  const line = `[${new Date().toISOString()}] ${msg}\n`;
+  try {
+    rotateIfNeeded();
+    fs.appendFileSync(LOG_FILE, line);
+  } catch (err) {
+    // 文件写失败不能影响主流程，但 stderr 提示一次
+    if (!log._warnedFileFail) {
+      log._warnedFileFail = true;
+      console.error('[logger] 写日志文件失败（后续不再提示）:', err.message);
+    }
+  }
+}
+
+/**
+ * 获取当前日志文件路径（方便 MCP 工具返回给调用方）
+ */
+export function getLogFilePath() {
+  return DISABLED ? null : LOG_FILE;
+}

package/loki-client.js

@@ -1,483 +1,488 @@
-/**
- * Grafana Loki API 客户端
- *
- * 通过 Grafana 代理接口查询 Loki 日志，支持：
- * - 日志查询（LogQL）
- * - 标签/标签值获取
- * - traceId 自动提取
- * - 服务名自动识别（从 filename 标签解析）
- * - 时间范围自动递进（1h → 24h → 72h → 7d）
- */
-
-import { LOKI_ENVIRONMENTS, LOKI_DEFAULTS } from './config.js';
-
-// Loki 查询超时（毫秒）
-const LOKI_FETCH_TIMEOUT = 30000;
-
-// 时间范围自动递进策略（毫秒）
-const AUTO_RANGE_STEPS = [
-  { range: 5 * 60 * 1000,            label: '5 分钟' },
-  { range: 30 * 60 * 1000,           label: '30 分钟' },
-  { range: 1 * 60 * 60 * 1000,       label: '1 小时' },
-  { range: 3 * 60 * 60 * 1000,       label: '3 小时' },
-  { range: 24 * 60 * 60 * 1000,      label: '24 小时' },
-];
-
-// ============================================================
-// 核心查询
-// ============================================================
-
-/**
- * 执行 Loki 日志查询
- * @param {string} envName - 环境名称，如 'cms'
- * @param {string} expr - LogQL 表达式
- * @param {Object} options - 查询选项
- * @param {number} options.from - 起始时间（毫秒时间戳），默认 1 小时前
- * @param {number} options.to - 结束时间（毫秒时间戳），默认当前
- * @param {number} options.maxLines - 最大返回行数，默认 100
- * @param {string} options.direction - 排序方向 'backward'|'forward'，默认 'backward'
- * @returns {Object} { logs: string[], labels: Object[], traceIds: string[], stats: Object }
- */
-export async function queryLoki(envName, expr, options = {}) {
-  const env = getLokiEnv(envName);
-  const now = Date.now();
-  const from = options.from || (now - LOKI_DEFAULTS.defaultTimeRange);
-  const to = options.to || now;
-  const maxLines = options.maxLines || LOKI_DEFAULTS.maxLines;
-  const direction = options.direction || 'backward';
-
-  const url = `${env.grafanaUrl}/api/ds/query?ds_type=loki`;
-  const body = {
-    queries: [{
-      refId: 'A',
-      expr,
-      queryType: 'range',
-      datasource: { type: 'loki', uid: env.datasourceUid },
-      editorMode: 'builder',
-      direction,
-      maxLines,
-      datasourceId: env.datasourceId,
-      intervalMs: 1000,
-      maxDataPoints: 1000
-    }],
-    from: String(from),
-    to: String(to)
-  };
-
-  console.error(`[Loki] 查询: env=${envName}, expr=${expr}`);
-
-  // 带超时的 fetch
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), LOKI_FETCH_TIMEOUT);
-
-  let resp;
-  try {
-    resp = await fetch(url, {
-      method: 'POST',
-      headers: buildHeaders(env),
-      body: JSON.stringify(body),
-      signal: controller.signal
-    });
-  } catch (e) {
-    clearTimeout(timer);
-    if (e.name === 'AbortError') {
-      throw new Error(`Loki 查询超时（${LOKI_FETCH_TIMEOUT}ms）`);
-    }
-    throw e;
-  } finally {
-    clearTimeout(timer);
-  }
-
-  if (!resp.ok) {
-    const text = await resp.text();
-    throw new Error(`Loki 查询失败 (${resp.status}): ${text}`);
-  }
-
-  const data = await resp.json();
-  return parseLokiResponse(data);
-}
-
-/**
- * 带时间范围自动递进的 Loki 查询
- *
- * 策略：1h → 24h → 72h → 7d，找到结果立即返回
- * 如果用户指定了 from/to，则直接使用指定范围，不递进
- *
- * @param {string} envName - 环境名称
- * @param {string} expr - LogQL 表达式
- * @param {Object} options - 查询选项
- * @param {number} options.from - 起始时间戳（毫秒），指定后不递进
- * @param {number} options.to - 结束时间戳（毫秒），指定后不递进
- * @param {number} options.maxLines - 最大返回行数
- * @param {string} options.direction - 排序方向
- * @returns {Object} { logs, labels, traceIds, stats, timeRange: { label, from, to } }
- */
-export async function queryLokiAutoRange(envName, expr, options = {}) {
-  // 如果用户明确指定了 from/to，直接查询不递进
-  if (options.from && options.to) {
-    console.error(`[Loki] 使用指定时间范围查询: ${new Date(options.from).toLocaleString()} ~ ${new Date(options.to).toLocaleString()}`);
-    try {
-      const result = await queryLoki(envName, expr, options);
-      result.timeRange = { label: '自定义', from: options.from, to: options.to };
-      return result;
-    } catch (e) {
-      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
-      console.error(`[Loki] ❌ 指定时间范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
-      return {
-        logs: [], labels: [], traceIds: [], stats: null,
-        timeRange: { label: '自定义', from: options.from, to: options.to },
-        notFound: true,
-        error: isTimeout
-          ? '查询超时（数据量过大），请缩小时间范围或指定具体服务'
-          : `查询失败: ${e.message.substring(0, 200)}`
-      };
-    }
-  }
-
-  // 自动递进：从小范围到大范围
-  const now = Date.now();
-  for (const step of AUTO_RANGE_STEPS) {
-    const from = now - step.range;
-    const to = now;
-
-    console.error(`[Loki] 自动递进: 尝试 ${step.label} 范围...`);
-
-    try {
-      const result = await queryLoki(envName, expr, { ...options, from, to });
-
-      if (result.logs.length > 0) {
-        console.error(`[Loki] ✅ 在 ${step.label} 范围内找到 ${result.logs.length} 行日志`);
-        result.timeRange = { label: step.label, from, to };
-        return result;
-      }
-
-      console.error(`[Loki] ⏭️ ${step.label} 范围内无结果，扩大范围...`);
-    } catch (e) {
-      // 查询超时或失败，停止递进，返回优雅降级结果
-      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
-      console.error(`[Loki] ⚠️ ${step.label} 范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
-      return {
-        logs: [], labels: [], traceIds: [], stats: null,
-        timeRange: { label: step.label, from, to },
-        notFound: true,
-        error: isTimeout
-          ? `查询在递进到 ${step.label} 范围时超时（数据量过大），请缩小时间范围或指定具体服务查询`
-          : `查询在递进到 ${step.label} 范围时失败: ${e.message.substring(0, 200)}`
-      };
-    }
-  }
-
-  // 所有范围都没找到
-  console.error(`[Loki] ❌ 所有时间范围均未找到结果`);
-  return {
-    logs: [],
-    labels: [],
-    traceIds: [],
-    stats: null,
-    timeRange: { label: '未找到', from: null, to: null },
-    notFound: true
-  };
-}
-
-/**
- * 解析用户传入的时间字符串为毫秒时间戳
- * 支持格式: "2026-02-06 12:00:00", "2026-02-06", ISO 8601 等
- * @param {string} timeStr - 时间字符串
- * @returns {number|null} 毫秒时间戳，解析失败返回 null
- */
-export function parseTimeStr(timeStr) {
-  if (!timeStr) return null;
-  // 如果是纯数字，当作时间戳
-  if (/^\d{10,13}$/.test(timeStr)) {
-    const ts = parseInt(timeStr);
-    return ts < 1e12 ? ts * 1000 : ts; // 秒 → 毫秒
-  }
-  const d = new Date(timeStr);
-  return isNaN(d.getTime()) ? null : d.getTime();
-}
-
-// ============================================================
-// 标签查询
-// ============================================================
-
-/** 获取 Loki 标签列表 */
-export async function getLokiLabels(envName) {
-  const env = getLokiEnv(envName);
-  const now = Date.now();
-  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
-  const end = now * 1_000_000;
-  const url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/labels?start=${start}&end=${end}`;
-  const resp = await fetch(url, { headers: buildHeaders(env) });
-  if (!resp.ok) throw new Error(`获取标签失败 (${resp.status})`);
-  const data = await resp.json();
-  return data.data || [];
-}
-
-/** 获取 Loki 标签值 */
-export async function getLokiLabelValues(envName, label, query = '') {
-  const env = getLokiEnv(envName);
-  const now = Date.now();
-  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
-  const end = now * 1_000_000;
-  let url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/label/${label}/values?start=${start}&end=${end}`;
-  if (query) url += `&query=${encodeURIComponent(query)}`;
-  const resp = await fetch(url, { headers: buildHeaders(env) });
-  if (!resp.ok) throw new Error(`获取标签值失败 (${resp.status})`);
-  const data = await resp.json();
-  return data.data || [];
-}
-
-// ============================================================
-// 响应解析
-// ============================================================
-
-/** 解析 Grafana Loki 查询响应 */
-export function parseLokiResponse(data) {
-  const result = { logs: [], labels: [], traceIds: [], stats: null };
-  const frames = data?.results?.A?.frames;
-  if (!frames || frames.length === 0) return result;
-
-  for (const frame of frames) {
-    const values = frame?.data?.values;
-    if (!values || values.length < 3) continue;
-    // values[0]: 标签数组, values[1]: 时间戳数组, values[2]: 日志行数组
-    const labelsArr = values[0] || [];
-    const linesArr = values[2] || [];
-    for (let i = 0; i < linesArr.length; i++) {
-      result.logs.push(linesArr[i]);
-      result.labels.push(labelsArr[i] || {});
-    }
-  }
-
-  result.traceIds = extractTraceIds(result.logs);
-
-  const stats = frames[0]?.schema?.meta?.stats;
-  if (stats) {
-    result.stats = {};
-    for (const s of stats) { result.stats[s.displayName] = s.value; }
-  }
-  return result;
-}
-
-// ============================================================
-// traceId 提取
-// ============================================================
-
-/**
- * 从日志行中提取 traceId（32位十六进制，在方括号中）
- * 日志格式: [clife-senior] 时间 级别 [服务] [pod] [线程] [OT-spanId] [traceId] 类名 - 内容
- */
-export function extractTraceIds(lines) {
-  const traceIdSet = new Set();
-
-  const regex = /\[([a-f0-9]{32})\]/gi;
-  for (const line of lines) {
-    let match;
-    while ((match = regex.exec(line)) !== null) {
-      traceIdSet.add(match[1].toLowerCase());
-    }
-    regex.lastIndex = 0;
-  }
-  return [...traceIdSet];
-}
-
-// ============================================================
-// 服务名解析
-// ============================================================
-
-/**
- * 从 Loki filename 标签中解析服务名
- * filename 格式: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
- * 解析结果: clife-senior-health
- */
-export function parseServiceFromFilename(filename) {
-  if (!filename) return null;
-  // 匹配 /{service-name}-app/ 或 /{service-name}-service/ 模式
-  const match = filename.match(/\/(clife-senior-[a-zA-Z0-9-]+?)(?:-app|-service)\//);
-  if (match) return match[1];
-  // 兜底：匹配非 clife-senior 前缀的服务（如 device-manage-service）
-  const match2 = filename.match(/\/([a-zA-Z0-9-]+?)(?:-app|-service)\//);
-  if (match2) return match2[1];
-  return null;
-}
-
-/**
- * 将查询结果按服务分组
- * @param {Object} lokiResult - parseLokiResponse 的返回值
- * @returns {Object} { serviceName: { logs: string[], traceIds: string[] } }
- */
-export function groupLogsByService(lokiResult) {
-  const groups = {};
-
-  for (let i = 0; i < lokiResult.logs.length; i++) {
-    const label = lokiResult.labels[i] || {};
-    const serviceName = parseServiceFromFilename(label.filename) || 'unknown';
-    const logLine = lokiResult.logs[i];
-
-    if (!groups[serviceName]) {
-      groups[serviceName] = { logs: [], traceIds: new Set() };
-    }
-    groups[serviceName].logs.push(logLine);
-
-    // 从该行提取 traceId
-    const ids = extractTraceIds([logLine]);
-    ids.forEach(id => groups[serviceName].traceIds.add(id));
-  }
-
-  // Set → Array
-  for (const key of Object.keys(groups)) {
-    groups[key].traceIds = [...groups[key].traceIds];
-  }
-
-  return groups;
-}
-
-// ============================================================
-// LogQL 构建辅助
-// ============================================================
-
-/**
- * 构建按服务查询的 LogQL 表达式
- * 根据环境是否有 project 标签，自动选择不同的 filename 路径格式：
- *   - 有 project 标签（CMS）: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
- *   - 无 project 标签（私有化）: /data/services/logs/clife-senior-health-app/normal_logs/normal.log
- *
- * @param {string} project - 项目名，如 'senior'
- * @param {string} servicePodPattern - 服务目录名，如 'clife-senior-health-app'
- * @param {string} keyword - 搜索关键词（可选）
- * @param {string} envName - 环境名称，如 'cms'、'chengyang'
- */
-export function buildServiceLogQL(project, servicePodPattern, keyword = '', envName = '') {
-  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
-  const hasProject = env ? env.hasProjectLabel !== false : true;
-
-  // CMS: /data/services/logs/senior/xxx-app/...  私有化: /data/services/logs/xxx-app/...
-  const filename = hasProject
-    ? `/data/services/logs/${project}/${servicePodPattern}/normal_logs/normal.log`
-    : `/data/services/logs/${servicePodPattern}/normal_logs/normal.log`;
-
-  let expr = `{filename="${filename}"}`;
-  if (keyword) {
-    expr += ` |= \`${keyword}\``;
-  }
-  return expr;
-}
-
-/**
- * 构建按项目查询的 LogQL 表达式（搜索整个项目所有服务）
- * 根据环境是否有 project 标签，自动选择不同的查询方式：
- *   - 有 project 标签（CMS）: {project="senior"} |= `keyword`
- *   - 无 project 标签（私有化）: {filename=~"/data/services/logs/clife-senior-.*normal.log"} |= `keyword`
- *
- * @param {string} project - 项目名，如 'senior'
- * @param {string} keyword - 搜索关键词
- * @param {string} envName - 环境名称，如 'cms'、'chengyang'
- */
-export function buildProjectLogQL(project, keyword, envName = '') {
-  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
-  const hasProject = env ? env.hasProjectLabel !== false : true;
-
-  if (hasProject) {
-    // CMS: 直接用 project 标签，高效精确
-    return `{project="${project}"} |= \`${keyword}\``;
-  } else {
-    // 私有化: 用 filename 正则匹配所有 clife-{project}-* 服务的 normal.log
-    return `{filename=~"/data/services/logs/clife-${project}-.*normal.log"} |= \`${keyword}\``;
-  }
-}
-
-// ============================================================
-// 内部辅助函数
-// ============================================================
-
-/** 获取 Loki 环境配置 */
-function getLokiEnv(envName) {
-  const env = LOKI_ENVIRONMENTS[envName];
-  if (!env) {
-    const available = Object.keys(LOKI_ENVIRONMENTS).join(', ');
-    throw new Error(`未知的 Loki 环境 "${envName}"，可用环境: ${available}`);
-  }
-  return env;
-}
-
-/** 构建请求头 */
-function buildHeaders(env) {
-  const headers = {
-    'Content-Type': 'application/json',
-    'Accept': 'application/json',
-    'x-grafana-org-id': String(env.orgId || 1),
-    'x-plugin-id': 'loki',
-    'x-datasource-uid': env.datasourceUid
-  };
-
-  // 如果配置了认证信息，添加 Basic Auth
-  if (env.username && env.password) {
-    const auth = Buffer.from(`${env.username}:${env.password}`).toString('base64');
-    headers['Authorization'] = `Basic ${auth}`;
-  }
-
-  return headers;
-}
-
-// ============================================================
-// 公共辅助函数
-// ============================================================
-
-/** 获取所有可用的 Loki 环境列表 */
-export function listLokiEnvironments() {
-  return Object.entries(LOKI_ENVIRONMENTS).map(([key, env]) => ({
-    name: key,
-    description: env.description,
-    grafanaUrl: env.grafanaUrl,
-    project: env.defaultProject
-  }));
-}
-
-/**
- * 获取指定环境下的服务列表（从 Loki filename 标签动态获取）
- * 根据环境是否有 project 标签，使用不同的查询方式：
- *   - 有 project 标签（CMS）: 用 {project="senior"} 过滤
- *   - 无 project 标签（私有化）: 获取全部 filename 后按 clife-{project}- 前缀过滤
- *
- * @param {string} envName - 环境名称
- * @param {string} project - 项目名，如 'senior'
- * @returns {string[]} 服务名列表
- */
-export async function listLokiServices(envName, project = 'senior') {
-  const env = LOKI_ENVIRONMENTS[envName];
-  const hasProject = env ? env.hasProjectLabel !== false : true;
-
-  let filenames;
-  if (hasProject) {
-    // CMS: 直接用 project 标签过滤
-    filenames = await getLokiLabelValues(envName, 'filename', `{project="${project}"}`);
-  } else {
-    // 私有化: 获取全部 filename，然后按 clife-{project}- 前缀过滤
-    filenames = await getLokiLabelValues(envName, 'filename');
-    filenames = filenames.filter(f => f.includes(`/clife-${project}-`));
-  }
-
-  const serviceSet = new Set();
-  for (const f of filenames) {
-    if (!f.includes('/normal_logs/normal.log')) continue;
-    const svc = parseServiceFromFilename(f);
-    if (svc) serviceSet.add(svc);
-  }
-
-  return [...serviceSet].sort();
-}
-
-/**
- * 根据服务简称获取 Loki 中的服务目录名
- * 例如: 'health' → 'clife-senior-health-app'
- * @param {string} serviceName - 服务简称，如 'health', 'core', 'gateway'
- * @returns {string} 服务目录名
- */
-export function getLokiServiceDirName(serviceName) {
-  // 如果已经是完整名称，直接返回
-  if (serviceName.startsWith('clife-senior-')) {
-    return serviceName.endsWith('-app') ? serviceName : `${serviceName}-app`;
-  }
-  // 简称转完整名称
-  return `clife-senior-${serviceName}-app`;
-}
+/**
+ * Grafana Loki API 客户端
+ *
+ * 通过 Grafana 代理接口查询 Loki 日志，支持：
+ * - 日志查询（LogQL）
+ * - 标签/标签值获取
+ * - traceId 自动提取
+ * - 服务名自动识别（从 filename 标签解析）
+ * - 时间范围自动递进（1h → 24h → 72h → 7d）
+ */
+
+import { LOKI_ENVIRONMENTS, LOKI_DEFAULTS } from './config.js';
+import { log } from './logger.js';
+
+// Loki 查询超时（毫秒）
+const LOKI_FETCH_TIMEOUT = 30000;
+
+// 时间范围自动递进策略（毫秒）
+const AUTO_RANGE_STEPS = [
+  { range: 5 * 60 * 1000,            label: '5 分钟' },
+  { range: 30 * 60 * 1000,           label: '30 分钟' },
+  { range: 1 * 60 * 60 * 1000,       label: '1 小时' },
+  { range: 3 * 60 * 60 * 1000,       label: '3 小时' },
+  { range: 24 * 60 * 60 * 1000,      label: '24 小时' },
+];
+
+// ============================================================
+// 核心查询
+// ============================================================
+
+/**
+ * 执行 Loki 日志查询
+ * @param {string} envName - 环境名称，如 'cms'
+ * @param {string} expr - LogQL 表达式
+ * @param {Object} options - 查询选项
+ * @param {number} options.from - 起始时间（毫秒时间戳），默认 1 小时前
+ * @param {number} options.to - 结束时间（毫秒时间戳），默认当前
+ * @param {number} options.maxLines - 最大返回行数，默认 100
+ * @param {string} options.direction - 排序方向 'backward'|'forward'，默认 'backward'
+ * @returns {Object} { logs: string[], labels: Object[], traceIds: string[], stats: Object }
+ */
+export async function queryLoki(envName, expr, options = {}) {
+  const env = getLokiEnv(envName);
+  const now = Date.now();
+  const from = options.from || (now - LOKI_DEFAULTS.defaultTimeRange);
+  const to = options.to || now;
+  const maxLines = options.maxLines || LOKI_DEFAULTS.maxLines;
+  const direction = options.direction || 'backward';
+
+  const url = `${env.grafanaUrl}/api/ds/query?ds_type=loki`;
+  const body = {
+    queries: [{
+      refId: 'A',
+      expr,
+      queryType: 'range',
+      datasource: { type: 'loki', uid: env.datasourceUid },
+      editorMode: 'builder',
+      direction,
+      maxLines,
+      datasourceId: env.datasourceId,
+      intervalMs: 1000,
+      maxDataPoints: 1000
+    }],
+    from: String(from),
+    to: String(to)
+  };
+
+  log(`[Loki] 查询: env=${envName}, expr=${expr}`);
+
+  // 带超时的 fetch —— AbortController 覆盖 fetch + body 读取全过程
+  // 之前的 bug：fetch resolve 后立刻 clearTimeout，导致 resp.json() 读 body 卡住时无保护
+  const controller = new AbortController();
+  const timer = setTimeout(() => {
+    log(`[Loki] ⏱ 超时 ${LOKI_FETCH_TIMEOUT}ms，主动 abort: env=${envName}, expr=${expr.substring(0, 80)}`);
+    controller.abort();
+  }, LOKI_FETCH_TIMEOUT);
+
+  try {
+    const resp = await fetch(url, {
+      method: 'POST',
+      headers: buildHeaders(env),
+      body: JSON.stringify(body),
+      signal: controller.signal
+    });
+
+    if (!resp.ok) {
+      // 读错误响应体同样受 signal 保护
+      const text = await resp.text();
+      throw new Error(`Loki 查询失败 (${resp.status}): ${text}`);
+    }
+
+    // 读 body 仍在 controller.signal 保护之下：body 卡住会被 abort
+    const data = await resp.json();
+    return parseLokiResponse(data);
+  } catch (e) {
+    if (e.name === 'AbortError') {
+      throw new Error(`Loki 查询超时（${LOKI_FETCH_TIMEOUT}ms）`);
+    }
+    throw e;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/**
+ * 带时间范围自动递进的 Loki 查询
+ *
+ * 策略：1h → 24h → 72h → 7d，找到结果立即返回
+ * 如果用户指定了 from/to，则直接使用指定范围，不递进
+ *
+ * @param {string} envName - 环境名称
+ * @param {string} expr - LogQL 表达式
+ * @param {Object} options - 查询选项
+ * @param {number} options.from - 起始时间戳（毫秒），指定后不递进
+ * @param {number} options.to - 结束时间戳（毫秒），指定后不递进
+ * @param {number} options.maxLines - 最大返回行数
+ * @param {string} options.direction - 排序方向
+ * @returns {Object} { logs, labels, traceIds, stats, timeRange: { label, from, to } }
+ */
+export async function queryLokiAutoRange(envName, expr, options = {}) {
+  // 如果用户明确指定了 from/to，直接查询不递进
+  if (options.from && options.to) {
+    log(`[Loki] 使用指定时间范围查询: ${new Date(options.from).toLocaleString()} ~ ${new Date(options.to).toLocaleString()}`);
+    try {
+      const result = await queryLoki(envName, expr, options);
+      result.timeRange = { label: '自定义', from: options.from, to: options.to };
+      return result;
+    } catch (e) {
+      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
+      log(`[Loki] ❌ 指定时间范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
+      return {
+        logs: [], labels: [], traceIds: [], stats: null,
+        timeRange: { label: '自定义', from: options.from, to: options.to },
+        notFound: true,
+        error: isTimeout
+          ? '查询超时（数据量过大），请缩小时间范围或指定具体服务'
+          : `查询失败: ${e.message.substring(0, 200)}`
+      };
+    }
+  }
+
+  // 自动递进：从小范围到大范围
+  const now = Date.now();
+  for (const step of AUTO_RANGE_STEPS) {
+    const from = now - step.range;
+    const to = now;
+
+    log(`[Loki] 自动递进: 尝试 ${step.label} 范围...`);
+
+    try {
+      const result = await queryLoki(envName, expr, { ...options, from, to });
+
+      if (result.logs.length > 0) {
+        log(`[Loki] ✅ 在 ${step.label} 范围内找到 ${result.logs.length} 行日志`);
+        result.timeRange = { label: step.label, from, to };
+        return result;
+      }
+
+      log(`[Loki] ⏭️ ${step.label} 范围内无结果，扩大范围...`);
+    } catch (e) {
+      // 查询超时或失败，停止递进，返回优雅降级结果
+      const isTimeout = e.message.includes('timeout') || e.message.includes('504') || e.message.includes('Timeout');
+      log(`[Loki] ⚠️ ${step.label} 范围查询${isTimeout ? '超时' : '失败'}: ${e.message.substring(0, 200)}`);
+      return {
+        logs: [], labels: [], traceIds: [], stats: null,
+        timeRange: { label: step.label, from, to },
+        notFound: true,
+        error: isTimeout
+          ? `查询在递进到 ${step.label} 范围时超时（数据量过大），请缩小时间范围或指定具体服务查询`
+          : `查询在递进到 ${step.label} 范围时失败: ${e.message.substring(0, 200)}`
+      };
+    }
+  }
+
+  // 所有范围都没找到
+  log(`[Loki] ❌ 所有时间范围均未找到结果`);
+  return {
+    logs: [],
+    labels: [],
+    traceIds: [],
+    stats: null,
+    timeRange: { label: '未找到', from: null, to: null },
+    notFound: true
+  };
+}
+
+/**
+ * 解析用户传入的时间字符串为毫秒时间戳
+ * 支持格式: "2026-02-06 12:00:00", "2026-02-06", ISO 8601 等
+ * @param {string} timeStr - 时间字符串
+ * @returns {number|null} 毫秒时间戳，解析失败返回 null
+ */
+export function parseTimeStr(timeStr) {
+  if (!timeStr) return null;
+  // 如果是纯数字，当作时间戳
+  if (/^\d{10,13}$/.test(timeStr)) {
+    const ts = parseInt(timeStr);
+    return ts < 1e12 ? ts * 1000 : ts; // 秒 → 毫秒
+  }
+  const d = new Date(timeStr);
+  return isNaN(d.getTime()) ? null : d.getTime();
+}
+
+// ============================================================
+// 标签查询
+// ============================================================
+
+/** 获取 Loki 标签列表 */
+export async function getLokiLabels(envName) {
+  const env = getLokiEnv(envName);
+  const now = Date.now();
+  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
+  const end = now * 1_000_000;
+  const url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/labels?start=${start}&end=${end}`;
+  const resp = await fetch(url, { headers: buildHeaders(env) });
+  if (!resp.ok) throw new Error(`获取标签失败 (${resp.status})`);
+  const data = await resp.json();
+  return data.data || [];
+}
+
+/** 获取 Loki 标签值 */
+export async function getLokiLabelValues(envName, label, query = '') {
+  const env = getLokiEnv(envName);
+  const now = Date.now();
+  const start = (now - LOKI_DEFAULTS.defaultTimeRange) * 1_000_000;
+  const end = now * 1_000_000;
+  let url = `${env.grafanaUrl}/api/datasources/uid/${env.datasourceUid}/resources/label/${label}/values?start=${start}&end=${end}`;
+  if (query) url += `&query=${encodeURIComponent(query)}`;
+  const resp = await fetch(url, { headers: buildHeaders(env) });
+  if (!resp.ok) throw new Error(`获取标签值失败 (${resp.status})`);
+  const data = await resp.json();
+  return data.data || [];
+}
+
+// ============================================================
+// 响应解析
+// ============================================================
+
+/** 解析 Grafana Loki 查询响应 */
+export function parseLokiResponse(data) {
+  const result = { logs: [], labels: [], traceIds: [], stats: null };
+  const frames = data?.results?.A?.frames;
+  if (!frames || frames.length === 0) return result;
+
+  for (const frame of frames) {
+    const values = frame?.data?.values;
+    if (!values || values.length < 3) continue;
+    // values[0]: 标签数组, values[1]: 时间戳数组, values[2]: 日志行数组
+    const labelsArr = values[0] || [];
+    const linesArr = values[2] || [];
+    for (let i = 0; i < linesArr.length; i++) {
+      result.logs.push(linesArr[i]);
+      result.labels.push(labelsArr[i] || {});
+    }
+  }
+
+  result.traceIds = extractTraceIds(result.logs);
+
+  const stats = frames[0]?.schema?.meta?.stats;
+  if (stats) {
+    result.stats = {};
+    for (const s of stats) { result.stats[s.displayName] = s.value; }
+  }
+  return result;
+}
+
+// ============================================================
+// traceId 提取
+// ============================================================
+
+/**
+ * 从日志行中提取 traceId（32位十六进制，在方括号中）
+ * 日志格式: [clife-senior] 时间 级别 [服务] [pod] [线程] [OT-spanId] [traceId] 类名 - 内容
+ */
+export function extractTraceIds(lines) {
+  const traceIdSet = new Set();
+
+  const regex = /\[([a-f0-9]{32})\]/gi;
+  for (const line of lines) {
+    let match;
+    while ((match = regex.exec(line)) !== null) {
+      traceIdSet.add(match[1].toLowerCase());
+    }
+    regex.lastIndex = 0;
+  }
+  return [...traceIdSet];
+}
+
+// ============================================================
+// 服务名解析
+// ============================================================
+
+/**
+ * 从 Loki filename 标签中解析服务名
+ * filename 格式: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
+ * 解析结果: clife-senior-health
+ */
+export function parseServiceFromFilename(filename) {
+  if (!filename) return null;
+  // 匹配 /{service-name}-app/ 或 /{service-name}-service/ 模式
+  const match = filename.match(/\/(clife-senior-[a-zA-Z0-9-]+?)(?:-app|-service)\//);
+  if (match) return match[1];
+  // 兜底：匹配非 clife-senior 前缀的服务（如 device-manage-service）
+  const match2 = filename.match(/\/([a-zA-Z0-9-]+?)(?:-app|-service)\//);
+  if (match2) return match2[1];
+  return null;
+}
+
+/**
+ * 将查询结果按服务分组
+ * @param {Object} lokiResult - parseLokiResponse 的返回值
+ * @returns {Object} { serviceName: { logs: string[], traceIds: string[] } }
+ */
+export function groupLogsByService(lokiResult) {
+  const groups = {};
+
+  for (let i = 0; i < lokiResult.logs.length; i++) {
+    const label = lokiResult.labels[i] || {};
+    const serviceName = parseServiceFromFilename(label.filename) || 'unknown';
+    const logLine = lokiResult.logs[i];
+
+    if (!groups[serviceName]) {
+      groups[serviceName] = { logs: [], traceIds: new Set() };
+    }
+    groups[serviceName].logs.push(logLine);
+
+    // 从该行提取 traceId
+    const ids = extractTraceIds([logLine]);
+    ids.forEach(id => groups[serviceName].traceIds.add(id));
+  }
+
+  // Set → Array
+  for (const key of Object.keys(groups)) {
+    groups[key].traceIds = [...groups[key].traceIds];
+  }
+
+  return groups;
+}
+
+// ============================================================
+// LogQL 构建辅助
+// ============================================================
+
+/**
+ * 构建按服务查询的 LogQL 表达式
+ * 根据环境是否有 project 标签，自动选择不同的 filename 路径格式：
+ *   - 有 project 标签（CMS）: /data/services/logs/senior/clife-senior-health-app/normal_logs/normal.log
+ *   - 无 project 标签（私有化）: /data/services/logs/clife-senior-health-app/normal_logs/normal.log
+ *
+ * @param {string} project - 项目名，如 'senior'
+ * @param {string} servicePodPattern - 服务目录名，如 'clife-senior-health-app'
+ * @param {string} keyword - 搜索关键词（可选）
+ * @param {string} envName - 环境名称，如 'cms'、'chengyang'
+ */
+export function buildServiceLogQL(project, servicePodPattern, keyword = '', envName = '') {
+  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
+  const hasProject = env ? env.hasProjectLabel !== false : true;
+
+  // CMS: /data/services/logs/senior/xxx-app/...  私有化: /data/services/logs/xxx-app/...
+  const filename = hasProject
+    ? `/data/services/logs/${project}/${servicePodPattern}/normal_logs/normal.log`
+    : `/data/services/logs/${servicePodPattern}/normal_logs/normal.log`;
+
+  let expr = `{filename="${filename}"}`;
+  if (keyword) {
+    expr += ` |= \`${keyword}\``;
+  }
+  return expr;
+}
+
+/**
+ * 构建按项目查询的 LogQL 表达式（搜索整个项目所有服务）
+ * 根据环境是否有 project 标签，自动选择不同的查询方式：
+ *   - 有 project 标签（CMS）: {project="senior"} |= `keyword`
+ *   - 无 project 标签（私有化）: {filename=~"/data/services/logs/clife-senior-.*normal.log"} |= `keyword`
+ *
+ * @param {string} project - 项目名，如 'senior'
+ * @param {string} keyword - 搜索关键词
+ * @param {string} envName - 环境名称，如 'cms'、'chengyang'
+ */
+export function buildProjectLogQL(project, keyword, envName = '') {
+  const env = envName ? LOKI_ENVIRONMENTS[envName] : null;
+  const hasProject = env ? env.hasProjectLabel !== false : true;
+
+  if (hasProject) {
+    // CMS: 直接用 project 标签，高效精确
+    return `{project="${project}"} |= \`${keyword}\``;
+  } else {
+    // 私有化: 用 filename 正则匹配所有 clife-{project}-* 服务的 normal.log
+    return `{filename=~"/data/services/logs/clife-${project}-.*normal.log"} |= \`${keyword}\``;
+  }
+}
+
+// ============================================================
+// 内部辅助函数
+// ============================================================
+
+/** 获取 Loki 环境配置 */
+function getLokiEnv(envName) {
+  const env = LOKI_ENVIRONMENTS[envName];
+  if (!env) {
+    const available = Object.keys(LOKI_ENVIRONMENTS).join(', ');
+    throw new Error(`未知的 Loki 环境 "${envName}"，可用环境: ${available}`);
+  }
+  return env;
+}
+
+/** 构建请求头 */
+function buildHeaders(env) {
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+    'x-grafana-org-id': String(env.orgId || 1),
+    'x-plugin-id': 'loki',
+    'x-datasource-uid': env.datasourceUid
+  };
+
+  // 如果配置了认证信息，添加 Basic Auth
+  if (env.username && env.password) {
+    const auth = Buffer.from(`${env.username}:${env.password}`).toString('base64');
+    headers['Authorization'] = `Basic ${auth}`;
+  }
+
+  return headers;
+}
+
+// ============================================================
+// 公共辅助函数
+// ============================================================
+
+/** 获取所有可用的 Loki 环境列表 */
+export function listLokiEnvironments() {
+  return Object.entries(LOKI_ENVIRONMENTS).map(([key, env]) => ({
+    name: key,
+    description: env.description,
+    grafanaUrl: env.grafanaUrl,
+    project: env.defaultProject
+  }));
+}
+
+/**
+ * 获取指定环境下的服务列表（从 Loki filename 标签动态获取）
+ * 根据环境是否有 project 标签，使用不同的查询方式：
+ *   - 有 project 标签（CMS）: 用 {project="senior"} 过滤
+ *   - 无 project 标签（私有化）: 获取全部 filename 后按 clife-{project}- 前缀过滤
+ *
+ * @param {string} envName - 环境名称
+ * @param {string} project - 项目名，如 'senior'
+ * @returns {string[]} 服务名列表
+ */
+export async function listLokiServices(envName, project = 'senior') {
+  const env = LOKI_ENVIRONMENTS[envName];
+  const hasProject = env ? env.hasProjectLabel !== false : true;
+
+  let filenames;
+  if (hasProject) {
+    // CMS: 直接用 project 标签过滤
+    filenames = await getLokiLabelValues(envName, 'filename', `{project="${project}"}`);
+  } else {
+    // 私有化: 获取全部 filename，然后按 clife-{project}- 前缀过滤
+    filenames = await getLokiLabelValues(envName, 'filename');
+    filenames = filenames.filter(f => f.includes(`/clife-${project}-`));
+  }
+
+  const serviceSet = new Set();
+  for (const f of filenames) {
+    if (!f.includes('/normal_logs/normal.log')) continue;
+    const svc = parseServiceFromFilename(f);
+    if (svc) serviceSet.add(svc);
+  }
+
+  return [...serviceSet].sort();
+}
+
+/**
+ * 根据服务简称获取 Loki 中的服务目录名
+ * 例如: 'health' → 'clife-senior-health-app'
+ * @param {string} serviceName - 服务简称，如 'health', 'core', 'gateway'
+ * @returns {string} 服务目录名
+ */
+export function getLokiServiceDirName(serviceName) {
+  // 如果已经是完整名称，直接返回
+  if (serviceName.startsWith('clife-senior-')) {
+    return serviceName.endsWith('-app') ? serviceName : `${serviceName}-app`;
+  }
+  // 简称转完整名称
+  return `clife-senior-${serviceName}-app`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-log-query-server",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "description": "MCP Server for querying server logs via SSH jump host and Grafana Loki API",
   "main": "index.js",
   "type": "module",
@@ -12,6 +12,7 @@
     "config.js",
     "ssh-client.js",
     "loki-client.js",
+    "logger.js",
     "server-sse.js",
     "README.md"
   ],

package/ssh-client.js

@@ -15,6 +15,7 @@
 
 import { Client } from 'ssh2';
 import { JUMP_HOST, K8S_SERVER, DEFAULTS } from './config.js';
+import { log } from './logger.js';
 
 // ============================================================
 // 并发信号量：防止同时打开过多堡垒机会话被踢
@@ -39,13 +40,13 @@ const _sshSem = {
 function sshAcquire(timeoutMs = SSH_ACQUIRE_TIMEOUT) {
   if (_sshSem.active < _sshSem.max) {
     _sshSem.active++;
-    console.error(`[SSH-Sem] acquire 直接通过 (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
+    log(`[SSH-Sem] acquire 直接通过 (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
     return Promise.resolve();
   }
   if (_sshSem.queue.length >= _sshSem.queueMax) {
     return Promise.reject(new Error(`SSH 并发队列已满（>${_sshSem.queueMax}），请稍后重试`));
   }
-  console.error(`[SSH-Sem] acquire 进入排队 (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length + 1}, timeout=${timeoutMs}ms)`);
+  log(`[SSH-Sem] acquire 进入排队 (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length + 1}, timeout=${timeoutMs}ms)`);
   return new Promise((resolve, reject) => {
     let settled = false;
     const enterQueue = () => {
@@ -53,7 +54,7 @@ function sshAcquire(timeoutMs = SSH_ACQUIRE_TIMEOUT) {
       settled = true;
       clearTimeout(timer);
       _sshSem.active++;
-      console.error(`[SSH-Sem] acquire 出队获得槽位 (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
+      log(`[SSH-Sem] acquire 出队获得槽位 (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
       resolve();
     };
     _sshSem.queue.push(enterQueue);
@@ -63,7 +64,7 @@ function sshAcquire(timeoutMs = SSH_ACQUIRE_TIMEOUT) {
       // 从队列里移除自己的 entry
       const idx = _sshSem.queue.indexOf(enterQueue);
       if (idx >= 0) _sshSem.queue.splice(idx, 1);
-      console.error(`[SSH-Sem] acquire 排队超时 (${timeoutMs}ms, active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
+      log(`[SSH-Sem] acquire 排队超时 (${timeoutMs}ms, active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
       reject(new Error(`SSH 排队等待超时 (${timeoutMs}ms)：前面请求卡住，或并发过高。可调整 SSH_MAX_CONCURRENT / SSH_ACQUIRE_TIMEOUT`));
     }, timeoutMs);
   });
@@ -74,7 +75,7 @@ function sshRelease() {
   // 超时的 entry 已在 timer 里从 queue 移除，这里 shift 到的都是活的
   const next = _sshSem.queue.shift();
   if (next) next();
-  console.error(`[SSH-Sem] release (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
+  log(`[SSH-Sem] release (active=${_sshSem.active}/${_sshSem.max}, queue=${_sshSem.queue.length})`);
 }
 
 /**