@huo15/dingtalk-connector-pro 1.0.5 → 1.0.7

package/src/sdk/helpers.js

@@ -0,0 +1,237 @@
+/**
+ * DingTalk Connector SDK Helpers
+ *
+ * 完全独立的辅助函数，不依赖任何外部 SDK。
+ */
+// ============================================================================
+// 账号 ID 处理
+// ============================================================================
+/**
+ * 默认账号 ID
+ */
+export const DEFAULT_ACCOUNT_ID = "__default__";
+/**
+ * 规范化账号 ID
+ *
+ * 注意：账号 ID 保留原始大小写，仅做 trim 处理。
+ * 不做 toLowerCase，因为配置文件中的 accounts key 是大小写敏感的，
+ * 如 "zhizaoDashuIP" 与 "zhizaodashuip" 是不同的账号。
+ * 特殊值 "default"（不区分大小写）和空字符串映射到 DEFAULT_ACCOUNT_ID。
+ */
+export function normalizeAccountId(accountId) {
+    const trimmed = accountId.trim();
+    if (trimmed.toLowerCase() === "default" || trimmed === "") {
+        return DEFAULT_ACCOUNT_ID;
+    }
+    return trimmed;
+}
+// ============================================================================
+// SecretInput 处理
+// ============================================================================
+/**
+ * 判断是否为 SecretInput 引用
+ */
+export function isSecretInputRef(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const ref = value;
+    return (typeof ref.source === "string" &&
+        ["env", "file", "exec"].includes(ref.source) &&
+        typeof ref.provider === "string" &&
+        ref.provider.length > 0 &&
+        typeof ref.id === "string" &&
+        ref.id.length > 0);
+}
+/**
+ * 规范化 SecretInput 字符串
+ * 用于显示和日志，会隐藏敏感信息
+ */
+export function normalizeSecretInputString(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return trimmed || undefined;
+    }
+    if (isSecretInputRef(value)) {
+        const ref = value;
+        return `<${ref.source}:${ref.provider}:${ref.id}>`;
+    }
+    return undefined;
+}
+/**
+ * 解析 SecretInput 为实际值
+ * 用于运行时获取实际的敏感信息
+ */
+export function resolveSecretInputValue(value, options) {
+    // 直接字符串
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return trimmed || undefined;
+    }
+    // SecretInput 引用
+    if (isSecretInputRef(value)) {
+        const ref = value;
+        // 环境变量
+        if (ref.source === "env" && options?.allowEnvRead) {
+            const envValue = process.env[ref.id];
+            if (typeof envValue === "string") {
+                return envValue.trim() || undefined;
+            }
+        }
+        // 文件或执行 - 返回引用字符串
+        return `<${ref.source}:${ref.provider}:${ref.id}>`;
+    }
+    return undefined;
+}
+/**
+ * 检查 SecretInput 是否已配置
+ */
+export function hasConfiguredSecretInput(value) {
+    if (typeof value === "string") {
+        return value.trim().length > 0;
+    }
+    if (isSecretInputRef(value)) {
+        const ref = value;
+        if (ref.source === "env") {
+            return typeof process.env[ref.id] === "string" && process.env[ref.id].trim().length > 0;
+        }
+        // file 和 exec 总是认为已配置（运行时会验证）
+        return true;
+    }
+    return false;
+}
+/**
+ * 规范化已解析的 SecretInput 字符串
+ * 用于配置验证和错误提示
+ */
+export function normalizeResolvedSecretInputString(params) {
+    const { value, path } = params;
+    // 直接字符串
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed) {
+            return trimmed;
+        }
+        throw new Error(`${path} must be a non-empty string`);
+    }
+    // SecretInput 引用
+    if (isSecretInputRef(value)) {
+        const ref = value;
+        // 验证引用格式
+        if (!["env", "file", "exec"].includes(ref.source)) {
+            throw new Error(`${path}.source must be one of: env, file, exec`);
+        }
+        if (typeof ref.provider !== "string" || !ref.provider.trim()) {
+            throw new Error(`${path}.provider must be a non-empty string`);
+        }
+        if (typeof ref.id !== "string" || !ref.id.trim()) {
+            throw new Error(`${path}.id must be a non-empty string`);
+        }
+        // 环境变量特殊处理
+        if (ref.source === "env") {
+            const envValue = process.env[ref.id];
+            if (!envValue || !envValue.trim()) {
+                throw new Error(`${path}: environment variable ${ref.id} is not set`);
+            }
+            return envValue.trim();
+        }
+        // file 和 exec 返回引用字符串
+        return `<${ref.source}:${ref.provider}:${ref.id}>`;
+    }
+    throw new Error(`${path} must be a string or SecretInput object`);
+}
+// ============================================================================
+// 群组策略处理
+// ============================================================================
+/**
+ * 解析默认群组策略
+ */
+export function resolveDefaultGroupPolicy(cfg) {
+    const dingtalkCfg = cfg.channels?.["dingtalk-connector"];
+    return dingtalkCfg?.groupPolicy ?? "open";
+}
+/**
+ * 解析允许列表提供者运行时群组策略
+ */
+export function resolveAllowlistProviderRuntimeGroupPolicy(params) {
+    const { providerConfigPresent, groupPolicy, defaultGroupPolicy } = params;
+    if (groupPolicy) {
+        return { groupPolicy };
+    }
+    if (providerConfigPresent) {
+        return { groupPolicy: defaultGroupPolicy };
+    }
+    return { groupPolicy: "disabled" };
+}
+// ============================================================================
+// 通道状态处理
+// ============================================================================
+/**
+ * 创建默认通道运行时状态
+ */
+export function createDefaultChannelRuntimeState(accountId, extras) {
+    return {
+        running: false,
+        lastStartAt: null,
+        lastStopAt: null,
+        lastError: null,
+        port: null,
+        accountId,
+        ...extras,
+    };
+}
+/**
+ * 构建基础通道状态摘要
+ */
+export function buildBaseChannelStatusSummary(snapshot) {
+    return {
+        accountId: snapshot.accountId,
+        enabled: snapshot.enabled,
+        configured: snapshot.configured,
+        name: snapshot.name,
+        running: snapshot.running ?? false,
+        lastStartAt: snapshot.lastStartAt ?? null,
+        lastStopAt: snapshot.lastStopAt ?? null,
+        lastError: snapshot.lastError ?? null,
+    };
+}
+// ============================================================================
+// 其他辅助函数
+// ============================================================================
+/**
+ * 添加通配符到 allowFrom
+ */
+export function addWildcardAllowFrom(existing) {
+    if (!existing || existing.length === 0) {
+        return ["*"];
+    }
+    if (existing.includes("*")) {
+        return existing;
+    }
+    return [...existing, "*"];
+}
+/**
+ * 格式化文档链接
+ */
+export function formatDocsLink(path, label) {
+    return `https://docs.openclaw.ai${path}`;
+}
+/**
+ * 规范化字符串
+ */
+export function normalizeString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+/**
+ * 解析 allowFrom 输入
+ */
+export function parseAllowFromInput(raw) {
+    return raw
+        .split(/[\n,;]+/g)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}

