@xmanrui/dsh-im 1.4.0 → 2.0.0

package/src/channels/weixin/config-store.mjs

@@ -3,6 +3,7 @@ import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 
 import { normalizeWeixinApiBaseUrl } from './weixin-api.mjs';
+import { t } from '../shared/i18n.mjs';
 
 const EMPTY_DOCUMENT = Object.freeze({ version: 1, accounts: Object.freeze([]) });
 
@@ -32,7 +33,7 @@ export function deriveWeixinBotIdentity(accountId) {
 
 export function maskWeixinAccountId(accountId) {
   const value = cleanString(accountId) ?? '';
-  if (value.length <= 10) return value ? `${value.slice(0, 3)}•••` : '微信机器人';
+  if (value.length <= 10) return value ? `${value.slice(0, 3)}•••` : t('微信机器人');
   return `${value.slice(0, 6)}••••${value.slice(-4)}`;
 }
 

package/src/channels/weixin/weixin-api.mjs

@@ -457,6 +457,123 @@ function validateLoginResponse(value) {
 export function createWeixinApi({ fetchImpl = fetch } = {}) {
   if (typeof fetchImpl !== 'function') throw new TypeError('fetchImpl must be a function');
 
+  async function sendArtifact({
+    baseUrl,
+    token,
+    toUserId,
+    file,
+    contextToken,
+    runId,
+    signal,
+  }, { mediaType, createItem }) {
+    const recipient = nonEmptyString(toUserId);
+    if (!recipient || !file || typeof file !== 'object'
+      || typeof file.fileName !== 'string' || !file.fileName
+      || !Buffer.isBuffer(file.bytes)) {
+      throw new TypeError('toUserId and a file are required');
+    }
+    signal?.throwIfAborted();
+    const fileKey = randomBytes(16).toString('hex');
+    const aesKey = randomBytes(16);
+    const rawMd5 = createHash('md5').update(file.bytes).digest('hex');
+    let upload;
+    try {
+      upload = await requestJson(fetchImpl, {
+        method: 'POST',
+        baseUrl,
+        endpoint: 'ilink/bot/getuploadurl',
+        token,
+        signal,
+        body: {
+          filekey: fileKey,
+          media_type: mediaType,
+          to_user_id: recipient,
+          rawsize: file.bytes.byteLength,
+          rawfilemd5: rawMd5,
+          filesize: aesEcbPaddedSize(file.bytes.byteLength),
+          no_need_thumb: true,
+          aeskey: aesKey.toString('hex'),
+          base_info: baseInfo(),
+        },
+      });
+    } catch (error) {
+      if (signal?.aborted) throw abortError(signal);
+      const status = Number(error?.status);
+      const fallback = error?.code === 'http-error' && status >= 400 && status < 500
+        ? 'artifact-provider-rejected'
+        : 'artifact-provider-failed';
+      throw weixinArtifactError(error, { fallback });
+    }
+    const uploadRejection = rejectedProviderResponse(upload);
+    if (uploadRejection) {
+      throw weixinArtifactError(new WeixinApiError(
+        'upload-url-rejected',
+        '微信服务拒绝了文件上传请求。',
+        { providerCode: uploadRejection },
+      ));
+    }
+    const uploadUrl = weixinCdnUploadUrl(upload, fileKey);
+    const ciphertext = encryptWeixinUpload(file.bytes, aesKey);
+    let downloadParam;
+    try {
+      downloadParam = await uploadWeixinCdn(fetchImpl, uploadUrl, ciphertext, { signal });
+    } catch (error) {
+      if (signal?.aborted) throw abortError(signal);
+      const status = Number(error?.status);
+      const fallback = error?.code === 'upload-rejected' || (status >= 400 && status < 500)
+        ? 'artifact-provider-rejected'
+        : 'artifact-provider-failed';
+      throw weixinArtifactError(error, { fallback });
+    }
+    signal?.throwIfAborted();
+    const deliverySeed = nonEmptyString(file.deliveryKey) ?? nonEmptyString(file.artifactId)
+      ?? randomUUID();
+    const clientIdSeed = mediaType === 3 ? deliverySeed : `${deliverySeed}\u0000${mediaType}`;
+    const clientId = `dsh-weixin-${createHash('sha256')
+      .update(clientIdSeed)
+      .digest('hex')
+      .slice(0, 32)}`;
+    const media = {
+      encrypt_query_param: downloadParam,
+      aes_key: Buffer.from(aesKey.toString('hex')).toString('base64'),
+      encrypt_type: 1,
+    };
+    let response;
+    try {
+      response = await requestJson(fetchImpl, {
+        method: 'POST',
+        baseUrl,
+        endpoint: 'ilink/bot/sendmessage',
+        token,
+        signal,
+        body: {
+          msg: {
+            from_user_id: '',
+            to_user_id: recipient,
+            client_id: clientId,
+            message_type: 2,
+            message_state: 2,
+            item_list: [createItem({ file, media, ciphertextSize: ciphertext.byteLength })],
+            ...(nonEmptyString(contextToken) ? { context_token: contextToken.trim() } : {}),
+            ...(nonEmptyString(runId) ? { run_id: runId.trim() } : {}),
+          },
+          base_info: baseInfo(),
+        },
+      });
+    } catch (error) {
+      throw classifyWeixinFinalDeliveryError(error, signal);
+    }
+    const sendRejection = rejectedProviderResponse(response);
+    if (sendRejection) {
+      throw weixinArtifactError(new WeixinApiError(
+        'send-rejected',
+        '微信服务拒绝了文件消息。',
+        { providerCode: sendRejection },
+      ));
+    }
+    return { messageId: clientId };
+  }
+
   return Object.freeze({
     inboundImages(message) {
       return extractWeixinImages(message, { fetchImpl });
@@ -549,115 +666,31 @@ export function createWeixinApi({ fetchImpl = fetch } = {}) {
       return true;
     },
 
-    async sendFile({ baseUrl, token, toUserId, file, contextToken, runId, signal }) {
-      const recipient = nonEmptyString(toUserId);
-      if (!recipient || !file || typeof file !== 'object'
-        || typeof file.fileName !== 'string' || !file.fileName
-        || !Buffer.isBuffer(file.bytes)) {
-        throw new TypeError('toUserId and a file are required');
-      }
-      signal?.throwIfAborted();
-      const fileKey = randomBytes(16).toString('hex');
-      const aesKey = randomBytes(16);
-      const rawMd5 = createHash('md5').update(file.bytes).digest('hex');
-      let upload;
-      try {
-        upload = await requestJson(fetchImpl, {
-          method: 'POST',
-          baseUrl,
-          endpoint: 'ilink/bot/getuploadurl',
-          token,
-          signal,
-          body: {
-            filekey: fileKey,
-            media_type: 3,
-            to_user_id: recipient,
-            rawsize: file.bytes.byteLength,
-            rawfilemd5: rawMd5,
-            filesize: aesEcbPaddedSize(file.bytes.byteLength),
-            no_need_thumb: true,
-            aeskey: aesKey.toString('hex'),
-            base_info: baseInfo(),
+    async sendFile(request) {
+      return sendArtifact(request, {
+        mediaType: 3,
+        createItem: ({ file, media }) => ({
+          type: 4,
+          file_item: {
+            media,
+            file_name: file.fileName,
+            len: String(file.bytes.byteLength),
           },
-        });
-      } catch (error) {
-        if (signal?.aborted) throw abortError(signal);
-        const status = Number(error?.status);
-        const fallback = error?.code === 'http-error' && status >= 400 && status < 500
-          ? 'artifact-provider-rejected'
-          : 'artifact-provider-failed';
-        throw weixinArtifactError(error, { fallback });
-      }
-      const uploadRejection = rejectedProviderResponse(upload);
-      if (uploadRejection) {
-        throw weixinArtifactError(new WeixinApiError(
-          'upload-url-rejected',
-          '微信服务拒绝了文件上传请求。',
-          { providerCode: uploadRejection },
-        ));
-      }
-      const uploadUrl = weixinCdnUploadUrl(upload, fileKey);
-      const ciphertext = encryptWeixinUpload(file.bytes, aesKey);
-      let downloadParam;
-      try {
-        downloadParam = await uploadWeixinCdn(fetchImpl, uploadUrl, ciphertext, { signal });
-      } catch (error) {
-        if (signal?.aborted) throw abortError(signal);
-        const status = Number(error?.status);
-        const fallback = error?.code === 'upload-rejected' || (status >= 400 && status < 500)
-          ? 'artifact-provider-rejected'
-          : 'artifact-provider-failed';
-        throw weixinArtifactError(error, { fallback });
-      }
-      signal?.throwIfAborted();
-      const deliverySeed = nonEmptyString(file.deliveryKey) ?? nonEmptyString(file.artifactId)
-        ?? randomUUID();
-      const clientId = `dsh-weixin-${createHash('sha256').update(deliverySeed).digest('hex').slice(0, 32)}`;
-      let response;
-      try {
-        response = await requestJson(fetchImpl, {
-          method: 'POST',
-          baseUrl,
-          endpoint: 'ilink/bot/sendmessage',
-          token,
-          signal,
-          body: {
-            msg: {
-              from_user_id: '',
-              to_user_id: recipient,
-              client_id: clientId,
-              message_type: 2,
-              message_state: 2,
-              item_list: [{
-                type: 4,
-                file_item: {
-                  media: {
-                    encrypt_query_param: downloadParam,
-                    aes_key: Buffer.from(aesKey.toString('hex')).toString('base64'),
-                    encrypt_type: 1,
-                  },
-                  file_name: file.fileName,
-                  len: String(file.bytes.byteLength),
-                },
-              }],
-              ...(nonEmptyString(contextToken) ? { context_token: contextToken.trim() } : {}),
-              ...(nonEmptyString(runId) ? { run_id: runId.trim() } : {}),
-            },
-            base_info: baseInfo(),
+        }),
+      });
+    },
+
+    async sendImage(request) {
+      return sendArtifact(request, {
+        mediaType: 1,
+        createItem: ({ media, ciphertextSize }) => ({
+          type: 2,
+          image_item: {
+            media,
+            mid_size: ciphertextSize,
           },
-        });
-      } catch (error) {
-        throw classifyWeixinFinalDeliveryError(error, signal);
-      }
-      const sendRejection = rejectedProviderResponse(response);
-      if (sendRejection) {
-        throw weixinArtifactError(new WeixinApiError(
-          'send-rejected',
-          '微信服务拒绝了文件消息。',
-          { providerCode: sendRejection },
-        ));
-      }
-      return { messageId: clientId };
+        }),
+      });
     },
 
     async notifyStart({ baseUrl, token, signal }) {

package/src/channels/weixin/weixin-bridge.mjs

@@ -38,41 +38,37 @@ import {
   prefetchInboundFiles,
 } from '../shared/inbound-file.mjs';
 import { rememberConnectionTestTarget } from '../shared/connection-test.mjs';
+import { deliverOutboundArtifacts } from '../shared/semantic/artifact-delivery.mjs';
 import {
-  materializeOutboundArtifact,
-  releaseOutboundArtifact,
-} from '../shared/semantic/artifact.mjs';
-import {
-  createArtifactFailureReceipt,
   createDeliveryReceipt,
-  mergeDeliveryReceipts,
   providerMessageIdsFor,
 } from '../shared/semantic/delivery.mjs';
+import { t } from '../shared/i18n.mjs';
 
-const INTERACTION_RESOLVED_TEXT = '这个问题已在其他客户端处理，无需再次回答。';
-const GENERIC_PROCESSING_ERROR = '消息处理失败，请稍后重试。';
+const INTERACTION_RESOLVED_TEXT = () => t('这个问题已在其他客户端处理，无需再次回答。');
+const GENERIC_PROCESSING_ERROR = () => t('消息处理失败，请稍后重试。');
 
-const HELP_TEXT = [
-  '微信已连接 DeepSeek Harness。',
+const HELP_TEXT = () => [
+  t('微信已连接 DeepSeek Harness。'),
   '',
-  '直接发送文字、图片、文件或带文字识别结果的语音即可继续当前会话。',
-  '/new  开启一个全新会话',
-  '/compact  压缩当前会话的较早上下文',
-  '/workspace 工作区绝对路径  切换工作区',
-  '/workspacelist  列出工作区绝对路径',
-  '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题',
-  '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
-  '/models  按序号列出所有可用模型',
-  '/model [序号或完整模型ID]  查看或切换当前会话模型',
-  '示例：先发 /models，再发 /model 2',
-  '/presetlist  按序号列出可用 Agent Preset',
-  '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset',
-  '纯数字 ID：/preset id:<ID>',
-  '/preset --default  跟随 Host 默认',
-  '/stop  停止当前任务',
-  '/steer 补充指令  纠偏当前任务',
-  '/status  检查连接状态',
-  '/help  显示本帮助',
+  t('直接发送文字、图片、文件或带文字识别结果的语音即可继续当前会话。'),
+  t('/new  开启一个全新会话'),
+  t('/compact  压缩当前会话的较早上下文'),
+  t('/workspace 工作区绝对路径  切换工作区'),
+  t('/workspacelist  列出工作区绝对路径'),
+  t('/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题'),
+  t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
+  t('/models  按序号列出所有可用模型'),
+  t('/model [序号或完整模型ID]  查看或切换当前会话模型'),
+  t('示例：先发 /models，再发 /model 2'),
+  t('/presetlist  按序号列出可用 Agent Preset'),
+  t('/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset'),
+  t('纯数字 ID：/preset id:<ID>'),
+  t('/preset --default  跟随 Host 默认'),
+  t('/stop  停止当前任务'),
+  t('/steer 补充指令  纠偏当前任务'),
+  t('/status  检查连接状态'),
+  t('/help  显示本帮助'),
 ].join('\n');
 
 function conversationKey(userId) {
@@ -113,7 +109,7 @@ function canClaimInteractionReply(message, pending) {
     && nonEmptyString(extractWeixinText(message));
 }
 
-function safeMessageError(error, userMessage = GENERIC_PROCESSING_ERROR) {
+function safeMessageError(error, userMessage = GENERIC_PROCESSING_ERROR()) {
   const diagnostic = imagePromptDiagnostic(error);
   return {
     code: diagnostic?.code ?? 'message-processing-failed',
@@ -124,24 +120,24 @@ function safeMessageError(error, userMessage = GENERIC_PROCESSING_ERROR) {
 }
 
 function artifactFailureText(fileName, error) {
-  const name = String(fileName ?? '结果文件').replace(/[\r\n]+/g, ' ').trim() || '结果文件';
+  const name = String(fileName ?? t('结果文件')).replace(/[\r\n]+/g, ' ').trim() || t('结果文件');
   switch (error?.code) {
     case 'artifact-delivery-uncertain':
-      return `结果文件「${name}」发送结果未能确认，请先检查聊天内是否已收到，不要立即重试。`;
+      return t('结果文件「{name}」发送结果未能确认，请先检查聊天内是否已收到，不要立即重试。', { name });
     case 'artifact-permission-required':
-      return `结果文件「${name}」已生成，但微信机器人当前没有文件消息发送权限，请检查机器人文件消息能力。`;
+      return t('结果文件「{name}」已生成，但微信机器人当前没有文件消息发送权限，请检查机器人文件消息能力。', { name });
     case 'artifact-too-large':
-      return `结果文件「${name}」超过当前微信会话可发送的文件大小，未发送。`;
+      return t('结果文件「{name}」超过当前微信会话可发送的文件大小，未发送。', { name });
     case 'artifact-rate-limited':
-      return `结果文件「${name}」暂时被微信限流，未能发送，请稍后重试。`;
+      return t('结果文件「{name}」暂时被微信限流，未能发送，请稍后重试。', { name });
     case 'artifact-provider-rejected':
-      return `结果文件「${name}」已生成，但微信拒绝了该文件消息。`;
+      return t('结果文件「{name}」已生成，但微信拒绝了该文件消息。', { name });
     case 'artifact-invalid':
     case 'artifact-changed':
     case 'artifact-unavailable':
-      return `结果文件「${name}」暂时无法读取或准备发送，请确认文件仍可访问后重试。`;
+      return t('结果文件「{name}」暂时无法读取或准备发送，请确认文件仍可访问后重试。', { name });
     default:
-      return `结果文件「${name}」已生成，但暂时未能通过微信发送，请稍后重试。`;
+      return t('结果文件「{name}」已生成，但暂时未能通过微信发送，请稍后重试。', { name });
   }
 }
 
@@ -249,7 +245,7 @@ export class WeixinHarnessBridge {
         this.#status.lastError = error?.message ?? String(error);
         this.#status.lastMessageError = safeMessageError(error);
         this.#logger.error?.('[dsh-weixin] failed to process a command:', error);
-        return this.#send(sender, GENERIC_PROCESSING_ERROR, contextToken, runId)
+        return this.#send(sender, GENERIC_PROCESSING_ERROR(), contextToken, runId)
           .catch(() => undefined);
       }).finally(() => {
         this.#acceptedMessageIds.delete(messageId);
@@ -405,26 +401,26 @@ export class WeixinHarnessBridge {
       const hasImages = hasInboundImages(promptMessage);
       const hasFiles = hasInboundFiles(promptMessage);
       if (!text && !hasImages && !hasFiles) {
-        await this.#send(sender, '目前支持文字、图片、文件，以及微信已转成文字的语音消息。', contextToken, runId);
+        await this.#send(sender, t('目前支持文字、图片、文件，以及微信已转成文字的语音消息。'), contextToken, runId);
         await this.#state.markSeen(messageId);
         return;
       }
 
       const command = text.trim().toLowerCase();
       if (!hasImages && !hasFiles && command === '/help') {
-        await this.#send(sender, HELP_TEXT, contextToken, runId);
+        await this.#send(sender, HELP_TEXT(), contextToken, runId);
         await this.#state.markSeen(messageId);
         return;
       }
       if (!hasImages && !hasFiles && command === '/status') {
         await this.#harness.ensureRunning({ signal: this.#signal });
-        await this.#send(sender, '微信与 DeepSeek Harness 连接正常。', contextToken, runId);
+        await this.#send(sender, t('微信与 DeepSeek Harness 连接正常。'), contextToken, runId);
         await this.#state.markSeen(messageId);
         return;
       }
       if (!hasImages && !hasFiles && command === '/new') {
         await this.#state.clearSession(key);
-        await this.#send(sender, '已开启新会话。请发送你的问题。', contextToken, runId);
+        await this.#send(sender, t('已开启新会话。请发送你的问题。'), contextToken, runId);
         await this.#state.markSeen(messageId);
         return;
       }
@@ -488,7 +484,7 @@ export class WeixinHarnessBridge {
       }
       const answerText = typeof answer === 'string' && answer.trim()
         ? answer
-        : artifacts.length > 0 ? '结果文件已生成。' : answer;
+        : artifacts.length > 0 ? t('结果文件已生成。') : answer;
       let textDeliveryError = null;
       let textReceipt = null;
       try {
@@ -524,7 +520,7 @@ export class WeixinHarnessBridge {
       this.#status.lastError = error?.message ?? String(error);
       const userMessage = inboundFileUserMessage(error)
         ?? imagePromptUserMessage(error)
-        ?? GENERIC_PROCESSING_ERROR;
+        ?? GENERIC_PROCESSING_ERROR();
       this.#status.lastMessageError = safeMessageError(error, userMessage);
       this.#logger.error?.('[dsh-weixin] failed to process an inbound message:', error);
       try {
@@ -562,7 +558,7 @@ export class WeixinHarnessBridge {
     if (!text || hasWeixinImageItems(message)) {
       await this.#send(
         expected.actor,
-        '请用文字回答当前问题。',
+        t('请用文字回答当前问题。'),
         contextToken,
         runId,
       );
@@ -574,7 +570,7 @@ export class WeixinHarnessBridge {
       if (claimed && (!pending || pending !== expected)) {
         await this.#send(
           expected.actor,
-          INTERACTION_RESOLVED_TEXT,
+          INTERACTION_RESOLVED_TEXT(),
           contextToken,
           runId,
         );
@@ -591,7 +587,7 @@ export class WeixinHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch {
-        this.#status.lastError = '微信交互问题发送失败。';
+        this.#status.lastError = t('微信交互问题发送失败。');
         this.#logger.error?.('[dsh-weixin] failed to retry an interaction question');
         pending.interaction.reconnect?.();
         return;
@@ -601,7 +597,7 @@ export class WeixinHarnessBridge {
         if (claimed && (!presentedPending || presentedPending !== expected)) {
           await this.#send(
             expected.actor,
-            INTERACTION_RESOLVED_TEXT,
+            INTERACTION_RESOLVED_TEXT(),
             contextToken,
             runId,
           ).catch(() => undefined);
@@ -626,7 +622,7 @@ export class WeixinHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch {
-        this.#status.lastError = '微信交互问题发送失败。';
+        this.#status.lastError = t('微信交互问题发送失败。');
         this.#logger.error?.('[dsh-weixin] failed to send the next interaction question');
         pending.interaction.reconnect?.();
       }
@@ -651,7 +647,7 @@ export class WeixinHarnessBridge {
         this.#clearPendingInteraction(key, pending.interactionId);
         await this.#send(
           pending.actor,
-          INTERACTION_RESOLVED_TEXT,
+          INTERACTION_RESOLVED_TEXT(),
           pending.contextToken,
           pending.runId,
         ).catch(() => undefined);
@@ -661,11 +657,11 @@ export class WeixinHarnessBridge {
       pending.submitting = false;
       pending.answers.pop();
       pending.index -= 1;
-      this.#status.lastError = '回答提交失败。';
+      this.#status.lastError = t('回答提交失败。');
       this.#logger.error?.('[dsh-weixin] failed to answer a Harness interaction');
       await this.#send(
         pending.actor,
-        '回答提交失败，请重新发送当前问题的答案。',
+        t('回答提交失败，请重新发送当前问题的答案。'),
         pending.contextToken,
         pending.runId,
       ).catch(() => undefined);
@@ -711,7 +707,7 @@ export class WeixinHarnessBridge {
       });
       await this.#send(
         actor,
-        '检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。',
+        t('检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。'),
         contextToken,
         runId,
       ).catch(() => undefined);
@@ -797,7 +793,7 @@ export class WeixinHarnessBridge {
     this.#status.lastMessageAt = new Date().toISOString();
     await this.#send(
       nonEmptyString(message?.from_user_id),
-      INTERACTION_RESOLVED_TEXT,
+      INTERACTION_RESOLVED_TEXT(),
       nonEmptyString(message?.context_token) ?? undefined,
       nonEmptyString(message?.run_id) ?? undefined,
     ).catch(() => undefined);
@@ -845,7 +841,7 @@ export class WeixinHarnessBridge {
     }
     await this.#send(
       nonEmptyString(message?.from_user_id),
-      GENERIC_PROCESSING_ERROR,
+      GENERIC_PROCESSING_ERROR(),
       nonEmptyString(message?.context_token) ?? undefined,
       nonEmptyString(message?.run_id) ?? undefined,
     ).catch(() => undefined);
@@ -869,73 +865,40 @@ export class WeixinHarnessBridge {
   }
 
   async #deliverArtifacts(toUserId, replyTo, artifacts, contextToken, runId, baseReceipt) {
-    const receipts = baseReceipt ? [baseReceipt] : [];
-    let userVisible = Boolean(baseReceipt);
-    for (const artifact of artifacts) {
-      this.#signal?.throwIfAborted();
-      try {
-        if (typeof this.#api.sendFile !== 'function') {
-          const unavailable = new Error('Weixin file delivery is unavailable');
-          unavailable.code = 'artifact-provider-unavailable';
-          throw unavailable;
-        }
-        const file = await materializeOutboundArtifact(artifact, {
-          signal: this.#signal,
-        });
-        const result = await this.#api.sendFile({
-          baseUrl: this.#baseUrl,
-          token: this.#token,
-          toUserId,
-          file,
-          contextToken,
-          runId,
-          signal: this.#signal,
-        });
-        receipts.push(createDeliveryReceipt({
-          deliveryId: file.deliveryKey,
-          presentation: 'weixin-file',
-          providerMessageIds: providerMessageIdsFor(result),
-          artifacts: [{ artifactId: file.artifactId, outcome: 'sent' }],
-        }));
-        userVisible = true;
-        this.#status.artifactsSent = (this.#status.artifactsSent ?? 0) + 1;
-      } catch (error) {
-        if (this.#signal?.aborted) throw error;
-        this.#status.artifactSendErrors = (this.#status.artifactSendErrors ?? 0) + 1;
-        this.#logger.warn?.(
-          `[dsh-weixin] result file delivery failed (${error?.code ?? 'unknown'})`,
-        );
-        let noticeSent = false;
-        const providerMessageIds = await this.#send(
-          toUserId,
-          artifactFailureText(artifact?.fileName, error),
-          contextToken,
-          runId,
-        ).then((ids) => {
-          noticeSent = true;
-          return ids;
-        }).catch(() => []);
-        const failureReceipt = createArtifactFailureReceipt({
-          artifactId: artifact?.artifactId ?? 'unknown',
-          deliveryId: artifact?.deliveryKey ?? artifact?.artifactId ?? 'unknown',
-          error,
-          providerMessageIds,
-        });
-        receipts.push(failureReceipt);
-        if (noticeSent || failureReceipt.artifacts[0]?.outcome === 'unknown') userVisible = true;
-      } finally {
-        releaseOutboundArtifact(artifact);
-      }
-    }
-    const receipt = receipts.length === 0
-      ? null
-      : receipts.length === 1
-        ? receipts[0]
-        : mergeDeliveryReceipts({
-            deliveryId: replyTo,
-            presentation: baseReceipt ? 'weixin-text-and-files' : 'weixin-files',
-            receipts,
-          });
-    return { receipt, userVisible };
+    const sendArtifact = (method, file) => this.#api[method]({
+      baseUrl: this.#baseUrl,
+      token: this.#token,
+      toUserId,
+      file,
+      contextToken,
+      runId,
+      signal: this.#signal,
+    });
+    const delivery = await deliverOutboundArtifacts({
+      artifacts,
+      baseReceipt,
+      deliveryId: replyTo,
+      aggregatePresentation: baseReceipt ? 'weixin-text-and-files' : 'weixin-files',
+      channelKey: 'weixin',
+      signal: this.#signal,
+      sendImage: typeof this.#api.sendImage === 'function'
+        ? (file) => sendArtifact('sendImage', file)
+        : undefined,
+      sendFile: typeof this.#api.sendFile === 'function'
+        ? (file) => sendArtifact('sendFile', file)
+        : undefined,
+      sendFailureNotice: (artifact, error) => this.#send(
+        toUserId,
+        artifactFailureText(artifact?.fileName, error),
+        contextToken,
+        runId,
+      ),
+      logger: this.#logger,
+    });
+    this.#status.artifactsSent = (this.#status.artifactsSent ?? 0)
+      + delivery.artifactsSent;
+    this.#status.artifactSendErrors = (this.#status.artifactSendErrors ?? 0)
+      + delivery.artifactSendErrors;
+    return { receipt: delivery.receipt, userVisible: delivery.userVisible };
   }
 }