@dingtalk-real-ai/dingtalk-connector 0.8.8 → 0.8.9

package/CHANGELOG.md

@@ -5,6 +5,44 @@ 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.9] - 2026-03-31
+
+### 新增 / Added
+- ✨ **引用消息完整解析** - 新增 `extractQuotedMsgText` 递归解析引用消息（最多 3 层嵌套），支持 text、richText、picture、video、audio、file、markdown、interactiveCard 等消息类型，自动提取引用中的媒体附件和链接  
+  **Quoted message full parsing** - Added recursive quoted message parsing (up to 3 levels) with media attachment and URL extraction
+
+- ✨ **新增配置项 asyncMode / ackText / endpoint / debug** - `configSchema` 新增四个配置字段  
+  **New config options** - Added `asyncMode`, `ackText`, `endpoint`, `debug` to configSchema
+
+- ✨ **普通消息本地图片后处理** - `sendNormalToUser` 和 `sendNormalToGroup` 新增本地图片上传后处理，发送普通消息时自动替换本地图片路径为 media_id  
+  **Local image post-processing for normal messages** - Added automatic local image upload and replacement in `sendNormalToUser` and `sendNormalToGroup`
+
+### 修复 / Fixes
+- 🐛 **macOS LaunchAgent 环境 WebSocket 连接失败** - 修复 macOS LaunchAgent/daemon 环境下 fd 0/1/2 无效（EBADF）导致 TCP 连接创建失败的问题  
+  **WebSocket connection failure on macOS LaunchAgent** - Fixed EBADF errors on macOS LaunchAgent environments by redirecting invalid file descriptors to `/dev/null`
+
+- 🐛 **AI Card 流式关闭竞争条件** - 修复 `closeStreaming` 被 `onIdle` 和 `onError` 同时触发时的竞争条件，采用 snapshot 模式防止并发崩溃  
+  **AI Card streaming close race condition** - Fixed race condition in `closeStreaming` using snapshot pattern to prevent concurrent crashes
+
+- 🐛 **FormData CJS 互操作问题** - 将 `form-data` 从动态 import 改为静态 import，修复 jiti/ESM 环境下 `.default` 偶发为 undefined 的问题  
+  **FormData CJS interop issue** - Changed `form-data` from dynamic to static import, fixing intermittent `.default` undefined errors in jiti/ESM
+
+- 🐛 **纯文本图片路径误转换** - 禁用纯文本中本地图片路径自动转换为图片语法的行为，避免影响用户展示路径文本的场景  
+  **Bare image path false conversion** - Disabled automatic conversion of bare local image paths to image syntax
+
+### 改进 / Improvements
+- ✅ **Zod Schema 拆分兼容 Web UI** - 将 `DingtalkConfigSchema` 拆分为 `DingtalkConfigBaseSchema` 和带 `superRefine` 的完整 Schema，解决 JSON Schema 生成兼容性问题  
+  **Zod Schema split for Web UI compatibility** - Split schema to fix `buildChannelConfigSchema` JSON Schema generation
+
+- ✅ **configSchema 类型简化** - 将 `clientId`、`clientSecret` 等字段从 `oneOf` 联合类型简化为单一 `string` 类型  
+  **configSchema type simplification** - Simplified JSON Schema from `oneOf` union types to single `string` type
+
+- ✅ **reply-dispatcher logger 统一** - 替换手动构建的 log 对象为 `createLoggerFromConfig`  
+  **reply-dispatcher logger unification** - Replaced manual log object with `createLoggerFromConfig`
+
+- ✅ **锁定 axios 版本到 1.6.0** - 避免自动升级引入不兼容变更  
+  **Pin axios to 1.6.0** - Prevent automatic upgrades from introducing incompatible changes
+
 ## [0.8.8] - 2026-03-29
 
 ### 修复 / Fixes

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "description": "DingTalk (钉钉) messaging channel via Stream mode with AI Card streaming",
   "author": "DingTalk Real Team",
   "main": "index.ts",
@@ -11,11 +11,6 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "properties": {
-      "enabled": {
-        "type": "boolean",
-        "default": true
-      }
-    }
+    "properties": {}
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dingtalk-real-ai/dingtalk-connector",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "description": "DingTalk (钉钉) channel connector — Stream mode with AI Card streaming",
   "main": "index.ts",
   "type": "module",

package/src/channel.ts

@@ -1,5 +1,4 @@
 import type {
-  ChannelMeta,
   ChannelPlugin,
   ClawdbotConfig,
 } from "openclaw/plugin-sdk";
@@ -30,33 +29,17 @@ import { monitorDingtalkProvider } from "./core/provider.ts";
 import { sendTextToDingTalk, sendMediaToDingTalk } from "./services/messaging/index.ts";
 import type { ResolvedDingtalkAccount, DingtalkConfig } from "./types/index.ts";
 