package/src/sdk/helpers.ts

@@ -4,7 +4,7 @@
  * 完全独立的辅助函数，不依赖任何外部 SDK。
  */
 
-import type { SecretInput, SecretInputRef } from "./types.ts";
+import type { SecretInput, SecretInputRef } from "./types.js";
 
 // ============================================================================
 // 账号 ID 处理

package/src/sdk/types.js

@@ -0,0 +1,13 @@
+/**
+ * DingTalk Connector SDK Types
+ *
+ * 完全独立的类型定义，不依赖任何外部 SDK。
+ * 这是钉钉连接器插件的核心类型系统。
+ */
+// ============================================================================
+// 常量
+// ============================================================================
+/**
+ * 默认账号 ID
+ */
+export const DEFAULT_ACCOUNT_ID = "default";

package/src/secret-input.js

@@ -0,0 +1,13 @@
+import { hasConfiguredSecretInput, normalizeResolvedSecretInputString, normalizeSecretInputString, } from "./sdk/helpers.js";
+import { z } from "zod";
+export { hasConfiguredSecretInput, normalizeResolvedSecretInputString, normalizeSecretInputString };
+export function buildSecretInputSchema() {
+    return z.union([
+        z.string(),
+        z.object({
+            source: z.enum(["env", "file", "exec"]),
+            provider: z.string().min(1),
+            id: z.string().min(1),
+        }),
+    ]);
+}

