@xmanrui/dsh-im 1.4.0 → 2.0.0

package/src/channels/shared/text-harness-bridge.mjs

@@ -1,3 +1,4 @@
+import { t } from './i18n.mjs';
 import { runWorkspaceCommand } from './workspace-command.mjs';
 import { runCompactCommand } from './compact-command.mjs';
 import {
@@ -32,14 +33,10 @@ import {
   harnessQuestionText,
   validHarnessQuestion,
 } from './harness-question.mjs';
+import { deliverOutboundArtifacts } from './semantic/artifact-delivery.mjs';
 import {
-  materializeOutboundArtifact,
-  releaseOutboundArtifact,
-} from './semantic/artifact.mjs';
-import {
-  createArtifactFailureReceipt,
   createDeliveryReceipt,
-  mergeDeliveryReceipts,
+  createTextDeliveryBlock,
   providerMessageIdsFor,
 } from './semantic/delivery.mjs';
 
@@ -59,38 +56,38 @@ function canClaimInteractionReply(message, pending, senderId) {
 }
 
 function artifactFailureText(fileName, error, descriptor) {
-  const name = String(fileName ?? '结果文件')
+  const name = String(fileName ?? t('结果文件'))
     .replace(/[\r\n]+/g, ' ')
     .trim()
-    .slice(0, 255) || '结果文件';
+    .slice(0, 255) || t('结果文件');
   switch (error?.code) {
     case 'artifact-delivery-uncertain':
-      return `结果文件「${name}」的发送结果未能确认，请先检查聊天内是否已收到，不要立即重试。`;
+      return t('结果文件「{name}」的发送结果未能确认，请先检查聊天内是否已收到，不要立即重试。', { name });
     case 'artifact-permission-required':
       if (descriptor?.key === 'slack') {
-        return `结果文件「${name}」已生成，但 Slack 应用缺少 files:write 权限。请更新 Manifest、重新安装应用并重新连接机器人后重试。`;
+        return t('结果文件「{name}」已生成，但 Slack 应用缺少 files:write 权限。请更新 Manifest、重新安装应用并重新连接机器人后重试。', { name });
       }
       if (descriptor?.key === 'discord') {
-        return `结果文件「${name}」已生成，但机器人缺少 Discord 的 Send Messages、Attach Files 或 Read Message History 权限。`;
+        return t('结果文件「{name}」已生成，但机器人缺少 Discord 的 Send Messages、Attach Files 或 Read Message History 权限。', { name });
       }
       if (descriptor?.key === 'telegram') {
-        return `结果文件「${name}」已生成，但 Telegram 不允许机器人在当前聊天发送文档，请检查聊天权限。`;
+        return t('结果文件「{name}」已生成，但 Telegram 不允许机器人在当前聊天发送文档，请检查聊天权限。', { name });
       }
-      return `结果文件「${name}」已生成，但当前机器人没有文件发送权限，请检查渠道权限。`;
+      return t('结果文件「{name}」已生成，但当前机器人没有文件发送权限，请检查渠道权限。', { name });
     case 'artifact-too-large':
-      return `结果文件「${name}」超过当前渠道大小上限，未发送。`;
+      return t('结果文件「{name}」超过当前渠道大小上限，未发送。', { name });
     case 'artifact-empty':
-      return `结果文件「${name}」为空，未发送。`;
+      return t('结果文件「{name}」为空，未发送。', { name });
     case 'artifact-invalid':
     case 'artifact-changed':
     case 'artifact-unavailable':
-      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 });
     default:
-      return `结果文件「${name}」已生成，但当前渠道暂时未能发送，请稍后重试。`;
+      return t('结果文件「{name}」已生成，但当前渠道暂时未能发送，请稍后重试。', { name });
   }
 }
 
@@ -325,7 +322,7 @@ export class TextHarnessBridge {
       if (error?.code === 'turn-stopped' || this.#signal?.aborted) return;
       this.#status.lastError = error?.message ?? String(error);
       this.#logger.error?.(`[dsh-im:${this.#descriptor.key}] failed to process a command:`, error);
-      await this.#bot.sendText(target, '消息处理失败，请稍后重试。').catch(() => undefined);
+      await this.#bot.sendText(target, t('消息处理失败，请稍后重试。')).catch(() => undefined);
     }
   }
 
