@jeik/dingtalk-connector 0.8.21-fix46 → 0.8.21-fix48

package/CHANGELOG.md

@@ -5,6 +5,31 @@ 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-fix48] - 2026-07-21
+
+### 新增 / Added
+- ✨ **`messageAnswerCard`（默认 `true`）** — message 工具正文默认走**答案静态卡**（`answerCardTemplateId` 或内置模板，`skipInputingWalk`）；失败降级普通消息。显式 `false` 关闭。  
+  已注册：`schema.ts`、`openclaw.plugin.json`（channels + accounts + uiHints）。  
+  与会话流式 `answerCard` 独立；图/音/视/文件仍走普通通道。
+
+### 安装 / Install
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+## [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

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-fix46</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-fix48</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,19 +23,28 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix46 · 2026-07-20 (current)
+### 🚀 v0.8.21-fix48 · 2026-07-21 (current)
 
-**Theme: always-on local MD image diagnostics (behavior same as fix45)**
+**Theme: message tool answer card by default (toggle)**
 
 | | Change |
 |--|--------|
-| 🔍 **LocalImage logs** | message path: scan / exists / upload / residual |
-| 🔍 **MediaIdTrace** | `mdImgs`, `residualLocal`, API-before preview |
+| ✨ **`messageAnswerCard`** | **Default `true`**: message body uses static answer card; set `false` for plain text/markdown |
+| 🔧 **Registered** | `schema` + `openclaw.plugin.json` (channels / accounts / uiHints) |
+| 📎 **Independent** | Separate from session-stream `answerCard`; media still uses normal APIs |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix47 · 2026-07-20
+
+`file://` no longer misclassified as remote (grey-image fix).
+
+### 📦 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.
@@ -46,14 +55,7 @@ Remote `media` download-then-upload.
 
 ### 📦 v0.8.21-fix37 · 2026-07-20
 
-**Theme: local images (incl. `/mnt`) · message media layout · diagnostics**
-
-| | Change |
-|--|--------|
-| 📷 **Local MD images** | Any absolute path (incl. **`/mnt`**, Chinese paths); upload retries via `/tmp` copy |
-| 📦 **Code-block safe** | Paths inside fenced/inline code are **not** uploaded (param samples stay literal) |
-| ⚙️ **`messageImageMd`** | Default `false`: message tool sends **text then image** separately; `true` merges only multi-image + text into one markdown |
-| 🔍 **Diagnostics** | Prefix `[DingTalk][LocalImage]` — **no `debug` flag required** |
+Local images (incl. `/mnt`) · `messageImageMd` · LocalImage diagnostics.
 
 ---
 
@@ -66,7 +68,7 @@ Remote `media` download-then-upload.
 | 2026-06-28 | npm `@jeik/dingtalk-connector`; premature finalization fix |
 | 2026-05 | MD images; multi-turn spam; 4.29 empty reply; WS phantom reconnect |
 
-Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix38](docs/RELEASE_NOTES_V0.8.21-fix38.md)
+Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix48.md)
 
 ---
 
@@ -90,20 +92,96 @@ Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix38
     "clientId": "your-clientId",
     "clientSecret": "your-clientSecret",
     "cardTemplateId": "your-card-template-id.schema",
