@jeik/dingtalk-connector 0.8.28 → 0.8.29

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-DbqGRyhI.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-BrO2i7tg.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,57 @@
+# 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`。
+
+---
+
+## 安装
+
+```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. 任务进行中再发：有排队/处理中反馈  

package/openclaw.plugin.json

@@ -1,9 +1,9 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.20",
-  "description": "Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件",
-  "author": "DingTalk Real Team",
+  "version": "0.8.29",
+  "description": "OpenClaw DingTalk channel plugin (community) | 钉钉 OpenClaw 社区增强版",
+  "author": "jeik",
   "main": "index.ts",
   "channels": [
     "dingtalk-connector"
@@ -240,7 +240,9 @@
             "type": "string"
           },
           "debug": {
-            "type": "boolean"
+            "type": "boolean",
+            "default": false,
+            "description": "调试日志：连接/入站、图片 mediaId、引用回填、队列计数等。日常关闭；排障时设 true 后重启 gateway。"
           },
           "messageImageMd": {
             "type": "boolean",
@@ -491,7 +493,9 @@
                   "type": "string"
                 },
                 "debug": {
-                  "type": "boolean"
+                  "type": "boolean",
+                  "default": false,
+                  "description": "调试日志：连接/入站、图片 mediaId、引用回填、队列计数等。日常关闭；排障时设 true 后重启 gateway。"
                 },
                 "messageImageMd": {
                   "type": "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeik/dingtalk-connector",
-  "version": "0.8.28",
+  "version": "0.8.29",
   "description": "OpenClaw DingTalk channel plugin (community) | 钉钉 OpenClaw 社区增强版（基于官方 0.8.24，长连接与消息体验增强）",
   "type": "module",
   "exports": {

package/src/config/schema.ts

@@ -81,7 +81,8 @@ const DingtalkSharedConfigShape = {
   asyncMode: z.boolean().optional(),
   ackText: z.string().optional(),
   endpoint: z.string().optional(), // DWClient gateway endpoint
-  debug: z.boolean().optional(), // DWClient debug mode
+  /** 调试日志：连接/入站摘要、图片 mediaId 追踪、引用回填、队列计数等（默认关，生产勿开） */
+  debug: z.boolean().optional(),
   enableMediaUpload: z.boolean().optional(),
   systemPrompt: z.string().optional(),
   /**