@largezhou/ddingtalk 1.3.2 → 1.4.0-beta.1

package/src/channel.ts

@@ -1,9 +1,13 @@
 import {
   buildChannelConfigSchema,
   DEFAULT_ACCOUNT_ID,
+  setAccountEnabledInConfigSection,
+  deleteAccountFromConfigSection,
+  applyAccountNameToChannelSection,
   formatPairingApproveHint,
   loadWebMedia,
   missingTargetError,
+  normalizeAccountId,
   type ChannelPlugin,
   type ChannelStatusIssue,
   type ChannelAccountSnapshot,
@@ -13,16 +17,16 @@ import path from "path";
 import { getDingTalkRuntime } from "./runtime.js";
 import {
   listDingTalkAccountIds,
-  normalizeAccountId,
   resolveDefaultDingTalkAccountId,
   resolveDingTalkAccount,
 } from "./accounts.js";
 import { DingTalkConfigSchema, type DingTalkConfig, type ResolvedDingTalkAccount, type DingTalkGroupConfig } from "./types.js";
-import { sendTextMessage, sendImageMessage, sendFileMessage, uploadMedia, probeDingTalkBot, inferMediaType, isGroupTarget } from "./client.js";
+import { sendTextMessage, sendImageMessage, sendFileMessage, sendAudioMessage, sendVideoMessage, uploadMedia, probeDingTalkBot, inferMediaType, isGroupTarget } from "./client.js";
 import { logger } from "./logger.js";
 import { monitorDingTalkProvider } from "./monitor.js";
 import { dingtalkOnboardingAdapter } from "./onboarding.js";
 import { PLUGIN_ID } from "./constants.js";
+import { hasFFmpeg, probeMediaBuffer } from "./ffmpeg.js";
 
 // ======================= Target Normalization =======================
 
@@ -102,10 +106,10 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
     enforceOwnerForCommands: true,
   },
   groups: {
-    resolveToolPolicy: ({ cfg, groupId }) => {
+    resolveToolPolicy: ({ cfg, accountId, groupId }) => {
       if (!groupId) return undefined;
-      const dingtalkConfig = (cfg.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
-      const groups = dingtalkConfig.groups;
+      const account = resolveDingTalkAccount({ cfg, accountId });
+      const groups = account.groups;
       if (!groups) return undefined;
       const key = Object.keys(groups).find(
         (k) => k === groupId || k.toLowerCase() === groupId.toLowerCase()
@@ -117,32 +121,23 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
   configSchema: buildChannelConfigSchema(DingTalkConfigSchema),
   config: {
     listAccountIds: (cfg) => listDingTalkAccountIds(cfg),
-    resolveAccount: (cfg, _accountId) => resolveDingTalkAccount({ cfg }),
-    defaultAccountId: (_cfg) => resolveDefaultDingTalkAccountId(_cfg),
-    setAccountEnabled: ({ cfg, enabled }) => {
-      const dingtalkConfig = (cfg.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
-      return {
-        ...cfg,
-        channels: {
-          ...cfg.channels,
-          [PLUGIN_ID]: {
-            ...dingtalkConfig,
-            enabled,
-          },
-        },
-      };
-    },
-    deleteAccount: ({ cfg }) => {
-      const dingtalkConfig = (cfg.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
-      const { clientId, clientSecret, ...rest } = dingtalkConfig;
-      return {
-        ...cfg,
-        channels: {
-          ...cfg.channels,
-          [PLUGIN_ID]: rest,
-        },
-      };
-    },
+    resolveAccount: (cfg, accountId) => resolveDingTalkAccount({ cfg, accountId }),
+    defaultAccountId: (cfg) => resolveDefaultDingTalkAccountId(cfg),
+    setAccountEnabled: ({ cfg, accountId, enabled }) =>
+      setAccountEnabledInConfigSection({
+        cfg,
+        sectionKey: PLUGIN_ID,
+        accountId: accountId ?? DEFAULT_ACCOUNT_ID,
+        enabled,
+        allowTopLevel: true,
+      }),
+    deleteAccount: ({ cfg, accountId }) =>
+      deleteAccountFromConfigSection({
+        cfg,
+        sectionKey: PLUGIN_ID,
+        accountId: accountId ?? DEFAULT_ACCOUNT_ID,
+        clearBaseFields: ["clientId", "clientSecret", "name"],
+      }),
     isConfigured: (account) => Boolean(account.clientId?.trim() && account.clientSecret?.trim()),
     describeAccount: (account) => ({
       accountId: account.accountId,
@@ -151,8 +146,8 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
       configured: Boolean(account.clientId?.trim() && account.clientSecret?.trim()),
       tokenSource: account.tokenSource,
     }),
-    resolveAllowFrom: ({ cfg }) =>
-      resolveDingTalkAccount({ cfg }).allowFrom.map((entry) => String(entry)),
+    resolveAllowFrom: ({ cfg, accountId }) =>
+      resolveDingTalkAccount({ cfg, accountId }).allowFrom.map((entry) => String(entry)),
     formatAllowFrom: ({ allowFrom }) =>
       allowFrom
         .map((entry) => String(entry).trim())
@@ -160,13 +155,16 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
         .map((entry) => entry.replace(new RegExp(`^${PLUGIN_ID}:(?:user:)?`, "i"), "")),
   },
   security: {
-    resolveDmPolicy: ({ cfg }) => {
-      const account = resolveDingTalkAccount({ cfg });
+    resolveDmPolicy: ({ cfg, accountId }) => {
+      const account = resolveDingTalkAccount({ cfg, accountId });
+      const basePath = account.accountId === DEFAULT_ACCOUNT_ID
+        ? `channels.${PLUGIN_ID}`
+        : `channels.${PLUGIN_ID}.accounts.${account.accountId}`;
       return {
         policy: "allowlist",
         allowFrom: account.allowFrom,
-        policyPath: `channels.${PLUGIN_ID}.allowFrom`,
-        allowFromPath: `channels.${PLUGIN_ID}.`,
+        policyPath: `${basePath}.allowFrom`,
+        allowFromPath: `${basePath}.`,
         approveHint: formatPairingApproveHint(PLUGIN_ID),
         normalizeEntry: (raw) => raw.replace(new RegExp(`^${PLUGIN_ID}:(?:user:)?`, "i"), ""),
       };
@@ -198,20 +196,14 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
   },
 
   setup: {
-    resolveAccountId: () => normalizeAccountId(),
-    applyAccountName: ({ cfg, name }) => {
-      const dingtalkConfig = (cfg.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
-      return {
-        ...cfg,
-        channels: {
-          ...cfg.channels,
-          [PLUGIN_ID]: {
-            ...dingtalkConfig,
-            name,
-          },
-        },
-      };
-    },
+    resolveAccountId: ({ accountId }) => normalizeAccountId(accountId),
+    applyAccountName: ({ cfg, accountId, name }) =>
+      applyAccountNameToChannelSection({
+        cfg,
+        channelKey: PLUGIN_ID,
+        accountId: accountId ?? DEFAULT_ACCOUNT_ID,
+        name,
+      }),
     validateInput: ({ input }) => {
       const typedInput = input as {
         clientId?: string;
@@ -225,24 +217,57 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
       }
       return null;
     },
-    applyAccountConfig: ({ cfg, input }) => {
+    applyAccountConfig: ({ cfg, accountId, input }) => {
       const typedInput = input as {
         name?: string;
         clientId?: string;
         clientSecret?: string;
       };
-      const dingtalkConfig = (cfg.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
+      const aid = normalizeAccountId(accountId);
+
+      // 应用账号名称
+      let next = applyAccountNameToChannelSection({
+        cfg,
+        channelKey: PLUGIN_ID,
+        accountId: aid,
+        name: typedInput.name,
+      });
 
+      const dingtalkConfig = (next.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
+
+      // default 账号 → 写顶层（兼容旧版 + 前端面板）
+      if (aid === DEFAULT_ACCOUNT_ID) {
+        return {
+          ...next,
+          channels: {
+            ...next.channels,
+            [PLUGIN_ID]: {
+              ...dingtalkConfig,
+              enabled: true,
+              ...(typedInput.clientId ? { clientId: typedInput.clientId } : {}),
+              ...(typedInput.clientSecret ? { clientSecret: typedInput.clientSecret } : {}),
+            },
+          },
+        };
+      }
+
+      // 非 default 账号 → 写 accounts[accountId]
       return {
-        ...cfg,
+        ...next,
         channels: {
-          ...cfg.channels,
+          ...next.channels,
           [PLUGIN_ID]: {
             ...dingtalkConfig,
             enabled: true,
-            ...(typedInput.name ? { name: typedInput.name } : {}),
-            ...(typedInput.clientId ? { clientId: typedInput.clientId } : {}),
-            ...(typedInput.clientSecret ? { clientSecret: typedInput.clientSecret } : {}),
+            accounts: {
+              ...dingtalkConfig.accounts,
+              [aid]: {
+                ...dingtalkConfig.accounts?.[aid],
+                enabled: true,
+                ...(typedInput.clientId ? { clientId: typedInput.clientId } : {}),
+                ...(typedInput.clientSecret ? { clientSecret: typedInput.clientSecret } : {}),
+              },
+            },
           },
         },
       };
@@ -324,19 +349,19 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
         ),
       };
     },
-    sendText: async ({ to, text, cfg }) => {
-      const account = resolveDingTalkAccount({ cfg });
+    sendText: async ({ to, text, cfg, accountId }) => {
+      const account = resolveDingTalkAccount({ cfg, accountId });
       const result = await sendTextMessage(to, text, { account });
       return { channel: PLUGIN_ID, ...result };
     },
-    sendMedia: async ({ to, text, mediaUrl, cfg }) => {
+    sendMedia: async ({ to, text, mediaUrl, cfg, accountId }) => {
       // 没有媒体 URL，提前返回
       if (!mediaUrl) {
         logger.warn("[sendMedia] 没有 mediaUrl，跳过");
         return { channel: PLUGIN_ID, messageId: "", chatId: to };
       }
 
-      const account = resolveDingTalkAccount({ cfg });
+      const account = resolveDingTalkAccount({ cfg, accountId });
 
       try {
         logger.log(`准备发送媒体: ${mediaUrl}`);
@@ -348,26 +373,91 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
 
         logger.log(`加载媒体成功 | type: ${mediaType} | mimeType: ${mimeType} | size: ${(media.buffer.length / 1024).toFixed(2)} KB`);
 
-        // 上传到钉钉
         const fileName = media.fileName || path.basename(mediaUrl) || `file_${Date.now()}`;
+        const ext = path.extname(fileName).slice(1) || "file";
+
+        // 上传到钉钉
         const uploadResult = await uploadMedia(media.buffer, fileName, account, {
           mimeType,
           type: mediaType,
         });
 
-        // 统一使用文件发送（语音/视频因格式限制和参数要求，也降级为文件）
-        const ext = path.extname(fileName).slice(1) || "file";
         let sendResult: { messageId: string; chatId: string };
 
         if (mediaType === "image") {
           // 图片使用 photoURL
           sendResult = await sendImageMessage(to, uploadResult.url, { account });
+          logger.log("发送图片消息成功");
+        } else if (mediaType === "voice" && hasFFmpeg()) {
+          // 语音：使用 ffprobe 获取时长，发送原生语音消息
+          try {
+            const probe = await probeMediaBuffer(media.buffer, fileName, "voice");
+            sendResult = await sendAudioMessage(to, uploadResult.mediaId, {
+              account,
+              duration: String(probe.duration),
+            });
+            logger.log(`发送语音消息成功 | duration: ${(probe.duration / 1000).toFixed(1)}s`);
+          } catch (probeErr) {
+            logger.warn(`[sendMedia] 语音探测失败，降级为文件发送: ${probeErr}`);
+            sendResult = await sendFileMessage(to, uploadResult.mediaId, fileName, ext, { account });
+            logger.log("发送语音消息成功（降级为文件形式）");
+          }
+        } else if (mediaType === "video" && hasFFmpeg()) {
+          // 视频：使用 ffprobe 获取时长和分辨率，提取封面，发送原生视频消息
+          try {
+            const probe = await probeMediaBuffer(media.buffer, fileName, "video");
+            const videoOpts: {
+              account: typeof account;
+              duration?: string;
+              picMediaId?: string;
+              width?: string;
+              height?: string;
+            } = { account };
+
+            if (probe.duration) {
+              videoOpts.duration = String(Math.floor(probe.duration / 1000));
+            }
+            if (probe.width) {
+              videoOpts.width = String(probe.width);
+            }
+            if (probe.height) {
+              videoOpts.height = String(probe.height);
+            }
+
+            // 上传封面图
+            if (probe.coverBuffer) {
+              try {
+                const coverUpload = await uploadMedia(probe.coverBuffer, "cover.jpg", account, {
+                  mimeType: "image/jpeg",
+                  type: "image",
+                });
+                videoOpts.picMediaId = coverUpload.mediaId;
+                logger.log(`视频封面上传成功 | picMediaId: ${coverUpload.mediaId}`);
+              } catch (coverErr) {
+                logger.warn(`[sendMedia] 视频封面上传失败，将不带封面发送: ${coverErr}`);
+              }
+            }
+
+            sendResult = await sendVideoMessage(to, uploadResult.mediaId, videoOpts);
+            logger.log(`发送视频消息成功 | duration: ${(probe.duration / 1000).toFixed(1)}s | ${probe.width}x${probe.height}`);
+          } catch (probeErr) {
+            logger.warn(`[sendMedia] 视频探测失败，降级为文件发送: ${probeErr}`);
+            sendResult = await sendFileMessage(to, uploadResult.mediaId, fileName, ext, { account });
+            logger.log("发送视频消息成功（降级为文件形式）");
+          }
         } else {
-          // 语音、视频、文件统一使用文件发送
+          // 文件 或 无 ffmpeg 的语音/视频：降级为文件发送
           sendResult = await sendFileMessage(to, uploadResult.mediaId, fileName, ext, { account });
-        }
 
-        logger.log(`发送${mediaType}消息成功（${mediaType !== "image" ? "文件形式" : "图片形式"}）`);
+          if ((mediaType === "voice" || mediaType === "video") && !hasFFmpeg()) {
+            logger.log(`发送${mediaType}消息成功（文件形式，系统未安装 ffmpeg）`);
+            // 附带降级提示文本
+            const hint = `⚠️ 系统未安装 ffmpeg，${mediaType === "voice" ? "语音" : "视频"}已降级为文件发送。如需原生${mediaType === "voice" ? "语音" : "视频"}体验，请安装 ffmpeg。`;
+            await sendTextMessage(to, hint, { account });
+          } else {
+            logger.log("发送文件消息成功");
+          }
+        }
 
         // 如果有文本，再发送文本消息
         if (text?.trim()) {
@@ -469,40 +559,50 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingTalkAccount> = {
         abortSignal: ctx.abortSignal,
       });
     },
-    logoutAccount: async ({ cfg }) => {
+    logoutAccount: async ({ cfg, accountId: rawAccountId }) => {
+      const accountId = normalizeAccountId(rawAccountId);
       const nextCfg = { ...cfg } as OpenClawConfig;
       const dingtalkConfig = (cfg.channels?.[PLUGIN_ID] ?? {}) as DingTalkConfig;
-      const nextDingTalk = { ...dingtalkConfig };
       let cleared = false;
       let changed = false;
 
-      if (
-        nextDingTalk.clientId ||
-        nextDingTalk.clientSecret
-      ) {
-        delete nextDingTalk.clientId;
-        delete nextDingTalk.clientSecret;
-        cleared = true;
-        changed = true;
+      if (accountId === DEFAULT_ACCOUNT_ID) {
+        // default 账号：清顶层凭据
+        const nextDingTalk = { ...dingtalkConfig };
+        if (nextDingTalk.clientId || nextDingTalk.clientSecret) {
+          delete nextDingTalk.clientId;
+          delete nextDingTalk.clientSecret;
+          cleared = true;
+          changed = true;
+        }
+        if (changed) {
+          nextCfg.channels = { ...nextCfg.channels, [PLUGIN_ID]: nextDingTalk };
+        }
+      } else {
+        // 非 default 账号：清 accounts[accountId] 凭据
+        const accounts = { ...(dingtalkConfig.accounts ?? {}) };
+        const target = accounts[accountId];
+        if (target && (target.clientId || target.clientSecret)) {
+          const { clientId: _cid, clientSecret: _cs, ...rest } = target;
+          accounts[accountId] = rest;
+          cleared = true;
+          changed = true;
+        }
+        if (changed) {
+          nextCfg.channels = {
+            ...nextCfg.channels,
+            [PLUGIN_ID]: { ...dingtalkConfig, accounts },
+          };
+        }
       }
 
       if (changed) {
-        if (Object.keys(nextDingTalk).length > 0) {
-          nextCfg.channels = { ...nextCfg.channels, [PLUGIN_ID]: nextDingTalk };
-        } else {
-          const nextChannels = { ...nextCfg.channels };
-          delete (nextChannels as Record<string, unknown>)[PLUGIN_ID];
-          if (Object.keys(nextChannels).length > 0) {
-            nextCfg.channels = nextChannels;
-          } else {
-            delete nextCfg.channels;
-          }
-        }
         await getDingTalkRuntime().config.writeConfigFile(nextCfg);
       }
 
       const resolved = resolveDingTalkAccount({
         cfg: changed ? nextCfg : cfg,
+        accountId,
       });
       const loggedOut = resolved.tokenSource === "none";
 

package/src/client.ts

@@ -1,14 +1,41 @@
-import * as $OpenApi from "@alicloud/openapi-client";
-import * as $Util from "@alicloud/tea-util";
-import dingtalk from "@alicloud/dingtalk";
 import type { ResolvedDingTalkAccount, WebhookResponse, MarkdownReplyBody } from "./types.js";
 import { logger } from "./logger.js";
 
-const { oauth2_1_0, robot_1_0 } = dingtalk;
+// ======================= 钉钉 API 基础封装 =======================
 
-// SDK 客户端类型
-type OAuth2Client = InstanceType<typeof oauth2_1_0.default>;
-type RobotClient = InstanceType<typeof robot_1_0.default>;
+const DINGTALK_API_BASE = "https://api.dingtalk.com";
+
+/**
+ * 钉钉新版 API 统一调用（v1.0 接口）
+ * @param path - API 路径，如 `/v1.0/oauth2/accessToken`
+ * @param body - 请求体
+ * @param accessToken - 可选，需要鉴权的接口传入
+ */
+async function dingtalkApi<T = Record<string, unknown>>(
+  path: string,
+  body: Record<string, unknown>,
+  accessToken?: string
+): Promise<T> {
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+  };
+  if (accessToken) {
+    headers["x-acs-dingtalk-access-token"] = accessToken;
+  }
+
+  const response = await fetch(`${DINGTALK_API_BASE}${path}`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(body),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`钉钉 API 请求失败 [${response.status}]: ${text}`);
+  }
+
+  return (await response.json()) as T;
+}
 
 // ======================= Access Token 缓存 =======================
 
@@ -19,26 +46,6 @@ interface TokenCache {
 
 const tokenCacheMap = new Map<string, TokenCache>();
 
-/**
- * 创建 OAuth2 客户端
- */
-function createOAuth2Client(): OAuth2Client {
-  const config = new $OpenApi.Config({});
-  config.protocol = "https";
-  config.regionId = "central";
-  return new oauth2_1_0.default(config);
-}
-
-/**
- * 创建 Robot 客户端
- */
-function createRobotClient(): RobotClient {
-  const config = new $OpenApi.Config({});
-  config.protocol = "https";
-  config.regionId = "central";
-  return new robot_1_0.default(config);
-}
-
 /**
  * 获取钉钉 access_token
  */
@@ -51,17 +58,17 @@ export async function getAccessToken(account: ResolvedDingTalkAccount): Promise<
     return cached.token;
   }
 
-  const oauth2Client = createOAuth2Client();
-  const request = new oauth2_1_0.GetAccessTokenRequest({
-    appKey: account.clientId,
-    appSecret: account.clientSecret,
-  });
-
-  const response = await oauth2Client.getAccessToken(request);
+  const result = await dingtalkApi<{ accessToken?: string; expireIn?: number }>(
+    "/v1.0/oauth2/accessToken",
+    {
+      appKey: account.clientId,
+      appSecret: account.clientSecret,
+    }
+  );
 
-  if (response.body?.accessToken) {
-    const token = response.body.accessToken;
-    const expireTime = Date.now() + (response.body.expireIn ?? 7200) * 1000;
+  if (result.accessToken) {
+    const token = result.accessToken;
+    const expireTime = Date.now() + (result.expireIn ?? 7200) * 1000;
     tokenCacheMap.set(cacheKey, { token, expireTime });
     return token;
   }
@@ -159,26 +166,19 @@ async function sendOTOMessage(
   options: SendMessageOptions
 ): Promise<SendMessageResult> {
   const accessToken = await getAccessToken(options.account);
-  const robotClient = createRobotClient();
-
-  const headers = new robot_1_0.BatchSendOTOHeaders({
-    xAcsDingtalkAccessToken: accessToken,
-  });
-
-  const request = new robot_1_0.BatchSendOTORequest({
-    robotCode: options.account.clientId,
-    userIds: [userId],
-    msgKey,
-    msgParam: JSON.stringify(msgParam),
-  });
 
-  const response = await robotClient.batchSendOTOWithOptions(
-    request,
-    headers,
-    new $Util.RuntimeOptions({})
+  const result = await dingtalkApi<{ processQueryKey?: string }>(
+    "/v1.0/robot/oToMessages/batchSend",
+    {
+      robotCode: options.account.clientId,
+      userIds: [userId],
+      msgKey,
+      msgParam: JSON.stringify(msgParam),
+    },
+    accessToken
   );
 
-  const processQueryKey = response.body?.processQueryKey ?? `dingtalk-${Date.now()}`;
+  const processQueryKey = result.processQueryKey ?? `dingtalk-${Date.now()}`;
 
   return {
     messageId: processQueryKey,
@@ -196,26 +196,19 @@ async function sendGroupMessage(
   options: SendMessageOptions
 ): Promise<SendMessageResult> {
   const accessToken = await getAccessToken(options.account);
-  const robotClient = createRobotClient();
-
-  const headers = new robot_1_0.OrgGroupSendHeaders({
-    xAcsDingtalkAccessToken: accessToken,
-  });
 
-  const request = new robot_1_0.OrgGroupSendRequest({
-    robotCode: options.account.clientId,
-    openConversationId,
-    msgKey,
-    msgParam: JSON.stringify(msgParam),
-  });
-
-  const response = await robotClient.orgGroupSendWithOptions(
-    request,
-    headers,
-    new $Util.RuntimeOptions({})
+  const result = await dingtalkApi<{ processQueryKey?: string }>(
+    "/v1.0/robot/groupMessages/send",
+    {
+      robotCode: options.account.clientId,
+      openConversationId,
+      msgKey,
+      msgParam: JSON.stringify(msgParam),
+    },
+    accessToken
   );
 
-  const processQueryKey = response.body?.processQueryKey ?? `dingtalk-group-${Date.now()}`;
+  const processQueryKey = result.processQueryKey ?? `dingtalk-group-${Date.now()}`;
 
   return {
     messageId: processQueryKey,
@@ -297,7 +290,7 @@ export async function sendImageMessage(
 /**
  * 发送语音消息（自动路由群聊/单聊）
  * @param mediaId - 语音文件的 mediaId（通过 uploadMedia 获取）
- * @param duration - 语音时长（秒），可选
+ * @param duration - 语音时长（毫秒），可选
  */
 export async function sendAudioMessage(
   to: string,
@@ -321,6 +314,7 @@ export async function sendAudioMessage(
 
 /**
  * 发送视频消息（自动路由群聊/单聊）
+ * @param duration - 视频时长（秒），可选
  */
 export async function sendVideoMessage(
   to: string,
@@ -457,25 +451,18 @@ export async function getFileDownloadUrl(
   account: ResolvedDingTalkAccount
 ): Promise<string> {
   const accessToken = await getAccessToken(account);
-  const robotClient = createRobotClient();
-
-  const headers = new robot_1_0.RobotMessageFileDownloadHeaders({
-    xAcsDingtalkAccessToken: accessToken,
-  });
-
-  const request = new robot_1_0.RobotMessageFileDownloadRequest({
-    downloadCode,
-    robotCode: account.clientId,
-  });
 
-  const response = await robotClient.robotMessageFileDownloadWithOptions(
-    request,
-    headers,
-    new $Util.RuntimeOptions({})
+  const result = await dingtalkApi<{ downloadUrl?: string }>(
+    "/v1.0/robot/messageFiles/download",
+    {
+      downloadCode,
+      robotCode: account.clientId,
+    },
+    accessToken
   );
 
-  if (response.body?.downloadUrl) {
-    return response.body.downloadUrl;
+  if (result.downloadUrl) {
+    return result.downloadUrl;
   }
 
   throw new Error("获取下载链接失败: 返回结果为空");