package/src/secret-input.ts

@@ -2,7 +2,7 @@ import {
   hasConfiguredSecretInput,
   normalizeResolvedSecretInputString,
   normalizeSecretInputString,
-} from "./sdk/helpers.ts";
+} from "./sdk/helpers.js";
 import { z } from "zod";
 
 export { hasConfiguredSecretInput, normalizeResolvedSecretInputString, normalizeSecretInputString };

package/src/services/media/audio.js

@@ -0,0 +1,40 @@
+/**
+ * 音频处理模块
+ * 支持音频消息发送
+ */
+import { AUDIO_MARKER_PATTERN, toLocalPath, uploadMediaToDingTalk } from './common.js';
+import * as fs from 'fs';
+/**
+ * 提取音频标记并发送音频消息
+ */
+export async function processAudioMarkers(content, sessionWebhook, config, oapiToken, log, useProactiveApi = false, target) {
+    const logPrefix = useProactiveApi ? '[DingTalk][Audio][Proactive]' : '[DingTalk][Audio]';
+    if (!oapiToken) {
+        log?.warn?.(`${logPrefix} 无 oapiToken，跳过音频处理`);
+        return content;
+    }
+    const matches = [...content.matchAll(AUDIO_MARKER_PATTERN)];
+    if (matches.length === 0)
+        return content;
+    log?.info?.(`${logPrefix} 检测到 ${matches.length} 个音频，开始上传...`);
+    let result = content;
+    for (const match of matches) {
+        const full = match[0];
+        try {
+            const audioData = JSON.parse(match[1]);
+            const absPath = toLocalPath(audioData.path);
+            if (!fs.existsSync(absPath)) {
+                log?.warn?.(`${logPrefix} 音频文件不存在：${absPath}`);
+                result = result.replace(full, '⚠️ 音频文件不存在');
+                continue;
+            }
+            const uploadResult = await uploadMediaToDingTalk(absPath, 'voice', oapiToken, 20 * 1024 * 1024, log);
+            result = result.replace(full, uploadResult ? `[音频已上传：${uploadResult}]` : '⚠️ 音频上传失败');
+        }
+        catch {
+            log?.warn?.(`${logPrefix} 解析音频标记失败：${match[1]}`);
+            result = result.replace(full, '');
+        }
+    }
+    return result.trim();
+}

package/src/services/media/audio.ts

@@ -3,8 +3,8 @@
  * 支持音频消息发送
  */
 
