evolclaw 2.0.4 → 2.0.6

package/README.md

@@ -6,18 +6,18 @@ EvolClaw 是一个轻量级 AI Agent 网关，基于 Claude Agent SDK 构建。
 
 ## 核心特性
 
-- **多端会话接力**：跨终端共享会话、环境、项目，无缝切换开发体验
-- **配置自动继承**：复用 CLI 环境的 API Key/URL、记忆文件、MCP/Skills 插件，零额外配置
-- **轻量化设计**：进程模式运行，CLI 命令行管理，无端口开放，无容器依赖，无 UI 界面
-- **多项目支持**：每个项目独立会话，支持动态切换
-- **双模式会话**：私聊会话隔离互不干扰，群聊会话共享协同协作
-- **多渠道接入**：Channel Adapter 模式，飞书 + 微信扫码一键接入
-- **分层权限**：用户级/管理员级命令分离，多用户安全隔离
-- **统一消息处理**：消息处理与渠道解耦，新增渠道仅需 ~15 行代码
-- **会话持久化**：会话数据与 CLI 工具共享，不额外存储，服务重启不丢失
-- **执行中插入**：任务执行中可发送新消息，自动中断当前任务并处理新请求
-- **消息智能发送**：前台任务动态聚合批量发送，后台任务静默完成后通知
-- **健壮性保障**：任务超时提醒、会话异常安全模式修复、重启失败自动自愈
+- 🔄 **多端会话接力**：跨终端共享会话、环境、项目，无缝切换开发体验
+- ♻️ **配置自动继承**：复用 CLI 环境的 API Key/URL、记忆文件、MCP/Skills 插件，零额外配置
+- 🚀 **轻量化设计**：进程模式运行，CLI 命令行管理，无端口开放，无容器依赖，无 UI 界面
+- 📁 **多项目支持**：每个项目独立会话，支持动态切换
+- 👥 **双模式会话**：多用户私聊会话隔离，群聊会话共享，满足不同协作场景
+- 🌐 **多渠道接入**：Channel Adapter 模式，飞书 + 微信扫码一键接入
+- 🔐 **分层权限**：用户级/管理员级命令分离，多用户安全隔离
+- 📊 **统一消息处理**：消息处理与渠道解耦，新增渠道仅需 ~15 行代码
+- 💾 **会话持久化**：会话数据与 CLI 工具共享，不额外存储，服务重启不丢失
+- ⚡ **执行中插入**：任务执行中可发送新消息，自动中断当前任务并处理新请求
+- 🔕 **消息智能发送**：前台任务动态聚合批量发送，后台任务静默完成后通知
+- 🤖 **健壮性保障**：任务超时提醒、会话异常安全模式修复、重启失败自动自愈
 
 ## 适合场景
 
@@ -71,7 +71,7 @@ MessageProcessor.processMessage()
 
 ### 环境要求
 
-- **操作系统**：macOS / Linux（Windows 暂不支持，见 TODO）
+- **操作系统**：macOS / Linux / Windows
 - **Node.js** >= 22（需要 node:sqlite 内置模块支持）
 - **Claude Code** >= 2.1.32（`npm install -g @anthropic-ai/claude-code`）
 
@@ -83,6 +83,8 @@ MessageProcessor.processMessage()
 npm install -g evolclaw
 ```
 
+> **Windows 用户**：首次运行前可能需要执行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
+
 **从源码安装**：
 
 ```bash
@@ -111,7 +113,7 @@ evolclaw init wechat
 - 渠道选择（飞书/微信）并扫码登录
 - 默认项目路径
 - 模型选择（sonnet/opus/haiku）
-- 自动写入 `EVOLCLAW_HOME` 到 shell profile
+- 自动写入 `EVOLCLAW_HOME` 到 shell profile（Unix）或用户环境变量（Windows）
 
 配置文件生成在 `{EVOLCLAW_HOME}/data/evolclaw.json`（默认 `~/.evolclaw/data/evolclaw.json`）。
 
