@jeik/dingtalk-connector 0.8.24 → 0.8.26-fix1

package/CHANGELOG.md

@@ -5,6 +5,28 @@ 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.26] - 2026-07-25
+
+### 修复与优化 / Fixed & Improved
+- 🎯 **目标 ID 约束强化** — 强化出站消息回复指引，严格约束 target ID 完整保留 Base64 / 特殊符号后缀（如 `==`、`=`）与字母大小写。
+
+### 安装 / Install
+```bash
+npm install -g @jeik/dingtalk-connector@0.8.26
+```
+
+## [0.8.25] - 2026-07-24
+
+### 修复与优化 / Fixed & Improved
+- ✨ **发送人身份与岗位信息** — 消息推送给 Agent 时自动前置发送人真名、岗位 (Title)、入职时间及角色（老板/主管）。
+- 🐛 **无前缀裸钉钉 ID 推导** — 自动将无前缀裸钉钉用户 ID 正确推导为 `direct`（单聊）类型。
+- 🛠️ **消息处理器与发送工具** — 优化消息响应调度与发送工具底层逻辑。
+
+### 安装 / Install
+```bash
+npm install -g @jeik/dingtalk-connector@0.8.25
+```
+
 ## [0.8.21-fix49] - 2026-07-21
 
 ### 变更 / Changed

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-fix49</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.21-fix49.tgz --force`）</p>
+  <p><strong>当前发布版：<a href="https://www.npmjs.com/package/@jeik/dingtalk-connector">@jeik/dingtalk-connector</a> v0.8.26</strong>（稳定生产可用；一键安装：`npx -y @jeik/dingtalk-connector install`；本地 tgz：`openclaw plugins install ./jeik-dingtalk-connector-0.8.26.tgz --force`）</p>
 
   <p>
     <a href="https://www.npmjs.com/package/@jeik/dingtalk-connector"><img src="https://img.shields.io/npm/v/@jeik/dingtalk-connector.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="npm version" /></a>
@@ -23,20 +23,28 @@
 
 ## 🔧 最近更新
 
-### 🚀 v0.8.21-fix49 · 2026-07-21（当前）
+### 🚀 v0.8.26 · 2026-07-25（当前正式版）
 
-**主题：message 工具默认答案卡（可关）**
+**主题：目标 ID 填写约束强化 + 特殊字符后缀与大小写保留**
 
 | | 改动 |
 |--|------|
-| ✨ **`messageAnswerCard`** | **默认 `true`**：message 正文走答案静态卡；`false` 恢复普通 text/markdown |
-| 🔧 **注册** | `schema` + `openclaw.plugin.json`（channels / accounts / uiHints） |
-| 📎 **独立** | 与会话流式 `answerCard` 分开；媒体消息仍普通通道 |
+| 🎯 **目标 ID 约束强化** | 出站消息回复指引强化，约束 target ID 完整保留 Base64/特殊字符后缀（如 `==`、`=`）与大小写 |
+
+| | 改动 |
+|--|------|
+| 👤 **发送人岗位与身份** | 自动前置推送发送人真名、岗位 (Title)、入职时间及老板/主管角色信息 |
+| 🎯 **`targets` 解析修复** | 无前缀裸钉钉用户 ID 自动智能推导为 `direct`（单聊）类型 |
+| 🛠️ **消息处理增强** | 消息处理器底层逻辑优化与工具库稳定性提升 |
 
 ```bash
 npx -y @jeik/dingtalk-connector install --force && openclaw gateway restart
 ```
 
+### 📦 v0.8.21-fix49 · 2026-07-21
+
+`message` 工具默认答案卡（可关）；增强模板字段一致。
+
 ### 📦 v0.8.21-fix47 · 2026-07-20
 
 `file://` 本地图误判远程修复（不再 `fetch failed` 灰图）。

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-BdF5tr4a.mjs";
+import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-DzZo6Gvk.mjs";
 import { t as registerGatewayMethods } from "./gateway-methods--aKsyMs-.mjs";
 //#region index.ts
 /**

package/dist/{message-handler-DLWxae1K.mjs → message-handler-DQZiKx3i.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveDingtalkAccount } from "./accounts-BAzdqkAV.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-BdF5tr4a.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-DzZo6Gvk.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";
@@ -2265,11 +2265,17 @@ async function handleDingTalkMessageInternal(params) {
 		}
 	} catch (err) {
 		log?.error?.(`SDK dispatch 失败: ${err.message}`);
-		try {
+		const errorText = matchModelErrorText(err.message, { includeCatchAll: true }) ?? `⚠️ 抱歉，处理请求时出错: ${err.message}`;
+		if (earlyCard) try {
+			await streamAICard(earlyCard, errorText, true, config, log);
+		} catch (cardErr) {
+			log?.error?.(`更新错误卡片失败: ${cardErr.message}`);
+		}
+		else try {
 			const token = await getAccessToken(config);
 			const body = {
 				msgtype: "text",
-				text: { content: `抱歉，处理请求时出错: ${err.message}` }
+				text: { content: errorText }
 			};
 			if (!isDirect) body.at = {
 				atUserIds: [senderId],

package/dist/{runtime-BdF5tr4a.mjs → runtime-DzZo6Gvk.mjs}

@@ -955,7 +955,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-DLWxae1K.mjs"),
+		import("./message-handler-DQZiKx3i.mjs"),
 		import("./connection-fc6B4z4G.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;

package/docs/RELEASE_NOTES_V0.8.25.md

@@ -0,0 +1,25 @@
+# RELEASE NOTES - V0.8.25 (正式版)
+
+**发布日期**: 2026-07-24
+
+---
+
+## 🚀 核心更新
+
+### 1. 发送人身份强化与岗位信息 (Sender Identity & Job Title)
+- ✨ **前置发送人身份全量信息**: 消息发送推给 Agent 时，自动通过通讯录 API 拉取并附带发送人的真名、**岗位 (Title)**、入职时间、角色（老板/主管）等信息，便于 Agent 更精准识别与响应。
+
+### 2. 目标解析与类型推导优化 (Targets & Routing)
+- 🐛 **无前缀裸钉钉 ID 推导修复**: 当传入没有显式类型前缀的钉钉用户 ID 时，自动正确推导为 `direct`（单聊）类型，避免解析失败或报错。
+
+### 3. 消息处理器与发送工具优化 (Message Handler & Utilities)
+- 🛠️ 优化消息处理器底层管道与异步调度。
+- 📦 升级包定义与依赖更新。
+
+---
+
+## 📦 安装与升级
+
+```bash
+npm install -g @jeik/dingtalk-connector@0.8.25
+```

package/docs/RELEASE_NOTES_V0.8.26.md

@@ -0,0 +1,18 @@
+# RELEASE NOTES - V0.8.26 (正式版)
+
+**发布日期**: 2026-07-25
+
+---
+
+## 🚀 核心更新
+
+### 1. 目标 ID 恢复约束强化 (Target ID Prompt Constraints)
+- 🎯 **出站消息 target ID 保留后缀与大小写约束**: 强化消息转发/回复场景下的 ID 指引，强调完整保留 Base64 / 特殊符号后缀（如 `==`、`=`）与字母大小写，避免模型在调用 `message` 工具时因裁剪符号导致投递失败。
+
+---
+
+## 📦 安装与升级
+
+```bash
+npm install -g @jeik/dingtalk-connector@0.8.26
+```

package/package.json

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

package/src/core/message-handler.ts

@@ -62,7 +62,7 @@ import {
   lookupCardContent,
 } from "../services/messaging/card-content-cache.ts";
 import { QUEUE_BUSY_ACK_PHRASES } from "../utils/constants.ts";
-import { createDingtalkReplyDispatcher } from "../reply-dispatcher.ts";
+import { createDingtalkReplyDispatcher, matchModelErrorText } from "../reply-dispatcher.ts";
 import { normalizeSlashCommand } from "../utils/session.ts";
 import { getDingtalkRuntime } from "../runtime.ts";
 import { dingtalkHttp } from '../utils/http-client.ts';
@@ -1906,20 +1906,32 @@ export async function handleDingTalkMessageInternal(params: HandleMessageParams)
   } catch (err: any) {
     log?.error?.(`SDK dispatch 失败: ${err.message}`);
     
-    // 降级：发送错误消息
-    try {
-      const token = await getAccessToken(config);
-      const body: any = { 
-        msgtype: 'text', 
-        text: { content: `抱歉，处理请求时出错: ${err.message}` } 
-      };
-      if (!isDirect) body.at = { atUserIds: [senderId], isAtAll: false };
-      
-      await dingtalkHttp.post(sessionWebhook, body, {
-        headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
-      });
-    } catch (fallbackErr: any) {
-      log?.error?.(`错误消息发送也失败: ${fallbackErr.message}`);
+    // 解析上游错误文本（例如 503 No available channel），匹配中文提示文案
+    const errorText = matchModelErrorText(err.message, { includeCatchAll: true }) ?? `⚠️ 抱歉，处理请求时出错: ${err.message}`;
+
+    // 如果已经建了 AI Card，则更新报错状态到 Card，避免停留在"正在召唤大模型"
+    if (earlyCard) {
+      try {
+        await streamAICard(earlyCard, errorText, true, config, log);
+      } catch (cardErr: any) {
+        log?.error?.(`更新错误卡片失败: ${cardErr.message}`);
+      }
+    } else {
+      // 降级：发送错误文本消息
+      try {
+        const token = await getAccessToken(config);
+        const body: any = { 
+          msgtype: 'text', 
+          text: { content: errorText } 
+        };
+        if (!isDirect) body.at = { atUserIds: [senderId], isAtAll: false };
+        
+        await dingtalkHttp.post(sessionWebhook, body, {
+          headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
+        });
+      } catch (fallbackErr: any) {
+        log?.error?.(`错误消息发送也失败: ${fallbackErr.message}`);
+      }
     }
   }
 

package/src/reply-dispatcher.ts

@@ -239,7 +239,7 @@ const MODEL_ERROR_CATCH_ALL: [RegExp, string] = [/.{20,}/, MODEL_ERROR_GENERIC];
  * @param opts.includeCatchAll 为 true 时启用万能兜底
  * @returns 命中则返回中文提示，未命中返回 null
  */
-function matchModelErrorText(
+export function matchModelErrorText(
   source: string,
   opts?: { includeCatchAll?: boolean },
 ): string | null {