@jeik/dingtalk-connector 0.8.28 → 0.8.30

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-CjE4Z9G5.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-BeTQQCUe.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-CjE4Z9G5.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: () => {
@@ -815,6 +810,13 @@ function createDingtalkReplyDispatcher(params) {
 			await startStreaming();
 			if (isNonAnswerPayload(payload)) {
 				const isModelErrorFinal = Boolean(payload.isError) && info?.kind === "final" && Boolean(text.trim());
+				const existingAnswerText = (lastAnswerText.trim() || accumulatedText.trim()).trim();
+				if (isModelErrorFinal && /Agent couldn't generate a response/i.test(text) && existingAnswerText.length >= 20 && !/Agent couldn't generate a response/i.test(existingAnswerText)) {
+					pendingErrorText = null;
+					log.warn(`[DingTalk][deliver] 忽略 incomplete_turn 误报 isError final（卡片已有真实答案 len=${existingAnswerText.length}），不定格错误卡`);
+					await closeStreaming();
+					return;
+				}
 				if (isModelErrorFinal) {
 					accumulatedText = text;
 					log.info(`[DingTalk][deliver] 将上游异常 final 文本存入 accumulatedText（len=${text.length}），防止 onIdle 覆盖`);
@@ -846,7 +848,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 +978,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 +991,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 +1186,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 +1211,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 +2323,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() || "✅ 任务执行完成（无文本输出）";

package/dist/{messaging-DVS3UKOp.mjs → messaging-CK0Wz3Ze.mjs}

@@ -1,5 +1,5 @@
-import { c as logMediaIdTrace, d as processLocalImages, u as processImagesForOutbound, y as uploadMediaToDingTalk } from "./media-DnQB2BrL.mjs";
-import { n as createLoggerFromConfig } from "./logger-mZ9OSbmD.mjs";
+import { c as logMediaIdTrace, d as processLocalImages, u as processImagesForOutbound, y as uploadMediaToDingTalk } from "./media-g8tJtpfU.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, r as getAccessToken, t as DINGTALK_API } from "./utils-CIfI_3Jh.mjs";
 import { r as MEDIA_MSG_TYPES } from "./session-DJ4jYqPv.mjs";
@@ -371,7 +371,7 @@ async function finishAICard(card, content, config, log, contentVar, skipInputing
 	const fixedContent = ensureTableBlankLines(cleanContent);
 	log?.info?.(`[DingTalk][AICard] 开始 finish（一次性定稿，无流式回放），最终内容长度=${fixedContent.length}`);
 	try {
-		const { rememberCardContent } = await import("./card-content-cache-c4Ls96eJ.mjs");
+		const { rememberCardContent } = await import("./card-content-cache-C7-XHhHw.mjs");
 		rememberCardContent({
 			text: fixedContent,
 			outTrackId: card.cardInstanceId,
@@ -821,7 +821,7 @@ function isImageMediaPath(mediaUrl) {
 async function downloadRemoteMediaToTemp(url, log) {
 	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(6e4),
@@ -858,7 +858,7 @@ async function downloadRemoteMediaToTemp(url, log) {
 		const { writeFileSync } = await import("node:fs");
 		const tmp = path.join(os.tmpdir(), `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) {
 		console.warn(`${tag} 下载异常 | ${err?.message || err}`);
@@ -876,7 +876,7 @@ async function resolveMediaSourceToLocalFile(mediaUrl, mediaLocalRoots, log) {
 			cleanup: tmp
 		};
 	}
-	const { toLocalPath } = await import("./media-BqpUGCni.mjs");
+	const { toLocalPath } = await import("./media-DDtX37T2.mjs");
 	const _fs = await import("fs");
 	const _path = await import("path");
 	let resolved = toLocalPath(mediaUrl);
@@ -911,24 +911,22 @@ 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);
 	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) {
 			text = (await processImagesForOutbound(text, oapiToken, log)).text;
-			console.log(`[DingTalk][LocalImage] sendTextToDingTalk 处理后 | ${beforeLen}→${text.length} 字`);
-			logMediaIdTrace("sendTextToDingTalk:after-process", text, void 0, true);
-		} else if (!oapiToken) console.warn(`[DingTalk][LocalImage] sendTextToDingTalk 无 oapiToken，跳过图片上传（本地 MD 图会灰）`);
+			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 图会灰）`);
 	} catch (err) {
 		console.warn(`[DingTalk][LocalImage] sendTextToDingTalk 图片处理失败: ${err?.message || err}`);
 	}
 	const msgType = 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,
 		replyToId,
@@ -1090,7 +1088,7 @@ async function sendMediaToDingTalk(params) {
 				const mediaId = uploadResult.mediaId;
 				const imgsInCaption = (caption.match(/!\[[^\]]*\]\([^)]+\)/g) || []).length;
 				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 result = await sendProactive(config, targetParam, `${caption}\n\n![](${mediaId})`, {
 						msgType: "markdown",
@@ -1145,7 +1143,7 @@ async function sendMediaToDingTalk(params) {
 			const fileName = mediaUrl.split("/").filter(Boolean).pop()?.split("?")[0] || "file";
 			if (mediaType === "video") {
 				const videoMarker = `[DINGTALK_VIDEO]{"path":"${resolvedMediaUrl}"}[/DINGTALK_VIDEO]`;
-				const { processVideoMarkers } = await import("./media-BqpUGCni.mjs");
+				const { processVideoMarkers } = await import("./media-DDtX37T2.mjs");
 				await processVideoMarkers(videoMarker, "", config, oapiToken, console, true, targetParam);
 				return {
 					ok: true,
@@ -1164,7 +1162,7 @@ async function sendMediaToDingTalk(params) {
 				fileName,
 				fileType: ext && ext.length < 12 ? ext : "file"
 			};
-			const { sendFileProactive } = await import("./media-BqpUGCni.mjs");
+			const { sendFileProactive } = await import("./media-DDtX37T2.mjs");
 			await sendFileProactive(config, targetParam, fileInfo, uploadResult.mediaId, log);
 			return {
 				ok: true,
@@ -1174,7 +1172,7 @@ async function sendMediaToDingTalk(params) {
 		} finally {
 			if (cleanupTemp) try {
 				_fs.unlinkSync(cleanupTemp);
-				console.log(`[DingTalk][RemoteMedia] 已清理临时文件 | ${cleanupTemp}`);
+				if (isDingtalkDebug()) console.log(`[DingTalk][RemoteMedia] 已清理临时文件 | ${cleanupTemp}`);
 			} catch {}
 		}
 	} catch (err) {
@@ -1249,7 +1247,7 @@ async function sendProactiveInternal(config, target, content, options) {
 		const card = await createAICardForTarget(config, target, externalLog, cardTemplateId);
 		if (card) {
 			await finishAICard(card, content, config, externalLog, void 0, 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,
@@ -1292,7 +1290,7 @@ async function sendProactiveInternal(config, target, content, options) {
 				usedAICard: false
 			};
 		}
-		logMediaIdTrace("API出站", content, `msgKey=${payload.msgKey} type=${msgType}`, true);
+		if (/!\[[^\]]*\]\([^)]+\)/.test(content || "") || isDingtalkDebug()) logMediaIdTrace("API出站", content, `msgKey=${payload.msgKey} type=${msgType}`);
 		const body = {
 			robotCode: String(config.clientId),
 			msgKey: payload.msgKey,

package/dist/{runtime-A6G7WAWn.mjs → runtime-CjE4Z9G5.mjs}

@@ -1,9 +1,9 @@
-import { b as __exportAll } from "./media-DnQB2BrL.mjs";
+import { b as __exportAll } from "./media-g8tJtpfU.mjs";
 import { a as resolveDingtalkAccount, c as addWildcardAllowFrom, d as hasConfiguredSecretInput, f as normalizeAccountId, l as createDefaultChannelRuntimeState, m as resolveDefaultGroupPolicy, o as resolveDingtalkCredentials, p as resolveAllowlistProviderRuntimeGroupPolicy, r as resolveDefaultDingtalkAccountId, s as DEFAULT_ACCOUNT_ID, t as listDingtalkAccountIds, u as formatDocsLink } from "./accounts-BAzdqkAV.mjs";
-import { t as createLogger } from "./logger-mZ9OSbmD.mjs";
+import { t as createLogger } from "./logger-CnBTcwyq.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import "./utils-CIfI_3Jh.mjs";
-import { S as finalClean, f as getActiveCardForConversation, n as sendMediaToDingTalk, o as sendTextToDingTalk } from "./messaging-DVS3UKOp.mjs";
+import { S as finalClean, f as getActiveCardForConversation, n as sendMediaToDingTalk, o as sendTextToDingTalk } from "./messaging-CK0Wz3Ze.mjs";
 import { createRequire } from "node:module";
 import { z, z as z$1 } from "zod";
 //#region src/secret-input.ts
@@ -92,6 +92,7 @@ const DingtalkSharedConfigShape = {
 	asyncMode: z$1.boolean().optional(),
 	ackText: z$1.string().optional(),
 	endpoint: z$1.string().optional(),
+	/** 调试日志：连接/入站摘要、图片 mediaId 追踪、引用回填、队列计数等（默认关，生产勿开） */
 	debug: z$1.boolean().optional(),
 	enableMediaUpload: z$1.boolean().optional(),
 	systemPrompt: z$1.string().optional(),
@@ -955,8 +956,8 @@ async function monitorDingtalkProvider(opts = {}) {
 	const log = createLogger(cfg.channels?.["dingtalk-connector"]?.debug ?? false);
 	const [accountsModule, monitorAccountModule, monitorSingleModule] = await Promise.all([
 		import("./accounts-BQptOmgB.mjs"),
-		import("./message-handler-B1usz1wb.mjs"),
-		import("./connection-CZ7ZoN5_.mjs")
+		import("./message-handler-BeTQQCUe.mjs"),
+		import("./connection-obtrPkj4.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;
 	const { handleDingTalkMessage } = monitorAccountModule;

package/dist/{utils-Bjh4r_qS.mjs → utils-Bwz2Fls_.mjs}

@@ -1,4 +1,4 @@
-import "./logger-mZ9OSbmD.mjs";
+import "./logger-CnBTcwyq.mjs";
 import { r as getAccessToken, t as DINGTALK_API } from "./utils-CIfI_3Jh.mjs";
 import "./session-DJ4jYqPv.mjs";
 export { DINGTALK_API, getAccessToken };

package/docs/RELEASE_NOTES_V0.8.28.md

@@ -2,13 +2,13 @@
 
 **发布日期：** 2026-07-25  
 **npm：** `@jeik/dingtalk-connector@0.8.28`  
-**定位：** 基于官方 **0.8.24** 的社区增强正式版
+**定位：** 基于官方 **0.8.24**，叠加本仓库独有优化的正式版
 
 ---
 
 ## 一句话
 
-连接更稳、消息更少丢、模型出错时提示更清楚；官方 0.8.24 的长连接改进已吸收，社区图片/答案卡等增强继续保留。
+连接更稳、消息更少丢、模型出错时提示更清楚；官方 0.8.24 的长连接改进已吸收，**本仓库独有**的图片/答案卡等优化继续保留。
 
 ---
 
@@ -22,13 +22,13 @@
 
 ---
 
-## 社区额外优化（效果）
+## 本仓库额外优化（效果）
 
 1. **真正能收消息才显示已连接** — 减少「显示在线、发了没反应」  
 2. **连发 / 错误后 / 刚回完再发** — 消息进网关的成功率明显提高  
 3. **上一条还在跑时再发** — 更容易马上看到排队提示和思考中表情  
 4. **模型 503、欠费、无可用线路等** — 更容易定格成中文错误说明，少卡转圈  
-5. **原有社区能力** — 大段答案独立卡片、图片全路径、中文错误映射等均保留  
+5. **本仓库独有能力** — 大段答案独立卡片、图片全路径、中文错误映射等均保留  
 
 ---
 

package/docs/RELEASE_NOTES_V0.8.29.md

@@ -0,0 +1,72 @@
+# Release Notes · v0.8.29
+
+**发布日期：** 2026-07-25  
+**npm：** `@jeik/dingtalk-connector@0.8.29`  
+**定位：** 正式加固版（日志 / 排障 / 文档）
+
+---
+
+## 一句话
+
+默认日志更干净；排障只需配置 `"debug": true`。连接、消息、错误卡能力继承 0.8.28。
+
+---
+
+## 本版变更
+
+1. **默认静默** — 无图正常回复不再刷 LocalImage / MediaIdTrace / CardCache  
+2. **debug 配置** — 打开后输出连接、图片 mediaId、引用回填、队列等详细日志（无需环境变量）  
+3. **文档** — 安装改为三条递进命令（最新 → 指定版本 → 官方源）
+
+---
+
+## 排障
+
+```json
+"channels": {
+  "dingtalk-connector": {
+    "debug": true
+  }
+}
+```
+
+改完后：`openclaw gateway restart`。用完请改回 `false`。
+
+---
+
+## 安装
+
+**npx（一键扫码，按顺序试）：**
+
+```bash
+# 1）装最新
+npx @jeik/dingtalk-connector install --force && openclaw gateway restart
+
+# 2）若不是最新，指定版本
+npx @jeik/dingtalk-connector@0.8.29 install --force && openclaw gateway restart
+
+# 3）仍失败时走 npm 官方源
+NPM_CONFIG_REGISTRY=https://registry.npmjs.org npx @jeik/dingtalk-connector@0.8.29 install --force && openclaw gateway restart
+```
+
+**openclaw plugins install（只装插件，按顺序试）：**
+
+```bash
+# 1）装最新
+openclaw plugins install @jeik/dingtalk-connector --force && openclaw gateway restart
+
+# 2）若不是最新，指定版本
+openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
+
+# 3）仍失败时走 npm 官方源
+NPM_CONFIG_REGISTRY=https://registry.npmjs.org openclaw plugins install @jeik/dingtalk-connector@0.8.29 --force && openclaw gateway restart
+```
+
+---
+
+## 建议验收
+
+1. 默认：纯文本对话日志无 LocalImage / MediaIdTrace 刷屏  
+2. `"debug": true` 重启后：可见图片/引用类详细日志  
+3. 模型 503：错误卡中文定稿，不永久转圈  
+4. 任务进行中再发：有排队/处理中反馈