@jeik/dingtalk-connector 0.8.21-fix45 → 0.8.21-fix47

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.21-fix47] - 2026-07-20
+
+### 修复 / Fixed
+- 🐛 **`file://` 本地图被误判为远程** — `looksLikeRemoteUrl` 对含 `://` 一律当远程，导致 `![x](file:///mnt/...)` / `file:///root/...` 走 `fetch` → `fetch failed`，原样发出灰图。现：`file://` / `MEDIA:` / `attachment://` **优先按本地上传**（`toLocalPath` 后 oapi）。  
+  日志特征（fix46）：`kind=http path=file://...` + `远程图下载异常 | fetch failed` + `localTried=0`。
+
+### 安装 / Install
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+## [0.8.21-fix46] - 2026-07-20
+
+### 诊断 / Diagnostics
+- ✨ **message 本地 MD 图灰图排查日志** — 恢复并加强 always-on `[DingTalk][LocalImage]` / `[MediaIdTrace]`：  
+  - `sendTextToDingTalk` 入口 / 处理后 / API前  
+  - `processImagesForOutbound` 扫描每张 `![]`（kind=local|http|mediaId、inCode、exists、size）  
+  - 本地上传成败 / 远程下载上传 / `residualLocal` 残留告警  
+  - MediaIdTrace 固定字段：`mediaIdCount` / `mdImgs` / `residualLocal` / preview  
+
+逻辑仍基于 fix45（图+下载同泡、只认 `![]`、代码块跳过）。
+
+### 安装 / Install
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
 ## [0.8.21-fix45] - 2026-07-20
 
 生产稳定版 / Production-stable community release。

package/README.en.md

@@ -4,7 +4,7 @@
   <p>Community maintained fork of the official <strong>v0.8.20</strong> release, tracking and fixing bugs the official team hasn't addressed.<br/>
   Identical to the official release in functionality — only community-critical fixes applied.</p>
 
-  <p><strong>Current published release: <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix45</strong> (production-stable; install: <code>npx -y @jeik/dingtalk-connector install</code>).</p>
+  <p><strong>Current published release: <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix47</strong> (production-stable; install: <code>npx -y @jeik/dingtalk-connector install</code>).</p>
 
   <p>
     <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector"><img src="https://img.shields.io/npm/v/@jeik/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm version" /></a>
@@ -23,21 +23,26 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix45 · 2026-07-20 (current)
+### 🚀 v0.8.21-fix47 · 2026-07-20 (current)
 
-**Theme: image + download link in one bubble · only `![]` · quote card cache**
+**Theme: fix `file://` misclassified as remote URL**
 
 | | Change |
 |--|--------|
-| 📷 **Image + download URL** | `![](http)` → upload mediaId; **original download URL stays in the same message** |
-| ✅ **Only `![]()`** | No bare-path scan; code-block paths not uploaded / no false grey-image warn |
-| 📎 **Quoted AI cards** | Cache final card text for quote backfill |
-| 🌐 **message media** | `media: "https://..."` download-then-upload |
+| 🐛 **`file://` grey images** | Treat `file://` / `MEDIA:` / `attachment://` as local upload, not `fetch` |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix46 · 2026-07-20
+
+Always-on local MD image diagnostics.
+
+### 📦 v0.8.21-fix45 · 2026-07-20
+
+Image + download link one bubble · only `![]` · quote cache · residual false-positive fix.
+
 ### 📦 v0.8.21-fix38 · 2026-07-20
 
 Remote `media` download-then-upload.

package/README.md

@@ -4,7 +4,7 @@
   <p>基于官方 <strong>v0.8.20</strong> 的社区维护版本，由社区持续跟进修复官方无暇处理的 Bug。<br/>
   功能与官方完全一致，拥有最快的修复速度，及时合并官方pr和个人发现的bug和社区急需的 Bug。</p>
 
-  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix45</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix45.tgz --force`）</p>
+  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix47</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix47.tgz --force`）</p>
 
   <p>
     <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector"><img src="https://img.shields.io/npm/v/@jeik/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm version" /></a>
@@ -23,21 +23,26 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.21-fix45 · 2026-07-20（当前）
+### 🚀 v0.8.21-fix47 · 2026-07-20（当前）
 
-**主题：图 + 下载链接单气泡 · 只认 `![]` · 引用卡片缓存**
+**主题：`file://` 本地图误判远程修复**
 
 | | 改动 |
 |--|------|
-| 📷 **图 + 下载链** | `![](http)` 上传为 mediaId；**下载链接原 URL 留在同一条消息**（不被钉钉改成 `@lADP`） |
-| ✅ **只处理 `![]()`** | 不扫裸路径；代码块内路径不上传、不误报灰图 |
-| 📎 **引用 AI 卡** | 定稿缓存正文，引用时回填（`CardCache`） |
-| 🌐 **message media** | `media: "https://..."` 下载再上传 |
+| 🐛 **`file://` 灰图** | `![x](file:///mnt/...)` / `file:///root/...` 按本地上传，不再 `fetch failed` |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix46 · 2026-07-20
+
+本地 MD 图灰图诊断日志（LocalImage / MediaIdTrace）。
+
+### 📦 v0.8.21-fix45 · 2026-07-20
+
+图 + 下载链接单气泡 · 只认 `![]` · 引用卡片缓存 · residual 误报修复。
+
 ### 📦 v0.8.21-fix38 · 2026-07-20
 
 message 远程 `media` 下载上传。
@@ -64,7 +69,7 @@ message 远程 `media` 下载上传。
 | 2026-06-28 | 上线 npm `@jeik/dingtalk-connector`；过程消息提前定稿修复 |
 | 2026-05 | MD 直链/本地图；多轮刷屏；4.29+ 无文本输出；WebSocket 幻影重连 |
 
-完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix45](docs/RELEASE_NOTES_V0.8.21-fix45.md)
+完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix47](docs/RELEASE_NOTES_V0.8.21-fix47.md)
 
 ---
 

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-b4qQpdOB.mjs");
+		const { registerGatewayMethods } = await import("./gateway-methods-DHMdV0k8.mjs");
 		registerGatewayMethods(api);
 	}
 });

package/dist/gateway-methods-DHMdV0k8.mjs

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

