@xmanrui/dsh-im 1.4.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

package/plugin-src/host/index.mjs

@@ -9,6 +9,7 @@ import { apply as applyWecom } from './channels/wecom/index.mjs';
 import { apply as applyWeixin } from './channels/weixin/index.mjs';
 import { apply as applyWhatsapp } from './channels/whatsapp/index.mjs';
 import { installOutboundArtifactTool } from '../../src/channels/shared/semantic/artifact.mjs';
+import { setImHostLanguage } from '../../src/channels/shared/i18n.mjs';
 
 export const name = 'dsh-im-host';
 export const inject = [
@@ -40,6 +41,7 @@ export function createImHostPlugin(internals = {}) {
     name,
     inject,
     async apply(ctx, config = {}) {
+      setImHostLanguage(config.language ?? process.env.DSH_IM_LANGUAGE);
       if (typeof ctx?.inject === 'function') {
         ctx.inject(['tools', 'systemPrompt'], (artifactCtx) => {
           installOutboundArtifactTool(artifactCtx);

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

@@ -2,6 +2,8 @@ import { createHash, randomUUID } from 'node:crypto';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 
+import { t } from '../shared/i18n.mjs';
+
 const EMPTY_DOCUMENT = Object.freeze({ version: 1, bots: Object.freeze([]) });
 const STORED_BOT_KEYS = new Set(['clientId', 'secretRef', 'approvedSenders']);
 
@@ -86,8 +88,8 @@ export function deriveDingtalkSenderKey() {
  */
 export function maskDingtalkSenderId(staffId) {
   const value = cleanString(staffId);
-  if (!value) return '钉钉用户';
-  return '身份已隐藏';
+  if (!value) return t('钉钉用户');
+  return t('身份已隐藏');
 }
 
 /**
@@ -97,7 +99,7 @@ export function maskDingtalkSenderId(staffId) {
  */
 export function maskDingtalkClientId(clientId) {
   const value = cleanString(clientId);
-  if (!value) return '钉钉机器人';
+  if (!value) return t('钉钉机器人');
   if (value.length <= 8) return `${value.slice(0, 2)}••••`;
   return `${value.slice(0, 4)}••••${value.slice(-4)}`;
 }

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

@@ -2,6 +2,7 @@ import { randomUUID } from 'node:crypto';
 import { extname } from 'node:path';
 
 import { fetchImageBuffer, ImagePromptError } from '../shared/image-prompt.mjs';
+import { t } from '../shared/i18n.mjs';
 
 export const DINGTALK_REGISTRATION_BASE_URL = 'https://oapi.dingtalk.com/';
 export const DINGTALK_API_BASE_URL = 'https://api.dingtalk.com/';
@@ -540,6 +541,93 @@ export function createDingtalkApi({
     return true;
   }
 
+  async function sendArtifact({
+    clientId,
+    clientSecret,
+    target,
+    file,
+    signal,
+  }, { uploadType, messageKey, createMessageParams }) {
+    if (!file || typeof file !== 'object'
+      || typeof file.fileName !== 'string' || !file.fileName
+      || !Buffer.isBuffer(file.bytes)) {
+      throw new TypeError('A DingTalk file is required');
+    }
+    const normalizedTarget = normalizeFileTarget(target);
+    let token;
+    try {
+      token = await accessToken({ clientId, clientSecret, signal });
+    } 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 dingtalkArtifactError(error, { fallback });
+    }
+    const uploadUrl = new URL('media/upload', DINGTALK_REGISTRATION_BASE_URL);
+    uploadUrl.searchParams.set('access_token', token);
+    uploadUrl.searchParams.set('type', uploadType);
+    const form = new FormData();
+    form.append(
+      'media',
+      new Blob([file.bytes], { type: file.mediaType ?? 'application/octet-stream' }),
+      file.fileName,
+    );
+    let uploaded;
+    try {
+      uploaded = await requestMultipart(fetchImpl, uploadUrl, { body: form, signal });
+    } 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 dingtalkArtifactError(error, { fallback });
+    }
+    const uploadRejection = rejectedProviderResponse(uploaded);
+    const mediaId = nonEmptyString(uploaded?.media_id);
+    if (uploadRejection || !mediaId) {
+      throw dingtalkArtifactError(new DingtalkApiError(
+        'upload-rejected',
+        '钉钉服务拒绝了文件上传。',
+        { providerCode: uploadRejection ?? 'missing-media-id' },
+      ));
+    }
+    signal?.throwIfAborted();
+    const messageBody = {
+      robotCode: normalizedTarget.robotCode,
+      msgKey: messageKey,
+      msgParam: JSON.stringify(createMessageParams(mediaId, file)),
+      ...(normalizedTarget.type === 'group'
+        ? { openConversationId: normalizedTarget.openConversationId }
+        : { userIds: [normalizedTarget.userId] }),
+    };
+    const pathname = normalizedTarget.type === 'group'
+      ? 'v1.0/robot/groupMessages/send'
+      : 'v1.0/robot/oToMessages/batchSend';
+    let response;
+    try {
+      response = await requestJson(fetchImpl, endpoint(apiBase, pathname), {
+        body: messageBody,
+        headers: { 'x-acs-dingtalk-access-token': token },
+        signal,
+        action: '文件消息发送',
+      });
+    } catch (error) {
+      throw classifyDingtalkFinalDeliveryError(error, signal);
+    }
+    const sendRejection = rejectedProviderResponse(response);
+    if (sendRejection) {
+      throw dingtalkArtifactError(new DingtalkApiError(
+        'send-rejected',
+        '钉钉服务拒绝了文件消息。',
+        { providerCode: sendRejection },
+      ));
+    }
+    return response;
+  }
+
   return Object.freeze({
     async beginRegistration({ signal } = {}) {
       const initialized = assertRegistrationOk(await requestJson(
@@ -742,7 +830,7 @@ export function createDingtalkApi({
             clientId: appKey,
             clientSecret: appSecret,
             cardInstanceId,
-            text: '消息处理失败，请稍后重试。',
+            text: t('消息处理失败，请稍后重试。'),
             signal: cleanupSignal,
           }).catch(() => undefined);
         }
@@ -842,89 +930,24 @@ export function createDingtalkApi({
       return true;
     },
 
-    async sendFile({ clientId, clientSecret, target, file, signal }) {
-      if (!file || typeof file !== 'object'
-        || typeof file.fileName !== 'string' || !file.fileName
-        || !Buffer.isBuffer(file.bytes)) {
-        throw new TypeError('A DingTalk file is required');
-      }
-      const normalizedTarget = normalizeFileTarget(target);
-      const fileType = dingtalkFileType(file.fileName);
-      let token;
-      try {
-        token = await accessToken({ clientId, clientSecret, signal });
-      } 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 dingtalkArtifactError(error, { fallback });
-      }
-      const uploadUrl = new URL('media/upload', DINGTALK_REGISTRATION_BASE_URL);
-      uploadUrl.searchParams.set('access_token', token);
-      uploadUrl.searchParams.set('type', 'file');
-      const form = new FormData();
-      form.append(
-        'media',
-        new Blob([file.bytes], { type: file.mediaType ?? 'application/octet-stream' }),
-        file.fileName,
-      );
-      let uploaded;
-      try {
-        uploaded = await requestMultipart(fetchImpl, uploadUrl, { body: form, signal });
-      } 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 dingtalkArtifactError(error, { fallback });
-      }
-      const uploadRejection = rejectedProviderResponse(uploaded);
-      if (uploadRejection || !nonEmptyString(uploaded?.media_id)) {
-        throw dingtalkArtifactError(new DingtalkApiError(
-          'upload-rejected',
-          '钉钉服务拒绝了文件上传。',
-          { providerCode: uploadRejection ?? 'missing-media-id' },
-        ));
-      }
-      signal?.throwIfAborted();
-      const messageBody = {
-        robotCode: normalizedTarget.robotCode,
-        msgKey: 'sampleFile',
-        msgParam: JSON.stringify({
-          mediaId: uploaded.media_id,
+    async sendFile(request) {
+      return sendArtifact(request, {
+        uploadType: 'file',
+        messageKey: 'sampleFile',
+        createMessageParams: (mediaId, file) => ({
+          mediaId,
           fileName: file.fileName,
-          fileType,
+          fileType: dingtalkFileType(file.fileName),
         }),
-        ...(normalizedTarget.type === 'group'
-          ? { openConversationId: normalizedTarget.openConversationId }
-          : { userIds: [normalizedTarget.userId] }),
-      };
-      const pathname = normalizedTarget.type === 'group'
-        ? 'v1.0/robot/groupMessages/send'
-        : 'v1.0/robot/oToMessages/batchSend';
-      let response;
-      try {
-        response = await requestJson(fetchImpl, endpoint(apiBase, pathname), {
-          body: messageBody,
-          headers: { 'x-acs-dingtalk-access-token': token },
-          signal,
-          action: '文件消息发送',
-        });
-      } catch (error) {
-        throw classifyDingtalkFinalDeliveryError(error, signal);
-      }
-      const sendRejection = rejectedProviderResponse(response);
-      if (sendRejection) {
-        throw dingtalkArtifactError(new DingtalkApiError(
-          'send-rejected',
-          '钉钉服务拒绝了文件消息。',
-          { providerCode: sendRejection },
-        ));
-      }
-      return response;
+      });
+    },
+
+    async sendImage(request) {
+      return sendArtifact(request, {
+        uploadType: 'image',
+        messageKey: 'sampleImageMsg',
+        createMessageParams: (mediaId) => ({ photoURL: mediaId }),
+      });
     },
 
     clearAccessToken(clientId) {

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

@@ -35,22 +35,18 @@ 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 CARD_INITIAL_TEXT = '已连接 DeepSeek Harness，正在思考…';
 const CARD_ERROR_TEXT = '消息处理失败，请稍后重试。';
 const INTERACTION_RESOLVED_TEXT = '这个问题已在其他客户端处理，无需再次回答。';
 
-const HELP_TEXT = [
+const HELP_TEXT_LINES = [
   '钉钉机器人已连接 DeepSeek Harness。',
   '',
   '直接发送文字、图片或文件即可继续当前会话。',
@@ -71,7 +67,11 @@ const HELP_TEXT = [
   '/steer 补充指令  纠偏当前任务',
   '/status  检查连接状态',
   '/help  显示本帮助',
-].join('\n');
+];
+
+function helpText() {
+  return HELP_TEXT_LINES.map((line) => t(line)).join('\n');
+}
 
 function nonEmptyString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
@@ -111,13 +111,13 @@ function dingtalkImageErrorUserMessage(error) {
   while (current && typeof current === 'object' && !seen.has(current)) {
     seen.add(current);
     if (current.code === 'image-download-address-failed') {
-      return '钉钉未能换取图片下载地址，请重新发送；若持续失败，请检查机器人的“企业内机器人发送消息权限”。';
+      return t('钉钉未能换取图片下载地址，请重新发送；若持续失败，请检查机器人的“企业内机器人发送消息权限”。');
     }
     if (current.code === 'invalid-image-download') {
-      return '钉钉没有返回图片下载地址，请重新发送。';
+      return t('钉钉没有返回图片下载地址，请重新发送。');
     }
     if (current.code === 'image-content-download-failed') {
-      return '钉钉返回的图片临时地址无法读取，请重新发送。';
+      return t('钉钉返回的图片临时地址无法读取，请重新发送。');
     }
     current = current.cause;
   }
@@ -246,34 +246,34 @@ function fileTarget(message, sender, clientId) {
 }
 
 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}」已生成，但钉钉应用或机器人缺少文件消息权限。请开通应用 qyapi_base 权限，并确认机器人具备文件消息发送能力。`;
+      return t('结果文件「{name}」已生成，但钉钉应用或机器人缺少文件消息权限。请开通应用 qyapi_base 权限，并确认机器人具备文件消息发送能力。', { 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 });
   }
 }
 
 function progressText(update) {
   if (update?.type === 'text' && nonEmptyString(update.text)) return update.text;
   if (update?.type === 'tool') {
-    if (update.name === 'web_search') return '_正在搜索网络并整理信息…_';
-    return `_正在使用 ${nonEmptyString(update.name) ?? '工具'}…_`;
+    if (update.name === 'web_search') return t('_正在搜索网络并整理信息…_');
+    return t('_正在使用 {name}…_', { name: nonEmptyString(update.name) ?? t('工具') });
   }
-  return `_${nonEmptyString(update?.text) ?? '正在处理…'}_`;
+  return t('_{text}_', { text: nonEmptyString(update?.text) ?? t('正在处理…') });
 }
 
 function canClaimInteractionReply(message, pending, sender) {
@@ -431,9 +431,9 @@ export class DingtalkHarnessBridge {
         commandRunner,
       ).catch((error) => {
         if (error?.code === 'turn-stopped' || this.#signal?.aborted) return;
-        this.#status.lastError = '钉钉命令处理失败。';
+        this.#status.lastError = t('钉钉命令处理失败。');
         this.#logger.error?.('[dsh-dingtalk] failed to process a command', safeErrorDiagnostic(error));
-        return this.#send(sessionWebhook, CARD_ERROR_TEXT).catch(() => undefined);
+        return this.#send(sessionWebhook, t(CARD_ERROR_TEXT)).catch(() => undefined);
       }).finally(() => {
         this.#acceptedMessageIds.delete(messageId);
         this.#commandTasks.delete(task);
@@ -468,13 +468,13 @@ export class DingtalkHarnessBridge {
           if (!sessionWebhook) {
             increment(this.#status, 'messagesRejected');
             this.#status.lastRejectedAt = new Date().toISOString();
-            this.#status.lastError = '钉钉消息没有安全的回复地址。';
+            this.#status.lastError = t('钉钉消息没有安全的回复地址。');
           }
           return true;
         })
         .catch((error) => {
           if (this.#signal?.aborted) return;
-          this.#status.lastError = '钉钉审批处理失败。';
+          this.#status.lastError = t('钉钉审批处理失败。');
           this.#logger.error?.('[dsh-dingtalk] failed to process an approval reply', error);
         })
         .finally(() => {
@@ -616,7 +616,7 @@ export class DingtalkHarnessBridge {
     } catch {
       increment(this.#status, 'messagesRejected');
       this.#status.lastRejectedAt = new Date().toISOString();
-      this.#status.lastError = '钉钉消息没有安全的回复地址。';
+      this.#status.lastError = t('钉钉消息没有安全的回复地址。');
       return;
     }
 
@@ -633,23 +633,23 @@ export class DingtalkHarnessBridge {
     let cardStarted = false;
     try {
       if (!text && !hasImages && !hasFiles) {
-        await this.#send(sessionWebhook, '目前支持文字、图片和文件消息。');
+        await this.#send(sessionWebhook, t('目前支持文字、图片和文件消息。'));
         return;
       }
 
       const command = text.toLowerCase();
       if (isPlainText && !hasImages && !hasFiles && command === '/help') {
-        await this.#send(sessionWebhook, HELP_TEXT);
+        await this.#send(sessionWebhook, helpText());
         return;
       }
       if (isPlainText && !hasImages && !hasFiles && command === '/status') {
         await this.#harness.ensureRunning({ signal: this.#signal });
-        await this.#send(sessionWebhook, '钉钉机器人与 DeepSeek Harness 连接正常。');
+        await this.#send(sessionWebhook, t('钉钉机器人与 DeepSeek Harness 连接正常。'));
         return;
       }
       if (isPlainText && !hasImages && !hasFiles && command === '/new') {
         await this.#state.clearSession(key);
-        await this.#send(sessionWebhook, '已开启新会话。请发送你的问题。');
+        await this.#send(sessionWebhook, t('已开启新会话。请发送你的问题。'));
         return;
       }
       const workspaceCommand = isPlainText && !hasImages && !hasFiles
@@ -689,7 +689,7 @@ export class DingtalkHarnessBridge {
           signal: this.#signal,
           logger: this.#logger,
         });
-        cardStarted = await cardStream.start(CARD_INITIAL_TEXT);
+        cardStarted = await cardStream.start(t(CARD_INITIAL_TEXT));
       }
       const { answer, artifacts = [] } = await askInWorkspaceSession({
         harness: this.#harness,
@@ -717,7 +717,7 @@ export class DingtalkHarnessBridge {
       });
       const answerText = typeof answer === 'string' && answer.trim()
         ? answer
-        : artifacts.length > 0 ? '结果文件已生成。' : answer;
+        : artifacts.length > 0 ? t('结果文件已生成。') : answer;
       let textDeliveryError = null;
       let textReceipt = null;
       let streamed = false;
@@ -752,11 +752,11 @@ export class DingtalkHarnessBridge {
       return delivery.receipt;
     } catch (error) {
       if (error?.code === 'turn-stopped') {
-        if (cardStarted) await cardStream.finish('已停止。').catch(() => undefined);
+        if (cardStarted) await cardStream.finish(t('已停止。')).catch(() => undefined);
         return;
       }
       if (this.#signal?.aborted) return;
-      this.#status.lastError = '钉钉消息处理失败。';
+      this.#status.lastError = t('钉钉消息处理失败。');
       this.#logger.error?.(
         '[dsh-dingtalk] failed to process an inbound message',
         safeErrorDiagnostic(error),
@@ -764,7 +764,7 @@ export class DingtalkHarnessBridge {
       try {
         const errorText = inboundFileUserMessage(error)
           ?? dingtalkImageErrorUserMessage(error)
-          ?? CARD_ERROR_TEXT;
+          ?? t(CARD_ERROR_TEXT);
         const streamed = cardStarted && await cardStream.finish(errorText);
         if (!streamed) await this.#send(sessionWebhook, errorText);
       } catch {
@@ -802,14 +802,14 @@ export class DingtalkHarnessBridge {
     } catch {
       increment(this.#status, 'messagesRejected');
       this.#status.lastRejectedAt = new Date().toISOString();
-      this.#status.lastError = '钉钉消息没有安全的回复地址。';
+      this.#status.lastError = t('钉钉消息没有安全的回复地址。');
       return;
     }
 
     const text = message?.msgtype === 'text' ? nonEmptyString(message?.text?.content) : null;
     if (!text) {
       try {
-        await this.#send(sessionWebhook, '请用文字回答当前问题。');
+        await this.#send(sessionWebhook, t('请用文字回答当前问题。'));
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to reject a non-text interaction reply');
       }
@@ -820,7 +820,7 @@ export class DingtalkHarnessBridge {
     if (!pending || pending !== expected || pending.submitting) {
       if (claimed && (!pending || pending !== expected)) {
         try {
-          await this.#send(sessionWebhook, INTERACTION_RESOLVED_TEXT);
+          await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT));
         } catch {
           this.#logger.error?.('[dsh-dingtalk] failed to send an expired interaction notice');
         }
@@ -836,7 +836,7 @@ export class DingtalkHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch {
-        this.#status.lastError = '钉钉交互问题发送失败。';
+        this.#status.lastError = t('钉钉交互问题发送失败。');
         this.#logger.error?.('[dsh-dingtalk] failed to retry an interaction question');
         pending.interaction.reconnect?.();
       }
@@ -855,7 +855,7 @@ export class DingtalkHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch {
-        this.#status.lastError = '钉钉交互问题发送失败。';
+        this.#status.lastError = t('钉钉交互问题发送失败。');
         this.#logger.error?.('[dsh-dingtalk] failed to send the next interaction question');
         pending.interaction.reconnect?.();
       }
@@ -879,7 +879,7 @@ export class DingtalkHarnessBridge {
       if (error?.code === 'interaction-not-pending') {
         this.#clearPendingInteraction(key, pending.interactionId);
         try {
-          await this.#send(sessionWebhook, INTERACTION_RESOLVED_TEXT);
+          await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT));
         } catch {
           this.#logger.error?.('[dsh-dingtalk] failed to send an expired interaction notice');
         }
@@ -888,10 +888,10 @@ export class DingtalkHarnessBridge {
       pending.submitting = false;
       pending.answers.pop();
       pending.index -= 1;
-      this.#status.lastError = '回答提交失败。';
+      this.#status.lastError = t('回答提交失败。');
       this.#logger.error?.('[dsh-dingtalk] failed to answer a Harness interaction');
       try {
-        await this.#send(sessionWebhook, '回答提交失败，请重新发送当前问题的答案。');
+        await this.#send(sessionWebhook, t('回答提交失败，请重新发送当前问题的答案。'));
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to send an interaction retry notice');
       }
@@ -937,7 +937,7 @@ export class DingtalkHarnessBridge {
         },
       });
       try {
-        await this.#send(sessionWebhook, '检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。');
+        await this.#send(sessionWebhook, t('检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。'));
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to send an interaction recovery notice');
       }
@@ -1023,7 +1023,7 @@ export class DingtalkHarnessBridge {
       return;
     }
     try {
-      await this.#send(sessionWebhook, INTERACTION_RESOLVED_TEXT);
+      await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT));
     } catch {
       this.#logger.error?.('[dsh-dingtalk] failed to send an expired interaction notice');
     }
@@ -1084,70 +1084,39 @@ export class DingtalkHarnessBridge {
   }
 
   async #deliverArtifacts(target, sessionWebhook, replyTo, artifacts, 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('DingTalk 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({
-          clientId: this.#clientId,
-          clientSecret: this.#clientSecret,
-          target,
-          file,
-          signal: this.#signal,
-        });
-        receipts.push(createDeliveryReceipt({
-          deliveryId: file.deliveryKey,
-          presentation: 'dingtalk-file',
-          providerMessageIds: dingtalkFileProviderIds(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-dingtalk] result file delivery failed (${error?.code ?? 'unknown'})`,
-        );
-        let noticeSent = false;
-        const providerMessageIds = await this.#send(
-          sessionWebhook,
-          artifactFailureText(artifact?.fileName, error),
-        ).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 ? 'dingtalk-text-and-files' : 'dingtalk-files',
-            receipts,
-          });
-    return { receipt, userVisible };
+    const sendArtifact = async (method, file) => dingtalkFileProviderIds(
+      await this.#api[method]({
+        clientId: this.#clientId,
+        clientSecret: this.#clientSecret,
+        target,
+        file,
+        signal: this.#signal,
+      }),
+    );
+    const delivery = await deliverOutboundArtifacts({
+      artifacts,
+      baseReceipt,
+      deliveryId: replyTo,
+      aggregatePresentation: baseReceipt ? 'dingtalk-text-and-files' : 'dingtalk-files',
+      channelKey: 'dingtalk',
+      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(
+        sessionWebhook,
+        artifactFailureText(artifact?.fileName, error),
+      ),
+      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 };
   }
 }