-const meta: ChannelMeta = {
+const meta = {
   id: "dingtalk-connector",
   label: "DingTalk",
   selectionLabel: "DingTalk (钉钉)",
   docsPath: "/channels/dingtalk-connector",
   docsLabel: "dingtalk-connector",
   blurb: "钉钉企业内部机器人，使用 Stream 模式，无需公网 IP，支持 AI Card 流式响应。",
-  aliases: ["dd", "ding"],
+  aliases: ["dd", "ding"] as string[],
   order: 70,
 };
 
-const secretInputJsonSchema = {
-  oneOf: [
-    { type: "string" },
-    {
-      type: "object",
-      additionalProperties: false,
-      required: ["source", "provider", "id"],
-      properties: {
-        source: { type: "string", enum: ["env", "file", "exec"] },
-        provider: { type: "string", minLength: 1 },
-        id: { type: "string", minLength: 1 },
-      },
-    },
-  ],
-} as const;
-
 export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
   id: "dingtalk-connector",
   meta: {
@@ -100,30 +83,27 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
       properties: {
         enabled: { type: "boolean" },
         defaultAccount: { type: "string" },
-        clientId: { oneOf: [{ type: "string" }, { type: "number" }] },
-        clientSecret: secretInputJsonSchema,
+        clientId: { type: "string" },
+        clientSecret: { type: "string" },
         enableMediaUpload: { type: "boolean" },
         systemPrompt: { type: "string" },
         dmPolicy: { type: "string", enum: ["open", "pairing", "allowlist"] },
-        allowFrom: { type: "array", items: { oneOf: [{ type: "string" }, { type: "number" }] } },
+        allowFrom: { type: "array", items: { type: "string" } },
         groupPolicy: { type: "string", enum: ["open", "allowlist", "disabled"] },
-        groupAllowFrom: {
-          type: "array",
-          items: { oneOf: [{ type: "string" }, { type: "number" }] },
-        },
+        groupAllowFrom: { type: "array", items: { type: "string" } },
         requireMention: { type: "boolean" },
-        groupSessionScope: {
-          type: "string",
-          enum: ["group", "group_sender"],
-        },
+        groupSessionScope: { type: "string", enum: ["group", "group_sender"] },
         separateSessionByConversation: { type: "boolean" },
         sharedMemoryAcrossConversations: { type: "boolean" },
         historyLimit: { type: "integer", minimum: 0 },
-        dmHistoryLimit: { type: "integer", minimum: 0 },
         textChunkLimit: { type: "integer", minimum: 1 },
         mediaMaxMb: { type: "number", minimum: 0 },
         typingIndicator: { type: "boolean" },
         resolveSenderNames: { type: "boolean" },
+        asyncMode: { type: "boolean" },
+        ackText: { type: "string" },
+        endpoint: { type: "string" },
+        debug: { type: "boolean" },
         tools: {
           type: "object",
           additionalProperties: false,
@@ -146,12 +126,9 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
                 },
               },
               enabled: { type: "boolean" },
-              allowFrom: { type: "array", items: { oneOf: [{ type: "string" }, { type: "number" }] } },
+              allowFrom: { type: "array", items: { type: "string" } },
               systemPrompt: { type: "string" },
-              groupSessionScope: {
-                type: "string",
-                enum: ["group", "group_sender"],
-              },
+              groupSessionScope: { type: "string", enum: ["group", "group_sender"] },
             },
           },
         },
@@ -162,28 +139,26 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
             properties: {
               enabled: { type: "boolean" },
               name: { type: "string" },
-              clientId: { oneOf: [{ type: "string" }, { type: "number" }] },
-              clientSecret: secretInputJsonSchema,
+              clientId: { type: "string" },
+              clientSecret: { type: "string" },
               enableMediaUpload: { type: "boolean" },
               systemPrompt: { type: "string" },
               dmPolicy: { type: "string", enum: ["open", "pairing", "allowlist"] },
-              allowFrom: { type: "array", items: { oneOf: [{ type: "string" }, { type: "number" }] } },
+              allowFrom: { type: "array", items: { type: "string" } },
               groupPolicy: { type: "string", enum: ["open", "allowlist", "disabled"] },
-              groupAllowFrom: {
-                type: "array",
-                items: { oneOf: [{ type: "string" }, { type: "number" }] },
-              },
+              groupAllowFrom: { type: "array", items: { type: "string" } },
               requireMention: { type: "boolean" },
-              groupSessionScope: {
-                type: "string",
-                enum: ["group", "group_sender"],
-              },
+              groupSessionScope: { type: "string", enum: ["group", "group_sender"] },
               separateSessionByConversation: { type: "boolean" },
               sharedMemoryAcrossConversations: { type: "boolean" },
               historyLimit: { type: "integer", minimum: 0 },
               textChunkLimit: { type: "integer", minimum: 1 },
               mediaMaxMb: { type: "number", minimum: 0 },
               typingIndicator: { type: "boolean" },
+              asyncMode: { type: "boolean" },
+              ackText: { type: "string" },
+              endpoint: { type: "string" },
+              debug: { type: "boolean" },
               tools: {
                 type: "object",
                 additionalProperties: false,
@@ -342,7 +317,7 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
       };
     },
   },