-    "cardContentVar": "content"
+    "cardContentVar": "content",
+    "messageAnswerCard": true
   }
 }
 ```
 
-| Parameter | Description |
-|-----------|-------------|
-| `cardTemplateId` | AI Card template ID, uses official default if not set |
-| `cardContentVar` | Card content variable (process / tool line / final all write here), defaults to `msgContent` |
-| `answerCard` | Answer-card mode switch, **on by default**; set `false` to disable |
-| `answerActToken` | Answer-card trigger threshold (tokens), default `500`; final answer ≤ this stays on the original card, > this opens a separate answer card |
-| `answerCardTemplateId` | Answer-card template ID, uses the built-in default if not set (must contain a `content` variable) |
-
-> Card template must be created in [DingTalk Open Platform](https://open.dingtalk.com/) with matching variable fields.
+### Full config reference (`channels.dingtalk-connector`)
+
+Source of truth: `src/config/schema.ts` + `openclaw.plugin.json`.  
+Top-level single-bot fields and `accounts.<id>` share the same **shared shape**; missing account fields inherit top-level.
+
+#### 1. Enable / credentials / multi-account
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `enabled` | boolean | — | Enable this channel |
+| `defaultAccount` | string | — | Default account key (must exist under `accounts`) |
+| `clientId` | string \| number | — | AppKey / Client ID (single-bot top-level) |
+| `clientSecret` | string \| SecretRef | — | AppSecret; plain string or `{ source, provider, id }` |
+| `accounts` | object | — | Multi-bot map; keys are account IDs |
+| `accounts.*.enabled` | boolean | — | Enable this account |
+| `accounts.*.name` | string | — | Display name |
+| `accounts.*.clientId` | string \| number | — | Account Client ID |
+| `accounts.*.clientSecret` | string \| SecretRef | — | Account secret |
+| `accounts.*.chatbotUserId` | string | — | Encrypted bot id for @-mentioning bots in groups (see `[BotIdentity]` logs) |
+| `accounts.*.chatbotCorpId` | string | — | Bot corp id |
+
+#### 2. Access policy
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `dmPolicy` | `"open"` \| `"pairing"` \| `"allowlist"` | `"open"` | DM policy |
+| `allowFrom` | (string\|number)[] | — | DM allowlist; **required (≥1)** when `dmPolicy=allowlist` |
+| `groupPolicy` | `"open"` \| `"allowlist"` \| `"disabled"` | `"open"` | Group policy |
+| `groupAllowFrom` | (string\|number)[] | — | Group allowlist; **required (≥1)** when `groupPolicy=allowlist` |
+| `requireMention` | boolean | `true` | Require @bot in groups |
+| `groups` | object | — | Per-group overrides (below) |
+
+**`groups.<openConversationId>`:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `enabled` | boolean | Enable this group |
+| `requireMention` | boolean | Override @ requirement |
+| `allowFrom` | (string\|number)[] | Per-group sender allowlist |
+| `systemPrompt` | string | Extra system prompt for this group |
+| `groupSessionScope` | `"group"` \| `"group_sender"` | Session scope for this group |
+| `tools.allow` / `tools.deny` | string[] | Per-group tool policy |
+
+#### 3. Session / behavior
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `groupSessionScope` | `"group"` \| `"group_sender"` | `"group"` | One session per group vs per group+sender |
+| `separateSessionByConversation` | boolean | `true` | Isolate sessions by conversation |
+| `sharedMemoryAcrossConversations` | boolean | `false` | Share memory across conversations |
+| `historyLimit` | int ≥0 | — | History length cap |
+| `textChunkLimit` | int >0 | — | Text chunk size cap |
+| `mediaMaxMb` | number >0 | — | Media size cap (MB) |
+| `typingIndicator` | boolean | — | Typing indicator |
+| `resolveSenderNames` | boolean | — | Resolve sender display names |
+| `asyncMode` | boolean | — | Async mode |
+| `ackText` | string | — | Inbound ACK text |
+| `systemPrompt` | string | — | Channel-level extra system prompt |
+| `enableMediaUpload` | boolean | — | Enable media upload features |
+| `endpoint` | string | — | Custom DWClient gateway (advanced) |
+| `debug` | boolean | — | Debug logging |
+
+#### 4. Tools
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `tools.docs` | boolean | true (semantic) | Document tools |
+| `tools.media` | boolean | true (semantic) | Media upload tools |
+
+#### 5. Group reply / AI card / answer card / message tool
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `groupReplyMode` | `"aicard"` \| `"text"` \| `"markdown"` | `"aicard"` | Group reply style; `text`/`markdown` disables streaming AI card in groups (multi-bot @) |
+| `cardTemplateId` | string | official stream template | Streaming AI Card template id |
+| `cardContentVar` | string | `"msgContent"` | Stream card content variable (process/tool/final) |
+| `answerCard` | boolean | **true** (unless `false`) | **Session-stream** answer card: long answers on a static card; original card freezes at “thinking done” |
+| `answerActToken` | int >0 | **500** | Token threshold: ≤ stay on stream card; > spawn answer card |
+| `answerCardTemplateId` | string | built-in answer template | Static answer card template id |
+| `messageAnswerCard` | boolean | **true** (unless `false`) | **message tool** body via static answer card; `false` = plain text/markdown. **Independent** of `answerCard`; media still normal APIs |
+| `messageImageMd` | boolean | **false** | message tool layout: `false` text then image; `true` merge multi-image+text markdown |
+
+> Create/publish card templates in [DingTalk Open Platform](https://open.dingtalk.com/).  
+> `answerCard` = conversational stream finalize; `messageAnswerCard` = Agent `message` tool outbound. Do not conflate them.
 
 ---
 

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-fix46</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix46.tgz --force`）</p>
+  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix48</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix48.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,19 +23,28 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.21-fix46 · 2026-07-20（当前）
+### 🚀 v0.8.21-fix48 · 2026-07-21（当前）
 
-**主题：本地 MD 图灰图诊断日志（逻辑同 fix45）**
+**主题：message 工具默认答案卡（可关）**
 
 | | 改动 |
 |--|------|
-| 🔍 **LocalImage 日志** | message 路径 always-on：扫描 / exists / 上传成败 / residual |
-| 🔍 **MediaIdTrace** | `mdImgs`、`residualLocal`、API前 preview，方便对灰图 |
+| ✨ **`messageAnswerCard`** | **默认 `true`**：message 正文走答案静态卡；`false` 恢复普通 text/markdown |
+| 🔧 **注册** | `schema` + `openclaw.plugin.json`（channels / accounts / uiHints） |
+| 📎 **独立** | 与会话流式 `answerCard` 分开；媒体消息仍普通通道 |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix47 · 2026-07-20
+
+`file://` 本地图误判远程修复（不再 `fetch failed` 灰图）。
+
+### 📦 v0.8.21-fix46 · 2026-07-20
+
+本地 MD 图灰图诊断日志（LocalImage / MediaIdTrace）。
+
 ### 📦 v0.8.21-fix45 · 2026-07-20
 
 图 + 下载链接单气泡 · 只认 `![]` · 引用卡片缓存 · residual 误报修复。
@@ -46,14 +55,7 @@ message 远程 `media` 下载上传。
 
 ### 📦 v0.8.21-fix37 · 2026-07-20
 
-**主题：本地图（含 `/mnt`）· message 文图策略 · 可观测日志**
-
-| | 改动 |
-|--|------|
-| 📷 **MD 本地图** | 支持任意绝对路径（含 **`/mnt` 共享盘**、中文目录）；上传失败会拷到 `/tmp` 再试 |
-| 📦 **代码块保护** | 围栏 / 行内 code 里的路径**不会上传**，参数示例不会被改成 `mediaId` |
-| ⚙️ **`messageImageMd`** | 默认 `false`：message 工具**文图分开**；`true` 时仅「多图 + 文字」合并为一条 markdown |
-| 🔍 **诊断日志** | 前缀 `[DingTalk][LocalImage]`，**无需开 debug** 也能看到匹配 / 上传 / 失败原因 |
+本地图（含 `/mnt`）· `messageImageMd` · LocalImage 诊断日志。
 
 ---
 
