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

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-fix49] - 2026-07-21
+
+### 变更 / Changed
+- 🎨 **默认流式 AI Card 模板** — `cardTemplateId` 默认 `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema`；`cardContentVar` 默认 `content`（与增强模板字段一致）。
+- 📚 文档：图片发送全面修复叙述；钉钉专属配置最小/最大化（单·多 Agent）；`messageAnswerCard` 等。
+
+### 安装 / Install
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+## [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

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-fix47</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-fix49</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,18 +23,24 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix47 · 2026-07-20 (current)
+### 🚀 v0.8.21-fix49 · 2026-07-21 (current)
 
-**Theme: fix `file://` misclassified as remote URL**
+**Theme: message tool answer card by default (toggle)**
 
 | | Change |
 |--|--------|
-| 🐛 **`file://` grey images** | Treat `file://` / `MEDIA:` / `attachment://` as local upload, not `fetch` |
+| ✨ **`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.
@@ -49,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.
 
 ---
 
@@ -69,22 +68,69 @@ 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-fix49.md)
 
 ---
 
 ## ✨ Enhanced Features
 
-- 🔧 Markdown image support for direct URLs and local paths, no download required:
-  - Markdown syntax `![](direct-url)` or `![](local-path)` sends images directly
-  - Compatible with mediaId format
-  - ⚠️ This plugin supports image messages, but DingTalk side won't trigger this feature automatically. Use the following prompt to guide the Agent:
+### 🖼️ Image sending: full fix & upgrade
+
+> 🔥 **No dead corners** · mixed send paths · far beyond the official’s weak image pipeline  
+> ✅ Chat · ✅ message direct · ✅ markdown embed · ✅ split or merge layout
+
+Full-path image fixes — every channel below renders correctly:
+
+| | Path | Capability |
+|--|------|------------|
+| 💬 | **Normal chat reply** | Agent embeds `![alt](…)`; upload to mediaId before finalize |
+| 📤 | **message · mediaUrl** | Proactive direct send (local / LAN / public) |
+| 📝 | **message · markdown body** | Nested `![](…)` (local / `file://` / URL) with text |
+| ⚙️ | **Configurable layout** | Default 📎 **separate**; `messageImageMd: true` → 🧩 **merge** one markdown |
+
+#### 🌐 Source types covered
 
-    ```
-    Please write a DingTalk image sending skill following this approach: use markdown to send images, with image captions for rich text; direct URLs or local paths can be embedded directly in markdown, and if local paths contain spaces, rename to remove spaces first before sending.
-    ```
+| | Type | Examples |
+|--|------|----------|
+| 🌍 | Public URL | `https://…` |
+| 🏠 | Private / LAN URL | `http://intranet/…` |
+| 📁 | Local absolute path | `/tmp/…` · `/root/…` |
+| 💾 | **`/mnt` mounts** | Chinese paths · SMB shares |
+| 🔗 | `file://` URI | `file:///mnt/…` · `file:///tmp/…` |
+| 🆔 | Existing mediaId | `@lADP…` |
 
