@jeik/dingtalk-connector 0.8.28 → 0.8.29

package/dist/{connection-CZ7ZoN5_.mjs → connection-obtrPkj4.mjs}

@@ -1,5 +1,5 @@
 import { i as checkAndMarkDingtalkMessage } from "./utils-legacy-DQ3HeGHh.mjs";
-import { n as onBackgroundWorkCountChange, t as getActiveBackgroundWorkCount } from "./background-work-Cxb4b-91.mjs";
+import { n as onBackgroundWorkCountChange, t as getActiveBackgroundWorkCount } from "./background-work-DkaSDqWk.mjs";
 import * as fs from "fs";
 //#region src/core/connection.ts
 /**
@@ -64,7 +64,7 @@ let _connectionNoticePrinted = false;
 function printConnectionNoticeOnce() {
 	if (_connectionNoticePrinted) return;
 	_connectionNoticePrinted = true;
-	console.log("[dingtalk-connector] ℹ️  上游 dingtalk-stream 噪音已过滤；须 OPEN+REGISTERED 才报 ready，REGISTERED 超时会强制重连（禁止假 online）。正常运行不应出现 ≤30s 周期性硬重连。");
+	console.log("[dingtalk-connector] ℹ️  上游 dingtalk-stream 噪音已过滤；OPEN 成功即可上线，REGISTERED 尽量等待；若环境不推 REGISTERED，首条消息会确认订阅。正常运行不应出现 ≤30s 周期性硬重连。");
 }
 async function monitorSingleAccount(opts) {
 	const { cfg, account, runtime, abortSignal, messageHandler, onStatusChange } = opts;
@@ -72,7 +72,8 @@ async function monitorSingleAccount(opts) {
 	silenceDingtalkStreamConsoleNoise();
 	const clawdbotConfig = cfg;
 	const log = runtime?.log;
-	const { createLoggerFromConfig } = await import("./logger-BmJkQkm1.mjs");
+	const { createLoggerFromConfig, setDingtalkDebug } = await import("./logger-D8H2IcYz.mjs");
+	if (account.config?.debug) setDingtalkDebug(true);
 	const logger = createLoggerFromConfig(account.config, `DingTalk:${accountId}`);
 	if (!account.clientId || !account.clientSecret) throw new Error(`[DingTalk][${accountId}] Missing credentials: clientId=${account.clientId ? "present" : "MISSING"}, clientSecret=${account.clientSecret ? "present" : "MISSING"}. Please check your configuration in channels.dingtalk-connector.`);
 	const clientIdStr = String(account.clientId);
@@ -169,13 +170,14 @@ async function monitorSingleAccount(opts) {
 		return Math.min(exponentialDelay + jitter, MAX_BACKOFF_DELAY);
 	}
 	/**
-	* 等待钉钉 Stream 真正可收消息。
+	* 等待钉钉 Stream 可服务。
 	*
-	* dingtalk-stream 的 client.connect() 在创建 WebSocket 后立刻 resolve，
-	* **不等** socket open，更不等服务端 SYSTEM/REGISTERED。
+	* - OPEN：必须成功，否则 throw
+	* - REGISTERED：尽量等待；超时则 **降级 OPEN 上线**（不 throw）
 	*
-	* 顺序：socket OPEN → SYSTEM topic=REGISTERED（client.registered=true）
-	* 任一步失败均 throw，禁止 OPEN-only 假 ready。
+	* 原因（生产日志）：部分环境 socket 已 OPEN 且 CALLBACK 能收消息，
+	* 但长期收不到 SYSTEM/REGISTERED 或 client.registered 不被置 true。
+	* 若硬性失败会触发网关 auto-restart 风暴，而旧连接/半连接其实仍在处理消息。
 	*/
 	async function waitForStreamReady(timeoutMs = STREAM_READY_TIMEOUT_MS) {
 		const started = Date.now();
@@ -209,7 +211,7 @@ async function monitorSingleAccount(opts) {
 		}
 		if (client.registered === true) {
 			logger.info(`✅ Stream 已就绪（OPEN + REGISTERED），耗时 ${Date.now() - started}ms`);
-			return;
+			return { registered: true };
 		}
 		if (await new Promise((resolve) => {
 			const socket = client.socket;
@@ -245,9 +247,10 @@ async function monitorSingleAccount(opts) {
 			socket.on("message", onMessage);
 		}) || client.registered === true) {
 			logger.info(`✅ Stream 已就绪（OPEN + REGISTERED），耗时 ${Date.now() - started}ms`);
-			return;
+			return { registered: true };
 		}
-		throw new Error(`SYSTEM/REGISTERED 超时（${timeoutMs}ms）：socket 已 OPEN 但订阅未生效，禁止报 connected`);
+		logger.warn(`⚠️ 未观察到 SYSTEM/REGISTERED（${timeoutMs}ms），socket 已 OPEN → 降级上线。 收到首条机器人消息后会记为「订阅 empirically 生效」。`);
+		return { registered: false };
 	}
 	/**
 	* connect 之后、wait ready 之前挂上 pong/message/close。
@@ -261,26 +264,27 @@ async function monitorSingleAccount(opts) {
 		setupCloseListener();
 	}
 	/**
-	* 单次：connect + 挂 listener + 等 OPEN/REGISTERED。
-	* 失败 throw，不报 connected。
+	* 单次：connect + 挂 listener + 等 OPEN（REGISTERED 可选）。
+	* 仅 OPEN 失败 throw；REGISTERED 超时则降级成功。
 	*/
-	async function connectAndWaitRegistered() {
+	async function connectAndWaitReady() {
 		await client.connect();
 		attachSocketLifecycleListeners();
-		await waitForStreamReady(STREAM_READY_TIMEOUT_MS);
-		if (client.registered !== true) throw new Error("connect 后 client.registered 仍为 false");
+		return await waitForStreamReady(STREAM_READY_TIMEOUT_MS);
 	}
 	/**
-	* 直到 REGISTERED 成功或次数用尽。
-	* 用于初次启动与硬重连：绝不在未订阅时对外 connected=true。
+	* 建立可服务连接。
+	* - 优先拿到 REGISTERED
+	* - OPEN 成功即可上线（避免环境不推 REGISTERED 时 restart 风暴）
+	* - 仅在 OPEN 都失败时多轮重试
 	*/
 	async function ensureRegisteredConnection(maxAttempts = REGISTERED_CONNECT_MAX_ATTEMPTS) {
 		let lastError;
 		for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-			if (isStopped) throw new Error("连接已停止，中止 REGISTERED 等待");
+			if (isStopped) throw new Error("连接已停止，中止 Stream 建立");
 			try {
 				if (attempt > 1) {
-					logger.warn(`🔄 REGISTERED 未就绪，强制重连 ${attempt}/${maxAttempts}…`);
+					logger.warn(`🔄 Stream 建立重试 ${attempt}/${maxAttempts}…`);
 					try {
 						if (client.socket) await client.disconnect();
 					} catch (discErr) {
@@ -288,18 +292,18 @@ async function monitorSingleAccount(opts) {
 					}
 					const delay = Math.min(1e3 * attempt, 5e3);
 					await new Promise((r) => setTimeout(r, delay));
-				} else logger.info(`⏳ 建立 Stream 并等待 REGISTERED（单次超时 ${STREAM_READY_TIMEOUT_MS}ms，最多 ${maxAttempts} 次）…`);
-				await connectAndWaitRegistered();
-				noteSocketAlive("registered-ok");
+				} else logger.info(`⏳ 建立 Stream（OPEN 必须；REGISTERED 尽量等待 ${STREAM_READY_TIMEOUT_MS}ms）…`);
+				const ready = await connectAndWaitReady();
+				noteSocketAlive(ready.registered ? "registered-ok" : "open-degraded");
 				connectionEstablishedTime = Date.now();
-				logger.info(`✅ 订阅已生效 registered=true（attempt ${attempt}/${maxAttempts}, socket=${client.socket?.readyState}）`);
+				logger.info(`✅ Stream 可服务（attempt ${attempt}/${maxAttempts}, registered=${ready.registered || Boolean(client.registered)}, socket=${client.socket?.readyState}）`);
 				return;
 			} catch (err) {
 				lastError = err instanceof Error ? err : new Error(String(err));
-				logger.warn(`⚠️ Stream 就绪失败 attempt=${attempt}/${maxAttempts}: ${lastError.message}`);
+				logger.warn(`⚠️ Stream 建立失败 attempt=${attempt}/${maxAttempts}: ${lastError.message}`);
 			}
 		}
-		throw new Error(`钉钉 Stream 在 ${maxAttempts} 次尝试后仍未 REGISTERED，拒绝假 connected。 最后错误: ${lastError?.message || "unknown"}`);
+		throw new Error(`钉钉 Stream 在 ${maxAttempts} 次尝试后仍无法 OPEN。 最后错误: ${lastError?.message || "unknown"}`);
 	}
 	/** 统一重连函数，带指数退避（无限重连） */
 	async function doReconnect(immediate = false) {
@@ -506,21 +510,19 @@ async function monitorSingleAccount(opts) {
 			receivedCount++;
 			lastMessageTime = Date.now();
 			noteSocketAlive("inbound-callback");
+			if (client.registered !== true) {
+				client.registered = true;
+				logger.info(`✅ 收到机器人 CALLBACK，视为订阅已生效（此前可能未观察到 SYSTEM/REGISTERED）`);
+			}
 			onStatusChange?.({ lastInboundAt: Date.now() });
 			const messageId = res.headers?.messageId;
-			const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-			logger.info(`\n========== 收到新消息 ==========`);
-			logger.info(`时间：${timestamp}`);
-			logger.info(`MessageId: ${messageId || "N/A"}`);
-			logger.info(`Headers: ${JSON.stringify(res.headers || {})}`);
-			logger.info(`Data 长度：${res.data?.length || 0} 字符`);
 			let acked = false;
 			const ackMessage = (why) => {
 				if (acked || !messageId) return;
 				try {
 					client.socketCallBackResponse(messageId, { success: true });
 					acked = true;
-					logger.info(`✅ 已确认回调 messageId=${messageId} (${why})`);
+					logger.debug(`ACK messageId=${messageId} (${why})`);
 				} catch (ackErr) {
 					logger.warn(`确认回调失败: ${ackErr?.message || ackErr}`);
 				}
@@ -531,37 +533,30 @@ async function monitorSingleAccount(opts) {
 				try {
 					data = JSON.parse(res.data);
 				} catch (parseError) {
-					logger.error("Failed to parse response data as JSON:", {
-						error: parseError instanceof Error ? parseError.message : String(parseError),
-						rawData: typeof res.data === "string" ? res.data.substring(0, 500) : res.data,
-						dataType: typeof res.data
-					});
-					throw new Error(`Invalid JSON response from DingTalk API. Error: ${parseError instanceof Error ? parseError.message : String(parseError)}. Raw data (first 100 chars): ${String(res.data).substring(0, 100)}`);
+					logger.error(`JSON 解析失败: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+					throw new Error(`Invalid JSON from DingTalk: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
 				}
-				logger.info(`\n----- 消息详情 -----`);
-				logger.info(`消息类型：${data.msgtype || "unknown"}`);
-				logger.info(`会话类型：${data.conversationType === "1" ? "DM (单聊)" : data.conversationType === "2" ? "Group (群聊)" : data.conversationType}`);
-				logger.info(`发送者：${data.senderNick || "unknown"} (${data.senderStaffId || data.senderId || "unknown"})`);
-				logger.info(`会话 ID: ${data.conversationId || "N/A"}`);
-				logger.info(`消息 ID: ${data.msgId || "N/A"}`);
-				logger.info(`SessionWebhook: ${data.sessionWebhook ? "已提供" : "未提供"}`);
-				logger.info(`RobotCode: ${data.robotCode || account.config?.clientId || "N/A"}`);
-				if (data.chatbotUserId || data.chatbotCorpId) console.log(`[DingTalk:${accountId}] [BotIdentity] accountId=${accountId} chatbotUserId=${data.chatbotUserId || "N/A"} chatbotCorpId=${data.chatbotCorpId || "N/A"}`);
 				const businessMsgId = data.msgId;
+				const convType = data.conversationType === "1" ? "DM" : data.conversationType === "2" ? "Group" : String(data.conversationType ?? "?");
+				const preview = (data.text?.content || "").trim().slice(0, 80) || data.msgtype || "(no text)";
+				logger.info(`📩 入站 ${convType} from=${data.senderNick || data.senderStaffId || data.senderId || "?"} msg=${businessMsgId || messageId || "-"} preview=${JSON.stringify(preview)}`);
+				logger.debug(`Headers: ${JSON.stringify(res.headers || {})}`);
+				logger.debug(`字段: ${Object.keys(data).join(",")}`);
+				if (data.chatbotUserId || data.chatbotCorpId) {
+					const key = `${accountId}:${data.chatbotUserId || ""}:${data.chatbotCorpId || ""}`;
+					if (!globalThis.__dingtalkBotIdentityLogged) globalThis.__dingtalkBotIdentityLogged = /* @__PURE__ */ new Set();
+					const seen = globalThis.__dingtalkBotIdentityLogged;
+					if (!seen.has(key)) {
+						seen.add(key);
+						console.log(`[DingTalk:${accountId}] [BotIdentity] chatbotUserId=${data.chatbotUserId || "N/A"} chatbotCorpId=${data.chatbotCorpId || "N/A"}`);
+					}
+				}
 				if (checkAndMarkDingtalkMessage(accountId, messageId, businessMsgId)) {
 					processedCount++;
 					ackMessage("duplicate");
-					logger.warn(`⚠️ 检测到重复消息，跳过：protocol=${messageId || "-"} business=${businessMsgId || "-"} (${processedCount}/${receivedCount})`);
-					logger.info(`========== 消息处理结束（重复） ==========\n`);
+					logger.warn(`⚠️ 重复消息已跳过 protocol=${messageId || "-"} business=${businessMsgId || "-"}`);
 					return;
 				}
-				let contentPreview = "N/A";
-				if (data.text?.content) contentPreview = data.text.content.length > 100 ? data.text.content.substring(0, 100) + "..." : data.text.content;
-				else if (data.content) contentPreview = JSON.stringify(data.content).substring(0, 100) + "...";
-				logger.info(`消息内容预览：${contentPreview}`);
-				logger.info(`完整数据字段：${Object.keys(data).join(", ")}`);
-				logger.info(`----- 消息详情结束 -----\n`);
-				logger.info(`🚀 开始处理消息...`);
 				await messageHandler({
 					accountId,
 					config: account.config,
@@ -574,16 +569,12 @@ async function monitorSingleAccount(opts) {
 				ackMessage("enqueued");
 				noteSocketAlive("after-enqueue");
 				processedCount++;
-				logger.info(`✅ 消息处理完成 (${processedCount}/${receivedCount})`);
-				logger.info(`========== 消息处理结束（成功） ==========\n`);
+				logger.info(`✅ 入队完成 (${processedCount}/${receivedCount})`);
 			} catch (error) {
 				processedCount++;
-				const errorMsg = `❌ 处理消息异常 (${processedCount}/${receivedCount}): ${error?.message || "未知错误"}`;
-				const errorStack = error?.stack || "无堆栈信息";
-				logger.error(errorMsg);
-				logger.error(`错误堆栈:\n${errorStack}`);
-				if (!acked) logger.warn(`⚠️ 未 ACK messageId=${messageId || "N/A"}，等待钉钉重投（避免网关永久丢消息）`);
-				logger.info(`========== 消息处理结束（失败） ==========\n`);
+				logger.error(`❌ 入站处理失败 (${processedCount}/${receivedCount}): ${error?.message || "未知错误"}`);
+				if (error?.stack) logger.debug(error.stack);
+				if (!acked) logger.warn(`⚠️ 未 ACK messageId=${messageId || "N/A"}，等待钉钉重投`);
 			} finally {
 				markMessageProcessingEnd();
 			}

package/dist/entry-bundled.mjs

@@ -23,7 +23,7 @@ var entry_bundled_default = defineBundledChannelEntry({
 		exportName: "setDingtalkRuntime"
 	},
 	async registerFull(api) {
-		const { registerGatewayMethods } = await import("./gateway-methods-BkI1gKaC.mjs");
+		const { registerGatewayMethods } = await import("./gateway-methods-DQ6TwOAr.mjs");
 		registerGatewayMethods(api);
 	}
 });

package/dist/{gateway-methods-kNX3qvqw.mjs → gateway-methods-BdcpfxEZ.mjs}

@@ -1,7 +1,7 @@
 import { a as resolveDingtalkAccount, t as listDingtalkAccountIds } from "./accounts-BAzdqkAV.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { r as getAccessToken, t as DINGTALK_API } from "./utils-CIfI_3Jh.mjs";
-import { c as prepareMultiBotMentions, d as finishAICard, i as sendProactive, s as buildBotMentionTable } from "./messaging-DVS3UKOp.mjs";
+import { c as prepareMultiBotMentions, d as finishAICard, i as sendProactive, s as buildBotMentionTable } from "./messaging-CK0Wz3Ze.mjs";
 import { d as getUnionId, h as recallEmotionReply } from "./utils-legacy-DQ3HeGHh.mjs";
 //#region src/docs.ts
 var DingtalkDocsClient = class {

package/dist/gateway-methods-DQ6TwOAr.mjs

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

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-A6G7WAWn.mjs";
-import { t as registerGatewayMethods } from "./gateway-methods-kNX3qvqw.mjs";
+import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-DbqGRyhI.mjs";
+import { t as registerGatewayMethods } from "./gateway-methods-BdcpfxEZ.mjs";
 //#region index.ts
 /**
 * 检测同一 plugin id 在多个路径被加载的情况。

package/dist/{logger-mZ9OSbmD.mjs → logger-CnBTcwyq.mjs}

@@ -1,8 +1,21 @@
 //#region src/utils/logger.ts
 /**
 * 日志工具模块
-* 根据 debug 配置控制日志输出
+* 根据配置里的 debug 控制日志输出（无需环境变量）
 */
+/** 任一账号/连接开启过 debug 后为 true；默认静默 */
+let pluginDebugEnabled = false;
+/**
+* 设置插件全局 debug（由配置 `debug: true` 驱动）
+* 仅在 true 时打开；避免多账号中未开 debug 的账号把开关关掉。
+*/
+function setDingtalkDebug(enabled) {
+	if (enabled) pluginDebugEnabled = true;
+}
+/** 是否输出图片/引用/队列等详细诊断日志 */
+function isDingtalkDebug() {
+	return pluginDebugEnabled;
+}
 /**
 * 创建日志记录器
 * @param debug - 是否启用 debug 模式
@@ -10,6 +23,7 @@
 * @returns 日志记录器对象
 */
 function createLogger(debug = false, prefix = "") {
+	if (debug) setDingtalkDebug(true);
 	return {
 		/**
 		* 打印 info 级别日志
@@ -55,4 +69,4 @@ function createLoggerFromConfig(config, prefix = "") {
 	return createLogger(!!config?.debug, prefix);
 }
 //#endregion
-export { createLoggerFromConfig as n, createLogger as t };
+export { setDingtalkDebug as i, createLoggerFromConfig as n, isDingtalkDebug as r, createLogger as t };

package/dist/logger-D8H2IcYz.mjs

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

package/dist/{media-BqpUGCni.mjs → media-DDtX37T2.mjs}

@@ -1,2 +1,2 @@
-import { _ as toLocalPath, d as processLocalImages, f as processRawMediaPaths, h as sendFileProactive, o as hasResidualLocalMdImagesOutsideCode, p as processVideoMarkers } from "./media-DnQB2BrL.mjs";
+import { _ as toLocalPath, d as processLocalImages, f as processRawMediaPaths, h as sendFileProactive, o as hasResidualLocalMdImagesOutsideCode, p as processVideoMarkers } from "./media-g8tJtpfU.mjs";
 export { hasResidualLocalMdImagesOutsideCode, processLocalImages, processRawMediaPaths, processVideoMarkers, sendFileProactive, toLocalPath };

package/dist/{media-DnQB2BrL.mjs → media-g8tJtpfU.mjs}

@@ -1,3 +1,4 @@
+import { r as isDingtalkDebug } from "./logger-CnBTcwyq.mjs";
 import { n as dingtalkOapiHttp, t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { n as DINGTALK_OAPI } from "./utils-CIfI_3Jh.mjs";
 import { createRequire } from "node:module";
@@ -76,9 +77,8 @@ function toLocalPath(raw) {
 	return filePath;
 }
 /**
-* 本地图诊断：默认 console.log 一行（不走 log.warn，避免 [sendTextToDingTalk] 双前缀）。
-* verbose=true 的细节（realpath 等）仅在 debug 时输出。
-* 决策路径（匹配/exists/上传成败/残留）务必 always-on，方便查灰图。
+* 本地图诊断日志。
+* 默认静默：无图/空扫描不再刷屏。仅在上传/失败/灰图风险，或 debug: true 时输出。
 */
 function logLocalImage(log, step, detail, verbose = false) {
 	const line = detail ? `[DingTalk][LocalImage] ${step} | ${detail}` : `[DingTalk][LocalImage] ${step}`;
@@ -88,6 +88,12 @@ function logLocalImage(log, step, detail, verbose = false) {
 		} catch {}
 		return;
 	}
+	if (!(isDingtalkDebug() || /失败|灰图|残留|上传成功|上传失败|下载成功|下载失败|重试|remote|Remote/i.test(`${step} ${detail || ""}`))) {
+		try {
+			log?.debug?.(line);
+		} catch {}
+		return;
+	}
 	console.log(line);
 }
 /** 钉钉 mediaId 形态（oapi 返回常带 @） */
@@ -117,7 +123,7 @@ function logMediaIdTrace(stage, content, extra, force = false) {
 	const residualLocal = mdTargets.filter((t) => isLocalImageRef(t));
 	const httpCount = (text.match(/https?:\/\//gi) || []).length;
 	const suspiciousBare = /type=image|sampleImage|photoURL/i.test(`${stage} ${extra || ""}`) ? [] : bareIds;
-	if (!(force || suspiciousBare.length > 0 || residualLocal.length > 0 || /API前|完成|:out|:in|after-process|processImages/i.test(stage))) return;
+	if (!(force || isDingtalkDebug() || suspiciousBare.length > 0 || residualLocal.length > 0)) return;
 	const preview = text.replace(/\n/g, "\\n").slice(0, 200);
 	console.log(`[DingTalk][MediaIdTrace] ${stage} | len=${text.length} mediaIdCount=${ids.length}` + (ids.length ? ` ids=[${ids.slice(0, 4).join(",")}]` : "") + ` BARE_ids=${suspiciousBare.length ? suspiciousBare.join(",") : "无"} mdImgs=[${mdImgs.length ? mdImgs.join(" || ") : "-"}] httpCount=${httpCount}` + (residualLocal.length ? ` residualLocal=${residualLocal.length}:${residualLocal.slice(0, 3).map((p) => p.slice(0, 80)).join("|")}` : " residualLocal=0") + (extra ? ` ${extra}` : "") + ` preview="${preview}"`);
 }
@@ -277,7 +283,7 @@ async function downloadRemoteUrlToTemp(url) {
 		}
 		const tmp = path.join(os.tmpdir(), `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) {
 		console.warn(`[DingTalk][MediaIdTrace] 远程图下载异常 | ${e?.message || e}`);
@@ -312,27 +318,29 @@ function replaceOutsideImageTargets(content, original, replacement) {
 * - 本地：正文重复的本地路径换成 down.dingtalk.com 可点链接（仍同一条消息）
 * - **不再拆第二条 text 消息**
 *
-* 日志约定（always-on，查灰图必看）：
-* - 开始 / 扫描每张 ![] / 本地 exists / 上传成败 / 远程下载 / 残留 / out
+* 日志约定（默认静默；配置 debug: true 全量）：
+* - 有图上传/失败/灰图残留才 console；无图路径不刷屏
 */
 async function processImagesForOutbound(content, oapiToken, log) {
 	logLocalImage(log, "processImagesForOutbound 开始", `contentLen=${content?.length ?? 0} hasToken=${!!oapiToken}`);
 	if (!oapiToken) {
-		logLocalImage(log, "processImagesForOutbound 跳过", "无 oapiToken（本地路径无法上传→必灰图）");
-		logMediaIdTrace("processImagesForOutbound:skip-no-token", content, void 0, true);
+		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, void 0, true);
+	logMediaIdTrace("processImagesForOutbound:in", content);
 	const codeRanges = getMarkdownCodeRanges(content);
 	if (codeRanges.length > 0) logLocalImage(log, "processImagesForOutbound 代码区域", `count=${codeRanges.length}（围栏/行内 code 内的图路径将跳过）`);
 	const mdMatches = [...content.matchAll(LOCAL_IMAGE_RE)];
@@ -435,9 +443,10 @@ async function processImagesForOutbound(content, oapiToken, log) {
 		if (m.index !== void 0 && isIndexInCodeRange(m.index, getMarkdownCodeRanges(result))) return false;
 		return isLocalImageRef((m[2] || "").trim());
 	}).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, "processImagesForOutbound ⚠️仍有代码块外本地路径未替换（钉钉必灰图）", residual.join(" | "));
-	logMediaIdTrace("processImagesForOutbound:out", result, void 0, true);
+	logMediaIdTrace("processImagesForOutbound:out", result);
 	return {
 		text: result,
 		followUpUrls: []
@@ -658,7 +667,7 @@ async function extractAudioDuration(filePath, log) {
 */
 async function sendVideoMessage(config, sessionWebhook, fileName, mediaId, log, metadata) {
 	try {
-		const token = await (await import("./utils-Bjh4r_qS.mjs")).getAccessToken(config);
+		const token = await (await import("./utils-Bwz2Fls_.mjs")).getAccessToken(config);
 		const videoMessage = {
 			msgtype: "video",
 			video: {
@@ -686,8 +695,8 @@ async function sendVideoMessage(config, sessionWebhook, fileName, mediaId, log,
 */
 async function sendVideoProactive(config, target, videoMediaId, picMediaId, metadata, log) {
 	try {
-		const token = await (await import("./utils-Bjh4r_qS.mjs")).getAccessToken(config);
-		const { DINGTALK_API } = await import("./utils-Bjh4r_qS.mjs");
+		const token = await (await import("./utils-Bwz2Fls_.mjs")).getAccessToken(config);
+		const { DINGTALK_API } = await import("./utils-Bwz2Fls_.mjs");
 		const msgParam = {
 			duration: metadata?.duration.toString() || "60000",
 			videoMediaId,
@@ -732,8 +741,8 @@ async function sendVideoProactive(config, target, videoMediaId, picMediaId, meta
 */
 async function sendAudioProactive(config, target, fileName, mediaId, log, durationMs) {
 	try {
-		const token = await (await import("./utils-Bjh4r_qS.mjs")).getAccessToken(config);
-		const { DINGTALK_API } = await import("./utils-Bjh4r_qS.mjs");
+		const token = await (await import("./utils-Bwz2Fls_.mjs")).getAccessToken(config);
+		const { DINGTALK_API } = await import("./utils-Bwz2Fls_.mjs");
 		const msgParam = {
 			mediaId,
 			duration: durationMs && durationMs > 0 ? durationMs.toString() : "60000"
@@ -770,8 +779,8 @@ async function sendAudioProactive(config, target, fileName, mediaId, log, durati
 */
 async function sendFileProactive(config, target, fileInfo, mediaId, log) {
 	try {
-		const token = await (await import("./utils-Bjh4r_qS.mjs")).getAccessToken(config);
-		const { DINGTALK_API } = await import("./utils-Bjh4r_qS.mjs");
+		const token = await (await import("./utils-Bwz2Fls_.mjs")).getAccessToken(config);
+		const { DINGTALK_API } = await import("./utils-Bwz2Fls_.mjs");
 		const resolvedFileName = fileInfo.fileName || path.basename(fileInfo.path);
 		const msgParam = {
 			mediaId,

package/dist/{message-handler-B1usz1wb.mjs → message-handler-BrO2i7tg.mjs}

@@ -1,15 +1,15 @@
 import { a as resolveDingtalkAccount } from "./accounts-BAzdqkAV.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-A6G7WAWn.mjs";
-import { n as createLoggerFromConfig } from "./logger-mZ9OSbmD.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-DbqGRyhI.mjs";
+import { n as createLoggerFromConfig, r as isDingtalkDebug } from "./logger-CnBTcwyq.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { i as getOapiAccessToken } from "./utils-CIfI_3Jh.mjs";
-import { S as finalClean, _ as FINAL_TAG, a as sendTextMessage, b as estimateTokens, d as finishAICard, g as unregisterActiveCard, h as streamAICard, i as sendProactive, m as registerActiveCard, p as isQpsLimitError, r as sendMessage, t as sendMarkdownMessage, u as createAICardForTarget, v as PROCESS_TAG, x as extractFinal, y as displayClean } from "./messaging-DVS3UKOp.mjs";
+import { S as finalClean, _ as FINAL_TAG, a as sendTextMessage, b as estimateTokens, d as finishAICard, g as unregisterActiveCard, h as streamAICard, i as sendProactive, m as registerActiveCard, p as isQpsLimitError, r as sendMessage, t as sendMarkdownMessage, u as createAICardForTarget, v as PROCESS_TAG, x as extractFinal, y as displayClean } from "./messaging-CK0Wz3Ze.mjs";
 import { a as QUEUE_BUSY_ACK_PHRASES, n as normalizeSlashCommand, t as buildSessionContext } from "./session-DJ4jYqPv.mjs";
 import { c as formatSenderRoles, f as getUserProfile, h as recallEmotionReply, l as getAccessToken, o as formatHiredDateShanghai, r as addEmotionReply, s as formatSenderDisplayLabel, t as DINGTALK_API, u as getOapiAccessToken$1 } from "./utils-legacy-DQ3HeGHh.mjs";
-import { r as trackBackgroundWork } from "./background-work-Cxb4b-91.mjs";
-import "./chunk-upload-BE71drPg.mjs";
-import { a as toLocalPath, i as VIDEO_MARKER_PATTERN, o as uploadMediaToDingTalk, r as FILE_MARKER_PATTERN, t as AUDIO_MARKER_PATTERN } from "./common-BZiVgd3A.mjs";
-import { n as lookupCardContent, t as collectCardLookupIds } from "./card-content-cache-bDQFz2u8.mjs";
+import { r as trackBackgroundWork } from "./background-work-DkaSDqWk.mjs";
+import "./chunk-upload-CIU5G_ay.mjs";
+import { a as toLocalPath, i as VIDEO_MARKER_PATTERN, o as uploadMediaToDingTalk, r as FILE_MARKER_PATTERN, t as AUDIO_MARKER_PATTERN } from "./common-BfIYs1yC.mjs";
+import { n as lookupCardContent, t as collectCardLookupIds } from "./card-content-cache-DT_OYThh.mjs";
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "node:os";
@@ -63,7 +63,7 @@ function resolveAgentWorkspaceDir(cfg, agentId) {
 * 直接复用 media.ts 权威实现，避免 reply 路径与 message 路径两套逻辑分叉。
 */
 async function processLocalImages(content, oapiToken, log) {
-	const { processLocalImages: impl } = await import("./media-BqpUGCni.mjs");
+	const { processLocalImages: impl } = await import("./media-DDtX37T2.mjs");
 	return impl(content, oapiToken, log);
 }
 //#endregion
@@ -606,22 +606,20 @@ function createDingtalkReplyDispatcher(params) {
 				type: "group",
 				openConversationId: conversationId
 			};
-			console.log(`[DingTalk][LocalImage] closeStreaming 开始媒体处理 | target=${JSON.stringify(target)} hasToken=${!!oapiToken} textLen=${finalText.length}`);
 			const mdImgCount = (finalText.match(/!\[[^\]]*\]\([^)]+\)/g) || []).length;
-			console.log(`[DingTalk][LocalImage] closeStreaming 正文 markdown 图数量=${mdImgCount} preview=${JSON.stringify(finalText.slice(0, 200))}`);
+			if (mdImgCount > 0 || isDingtalkDebug()) log.info(`[DingTalk][LocalImage] closeStreaming 媒体处理 | target=${JSON.stringify(target)} hasToken=${!!oapiToken} textLen=${finalText.length} mdImgs=${mdImgCount}`);
 			if (oapiToken) {
 				const beforeImg = finalText;
 				finalText = await processLocalImages(finalText, oapiToken, log);
-				if (beforeImg !== finalText) console.log(`[DingTalk][LocalImage] closeStreaming 图片处理 | ${beforeImg.length}→${finalText.length}`);
+				if (beforeImg !== finalText) log.info(`[DingTalk][LocalImage] closeStreaming 图片已处理 | ${beforeImg.length}→${finalText.length}`);
 				try {
-					const { hasResidualLocalMdImagesOutsideCode } = await import("./media-BqpUGCni.mjs");
-					if (hasResidualLocalMdImagesOutsideCode(finalText)) console.warn(`[DingTalk][LocalImage] closeStreaming 定稿后仍有代码块外的本地 MD 图未上传，钉钉可能灰图`);
+					const { hasResidualLocalMdImagesOutsideCode } = await import("./media-DDtX37T2.mjs");
+					if (hasResidualLocalMdImagesOutsideCode(finalText)) log.warn(`[DingTalk][LocalImage] closeStreaming 定稿后仍有代码块外的本地 MD 图未上传，钉钉可能灰图`);
 				} catch {}
 				finalText = await processVideoMarkers(finalText, "", account.config, oapiToken, log, true, target);
 				finalText = await processAudioMarkers(finalText, "", account.config, oapiToken, log, true, target);
 				finalText = await uploadAndReplaceFileMarkers(finalText, "", account.config, oapiToken, log, true, target);
-				log.info(`[DingTalk][closeStreaming] 准备调用 processRawMediaPaths`);
-				const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
+				const { processRawMediaPaths } = await import("./media-DDtX37T2.mjs");
 				finalText = await processRawMediaPaths(finalText, account.config, oapiToken, log, target);
 				log.info(`[DingTalk][closeStreaming] processRawMediaPaths 处理完成`);
 			} else log.warn(`[DingTalk][closeStreaming] oapiToken 为空，跳过媒体处理`);
@@ -774,11 +772,8 @@ function createDingtalkReplyDispatcher(params) {
 		onSkip: (payload, info) => {
 			const raw = readPayloadRawError(payload);
 			const isErr = Boolean(payload?.isError);
-			if (!raw && !isErr) {
-				log.info(`[DingTalk][onSkip] kind=${info?.kind} reason=${info?.reason} 非错误静默（NO_REPLY/empty），跳过错误捕获`);
-				return;
-			}
-			log.warn(`[DingTalk][onSkip] kind=${info?.kind} reason=${info?.reason} isError=${isErr} rawLen=${raw.length}（群聊静默失败常见）`);
+			if (!raw && !isErr) return;
+			log.warn(`[DingTalk][onSkip] 群聊静默失败 kind=${info?.kind} reason=${info?.reason} rawLen=${raw.length}`);
 			captureErrorFromPayload(payload, `onSkip:${info?.kind ?? "?"}:${info?.reason ?? "?"}`);
 		},
 		onReplyStart: () => {
@@ -846,7 +841,7 @@ function createDingtalkReplyDispatcher(params) {
 					const oapiToken = await getOapiAccessToken(account.config);
 					if (oapiToken) {
 						log.info(`[DingTalk][deliver] 检测到 final 响应，准备处理裸露文件路径`);
-						const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
+						const { processRawMediaPaths } = await import("./media-DDtX37T2.mjs");
 						text = await processRawMediaPaths(text, account.config, oapiToken, log, target);
 						log.info(`[DingTalk][deliver] 裸露文件路径处理完成`);
 					}
@@ -976,7 +971,7 @@ function createDingtalkReplyDispatcher(params) {
 					currentToolLine = "";
 					await startStreaming();
 					if (currentCardTarget) try {
-						const { FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN, AUDIO_MARKER_PATTERN } = await import("./common-DgL28gCZ.mjs");
+						const { FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN, AUDIO_MARKER_PATTERN } = await import("./common-C0Oaf0z-.mjs");
 						await enqueueCardStream(buildCardContent().replace(FILE_MARKER_PATTERN, "").replace(VIDEO_MARKER_PATTERN, "").replace(AUDIO_MARKER_PATTERN, "").trim(), { force: true });
 					} catch (err) {
 						if (!isQpsLimitError(err)) log.error(`[DingTalk][onPartialReply] final-marker 刷卡失败：${err.message}`);
@@ -989,7 +984,7 @@ function createDingtalkReplyDispatcher(params) {
 					if (payload.text?.trim()) hasModelStreamText = true;
 					currentToolLine = "";
 					try {
-						const { FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN, AUDIO_MARKER_PATTERN } = await import("./common-DgL28gCZ.mjs");
+						const { FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN, AUDIO_MARKER_PATTERN } = await import("./common-C0Oaf0z-.mjs");
 						await enqueueCardStream(buildCardContent().replace(FILE_MARKER_PATTERN, "").replace(VIDEO_MARKER_PATTERN, "").replace(AUDIO_MARKER_PATTERN, "").trim());
 					} catch (err) {
 						if (isQpsLimitError(err)) log.warn(`[DingTalk][onPartialReply] QPS 限流，已排队尾随重试 latestLen=${latestCardContent.length}`);
@@ -1184,8 +1179,9 @@ function extractQuotedMsgText(container, maxDepth, conversationId) {
 					conversationId,
 					allowConversationRecent: false
 				}) || "";
-				if (cardText) console.log(`[DingTalk][Quote] interactiveCard 已从 CardCache 精确回填 | ids=${ids.join(",") || "-"} len=${cardText.length}`);
-				else {
+				if (cardText) {
+					if (isDingtalkDebug()) console.log(`[DingTalk][Quote] interactiveCard 已从 CardCache 精确回填 | ids=${ids.join(",") || "-"} len=${cardText.length}`);
+				} else if (isDingtalkDebug()) {
 					const dump = JSON.stringify(repliedMsg ?? {}).slice(0, 800);
 					console.log(`[DingTalk][Quote] interactiveCard 无正文且缓存未命中（未使用会话最近兜底） | conv=${conversationId || "-"} keys=${Object.keys(contentObj || {}).join(",")} repliedMsg=${dump}`);
 				}
@@ -1208,13 +1204,13 @@ function extractQuotedMsgText(container, maxDepth, conversationId) {
 				});
 				if (cached) {
 					bodyText = cached;
-					console.log(`[DingTalk][Quote] msgType=${msgType} 已从 CardCache 精确回填 | ids=${ids.join(",") || "-"} len=${cached.length}`);
+					if (isDingtalkDebug()) console.log(`[DingTalk][Quote] msgType=${msgType} 已从 CardCache 精确回填 | ids=${ids.join(",") || "-"} len=${cached.length}`);
 				} else if (/card|interactive/i.test(String(msgType || "")) || ids.length > 0) {
 					bodyText = "钉钉卡片消息。";
-					console.log(`[DingTalk][Quote] 未知卡片类引用 msgType=${msgType} 已简化占位 | keys=${Object.keys(contentObj || {}).join(",")}`);
-				} else console.log(`[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(",")} dump=${JSON.stringify(repliedMsg ?? {}).slice(0, 600)}`);
+					if (isDingtalkDebug()) console.log(`[DingTalk][Quote] 未知卡片类引用 msgType=${msgType} 已简化占位 | keys=${Object.keys(contentObj || {}).join(",")}`);
+				} else if (isDingtalkDebug()) console.log(`[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(",")} dump=${JSON.stringify(repliedMsg ?? {}).slice(0, 600)}`);
 			} catch {
-				console.log(`[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(",")}`);
+				if (isDingtalkDebug()) console.log(`[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(",")}`);
 			}
 			break;
 	}
@@ -2320,7 +2316,7 @@ async function handleDingTalkMessageInternal(params) {
 				finalText = await processVideoMarkers(finalText, "", config, oapiToken, log, true, mediaTarget);
 				finalText = await processAudioMarkers(finalText, "", config, oapiToken, log, true, mediaTarget);
 				finalText = await uploadAndReplaceFileMarkers(finalText, "", config, oapiToken, log, true, mediaTarget);
-				const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
+				const { processRawMediaPaths } = await import("./media-DDtX37T2.mjs");
 				finalText = await processRawMediaPaths(finalText, config, oapiToken, log, mediaTarget);
 			}
 			const textToSend = finalText.trim() || "✅ 任务执行完成（无文本输出）";