-  onboarding: dingtalkOnboardingAdapter,
+  setupWizard: dingtalkOnboardingAdapter as any,
   messaging: {
     normalizeTarget: (raw) => normalizeDingtalkTarget(raw) ?? undefined,
     targetResolver: {
@@ -465,7 +440,7 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
     },
   },
   status: {
-    defaultRuntime: createDefaultChannelRuntimeState(DEFAULT_ACCOUNT_ID, { port: null }),
+    defaultRuntime: createDefaultChannelRuntimeState(DEFAULT_ACCOUNT_ID, { port: null }) as any,
     buildChannelSummary: ({ snapshot }) => ({
       // 只返回 probe 相关字段，不透传运行时字段（running/lastStartAt 等）。
       // 运行时状态由框架从 store.runtimes 自动维护，buildChannelSummary 在 probe
@@ -572,7 +547,7 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
         });
       } catch (err: any) {
         // 打印真实错误到 stderr，绕过框架 log 系统（框架的 runtime.log 可能未初始化）
-        ctx.log?.error(`[dingtalk-connector][${ctx.accountId}] startAccount error:`, err?.message ?? err, err?.stack);
+        ctx.log?.error(`[dingtalk-connector][${ctx.accountId}] startAccount error: ${err?.message ?? err}\n${err?.stack ?? ''}`);
         throw err;
       }
     },

package/src/config/schema.ts

@@ -54,7 +54,6 @@ const DingtalkSharedConfigShape = {
   requireMention: z.boolean().optional(),
   groups: z.record(z.string(), DingtalkGroupSchema.optional()).optional(),
   historyLimit: z.number().int().min(0).optional(),
-  dmHistoryLimit: z.number().int().min(0).optional(),
   textChunkLimit: z.number().int().positive().optional(),
   mediaMaxMb: z.number().positive().optional(),
   tools: DingtalkToolsConfigSchema,
@@ -83,7 +82,11 @@ export const DingtalkAccountConfigSchema = z
   })
   .strict();
 
-export const DingtalkConfigSchema = z
+/**
+ * Base schema (ZodObject) without superRefine, used for JSON Schema generation (Web UI).
+ * superRefine turns the schema into ZodEffects which is not compatible with buildChannelConfigSchema.
+ */
+export const DingtalkConfigBaseSchema = z
   .object({
     enabled: z.boolean().optional(),
     defaultAccount: z.string().optional(),
@@ -102,8 +105,9 @@ export const DingtalkConfigSchema = z
     // Multi-account configuration
     accounts: z.record(z.string(), DingtalkAccountConfigSchema.optional()).optional(),
   })
-  .strict()
-  .superRefine((value, ctx) => {
+  .strict();
+
+export const DingtalkConfigSchema = DingtalkConfigBaseSchema.superRefine((value, ctx) => {
     const defaultAccount = value.defaultAccount?.trim();
     if (defaultAccount && value.accounts && Object.keys(value.accounts).length > 0) {
       const normalizedDefaultAccount = normalizeAccountId(defaultAccount);

package/src/core/connection.ts

@@ -12,6 +12,7 @@
  * - 详细的消息接收日志（三阶段：接收、解析、处理）
  * - 连接统计和监控（每分钟输出）
  */
+import * as fs from 'fs';
 import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
 import type { ResolvedDingtalkAccount } from "../types/index.ts";
 import {
@@ -101,6 +102,30 @@ export async function monitorSingleAccount(
     );
   }
 
+  // ============ 修复 macOS LaunchAgent 环境下的文件描述符问题 ============
+  //
+  // 在 macOS LaunchAgent/daemon 环境下，进程启动时 stdin/stdout/stderr（fd 0/1/2）
+  // 可能无效（EBADF），导致 Node.js 的 net.Socket 在创建 TCP 连接时出现 EBADF 错误。
+  // 通过打开 /dev/null 来确保 fd 0/1/2 有效，避免 socket 创建时使用无效的 fd。
+  //
+  // 参考：OpenClaw issue #8021 (spawn EBADF on macOS with Node.js 22+)
+  if (process.platform === 'darwin') {
+    for (const stdioFd of [0, 1, 2]) {
+      try {
+        fs.fstatSync(stdioFd);
+      } catch (fdError: any) {
+        if (fdError.code === 'EBADF') {
+          logger.warn(`[LaunchAgent] 检测到 fd ${stdioFd} 无效（EBADF），重定向到 /dev/null 以防止 TCP socket 创建失败`);
+          try {
+            fs.openSync('/dev/null', stdioFd === 0 ? 'r' : 'w');
+          } catch (openError: any) {
+            logger.warn(`[LaunchAgent] 无法修复 fd ${stdioFd}: ${openError.message}`);
+          }
+        }
+      }
+    }
+  }
+
   logger.info(`Starting DingTalk Stream client...`);
   logger.info(`Initializing with clientId: ${clientIdStr.substring(0, 8)}...`);
   logger.info(`WebSocket keepAlive: false (using application-layer heartbeat)`);