-- 🎨 Custom AI Card template support for user-prebuilt cards (with copy button), uses official default card if not set:
+#### 🛡️ Extra safeguards
+
+- 📦 Code-block / inline-code paths are **not** uploaded
+- ⬇️ Remote: **download then upload**; local: **`/tmp` retry** on failure
+- 🫧 Image + download link in **one bubble**: `![]` → mediaId, URL kept as-is
+
+### 🎨 AI Card template
+
+- ✨ Custom stream cards; **if `cardTemplateId` is omitted**, defaults to  
+  `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema` (📋 copy button, etc.)
+
+### ⚙️ Minimal config
+
+```json
+"channels": {
+  "dingtalk-connector": {
+    "enabled": true,
+    "clientId": "your-clientId",
+    "clientSecret": "your-clientSecret"
+  }
+}
+```
+
+Defaults apply: stream card `0d2c84b3-…schema`, session answer card on, message answer card on, `messageImageMd=false`.
+
+> **Maximal config ≡ minimal config.** The blocks below only spell out defaults so the fields are easier to understand. Behavior is the same as the credential-only minimal config — use minimal in production.
+
+### Maximal config (for illustration; defaults written out)
+
+**Single Agent** and **multi Agent** (all values are defaults — **not extra features**).
+
+**Single Agent (top-level credentials):**
 
 ```json
 "channels": {
@@ -92,21 +138,74 @@ Full log: [CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix38
     "enabled": true,
     "clientId": "your-clientId",
     "clientSecret": "your-clientSecret",
-    "cardTemplateId": "your-card-template-id.schema",
-    "cardContentVar": "content"
+    "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
+    "cardContentVar": "content",
+    "answerCard": true,
+    "answerActToken": 500,
+    "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+    "messageAnswerCard": true,
+    "messageImageMd": false
   }
 }
 ```
 
-| 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) |
+**Multi Agent (`accounts`, one credential/card set per bot):**
+
+```json
+"channels": {
+  "dingtalk-connector": {
+    "enabled": true,
+    "defaultAccount": "main-bot",
+    "accounts": {
+      "main-bot": {
+        "enabled": true,
+        "name": "main-bot",
+        "clientId": "main-bot-clientId",
+        "clientSecret": "main-bot-clientSecret",
+        "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
+        "cardContentVar": "content",
+        "answerCard": true,
+        "answerActToken": 500,
+        "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+        "messageAnswerCard": true,
+        "messageImageMd": false
+      },
+      "guide-bot": {
+        "enabled": true,
+        "name": "guide-bot",
+        "clientId": "guide-bot-clientId",
+        "clientSecret": "guide-bot-clientSecret",
+        "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
+        "cardContentVar": "content",
+        "answerCard": true,
+        "answerActToken": 500,
+        "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+        "messageAnswerCard": true,
+        "messageImageMd": false
+      }
+    }
+  }
+}
+```
 
