@xmanrui/dsh-im 2.4.0 → 2.5.0

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

@@ -11,6 +11,7 @@ import {
   connectionTestTargetUnavailable,
 } from '../shared/connection-test.mjs';
 import { t } from '../shared/i18n.mjs';
+import { publicMessageFailure } from '../shared/message-failure.mjs';
 
 const ACTIVE_ATTEMPT_STATES = new Set(['starting', 'pending', 'connecting']);
 const TERMINAL_ATTEMPT_STATES = new Set(['connected', 'expired', 'failed', 'cancelled']);
@@ -516,6 +517,7 @@ export class DingtalkController {
           messagesReceived: Number(currentStatus.messagesReceived) || 0,
           messagesReplied: Number(currentStatus.messagesReplied) || 0,
         },
+        lastMessageError: publicMessageFailure(currentStatus.lastMessageError),
         senders: {
           pending,
           approved: config.approvedSenders.map(publicApprovedSender),

package/src/channels/feishu/bridge.mjs

@@ -9,6 +9,7 @@ import {
 } from './message-utils.mjs';
 import {
   hasInboundImages,
+  imagePromptDiagnostic,
   imagePromptUserMessage,
   promptContentForMessage,
 } from '../shared/image-prompt.mjs';
@@ -48,6 +49,12 @@ import { deliverOutboundArtifacts } from '../shared/semantic/artifact-delivery.m
 import {
   createDeliveryReceipt,
 } from '../shared/semantic/delivery.mjs';
+import {
+  channelDeliveryFailure,
+  clearLastMessageFailure,
+  messageFailureText,
+  setLastMessageFailure,
+} from '../shared/message-failure.mjs';
 import {
   MENU_PAGE_SIZE,
   PRESET_FOLLOW_DEFAULT_SENTINEL,
@@ -365,6 +372,7 @@ function ensureStatus(status) {
   status.lastReplyAt ??= null;
   status.lastRejectedAt ??= null;
   status.lastError ??= null;
+  status.lastMessageError ??= null;
 }
 
 export class FeishuHarnessBridge {
@@ -801,6 +809,30 @@ export class FeishuHarnessBridge {
     return current;
   }
 
+  #recordFailure(error, {
+    logLabel = 'operation',
+    logLevel = 'warn',
+    userMessage,
+    reason,
+  } = {}) {
+    this.#status.lastError = error?.message ?? String(error);
+    const failure = setLastMessageFailure(this.#status, error, { userMessage, reason });
+    this.#logger?.[logLevel]?.(
+      `[dsh-feishu] ${logLabel} failed [${failure.referenceId}]:`,
+      error?.message ?? String(error),
+    );
+    return failure;
+  }
+
+  async #sendFailure(chatId, error, options = {}) {
+    const failure = this.#recordFailure(error, options);
+    const text = options.appendMessage
+      ? `${messageFailureText(failure)}\n\n${options.appendMessage}`
+      : messageFailureText(failure);
+    await this.#send(chatId, text).catch(() => undefined);
+    return failure;
+  }
+
   async #handleMessageFailure(event, messageId, processingReaction, error) {
     if (error?.code === 'turn-stopped') {
       await this.#removeProcessingReaction(messageId, processingReaction);
@@ -813,15 +845,21 @@ export class FeishuHarnessBridge {
       await this.#removeProcessingReaction(messageId, processingReaction);
       return;
     }
-    this.#logger.error?.('[dsh-feishu] message handling failed:', error?.message ?? String(error));
-    this.#status.lastError = error?.message ?? String(error);
+    const userMessage = inboundFileUserMessage(error)
+      ?? imagePromptUserMessage(error);
+    const failure = this.#recordFailure(error, {
+      logLabel: 'message handling',
+      logLevel: 'error',
+      userMessage,
+      reason: imagePromptDiagnostic(error)?.reason,
+    });
     await this.#finishReaction(messageId, processingReaction, 'ERROR');
+    const failureText = error?.batchInputMessage
+      ? `${messageFailureText(failure)}\n\n${error.batchInputMessage}`
+      : messageFailureText(failure);
     await this.#send(
       event.message.chat_id,
-      error?.batchInputMessage
-        ?? inboundFileUserMessage(error)
-        ?? imagePromptUserMessage(error)
-        ?? t('处理失败，请稍后重试。如果问题持续，请在 DeepSeek Harness 的飞书插件页面检查连接状态。'),
+      failureText,
     ).catch(() => undefined);
   }
 