@@ -66,7 +68,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 fix46](docs/RELEASE_NOTES_V0.8.21-fix46.md)
+完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix48.md)
 
 ---
 
@@ -96,6 +98,7 @@ message 远程 `media` 下载上传。
     "cardTemplateId": "你的卡片模板ID.schema",
     "cardContentVar": "content",
     "messageImageMd": false,
+    "messageAnswerCard": true,
     "debug": false
   }
 }
@@ -129,21 +132,90 @@ message 远程 `media` 下载上传。
 }
 ```
 
-| 参数 | 说明 |
-|------|------|
-| `clientId` / `clientSecret` | 单机器人模式直接填在顶层 |
-| `accounts` | 多机器人模式，key 为账号标识名（可任意命名） |
-| `accounts.*.enabled` | 是否启用该账号 |
-| `accounts.*.name` | 账号显示名称（仅用于标识） |
-| `accounts.*.clientId` | 钉钉应用 ClientId |
-| `accounts.*.clientSecret` | 钉钉应用 ClientSecret |
-| `cardTemplateId` | AI Card 模板 ID，不填则使用官方默认模板 |
-| `cardContentVar` | 卡片内容变量名，不填默认 `msgContent`（过程/工具/终稿统一写入此字段） |
-| `answerCard` | 答案卡模式开关，**默认开启**；显式设 `false` 关闭 |
-| `answerActToken` | 答案卡触发阈值（token），默认 `500`；最终答案 ≤ 此值直接在原卡定稿，> 此值才另开答案卡 |
-| `answerCardTemplateId` | 答案卡模板 ID，不填用内置默认模板（需含 `content` 变量） |
-
-> 卡片模板需在[钉钉开放平台](https://open.dingtalk.com/)创建，并添加对应的变量字段。
+### 完整配置字段（`channels.dingtalk-connector`）
+
+源码权威：`src/config/schema.ts` + `openclaw.plugin.json`。  
+**顶层单账号**与 **`accounts.<id>`** 共用同一批「共享字段」；账号级缺省时继承顶层。
+
+#### 1. 启用 / 凭证 / 多账号
+
+| 字段 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `enabled` | boolean | — | 是否启用本渠道 |
+| `defaultAccount` | string | — | 默认账号 key；须存在于 `accounts` |
+| `clientId` | string \| number | — | AppKey / Client ID（单账号顶层） |
+| `clientSecret` | string \| SecretRef | — | AppSecret；支持明文或 `{ source, provider, id }` |
+| `accounts` | object | — | 多账号；key 为账号 ID（如 `main-bot`） |
+| `accounts.*.enabled` | boolean | — | 是否启用该账号 |
+| `accounts.*.name` | string | — | 显示名 |
+| `accounts.*.clientId` | string \| number | — | 该账号 Client ID |
+| `accounts.*.clientSecret` | string \| SecretRef | — | 该账号 Secret |
+| `accounts.*.chatbotUserId` | string | — | 机器人加密 ID（群内 @ 其它 bot 用）；见日志 `[BotIdentity] chatbotUserId=...` |
+| `accounts.*.chatbotCorpId` | string | — | 机器人所属 corpId（身份日志） |
+
+#### 2. 访问策略
+
+| 字段 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `dmPolicy` | `"open"` \| `"pairing"` \| `"allowlist"` | `"open"` | 单聊策略 |
+| `allowFrom` | (string\|number)[] | — | 单聊白名单；`dmPolicy=allowlist` 时**必填至少 1 项** |
+| `groupPolicy` | `"open"` \| `"allowlist"` \| `"disabled"` | `"open"` | 群聊策略 |
+| `groupAllowFrom` | (string\|number)[] | — | 群白名单；`groupPolicy=allowlist` 时**必填至少 1 项** |
+| `requireMention` | boolean | `true` | 群聊是否需 @机器人 才响应 |
+| `groups` | object | — | 按群 ID 覆盖策略（见下表） |
+
+**`groups.<openConversationId>`：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `enabled` | boolean | 该群是否启用 |
+| `requireMention` | boolean | 覆盖全局 @ 要求 |
+| `allowFrom` | (string\|number)[] | 该群发送者白名单 |
+| `systemPrompt` | string | 该群额外 system 提示 |
+| `groupSessionScope` | `"group"` \| `"group_sender"` | 该群会话维度 |
+| `tools.allow` / `tools.deny` | string[] | 该群工具策略 |
+
+#### 3. 会话 / 行为
+
+| 字段 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `groupSessionScope` | `"group"` \| `"group_sender"` | `"group"` | 群会话：整群一份 / 群+发送者一份 |
+| `separateSessionByConversation` | boolean | `true` | 按会话隔离 |
+| `sharedMemoryAcrossConversations` | boolean | `false` | 跨会话共享记忆 |
+| `historyLimit` | int ≥0 | — | 历史条数上限 |
+| `textChunkLimit` | int >0 | — | 文本分片上限 |
+| `mediaMaxMb` | number >0 | — | 媒体大小上限（MB） |
+| `typingIndicator` | boolean | — | 输入中指示 |
+| `resolveSenderNames` | boolean | — | 解析发送者昵称 |
+| `asyncMode` | boolean | — | 异步模式 |
+| `ackText` | string | — | 收到消息时的 ACK 文案 |
+| `systemPrompt` | string | — | 渠道级附加 system 提示 |
+| `enableMediaUpload` | boolean | — | 是否启用媒体上传能力 |
+| `endpoint` | string | — | 自定义 DWClient 网关（高级） |
+| `debug` | boolean | — | 调试日志 |
+
+#### 4. 工具
+
+| 字段 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `tools.docs` | boolean | true（语义） | 文档类工具 |
+| `tools.media` | boolean | true（语义） | 媒体上传类工具 |
+
+#### 5. 群回复形态 / AI 卡 / 答案卡 / message 工具
+
+| 字段 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `groupReplyMode` | `"aicard"` \| `"text"` \| `"markdown"` | `"aicard"` | 群回复形态；`text`/`markdown` 时群聊不用 AI 流式卡（便于多 bot @） |
+| `cardTemplateId` | string | 官方默认流式模板 | 会话流式 AI Card 模板 ID |
+| `cardContentVar` | string | `"msgContent"` | 流式卡内容变量名（过程/工具/终稿写入此字段） |
+| `answerCard` | boolean | **true**（未配或非 false） | **会话流式**答案卡：长答案另开静态卡，原卡定格「思考完成」 |
+| `answerActToken` | int >0 | **500** | 会话答案卡阈值：估算 token ≤ 此值原卡定稿；> 此值才新建答案卡 |
+| `answerCardTemplateId` | string | 内置答案模板 | 答案静态卡模板 ID（需含内容变量） |
+| `messageAnswerCard` | boolean | **true**（未配或非 false） | **message 工具**正文是否走答案静态卡；`false`=普通 text/markdown。与 `answerCard` **独立**；图/音/视/文件仍普通通道 |
+| `messageImageMd` | boolean | **false** | message 工具图文：`false` 文图分开；`true` 仅多图+文字时合并一条 markdown |
+
+> 卡片模板需在[钉钉开放平台](https://open.dingtalk.com/)创建并发布。  
+> `answerCard` = 对话流式收尾；`messageAnswerCard` = Agent 调 message 工具外发。不要混为一谈。
 
 ---
 

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

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

package/dist/{gateway-methods-BTByJFxo.mjs → gateway-methods-DtzGBBiy.mjs}

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

package/dist/index.d.mts

@@ -70,6 +70,7 @@ declare const DingtalkConfigSchema: z$1.ZodObject<{
     enableMediaUpload: z$1.ZodOptional<z$1.ZodBoolean>;
     systemPrompt: z$1.ZodOptional<z$1.ZodString>;
     messageImageMd: z$1.ZodOptional<z$1.ZodBoolean>;
+    messageAnswerCard: z$1.ZodOptional<z$1.ZodBoolean>;
     groupReplyMode: z$1.ZodOptional<z$1.ZodEnum<{
       aicard: "aicard";
       text: "text";
@@ -127,6 +128,7 @@ declare const DingtalkConfigSchema: z$1.ZodObject<{
   enableMediaUpload: z$1.ZodOptional<z$1.ZodBoolean>;
   systemPrompt: z$1.ZodOptional<z$1.ZodString>;
   messageImageMd: z$1.ZodOptional<z$1.ZodBoolean>;
+  messageAnswerCard: z$1.ZodOptional<z$1.ZodBoolean>;
   groupReplyMode: z$1.ZodOptional<z$1.ZodEnum<{
     aicard: "aicard";
     text: "text";

package/dist/index.mjs

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

package/dist/{media-9LvaywGZ.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-BMNRjseJ.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-BMNRjseJ.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("://");

package/dist/{message-handler-CytB34ZJ.mjs → message-handler-DKPtnK0x.mjs}

@@ -1,9 +1,9 @@
 import { a as resolveDingtalkAccount } from "./accounts-BAzdqkAV.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-I36vhOzx.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-hVrm4xYI.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-ngF20yqM.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-DOEBZgXQ.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-9LvaywGZ.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-9LvaywGZ.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-9LvaywGZ.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-9LvaywGZ.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-9LvaywGZ.mjs");
+				const { processRawMediaPaths } = await import("./media-BqpUGCni.mjs");
 				finalText = await processRawMediaPaths(finalText, config, oapiToken, log, mediaTarget);
 			}
 			const textToSend = finalText.trim() || "✅ 任务执行完成（无文本输出）";

package/dist/{messaging-ngF20yqM.mjs → messaging-DOEBZgXQ.mjs}

@@ -1,4 +1,4 @@
-import { c as logMediaIdTrace, d as processLocalImages, u as processImagesForOutbound, y as uploadMediaToDingTalk } from "./media-BMNRjseJ.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";
@@ -582,6 +582,28 @@ function prepareMultiBotMentions(params) {
 //#endregion
 //#region src/services/messaging.ts
 /**
+* message 工具是否用答案卡（默认开；显式 false 才关）。
+* 与会话流式 answerCard 独立。
+*/
+function isMessageAnswerCardEnabled(config) {
+	return config?.messageAnswerCard !== false;
+}
+/**
+* message 工具正文发送的卡片选项：答案卡模板 + 静态 FINISHED，失败降级普通消息。
+*/
+function messageToolProactiveCardOptions(config) {
+	if (!isMessageAnswerCardEnabled(config)) return {
+		useAICard: false,
+		fallbackToNormal: true
+	};
+	return {
+		useAICard: true,
+		fallbackToNormal: true,
+		cardTemplateId: typeof config.answerCardTemplateId === "string" && config.answerCardTemplateId.trim() || "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+		skipInputingWalk: true
+	};
+}
+/**
 * 发送 Markdown 消息
 * 支持 @用户（atUserId）和 @机器人（atDingtalkIds）
 */
@@ -848,7 +870,7 @@ async function resolveMediaSourceToLocalFile(mediaUrl, mediaLocalRoots, log) {
 			cleanup: tmp
 		};
 	}
-	const { toLocalPath } = await import("./media-9LvaywGZ.mjs");
+	const { toLocalPath } = await import("./media-BqpUGCni.mjs");
 	const _fs = await import("fs");
 	const _path = await import("path");
 	let resolved = toLocalPath(mediaUrl);
@@ -898,12 +920,13 @@ async function sendTextToDingTalk(params) {
 		console.warn(`[DingTalk][LocalImage] sendTextToDingTalk 图片处理失败: ${err?.message || err}`);
 	}
 	const msgType = shouldSendAsMarkdown(text) ? "markdown" : "text";
-	logMediaIdTrace("sendTextToDingTalk:API前", text, `msgType=${msgType}`, true);
+	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 || "-"}`);
 	return sendProactive(config, targetParam, text, {
 		msgType,
 		replyToId,
-		useAICard: false,
-		fallbackToNormal: true,
+		...cardOpts,
 		skipProcessLocalImages: true
 	});
 }
