@xmanrui/dsh-im 1.5.0 → 2.0.0

package/src/channels/shared/semantic/delivery.mjs

@@ -1,6 +1,8 @@
 export const DELIVERY_RECEIPT_SCHEMA_VERSION = 1;
 
 const ARTIFACT_OUTCOMES = new Set(['sent', 'rejected', 'failed', 'unknown']);
+const DELIVERY_OUTCOMES = new Set(['sent', 'failed', 'unknown']);
+const TEXT_FORMATS = new Set(['plain', 'markdown']);
 const REJECTED_ARTIFACT_ERRORS = new Set([
   'artifact-changed',
   'artifact-context-required',
@@ -52,6 +54,24 @@ function requiredString(value, name) {
   return value;
 }
 
+export function createTextDeliveryBlock(value, format = 'plain') {
+  const block = typeof value === 'string'
+    ? { kind: 'text', text: value, format }
+    : value;
+  if (!block || typeof block !== 'object' || Array.isArray(block)
+    || block.kind !== 'text' || typeof block.text !== 'string' || !block.text.trim()) {
+    throw new TypeError('text delivery block must contain non-empty text');
+  }
+  if (!TEXT_FORMATS.has(block.format)) {
+    throw new TypeError('text delivery format must be plain or markdown');
+  }
+  return Object.freeze({
+    kind: 'text',
+    text: block.text,
+    format: block.format,
+  });
+}
+
 function providerIds(values) {
   if (!Array.isArray(values)) throw new TypeError('providerMessageIds must be an array');
   const ids = [];
@@ -98,12 +118,22 @@ export function createDeliveryReceipt({
   presentation,
   providerMessageIds = [],
   artifacts = [],
+  deliveryOutcome,
+  reason,
 }) {
+  if (deliveryOutcome !== undefined && !DELIVERY_OUTCOMES.has(deliveryOutcome)) {
+    throw new TypeError('deliveryOutcome must be sent, failed, or unknown');
+  }
+  const normalizedReason = reason === undefined
+    ? undefined
+    : requiredString(reason, 'delivery reason');
   return Object.freeze({
     schemaVersion: DELIVERY_RECEIPT_SCHEMA_VERSION,
     deliveryId: requiredString(deliveryId, 'deliveryId'),
     presentation: requiredString(presentation, 'presentation'),
     providerMessageIds: providerIds(providerMessageIds),
+    ...(deliveryOutcome === undefined ? {} : { deliveryOutcome }),
+    ...(normalizedReason === undefined ? {} : { reason: normalizedReason }),
     artifacts: artifactResults(artifacts),
   });
 }
@@ -137,11 +167,17 @@ export function mergeDeliveryReceipts({ deliveryId, presentation, receipts }) {
   }
   const messageIds = [];
   const artifacts = new Map();
+  let deliveryOutcome;
+  let reason;
   for (const receipt of receipts) {
     if (!receipt || receipt.schemaVersion !== DELIVERY_RECEIPT_SCHEMA_VERSION) {
       throw new TypeError('receipt must use DeliveryReceipt schema version 1');
     }
     messageIds.push(...(receipt.providerMessageIds ?? []));
+    if (deliveryOutcome === undefined && receipt.deliveryOutcome !== undefined) {
+      deliveryOutcome = receipt.deliveryOutcome;
+      reason = receipt.reason;
+    }
     for (const artifact of receipt.artifacts ?? []) {
       artifacts.set(artifact.artifactId, artifact);
     }
@@ -150,6 +186,8 @@ export function mergeDeliveryReceipts({ deliveryId, presentation, receipts }) {
     deliveryId,
     presentation,
     providerMessageIds: messageIds,
+    deliveryOutcome,
+    reason,
     artifacts: [...artifacts.values()],
   });
 }

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 {
@@ -35,6 +36,7 @@ import {
 import { deliverOutboundArtifacts } from './semantic/artifact-delivery.mjs';
 import {
   createDeliveryReceipt,
+  createTextDeliveryBlock,
   providerMessageIdsFor,
 } from './semantic/delivery.mjs';
 
@@ -54,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 });
   }
 }
 
@@ -320,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);
     }
   }
 
@@ -328,7 +330,7 @@ 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),
     });
   }
@@ -372,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) {
@@ -382,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
@@ -427,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
@@ -448,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) {
@@ -475,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?.();
@@ -515,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) {
@@ -561,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) {
@@ -572,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),
@@ -615,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:`,
@@ -643,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,
@@ -681,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,
@@ -707,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:`,
@@ -720,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:`,
@@ -773,7 +840,7 @@ export class TextHarnessBridge {
       try {
         await this.#bot.sendText(
           target,
-          '检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。',
+          t('检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。'),
         );
       } catch (error) {
         this.#logger.error?.(
@@ -874,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,
         },