@@ -333,79 +330,35 @@ export class TextHarnessBridge {
     return sendRememberedConnectionTest({
       state: this.#state,
       text,
-      channelLabel: `${this.#descriptor.label}机器人`,
+      channelLabel: t('{label}机器人', { label: this.#descriptor.label }),
       send: (target, message) => this.#bot.sendText(target, message),
     });
   }
 
   async #deliverArtifacts(target, replyTo, artifacts = [], baseReceipt) {
-    const receipts = baseReceipt ? [baseReceipt] : [];
-    let userVisible = Boolean(baseReceipt);
-    for (const artifact of artifacts) {
-      this.#signal?.throwIfAborted();
-      try {
-        if (typeof this.#bot.sendFile !== 'function') {
-          const unavailable = new Error('Native file delivery is unavailable');
-          unavailable.code = 'artifact-provider-unavailable';
-          throw unavailable;
-        }
-        const file = await materializeOutboundArtifact(artifact, {
-          signal: this.#signal,
-        });
-        this.#signal?.throwIfAborted();
-        const result = await this.#bot.sendFile(target, file);
-        receipts.push(createDeliveryReceipt({
-          deliveryId: file.deliveryKey,
-          presentation: `${this.#descriptor.key}-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-im:${this.#descriptor.key}] result file delivery failed (${error?.code ?? 'unknown'})`,
-        );
-        let providerMessageIds = [];
-        let noticeSent = false;
-        try {
-          const notice = await this.#bot.sendText(
-            target,
-            artifactFailureText(artifact?.fileName, error, this.#descriptor),
-          );
-          providerMessageIds = providerMessageIdsFor(notice);
-          noticeSent = true;
-        } catch {
-          this.#logger.warn?.(
-            `[dsh-im:${this.#descriptor.key}] unable to send the safe result-file failure notice`,
-          );
-        }
-        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
-              ? `${this.#descriptor.key}-text-and-files`
-              : `${this.#descriptor.key}-files`,
-            receipts,
-          });
-    return { receipt, userVisible };
+    const delivery = await deliverOutboundArtifacts({
+      artifacts,
+      baseReceipt,
+      deliveryId: replyTo,
+      channelKey: this.#descriptor.key,
+      signal: this.#signal,
+      sendImage: typeof this.#bot.sendImage === 'function'
+        ? (file) => this.#bot.sendImage(target, file)
+        : undefined,
+      sendFile: typeof this.#bot.sendFile === 'function'
+        ? (file) => this.#bot.sendFile(target, file)
+        : undefined,
+      sendFailureNotice: (artifact, error) => this.#bot.sendText(
+        target,
+        artifactFailureText(artifact?.fileName, error, this.#descriptor),
+      ),
+      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 };
   }
 
   async #process(message, messageId, senderId, conversationKey, {
@@ -421,6 +374,7 @@ export class TextHarnessBridge {
     const target = message.replyTarget;
     const text = cleanText(message.content);
     let stream = null;
+    let semanticStream = false;
     try {
       this.#signal?.throwIfAborted();
       if (message.kind === 'group' && message.addressed !== true) {
@@ -431,38 +385,38 @@ export class TextHarnessBridge {
       const hasImages = hasInboundImages(message);
       const hasFiles = hasInboundFiles(message);
       if (!text && !hasImages && !hasFiles) {
-        await this.#bot.sendText(target, '目前支持文字、图片和文件消息。');
+        await this.#bot.sendText(target, t('目前支持文字、图片和文件消息。'));
         return;
       }
       const command = text.toLowerCase();
       if (!hasImages && !hasFiles && command === '/help') {
         await this.#bot.sendText(target, [
-          `${this.#descriptor.label}机器人已连接 DeepSeek Harness。`,
+          t('{label}机器人已连接 DeepSeek Harness。', { label: this.#descriptor.label }),
           '',
-          '直接发送文字、图片或文件即可继续当前会话。',
-          '/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'));
         return;
       }
       if (!hasImages && !hasFiles && command === '/status') {
         await this.#harness.ensureRunning({ signal: this.#signal });
-        await this.#bot.sendText(target, `${this.#descriptor.label}机器人与 DeepSeek Harness 连接正常。`);
+        await this.#bot.sendText(target, t('{label}机器人与 DeepSeek Harness 连接正常。', { label: this.#descriptor.label }));
         return;
       }
       const workspaceCommand = !hasImages && !hasFiles
@@ -476,7 +430,7 @@ export class TextHarnessBridge {
       }
       if (!hasImages && !hasFiles && command === '/new') {
         await this.#state.clearSession(conversationKey);
-        await this.#bot.sendText(target, '已开启新会话。请发送你的问题。');
+        await this.#bot.sendText(target, t('已开启新会话。请发送你的问题。'));
         return;
       }
       const compactCommand = !hasImages && !hasFiles
@@ -497,7 +451,17 @@ export class TextHarnessBridge {
         this.#logger.warn?.(`[dsh-im:${this.#descriptor.key}] typing indicator failed:`, error);
       });
       let streamFinished = false;
-      if (typeof this.#bot.openStream === 'function') {
+      if (typeof this.#bot.openDeliveryStream === 'function') {
+        try {
+          stream = await this.#bot.openDeliveryStream(target);
+          semanticStream = true;
+        } catch (error) {
+          this.#logger.warn?.(
+            `[dsh-im:${this.#descriptor.key}] unable to start a semantic reply stream; using final delivery:`,
+            error,
+          );
+        }
+      } else if (typeof this.#bot.openStream === 'function') {
         try {
           stream = await this.#bot.openStream(target);
         } catch (error) {
@@ -524,35 +488,48 @@ export class TextHarnessBridge {
           control: { owner: this, key: conversationKey },
           onUpdate: stream ? async (update) => {
             const progress = update.type === 'text' ? update.text
-              : update.type === 'tool' ? `正在使用${update.name}…` : update.text;
-            if (progress) await stream.update(progress);
+              : update.type === 'tool' ? t('正在使用{name}…', { name: update.name }) : update.text;
+            if (progress) {
+              const format = update.type === 'text' ? 'markdown' : 'plain';
+              await stream.update(semanticStream
+                ? createTextDeliveryBlock(progress, format)
+                : progress);
+            }
           } : undefined,
           onInteraction: (interaction) => this.#handleInteraction(interaction, {
             key: conversationKey,
             actor: senderId,
             target,
-            requiresMention: message.kind === 'group',
+            requiresMention: message.kind === 'group' && message.requiresMention !== false,
           }),
           onInteractionResolved: (resolution) => this.#handleInteractionResolved(resolution),
           files: message.files,
         },
       });
-      const visibleAnswer = !cleanText(answer) && artifacts.length > 0
-        ? FILE_ONLY_COMPLETION_TEXT
+      const fileOnlyCompletion = !cleanText(answer) && artifacts.length > 0;
+      const visibleAnswer = fileOnlyCompletion
+        ? t(FILE_ONLY_COMPLETION_TEXT)
         : answer;
+      const answerFormat = fileOnlyCompletion ? 'plain' : 'markdown';
       let textDeliveryError = null;
       let textReceipt = null;
       if (stream) {
         try {
-          const result = await stream.finish(visibleAnswer);
+          const result = await stream.finish(semanticStream
+            ? createTextDeliveryBlock(visibleAnswer, answerFormat)
+            : visibleAnswer);
           streamFinished = true;
           textReceipt = createDeliveryReceipt({
             deliveryId: messageId,
-            presentation: `${this.#descriptor.key}-stream`,
+            presentation: result?.presentation
+              ?? stream.presentation
+              ?? `${this.#descriptor.key}-stream`,
             providerMessageIds: [
               ...providerMessageIdsFor(stream),
               ...providerMessageIdsFor(result),
             ],
+            deliveryOutcome: result?.deliveryOutcome,
+            reason: result?.reason,
           });
         } catch (error) {
           stream.cancel?.();
@@ -564,40 +541,74 @@ export class TextHarnessBridge {
       }
       if (!streamFinished) {
         try {
-          const result = await this.#bot.sendText(target, visibleAnswer);
+          const result = typeof this.#bot.sendDelivery === 'function'
+            ? await this.#bot.sendDelivery(
+                target,
+                createTextDeliveryBlock(visibleAnswer, answerFormat),
+              )
+            : await this.#bot.sendText(target, visibleAnswer);
           textReceipt = createDeliveryReceipt({
             deliveryId: messageId,
-            presentation: `${this.#descriptor.key}-text`,
+            presentation: result?.presentation ?? `${this.#descriptor.key}-text`,
             providerMessageIds: providerMessageIdsFor(result),
+            deliveryOutcome: result?.deliveryOutcome,
+            reason: result?.reason,
           });
         } catch (error) {
           textDeliveryError = error;
         }
       }
+      if (textReceipt?.deliveryOutcome === 'failed') {
+        const reason = textReceipt.reason ?? 'text-delivery-failed';
+        textDeliveryError = new Error(`Final text delivery failed (${reason})`);
+        textDeliveryError.code = reason;
+      }
       // A failed final text must not discard an already registered result file.
       // Settle the independent attachment path before surfacing the text error.
       const delivery = await this.#deliverArtifacts(target, messageId, artifacts, textReceipt);
-      if (textDeliveryError && !delivery.userVisible) throw textDeliveryError;
-      this.#status.messagesReplied += 1;
-      this.#status.lastReplyAt = new Date().toISOString();
-      this.#status.lastError = null;
+      if (textDeliveryError && !delivery.userVisible) {
+        textDeliveryError.deliveryReceipt = delivery.receipt;
+        throw textDeliveryError;
+      }
+      if (delivery.userVisible) {
+        this.#status.messagesReplied += 1;
+        this.#status.lastReplyAt = new Date().toISOString();
+        this.#status.lastError = null;
+      }
       return delivery.receipt;
     } catch (error) {
       if (error?.code === 'turn-stopped') {
         if (stream) {
           try {
-            await stream.finish('已停止。');
+            await stream.finish(t('已停止。'));
           } catch {
             stream.cancel?.();
           }
         }
         return;
       }
-      stream?.cancel?.();
-      if (this.#signal?.aborted) return;
+      if (this.#signal?.aborted) {
+        stream?.cancel?.();
+        return;
+      }
       this.#status.lastError = error?.message ?? String(error);
+      const presentStreamFailure = async (text) => {
+        if (typeof stream?.fail !== 'function') return false;
+        try {
+          const result = await stream.fail(text);
+          return Boolean(result) && result.deliveryOutcome !== 'failed';
+        } catch (streamError) {
+          this.#logger.warn?.(
+            `[dsh-im:${this.#descriptor.key}] unable to finalize the failed stream:`,
+            streamError,
+          );
+          return false;
+        }
+      };
       const imageErrorMessage = imagePromptUserMessage(error);
       if (imageErrorMessage) {
+        if (await presentStreamFailure(imageErrorMessage)) return;
+        stream?.cancel?.();
         try {
           await this.#bot.sendText(target, imageErrorMessage);
         } catch (sendError) {
@@ -610,6 +621,8 @@ export class TextHarnessBridge {
       }
       const fileErrorMessage = inboundFileUserMessage(error);
       if (fileErrorMessage) {
+        if (await presentStreamFailure(fileErrorMessage)) return;
+        stream?.cancel?.();
         try {
           await this.#bot.sendText(target, fileErrorMessage);
         } catch (sendError) {
@@ -621,14 +634,19 @@ export class TextHarnessBridge {
         return;
       }
       this.#logger.error?.(`[dsh-im:${this.#descriptor.key}] failed to process a message:`, error);
+      if (await presentStreamFailure('消息处理失败，请稍后重试。')) {
+        return error.deliveryReceipt;
+      }
+      stream?.cancel?.();
       try {
-        await this.#bot.sendText(target, '消息处理失败，请稍后重试。');
+        await this.#bot.sendText(target, t('消息处理失败，请稍后重试。'));
       } catch (sendError) {
         this.#logger.error?.(
           `[dsh-im:${this.#descriptor.key}] failed to send the safe error reply:`,
           sendError,
         );
       }
+      return error.deliveryReceipt;
     } finally {
       await Promise.allSettled([
         this.#cancelPendingInteraction(conversationKey),
@@ -664,7 +682,7 @@ export class TextHarnessBridge {
     const text = cleanText(message.content);
     if (!text || hasInboundImages(message) || hasInboundFiles(message)) {
       try {
-        await this.#bot.sendText(target, '请用文字回答当前问题。');
+        await this.#bot.sendText(target, t('请用文字回答当前问题。'));
       } catch (error) {
         this.#logger.error?.(
           `[dsh-im:${this.#descriptor.key}] failed to reject a non-text interaction reply:`,
@@ -692,7 +710,7 @@ export class TextHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch (error) {
-        this.#status.lastError = `${this.#descriptor.label}交互问题发送失败。`;
+        this.#status.lastError = t('{label}交互问题发送失败。', { label: this.#descriptor.label });
         this.#logger.error?.(
           `[dsh-im:${this.#descriptor.key}] failed to retry an interaction question:`,
           error,
@@ -730,7 +748,7 @@ export class TextHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch (error) {
-        this.#status.lastError = `${this.#descriptor.label}交互问题发送失败。`;
+        this.#status.lastError = t('{label}交互问题发送失败。', { label: this.#descriptor.label });
         this.#logger.error?.(
           `[dsh-im:${this.#descriptor.key}] failed to send the next interaction question:`,
           error,
@@ -756,7 +774,7 @@ export class TextHarnessBridge {
         this.#clearPendingInteraction(key, pending.interactionId);
         if (this.#signal?.aborted) return;
         try {
-          await this.#bot.sendText(target, INTERACTION_RESOLVED_TEXT);
+          await this.#bot.sendText(target, t(INTERACTION_RESOLVED_TEXT));
         } catch (sendError) {
           this.#logger.error?.(
             `[dsh-im:${this.#descriptor.key}] failed to send an expired interaction notice:`,
@@ -769,13 +787,13 @@ export class TextHarnessBridge {
       pending.submitting = false;
       pending.answers.pop();
       pending.index -= 1;
-      this.#status.lastError = '回答提交失败。';
+      this.#status.lastError = t('回答提交失败。');
       this.#logger.error?.(
         `[dsh-im:${this.#descriptor.key}] failed to answer a Harness interaction:`,
         error,
       );
       try {
-        await this.#bot.sendText(target, '回答提交失败，请重新发送当前问题的答案。');
+        await this.#bot.sendText(target, t('回答提交失败，请重新发送当前问题的答案。'));
       } catch (sendError) {
         this.#logger.error?.(
           `[dsh-im:${this.#descriptor.key}] failed to send an interaction retry notice:`,
@@ -822,7 +840,7 @@ export class TextHarnessBridge {
       try {
         await this.#bot.sendText(
           target,
-          '检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。',
+          t('检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。'),
         );
       } catch (error) {
         this.#logger.error?.(
@@ -923,7 +941,7 @@ export class TextHarnessBridge {
       this.#status.lastMessageAt = new Date().toISOString();
     }
     try {
-      await this.#bot.sendText(message.replyTarget, INTERACTION_RESOLVED_TEXT);
+      await this.#bot.sendText(message.replyTarget, t(INTERACTION_RESOLVED_TEXT));
     } catch (error) {
       this.#logger.error?.(
         `[dsh-im:${this.#descriptor.key}] failed to send an expired interaction notice:`,

package/src/channels/shared/token-bot-controller.mjs

@@ -1,4 +1,5 @@
 import { connectionTestMessage } from './connection-test.mjs';
+import { t } from './i18n.mjs';
 
 function cleanString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
@@ -70,7 +71,9 @@ export class TokenBotController {
         if (!token) {
           this.#errors.set(config.botId, safeError(
             'missing-token',
-            `${this.#descriptor.label}机器人凭据缺失，请移除后重新接入。`,
+            t('{label}机器人凭据缺失，请移除后重新接入。', {
+              label: this.#descriptor.label,
+            }),
           ));
           return;
         }
@@ -80,7 +83,9 @@ export class TokenBotController {
         } catch (error) {
           this.#errors.set(config.botId, safeError(
             'connection-failed',
-            `${this.#descriptor.label}连接未就绪，插件会自动重试。`,
+            t('{label}连接未就绪，插件会自动重试。', {
+              label: this.#descriptor.label,
+            }),
           ));
           this.#logger.warn?.(
             `[dsh-im:${this.#descriptor.key}] bot ${config.botId} failed to initialize:`,
@@ -129,7 +134,9 @@ export class TokenBotController {
       } catch (error) {
         this.#errors.set(identity.botId, safeError(
           'connection-failed',
-          `${this.#descriptor.label}机器人已接入，消息连接暂未就绪。`,
+          t('{label}机器人已接入，消息连接暂未就绪。', {
+            label: this.#descriptor.label,
+          }),
         ));
         this.#logger.warn?.(
           `[dsh-im:${this.#descriptor.key}] bot ${identity.botId} credential connection failed:`,
@@ -153,7 +160,9 @@ export class TokenBotController {
       } catch (error) {
         this.#errors.set(botId, safeError(
           'connection-failed',
-          `${this.#descriptor.label}连接仍未就绪，请稍后重试。`,
+          t('{label}连接仍未就绪，请稍后重试。', {
+            label: this.#descriptor.label,
+          }),
         ));
         throw error;
       } finally {
@@ -181,7 +190,9 @@ export class TokenBotController {
       } catch (error) {
         this.#errors.set(botId, safeError(
           'connection-failed',
-          `${this.#descriptor.label}连接仍未就绪，请稍后重试。`,
+          t('{label}连接仍未就绪，请稍后重试。', {
+            label: this.#descriptor.label,
+          }),
         ));
         throw error;
       } finally {
@@ -197,14 +208,19 @@ export class TokenBotController {
     return this.#withBotTransition(botId, async () => {
       const runtime = this.#runtimes.get(botId);
       if (!runtime?.status?.ready || typeof runtime.sendConnectionTest !== 'function') {
-        const error = new Error(`${this.#descriptor.label}机器人尚未连接`);
+        const error = new Error(t('{label}机器人尚未连接', {
+          label: this.#descriptor.label,
+        }));
         error.code = 'test-target-unavailable';
         throw error;
       }
-      const cardLabel = `${config.name}（${this.#maskPlatformId(config.platformId)}）`;
+      const cardLabel = t('{name}（{id}）', {
+        name: config.name,
+        id: this.#maskPlatformId(config.platformId),
+      });
       await runtime.sendConnectionTest(connectionTestMessage(
         cardLabel,
-        `${this.#descriptor.label}机器人`,
+        t('{label}机器人', { label: this.#descriptor.label }),
       ));
       return { sent: true };
     });
@@ -260,9 +276,14 @@ export class TokenBotController {
         },
         health: {
           status: connected ? 'healthy' : state === 'error' ? 'error' : 'offline',
-          summary: connected ? `${this.#descriptor.label}${this.#descriptor.connectionLabel}运行正常`
-            : state === 'error' ? `${this.#descriptor.label}连接未就绪，插件会自动重试`
-              : `${this.#descriptor.label}连接当前离线`,
+          summary: connected ? t('{label}{connectionLabel}运行正常', {
+            label: this.#descriptor.label,
+            connectionLabel: t(this.#descriptor.connectionLabel),
+          })
+            : state === 'error' ? t('{label}连接未就绪，插件会自动重试', {
+              label: this.#descriptor.label,
+            })
+              : t('{label}连接当前离线', { label: this.#descriptor.label }),
           lastCheckedAt: runtimeStatus?.lastCheckedAt ?? null,
           lastConnectedAt: runtimeStatus?.lastConnectedAt ?? null,
         },