-import type { DingtalkConfig } from '../../types/index.ts';
-import { AUDIO_MARKER_PATTERN, toLocalPath, uploadMediaToDingTalk } from './common.ts';
+import type { DingtalkConfig } from '../../types/index.js';
+import { AUDIO_MARKER_PATTERN, toLocalPath, uploadMediaToDingTalk } from './common.js';
 import * as fs from 'fs';
 
 /**

package/src/services/media/chunk-upload.js

@@ -0,0 +1,211 @@
+/**
+ * 钉钉文件分块上传模块
+ * 支持大文件（>20MB）的分块上传
+ *
+ * API 文档：
+ * - 开启事务：https://open.dingtalk.com/document/development/enable-upload-transaction
+ * - 上传块：https://open.dingtalk.com/document/development/upload-file-blocks
+ * - 提交事务：https://open.dingtalk.com/document/development/submit-a-file-upload-transaction
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { createLogger } from '../../utils/logger.js';
+import { dingtalkOapiHttp } from '../../utils/http-client.js';
+// form-data 是 CJS 模块，静态 import 可确保 jiti/ESM 环境下 CJS 互操作行为稳定，
+// 避免动态 import 时 .default 偶发为 undefined 导致 "Cannot read properties of undefined (reading 'registry')"
+import FormData from 'form-data';
+const DINGTALK_OAPI = 'https://oapi.dingtalk.com';
+/** 分块上传配置 */
+export const CHUNK_CONFIG = {
+    MIN_CHUNK_SIZE: 100 * 1024, // 最小分块 100KB
+    MAX_CHUNK_SIZE: 8 * 1024 * 1024, // 最大分块 8MB
+    DEFAULT_CHUNK_SIZE: 5 * 1024 * 1024, // 默认分块 5MB
+    SIZE_THRESHOLD: 20 * 1024 * 1024, // 超过 20MB 使用分块上传
+};
+/**
+ * 步骤一：开启分块上传事务
+ * @param oapiToken 钉钉 access_token
+ * @param fileName 文件名
+ * @param fileSize 文件大小（字节）
+ * @param log 日志对象
+ */
+export async function enableUploadTransaction(oapiToken, fileName, fileSize, debug = false) {
+    const log = createLogger(debug, 'DingTalk][ChunkUpload');
+    try {
+        log.info(`开启上传事务：${fileName}, 大小：${(fileSize / 1024 / 1024).toFixed(2)}MB`);
+        const form = new FormData();
+        form.append('file_name', fileName);
+        form.append('file_size', fileSize.toString());
+        const resp = await dingtalkOapiHttp.post(`${DINGTALK_OAPI}/file/upload/transaction/enable`, form, {
+            params: { access_token: oapiToken },
+            headers: form.getHeaders(),
+            timeout: 60_000,
+        });
+        if (resp.data.errcode === 0) {
+            log.info(`事务开启成功，upload_id: ${resp.data.upload_id}`);
+            return resp.data.upload_id;
+        }
+        else {
+            log.error(`开启事务失败：${resp.data.errmsg}`);
+            return null;
+        }
+    }
+    catch (err) {
+        log.error(`开启事务异常：${err.message}`);
+        console.error(`开启事务异常详情:`, err.response?.data || err);
+        return null;
+    }
+}
+/**
+ * 步骤二：上传文件块
+ * @param oapiToken 钉钉 access_token
+ * @param uploadId 上传事务 ID
+ * @param chunkData 文件块数据
+ * @param chunkNumber 块编号（从 1 开始）
+ * @param totalChunks 总块数
+ * @param log 日志对象
+ */
+export async function uploadFileBlock(oapiToken, uploadId, chunkData, chunkNumber, totalChunks, debug = false) {
+    const log = createLogger(debug, 'DingTalk][ChunkUpload');
+    try {
+        log.info(`上传块 ${chunkNumber}/${totalChunks}, 大小：${(chunkData.length / 1024).toFixed(2)}KB`);
+        const form = new FormData();
+        form.append('upload_id', uploadId);
+        form.append('chunk_number', chunkNumber.toString());
+        form.append('total_chunks', totalChunks.toString());
+        form.append('file', chunkData, {
+            filename: `chunk_${chunkNumber}`,
+            contentType: 'application/octet-stream',
+        });
+        const resp = await dingtalkOapiHttp.post(`${DINGTALK_OAPI}/file/upload/chunk`, form, {
+            params: { access_token: oapiToken },
+            headers: form.getHeaders(),
+            timeout: 60_000,
+        });
+        if (resp.data.errcode === 0) {
+            log.info(`块 ${chunkNumber} 上传成功`);
+            return true;
+        }
+        else {
+            log.error(`块 ${chunkNumber} 上传失败：${resp.data.errmsg}`);
+            return false;
+        }
+    }
+    catch (err) {
+        log.error(`块 ${chunkNumber} 上传异常：${err.message}`);
+        return false;
+    }
+}
+/**
+ * 步骤三：提交分块上传事务
+ * @param oapiToken 钉钉 access_token
+ * @param uploadId 上传事务 ID
+ * @param fileName 文件名
+ * @param log 日志对象
+ */
+export async function submitUploadTransaction(oapiToken, uploadId, fileName, debug = false) {
+    const log = createLogger(debug, 'DingTalk][ChunkUpload');
+    try {
+        log.info(`提交上传事务：${uploadId}`);
+        const resp = await dingtalkOapiHttp.get(`${DINGTALK_OAPI}/file/upload/transaction/submit`, {
+            params: {
+                access_token: oapiToken,
+                upload_id: uploadId,
+                file_name: fileName,
+            },
+            timeout: 60_000,
+        });
+        if (resp.data.errcode === 0) {
+            log.info(`事务提交成功，file_id: ${resp.data.file_id}, download_code: ${resp.data.download_code}`);
+            return {
+                fileId: resp.data.file_id,
+                downloadCode: resp.data.download_code,
+            };
+        }
+        else {
+            log.error(`事务提交失败：${resp.data.errmsg}`);
+            return null;
+        }
+    }
+    catch (err) {
+        log.error(`事务提交异常：${err.message}`);
+        return null;
+    }
+}
+/**
+ * 计算分块参数
+ */
+function calculateChunkParams(fileSize) {
+    // 根据文件大小动态调整分块大小
+    let chunkSize = CHUNK_CONFIG.DEFAULT_CHUNK_SIZE;
+    if (fileSize > 100 * 1024 * 1024) {
+        // >100MB，使用最大分块 8MB
+        chunkSize = CHUNK_CONFIG.MAX_CHUNK_SIZE;
+    }
+    else if (fileSize > 50 * 1024 * 1024) {
+        // >50MB，使用 6MB 分块
+        chunkSize = 6 * 1024 * 1024;
+    }
+    const totalChunks = Math.ceil(fileSize / chunkSize);
+    return { chunkSize, totalChunks };
+}
+/**
+ * 分块上传大文件（>20MB）
+ * @param filePath 文件路径
+ * @param mediaType 媒体类型：video, file
+ * @param oapiToken 钉钉 access_token
+ * @param log 日志对象
+ * @returns download_code 或 null
+ */
+export async function uploadLargeFileByChunks(filePath, mediaType, oapiToken, debug = false) {
+    const log = createLogger(debug, 'DingTalk][ChunkUpload');
+    try {
+        const absPath = path.resolve(filePath);
+        if (!fs.existsSync(absPath)) {
+            log.warn(`文件不存在：${absPath}`);
+            return null;
+        }
+        const stats = fs.statSync(absPath);
+        const fileSize = stats.size;
+        const fileName = path.basename(absPath);
+        const fileSizeMB = (fileSize / 1024 / 1024).toFixed(2);
+        log.info(`开始分块上传：${fileName}, 大小：${fileSizeMB}MB, 类型：${mediaType}`);
+        // 步骤一：开启上传事务
+        const uploadId = await enableUploadTransaction(oapiToken, fileName, fileSize, debug);
+        if (!uploadId) {
+            log.error(`开启事务失败，终止上传`);
+            return null;
+        }
+        // 计算分块参数
+        const { chunkSize, totalChunks } = calculateChunkParams(fileSize);
+        log.info(`分块参数：chunkSize=${(chunkSize / 1024 / 1024).toFixed(2)}MB, totalChunks=${totalChunks}`);
+        // 步骤二：分块上传
+        const fileBuffer = fs.readFileSync(absPath);
+        let successCount = 0;
+        for (let i = 0; i < totalChunks; i++) {
+            const start = i * chunkSize;
+            const end = Math.min(start + chunkSize, fileSize);
+            const chunkData = fileBuffer.slice(start, end);
+            const success = await uploadFileBlock(oapiToken, uploadId, chunkData, i + 1, // chunkNumber 从 1 开始
+            totalChunks, debug);
+            if (!success) {
+                log.error(`块 ${i + 1} 上传失败，终止上传`);
+                return null;
+            }
+            successCount++;
+            log.info(`进度：${successCount}/${totalChunks} (${((successCount / totalChunks) * 100).toFixed(1)}%)`);
+        }
+        // 步骤三：提交上传事务
+        const result = await submitUploadTransaction(oapiToken, uploadId, fileName, debug);
+        if (!result || !result.downloadCode) {
+            log.error(`提交事务失败`);
+            return null;
+        }
+        log.info(`分块上传完成：${fileName}, download_code: ${result.downloadCode}`);
+        return result.downloadCode;
+    }
+    catch (err) {
+        log.error(`分块上传异常：${err.message}`);
+        return null;
+    }
+}

