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

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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-fix45] - 2026-07-20
+
+生产稳定版 / Production-stable community release。
+
+### 修复 / Fixed
+- 🐛 **message 图 + 下载链接被改成 mediaId** — 钉钉 `sampleMarkdown` 在「`![](http)` 与正文同一 URL」时会把下载位改写成 `@lADP…`。现：`![](http)` **下载上传 → mediaId**；**下载链接原 URL 留在同一条消息**（不拆第二条气泡）。  
+- 🐛 **只处理明确 `![]()`** — 删除裸路径自动扫描（与代码块误转 mediaId 同类根因）。  
+- 🐛 **closeStreaming 误报「仍含本地路径 MD 图」** — 代码块/示例 JSON 里的 `/tmp/...` 不再告警。  
+- 🐛 **引用 AI 卡片无正文** — 定稿缓存 `outTrackId → 正文`，引用时按会话回填（`CardCache`）。  
+- 🐛 **message `media=https://...`** — 远程 media 先下载再上传（fix38）。  
+
+### 日志 / Logs
+- 精简 `[DingTalk][LocalImage]` / `[MediaIdTrace]`（去掉双前缀刷屏，保留 API 前关键行）。
+
+### 安装 / Install
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+### 从 fix38～fix44 升级
+直接 `--force` 装 fix45 即可，包含上述全部修复。
+
 ## [0.8.21-fix38] - 2026-07-20
 
 ### 修复 / Fixed

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-fix38</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-fix45</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,20 +23,25 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix38 · 2026-07-20 (current)
+### 🚀 v0.8.21-fix45 · 2026-07-20 (current)
 
-**Theme: message tool remote https media**
+**Theme: image + download link in one bubble · only `![]` · quote card cache**
 
 | | Change |
 |--|--------|