@@ -1025,7 +1063,11 @@ export class FeishuHarnessBridge {
     const batchSubmission = event.batchSubmission ?? null;
     let batchAskCompleted = false;
     try {
-      const receipt = await this.#answerWithStream(event, key, message, {
+      const {
+        receipt,
+        artifactSendErrors,
+        textDeliveryErrors = 0,
+      } = await this.#answerWithStream(event, key, message, {
         onAskComplete: batchSubmission
           ? () => {
               batchAskCompleted = this.#batchInputs.complete(
@@ -1038,6 +1080,9 @@ export class FeishuHarnessBridge {
       this.#status.messagesReplied += 1;
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
+      if (textDeliveryErrors === 0 && artifactSendErrors === 0) {
+        clearLastMessageFailure(this.#status);
+      }
       return receipt;
     } catch (error) {
       if (batchSubmission && !batchAskCompleted) {
@@ -1049,6 +1094,9 @@ export class FeishuHarnessBridge {
         if (failed.retained) {
           const batchError = new Error(error?.message ?? String(error), { cause: error });
           batchError.code = error?.code;
+          batchError.providerCode = error?.providerCode;
+          batchError.method = error?.method;
+          if (Number.isInteger(error?.status)) batchError.status = error.status;
           batchError.batchInputMessage = failed.message;
           throw batchError;
         }
@@ -1643,9 +1691,7 @@ export class FeishuHarnessBridge {
       })
       .catch(async (error) => {
         if (this.#signal?.aborted) return;
-        this.#logger.warn?.('[dsh-feishu] card action failed:', error?.message ?? String(error));
-        this.#status.lastError = error?.message ?? String(error);
-        await this.#send(entry.chatId, t('卡片操作失败，请稍后重试。')).catch(() => undefined);
+        await this.#sendFailure(entry.chatId, error, { logLabel: 'card action' });
       })
       .finally(() => {
         if (this.#cardActionInFlight.get(dedupeKey) === tracked) {
@@ -2008,8 +2054,7 @@ export class FeishuHarnessBridge {
         },
       );
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] session list failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取会话列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'session list' });
     }
   }
 
@@ -2026,8 +2071,7 @@ export class FeishuHarnessBridge {
         { key, updateMessageId },
       );
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] workspace list failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取工作区列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'workspace list' });
     }
   }
 
@@ -2038,7 +2082,10 @@ export class FeishuHarnessBridge {
       await this.#send(chatId, t('已绑定会话「{title}」\nID：{id}', { title, id: bound?.sessionId ?? sessionId }));
       await this.#sendMenuCard(key, chatId, { updateMessageId });
     } catch (error) {
-      await this.#send(chatId, t('绑定失败：{message}', { message: safeErrorText(error) }));
+      await this.#sendFailure(chatId, error, {
+        logLabel: 'session binding',
+        userMessage: t('绑定失败：{message}', { message: safeErrorText(error) }),
+      });
     }
   }
 
@@ -2048,7 +2095,10 @@ export class FeishuHarnessBridge {
       await this.#send(chatId, t('工作区已切换为：{workspace}', { workspace: current }));
       await this.#sendMenuCard(key, chatId, { updateMessageId });
     } catch (error) {
-      await this.#send(chatId, t('切换失败：{message}', { message: safeErrorText(error) }));
+      await this.#sendFailure(chatId, error, {
+        logLabel: 'workspace switch',
+        userMessage: t('切换失败：{message}', { message: safeErrorText(error) }),
+      });
     }
   }
 
@@ -2247,8 +2297,7 @@ export class FeishuHarnessBridge {
       catalog._currentId = settings.agentPreset;
       await this.#sendCard(chatId, presetCard(catalog), { key, updateMessageId });
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] preset card failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取预设列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'preset card' });
     }
   }
 
@@ -2273,8 +2322,7 @@ export class FeishuHarnessBridge {
       }
       await this.#sendCard(chatId, modelCard(catalog), { key, updateMessageId });
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] model card failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取模型列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'model card' });
     }
   }
 
@@ -2302,8 +2350,7 @@ export class FeishuHarnessBridge {
       }
       await this.#send(chatId, lines.join('\n'));
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] status text failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取系统状态，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'status text' });
     }
   }
 