@@ -159,8 +161,6 @@ npm test
 
 ```
 evolclaw/
-├── bin/
-│   └── evolclaw                    # CLI 入口（npm link）
 ├── src/
 │   ├── core/
 │   │   ├── command-handler.ts       # 斜杠命令处理
@@ -225,8 +225,8 @@ evolclaw/
 
 ## TODO
 
-- [ ] Windows 系统 CLI 命令支持
-- [ ] 微信插件支持图片/文件的收发
+- [x] Windows 系统 CLI 命令支持
+- [x] 微信插件支持图片/文件的收发
 - [ ] 自动授权可配置（自动放行/自动拒绝）
 - [ ] 手动授权支持（飞书卡片/文本回复）
 - [ ] ACP 协议支持（接入 Codex / Gemini CLI）

package/dist/channels/feishu.js

@@ -46,6 +46,10 @@ export class FeishuChannel {
                     const msg = data.message;
                     logger.debug('[Feishu] Received message, message_id:', msg.message_id, 'type:', msg.message_type);
                     logger.debug('[Feishu] Full data object:', JSON.stringify(data, null, 2));
+                    // 诊断：话题消息检测
+                    if (msg.thread_id) {
+                        logger.info('[Feishu] Thread message detected, thread_id:', msg.thread_id, 'parent_id:', msg.parent_id, 'root_id:', msg.root_id);
+                    }
                     if (!msg.message_id || this.isDuplicate(msg.message_id)) {
                         logger.debug('[Feishu] Duplicate message ignored:', msg.message_id);
                         return;
@@ -54,6 +58,12 @@ export class FeishuChannel {
                     this.addAckReaction(msg.message_id);
                     if (!this.messageHandler)
                         return;
+                    // 提取 @ 提及列表（排除机器人自身）
+                    const mentions = (msg.mentions || []).map((m) => ({
+                        userId: m.id?.open_id || '',
+                        name: m.name,
+                        key: m.key
+                    })).filter((m) => m.userId && m.userId !== this.config.appId);
                     // 提取发送者信息
                     const userId = data.sender?.sender_id?.open_id;
                     let userName;
@@ -113,7 +123,19 @@ export class FeishuChannel {
                                     }
                                 }
                                 else if (quotedMsgType === 'file') {
-                                    quotedText = `> [文件消息]\n\n`;
+                                    const parsedFile = JSON.parse(quotedContent);
+                                    const quotedFileKey = parsedFile.file_key;
+                                    const quotedFileName = parsedFile.file_name || 'unknown';
+                                    const projectPath = this.projectPathProvider
+                                        ? await this.projectPathProvider(msg.chat_id)
+                                        : process.cwd();
+                                    const quotedFilePath = await this.downloadFile(quotedFileKey, quotedFileName, msg.parent_id, projectPath);
+                                    if (quotedFilePath) {
+                                        quotedText = `> [引用的文件：${quotedFileName}]\n> 文件已保存到：${quotedFilePath}\n\n`;
+                                    }
+                                    else {
+                                        quotedText = `> [文件消息]\n\n`;
+                                    }
                                 }
                                 else {
                                     quotedText = `> [${quotedMsgType}消息]\n\n`;
@@ -127,11 +149,9 @@ export class FeishuChannel {
                         if (msg.message_type === 'text') {
                             const parsed = JSON.parse(msg.content);
                             // 优先使用 text_without_at_bot（去除机器人 @），否则使用 text
-                            let content = parsed.text_without_at_bot || parsed.text;
-                            // 去除消息中所有的 @ 提及（支持命令在前或在后）
-                            content = content.replace(/@[^\s]+\s*/g, '').trim();
+                            const content = parsed.text_without_at_bot || parsed.text;
                             const finalContent = quotedText + content;
-                            await this.messageHandler(msg.chat_id, finalContent, quotedImages.length > 0 ? quotedImages : undefined, userId, userName, msg.message_id);
+                            await this.messageHandler(msg.chat_id, finalContent, quotedImages.length > 0 ? quotedImages : undefined, userId, userName, msg.message_id, mentions.length > 0 ? mentions : undefined);
                         }
                         // 处理图片消息
                         else if (msg.message_type === 'image') {
@@ -148,7 +168,7 @@ export class FeishuChannel {
                                 await this.messageHandler(msg.chat_id, prompt, allImages, userId, userName, msg.message_id);
                             }
                             else {
-                                const prompt = quotedText + '[图片下载失败] 应用可能缺少 im:resource 权限';
+                                const prompt = quotedText + '[图片下载失败] 应用可能缺少 im:message 或 im:message:readonly 权限';
                                 await this.messageHandler(msg.chat_id, prompt, quotedImages.length > 0 ? quotedImages : undefined, userId, userName, msg.message_id);
                             }
                         }
@@ -171,6 +191,27 @@ export class FeishuChannel {
                                 await this.messageHandler(msg.chat_id, prompt, quotedImages.length > 0 ? quotedImages : undefined, userId, userName, msg.message_id);
                             }
                         }
+                        // 处理富文本消息
+                        else if (msg.message_type === 'post') {
+                            const parsed = JSON.parse(msg.content);
+                            let text = '';
+                            const title = parsed.zh_cn?.title || parsed.en_us?.title || parsed.title;
+                            const content = parsed.zh_cn?.content || parsed.en_us?.content || parsed.content;
+                            if (content) {
+                                for (const line of content) {
+                                    for (const elem of line) {
+                                        if (elem.text)
+                                            text += elem.text;
+                                    }
+                                    text += '\n';
+                                }
+                            }
+                            let finalContent = text.trim();
+                            if (title)
+                                finalContent = `${title}\n${finalContent}`;
+                            finalContent = quotedText + finalContent;
+                            await this.messageHandler(msg.chat_id, finalContent, quotedImages.length > 0 ? quotedImages : undefined, userId, userName, msg.message_id);
+                        }
                         // 处理其他类型消息
                         else {
                             logger.debug('[Feishu] Unsupported message type:', msg.message_type);
@@ -250,10 +291,27 @@ export class FeishuChannel {
         logger.debug(`[Feishu] sendMessage called, chatId: ${chatId}, content length: ${content.length}`);
         try {
             const useMarkdown = !options?.forceText && hasMarkdownSyntax(content);
-            const msgType = useMarkdown ? 'post' : 'text';
-            const msgContent = useMarkdown
-                ? JSON.stringify(markdownToFeishuPost(content, options?.title))
-                : JSON.stringify({ text: content });
+            const hasMention = !!(options?.mentionUserIds && options.mentionUserIds.length > 0);
+            // 如果需要 @，强制使用 post 格式
+            const msgType = (useMarkdown || hasMention) ? 'post' : 'text';
+            let msgContent;
+            if (hasMention) {
+                // 构造带 @ 的富文本消息
+                const postData = useMarkdown
+                    ? markdownToFeishuPost(content, options?.title)
+                    : { zh_cn: { title: options?.title || '', content: [[{ tag: 'text', text: content }]] } };
+                // 在第一行开头插入所有 @ 标签
+                if (postData.zh_cn.content.length > 0) {
+                    const atTags = options.mentionUserIds.map(uid => ({ tag: 'at', user_id: uid }));
+                    postData.zh_cn.content[0].unshift(...atTags);
+                }
+                msgContent = JSON.stringify(postData);
+            }
+            else {
+                msgContent = useMarkdown
+                    ? JSON.stringify(markdownToFeishuPost(content, options?.title))
+                    : JSON.stringify({ text: content });
+            }
             if (options?.replyToMessageId) {
                 await this.client.im.message.reply({
                     path: { message_id: options.replyToMessageId },

package/dist/channels/wechat.js

@@ -17,8 +17,58 @@ const SESSION_PAUSE_DURATION_MS = 10 * 60 * 1000; // 长暂停：10 分钟
 const MSG_TYPE_USER = 1;
 const MSG_TYPE_BOT = 2;
 const MSG_ITEM_TEXT = 1;
+const MSG_ITEM_IMAGE = 2;
 const MSG_ITEM_VOICE = 3;
+const MSG_ITEM_FILE = 4;
+const MSG_ITEM_VIDEO = 5;
 const MSG_STATE_FINISH = 2;
+// ── CDN + AES ───────────────────────────────────────────────────────────────
+const CDN_BASE_URL = 'https://novac2c.cdn.weixin.qq.com/c2c';
+const MIME_MAP = {
+    '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png',
+    '.gif': 'image/gif', '.webp': 'image/webp', '.bmp': 'image/bmp',
+    '.mp4': 'video/mp4', '.mov': 'video/quicktime', '.avi': 'video/x-msvideo',
+    '.pdf': 'application/pdf', '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.zip': 'application/zip', '.rar': 'application/x-rar-compressed',
+    '.txt': 'text/plain', '.csv': 'text/csv', '.md': 'text/markdown',
+};
+// Exported for unit testing
+export function parseAesKey(aesKeyBase64) {
+    const decoded = Buffer.from(aesKeyBase64, 'base64');
+    if (decoded.length === 16)
+        return decoded;
+    if (decoded.length === 32 && /^[0-9a-fA-F]{32}$/.test(decoded.toString('ascii')))
+        return Buffer.from(decoded.toString('ascii'), 'hex');
+    throw new Error(`Invalid aes_key length: ${decoded.length}`);
+}
+// Exported for unit testing
+export function decryptAesEcb(ciphertext, key) {
+    const decipher = crypto.createDecipheriv('aes-128-ecb', key, null);
+    return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+}
+// Exported for unit testing
+export function encryptAesEcb(plaintext, key) {
+    const cipher = crypto.createCipheriv('aes-128-ecb', key, null);
+    return Buffer.concat([cipher.update(plaintext), cipher.final()]);
+}
+async function downloadMedia(cdnMedia, hexKey) {
+    const aesKeyBase64 = hexKey
+        ? Buffer.from(hexKey, 'hex').toString('base64')
+        : cdnMedia.aes_key;
+    if (!cdnMedia.encrypt_query_param)
+        throw new Error('No encrypt_query_param');
+    const url = `${CDN_BASE_URL}/download?encrypted_query_param=${encodeURIComponent(cdnMedia.encrypt_query_param)}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`CDN download failed: ${res.status}`);
+    const encrypted = Buffer.from(await res.arrayBuffer());
+    if (!aesKeyBase64)
+        return encrypted; // 无 key = 明文
+    return decryptAesEcb(encrypted, parseAesKey(aesKeyBase64));
+}
 // ── Markdown → Plain Text ───────────────────────────────────────────────────
 function markdownToPlainText(text) {
     let result = text;
@@ -91,6 +141,8 @@ export class WechatChannel {
     // Session expired 状态
     sessionPausedUntil = 0;
     onSessionExpired;
+    // Project path resolver（用于保存文件到 uploads 目录）
+    projectPathResolver;
     constructor(config) {
         this.config = config;
         const dataDir = resolvePaths().dataDir;
@@ -179,6 +231,64 @@ export class WechatChannel {
             throw err;
         }
     }
+    /** 注册 projectPath 解析器，用于保存接收的文件 */
+    onProjectPathRequest(resolver) {
+        this.projectPathResolver = resolver;
+    }
+    /** 发送文件（图片/视频/文件）给用户，通过 CDN 上传 */
+    async sendFile(to, filePath) {
+        // Session 暂停期间拒绝发送
+        if (this.isSessionPaused()) {
+            logger.warn(`[WeChat] Session paused, dropping file send to ${to}`);
+            return;
+        }
+        const contextToken = this.contextTokenCache.get(to);
+        if (!contextToken) {
+            logger.error(`[WeChat] No context_token for ${to}, cannot send file`);
+            return;
+        }
+        if (!fs.existsSync(filePath)) {
+            logger.error(`[WeChat] File not found: ${filePath}`);
+            return;
+        }
+        try {
+            const plaintext = Buffer.from(fs.readFileSync(filePath));
+            const rawsize = plaintext.length;
+            const rawfilemd5 = crypto.createHash('md5').update(plaintext).digest('hex');
+            const aeskey = crypto.randomBytes(16);
+            const filekey = crypto.randomBytes(16).toString('hex');
+            const filesize = Math.ceil((rawsize + 1) / 16) * 16;
+            // MIME → UploadMediaType
+            const ext = path.extname(filePath).toLowerCase();
+            const mime = MIME_MAP[ext] || 'application/octet-stream';
+            const uploadMediaType = mime.startsWith('image/') ? 1
+                : mime.startsWith('video/') ? 2 : 3;
+            // Step 1: getuploadurl
+            const uploadResp = await this.getUploadUrl({
+                filekey, media_type: uploadMediaType, to_user_id: to,
+                rawsize, rawfilemd5, filesize,
+                aeskey: aeskey.toString('hex'),
+                no_need_thumb: true,
+            });
+            // Step 2: encrypt + upload to CDN
+            const ciphertext = encryptAesEcb(plaintext, aeskey);
+            const downloadParam = await this.cdnUpload(uploadResp.upload_param, filekey, ciphertext);
+            // Step 3: sendmessage with CDN reference
+            const cdnMedia = {
+                encrypt_query_param: downloadParam,
+                aes_key: Buffer.from(aeskey.toString('hex')).toString('base64'),
+                encrypt_type: 1,
+            };
+            const itemType = mime.startsWith('image/') ? MSG_ITEM_IMAGE
+                : mime.startsWith('video/') ? MSG_ITEM_VIDEO : MSG_ITEM_FILE;
+            const item = this.buildMediaItem(itemType, cdnMedia, filePath, filesize, rawsize);
+            await this.sendMediaMessage(to, item, contextToken);
+        }
+        catch (err) {
+            logger.error(`[WeChat] Failed to send file ${filePath} to ${to}:`, err);
+            throw err;
+        }
+    }
     // ── Long-Poll Loop ────────────────────────────────────────────────────
     async pollLoop(signal) {
         let consecutiveFailures = 0;
@@ -315,22 +425,29 @@ export class WechatChannel {
     async handleInboundMessage(msg) {
         if (msg.message_type !== MSG_TYPE_USER)
             return;
-        const text = extractTextFromMessage(msg);
-        if (!text)
-            return;
         const fromUserId = msg.from_user_id ?? '';
         // 缓存 context_token
         if (msg.context_token) {
             this.contextTokenCache.set(fromUserId, msg.context_token);
             this.persistContextTokens();
         }
-        logger.info(`[WeChat] Received: from=${fromUserId} text=${text.slice(0, 50)}...`);
+        // 提取文本（原有逻辑）
+        const text = extractTextFromMessage(msg);
+        // 提取媒体 → 下载
+        const media = await this.extractMedia(msg, fromUserId);
+        // 合成最终内容
+        const finalContent = media.prompt
+            ? (text ? `${text}\n\n${media.prompt}` : media.prompt)
+            : text;
+        if (!finalContent && !media.images.length)
+            return;
+        logger.info(`[WeChat] Received: from=${fromUserId} text=${(finalContent || '').slice(0, 50)} images=${media.images.length}...`);
         // 发送 typing 指示器（异步，不阻塞）
         this.acknowledgeMessage(fromUserId, msg.context_token).catch(() => { });
         // 回调主流程
         if (this.messageHandler) {
             try {
-                await this.messageHandler(fromUserId, text, fromUserId);
+                await this.messageHandler(fromUserId, finalContent || '', fromUserId, media.images.length ? media.images : undefined);
             }
             catch (err) {
                 logger.error('[WeChat] Message handler error:', err);
@@ -379,6 +496,122 @@ export class WechatChannel {
         }
         return undefined;
     }
+    // ── Media Extraction (Inbound) ────────────────────────────────────────
+    async extractMedia(msg, channelId) {
+        const images = [];
+        const prompts = [];
+        for (const item of msg.item_list ?? []) {
+            try {
+                if (item.type === MSG_ITEM_IMAGE && item.image_item?.media) {
+                    const buf = await downloadMedia(item.image_item.media, item.image_item.aeskey);
+                    images.push({ data: buf.toString('base64'), mimeType: 'image/jpeg' });
+                }
+                else if (item.type === MSG_ITEM_FILE && item.file_item?.media) {
+                    const buf = await downloadMedia(item.file_item.media);
+                    const fileName = this.sanitizeFileName(item.file_item.file_name || `file_${Date.now()}`);
+                    const savePath = await this.saveToUploads(buf, fileName, channelId);
+                    prompts.push(`用户发送了文件：${fileName}\n文件已保存到：${savePath}\n请使用 Read 工具读取并分析文件内容。`);
+                }
+                else if (item.type === MSG_ITEM_VIDEO && item.video_item?.media) {
+                    const buf = await downloadMedia(item.video_item.media);
+                    const fileName = `video_${Date.now()}.mp4`;
+                    const savePath = await this.saveToUploads(buf, fileName, channelId);
+                    prompts.push(`用户发送了视频：${fileName}\n文件已保存到：${savePath}`);
+                }
+            }
+            catch (err) {
+                logger.error(`[WeChat] Failed to download media type=${item.type}:`, err);
+            }
+        }
+        return { prompt: prompts.join('\n\n'), images };
+    }
+    async saveToUploads(buf, fileName, channelId) {
+        const projectPath = this.projectPathResolver
+            ? await this.projectPathResolver(channelId)
+            : process.cwd();
+        const uploadsDir = path.join(projectPath, '.claude', 'uploads');
+        fs.mkdirSync(uploadsDir, { recursive: true });
+        const savePath = path.join(uploadsDir, fileName);
+        fs.writeFileSync(savePath, buf);
+        return savePath;
+    }
+    /** 清理文件名：移除路径穿越字符，只保留 basename */
+    sanitizeFileName(name) {
+        return path.basename(name).replace(/[<>:"|?*\x00-\x1f]/g, '_') || `file_${Date.now()}`;
+    }
+    // ── Media Upload (Outbound) ──────────────────────────────────────────
+    async getUploadUrl(params) {
+        const body = JSON.stringify({
+            ...params,
+            base_info: { channel_version: CHANNEL_VERSION },
+        });
+        const raw = await this.apiFetch('ilink/bot/getuploadurl', body, DEFAULT_API_TIMEOUT_MS);
+        const resp = JSON.parse(raw);
+        if (!resp.upload_param)
+            throw new Error('getuploadurl: no upload_param');
+        return resp;
+    }
+    async cdnUpload(uploadParam, filekey, ciphertext) {
+        const url = `${CDN_BASE_URL}/upload?encrypted_query_param=${encodeURIComponent(uploadParam)}&filekey=${filekey}`;
+        let lastError;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/octet-stream' },
+                    body: new Uint8Array(ciphertext),
+                });
+                if (res.status >= 400 && res.status < 500) {
+                    throw new Error(`CDN upload client error: ${res.status}`);
+                }
+                if (!res.ok)
+                    throw new Error(`CDN upload failed: ${res.status}`);
+                const downloadParam = res.headers.get('x-encrypted-param');
+                if (!downloadParam)
+                    throw new Error('Missing x-encrypted-param header');
+                return downloadParam;
+            }
+            catch (err) {
+                lastError = err;
+                if (err.message?.includes('client error'))
+                    throw err; // 4xx 不重试
+            }
+        }
+        throw lastError;
+    }
+    buildMediaItem(itemType, cdnMedia, filePath, ciphertextSize, plaintextSize) {
+        if (itemType === MSG_ITEM_IMAGE) {
+            return { type: MSG_ITEM_IMAGE, image_item: { media: cdnMedia, mid_size: ciphertextSize } };
+        }
+        if (itemType === MSG_ITEM_VIDEO) {
+            return { type: MSG_ITEM_VIDEO, video_item: { media: cdnMedia, video_size: ciphertextSize } };
+        }
+        return {
+            type: MSG_ITEM_FILE,
+            file_item: {
+                media: cdnMedia,
+                file_name: path.basename(filePath),
+                len: String(plaintextSize),
+            },
+        };
+    }
+    async sendMediaMessage(to, item, contextToken) {
+        const clientId = `evolclaw-wechat:${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+        const body = {
+            msg: {
+                from_user_id: '',
+                to_user_id: to,
+                client_id: clientId,
+                message_type: MSG_TYPE_BOT,
+                message_state: MSG_STATE_FINISH,
+                item_list: [item],
+                context_token: contextToken,
+            },
+            base_info: { channel_version: CHANNEL_VERSION },
+        };
+        await this.apiFetch('ilink/bot/sendmessage', JSON.stringify(body), DEFAULT_API_TIMEOUT_MS);
+        logger.info(`[WeChat] Sent media to ${to}, type=${item.type}`);
+    }
     // ── ilink API Helpers ─────────────────────────────────────────────────
     async apiFetch(endpoint, body, timeoutMs, externalSignal) {
         const base = this.config.baseUrl.endsWith('/') ? this.config.baseUrl : `${this.config.baseUrl}/`;