@@ -1000,8 +1023,7 @@ async function sendMediaToDingTalk(params) {
 			if (text?.trim()) await sendProactive(config, targetParam, text.trim(), {
 				msgType: shouldSendAsMarkdown(text) ? "markdown" : "text",
 				replyToId,
-				useAICard: false,
-				fallbackToNormal: true
+				...messageToolProactiveCardOptions(config)
 			});
 			if (isRemoteHttpUrl(mediaUrl) && mediaType === "image") {
 				console.log(`[DingTalk][RemoteMedia] 下载失败，尝试 photoURL 直链发送 | ${mediaUrl}`);
@@ -1041,8 +1063,7 @@ async function sendMediaToDingTalk(params) {
 					if (caption) await sendProactive(config, targetParam, caption, {
 						msgType: shouldSendAsMarkdown(caption) ? "markdown" : "text",
 						replyToId,
-						useAICard: false,
-						fallbackToNormal: true
+						...messageToolProactiveCardOptions(config)
 					});
 					if (isRemoteHttpUrl(mediaUrl)) {
 						console.log(`[DingTalk][RemoteMedia] 再上传失败，photoURL 直链兜底 | ${mediaUrl}`);
@@ -1068,8 +1089,7 @@ async function sendMediaToDingTalk(params) {
 					const result = await sendProactive(config, targetParam, `${caption}\n\n![](${mediaId})`, {
 						msgType: "markdown",
 						replyToId,
-						useAICard: false,
-						fallbackToNormal: true
+						...messageToolProactiveCardOptions(config)
 					});
 					return {
 						...result,
@@ -1079,8 +1099,7 @@ async function sendMediaToDingTalk(params) {
 				if (caption) await sendProactive(config, targetParam, caption, {
 					msgType: shouldSendAsMarkdown(caption) ? "markdown" : "text",
 					replyToId,
-					useAICard: false,
-					fallbackToNormal: true
+					...messageToolProactiveCardOptions(config)
 				});
 				const result = await sendProactive(config, targetParam, mediaId, {
 					msgType: "image",
@@ -1102,8 +1121,7 @@ async function sendMediaToDingTalk(params) {
 				await sendProactive(config, targetParam, caption, {
 					msgType: shouldSendAsMarkdown(caption) ? "markdown" : "text",
 					replyToId,
-					useAICard: false,
-					fallbackToNormal: true
+					...messageToolProactiveCardOptions(config)
 				});
 			}
 			const uploadResult = await uploadMediaToDingTalk(resolvedMediaUrl, mediaType, oapiToken, maxSize, log);
@@ -1121,7 +1139,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-9LvaywGZ.mjs");
+				const { processVideoMarkers } = await import("./media-BqpUGCni.mjs");
 				await processVideoMarkers(videoMarker, "", config, oapiToken, console, true, targetParam);
 				return {
 					ok: true,
@@ -1140,7 +1158,7 @@ async function sendMediaToDingTalk(params) {
 				fileName,
 				fileType: ext && ext.length < 12 ? ext : "file"
 			};
-			const { sendFileProactive } = await import("./media-9LvaywGZ.mjs");
+			const { sendFileProactive } = await import("./media-BqpUGCni.mjs");
 			await sendFileProactive(config, targetParam, fileInfo, uploadResult.mediaId, log);
 			return {
 				ok: true,
@@ -1219,12 +1237,13 @@ async function sendProactiveInternal(config, target, content, options) {
 			usedAICard: false
 		};
 	}
-	const { msgType = "text", useAICard = true, fallbackToNormal = true, log: externalLog } = options;
+	const { msgType = "text", useAICard = true, fallbackToNormal = true, cardTemplateId, skipInputingWalk = false, log: externalLog } = options;
 	const isMediaMessage = MEDIA_MSG_TYPES.has(msgType);
 	if (useAICard && !isMediaMessage) try {
-		const card = await createAICardForTarget(config, target, externalLog);
+		const card = await createAICardForTarget(config, target, externalLog, cardTemplateId);
 		if (card) {
-			await finishAICard(card, content, config, externalLog);
+			await finishAICard(card, content, config, externalLog, void 0, skipInputingWalk);
+			console.log(`[DingTalk][MessageCard] AI Card 发送成功 | outTrack=${card.cardInstanceId} tpl=${cardTemplateId || "default"} skipInputing=${skipInputingWalk}`);
 			return {
 				ok: true,
 				cardInstanceId: card.cardInstanceId,
@@ -1236,8 +1255,10 @@ async function sendProactiveInternal(config, target, content, options) {
 			error: "Failed to create AI Card",
 			usedAICard: false
 		};
+		console.warn(`[DingTalk][MessageCard] AI Card 创建失败，fallbackToNormal=${fallbackToNormal}`);
 	} catch (err) {
 		externalLog?.error?.(`AI Card 发送失败: ${err.message}`);
+		console.warn(`[DingTalk][MessageCard] AI Card 异常: ${err?.message || err}，fallbackToNormal=${fallbackToNormal}`);
 		if (!fallbackToNormal) return {
 			ok: false,
 			error: err.message,

package/dist/{runtime-I36vhOzx.mjs → runtime-hVrm4xYI.mjs}

@@ -1,9 +1,9 @@
-import { b as __exportAll } from "./media-BMNRjseJ.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-ngF20yqM.mjs";
+import { S as finalClean, f as getActiveCardForConversation, n as sendMediaToDingTalk, o as sendTextToDingTalk } from "./messaging-DOEBZgXQ.mjs";
 import { createRequire } from "node:module";
 import { z, z as z$1 } from "zod";
 //#region src/secret-input.ts
@@ -102,6 +102,13 @@ const DingtalkSharedConfigShape = {
 	*         单张图文、纯媒体文件仍分开发送
 	*/
 	messageImageMd: z$1.boolean().optional(),
+	/**
+	* message 工具是否用答案卡发送正文（默认 true，显式 false 才关）：
+	* - true / 未配：走答案专用静态卡（answerCardTemplateId 或内置模板），失败降级普通消息
+	* - false：直接普通 text/markdown（旧行为）
+	* 与会话流式的 answerCard 独立；媒体消息（图/音/视/文件）仍走普通通道。
+	*/
+	messageAnswerCard: z$1.boolean().optional(),
 	groupReplyMode: GroupReplyModeSchema,
 	/** AI Card 模板 ID，不填则使用官方默认模板 */
 	cardTemplateId: z$1.string().optional(),
@@ -111,7 +118,7 @@ const DingtalkSharedConfigShape = {
 	*  规避钉钉流式卡 FINISHED 后仍抖动的官方 bug。默认开启（显式设 false 才关）。 */
 	answerCard: z$1.boolean().optional(),
 	/** 答案卡触发阈值（token）：最终答案估算 token ≤ 此值时直接在原卡定稿（不另建卡），
-	*  > 此值才新建答案卡。避免简单任务也多一张卡。默认 600。 */
+	*  > 此值才新建答案卡。避免简单任务也多一张卡。默认 500（见 reply-dispatcher）。 */
 	answerActToken: z$1.number().int().positive().optional(),
 	/** 答案专用卡模板 ID：不填用内置默认模板。需是钉钉后台已发布、含 content 变量的卡片模板。 */
 	answerCardTemplateId: z$1.string().optional()
@@ -930,7 +937,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-CytB34ZJ.mjs"),
+		import("./message-handler-DKPtnK0x.mjs"),
 		import("./connection-DHHFFNQJ.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;

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/docs/RELEASE_NOTES_V0.8.21-fix48.md

@@ -0,0 +1,73 @@
+# Release Notes — v0.8.21-fix48（2026-07-21）
+
+生产稳定版 / Production-stable community build of `@jeik/dingtalk-connector`。
+
+## 安装 / Install
+
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+本地 tgz：
+
+```bash
+openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix48.tgz --force
+openclaw gateway restart
+```
+
+## 本版要点 / Highlights
+
+| 领域 | 说明 |
+|------|------|
+| **message 答案卡** | 新增配置 **`messageAnswerCard`（默认 `true`）**：message 工具正文默认走**答案静态卡** |
+| 模板 | 使用 `answerCardTemplateId` 或内置答案卡模板；`skipInputingWalk` 直接 FINISHED |
+| 降级 | 建卡失败 → 自动普通 text/markdown |
+| 关闭 | `"messageAnswerCard": false` 恢复旧行为（普通消息） |
+| 注册 | `schema.ts` + `openclaw.plugin.json`（channels / accounts / uiHints） |
+| 独立 | 与会话流式 **`answerCard`** 互不影响；图/音/视/文件仍走普通通道 |
+
+## 配置示例
+
+```json
+"channels": {
+  "dingtalk-connector": {
+    "messageAnswerCard": true,
+    "answerCardTemplateId": "可选-自定义答案卡模板.schema"
+  }
+}
+```
+
+关闭 message 答案卡：
+
+```json
+"messageAnswerCard": false
+```
+
+### 完整字段表
+
+见仓库 README「完整配置字段」章节（中文 `README.md` / 英文 `README.en.md`），与 `src/config/schema.ts`、`openclaw.plugin.json` 对齐，含：
+
+- 凭证 / `accounts` / `chatbotUserId`
+- `dmPolicy` / `groupPolicy` / `requireMention` / `groups.*`
+- 会话：`groupSessionScope` / `separateSessionByConversation` / …
+- 卡片：`groupReplyMode` / `cardTemplateId` / `cardContentVar`
+- 答案卡：`answerCard` / `answerActToken`（默认 500）/ `answerCardTemplateId`
+- message：`messageAnswerCard`（默认 true）/ `messageImageMd`（默认 false）
+
+## 日志
+
+```text
+[DingTalk][MessageCard] sendTextToDingTalk | messageAnswerCard=true useAICard=true tpl=...
+[DingTalk][MessageCard] AI Card 发送成功 | outTrack=card_... skipInputing=true
+```
+
+## 含此前修复
+
+- fix47：`file://` 本地图不再误判远程  
+- fix46：LocalImage / MediaIdTrace 诊断日志  
+- fix45：图+下载同泡、只认 `![]`、CardCache、residual 误报  
+
+## 升级
+
+从任意 fix37+ 直接 `--force` 安装即可。

package/openclaw.plugin.json

@@ -247,6 +247,11 @@
             "default": false,
             "description": "message 工具图文策略：false=文图分开（默认）；true=多图+文字时才合并为 markdown"
           },
+          "messageAnswerCard": {
+            "type": "boolean",
+            "default": true,
+            "description": "message 工具是否用答案卡发送正文：true（默认）= 答案静态卡；false= 普通 text/markdown。媒体消息仍走普通通道。"
+          },
           "groupReplyMode": {
             "type": "string",
             "enum": [
@@ -493,6 +498,11 @@
                   "default": false,
                   "description": "message 工具图文策略：false=文图分开（默认）；true=多图+文字时才合并为 markdown"
                 },
+                "messageAnswerCard": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "message 工具是否用答案卡发送正文：true（默认）= 答案静态卡；false= 普通 text/markdown。媒体消息仍走普通通道。"
+                },
                 "groupReplyMode": {
                   "type": "string",
                   "enum": [
@@ -557,6 +567,41 @@
           "help": "message 工具图文策略。false（默认）：文字与图片分开发送，阅读体验更好。true：仅当多图与文字结合时合并为一条 markdown；单张图文、纯媒体仍分开。",
           "advanced": true
         },
+        "channels.dingtalk-connector.messageAnswerCard": {
+          "label": "Message Answer Card",
+          "help": "message 工具是否用答案卡发正文。默认开启（答案静态卡，失败降级普通消息）；设为 false 则直接发 text/markdown。与会话流式的 answerCard 独立。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.groupReplyMode": {
+          "label": "Group Reply Mode",
+          "help": "群回复形态：aicard（默认，流式 AI 卡）/ text / markdown。text、markdown 时群聊不用 AI 卡，便于多机器人互相 @。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.cardTemplateId": {
+          "label": "AI Card Template ID",
+          "help": "会话流式 AI Card 模板 ID；不填用官方默认流式模板。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.cardContentVar": {
+          "label": "Card Content Variable",
+          "help": "流式卡内容变量名，默认 msgContent（过程/工具/终稿写入此字段）。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.answerCard": {
+          "label": "Session Answer Card",
+          "help": "会话流式答案卡开关，默认开启。长答案另开静态卡，原卡定格思考完成；显式 false 关闭。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.answerActToken": {
+          "label": "Answer Card Token Threshold",
+          "help": "会话答案卡触发阈值（token），默认 500。≤ 阈值在原卡定稿；> 阈值才新建答案卡。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.answerCardTemplateId": {
+          "label": "Answer Card Template ID",
+          "help": "答案静态卡模板 ID；message 答案卡与会话答案卡共用。不填用内置默认模板。",
+          "advanced": true
+        },
         "channels.dingtalk-connector.endpoint": {
           "label": "Gateway Endpoint",
           "help": "自定义 DWClient 网关地址（高级）",

package/package.json

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

package/src/config/schema.ts

@@ -91,6 +91,13 @@ const DingtalkSharedConfigShape = {
    *         单张图文、纯媒体文件仍分开发送
    */
   messageImageMd: z.boolean().optional(),
+  /**
+   * message 工具是否用答案卡发送正文（默认 true，显式 false 才关）：
+   * - true / 未配：走答案专用静态卡（answerCardTemplateId 或内置模板），失败降级普通消息
+   * - false：直接普通 text/markdown（旧行为）
+   * 与会话流式的 answerCard 独立；媒体消息（图/音/视/文件）仍走普通通道。
+   */
+  messageAnswerCard: z.boolean().optional(),
   groupReplyMode: GroupReplyModeSchema,
   /** AI Card 模板 ID，不填则使用官方默认模板 */
   cardTemplateId: z.string().optional(),
@@ -100,7 +107,7 @@ const DingtalkSharedConfigShape = {
    *  规避钉钉流式卡 FINISHED 后仍抖动的官方 bug。默认开启（显式设 false 才关）。 */
   answerCard: z.boolean().optional(),
   /** 答案卡触发阈值（token）：最终答案估算 token ≤ 此值时直接在原卡定稿（不另建卡），
-   *  > 此值才新建答案卡。避免简单任务也多一张卡。默认 600。 */
+   *  > 此值才新建答案卡。避免简单任务也多一张卡。默认 500（见 reply-dispatcher）。 */
   answerActToken: z.number().int().positive().optional(),
   /** 答案专用卡模板 ID：不填用内置默认模板。需是钉钉后台已发布、含 content 变量的卡片模板。 */
   answerCardTemplateId: z.string().optional(),

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)) {
     // 有图片后缀，或路径中明显是文件（含扩展名）

package/src/services/messaging/index.ts

@@ -15,4 +15,6 @@ export {
   sendToGroup,
   sendTextToDingTalk,
   sendMediaToDingTalk,
+  isMessageAnswerCardEnabled,
+  messageToolProactiveCardOptions,
 } from '../messaging.ts';

package/src/services/messaging.ts

@@ -22,11 +22,43 @@ import {
   createAICardForTarget,
   streamAICard,
   finishAICard,
+  ANSWER_CARD_TEMPLATE_ID,
   type AICardInstance,
   type AICardTarget,
 } from "./messaging/card.ts";
 import { substituteBotMentions } from "./messaging/mentions.ts";
 
+/**
+ * message 工具是否用答案卡（默认开；显式 false 才关）。
+ * 与会话流式 answerCard 独立。
+ */
+export function isMessageAnswerCardEnabled(config: DingtalkConfig | null | undefined): boolean {
+  return (config as any)?.messageAnswerCard !== false;
+}
+
+/**
+ * message 工具正文发送的卡片选项：答案卡模板 + 静态 FINISHED，失败降级普通消息。
+ */
+export function messageToolProactiveCardOptions(
+  config: DingtalkConfig,
+): Pick<
+  ProactiveSendOptions,
+  "useAICard" | "fallbackToNormal" | "cardTemplateId" | "skipInputingWalk"
+> {
+  if (!isMessageAnswerCardEnabled(config)) {
+    return { useAICard: false, fallbackToNormal: true };
+  }
+  const tpl =
+    (typeof config.answerCardTemplateId === "string" && config.answerCardTemplateId.trim()) ||
+    ANSWER_CARD_TEMPLATE_ID;
+  return {
+    useAICard: true,
+    fallbackToNormal: true,
+    cardTemplateId: tpl,
+    skipInputingWalk: true,
+  };
+}
+
 // ============ 常量 ============
 // 注意：AI Card 相关的类型和函数已移至 ./messaging/card.ts，通过上方 import 引入
 
@@ -55,6 +87,15 @@ export interface ProactiveSendOptions {
   log?: any;
   useAICard?: boolean;
   fallbackToNormal?: boolean;
+  /**
+   * 覆盖 AI Card / 答案卡模板 ID（如 message 工具答案卡）。
+   * 不传则 createAICardForTarget 用 config.cardTemplateId / 默认流式模板。
+   */
+  cardTemplateId?: string;
+  /**
+   * 答案静态卡：finish 时跳过 INPUTING 过渡，直接 FINISHED（与 closeStreaming 答案卡一致）。
+   */
+  skipInputingWalk?: boolean;
   /**
    * 已在上层 processLocalImages 过则跳过，避免二次处理干扰 MediaIdTrace。
    */
@@ -873,13 +914,21 @@ export async function sendTextToDingTalk(params: {
   }
 
   const msgType: DingTalkMsgType = shouldSendAsMarkdown(text) ? "markdown" : "text";
-  logMediaIdTrace("sendTextToDingTalk:API前", text, `msgType=${msgType}`, true);
+  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 || "-"}`,
+  );
 
   return sendProactive(config, targetParam, text, {
     msgType,
     replyToId,
-    useAICard: false,
-    fallbackToNormal: true,
+    ...cardOpts,
     skipProcessLocalImages: true,
   });
 }
@@ -992,8 +1041,7 @@ export async function sendMediaToDingTalk(params: {
         await sendProactive(config, targetParam, text.trim(), {
           msgType: shouldSendAsMarkdown(text) ? "markdown" : "text",
           replyToId,
-          useAICard: false,
-          fallbackToNormal: true,
+          ...messageToolProactiveCardOptions(config),
         });
       }
       // 远程图可再尝试 photoURL 直链（部分环境可用）
@@ -1052,8 +1100,7 @@ export async function sendMediaToDingTalk(params: {
             await sendProactive(config, targetParam, caption, {
               msgType: shouldSendAsMarkdown(caption) ? "markdown" : "text",
               replyToId,
-              useAICard: false,
-              fallbackToNormal: true,
+              ...messageToolProactiveCardOptions(config),
             });
           }
           if (isRemoteHttpUrl(mediaUrl)) {
@@ -1089,8 +1136,7 @@ export async function sendMediaToDingTalk(params: {
           const result = await sendProactive(config, targetParam, combined, {
             msgType: "markdown",
             replyToId,
-            useAICard: false,
-            fallbackToNormal: true,
+            ...messageToolProactiveCardOptions(config),
           });
           return {
             ...result,
@@ -1102,8 +1148,7 @@ export async function sendMediaToDingTalk(params: {
           await sendProactive(config, targetParam, caption, {
             msgType: shouldSendAsMarkdown(caption) ? "markdown" : "text",
             replyToId,
-            useAICard: false,
-            fallbackToNormal: true,
+            ...messageToolProactiveCardOptions(config),
           });
         }
         const result = await sendProactive(config, targetParam, mediaId, {
@@ -1130,8 +1175,7 @@ export async function sendMediaToDingTalk(params: {
         await sendProactive(config, targetParam, caption, {
           msgType: shouldSendAsMarkdown(caption) ? "markdown" : "text",
           replyToId,
-          useAICard: false,
-          fallbackToNormal: true,
+          ...messageToolProactiveCardOptions(config),
         });
       }
 
@@ -1321,6 +1365,8 @@ async function sendProactiveInternal(
     msgType = "text",
     useAICard = true,          // 默认启用 AI Card，让主动发送消息优先使用卡片形式
     fallbackToNormal = true,   // 默认降级，AI Card 失败时自动回退到普通消息
+    cardTemplateId,
+    skipInputingWalk = false,
     log: externalLog,
   } = options;
 
@@ -1330,9 +1376,25 @@ async function sendProactiveInternal(
   // 如果启用 AI Card（媒体消息强制跳过）
   if (useAICard && !isMediaMessage) {
     try {
-      const card = await createAICardForTarget(config, target, externalLog);
+      const card = await createAICardForTarget(
+        config,
+        target,
+        externalLog,
+        cardTemplateId,
+      );
       if (card) {
-        await finishAICard(card, content, config, externalLog);
+        // 答案静态卡：skipInputingWalk=true 直接 FINISHED；普通卡仍走 INPUTING 再定稿
+        await finishAICard(
+          card,
+          content,
+          config,
+          externalLog,
+          undefined,
+          skipInputingWalk,
+        );
+        console.log(
+          `[DingTalk][MessageCard] AI Card 发送成功 | outTrack=${card.cardInstanceId} tpl=${cardTemplateId || "default"} skipInputing=${skipInputingWalk}`,
+        );
         return {
           ok: true,
           cardInstanceId: card.cardInstanceId,
@@ -1346,8 +1408,14 @@ async function sendProactiveInternal(
           usedAICard: false,
         };
       }
+      console.warn(
+        `[DingTalk][MessageCard] AI Card 创建失败，fallbackToNormal=${fallbackToNormal}`,
+      );
     } catch (err: any) {
       externalLog?.error?.(`AI Card 发送失败: ${err.message}`);
+      console.warn(
+        `[DingTalk][MessageCard] AI Card 异常: ${err?.message || err}，fallbackToNormal=${fallbackToNormal}`,
+      );
       if (!fallbackToNormal) {
         return { ok: false, error: err.message, usedAICard: false };
       }