@@ -2355,8 +2402,7 @@ export class FeishuHarnessBridge {
 
       await this.#sendCard(chatId, statusCard(info), { key, updateMessageId });
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] status card failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取系统状态，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'status card' });
     }
   }
 
@@ -2381,8 +2427,7 @@ export class FeishuHarnessBridge {
       );
       await this.#send(chatId, result?.message || t('上下文压缩失败。'));
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] compact failed:', error.message, error.code);
-      await this.#send(chatId, t('上下文压缩失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'compact' });
     }
   }
 
@@ -2405,8 +2450,7 @@ export class FeishuHarnessBridge {
       }
       await this.#send(chatId, result?.message || t('/stop 执行完成。'));
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] stop failed:', error.message);
-      await this.#send(chatId, t('停止任务失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'stop' });
     }
   }
 
@@ -2446,8 +2490,7 @@ export class FeishuHarnessBridge {
         if (reply) await this.#send(chatId, reply);
       }
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] preset default failed:', error.message);
-      await this.#send(chatId, t('预设重置失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'preset reset' });
       return;
     }
     try {
@@ -2470,8 +2513,7 @@ export class FeishuHarnessBridge {
         if (reply) await this.#send(chatId, reply);
       }
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] preset select failed:', error.message);
-      await this.#send(chatId, t('预设切换失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'preset selection' });
       return;
     }
     try {
@@ -2503,8 +2545,7 @@ export class FeishuHarnessBridge {
         if (reply) await this.#send(chatId, reply);
       }
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] model select failed:', error.message);
-      await this.#send(chatId, t('模型切换失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'model selection' });
       return;
     }
     try {
@@ -3046,10 +3087,14 @@ export class FeishuHarnessBridge {
             signal: this.#signal,
           })
         : undefined,
-      sendFailureNotice: async (artifact, error) => ({
+      onFailure: (artifact, error) => setLastMessageFailure(this.#status, error, {
+        userMessage: artifactFailureText(artifact?.fileName, error),
+        reason: error?.code,
+      }),
+      sendFailureNotice: async (_artifact, _error, failure) => ({
         messageId: await this.#send(
           chatId,
-          artifactFailureText(artifact?.fileName, error),
+          messageFailureText(failure),
         ),
       }),
       logger: this.#logger,
@@ -3065,11 +3110,13 @@ export class FeishuHarnessBridge {
           presentation: 'feishu-files',
         }),
         failureNoticeVisible: delivery.failureNoticeVisible,
+        artifactSendErrors: delivery.artifactSendErrors,
       };
     }
     return {
       receipt: delivery.receipt,
       failureNoticeVisible: delivery.failureNoticeVisible,
+      artifactSendErrors: delivery.artifactSendErrors,
     };
   }
 
@@ -3110,7 +3157,7 @@ export class FeishuHarnessBridge {
           },
         );
       } catch (error) {
-        textSendError = error;
+        textSendError = channelDeliveryFailure(error);
         this.#logger.warn?.(
           '[dsh-feishu] final text delivery failed; continuing with result files:',
           error,
@@ -3123,8 +3170,11 @@ export class FeishuHarnessBridge {
       if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
         throw textSendError;
       }
+      if (textSendError && delivery.artifactSendErrors === 0) {
+        setLastMessageFailure(this.#status, textSendError);
+      }
       this.#status.streamFallbacks = (this.#status.streamFallbacks ?? 0) + 1;
-      return delivery.receipt;
+      return { ...delivery, textDeliveryErrors: textSendError ? 1 : 0 };
     }
 
     let promptStarted = false;
@@ -3177,7 +3227,7 @@ export class FeishuHarnessBridge {
             },
           );
         } catch (fallbackError) {
-          textSendError = fallbackError;
+          textSendError = channelDeliveryFailure(fallbackError);
           this.#logger.warn?.(
             '[dsh-feishu] fallback text delivery failed; continuing with result files:',
             fallbackError,
@@ -3195,8 +3245,11 @@ export class FeishuHarnessBridge {
         if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
           throw textSendError;
         }
+        if (textSendError && delivery.artifactSendErrors === 0) {
+          setLastMessageFailure(this.#status, textSendError);
+        }
         this.#status.streamFallbacks = (this.#status.streamFallbacks ?? 0) + 1;
-        return delivery.receipt;
+        return { ...delivery, textDeliveryErrors: textSendError ? 1 : 0 };
       }
       if (promptStarted) throw error;
 
@@ -3224,7 +3277,7 @@ export class FeishuHarnessBridge {
           },
         );
       } catch (fallbackError) {
-        textSendError = fallbackError;
+        textSendError = channelDeliveryFailure(fallbackError);
         this.#logger.warn?.(
           '[dsh-feishu] fallback text delivery failed; continuing with result files:',
           fallbackError,
@@ -3237,8 +3290,11 @@ export class FeishuHarnessBridge {
       if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
         throw textSendError;
       }
+      if (textSendError && delivery.artifactSendErrors === 0) {
+        setLastMessageFailure(this.#status, textSendError);
+      }
       this.#status.streamFallbacks = (this.#status.streamFallbacks ?? 0) + 1;
-      return delivery.receipt;
+      return { ...delivery, textDeliveryErrors: textSendError ? 1 : 0 };
     }
     const delivery = await this.#deliverArtifacts(
       chatId,
@@ -3251,7 +3307,7 @@ export class FeishuHarnessBridge {
       }),
     );
     this.#status.streamResponses = (this.#status.streamResponses ?? 0) + 1;