package/dist/{gateway-methods-CCh-LutW.mjs → gateway-methods-DNvtOYEG.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-CpOPEOI8.mjs";
+import { c as prepareMultiBotMentions, d as finishAICard, i as sendProactive, s as buildBotMentionTable } from "./messaging-msXFq5IJ.mjs";
 import { c as getUnionId, d as recallEmotionReply } from "./utils-legacy-CALCPP1t.mjs";
 //#region src/docs.ts
 var DingtalkDocsClient = class {

package/dist/index.mjs

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

package/dist/{media-ClfWY5Cw.mjs → media-BqpUGCni.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-_qA1Qjt_.mjs";
+import { _ as toLocalPath, d as processLocalImages, f as processRawMediaPaths, h as sendFileProactive, o as hasResidualLocalMdImagesOutsideCode, p as processVideoMarkers } from "./media-DnQB2BrL.mjs";
 export { hasResidualLocalMdImagesOutsideCode, processLocalImages, processRawMediaPaths, processVideoMarkers, sendFileProactive, toLocalPath };

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

@@ -30,10 +30,18 @@ const IMAGE_EXTENSIONS = /\.(png|jpg|jpeg|gif|bmp|webp|tiff|svg)$/i;
 * 注意：旧版只匹配 /tmp|/home|/root 等前缀，**漏掉 /mnt 共享盘**，导致 message 工具 MD 灰图。
 */
 const LOCAL_IMAGE_RE = /!\[([^\]]*)\]\(([^)]+)\)/g;
-/** 是否像远程 URL 或其截断片段（禁止当本地路径上传） */
+/** 本地文件 URI / OpenClaw 媒体前缀（不是 http 远程） */
+function isLocalFileScheme(p) {
+	return p.startsWith("file://") || p.startsWith("MEDIA:") || p.startsWith("attachment://");
+}
+/**
+* 是否像远程 URL（禁止当本地路径上传）。
+* **不含** file:// / MEDIA: / attachment://（那些是本地引用）。
+*/
 function looksLikeRemoteUrl(raw) {
 	const p = (raw || "").trim();
 	if (!p) return false;
+	if (isLocalFileScheme(p)) return false;
 	if (/^https?:\/\//i.test(p)) return true;
 	if (/^[a-z]:\/\//i.test(p) && !/^[a-z]:[\\/][^/\\]/i.test(p)) return true;
 	if (p.includes("://")) return true;
@@ -43,9 +51,9 @@ function looksLikeRemoteUrl(raw) {
 function isLocalImageRef(rawPath) {
 	const p = (rawPath || "").trim();
 	if (!p) return false;
+	if (isLocalFileScheme(p)) return true;
 	if (looksLikeRemoteUrl(p) || /^https?:\/\//i.test(p)) return false;
 	if (p.startsWith("@") && !p.includes("/") && !p.includes("\\")) return false;
-	if (p.startsWith("file://") || p.startsWith("MEDIA:") || p.startsWith("attachment://")) return true;
 	if (p.startsWith("/") || /^[A-Za-z]:[\\/]/.test(p)) {
 		if (IMAGE_EXTENSIONS.test(p.split("?")[0] || p)) return true;
 		return !p.includes("://");
@@ -68,8 +76,9 @@ function toLocalPath(raw) {
 	return filePath;
 }
 /**
-* 本地图诊断：默认只 console 一行，不再 log.warn（避免 [sendTextToDingTalk] 双前缀刷屏）。
-* verbose 步骤（文件可读/realpath 等）仅 debug 时通过 log 输出。
+* 本地图诊断：默认 console.log 一行（不走 log.warn，避免 [sendTextToDingTalk] 双前缀）。
+* verbose=true 的细节（realpath 等）仅在 debug 时输出。
+* 决策路径（匹配/exists/上传成败/残留）务必 always-on，方便查灰图。
 */
 function logLocalImage(log, step, detail, verbose = false) {
 	const line = detail ? `[DingTalk][LocalImage] ${step} | ${detail}` : `[DingTalk][LocalImage] ${step}`;
@@ -81,21 +90,36 @@ function logLocalImage(log, step, detail, verbose = false) {
 	}
 	console.log(line);
 }
-/** 钉钉 mediaId 形态 */
+/** 钉钉 mediaId 形态（oapi 返回常带 @） */
 const MEDIA_ID_RE = /@[A-Za-z0-9_-]{8,}/g;
+function classifyMdImgTarget(target) {
+	const t = (target || "").trim();
+	if (!t) return "other";
+	if (t.startsWith("@") && !t.includes("/") && !t.includes("\\")) return "mediaId";
+	if (looksLikeRemoteUrl(t) || /^https?:\/\//i.test(t)) return "http";
+	if (isLocalImageRef(t)) return "local";
+	return "other";
+}
 /**
-* 精简 MediaId 追踪：默认只在关键节点 / 异常时打一行。
-* force=true 或发现「裸 mediaId」时才输出。
+* MediaId 追踪：关键节点 / force / 裸 mediaId 时输出。
+* 固定字段：mediaIdCount / ids / BARE_ids / mdImgs / httpCount / residualLocal / preview
+* （灰图排查：看 mdImgs 是 path:本地 还是 mediaId:@xxx，以及 residualLocal）
 */
 function logMediaIdTrace(stage, content, extra, force = false) {
 	const text = typeof content === "string" ? content : "";
 	const ids = [...new Set([...text.matchAll(MEDIA_ID_RE)].map((m) => m[0]))];
-	const inMd = new Set([...text.matchAll(LOCAL_IMAGE_RE)].map((m) => (m[2] || "").trim()));
+	const mdTargets = [...text.matchAll(LOCAL_IMAGE_RE)].map((m) => (m[2] || "").trim());
+	const inMd = new Set(mdTargets);
 	const bareIds = ids.filter((id) => !inMd.has(id));
+	const mdImgs = mdTargets.slice(0, 8).map((t) => {
+		return `${classifyMdImgTarget(t)}:${t.length > 100 ? `${t.slice(0, 100)}…` : t}`;
+	});
+	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 && !stage.includes("API前") && !stage.includes("完成")) return;
-	const preview = text.replace(/\n/g, "\\n").slice(0, 160);
-	console.log(`[DingTalk][MediaIdTrace] ${stage} | len=${text.length}` + (ids.length ? ` mediaIds=${ids.length}` : "") + (suspiciousBare.length ? ` ⚠️BARE=${suspiciousBare.join(",")}` : "") + (extra ? ` ${extra}` : "") + ` | ${preview}`);
+	if (!(force || suspiciousBare.length > 0 || residualLocal.length > 0 || /API前|完成|:out|:in|after-process|processImages/i.test(stage))) 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}"`);
 }
 /** Markdown 代码区域（围栏 ``` 与行内 `...`），其中的路径不应上传 */
 function getMarkdownCodeRanges(content) {
@@ -124,21 +148,21 @@ async function uploadMediaToDingTalk(filePath, mediaType, oapiToken, maxSize = 2
 	const tag = `uploadMedia type=${mediaType}`;
 	try {
 		let absPath = toLocalPath(filePath);
-		logLocalImage(log, `${tag} 开始`, `path=${absPath}`, true);
+		logLocalImage(log, `${tag} 开始`, `path=${absPath}`);
 		if (!fs.existsSync(absPath)) {
 			logLocalImage(log, `${tag} 失败:文件不存在`, absPath);
 			return null;
 		}
 		try {
 			const real = fs.realpathSync(absPath);
-			if (real !== absPath) logLocalImage(log, `${tag} realpath`, `${absPath} → ${real}`, true);
+			if (real !== absPath) logLocalImage(log, `${tag} realpath`, `${absPath} → ${real}`);
 			absPath = real;
 		} catch (e) {
 			logLocalImage(log, `${tag} realpath跳过`, e?.message || String(e), true);
 		}
 		const stats = fs.statSync(absPath);
 		const fileSizeMB = (stats.size / (1024 * 1024)).toFixed(2);
-		logLocalImage(log, `${tag} 文件可读`, `size=${fileSizeMB}MB`, true);
+		logLocalImage(log, `${tag} 文件可读`, `size=${fileSizeMB}MB mode=${stats.mode}`);
 		const effectiveMax = mediaType === "image" ? Math.min(maxSize, 10 * 1024 * 1024) : mediaType === "voice" ? Math.min(maxSize, 2 * 1024 * 1024) : maxSize;
 		if (stats.size > effectiveMax) {
 			const maxSizeMB = (effectiveMax / (1024 * 1024)).toFixed(0);
@@ -197,17 +221,26 @@ async function uploadMediaToDingTalk(filePath, mediaType, oapiToken, maxSize = 2
 */
 async function uploadLocalImageWithFallback(filePath, oapiToken, log) {
 	const absPath = toLocalPath(filePath);
-	if (!fs.existsSync(absPath)) {
+	const exists = fs.existsSync(absPath);
+	logLocalImage(log, "fallback 入口", `path=${absPath} exists=${exists}`);
+	if (!exists) {
 		logLocalImage(log, "fallback 失败:文件不存在", absPath);
 		return null;
 	}
+	logLocalImage(log, "fallback 第1次:直接上传", absPath);
 	let result = await uploadMediaToDingTalk(absPath, "image", oapiToken, 10 * 1024 * 1024, log);
-	if (result?.mediaId) return result;
+	if (result?.mediaId) {
+		logLocalImage(log, "fallback 第1次成功", result.mediaId);
+		return result;
+	}
 	const ext = path.extname(absPath) || ".jpg";
 	const tmp = path.join(os.tmpdir(), `dingtalk-img-${Date.now()}-${Math.random().toString(36).slice(2, 8)}${ext.toLowerCase()}`);
 	try {
 		fs.copyFileSync(absPath, tmp);
+		logLocalImage(log, "fallback 第2次:tmp重试", `${absPath} → ${tmp}`);
 		result = await uploadMediaToDingTalk(tmp, "image", oapiToken, 10 * 1024 * 1024, log);
+		if (result?.mediaId) logLocalImage(log, "fallback 第2次成功", result.mediaId);
+		else logLocalImage(log, "fallback 第2次仍失败", tmp);
 		return result;
 	} catch (err) {
 		logLocalImage(log, "fallback 拷贝/重试异常", `${absPath} err=${err?.message || err}`);
@@ -278,51 +311,109 @@ function replaceOutsideImageTargets(content, original, replacement) {
 *   （钉钉改写发生在「![] 与正文共用同一 http」时；![] 改成 mediaId 后即可同泡共存）
 * - 本地：正文重复的本地路径换成 down.dingtalk.com 可点链接（仍同一条消息）
 * - **不再拆第二条 text 消息**
+*
+* 日志约定（always-on，查灰图必看）：
+* - 开始 / 扫描每张 ![] / 本地 exists / 上传成败 / 远程下载 / 残留 / out
 */
 async function processImagesForOutbound(content, oapiToken, log) {
-	if (!oapiToken || !content || typeof content !== "string") return {
-		text: content || "",
-		followUpUrls: []
-	};
+	logLocalImage(log, "processImagesForOutbound 开始", `contentLen=${content?.length ?? 0} hasToken=${!!oapiToken}`);
+	if (!oapiToken) {
+		logLocalImage(log, "processImagesForOutbound 跳过", "无 oapiToken（本地路径无法上传→必灰图）");
+		logMediaIdTrace("processImagesForOutbound:skip-no-token", content, void 0, true);
+		return {
+			text: content || "",
+			followUpUrls: []
+		};
+	}
+	if (!content || typeof content !== "string") {
+		logLocalImage(log, "processImagesForOutbound 跳过", "content 为空");
+		return {
+			text: content || "",
+			followUpUrls: []
+		};
+	}
+	logMediaIdTrace("processImagesForOutbound:in", content, void 0, true);
 	const codeRanges = getMarkdownCodeRanges(content);
+	if (codeRanges.length > 0) logLocalImage(log, "processImagesForOutbound 代码区域", `count=${codeRanges.length}（围栏/行内 code 内的图路径将跳过）`);
 	const mdMatches = [...content.matchAll(LOCAL_IMAGE_RE)];
+	const scanPreview = mdMatches.map((m, i) => {
+		const p = (m[2] || "").trim();
+		const inCode = m.index !== void 0 && isIndexInCodeRange(m.index, codeRanges);
+		const kind = classifyMdImgTarget(p);
+		return `#${i + 1} kind=${kind} inCode=${inCode} path=${p.slice(0, 120)}`;
+	});
+	logLocalImage(log, "processImagesForOutbound 扫描 ![]()", scanPreview.length ? scanPreview.join(" || ") : "正文中没有任何 markdown 图片语法");
 	let result = content;
 	/** 本地路径 → 可点 downloadUrl（仅替换正文中的裸路径，不拆消息） */
 	const localPathToDl = /* @__PURE__ */ new Map();
 	let uploadCount = 0;
+	let localTried = 0;
+	let remoteTried = 0;
+	let skippedCode = 0;
+	let skippedOther = 0;
 	for (const match of mdMatches) {
-		if (match.index !== void 0 && isIndexInCodeRange(match.index, codeRanges)) continue;
+		if (match.index !== void 0 && isIndexInCodeRange(match.index, codeRanges)) {
+			skippedCode++;
+			logLocalImage(log, "processImagesForOutbound 跳过代码块内", (match[2] || "").trim().slice(0, 120));
+			continue;
+		}
 		const [fullMatch, alt, rawPath] = match;
 		const cleanPath = (rawPath || "").replace(/\\ /g, " ").trim();
 		if (!cleanPath) continue;
 		if (isLocalImageRef(cleanPath)) {
+			localTried++;
 			const absPath = toLocalPath(cleanPath);
+			let exists = false;
+			let sizeMB = "-";
+			try {
+				exists = fs.existsSync(absPath);
+				if (exists) sizeMB = (fs.statSync(absPath).size / (1024 * 1024)).toFixed(2);
+			} catch (e) {
+				logLocalImage(log, "processImagesForOutbound 本地 stat 异常", e?.message || String(e));
+			}
+			logLocalImage(log, "processImagesForOutbound 处理本地图", `alt=${alt || "-"} raw=${cleanPath.slice(0, 120)} abs=${absPath} exists=${exists} sizeMB=${sizeMB}`);
+			if (!exists) {
+				result = result.split(fullMatch).join(`📷 *图片文件不存在（${path.basename(absPath)}）*`);
+				logLocalImage(log, "processImagesForOutbound 本地文件不存在→失败提示", absPath);
+				continue;
+			}
 			try {
 				const uploadResult = await uploadLocalImageWithFallback(absPath, oapiToken, log);
 				if (uploadResult?.mediaId) {
-					result = result.split(fullMatch).join(`![${alt || path.basename(absPath)}](${uploadResult.mediaId})`);
+					const replacement = `![${alt || path.basename(absPath)}](${uploadResult.mediaId})`;
+					result = result.split(fullMatch).join(replacement);
 					uploadCount++;
 					if (uploadResult.downloadUrl) {
 						localPathToDl.set(cleanPath, uploadResult.downloadUrl);
 						localPathToDl.set(absPath, uploadResult.downloadUrl);
 					}
-				} else result = result.split(fullMatch).join(`📷 *图片上传失败（${path.basename(absPath)}）*`);
-			} catch {
+					logLocalImage(log, "processImagesForOutbound 本地→mediaId 成功", `${absPath} → ${uploadResult.mediaId}`);
+				} else {
+					result = result.split(fullMatch).join(`📷 *图片上传失败（${path.basename(absPath)}）*`);
+					logLocalImage(log, "processImagesForOutbound 本地上传失败→失败提示", absPath);
+				}
+			} catch (err) {
 				result = result.split(fullMatch).join(`📷 *图片上传异常（${path.basename(toLocalPath(cleanPath))}）*`);
+				logLocalImage(log, "processImagesForOutbound 本地上传异常", `${absPath} err=${err?.message || err}`);
 			}
 			continue;
 		}
 		if (looksLikeRemoteUrl(cleanPath)) {
+			remoteTried++;
+			logLocalImage(log, "processImagesForOutbound 远程图", cleanPath.slice(0, 160));
 			let tmp = null;
 			try {
 				tmp = await downloadRemoteUrlToTemp(cleanPath);
-				if (!tmp) continue;
+				if (!tmp) {
+					logLocalImage(log, "processImagesForOutbound 远程下载失败(保留原![]URL)", cleanPath.slice(0, 120));
+					continue;
+				}
 				const uploadResult = await uploadLocalImageWithFallback(tmp, oapiToken, log);
 				if (uploadResult?.mediaId) {
 					result = result.split(fullMatch).join(`![${alt || "image"}](${uploadResult.mediaId})`);
 					uploadCount++;
-					console.log(`[DingTalk][LocalImage] ![]远程→mediaId 下载链保留原URL | ${uploadResult.mediaId}`);
-				}
+					logLocalImage(log, "processImagesForOutbound 远程→mediaId 下载链保留原URL", `${cleanPath.slice(0, 80)} → ${uploadResult.mediaId}`);
+				} else logLocalImage(log, "processImagesForOutbound 远程上传失败(保留原![]URL)", cleanPath.slice(0, 120));
 			} catch (err) {
 				logLocalImage(log, "远程图处理失败", err?.message || String(err));
 			} finally {
@@ -330,11 +421,23 @@ async function processImagesForOutbound(content, oapiToken, log) {
 					fs.unlinkSync(tmp);
 				} catch {}
 			}
+			continue;
 		}
+		skippedOther++;
+		logLocalImage(log, "processImagesForOutbound 跳过非本地非远程", `kind=${classifyMdImgTarget(cleanPath)} path=${cleanPath.slice(0, 120)}`);
+	}
+	for (const [p, dl] of localPathToDl) {
+		const before = result;
+		result = replaceOutsideImageTargets(result, p, dl);
+		if (before !== result) logLocalImage(log, "processImagesForOutbound 正文裸本地路径→downloadUrl", `${p.slice(0, 80)} → ${dl}`);
 	}
-	for (const [p, dl] of localPathToDl) result = replaceOutsideImageTargets(result, p, dl);
-	console.log(`[DingTalk][LocalImage] processImagesForOutbound 完成 | uploads=${uploadCount} outLen=${result.length}`);
-	logMediaIdTrace("processImagesForOutbound:out", result);
+	const residual = [...result.matchAll(LOCAL_IMAGE_RE)].filter((m) => {
+		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 (residual.length) logLocalImage(log, "processImagesForOutbound ⚠️仍有代码块外本地路径未替换（钉钉必灰图）", residual.join(" | "));
+	logMediaIdTrace("processImagesForOutbound:out", result, void 0, true);
 	return {
 		text: result,
 		followUpUrls: []

package/dist/{message-handler-BKmyuozN.mjs → message-handler-DVXM5olz.mjs}

@@ -1,9 +1,9 @@
 import { a as resolveDingtalkAccount } from "./accounts-BAzdqkAV.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-Dj8jSHjE.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-f78QdJj5.mjs";
 import { n as createLoggerFromConfig } from "./logger-mZ9OSbmD.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-CpOPEOI8.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-msXFq5IJ.mjs";
 import { a as QUEUE_BUSY_ACK_PHRASES, n as normalizeSlashCommand, t as buildSessionContext } from "./session-DJ4jYqPv.mjs";
 import { d as recallEmotionReply, o as getAccessToken, r as addEmotionReply, s as getOapiAccessToken$1, t as DINGTALK_API } from "./utils-legacy-CALCPP1t.mjs";
 import "./chunk-upload-BBQgGtcZ.mjs";
@@ -62,7 +62,7 @@ function resolveAgentWorkspaceDir(cfg, agentId) {
 * 直接复用 media.ts 权威实现，避免 reply 路径与 message 路径两套逻辑分叉。
 */
 async function processLocalImages(content, oapiToken, log) {
-	const { processLocalImages: impl } = await import("./media-ClfWY5Cw.mjs");
+	const { processLocalImages: impl } = await import("./media-BqpUGCni.mjs");
 	return impl(content, oapiToken, log);
 }
 //#endregion
@@ -581,14 +581,14 @@ function createDingtalkReplyDispatcher(params) {
 				finalText = await processLocalImages(finalText, oapiToken, log);
 				if (beforeImg !== finalText) console.log(`[DingTalk][LocalImage] closeStreaming 图片处理 | ${beforeImg.length}→${finalText.length}`);
 				try {
-					const { hasResidualLocalMdImagesOutsideCode } = await import("./media-ClfWY5Cw.mjs");
+					const { hasResidualLocalMdImagesOutsideCode } = await import("./media-BqpUGCni.mjs");
 					if (hasResidualLocalMdImagesOutsideCode(finalText)) console.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-ClfWY5Cw.mjs");
+				const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
 				finalText = await processRawMediaPaths(finalText, account.config, oapiToken, log, target);
 				log.info(`[DingTalk][closeStreaming] processRawMediaPaths 处理完成`);
 			} else log.warn(`[DingTalk][closeStreaming] oapiToken 为空，跳过媒体处理`);
@@ -744,7 +744,7 @@ function createDingtalkReplyDispatcher(params) {
 					const oapiToken = await getOapiAccessToken(account.config);
 					if (oapiToken) {
 						log.info(`[DingTalk][deliver] 检测到 final 响应，准备处理裸露文件路径`);
-						const { processRawMediaPaths } = await import("./media-ClfWY5Cw.mjs");
+						const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
 						text = await processRawMediaPaths(text, account.config, oapiToken, log, target);
 						log.info(`[DingTalk][deliver] 裸露文件路径处理完成`);
 					}
@@ -2184,7 +2184,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-ClfWY5Cw.mjs");
+				const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
 				finalText = await processRawMediaPaths(finalText, config, oapiToken, log, mediaTarget);
 			}
 			const textToSend = finalText.trim() || "✅ 任务执行完成（无文本输出）";

package/dist/{messaging-CpOPEOI8.mjs → messaging-msXFq5IJ.mjs}

@@ -1,4 +1,4 @@
-import { c as logMediaIdTrace, d as processLocalImages, u as processImagesForOutbound, y as uploadMediaToDingTalk } from "./media-_qA1Qjt_.mjs";
+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 { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { i as getOapiAccessToken, r as getAccessToken, t as DINGTALK_API } from "./utils-CIfI_3Jh.mjs";
@@ -848,7 +848,7 @@ async function resolveMediaSourceToLocalFile(mediaUrl, mediaLocalRoots, log) {
 			cleanup: tmp
 		};
 	}
-	const { toLocalPath } = await import("./media-ClfWY5Cw.mjs");
+	const { toLocalPath } = await import("./media-BqpUGCni.mjs");
 	const _fs = await import("fs");
 	const _path = await import("path");
 	let resolved = toLocalPath(mediaUrl);
@@ -883,14 +883,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;
 	try {
 		const oapiToken = await getOapiAccessToken(config);
-		if (oapiToken && text) text = (await processImagesForOutbound(text, oapiToken, log)).text;
+		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 图会灰）`);
 	} catch (err) {
 		console.warn(`[DingTalk][LocalImage] sendTextToDingTalk 图片处理失败: ${err?.message || err}`);
 	}
 	const msgType = shouldSendAsMarkdown(text) ? "markdown" : "text";
-	logMediaIdTrace("sendTextToDingTalk:API前", text, `msgType=${msgType}`);
+	logMediaIdTrace("sendTextToDingTalk:API前", text, `msgType=${msgType}`, true);
 	return sendProactive(config, targetParam, text, {
 		msgType,
 		replyToId,
@@ -1113,7 +1121,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-ClfWY5Cw.mjs");
+				const { processVideoMarkers } = await import("./media-BqpUGCni.mjs");
 				await processVideoMarkers(videoMarker, "", config, oapiToken, console, true, targetParam);
 				return {
 					ok: true,
@@ -1132,7 +1140,7 @@ async function sendMediaToDingTalk(params) {
 				fileName,
 				fileType: ext && ext.length < 12 ? ext : "file"
 			};
-			const { sendFileProactive } = await import("./media-ClfWY5Cw.mjs");
+			const { sendFileProactive } = await import("./media-BqpUGCni.mjs");
 			await sendFileProactive(config, targetParam, fileInfo, uploadResult.mediaId, log);
 			return {
 				ok: true,

package/dist/{runtime-Dj8jSHjE.mjs → runtime-f78QdJj5.mjs}

@@ -1,9 +1,9 @@
-import { b as __exportAll } from "./media-_qA1Qjt_.mjs";
+import { b as __exportAll } from "./media-DnQB2BrL.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 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-CpOPEOI8.mjs";
+import { S as finalClean, f as getActiveCardForConversation, n as sendMediaToDingTalk, o as sendTextToDingTalk } from "./messaging-msXFq5IJ.mjs";
 import { createRequire } from "node:module";
 import { z, z as z$1 } from "zod";
 //#region src/secret-input.ts
@@ -930,7 +930,7 @@ 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-BKmyuozN.mjs"),
+		import("./message-handler-DVXM5olz.mjs"),
 		import("./connection-DHHFFNQJ.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;

package/docs/RELEASE_NOTES_V0.8.21-fix46.md

@@ -0,0 +1,45 @@
+# Release Notes — v0.8.21-fix46（2026-07-20）
+
+生产稳定版 / Production-stable community build of `@jeik/dingtalk-connector`。
+
+在 **fix45** 行为不变的基础上，补强 **message 本地 MD 图** 诊断日志，方便排查灰图。
+
+## 安装 / Install
+
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+本地 tgz：
+
+```bash
+openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix46.tgz --force
+openclaw gateway restart
+```
+
+## 本版要点 / Highlights
+
+| 领域 | 说明 |
+|------|------|
+| 诊断日志 | always-on 本地图流水线：匹配 → exists → 上传 → API 前 payload → residual |
+| MediaIdTrace | `mdImgs=[local:…\|mediaId:…]`、`residualLocal`、preview |
+| 业务逻辑 | **与 fix45 相同**（图+下载同泡、只认 `![]`、代码块跳过、CardCache） |
+
+## 查灰图时看哪些行
+
+```text
+[DingTalk][LocalImage] sendTextToDingTalk 入口 | ...
+[DingTalk][LocalImage] processImagesForOutbound 扫描 ![]() | #1 kind=local exists=...
+[DingTalk][LocalImage] processImagesForOutbound 本地→mediaId 成功 | ... → @lADP...
+[DingTalk][MediaIdTrace] sendTextToDingTalk:API前 | mdImgs=[mediaId:@lADP...] residualLocal=0
+```
+
+- `kind=local` 但 `exists=false` → 路径在 gateway 机上不存在  
+- 上传失败 → 会看到失败提示 / fallback 第2次  
+- API前仍是 `local:/tmp/...` 或 `residualLocal>0` → 未换成 mediaId  
+- API前已是 `mediaId:@lADP...` 仍灰 → 偏钉钉渲染/账号侧
+
+## 升级
+
+从 fix45 直接 `--force` 安装即可。

package/docs/RELEASE_NOTES_V0.8.21-fix47.md

@@ -0,0 +1,32 @@
+# Release Notes — v0.8.21-fix47（2026-07-20）
+
+## 安装 / Install
+
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+## 修复 / Fixed
+
+### `file://` MD 本地图灰图
+
+**现象（fix46 日志）：**
+
+```text
+扫描 ![]() | #2 kind=http path=file:///mnt/smb/...
+processImagesForOutbound 远程图 | file:///mnt/...
+远程图下载异常 | fetch failed
+localTried=0 remoteTried=3
+API前 mdImgs 仍含 http:file:///...
+```
+
+**原因：** `looksLikeRemoteUrl` 把任意含 `://` 的字符串当远程；`isLocalImageRef` 又先调用它，`file://` 永远进不了本地上传。
+
+**修复：** `file://` / `MEDIA:` / `attachment://` 优先判本地 → `toLocalPath` → 上传 mediaId。
+
+裸绝对路径 `/mnt/...`、`/tmp/...` 本来就正常；本版修的是 **带 `file://` 前缀** 的写法。
+
+## 升级
+
+从 fix46 直接 `--force` 安装。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeik/dingtalk-connector",
-  "version": "0.8.21-fix45",
+  "version": "0.8.21-fix47",
   "description": "OpenClaw DingTalk channel plugin (fork) | 钉钉 OpenClaw 渠道插件（fork 自官方，含标记/卡片渲染修复）",
   "type": "module",
   "exports": {

package/src/services/media/common.ts

@@ -28,18 +28,17 @@ export const IMAGE_EXTENSIONS = /\.(png|jpg|jpeg|gif|bmp|webp|tiff|svg)$/i;
  */
 export const LOCAL_IMAGE_RE = /!\[([^\]]*)\]\(([^)]+)\)/g;
 
-/** 是否为需上传的本地图引用 */
+/** 是否为需上传的本地图引用（与 media.ts 权威实现一致：file:// 必须算本地） */
 export function isLocalImageRef(rawPath: string): boolean {
   const p = (rawPath || "").trim();
   if (!p) return false;
-  if (/^https?:\/\//i.test(p)) return false;
-  if (p.includes("://") && !p.startsWith("file://") && !p.startsWith("MEDIA:") && !p.startsWith("attachment://")) {
-    return false;
-  }
-  if (p.startsWith("@") && !p.includes("/") && !p.includes("\\")) return false;
+  // file:// 等本地 scheme 优先（勿被 includes("://") 挡掉）
   if (p.startsWith("file://") || p.startsWith("MEDIA:") || p.startsWith("attachment://")) {
     return true;
   }
+  if (/^https?:\/\//i.test(p)) return false;
+  if (p.includes("://")) return false;
+  if (p.startsWith("@") && !p.includes("/") && !p.includes("\\")) return false;
   if (p.startsWith("/") || /^[A-Za-z]:[\\/]/.test(p)) {
     if (IMAGE_EXTENSIONS.test(p.split("?")[0] || p)) return true;
     return !p.includes("://");

package/src/services/media.ts

@@ -45,11 +45,26 @@ export const IMAGE_EXTENSIONS = /\.(png|jpg|jpeg|gif|bmp|webp|tiff|svg)$/i;
  */
 export const LOCAL_IMAGE_RE = /!\[([^\]]*)\]\(([^)]+)\)/g;
 
-/** 是否像远程 URL 或其截断片段（禁止当本地路径上传） */
+/** 本地文件 URI / OpenClaw 媒体前缀（不是 http 远程） */
+function isLocalFileScheme(p: string): boolean {
+  return (
+    p.startsWith("file://") ||
+    p.startsWith("MEDIA:") ||
+    p.startsWith("attachment://")
+  );
+}
+
+/**
+ * 是否像远程 URL（禁止当本地路径上传）。
+ * **不含** file:// / MEDIA: / attachment://（那些是本地引用）。
+ */
 export function looksLikeRemoteUrl(raw: string): boolean {
   const p = (raw || "").trim();
   if (!p) return false;
+  // 本地 scheme 优先：否则 file:// 会被 includes("://") 误判成远程 → fetch 失败 → 灰图
+  if (isLocalFileScheme(p)) return false;
   if (/^https?:\/\//i.test(p)) return true;
+  // 伪协议截断如 p://（Windows 路径被当 URL 的历史坑）
   if (/^[a-z]:\/\//i.test(p) && !/^[a-z]:[\\/][^/\\]/i.test(p)) return true;
   if (p.includes("://")) return true;
   return false;
@@ -156,12 +171,11 @@ export function protectNonImageOccurrencesOfTargets(
 export function isLocalImageRef(rawPath: string): boolean {
   const p = (rawPath || "").trim();
   if (!p) return false;
+  // file:// / MEDIA: / attachment:// 一律本地（必须先于 looksLikeRemoteUrl）
+  if (isLocalFileScheme(p)) return true;
   // 已是远程 URL 或钉钉 mediaId（@ 开头）→ 不上传
   if (looksLikeRemoteUrl(p) || /^https?:\/\//i.test(p)) return false;
   if (p.startsWith("@") && !p.includes("/") && !p.includes("\\")) return false;
-  if (p.startsWith("file://") || p.startsWith("MEDIA:") || p.startsWith("attachment://")) {
-    return true;
-  }
   // Unix 绝对路径 / Windows 盘符
   if (p.startsWith("/") || /^[A-Za-z]:[\\/]/.test(p)) {
     // 有图片后缀，或路径中明显是文件（含扩展名）
@@ -211,8 +225,9 @@ export interface UploadResult {
 }
 
 /**
- * 本地图诊断：默认只 console 一行，不再 log.warn（避免 [sendTextToDingTalk] 双前缀刷屏）。
- * verbose 步骤（文件可读/realpath 等）仅 debug 时通过 log 输出。
+ * 本地图诊断：默认 console.log 一行（不走 log.warn，避免 [sendTextToDingTalk] 双前缀）。
+ * verbose=true 的细节（realpath 等）仅在 debug 时输出。
+ * 决策路径（匹配/exists/上传成败/残留）务必 always-on，方便查灰图。
  */
 function logLocalImage(log: any, step: string, detail?: string, verbose = false) {
   const line = detail
@@ -229,12 +244,22 @@ function logLocalImage(log: any, step: string, detail?: string, verbose = false)
   console.log(line);
 }
 
-/** 钉钉 mediaId 形态 */
+/** 钉钉 mediaId 形态（oapi 返回常带 @） */
 const MEDIA_ID_RE = /@[A-Za-z0-9_-]{8,}/g;
 
+function classifyMdImgTarget(target: string): "mediaId" | "http" | "local" | "other" {
+  const t = (target || "").trim();
+  if (!t) return "other";
+  if (t.startsWith("@") && !t.includes("/") && !t.includes("\\")) return "mediaId";
+  if (looksLikeRemoteUrl(t) || /^https?:\/\//i.test(t)) return "http";
+  if (isLocalImageRef(t)) return "local";
+  return "other";
+}
+
 /**
- * 精简 MediaId 追踪：默认只在关键节点 / 异常时打一行。
- * force=true 或发现「裸 mediaId」时才输出。
+ * MediaId 追踪：关键节点 / force / 裸 mediaId 时输出。
+ * 固定字段：mediaIdCount / ids / BARE_ids / mdImgs / httpCount / residualLocal / preview
+ * （灰图排查：看 mdImgs 是 path:本地 还是 mediaId:@xxx，以及 residualLocal）
  */
 export function logMediaIdTrace(
   stage: string,
@@ -244,23 +269,42 @@ export function logMediaIdTrace(
 ): void {
   const text = typeof content === "string" ? content : "";
   const ids = [...new Set([...text.matchAll(MEDIA_ID_RE)].map((m) => m[0]))];
-  const inMd = new Set(
-    [...text.matchAll(LOCAL_IMAGE_RE)].map((m) => (m[2] || "").trim()),
-  );
+  const mdTargets = [...text.matchAll(LOCAL_IMAGE_RE)].map((m) => (m[2] || "").trim());
+  const inMd = new Set(mdTargets);
   const bareIds = ids.filter((id) => !inMd.has(id));
+  const mdImgs = mdTargets.slice(0, 8).map((t) => {
+    const kind = classifyMdImgTarget(t);
+    const short = t.length > 100 ? `${t.slice(0, 100)}…` : t;
+    return `${kind}:${short}`;
+  });
+  const residualLocal = mdTargets.filter((t) => isLocalImageRef(t));
+  const httpCount = (text.match(/https?:\/\//gi) || []).length;
   // sampleImageMsg 的 photoURL 就是裸 mediaId，不算异常
   const isImageMsg = /type=image|sampleImage|photoURL/i.test(`${stage} ${extra || ""}`);
   const suspiciousBare = isImageMsg ? [] : bareIds;
-  if (!force && suspiciousBare.length === 0 && !stage.includes("API前") && !stage.includes("完成")) {
-    return;
-  }
-  const preview = text.replace(/\n/g, "\\n").slice(0, 160);
+  const always =
+    force ||
+    suspiciousBare.length > 0 ||
+    residualLocal.length > 0 ||
+    /API前|完成|:out|:in|after-process|processImages/i.test(stage);
+  if (!always) return;
+
+  const preview = text.replace(/\n/g, "\\n").slice(0, 200);
   console.log(
     `[DingTalk][MediaIdTrace] ${stage} | len=${text.length}` +
-      (ids.length ? ` mediaIds=${ids.length}` : "") +
-      (suspiciousBare.length ? ` ⚠️BARE=${suspiciousBare.join(",")}` : "") +
+      ` 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="${preview}"`,
   );
 }
 
@@ -298,7 +342,8 @@ export async function uploadMediaToDingTalk(
   const tag = `uploadMedia type=${mediaType}`;
   try {
     let absPath = toLocalPath(filePath);
-    logLocalImage(log, `${tag} 开始`, `path=${absPath}`, true);
+    // 上传起止 always-on：灰图时必须能看到是否走到 OAPI、文件是否可读
+    logLocalImage(log, `${tag} 开始`, `path=${absPath}`);
 
     if (!fs.existsSync(absPath)) {
       logLocalImage(log, `${tag} 失败:文件不存在`, absPath);
@@ -309,7 +354,7 @@ export async function uploadMediaToDingTalk(
     try {
       const real = fs.realpathSync(absPath);
       if (real !== absPath) {
-        logLocalImage(log, `${tag} realpath`, `${absPath} → ${real}`, true);
+        logLocalImage(log, `${tag} realpath`, `${absPath} → ${real}`);
       }
       absPath = real;
     } catch (e: any) {
@@ -319,7 +364,7 @@ export async function uploadMediaToDingTalk(
     // 检查文件大小
     const stats = fs.statSync(absPath);
     const fileSizeMB = (stats.size / (1024 * 1024)).toFixed(2);
-    logLocalImage(log, `${tag} 文件可读`, `size=${fileSizeMB}MB`, true);
+    logLocalImage(log, `${tag} 文件可读`, `size=${fileSizeMB}MB mode=${stats.mode}`);
 
     // 钉钉 image 类型官方上限约 10MB；调用方若传入更大 limit 也按类型收紧
     const effectiveMax =
@@ -429,13 +474,17 @@ export async function uploadLocalImageWithFallback(
   log?: any,
 ): Promise<UploadResult | null> {
   const absPath = toLocalPath(filePath);
-  if (!fs.existsSync(absPath)) {
+  const exists = fs.existsSync(absPath);
+  logLocalImage(log, "fallback 入口", `path=${absPath} exists=${exists}`);
+  if (!exists) {
     logLocalImage(log, "fallback 失败:文件不存在", absPath);
     return null;
   }
 
+  logLocalImage(log, "fallback 第1次:直接上传", absPath);
   let result = await uploadMediaToDingTalk(absPath, "image", oapiToken, 10 * 1024 * 1024, log);
   if (result?.mediaId) {
+    logLocalImage(log, "fallback 第1次成功", result.mediaId);
     return result;
   }
 
@@ -447,7 +496,13 @@ export async function uploadLocalImageWithFallback(
   );
   try {
     fs.copyFileSync(absPath, tmp);
+    logLocalImage(log, "fallback 第2次:tmp重试", `${absPath} → ${tmp}`);
     result = await uploadMediaToDingTalk(tmp, "image", oapiToken, 10 * 1024 * 1024, log);
+    if (result?.mediaId) {
+      logLocalImage(log, "fallback 第2次成功", result.mediaId);
+    } else {
+      logLocalImage(log, "fallback 第2次仍失败", tmp);
+    }
     return result;
   } catch (err: any) {
     logLocalImage(
@@ -543,68 +598,158 @@ function replaceOutsideImageTargets(
  *   （钉钉改写发生在「![] 与正文共用同一 http」时；![] 改成 mediaId 后即可同泡共存）
  * - 本地：正文重复的本地路径换成 down.dingtalk.com 可点链接（仍同一条消息）
  * - **不再拆第二条 text 消息**
+ *
+ * 日志约定（always-on，查灰图必看）：
+ * - 开始 / 扫描每张 ![] / 本地 exists / 上传成败 / 远程下载 / 残留 / out
  */
 export async function processImagesForOutbound(
   content: string,
   oapiToken: string | null,
   log?: any,
 ): Promise<ProcessImagesOutboundResult> {
-  if (!oapiToken || !content || typeof content !== "string") {
+  logLocalImage(
+    log,
+    "processImagesForOutbound 开始",
+    `contentLen=${content?.length ?? 0} hasToken=${!!oapiToken}`,
+  );
+  if (!oapiToken) {
+    logLocalImage(log, "processImagesForOutbound 跳过", "无 oapiToken（本地路径无法上传→必灰图）");
+    logMediaIdTrace("processImagesForOutbound:skip-no-token", content, undefined, true);
+    return { text: content || "", followUpUrls: [] };
+  }
+  if (!content || typeof content !== "string") {
+    logLocalImage(log, "processImagesForOutbound 跳过", "content 为空");
     return { text: content || "", followUpUrls: [] };
   }
 
+  logMediaIdTrace("processImagesForOutbound:in", content, undefined, true);
+
   const codeRanges = getMarkdownCodeRanges(content);
+  if (codeRanges.length > 0) {
+    logLocalImage(
+      log,
+      "processImagesForOutbound 代码区域",
+      `count=${codeRanges.length}（围栏/行内 code 内的图路径将跳过）`,
+    );
+  }
+
   const mdMatches = [...content.matchAll(LOCAL_IMAGE_RE)];
+  const scanPreview = mdMatches.map((m, i) => {
+    const p = (m[2] || "").trim();
+    const inCode = m.index !== undefined && isIndexInCodeRange(m.index, codeRanges);
+    const kind = classifyMdImgTarget(p);
+    return `#${i + 1} kind=${kind} inCode=${inCode} path=${p.slice(0, 120)}`;
+  });
+  logLocalImage(
+    log,
+    "processImagesForOutbound 扫描 ![]()",
+    scanPreview.length ? scanPreview.join(" || ") : "正文中没有任何 markdown 图片语法",
+  );
+
   let result = content;
   /** 本地路径 → 可点 downloadUrl（仅替换正文中的裸路径，不拆消息） */
   const localPathToDl = new Map<string, string>();
   let uploadCount = 0;
+  let localTried = 0;
+  let remoteTried = 0;
+  let skippedCode = 0;
+  let skippedOther = 0;
 
   for (const match of mdMatches) {
-    if (match.index !== undefined && isIndexInCodeRange(match.index, codeRanges)) continue;
+    if (match.index !== undefined && isIndexInCodeRange(match.index, codeRanges)) {
+      skippedCode++;
+      logLocalImage(
+        log,
+        "processImagesForOutbound 跳过代码块内",
+        (match[2] || "").trim().slice(0, 120),
+      );
+      continue;
+    }
     const [fullMatch, alt, rawPath] = match;
     const cleanPath = (rawPath || "").replace(/\\ /g, " ").trim();
     if (!cleanPath) continue;
 
     if (isLocalImageRef(cleanPath)) {
+      localTried++;
       const absPath = toLocalPath(cleanPath);
+      let exists = false;
+      let sizeMB = "-";
+      try {
+        exists = fs.existsSync(absPath);
+        if (exists) {
+          sizeMB = (fs.statSync(absPath).size / (1024 * 1024)).toFixed(2);
+        }
+      } catch (e: any) {
+        logLocalImage(log, "processImagesForOutbound 本地 stat 异常", e?.message || String(e));
+      }
+      logLocalImage(
+        log,
+        "processImagesForOutbound 处理本地图",
+        `alt=${alt || "-"} raw=${cleanPath.slice(0, 120)} abs=${absPath} exists=${exists} sizeMB=${sizeMB}`,
+      );
+      if (!exists) {
+        result = result
+          .split(fullMatch)
+          .join(`📷 *图片文件不存在（${path.basename(absPath)}）*`);
+        logLocalImage(log, "processImagesForOutbound 本地文件不存在→失败提示", absPath);
+        continue;
+      }
       try {
         const uploadResult = await uploadLocalImageWithFallback(absPath, oapiToken, log);
         if (uploadResult?.mediaId) {
-          result = result
-            .split(fullMatch)
-            .join(`![${alt || path.basename(absPath)}](${uploadResult.mediaId})`);
+          const replacement = `![${alt || path.basename(absPath)}](${uploadResult.mediaId})`;
+          result = result.split(fullMatch).join(replacement);
           uploadCount++;
           if (uploadResult.downloadUrl) {
             localPathToDl.set(cleanPath, uploadResult.downloadUrl);
             localPathToDl.set(absPath, uploadResult.downloadUrl);
           }
+          logLocalImage(
+            log,
+            "processImagesForOutbound 本地→mediaId 成功",
+            `${absPath} → ${uploadResult.mediaId}`,
+          );
         } else {
           result = result
             .split(fullMatch)
             .join(`📷 *图片上传失败（${path.basename(absPath)}）*`);
+          logLocalImage(log, "processImagesForOutbound 本地上传失败→失败提示", absPath);
         }
-      } catch {
+      } catch (err: any) {
         result = result
           .split(fullMatch)
           .join(`📷 *图片上传异常（${path.basename(toLocalPath(cleanPath))}）*`);
+        logLocalImage(
+          log,
+          "processImagesForOutbound 本地上传异常",
+          `${absPath} err=${err?.message || err}`,
+        );
       }
       continue;
     }
 
     if (looksLikeRemoteUrl(cleanPath)) {
+      remoteTried++;
+      logLocalImage(log, "processImagesForOutbound 远程图", cleanPath.slice(0, 160));
       let tmp: string | null = null;
       try {
         tmp = await downloadRemoteUrlToTemp(cleanPath);
-        if (!tmp) continue;
+        if (!tmp) {
+          logLocalImage(log, "processImagesForOutbound 远程下载失败(保留原![]URL)", cleanPath.slice(0, 120));
+          continue;
+        }
         const uploadResult = await uploadLocalImageWithFallback(tmp, oapiToken, log);
         if (uploadResult?.mediaId) {
           // 只改 ![] 为 mediaId；正文「下载链接：http://…」保持原 URL，同一条消息
           result = result.split(fullMatch).join(`![${alt || "image"}](${uploadResult.mediaId})`);
           uploadCount++;
-          console.log(
-            `[DingTalk][LocalImage] ![]远程→mediaId 下载链保留原URL | ${uploadResult.mediaId}`,
+          logLocalImage(
+            log,
+            "processImagesForOutbound 远程→mediaId 下载链保留原URL",
+            `${cleanPath.slice(0, 80)} → ${uploadResult.mediaId}`,
           );
+        } else {
+          logLocalImage(log, "processImagesForOutbound 远程上传失败(保留原![]URL)", cleanPath.slice(0, 120));
         }
       } catch (err: any) {
         logLocalImage(log, "远程图处理失败", err?.message || String(err));
@@ -617,18 +762,55 @@ export async function processImagesForOutbound(
           }
         }
       }
+      continue;
     }
+
+    skippedOther++;
+    logLocalImage(
+      log,
+      "processImagesForOutbound 跳过非本地非远程",
+      `kind=${classifyMdImgTarget(cleanPath)} path=${cleanPath.slice(0, 120)}`,
+    );
   }
 
   // 本地路径若在「下载链接」等处再出现：换成可点 downloadUrl（仍同一气泡）
   for (const [p, dl] of localPathToDl) {
+    const before = result;
     result = replaceOutsideImageTargets(result, p, dl);
+    if (before !== result) {
+      logLocalImage(
+        log,
+        "processImagesForOutbound 正文裸本地路径→downloadUrl",
+        `${p.slice(0, 80)} → ${dl}`,
+      );
+    }
   }
 
-  console.log(
-    `[DingTalk][LocalImage] processImagesForOutbound 完成 | uploads=${uploadCount} outLen=${result.length}`,
+  const residual = [...result.matchAll(LOCAL_IMAGE_RE)]
+    .filter((m) => {
+      if (m.index !== undefined && 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"),
   );
-  logMediaIdTrace("processImagesForOutbound:out", result);
+  if (residual.length) {
+    logLocalImage(
+      log,
+      "processImagesForOutbound ⚠️仍有代码块外本地路径未替换（钉钉必灰图）",
+      residual.join(" | "),
+    );
+  }
+  logMediaIdTrace("processImagesForOutbound:out", result, undefined, true);
 
   return { text: result, followUpUrls: [] };
 }

package/src/services/messaging.ts

@@ -842,12 +842,29 @@ 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（不拆消息）
+  const beforeLen = text?.length ?? 0;
   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) {
+      console.warn(
+        `[DingTalk][LocalImage] sendTextToDingTalk 无 oapiToken，跳过图片上传（本地 MD 图会灰）`,
+      );
     }
   } catch (err: any) {
     console.warn(
@@ -856,7 +873,7 @@ export async function sendTextToDingTalk(params: {
   }
 
   const msgType: DingTalkMsgType = shouldSendAsMarkdown(text) ? "markdown" : "text";
-  logMediaIdTrace("sendTextToDingTalk:API前", text, `msgType=${msgType}`);
+  logMediaIdTrace("sendTextToDingTalk:API前", text, `msgType=${msgType}`, true);
 
   return sendProactive(config, targetParam, text, {
     msgType,

package/dist/gateway-methods-b4qQpdOB.mjs

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