-> Card template must be created in [DingTalk Open Platform](https://open.dingtalk.com/) with matching variable fields.
+### DingTalk-specific fields
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `clientId` | string \| number | — | AppKey / Client ID |
+| `clientSecret` | string \| SecretRef | — | AppSecret |
+| `accounts` | object | — | Multi-bot map |
+| `accounts.*.name` | string | — | Display name |
+| `accounts.*.clientId` / `clientSecret` | — | — | Per-bot credentials |
+| `cardTemplateId` | string | `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema` | Streaming AI Card template |
+| `cardContentVar` | string | `"content"` | Stream card content variable |
+| `answerCard` | boolean | **true** | Session-stream answer card; `false` disables |
+| `answerActToken` | int | **500** | Token threshold for spawning answer card |
+| `answerCardTemplateId` | string | `d246b7f5-1783-4e9b-bb46-bef52d63050e.schema` | Static answer card template |
+| `messageAnswerCard` | boolean | **true** | message-tool body via answer card; `false` = plain message |
+| `messageImageMd` | boolean | **false** | message images: separate vs merge markdown |
+
+> `answerCard` = conversation finalize; `messageAnswerCard` = message-tool outbound.
 
 ---
 

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-fix47</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix47.tgz --force`）</p>
+  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.21-fix49</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix49.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,18 +23,24 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.21-fix47 · 2026-07-20（当前）
+### 🚀 v0.8.21-fix49 · 2026-07-21（当前）
 
-**主题：`file://` 本地图误判远程修复**
+**主题：message 工具默认答案卡（可关）**
 
 | | 改动 |
 |--|------|
-| 🐛 **`file://` 灰图** | `![x](file:///mnt/...)` / `file:///root/...` 按本地上传，不再 `fetch failed` |
+| ✨ **`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）。
@@ -49,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 诊断日志。
 
 ---
 
@@ -69,26 +68,69 @@ message 远程 `media` 下载上传。
 | 2026-06-28 | 上线 npm `@jeik/dingtalk-connector`；过程消息提前定稿修复 |
 | 2026-05 | MD 直链/本地图；多轮刷屏；4.29+ 无文本输出；WebSocket 幻影重连 |
 
-完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix47](docs/RELEASE_NOTES_V0.8.21-fix47.md)
+完整说明：[CHANGELOG.md](CHANGELOG.md) · [FIXES.md](FIXES.md) · [Release fix48](docs/RELEASE_NOTES_V0.8.21-fix49.md)
 
 ---
 
 ## ✨ 增强功能
 
-- 🔧 Markdown 图片发送支持直链和本地路径（含 **`/mnt` 共享盘**、中文路径）：
-  - 语法 `![注释](直链URL)` 或 `![注释](/绝对/本地路径)` → 自动上传 mediaId 后发出
-  - **代码块 / 行内 code 内的路径不会上传**（参数说明原文保留）
-  - 兼容已有 mediaId 格式
-  - message 工具默认**文图分开**；可选 `messageImageMd: true` 在多图+文字时合并 markdown
-  - ⚠️ 需引导 Agent 使用 markdown 发图时可用：
+### 🖼️ 图片发送：全面修复与增强
+
+> 🔥 **毫无死角** · 混合发图 · 全面碾压官方薄弱的图片机制  
+> ✅ 对话发图 · ✅ message 直发 · ✅ markdown 嵌图 · ✅ 文图可分可合
+
+对官方图片发送做了**全路径修复增强**，多通道混合发图，全部显示正常：
 
-    ```
-    请你把以下发送图片的方式写成你的钉钉图片发送skill，当涉及到图片发送，则调用该技能：用markdown语法发送图片，支持添加图片注释实现图文并茂；直链图片或本地路径文件均可直接嵌入markdown发送，如本地路径含空格请先重命名去除空格再发送。展示工具参数时请放在代码块中，避免被当作待发送图片。
-    ```
+| | 发送方式 | 能力 |
+|--|----------|------|
+| 💬 | **普通对话回复** | Agent 用 `![注释](…)` 嵌图，定稿前自动上传 mediaId |
+| 📤 | **message · mediaUrl** | 机器人主动触发直发（本地 / 内网 / 公网） |
+| 📝 | **message · markdown 正文** | 正文嵌 `![](…)`（本地 / `file://` / 直链）与文字同条 |
+| ⚙️ | **文图策略可配** | 默认 📎 **分开**；`messageImageMd: true` → 🧩 **合并**一条 markdown |
 
-- 🎨 支持自定义 AI Card 模板，可使用本人预制的卡片（含内容复制按钮），不填则使用官方默认卡片。
+#### 🌐 路径与协议全覆盖
 
-**单机器人：**
+| | 类型 | 示例 |
+|--|------|------|
+| 🌍 | 公网直链 | `https://…` |
+| 🏠 | 内网直链 | `http://内网主机/…` |
+| 📁 | 本地绝对路径 | `/tmp/…` · `/root/…` |
+| 💾 | **`/mnt` 挂载盘** | 中文目录 · 共享盘 · SMB |
+| 🔗 | `file://` URI | `file:///mnt/…` · `file:///tmp/…` |
+| 🆔 | 已有 mediaId | `@lADP…` |
+
+#### 🛡️ 细节兜底
+
+- 📦 代码块 / 行内 code 路径 **不会误上传**（参数说明原文保留）
+- ⬇️ 远程图 **先下载再上传**；本地失败会 **`/tmp` 重试**
+- 🫧 图 + 下载链接 **同泡共存**：`![]` → mediaId，下载 URL 仍是原链
+
+### 🎨 AI Card 模板
+
+- ✨ 支持自定义流式卡；**不填 `cardTemplateId` 默认**  
+  `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema`（含 📋 复制按钮等）
+
+### ⚙️ 最小配置（够跑）
+
+```json
+"channels": {
+  "dingtalk-connector": {
+    "enabled": true,
+    "clientId": "你的clientId",
+    "clientSecret": "你的clientSecret"
+  }
+}
+```
+
+未写的项走默认：流式卡 `0d2c84b3-…schema`、会话答案卡开、message 答案卡开、`messageImageMd=false`。
+
+> **最大化配置 ≡ 最小化配置。** 下面只是把默认值显式写出来，方便对照字段含义；效果与只填凭证的最小配置相同，生产环境直接用最小配置即可。
+
+### 最大化配置（展示用，默认值写全）
+
+按单 Agent / 多 Agent 两种写法（值均为默认，**不等于额外能力**）。
+
+**单 Agent（顶层凭证）：**
 
 ```json
 "channels": {
@@ -96,57 +138,74 @@ message 远程 `media` 下载上传。
     "enabled": true,
     "clientId": "你的clientId",
     "clientSecret": "你的clientSecret",
-    "cardTemplateId": "你的卡片模板ID.schema",
+    "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
     "cardContentVar": "content",
-    "messageImageMd": false,
-    "debug": false
+    "answerCard": true,
+    "answerActToken": 500,
+    "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+    "messageAnswerCard": true,
+    "messageImageMd": false
   }
 }
 ```
 
-**多机器人（多 Agent）：** 每个账号可绑定不同机器人
+**多 Agent（`accounts`，每个机器人一套凭证与卡片选项）：**
 
 ```json
 "channels": {
   "dingtalk-connector": {
     "enabled": true,
+    "defaultAccount": "main-bot",
     "accounts": {
       "main-bot": {
         "enabled": true,
-        "name": "工作流机器人",
-        "clientId": "你的clientId",
-        "clientSecret": "你的clientSecret",
-        "cardTemplateId": "f9b75aac-713c-40e8-a17f-e236d7b5422b.schema",
-        "cardContentVar": "content"
+        "name": "主机器人",
+        "clientId": "主机器人clientId",
+        "clientSecret": "主机器人clientSecret",
+        "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
+        "cardContentVar": "content",
+        "answerCard": true,
+        "answerActToken": 500,
+        "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+        "messageAnswerCard": true,
+        "messageImageMd": false
       },
-      "another-bot": {
+      "guide-bot": {
         "enabled": true,
-        "name": "另一个机器人",
-        "clientId": "另一个clientId",
-        "clientSecret": "另一个clientSecret",
-        "cardTemplateId": "f9b75aac-713c-40e8-a17f-e236d7b5422b.schema",
-        "cardContentVar": "content"
+        "name": "引导机器人",
+        "clientId": "引导机器人clientId",
+        "clientSecret": "引导机器人clientSecret",
+        "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
+        "cardContentVar": "content",
+        "answerCard": true,
+        "answerActToken": 500,
+        "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
+        "messageAnswerCard": true,
+        "messageImageMd": false
       }
     }
   }
 }
 ```
 
-| 参数 | 说明 |
-|------|------|
-| `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/)创建，并添加对应的变量字段。
+### 钉钉专属配置字段
+
+| 字段 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `clientId` | string \| number | — | 钉钉 AppKey / Client ID |
+| `clientSecret` | string \| SecretRef | — | AppSecret |
+| `accounts` | object | — | 多机器人；key 为账号 ID |
+| `accounts.*.name` | string | — | 账号显示名 |
+| `accounts.*.clientId` / `clientSecret` | — | — | 该机器人凭证 |
+| `cardTemplateId` | string | `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema` | 会话流式 AI Card 模板 |
+| `cardContentVar` | string | `"content"` | 流式卡内容变量名 |
+| `answerCard` | boolean | **true** | 会话流式答案卡；`false` 关闭 |
+| `answerActToken` | int | **500** | 答案卡 token 阈值：≤ 原卡定稿，> 另开答案卡 |
+| `answerCardTemplateId` | string | `d246b7f5-1783-4e9b-bb46-bef52d63050e.schema` | 答案静态卡模板 |
+| `messageAnswerCard` | boolean | **true** | message 工具正文走答案静态卡；`false`=普通消息 |
+| `messageImageMd` | boolean | **false** | message 图文：`false` 文图分开；`true` 可合并 markdown |
+
+> `answerCard` = 对话流式收尾；`messageAnswerCard` = 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-DHMdV0k8.mjs");
+		const { registerGatewayMethods } = await import("./gateway-methods-BnjDzM0H.mjs");
 		registerGatewayMethods(api);
 	}
 });

package/dist/gateway-methods-BnjDzM0H.mjs

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

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

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-f78QdJj5.mjs";
-import { t as registerGatewayMethods } from "./gateway-methods-DNvtOYEG.mjs";
+import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-DOR9z5p2.mjs";
+import { t as registerGatewayMethods } from "./gateway-methods-KiwXV8w1.mjs";
 //#region index.ts
 /**
 * 检测同一 plugin id 在多个路径被加载的情况。

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

@@ -1,9 +1,9 @@
 import { a as resolveDingtalkAccount } from "./accounts-BAzdqkAV.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-f78QdJj5.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-DOR9z5p2.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-msXFq5IJ.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-CgX-cHZa.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";

package/dist/{messaging-msXFq5IJ.mjs → messaging-CgX-cHZa.mjs}

@@ -53,8 +53,10 @@ function unregisterActiveCard(openConversationId) {
 function getActiveCardForConversation(openConversationId) {
 	return _activeCardRegistry.get(openConversationId) ?? null;
 }
-const DEFAULT_CARD_TEMPLATE_ID = "02fcf2f4-5e02-4a85-b672-46d1f715543e.schema";
-const DEFAULT_CARD_CONTENT_VAR = "msgContent";
+/** 社区增强版流式 AI Card 默认模板（含复制按钮等） */
+const DEFAULT_CARD_TEMPLATE_ID = "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema";
+/** 与默认增强模板 0d2c84b3… 字段一致 */
+const DEFAULT_CARD_CONTENT_VAR = "content";
 /**
 * 钉钉卡片 API 的最大 QPS（官方限制约 40 次/秒）。
 * 保守取 20，为 createAICardForTarget / finishAICard 等非流式调用留余量。
@@ -582,6 +584,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）
 */
@@ -898,12 +922,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 +1025,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 +1065,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 +1091,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 +1101,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 +1123,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);
@@ -1219,12 +1239,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 +1257,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-f78QdJj5.mjs → runtime-DOR9z5p2.mjs}

@@ -3,7 +3,7 @@ import { a as resolveDingtalkAccount, c as addWildcardAllowFrom, d as hasConfigu
 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-msXFq5IJ.mjs";
+import { S as finalClean, f as getActiveCardForConversation, n as sendMediaToDingTalk, o as sendTextToDingTalk } from "./messaging-CgX-cHZa.mjs";
 import { createRequire } from "node:module";
 import { z, z as z$1 } from "zod";
 //#region src/secret-input.ts
@@ -102,16 +102,23 @@ 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(),
-	/** AI Card 内容变量名，对应卡片模板中的变量字段，不填默认 msgContent */
-	cardContentVar: z$1.string().optional().default("msgContent"),
+	/** AI Card 内容变量名，对应卡片模板中的变量字段，不填默认 content（与默认增强模板一致） */
+	cardContentVar: z$1.string().optional().default("content"),
 	/** 答案专用卡模式：超过 answerActToken 的最终答案投到一张新的静态文本卡，原流式卡定格"思考完成"，
 	*  规避钉钉流式卡 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-DVXM5olz.mjs"),
+		import("./message-handler-BpyhuanG.mjs"),
 		import("./connection-DHHFFNQJ.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;

package/docs/RELEASE_NOTES_V0.8.21-fix48.md

@@ -0,0 +1,71 @@
+# 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 最小/最大化配置与字段表：
+
+- 凭证 / `accounts`（name、clientId、clientSecret）
+- `cardTemplateId`（默认 `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema`）/ `cardContentVar`（默认 `content`）
+- `answerCard` / `answerActToken`（500）/ `answerCardTemplateId`
+- `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/docs/RELEASE_NOTES_V0.8.21-fix49.md

@@ -0,0 +1,16 @@
+# Release Notes — v0.8.21-fix49（2026-07-21）
+
+## 安装
+
+```bash
+npx -y @jeik/dingtalk-connector install --force
+openclaw gateway restart
+```
+
+## 本版要点
+
+- 默认流式卡：`0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema`，`cardContentVar=content`
+- 含 fix48：`messageAnswerCard`（默认开）、`file://` 本地图修复、图片发送全路径增强
+- 文档：最小/最大化配置、图片能力说明
+
+从 fix48 直接 `--force` 安装即可。

package/openclaw.plugin.json

@@ -14,7 +14,7 @@
     "additionalProperties": false,
     "properties": {
       "cardTemplateId": { "type": "string" },
-      "cardContentVar": { "type": "string", "default": "msgContent" }
+      "cardContentVar": { "type": "string", "default": "content" }
     }
   },
   "channelConfigs": {
@@ -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": [
@@ -260,7 +265,7 @@
           },
           "cardContentVar": {
             "type": "string",
-            "default": "msgContent"
+            "default": "content"
           },
           "answerCard": {
             "type": "boolean"
@@ -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": [
@@ -506,7 +516,7 @@
                 },
                 "cardContentVar": {
                   "type": "string",
-                  "default": "msgContent"
+                  "default": "content"
                 },
                 "answerCard": {
                   "type": "boolean"
@@ -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；不填默认 0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema。",
+          "advanced": true
+        },
+        "channels.dingtalk-connector.cardContentVar": {
+          "label": "Card Content Variable",
+          "help": "流式卡内容变量名，默认 content（过程/工具/终稿写入此字段）。",
+          "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-fix47",
+  "version": "0.8.21-fix49",
   "description": "OpenClaw DingTalk channel plugin (fork) | 钉钉 OpenClaw 渠道插件（fork 自官方，含标记/卡片渲染修复）",
   "type": "module",
   "exports": {

package/src/config/schema.ts

@@ -91,16 +91,23 @@ 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(),
-  /** AI Card 内容变量名，对应卡片模板中的变量字段，不填默认 msgContent */
-  cardContentVar: z.string().optional().default("msgContent"),
+  /** AI Card 内容变量名，对应卡片模板中的变量字段，不填默认 content（与默认增强模板一致） */
+  cardContentVar: z.string().optional().default("content"),
   /** 答案专用卡模式：超过 answerActToken 的最终答案投到一张新的静态文本卡，原流式卡定格"思考完成"，
    *  规避钉钉流式卡 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/messaging/card.ts

@@ -28,8 +28,10 @@ export function getActiveCardForConversation(openConversationId: string): AICard
 
 // ============ 常量 ============
 
-const DEFAULT_CARD_TEMPLATE_ID = "02fcf2f4-5e02-4a85-b672-46d1f715543e.schema";
-const DEFAULT_CARD_CONTENT_VAR = "msgContent";
+/** 社区增强版流式 AI Card 默认模板（含复制按钮等） */
+const DEFAULT_CARD_TEMPLATE_ID = "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema";
+/** 与默认增强模板 0d2c84b3… 字段一致 */
+const DEFAULT_CARD_CONTENT_VAR = "content";
 
 /**
  * 钉钉卡片 API 的最大 QPS（官方限制约 40 次/秒）。

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 };
       }

package/dist/gateway-methods-DHMdV0k8.mjs

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