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

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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

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-fix48</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,7 +23,7 @@
 
 ## 🔧 Recent Updates
 
-### 🚀 v0.8.21-fix48 · 2026-07-21 (current)
+### 🚀 v0.8.21-fix49 · 2026-07-21 (current)
 
 **Theme: message tool answer card by default (toggle)**
 
@@ -68,120 +68,144 @@ Local images (incl. `/mnt`) · `messageImageMd` · LocalImage diagnostics.
 | 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 fix48](docs/RELEASE_NOTES_V0.8.21-fix48.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
 
-    ```
-    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.
-    ```
+> 🔥 **No dead corners** · mixed send paths · far beyond the official’s weak image pipeline  
+> ✅ Chat · ✅ message direct · ✅ markdown embed · ✅ split or merge layout
 
-- 🎨 Custom AI Card template support for user-prebuilt cards (with copy button), uses official default card if not set:
+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
+
+| | 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…` |
+
+#### 🛡️ 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",
-    "cardTemplateId": "your-card-template-id.schema",
-    "cardContentVar": "content",
-    "messageAnswerCard": true
+    "clientSecret": "your-clientSecret"
   }
 }
 ```
 
-### Full config reference (`channels.dingtalk-connector`)
+Defaults apply: stream card `0d2c84b3-…schema`, session answer card on, message answer card on, `messageImageMd=false`.
 
-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.
+> **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.
 
-#### 1. Enable / credentials / multi-account
+### Maximal config (for illustration; defaults written out)
 
-| 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 |
+**Single Agent** and **multi Agent** (all values are defaults — **not extra features**).
 
-#### 2. Access policy
+**Single Agent (top-level credentials):**
 
-| 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
+```json
+"channels": {
+  "dingtalk-connector": {
+    "enabled": true,
+    "clientId": "your-clientId",
+    "clientSecret": "your-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
+  }
+}
+```
 
-| 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
+**Multi Agent (`accounts`, one credential/card set per bot):**
 
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `tools.docs` | boolean | true (semantic) | Document tools |
-| `tools.media` | boolean | true (semantic) | Media upload tools |
+```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
+      }
+    }
+  }
+}
+```
 
-#### 5. Group reply / AI card / answer card / message tool
+### DingTalk-specific fields
 
 | 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.
+| `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-fix48</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix48.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,7 +23,7 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.21-fix48 · 2026-07-21（当前）
+### 🚀 v0.8.21-fix49 · 2026-07-21（当前）
 
 **主题：message 工具默认答案卡（可关）**
 
@@ -68,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 fix48](docs/RELEASE_NOTES_V0.8.21-fix48.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 发图时可用：
+### 🖼️ 图片发送：全面修复与增强
 
-    ```
-    请你把以下发送图片的方式写成你的钉钉图片发送skill，当涉及到图片发送，则调用该技能：用markdown语法发送图片，支持添加图片注释实现图文并茂；直链图片或本地路径文件均可直接嵌入markdown发送，如本地路径含空格请先重命名去除空格再发送。展示工具参数时请放在代码块中，避免被当作待发送图片。
-    ```
+> 🔥 **毫无死角** · 混合发图 · 全面碾压官方薄弱的图片机制  
+> ✅ 对话发图 · ✅ message 直发 · ✅ markdown 嵌图 · ✅ 文图可分可合
 
-- 🎨 支持自定义 AI Card 模板，可使用本人预制的卡片（含内容复制按钮），不填则使用官方默认卡片。
+对官方图片发送做了**全路径修复增强**，多通道混合发图，全部显示正常：
 
-**单机器人：**
+| | 发送方式 | 能力 |
+|--|----------|------|
+| 💬 | **普通对话回复** | Agent 用 `![注释](…)` 嵌图，定稿前自动上传 mediaId |
+| 📤 | **message · mediaUrl** | 机器人主动触发直发（本地 / 内网 / 公网） |
+| 📝 | **message · markdown 正文** | 正文嵌 `![](…)`（本地 / `file://` / 直链）与文字同条 |
+| ⚙️ | **文图策略可配** | 默认 📎 **分开**；`messageImageMd: true` → 🧩 **合并**一条 markdown |
+
+#### 🌐 路径与协议全覆盖
+
+| | 类型 | 示例 |
+|--|------|------|
+| 🌍 | 公网直链 | `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": {
@@ -95,127 +138,74 @@ message 远程 `media` 下载上传。
     "enabled": true,
     "clientId": "你的clientId",
     "clientSecret": "你的clientSecret",
-    "cardTemplateId": "你的卡片模板ID.schema",
+    "cardTemplateId": "0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema",
     "cardContentVar": "content",
-    "messageImageMd": false,
+    "answerCard": true,
+    "answerActToken": 500,
+    "answerCardTemplateId": "d246b7f5-1783-4e9b-bb46-bef52d63050e.schema",
     "messageAnswerCard": true,
-    "debug": false
+    "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
       }
     }
   }
 }
 ```
 
-### 完整配置字段（`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 工具外发。不要混为一谈。
+| `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-DtzGBBiy.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-CuqlMAXE.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-DOEBZgXQ.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.mjs

@@ -1,5 +1,5 @@
-import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-hVrm4xYI.mjs";
-import { t as registerGatewayMethods } from "./gateway-methods-CuqlMAXE.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-DKPtnK0x.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-hVrm4xYI.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-DOEBZgXQ.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-DOEBZgXQ.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 等非流式调用留余量。

package/dist/{runtime-hVrm4xYI.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-DOEBZgXQ.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
@@ -112,8 +112,8 @@ const DingtalkSharedConfigShape = {
 	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(),
@@ -937,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-DKPtnK0x.mjs"),
+		import("./message-handler-BpyhuanG.mjs"),
 		import("./connection-DHHFFNQJ.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;

package/docs/RELEASE_NOTES_V0.8.21-fix48.md

@@ -44,16 +44,14 @@ openclaw gateway restart
 "messageAnswerCard": false
 ```
 
-### 完整字段表
+### 钉钉专属字段（文档）
 
-见仓库 README「完整配置字段」章节（中文 `README.md` / 英文 `README.en.md`），与 `src/config/schema.ts`、`openclaw.plugin.json` 对齐，含：
+见 README 最小/最大化配置与字段表：
 
-- 凭证 / `accounts` / `chatbotUserId`
-- `dmPolicy` / `groupPolicy` / `requireMention` / `groups.*`
-- 会话：`groupSessionScope` / `separateSessionByConversation` / …
-- 卡片：`groupReplyMode` / `cardTemplateId` / `cardContentVar`
-- 答案卡：`answerCard` / `answerActToken`（默认 500）/ `answerCardTemplateId`
-- message：`messageAnswerCard`（默认 true）/ `messageImageMd`（默认 false）
+- 凭证 / `accounts`（name、clientId、clientSecret）
+- `cardTemplateId`（默认 `0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema`）/ `cardContentVar`（默认 `content`）
+- `answerCard` / `answerActToken`（500）/ `answerCardTemplateId`
+- `messageAnswerCard`（true）/ `messageImageMd`（false）
 
 ## 日志
 

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": {
@@ -265,7 +265,7 @@
           },
           "cardContentVar": {
             "type": "string",
-            "default": "msgContent"
+            "default": "content"
           },
           "answerCard": {
             "type": "boolean"
@@ -516,7 +516,7 @@
                 },
                 "cardContentVar": {
                   "type": "string",
-                  "default": "msgContent"
+                  "default": "content"
                 },
                 "answerCard": {
                   "type": "boolean"
@@ -579,12 +579,12 @@
         },
         "channels.dingtalk-connector.cardTemplateId": {
           "label": "AI Card Template ID",
-          "help": "会话流式 AI Card 模板 ID；不填用官方默认流式模板。",
+          "help": "会话流式 AI Card 模板 ID；不填默认 0d2c84b3-12c1-473b-b14a-f329a7a102cd.schema。",
           "advanced": true
         },
         "channels.dingtalk-connector.cardContentVar": {
           "label": "Card Content Variable",
-          "help": "流式卡内容变量名，默认 msgContent（过程/工具/终稿写入此字段）。",
+          "help": "流式卡内容变量名，默认 content（过程/工具/终稿写入此字段）。",
           "advanced": true
         },
         "channels.dingtalk-connector.answerCard": {

package/package.json

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

package/src/config/schema.ts

@@ -101,8 +101,8 @@ const DingtalkSharedConfigShape = {
   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(),

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/dist/gateway-methods-DtzGBBiy.mjs

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