@jeik/dingtalk-connector 0.8.28 → 0.8.30

package/src/services/media.ts

@@ -12,6 +12,7 @@ import FormData from 'form-data';
 import type { DingtalkConfig } from '../types/index.ts';
 import { DINGTALK_OAPI, getOapiAccessToken } from '../utils/index.ts';
 import { dingtalkHttp, dingtalkOapiHttp } from '../utils/http-client.ts';
+import { isDingtalkDebug } from '../utils/logger.ts';
 
 
 /** 文本文件扩展名 */
@@ -109,9 +110,11 @@ export function stripNonImageOccurrencesOfTargets(
           from = idx + variant.length;
           continue;
         }
-        console.log(
-          `[DingTalk][MediaIdTrace] strip 非图重复 target | idx=${idx} remove=${variant.slice(0, 100)}`,
-        );
+        if (isDingtalkDebug()) {
+          console.log(
+            `[DingTalk][MediaIdTrace] strip 非图重复 target | idx=${idx} remove=${variant.slice(0, 100)}`,
+          );
+        }
         if (!stripped.includes(original)) stripped.push(original);
         out = out.slice(0, idx) + out.slice(idx + variant.length);
         // 清掉残留的空「下载链接：」类前缀行由调用方整理；此处只去 target
@@ -127,7 +130,7 @@ export function stripNonImageOccurrencesOfTargets(
     .replace(/[：:]\s*$/gm, "")
     .trim();
 
-  if (stripped.length) {
+  if (stripped.length && isDingtalkDebug()) {
     console.log(
       `[DingTalk][MediaIdTrace] strip 完成 | stripped=${stripped.length} bodyLen=${out.length}`,
     );
@@ -225,9 +228,8 @@ export interface UploadResult {
 }
 
 /**
- * 本地图诊断：默认 console.log 一行（不走 log.warn，避免 [sendTextToDingTalk] 双前缀）。
- * verbose=true 的细节（realpath 等）仅在 debug 时输出。
- * 决策路径（匹配/exists/上传成败/残留）务必 always-on，方便查灰图。
+ * 本地图诊断日志。
+ * 默认静默：无图/空扫描不再刷屏。仅在上传/失败/灰图风险，或 debug: true 时输出。
  */
 function logLocalImage(log: any, step: string, detail?: string, verbose = false) {
   const line = detail
@@ -241,6 +243,19 @@ function logLocalImage(log: any, step: string, detail?: string, verbose = false)
     }
     return;
   }
+  const interesting =
+    isDingtalkDebug() ||
+    /失败|灰图|残留|上传成功|上传失败|下载成功|下载失败|重试|remote|Remote/i.test(
+      `${step} ${detail || ""}`,
+    );
+  if (!interesting) {
+    try {
+      log?.debug?.(line);
+    } catch {
+      // ignore
+    }
+    return;
+  }
   console.log(line);
 }
 
@@ -282,11 +297,12 @@ export function logMediaIdTrace(
   // sampleImageMsg 的 photoURL 就是裸 mediaId，不算异常
   const isImageMsg = /type=image|sampleImage|photoURL/i.test(`${stage} ${extra || ""}`);
   const suspiciousBare = isImageMsg ? [] : bareIds;
+  // 默认静默：仅 force、灰图风险（裸 mediaId / 残留本地路径）、或 debug: true
   const always =
     force ||
+    isDingtalkDebug() ||
     suspiciousBare.length > 0 ||
-    residualLocal.length > 0 ||
-    /API前|完成|:out|:in|after-process|processImages/i.test(stage);
+    residualLocal.length > 0;
   if (!always) return;
 
   const preview = text.replace(/\n/g, "\\n").slice(0, 200);
@@ -556,9 +572,11 @@ async function downloadRemoteUrlToTemp(url: string): Promise<string | null> {
       `dingtalk-md-remote-${Date.now()}-${Math.random().toString(36).slice(2, 8)}${ext}`,
     );
     fs.writeFileSync(tmp, buf);
-    console.log(
-      `[DingTalk][MediaIdTrace] 远程图下载成功 | bytes=${buf.length} tmp=${tmp}`,
-    );
+    if (isDingtalkDebug()) {
+      console.log(
+        `[DingTalk][MediaIdTrace] 远程图下载成功 | bytes=${buf.length} tmp=${tmp}`,
+      );
+    }
     return tmp;
   } catch (e: any) {
     console.warn(`[DingTalk][MediaIdTrace] 远程图下载异常 | ${e?.message || e}`);
@@ -599,8 +617,8 @@ function replaceOutsideImageTargets(
  * - 本地：正文重复的本地路径换成 down.dingtalk.com 可点链接（仍同一条消息）
  * - **不再拆第二条 text 消息**
  *
- * 日志约定（always-on，查灰图必看）：
- * - 开始 / 扫描每张 ![] / 本地 exists / 上传成败 / 远程下载 / 残留 / out
+ * 日志约定（默认静默；配置 debug: true 全量）：
+ * - 有图上传/失败/灰图残留才 console；无图路径不刷屏
  */
 export async function processImagesForOutbound(
   content: string,
@@ -613,16 +631,19 @@ export async function processImagesForOutbound(
     `contentLen=${content?.length ?? 0} hasToken=${!!oapiToken}`,
   );
   if (!oapiToken) {
-    logLocalImage(log, "processImagesForOutbound 跳过", "无 oapiToken（本地路径无法上传→必灰图）");
-    logMediaIdTrace("processImagesForOutbound:skip-no-token", content, undefined, true);
+    // 有 MD 图却无 token 才告警（否则无图路径全静默）
+    if (/!\[[^\]]*\]\([^)]+\)/.test(content || "")) {
+      logLocalImage(log, "processImagesForOutbound 跳过", "无 oapiToken（本地路径无法上传→必灰图）");
+      logMediaIdTrace("processImagesForOutbound:skip-no-token", content);
+    }
     return { text: content || "", followUpUrls: [] };
   }
   if (!content || typeof content !== "string") {
-    logLocalImage(log, "processImagesForOutbound 跳过", "content 为空");
+    logLocalImage(log, "processImagesForOutbound 跳过", "content 为空", true);
     return { text: content || "", followUpUrls: [] };
   }
 
-  logMediaIdTrace("processImagesForOutbound:in", content, undefined, true);
+  logMediaIdTrace("processImagesForOutbound:in", content);
 
   const codeRanges = getMarkdownCodeRanges(content);
   if (codeRanges.length > 0) {
@@ -795,14 +816,26 @@ export async function processImagesForOutbound(
     })
     .map((m) => (m[2] || "").trim());
 
-  logLocalImage(
-    log,
-    "processImagesForOutbound 完成",
-    `uploads=${uploadCount} localTried=${localTried} remoteTried=${remoteTried} skippedCode=${skippedCode} skippedOther=${skippedOther} outLen=${result.length}` +
-      (residual.length
-        ? ` ⚠️residualLocal=${residual.length}:${residual.slice(0, 3).join("|")}`
-        : " residualLocal=0"),
-  );
+  // 有实际上传/跳过/残留时记一行；纯文本无图完成则静默
+  if (uploadCount > 0 || localTried > 0 || remoteTried > 0 || residual.length > 0) {
+    logLocalImage(
+      log,
+      residual.length
+        ? "processImagesForOutbound 完成(有残留)"
+        : "processImagesForOutbound 上传成功",
+      `uploads=${uploadCount} localTried=${localTried} remoteTried=${remoteTried} skippedCode=${skippedCode} skippedOther=${skippedOther} outLen=${result.length}` +
+        (residual.length
+          ? ` ⚠️residualLocal=${residual.length}:${residual.slice(0, 3).join("|")}`
+          : " residualLocal=0"),
+    );
+  } else {
+    logLocalImage(
+      log,
+      "processImagesForOutbound 完成",
+      `uploads=0 outLen=${result.length}`,
+      true,
+    );
+  }
   if (residual.length) {
     logLocalImage(
       log,
@@ -810,7 +843,7 @@ export async function processImagesForOutbound(
       residual.join(" | "),
     );
   }
-  logMediaIdTrace("processImagesForOutbound:out", result, undefined, true);
+  logMediaIdTrace("processImagesForOutbound:out", result);
 
   return { text: result, followUpUrls: [] };
 }

package/src/services/messaging/card-content-cache.ts

@@ -12,6 +12,8 @@
  * 内存 LRU + TTL，进程重启后清空（可接受）。
  */
 
+import { isDingtalkDebug } from "../../utils/logger.ts";
+
 export type CardContentCacheEntry = {
   text: string;
   at: number;
@@ -83,12 +85,15 @@ export function rememberCardContent(params: {
     byKey.set(normalizeKey("convRef", `${cid}|${ref}`), entry);
   }
 
-  try {
-    console.log(
-      `[DingTalk][CardCache] 已缓存 | outTrack=${params.outTrackId || "-"} conv=${params.conversationId || "-"} len=${text.length}`,
-    );
-  } catch {
-    // ignore
+  // 成功写入默认静默；需要排查时设 debug: true
+  if (isDingtalkDebug()) {
+    try {
+      console.log(
+        `[DingTalk][CardCache] 已缓存 | outTrack=${params.outTrackId || "-"} conv=${params.conversationId || "-"} len=${text.length}`,
+      );
+    } catch {
+      // ignore
+    }
   }
 }
 

package/src/services/messaging.ts

@@ -7,7 +7,7 @@ import type { DingtalkConfig } from "../types/index.ts";
 import { DINGTALK_API, getAccessToken, getOapiAccessToken } from "../utils/index.ts";
 import { dingtalkHttp, dingtalkOapiHttp } from "../utils/http-client.ts";
 import { MEDIA_MSG_TYPES } from "../utils/constants.ts";
-import { createLoggerFromConfig } from "../utils/logger.ts";
+import { createLoggerFromConfig, isDingtalkDebug } from "../utils/logger.ts";
 import {
   processLocalImages,
   processImagesForOutbound,
@@ -779,7 +779,9 @@ async function downloadRemoteMediaToTemp(
 ): Promise<string | null> {
   const tag = "[DingTalk][RemoteMedia]";
   try {
-    console.log(`${tag} 开始下载 | ${url}`);
+    if (isDingtalkDebug()) {
+      console.log(`${tag} 开始下载 | ${url}`);
+    }
     const res = await fetch(url, {
       redirect: "follow",
       signal: AbortSignal.timeout(60_000),
@@ -819,7 +821,9 @@ async function downloadRemoteMediaToTemp(
       `dingtalk-remote-${Date.now()}-${Math.random().toString(36).slice(2, 8)}${ext}`,
     );
     writeFileSync(tmp, buf);
-    console.log(`${tag} 下载成功 | bytes=${buf.length} ct=${ct || "-"} tmp=${tmp}`);
+    if (isDingtalkDebug()) {
+      console.log(`${tag} 下载成功 | bytes=${buf.length} ct=${ct || "-"} tmp=${tmp}`);
+    }
     return tmp;
   } catch (err: any) {
     console.warn(`${tag} 下载异常 | ${err?.message || err}`);
@@ -883,26 +887,27 @@ export async function sendTextToDingTalk(params: {
 
   const targetParam = resolveOutboundTarget(target);
 
-  console.log(
-    `[DingTalk][LocalImage] sendTextToDingTalk 入口 | target=${target} textLen=${text?.length ?? 0}`,
-  );
-  logMediaIdTrace("sendTextToDingTalk:in", text, `target=${target}`, true);
-
   // 图片：![] 上传为 mediaId；下载链接原 URL 留在同一条 markdown（不拆消息）
+  // 无图路径全程静默；有 MD 图/失败才打日志（debug: true 可开全量）
   const beforeLen = text?.length ?? 0;
+  const hasMdImg = /!\[[^\]]*\]\([^)]+\)/.test(text || "");
+  if (hasMdImg || isDingtalkDebug()) {
+    logMediaIdTrace("sendTextToDingTalk:in", text, `target=${target}`);
+  }
   try {
     const oapiToken = await getOapiAccessToken(config);
-    console.log(
-      `[DingTalk][LocalImage] sendTextToDingTalk 入口 | target=${target} textLen=${beforeLen} hasToken=${!!oapiToken}`,
-    );
     if (oapiToken && text) {
       const processed = await processImagesForOutbound(text, oapiToken, log);
       text = processed.text;
-      console.log(
-        `[DingTalk][LocalImage] sendTextToDingTalk 处理后 | ${beforeLen}→${text.length} 字`,
-      );
-      logMediaIdTrace("sendTextToDingTalk:after-process", text, undefined, true);
-    } else if (!oapiToken) {
+      if (beforeLen !== text.length && (hasMdImg || isDingtalkDebug())) {
+        console.log(
+          `[DingTalk][LocalImage] sendTextToDingTalk 处理后 | ${beforeLen}→${text.length} 字`,
+        );
+      }
+      if (hasMdImg || isDingtalkDebug()) {
+        logMediaIdTrace("sendTextToDingTalk:after-process", text);
+      }
+    } else if (!oapiToken && hasMdImg) {
       console.warn(
         `[DingTalk][LocalImage] sendTextToDingTalk 无 oapiToken，跳过图片上传（本地 MD 图会灰）`,
       );
@@ -915,15 +920,13 @@ export async function sendTextToDingTalk(params: {
 
   const msgType: DingTalkMsgType = shouldSendAsMarkdown(text) ? "markdown" : "text";
   const cardOpts = messageToolProactiveCardOptions(config);
-  logMediaIdTrace(
-    "sendTextToDingTalk:API前",
-    text,
-    `msgType=${msgType} messageAnswerCard=${isMessageAnswerCardEnabled(config)} useAICard=${cardOpts.useAICard}`,
-    true,
-  );
-  console.log(
-    `[DingTalk][MessageCard] sendTextToDingTalk | messageAnswerCard=${isMessageAnswerCardEnabled(config)} useAICard=${cardOpts.useAICard} tpl=${cardOpts.cardTemplateId || "-"}`,
-  );
+  if (hasMdImg || isDingtalkDebug()) {
+    logMediaIdTrace(
+      "sendTextToDingTalk:API前",
+      text,
+      `msgType=${msgType} messageAnswerCard=${isMessageAnswerCardEnabled(config)} useAICard=${cardOpts.useAICard}`,
+    );
+  }
 
   return sendProactive(config, targetParam, text, {
     msgType,
@@ -1127,9 +1130,11 @@ export async function sendMediaToDingTalk(params: {
         const mergeMd =
           config.messageImageMd === true && caption.length > 0 && imgsInCaption >= 1;
 
-        console.log(
-          `[DingTalk][LocalImage] sendMedia 图片策略 | messageImageMd=${config.messageImageMd === true} imgsInCaption=${imgsInCaption} mergeMd=${mergeMd} remote=${isRemoteHttpUrl(mediaUrl)}`,
-        );
+        if (isDingtalkDebug()) {
+          console.log(
+            `[DingTalk][LocalImage] sendMedia 图片策略 | messageImageMd=${config.messageImageMd === true} imgsInCaption=${imgsInCaption} mergeMd=${mergeMd} remote=${isRemoteHttpUrl(mediaUrl)}`,
+          );
+        }
 
         if (mergeMd) {
           const combined = `${caption}\n\n![](${mediaId})`;
@@ -1250,7 +1255,9 @@ export async function sendMediaToDingTalk(params: {
       if (cleanupTemp) {
         try {
           _fs.unlinkSync(cleanupTemp);
-          console.log(`[DingTalk][RemoteMedia] 已清理临时文件 | ${cleanupTemp}`);
+          if (isDingtalkDebug()) {
+            console.log(`[DingTalk][RemoteMedia] 已清理临时文件 | ${cleanupTemp}`);
+          }
         } catch {
           // ignore
         }
@@ -1392,9 +1399,11 @@ async function sendProactiveInternal(
           undefined,
           skipInputingWalk,
         );
-        console.log(
-          `[DingTalk][MessageCard] AI Card 发送成功 | outTrack=${card.cardInstanceId} tpl=${cardTemplateId || "default"} skipInputing=${skipInputingWalk}`,
-        );
+        if (isDingtalkDebug()) {
+          console.log(
+            `[DingTalk][MessageCard] AI Card 发送成功 | outTrack=${card.cardInstanceId} tpl=${cardTemplateId || "default"} skipInputing=${skipInputingWalk}`,
+          );
+        }
         return {
           ok: true,
           cardInstanceId: card.cardInstanceId,
@@ -1455,12 +1464,17 @@ async function sendProactiveInternal(
       return { ok: false, error: payload.error, usedAICard: false };
     }
 
-    logMediaIdTrace(
-      "API出站",
-      content,
-      `msgKey=${payload.msgKey} type=${msgType}`,
-      true,
-    );
+    // 仅有 MD 图或调试时追踪（纯文本出站不再刷屏）
+    if (
+      /!\[[^\]]*\]\([^)]+\)/.test(content || "") ||
+      isDingtalkDebug()
+    ) {
+      logMediaIdTrace(
+        "API出站",
+        content,
+        `msgKey=${payload.msgKey} type=${msgType}`,
+      );
+    }
 
     const body: any = {
       robotCode: String(config.clientId),

package/src/utils/background-work.ts

@@ -9,6 +9,8 @@
  * connection 层订阅计数变化，在 count>0 时保持处理中 keepAlive。
  */
 
+import { isDingtalkDebug } from "./logger.ts";
+
 type CountListener = (count: number) => void;
 
 let activeCount = 0;
@@ -54,7 +56,7 @@ export function trackBackgroundWork(
     notify();
   };
   void work.then(done, done);
-  if (label && typeof process !== "undefined" && process.env?.DINGTALK_DEBUG_QUEUE === "1") {
+  if (label && typeof process !== "undefined" && isDingtalkDebug()) {
     console.log(`[DingTalk][bgWork] +1 label=${label} count=${activeCount}`);
     void work.finally(() => {
       console.log(`[DingTalk][bgWork] -1 label=${label} count=${activeCount}`);

package/src/utils/logger.ts

@@ -1,8 +1,24 @@
 /**
  * 日志工具模块
- * 根据 debug 配置控制日志输出
+ * 根据配置里的 debug 控制日志输出（无需环境变量）
  */
 
+/** 任一账号/连接开启过 debug 后为 true；默认静默 */
+let pluginDebugEnabled = false;
+
+/**
+ * 设置插件全局 debug（由配置 `debug: true` 驱动）
+ * 仅在 true 时打开；避免多账号中未开 debug 的账号把开关关掉。
+ */
+export function setDingtalkDebug(enabled: boolean): void {
+  if (enabled) pluginDebugEnabled = true;
+}
+
+/** 是否输出图片/引用/队列等详细诊断日志 */
+export function isDingtalkDebug(): boolean {
+  return pluginDebugEnabled;
+}
+
 /**
  * 创建日志记录器
  * @param debug - 是否启用 debug 模式
@@ -10,6 +26,8 @@
  * @returns 日志记录器对象
  */
 export function createLogger(debug: boolean = false, prefix: string = '') {
+  if (debug) setDingtalkDebug(true);
+
   const logger = {
     /**
      * 打印 info 级别日志
@@ -73,6 +91,9 @@ export function createLogger(debug: boolean = false, prefix: string = '') {
  * @param prefix - 日志前缀
  * @returns 日志记录器对象
  */
-export function createLoggerFromConfig(config: { debug?: boolean } | undefined | null, prefix: string = '') {
+export function createLoggerFromConfig(
+  config: { debug?: boolean } | undefined | null,
+  prefix: string = '',
+) {
   return createLogger(!!config?.debug, prefix);
 }

package/dist/card-content-cache-c4Ls96eJ.mjs

@@ -1,2 +0,0 @@
-import { r as rememberCardContent } from "./card-content-cache-bDQFz2u8.mjs";
-export { rememberCardContent };

package/dist/chunk-upload-PwhogwfE.mjs

@@ -1,2 +0,0 @@
-import { a as uploadLargeFileByChunks } from "./chunk-upload-BE71drPg.mjs";
-export { uploadLargeFileByChunks };

package/dist/gateway-methods-BkI1gKaC.mjs

@@ -1,2 +0,0 @@
-import { t as registerGatewayMethods } from "./gateway-methods-kNX3qvqw.mjs";
-export { registerGatewayMethods };

package/dist/logger-BmJkQkm1.mjs

@@ -1,2 +0,0 @@
-import { n as createLoggerFromConfig } from "./logger-mZ9OSbmD.mjs";
-export { createLoggerFromConfig };