-    return delivery.receipt;
+    return delivery;
   }
 
   async #processInteractionReply(event, messageId, key, expected, processingReaction) {

package/src/channels/feishu/multi-bot-controller.mjs

@@ -1,5 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { connectionTestMessage } from '../shared/connection-test.mjs';
+import { publicMessageFailure } from '../shared/message-failure.mjs';
 import { RegistrationManager } from './registration-manager.mjs';
 import {
   CALLBACK_REPAIR_OPERATION,
@@ -633,6 +634,7 @@ export class MultiBotDshFeishuController {
         groupMessagePermissionGranted: config.groupMessagePermissionGranted === true,
         bot: publicBot(config),
         connection,
+        lastMessageError: publicMessageFailure(connection.lastMessageError),
         error,
       };
     });

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

@@ -29,6 +29,7 @@ import {
 import {
   fetchImageBuffer,
   hasInboundImages,
+  imagePromptDiagnostic,
   imagePromptUserMessage,
   promptContentForMessage,
 } from '../shared/image-prompt.mjs';
@@ -45,6 +46,12 @@ import {
   createDeliveryReceipt,
   providerMessageIdsFor,
 } from '../shared/semantic/delivery.mjs';
+import {
+  channelDeliveryFailure,
+  clearLastMessageFailure,
+  messageFailureText,
+  setLastMessageFailure,
+} from '../shared/message-failure.mjs';
 import { sendMarkdownReply } from './markdown-reply.mjs';
 import { t } from '../shared/i18n.mjs';
 
@@ -216,9 +223,15 @@ function answerTextForDelivery(answer, artifacts) {
 }
 
 function qqArtifactError(error, { dispatched = false } = {}) {
-  if (error?.code?.startsWith?.('artifact-') || error?.name === 'UploadDailyLimitExceededError') {
+  if (error?.code?.startsWith?.('artifact-')) {
     return error;
   }
+  if (error?.name === 'UploadDailyLimitExceededError') {
+    const wrapped = new Error('QQ daily file upload limit exceeded', { cause: error });
+    wrapped.name = error.name;
+    wrapped.code = 'artifact-rate-limited';
+    return wrapped;
+  }
   const status = Number(error?.httpStatus);
   const wrapped = new Error('QQ file delivery failed', { cause: error });
   if (status === 401 || status === 403) wrapped.code = 'artifact-permission-required';
@@ -341,6 +354,7 @@ export function createQqBridgeStatus() {
     lastReplyAt: null,
     lastRejectedAt: null,
     lastError: null,
+    lastMessageError: null,
   };
 }
 
@@ -470,8 +484,12 @@ export class QqHarnessBridge {
       ).catch((error) => {
         if (error?.code === 'turn-stopped' || this.#signal?.aborted) return;
         this.#status.lastError = error?.message ?? String(error);
-        this.#logger.error?.('[dsh-im:qq] failed to process a command:', error);
-        return this.#bot.sendText(message.replyTarget, t('消息处理失败，请稍后重试。'))
+        const failure = setLastMessageFailure(this.#status, error);
+        this.#logger.error?.(
+          `[dsh-im:qq] failed to process a command [${failure.referenceId}]:`,
+          error,
+        );
+        return this.#bot.sendText(message.replyTarget, messageFailureText(failure))
           .catch(() => undefined);
       }).finally(() => {
         this.#acceptedMessageIds.delete(messageId);
@@ -614,8 +632,12 @@ export class QqHarnessBridge {
     }).catch(async (error) => {
       if (this.#signal?.aborted) return;
       this.#status.lastError = error?.message ?? String(error);
-      this.#logger.error?.('[dsh-im:qq] failed to process a batch input message:', error);
-      await this.#bot.sendText(message.replyTarget, t('消息处理失败，请稍后重试。'))
+      const failure = setLastMessageFailure(this.#status, error);
+      this.#logger.error?.(
+        `[dsh-im:qq] failed to process a batch input message [${failure.referenceId}]:`,
+        error,
+      );
+      await this.#bot.sendText(message.replyTarget, messageFailureText(failure))
         .catch(() => undefined);
     }).finally(() => {
       this.#acceptedMessageIds.delete(messageId);
@@ -627,7 +649,7 @@ export class QqHarnessBridge {
 
   async #deliverArtifacts(target, replyTo, artifacts = [], baseReceipt = null) {
     if (artifacts.length === 0) {
-      return { receipt: baseReceipt, failureNoticeVisible: false };
+      return { receipt: baseReceipt, failureNoticeVisible: false, artifactSendErrors: 0 };
     }
     const delivery = await deliverOutboundArtifacts({
       artifacts,
@@ -645,9 +667,13 @@ export class QqHarnessBridge {
         signal: this.#signal,
         timeoutMs: this.#fileUploadTimeoutMs,
       }),
-      sendFailureNotice: (artifact, error) => this.#bot.sendText(
+      onFailure: (artifact, error) => setLastMessageFailure(this.#status, error, {
+        userMessage: artifactFailureText(artifact?.fileName, error),
+        reason: error?.code,
+      }),
+      sendFailureNotice: (_artifact, _error, failure) => this.#bot.sendText(
         target,
-        artifactFailureText(artifact?.fileName, error),
+        messageFailureText(failure),
       ),
       logger: this.#logger,
     });
@@ -658,6 +684,7 @@ export class QqHarnessBridge {
     return {
       receipt: delivery.receipt,
       failureNoticeVisible: delivery.failureNoticeVisible,
+      artifactSendErrors: delivery.artifactSendErrors,
     };
   }
 
@@ -676,6 +703,12 @@ export class QqHarnessBridge {
       this.#status.messagesReceived += 1;
       this.#status.lastMessageAt = new Date().toISOString();
     }
+    let messageRecorded = alreadyRecorded;
+    const markMessageSeen = async () => {
+      if (messageRecorded) return;
+      await this.#state.markSeen(messageId);
+      messageRecorded = true;
+    };
     if (this.#ownerUserOpenid !== '*' && sender !== this.#ownerUserOpenid) {
       this.#status.messagesRejected += 1;
       this.#status.lastRejectedAt = new Date().toISOString();
@@ -694,25 +727,25 @@ export class QqHarnessBridge {
     try {
       if (!text && !hasImages && !hasFiles) {
         await this.#bot.sendText(target, t('目前支持文字、图片和文件消息。'));
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
       const command = text.toLowerCase();
       if (!hasImages && !hasFiles && command === '/help') {
         await this.#bot.sendText(target, helpText());
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
       if (!hasImages && !hasFiles && command === '/status') {
         await this.#harness.ensureRunning({ signal: this.#signal });
         await this.#bot.sendText(target, t('QQ 机器人与 DeepSeek Harness 连接正常。'));
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
       if (!hasImages && !hasFiles && command === '/new') {
         await this.#state.clearSession(key);
         await this.#bot.sendText(target, t('已开启新会话。请发送你的问题。'));
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
       const workspaceCommand = hasImages || hasFiles
@@ -722,7 +755,7 @@ export class QqHarnessBridge {
         for (const reply of workspaceCommand.messages ?? [workspaceCommand.message]) {
           await this.#bot.sendText(target, reply);
         }
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
       const compactCommand = hasImages || hasFiles
@@ -736,7 +769,7 @@ export class QqHarnessBridge {
           );
       if (compactCommand) {
         await this.#bot.sendText(target, compactCommand.message);
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
 
@@ -757,6 +790,9 @@ export class QqHarnessBridge {
       let answer;
       let artifacts = [];
       try {
+        // Persist consumption before handing the prompt to Harness. Provider
+        // redelivery after a failed error notice must never execute it twice.
+        await markMessageSeen();
         ({ answer, artifacts = [] } = await askInWorkspaceSession({
           harness: this.#harness,
           state: this.#state,
@@ -771,10 +807,13 @@ export class QqHarnessBridge {
             progressMode: 'all',
             onUpdate: (update) => {
               if (update.error) {
-                const label = nonEmptyString(update.toolName)
-                  ? `Tool call ${update.toolName}` : 'Tool call';
-                const text = `${label}\nError: ${update.error}`;
-                toolErrors.push(text);
+                const name = (nonEmptyString(update.toolName) ?? t('工具'))
+                  .replace(/[\r\n]+/gu, ' ')
+                  .slice(0, 80);
+                toolErrors.push(t(
+                  '工具调用「{name}」未成功，请检查工具配置或稍后重试。',
+                  { name },
+                ));
               }
             },
             onInteraction: (interaction) => this.#handleInteraction(interaction, {
@@ -836,7 +875,7 @@ export class QqHarnessBridge {
           });
         }
       } catch (error) {
-        textSendError = error;
+        textSendError = channelDeliveryFailure(error);
         this.#logger.warn?.('[dsh-im:qq] final text delivery failed; continuing with result files:', error);
       }
       const delivery = await this.#deliverArtifacts(target, messageId, artifacts, textReceipt);
@@ -846,10 +885,15 @@ export class QqHarnessBridge {
       if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
         throw textSendError;
       }
-      await this.#state.markSeen(messageId);
+      if (textSendError && delivery.artifactSendErrors === 0) {
+        setLastMessageFailure(this.#status, textSendError);
+      }
       this.#status.messagesReplied += 1;
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
+      if (!textSendError && delivery.artifactSendErrors === 0) {
+        clearLastMessageFailure(this.#status);
+      }
       return delivery.receipt;
     } catch (error) {
       let batchFailureMessage = null;
@@ -872,7 +916,7 @@ export class QqHarnessBridge {
         } catch (sendError) {
           this.#logger.warn?.('[dsh-im:qq] unable to announce a stopped QQ turn:', sendError);
         }
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
         return;
       }
       try {
@@ -882,16 +926,23 @@ export class QqHarnessBridge {
       }
       if (this.#signal?.aborted) return;
       this.#status.lastError = error?.message ?? String(error);
-      this.#logger.error?.('[dsh-im:qq] failed to process an inbound message:', error);
+      const userMessage = inboundFileUserMessage(error)
+        ?? imagePromptUserMessage(error);
+      const failure = setLastMessageFailure(this.#status, error, {
+        userMessage,
+        reason: imagePromptDiagnostic(error)?.reason,
+      });
+      this.#logger.error?.(
+        `[dsh-im:qq] failed to process an inbound message [${failure.referenceId}]:`,
+        error,
+      );
       try {
-        const errorMessage = inboundFileUserMessage(error)
-          ?? imagePromptUserMessage(error)
-          ?? t('消息处理失败，请稍后重试。');
+        const errorMessage = messageFailureText(failure);
         await this.#bot.sendText(
           target,
           batchFailureMessage ? `${errorMessage}\n\n${batchFailureMessage}` : errorMessage,
         );
-        await this.#state.markSeen(messageId);
+        await markMessageSeen();
       } catch (sendError) {
         this.#logger.error?.('[dsh-im:qq] failed to send the safe error reply:', sendError);
       }
@@ -1166,11 +1217,15 @@ export class QqHarnessBridge {
   async #handleInteractionFailure(message, messageId, error) {
     if (this.#signal?.aborted) return;
     this.#status.lastError = error?.message ?? String(error);
-    this.#logger.error?.('[dsh-im:qq] failed to process an interaction reply:', error);
+    const failure = setLastMessageFailure(this.#status, error);
+    this.#logger.error?.(
+      `[dsh-im:qq] failed to process an interaction reply [${failure.referenceId}]:`,
+      error,
+    );
     if (!this.#state.hasSeen(messageId)) {
       await this.#state.markSeen(messageId).catch(() => undefined);
     }
-    await this.#bot.sendText(message.replyTarget, t('消息处理失败，请稍后重试。'))
+    await this.#bot.sendText(message.replyTarget, messageFailureText(failure))
       .catch(() => undefined);
   }
 }