-| 🌐 **Remote media** | `media: "https://..."` is **downloaded then uploaded** (no more local-path “file not found”) |
-| 🖼️ **Extensionless hosts** | e.g. `picsum.photos/seed/...` treated as **image** |
-| 🛟 **Fallback** | photoURL direct send if download/re-upload fails; logs `[DingTalk][RemoteMedia]` |
+| 📷 **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 |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix38 · 2026-07-20
+
+Remote `media` download-then-upload.
+
 ### 📦 v0.8.21-fix37 · 2026-07-20
 
 **Theme: local images (incl. `/mnt`) · message media layout · diagnostics**

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-fix38</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix38.tgz --force`）</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>
     <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,20 +23,25 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.21-fix38 · 2026-07-20（当前）
+### 🚀 v0.8.21-fix45 · 2026-07-20（当前）
 
-**主题：message 工具远程 https 媒体**
+**主题：图 + 下载链接单气泡 · 只认 `![]` · 引用卡片缓存**
 
 | | 改动 |
 |--|------|
-| 🌐 **远程 media** | `media: "https://..."` **先下载再上传**，不再当本地路径报「文件不存在」 |
-| 🖼️ **无扩展名图床** | 如 `picsum.photos/seed/...` 默认按 **image**（不再误判 file） |
-| 🛟 **兜底** | 下载/再上传失败时尝试 photoURL 直链；日志前缀 `[DingTalk][RemoteMedia]` |
+| 📷 **图 + 下载链** | `![](http)` 上传为 mediaId；**下载链接原 URL 留在同一条消息**（不被钉钉改成 `@lADP`） |
+| ✅ **只处理 `![]()`** | 不扫裸路径；代码块内路径不上传、不误报灰图 |
+| 📎 **引用 AI 卡** | 定稿缓存正文，引用时回填（`CardCache`） |
+| 🌐 **message media** | `media: "https://..."` 下载再上传 |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix38 · 2026-07-20
+
+message 远程 `media` 下载上传。
+
 ### 📦 v0.8.21-fix37 · 2026-07-20
 
 **主题：本地图（含 `/mnt`）· message 文图策略 · 可观测日志**
@@ -59,7 +64,7 @@ npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 | 2026-06-28 | 上线 npm `@jeik/dingtalk-connector`；过程消息提前定稿修复 |
 | 2026-05 | MD 直链/本地图；多轮刷屏；4.29+ 无文本输出；WebSocket 幻影重连 |
 
-完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix38](docs/RELEASE_NOTES_V0.8.21-fix38.md)
+完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix45](docs/RELEASE_NOTES_V0.8.21-fix45.md)
 
 ---
 

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

@@ -0,0 +1,106 @@
+//#region src/services/messaging/card-content-cache.ts
+const MAX_ENTRIES = 300;
+/** 默认保留 7 天（引用历史卡片） */
+const DEFAULT_TTL_MS = 10080 * 60 * 1e3;
+const byKey = /* @__PURE__ */ new Map();
+/** 每个会话最近若干条（新→旧） */
+const byConversation = /* @__PURE__ */ new Map();
+function pruneExpired(now = Date.now(), ttlMs = DEFAULT_TTL_MS) {
+	for (const [k, v] of byKey) if (now - v.at > ttlMs) byKey.delete(k);
+	if (byKey.size <= MAX_ENTRIES) return;
+	const sorted = [...byKey.entries()].sort((a, b) => a[1].at - b[1].at);
+	const drop = sorted.length - MAX_ENTRIES;
+	for (let i = 0; i < drop; i++) byKey.delete(sorted[i][0]);
+}
+function normalizeKey(kind, id) {
+	return `${kind}:${id.trim()}`;
+}
+/**
+* 记住一张卡的终稿正文
+*/
+function rememberCardContent(params) {
+	const text = (params.text || "").trim();
+	if (!text) return;
+	const entry = {
+		text,
+		at: Date.now(),
+		conversationId: params.conversationId,
+		outTrackId: params.outTrackId,
+		msgId: params.msgId
+	};
+	pruneExpired();
+	if (params.outTrackId) byKey.set(normalizeKey("outTrack", params.outTrackId), entry);
+	if (params.msgId) byKey.set(normalizeKey("msgId", params.msgId), entry);
+	if (params.conversationId) {
+		const cid = params.conversationId;
+		const list = byConversation.get(cid) || [];
+		const ref = params.outTrackId || params.msgId || `t${entry.at}`;
+		const next = [ref, ...list.filter((x) => x !== ref)].slice(0, 20);
+		byConversation.set(cid, next);
+		byKey.set(normalizeKey("convRef", `${cid}|${ref}`), entry);
+	}
+	try {
+		console.log(`[DingTalk][CardCache] 已缓存 | outTrack=${params.outTrackId || "-"} conv=${params.conversationId || "-"} len=${text.length}`);
+	} catch {}
+}
+/**
+* 从引用载荷里可能出现的字段收集候选 id
+*/
+function collectCardLookupIds(repliedMsg, contentObj) {
+	const ids = [];
+	const push = (v) => {
+		if (typeof v === "string" && v.trim()) ids.push(v.trim());
+	};
+	push(contentObj?.outTrackId);
+	push(contentObj?.outTrackID);
+	push(contentObj?.cardInstanceId);
+	push(contentObj?.cardInstanceID);
+	push(contentObj?.trackId);
+	push(contentObj?.bizId);
+	push(contentObj?.cardBizId);
+	push(contentObj?.instanceId);
+	push(repliedMsg?.outTrackId);
+	push(repliedMsg?.cardInstanceId);
+	push(repliedMsg?.msgId);
+	push(repliedMsg?.msgID);
+	push(repliedMsg?.messageId);
+	const nests = [
+		contentObj?.cardData,
+		contentObj?.data,
+		contentObj?.bizData
+	];
+	for (const n of nests) {
+		if (!n || typeof n !== "object") continue;
+		push(n.outTrackId);
+		push(n.cardInstanceId);
+		push(n.trackId);
+	}
+	return [...new Set(ids)];
+}
+/**
+* 查找缓存正文
+*/
+function lookupCardContent(params) {
+	pruneExpired();
+	const ids = params.ids || [];
+	for (const id of ids) {
+		const a = byKey.get(normalizeKey("outTrack", id));
+		if (a?.text) return a.text;
+		const b = byKey.get(normalizeKey("msgId", id));
+		if (b?.text) return b.text;
+	}
+	if (params.allowConversationRecent !== false && params.conversationId) {
+		const list = byConversation.get(params.conversationId) || [];
+		for (const ref of list) {
+			const e = byKey.get(normalizeKey("outTrack", ref)) || byKey.get(normalizeKey("msgId", ref)) || byKey.get(normalizeKey("convRef", `${params.conversationId}|${ref}`));
+			if (e?.text && e.text !== "✅ 思考完成") return e.text;
+		}
+		for (const ref of list) {
+			const e = byKey.get(normalizeKey("outTrack", ref)) || byKey.get(normalizeKey("msgId", ref)) || byKey.get(normalizeKey("convRef", `${params.conversationId}|${ref}`));
+			if (e?.text) return e.text;
+		}
+	}
+	return null;
+}
+//#endregion
+export { lookupCardContent as n, rememberCardContent as r, collectCardLookupIds as t };

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

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

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

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

package/dist/gateway-methods-b4qQpdOB.mjs

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

package/dist/index.mjs

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

package/dist/media-ClfWY5Cw.mjs

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

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

@@ -30,13 +30,20 @@ const IMAGE_EXTENSIONS = /\.(png|jpg|jpeg|gif|bmp|webp|tiff|svg)$/i;
 * 注意：旧版只匹配 /tmp|/home|/root 等前缀，**漏掉 /mnt 共享盘**，导致 message 工具 MD 灰图。
 */
 const LOCAL_IMAGE_RE = /!\[([^\]]*)\]\(([^)]+)\)/g;
-/** 纯文本里的绝对本地图片路径（含 /mnt 共享盘） */
-const BARE_IMAGE_PATH_RE = /`?((?:\/(?:tmp|var|private|Users|home|root|mnt|opt|data|Volumes)\/[^\s`'",)]+|[A-Za-z]:[\\/][^\s`'",)]+)\.(?:png|jpg|jpeg|gif|bmp|webp|tiff|svg))`?/gi;
+/** 是否像远程 URL 或其截断片段（禁止当本地路径上传） */
+function looksLikeRemoteUrl(raw) {
+	const p = (raw || "").trim();
+	if (!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;
+	return false;
+}
 /** 判断 markdown 图片 target 是否为需要上传的本地路径（非 http(s)/mediaId） */
 function isLocalImageRef(rawPath) {
 	const p = (rawPath || "").trim();
 	if (!p) return false;
-	if (/^https?:\/\//i.test(p)) return false;
+	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)) {
@@ -61,15 +68,34 @@ function toLocalPath(raw) {
 	return filePath;
 }
 /**
-* 本地图诊断日志：始终打到 stdout（不依赖 config.debug）。
-* 同时尽量走 log.warn，便于 gateway 文件日志收集。
+* 本地图诊断：默认只 console 一行，不再 log.warn（避免 [sendTextToDingTalk] 双前缀刷屏）。
+* verbose 步骤（文件可读/realpath 等）仅 debug 时通过 log 输出。
 */
-function logLocalImage(log, step, detail) {
+function logLocalImage(log, step, detail, verbose = false) {
 	const line = detail ? `[DingTalk][LocalImage] ${step} | ${detail}` : `[DingTalk][LocalImage] ${step}`;
+	if (verbose) {
+		try {
+			log?.debug?.(line);
+		} catch {}
+		return;
+	}
 	console.log(line);
-	try {
-		log?.warn?.(line);
-	} catch {}
+}
+/** 钉钉 mediaId 形态 */
+const MEDIA_ID_RE = /@[A-Za-z0-9_-]{8,}/g;
+/**
+* 精简 MediaId 追踪：默认只在关键节点 / 异常时打一行。
+* force=true 或发现「裸 mediaId」时才输出。
+*/
+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 bareIds = ids.filter((id) => !inMd.has(id));
+	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}`);
 }
 /** Markdown 代码区域（围栏 ``` 与行内 `...`），其中的路径不应上传 */
 function getMarkdownCodeRanges(content) {
@@ -98,21 +124,21 @@ async function uploadMediaToDingTalk(filePath, mediaType, oapiToken, maxSize = 2
 	const tag = `uploadMedia type=${mediaType}`;
 	try {
 		let absPath = toLocalPath(filePath);
-		logLocalImage(log, `${tag} 开始`, `path=${absPath}`);
+		logLocalImage(log, `${tag} 开始`, `path=${absPath}`, true);
 		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}`);
+			if (real !== absPath) logLocalImage(log, `${tag} realpath`, `${absPath} → ${real}`, true);
 			absPath = real;
 		} catch (e) {
-			logLocalImage(log, `${tag} realpath跳过`, e?.message || String(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 mode=${stats.mode}`);
+		logLocalImage(log, `${tag} 文件可读`, `size=${fileSizeMB}MB`, true);
 		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);
@@ -171,26 +197,17 @@ async function uploadMediaToDingTalk(filePath, mediaType, oapiToken, maxSize = 2
 */
 async function uploadLocalImageWithFallback(filePath, oapiToken, log) {
 	const absPath = toLocalPath(filePath);
-	logLocalImage(log, "fallback 入口", `path=${absPath} exists=${fs.existsSync(absPath)}`);
 	if (!fs.existsSync(absPath)) {
 		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;
-	}
+	if (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);
-		const tmpSize = fs.statSync(tmp).size;
-		logLocalImage(log, "fallback 第2次:tmp拷贝后上传", `${absPath} → ${tmp} size=${tmpSize}`);
 		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}`);
@@ -201,99 +218,144 @@ async function uploadLocalImageWithFallback(filePath, oapiToken, log) {
 		} catch {}
 	}
 }
+async function downloadRemoteUrlToTemp(url) {
+	try {
+		const res = await fetch(url, {
+			redirect: "follow",
+			signal: AbortSignal.timeout(6e4),
+			headers: { "User-Agent": "dingtalk-openclaw-connector/0.8.21" }
+		});
+		if (!res.ok) {
+			console.warn(`[DingTalk][MediaIdTrace] 远程图下载失败 HTTP ${res.status} | ${url}`);
+			return null;
+		}
+		const buf = Buffer.from(await res.arrayBuffer());
+		if (!buf.length || buf.length > 20 * 1024 * 1024) return null;
+		const ct = (res.headers.get("content-type") || "").toLowerCase();
+		let ext = ".bin";
+		if (ct.includes("png")) ext = ".png";
+		else if (ct.includes("jpeg") || ct.includes("jpg")) ext = ".jpg";
+		else if (ct.includes("gif")) ext = ".gif";
+		else if (ct.includes("webp")) ext = ".webp";
+		else {
+			const m = (url.split("?")[0] || "").match(/\.(png|jpe?g|gif|webp)$/i);
+			if (m) ext = `.${m[1].toLowerCase().replace("jpeg", "jpg")}`;
+			else ext = ".jpg";
+		}
+		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}`);
+		return tmp;
+	} catch (e) {
+		console.warn(`[DingTalk][MediaIdTrace] 远程图下载异常 | ${e?.message || e}`);
+		return null;
+	}
+}
 /**
-* 扫描内容中的本地图片路径，上传到钉钉并替换为 media_id（Markdown 可渲染）
-*
-* - 匹配所有 ![]()，本地判定 isLocalImageRef（含 /mnt、中文、& 文件名）
-* - 上传失败会 /tmp 拷贝重试；仍失败则去掉本地路径（避免钉钉灰图占位）
-* - 关键步骤始终 console.log（不依赖 debug 开关）
+* 把 original 在「非 ![] / 非 ]( 」位置替换为 replacement（同一气泡内保留下载位）。
 */
-async function processLocalImages(content, oapiToken, log) {
-	logLocalImage(log, "processLocalImages 开始", `contentLen=${content?.length ?? 0} hasToken=${!!oapiToken}`);
-	if (!oapiToken) {
-		logLocalImage(log, "processLocalImages 跳过", "无 oapiToken");
-		return content;
-	}
-	if (!content || typeof content !== "string") {
-		logLocalImage(log, "processLocalImages 跳过", "content 为空");
-		return content;
+function replaceOutsideImageTargets(content, original, replacement) {
+	if (!content.includes(original) || original === replacement) return content;
+	let out = content;
+	let from = 0;
+	while (from < out.length) {
+		const idx = out.indexOf(original, from);
+		if (idx < 0) break;
+		if (out.slice(Math.max(0, idx - 2), idx) === "](") {
+			from = idx + original.length;
+			continue;
+		}
+		out = out.slice(0, idx) + replacement + out.slice(idx + original.length);
+		from = idx + replacement.length;
 	}
+	return out;
+}
+/**
+* 出站图片处理（单气泡）：
+* - 只处理 `![](target)`：本地/远程均上传 → `![](mediaId)`
+* - 代码块跳过；不扫裸路径
+* - 远程：![] 改 mediaId 后，正文里「下载链接：http://…」**原样保留在同一条消息**
+*   （钉钉改写发生在「![] 与正文共用同一 http」时；![] 改成 mediaId 后即可同泡共存）
+* - 本地：正文重复的本地路径换成 down.dingtalk.com 可点链接（仍同一条消息）
+* - **不再拆第二条 text 消息**
+*/
+async function processImagesForOutbound(content, oapiToken, log) {
+	if (!oapiToken || !content || typeof content !== "string") return {
+		text: content || "",
+		followUpUrls: []
+	};
 	const codeRanges = getMarkdownCodeRanges(content);
-	if (codeRanges.length > 0) logLocalImage(log, "processLocalImages 代码区域", `count=${codeRanges.length}（围栏/行内 code 内的图路径将跳过）`);
-	const allMdPreview = [...content.matchAll(LOCAL_IMAGE_RE)].map((m, i) => {
-		const p = (m[2] || "").trim();
-		const inCode = m.index !== void 0 && isIndexInCodeRange(m.index, codeRanges);
-		return `#${i + 1} local=${isLocalImageRef(p)} inCode=${inCode} path=${p.slice(0, 120)}`;
-	});
-	logLocalImage(log, "processLocalImages 扫描 ![]()", allMdPreview.length ? allMdPreview.join(" || ") : "正文中没有任何 markdown 图片语法");
-	let result = content;
 	const mdMatches = [...content.matchAll(LOCAL_IMAGE_RE)];
-	const localMd = mdMatches.filter((m) => {
-		if (!isLocalImageRef(m[2] || "")) return false;
-		if (m.index !== void 0 && isIndexInCodeRange(m.index, codeRanges)) {
-			logLocalImage(log, "processLocalImages 跳过代码块内图片", (m[2] || "").slice(0, 120));
-			return false;
-		}
-		return true;
-	});
-	if (localMd.length > 0) {
-		logLocalImage(log, "processLocalImages 待上传本地图", `count=${localMd.length}/${mdMatches.length}`);
-		for (const match of localMd) {
-			const [fullMatch, alt, rawPath] = match;
-			const absPath = toLocalPath(rawPath.replace(/\\ /g, " ").trim());
-			logLocalImage(log, "processLocalImages 处理一张", `alt=${alt || "-"} raw=${rawPath} abs=${absPath} exists=${fs.existsSync(absPath)}`);
+	let result = content;
+	/** 本地路径 → 可点 downloadUrl（仅替换正文中的裸路径，不拆消息） */
+	const localPathToDl = /* @__PURE__ */ new Map();
+	let uploadCount = 0;
+	for (const match of mdMatches) {
+		if (match.index !== void 0 && isIndexInCodeRange(match.index, codeRanges)) continue;
+		const [fullMatch, alt, rawPath] = match;
+		const cleanPath = (rawPath || "").replace(/\\ /g, " ").trim();
+		if (!cleanPath) continue;
+		if (isLocalImageRef(cleanPath)) {
+			const absPath = toLocalPath(cleanPath);
 			try {
 				const uploadResult = await uploadLocalImageWithFallback(absPath, oapiToken, log);
 				if (uploadResult?.mediaId) {
-					const replacement = `![${alt || path.basename(absPath)}](${uploadResult.mediaId})`;
-					result = result.split(fullMatch).join(replacement);
-					logLocalImage(log, "processLocalImages 替换成功", `${absPath} → ${uploadResult.mediaId}`);
-				} else {
-					const note = `📷 *图片上传失败（${path.basename(absPath)}）*`;
-					result = result.split(fullMatch).join(note);
-					logLocalImage(log, "processLocalImages 替换为失败提示", absPath);
-				}
-			} catch (err) {
-				const note = `📷 *图片上传异常（${path.basename(absPath)}）*`;
-				result = result.split(fullMatch).join(note);
-				logLocalImage(log, "processLocalImages 异常", `${absPath} err=${err?.message || err}`);
+					result = result.split(fullMatch).join(`![${alt || path.basename(absPath)}](${uploadResult.mediaId})`);
+					uploadCount++;
+					if (uploadResult.downloadUrl) {
+						localPathToDl.set(cleanPath, uploadResult.downloadUrl);
+						localPathToDl.set(absPath, uploadResult.downloadUrl);
+					}
+				} else result = result.split(fullMatch).join(`📷 *图片上传失败（${path.basename(absPath)}）*`);
+			} catch {
+				result = result.split(fullMatch).join(`📷 *图片上传异常（${path.basename(toLocalPath(cleanPath))}）*`);
 			}
+			continue;
 		}
-	} else if (mdMatches.length > 0) logLocalImage(log, "processLocalImages 无本地图可传", `全部 ${mdMatches.length} 个视为远程/非本地`);
-	else logLocalImage(log, "processLocalImages 无 markdown 图片", "无需上传");
-	const bareOutsideCode = [...result.matchAll(BARE_IMAGE_PATH_RE)].filter((m) => {
-		if (m.index === void 0) return false;
-		const idx = m.index;
-		return !result.slice(Math.max(0, idx - 10), idx).includes("](");
-	}).filter((m) => {
-		if (m.index === void 0) return true;
-		if (isIndexInCodeRange(m.index, codeRanges)) {
-			logLocalImage(log, "processLocalImages 跳过代码块内纯路径", (m[1] || "").slice(0, 80));
-			return false;
-		}
-		return true;
-	});
-	if (bareOutsideCode.length > 0) {
-		logLocalImage(log, "processLocalImages 纯文本路径", `count=${bareOutsideCode.length}`);
-		for (const match of bareOutsideCode.reverse()) {
-			const [fullMatch, rawPath] = match;
-			const absPath = toLocalPath(rawPath.replace(/\\ /g, " ").trim());
-			logLocalImage(log, "processLocalImages 纯文本上传", absPath);
+		if (looksLikeRemoteUrl(cleanPath)) {
+			let tmp = null;
 			try {
-				const uploadResult = await uploadLocalImageWithFallback(absPath, oapiToken, log);
+				tmp = await downloadRemoteUrlToTemp(cleanPath);
+				if (!tmp) continue;
+				const uploadResult = await uploadLocalImageWithFallback(tmp, oapiToken, log);
 				if (uploadResult?.mediaId) {
-					const replacement = `![](${uploadResult.mediaId})`;
-					result = result.slice(0, match.index) + result.slice(match.index).replace(fullMatch, replacement);
-					logLocalImage(log, "processLocalImages 纯文本替换成功", uploadResult.mediaId);
+					result = result.split(fullMatch).join(`![${alt || "image"}](${uploadResult.mediaId})`);
+					uploadCount++;
+					console.log(`[DingTalk][LocalImage] ![]远程→mediaId 下载链保留原URL | ${uploadResult.mediaId}`);
 				}
 			} catch (err) {
-				logLocalImage(log, "processLocalImages 纯文本失败", `${absPath} ${err?.message || err}`);
+				logLocalImage(log, "远程图处理失败", err?.message || String(err));
+			} finally {
+				if (tmp) try {
+					fs.unlinkSync(tmp);
+				} catch {}
 			}
 		}
 	}
-	const stillLocal = [...result.matchAll(LOCAL_IMAGE_RE)].filter((m) => isLocalImageRef(m[2] || "")).map((m) => m[2]);
-	logLocalImage(log, "processLocalImages 结束", stillLocal.length ? `仍残留本地路径 ${stillLocal.length} 个: ${stillLocal.join(" | ")}` : `无残留本地路径 outLen=${result.length}`);
-	return result;
+	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);
+	return {
+		text: result,
+		followUpUrls: []
+	};
+}
+/** 兼容旧调用 */
+async function processLocalImages(content, oapiToken, log) {
+	return (await processImagesForOutbound(content, oapiToken, log)).text;
+}
+/**
+* 是否仍有「需要上传却未上传」的本地 MD 图。
+* **代码块 / 行内 code 内的示例路径不算**（否则 AI 举例 `![x](/tmp/a.jpg)` 会误报灰图）。
+*/
+function hasResidualLocalMdImagesOutsideCode(content) {
+	if (!content) return false;
+	const codeRanges = getMarkdownCodeRanges(content);
+	for (const m of content.matchAll(LOCAL_IMAGE_RE)) {
+		if (m.index !== void 0 && isIndexInCodeRange(m.index, codeRanges)) continue;
+		if (isLocalImageRef((m[2] || "").trim())) return true;
+	}
+	return false;
 }
 /**
 * 提取视频元数据（时长、分辨率）
@@ -712,4 +774,4 @@ async function processRawMediaPaths(content, config, oapiToken, log, target) {
 	return processedContent;
 }
 //#endregion
-export { __exportAll as _, extractVideoMetadata as a, processLocalImages as c, sendAudioProactive as d, sendFileProactive as f, uploadMediaToDingTalk as g, uploadLocalImageWithFallback as h, VIDEO_MARKER_PATTERN as i, processRawMediaPaths as l, toLocalPath as m, IMAGE_EXTENSIONS as n, extractVideoThumbnail as o, sendVideoProactive as p, LOCAL_IMAGE_RE as r, isLocalImageRef as s, BARE_IMAGE_PATH_RE as t, processVideoMarkers as u };
+export { toLocalPath as _, extractVideoThumbnail as a, __exportAll as b, logMediaIdTrace as c, processLocalImages as d, processRawMediaPaths as f, sendVideoProactive as g, sendFileProactive as h, extractVideoMetadata as i, looksLikeRemoteUrl as l, sendAudioProactive as m, LOCAL_IMAGE_RE as n, hasResidualLocalMdImagesOutsideCode as o, processVideoMarkers as p, VIDEO_MARKER_PATTERN as r, isLocalImageRef as s, IMAGE_EXTENSIONS as t, processImagesForOutbound as u, uploadLocalImageWithFallback as v, uploadMediaToDingTalk as y };