package/src/services/media/chunk-upload.ts

@@ -10,8 +10,8 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
-import { createLogger } from '../../utils/logger.ts';
-import { dingtalkOapiHttp, dingtalkUploadHttp } from '../../utils/http-client.ts';
+import { createLogger } from '../../utils/logger.js';
+import { dingtalkOapiHttp, dingtalkUploadHttp } from '../../utils/http-client.js';
 // form-data 是 CJS 模块，静态 import 可确保 jiti/ESM 环境下 CJS 互操作行为稳定，
 // 避免动态 import 时 .default 偶发为 undefined 导致 "Cannot read properties of undefined (reading 'registry')"
 import FormData from 'form-data';

package/src/services/media/common.js

@@ -0,0 +1,120 @@
+/**
+ * 媒体处理公共工具和常量
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// form-data 是 CJS 模块，静态 import 可确保 jiti/ESM 环境下 CJS 互操作行为稳定，
+// 避免动态 import 时 .default 偶发为 undefined 导致 "Cannot read properties of undefined (reading 'registry')"
+import FormData from 'form-data';
+import { createLogger } from '../../utils/logger.js';
+import { CHUNK_CONFIG } from './chunk-upload.js';
+import { dingtalkUploadHttp } from '../../utils/http-client.js';
+// ============ 常量 ============
+/** 文本文件扩展名 */
+export const TEXT_FILE_EXTENSIONS = new Set([
+    '.txt', '.md', '.json', '.yaml', '.yml', '.xml', '.html', '.css',
+    '.js', '.ts', '.py', '.java', '.c', '.cpp', '.h', '.sh', '.bat', '.csv',
+]);
+/** 图片文件扩展名 */
+export const IMAGE_EXTENSIONS = /\.(png|jpg|jpeg|gif|bmp|webp|tiff|svg)$/i;
+/** 本地图片路径正则表达式（跨平台） */
+export const LOCAL_IMAGE_RE = /!\[([^\]]*)\]\(((?:file:\/\/|MEDIA:|attachment:\/\/)[^)]+|\/(?:tmp|var|private|Users|home|root)[^)]+|[A-Za-z]:[\\/][^)]+)\)/g;
+/** 纯文本图片路径正则表达式 */
+export const BARE_IMAGE_PATH_RE = /`?((?:\/(?:tmp|var|private|Users|home|root)\/[^\s`'",)]+|[A-Za-z]:[\\/][^\s`'",)]+)\.(?:png|jpg|jpeg|gif|bmp|webp))`?/gi;
+/** 视频标记正则表达式 */
+export const VIDEO_MARKER_PATTERN = /\[DINGTALK_VIDEO\](.*?)\[\/DINGTALK_VIDEO\]/gs;
+/** 音频标记正则表达式 */
+export const AUDIO_MARKER_PATTERN = /\[DINGTALK_AUDIO\](.*?)\[\/DINGTALK_AUDIO\]/gs;
+/** 文件标记正则表达式 */
+export const FILE_MARKER_PATTERN = /\[DINGTALK_FILE\](.*?)\[\/DINGTALK_FILE\]/gs;
+// ============ 工具函数 ============
+/**
+ * 去掉 file:// / MEDIA: / attachment:// 前缀，得到实际的绝对路径
+ */
+export function toLocalPath(raw) {
+    let filePath = raw;
+    if (filePath.startsWith('file://'))
+        filePath = filePath.replace('file://', '');
+    else if (filePath.startsWith('MEDIA:'))
+        filePath = filePath.replace('MEDIA:', '');
+    else if (filePath.startsWith('attachment://'))
+        filePath = filePath.replace('attachment://', '');
+    try {
+        filePath = decodeURIComponent(filePath);
+    }
+    catch {
+        // 解码失败则保持原样
+    }
+    return filePath;
+}
+/**
+ * 谨慎使用，返回的是cleanMediaId
+ * 后续逐步删除，可用 media.ts
+ */
+export async function uploadMediaToDingTalk(filePath, mediaType, oapiToken, maxSize = 20 * 1024 * 1024, logOrDebug, debug) {
+    const debugEnabled = typeof logOrDebug === 'boolean' ? logOrDebug === true : debug === true;
+    const externalLog = typeof logOrDebug === 'boolean' ? undefined : logOrDebug;
+    const log = externalLog ?? createLogger(debugEnabled, `DingTalk][${mediaType}`);
+    log?.info?.(`[uploadMediaToDingTalk] 开始上传，filePath: ${filePath}, mediaType: ${mediaType}, debug: ${debugEnabled}`);
+    try {
+        const absPath = toLocalPath(filePath);
+        log?.info?.(`检查文件是否存在：${absPath}`);
+        if (!fs.existsSync(absPath)) {
+            log?.warn?.(`文件不存在：${absPath}`);
+            return null;
+        }
+        const stats = fs.statSync(absPath);
+        const fileSizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+        const fileSize = stats.size;
+        // ✅ 对于视频和文件类型，如果超过 20MB，使用分块上传
+        if ((mediaType === 'video' || mediaType === 'file') && fileSize > CHUNK_CONFIG.SIZE_THRESHOLD) {
+            log?.info?.(`文件超过 20MB，使用分块上传：${absPath} (${fileSizeMB}MB)`);
+            try {
+                const { uploadLargeFileByChunks } = await import('./chunk-upload');
+                const downloadCode = await uploadLargeFileByChunks(absPath, mediaType, oapiToken, debugEnabled);
+                if (downloadCode) {
+                    log?.info?.(`分块上传成功：${absPath}, download_code: ${downloadCode}`);
+                    return downloadCode;
+                }
+                log?.error?.(`分块上传失败：${absPath}`);
+            }
+            catch (chunkErr) {
+                log?.error?.(`分块上传异常：${chunkErr.message}`);
+            }
+            return null;
+        }
+        // 检查文件大小（对于小于 20MB 的文件）
+        if (stats.size > maxSize) {
+            const maxSizeMB = (maxSize / (1024 * 1024)).toFixed(0);
+            log?.warn?.(`文件过大：${absPath}, 大小：${fileSizeMB}MB, 超过限制 ${maxSizeMB}MB`);
+            return null;
+        }
+        const form = new FormData();
+        form.append('media', fs.createReadStream(absPath), {
+            filename: path.basename(absPath),
+            contentType: mediaType === 'image' ? 'image/jpeg' : 'application/octet-stream',
+        });
+        const uploadType = mediaType;
+        log?.info?.(`上传文件：${absPath} (${fileSizeMB}MB), uploadType=${uploadType}`);
+        const resp = await dingtalkUploadHttp.post(`${DINGTALK_OAPI}/media/upload`, form, {
+            params: { access_token: oapiToken, type: mediaType },
+            headers: form.getHeaders(),
+            timeout: 60_000,
+            maxBodyLength: Infinity,
+        });
+        const mediaId = resp.data?.media_id;
+        if (mediaId) {
+            const cleanMediaId = mediaId.startsWith('@') ? mediaId.substring(1) : mediaId;
+            log?.info?.(`上传成功：mediaId=${cleanMediaId}`);
+            return cleanMediaId;
+        }
+        log?.warn?.(`上传返回无 media_id`);
+        return null;
+    }
+    catch (err) {
+        log?.error?.(`上传失败：${err.message}`);
+        return null;
+    }
+}
+/** 钉钉 OAPI 常量 */
+export const DINGTALK_OAPI = 'https://oapi.dingtalk.com';