@xmanrui/dsh-im 2.4.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "2.4.0",
+  "version": "2.5.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/client/channel-card-meta.js

@@ -1,6 +1,20 @@
 import * as React from 'react';
 
-import { h } from './i18n.js';
+import { h, isEnglish } from './i18n.js';
+
+function messageErrorTime(value) {
+  try {
+    return new Intl.DateTimeFormat(isEnglish() ? 'en-US' : 'zh-CN', {
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+      hour: '2-digit',
+      minute: '2-digit',
+    }).format(new Date(value));
+  } catch {
+    return null;
+  }
+}
 
 export function ChannelListHeading({ className = '', id, title, connectionLabel }) {
   const helpId = React.useId();
@@ -46,3 +60,24 @@ export function BotStatusMeta({
       h('span', null, '最近检查'),
       h('span', null, formatCheckedTime(lastCheckedAt))));
 }
+
+export function LastMessageErrorSummary({ className = '', error }) {
+  if (!error) return null;
+  const occurredAt = messageErrorTime(error.at);
+  return h('div', {
+    className: `${className} dim-cardSummary`.trim(),
+    role: 'status',
+  },
+  h('strong', null, '最近一条消息处理失败'),
+  '：',
+  h('span', null, error.message),
+  '（',
+  h('span', null, '错误码'),
+  ` ${error.code} · `,
+  h('span', null, '参考号'),
+  ` ${error.referenceId}`,
+  occurredAt ? h(React.Fragment, null,
+    ' · ',
+    h('time', { dateTime: new Date(error.at).toISOString() }, occurredAt)) : null,
+  '）');
+}

package/plugin-src/client/channels/dingtalk/api.js

@@ -1,4 +1,5 @@
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
 
 export const DINGTALK_RPC_CHANNEL = '/dingtalk';
 
@@ -178,6 +179,7 @@ function normalizeBot(value) {
       messagesReceived: nonNegativeInteger(stats.messagesReceived),
       messagesReplied: nonNegativeInteger(stats.messagesReplied),
     },
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: normalizeError(value.error, 'DINGTALK_ACCOUNT_ERROR', '钉钉连接尚未就绪') ?? null,
   };
 }

package/plugin-src/client/channels/dingtalk/index.js

@@ -9,7 +9,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
-import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from '../../channel-card-meta.js';
 import {
   DINGTALK_ENDPOINTS,
   DINGTALK_RPC_CHANNEL,
@@ -262,6 +266,10 @@ export function AccountCard({
             h(Button, { className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy) },
               '移除接入')),
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.lastMessageError ? h(LastMessageErrorSummary, {
+            className: 'ddt-summary',
+            error: account.lastMessageError,
+          }) : null,
           feedback ? h('div', {
             className: 'ddt-summary dim-cardFeedback',
             role: 'status',

package/plugin-src/client/channels/feishu/api.js

@@ -7,6 +7,7 @@
  */
 
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId } from "../../agent-preset.js";
+import { normalizeLastMessageError } from "../../last-message-error.js";
 
 export const FEISHU_RPC_CHANNEL = "/feishu";
 
@@ -206,6 +207,7 @@ export function normalizeBotConnection(value, fallbackBotId) {
     groupMessagePermissionGranted: value.groupMessagePermissionGranted === true,
     bot: normalizeBot(value.bot),
     health: normalizeHealth(value.health, connected),
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: normalizeError(value.error),
   };
 }
@@ -226,6 +228,7 @@ export function normalizeBotsSnapshot(value) {
       configured: true,
       bot: value.bot,
       health: value.health,
+      lastMessageError: value.lastMessageError,
       error: value.error,
     }];
   }

package/plugin-src/client/channels/feishu/index.js

@@ -23,7 +23,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from "../../agent-preset.js";
 import { useWorkspaceSnapshotFence } from "../../workspace-snapshot-fence.js";
-import { BotStatusMeta, ChannelListHeading } from "../../channel-card-meta.js";
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from "../../channel-card-meta.js";
 import { installFeishuStyles } from "./styles.js";
 
 export const name = "feishu-settings";
@@ -661,6 +665,10 @@ export function BotCard({
             }, "移除接入")),
           summary ? h("div", { className: "bxf-healthSummary dim-cardSummary", "data-error": actionError || connection.error ? "true" : undefined },
             summary) : null,
+          connection.lastMessageError ? h(LastMessageErrorSummary, {
+            className: "bxf-healthSummary",
+            error: connection.lastMessageError,
+          }) : null,
           testNotice ? h("div", {
             className: "bxf-healthSummary dim-cardFeedback",
             role: "status",

package/plugin-src/client/channels/qq/api.js

@@ -1,4 +1,5 @@
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
 
 export const QQ_RPC_CHANNEL = '/qq';
 
@@ -94,6 +95,7 @@ function normalizeBot(value) {
       summary: text(value.health?.summary, connected ? 'QQ WebSocket 长连接运行正常' : 'QQ 连接尚未就绪'),
       lastCheckedAt: timestamp(value.health?.lastCheckedAt),
     },
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
       code: text(value.error.code, 'QQ_ACCOUNT_ERROR', 80),
       message: text(value.error.message, 'QQ 连接尚未就绪'),

package/plugin-src/client/channels/qq/index.js

@@ -10,7 +10,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
-import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from '../../channel-card-meta.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
   QQ_ENDPOINTS,
@@ -201,6 +205,10 @@ export function AccountCard({
             h(Button, { className: 'dim-cardAction', onClick: onReconnect, disabled: Boolean(busy) }, busy === 'reconnect' ? '检查中…' : account.connected ? '检查连接' : '重试连接'),
             h(Button, { className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy) }, '移除接入')),
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.lastMessageError ? h(LastMessageErrorSummary, {
+            className: 'ddt-summary',
+            error: account.lastMessageError,
+          }) : null,
           feedback ? h('div', {
             className: 'ddt-summary dim-cardFeedback',
             role: 'status',

package/plugin-src/client/channels/shared/token-api.js

@@ -1,4 +1,5 @@
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
 
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
 
@@ -68,6 +69,7 @@ export function createTokenChannelApi(channel, connectionSummary, {
         ),
         lastCheckedAt: timestamp(value.health?.lastCheckedAt),
       },
+      lastMessageError: normalizeLastMessageError(value.lastMessageError),
       error: isRecord(value.error) ? {
         code: text(value.error.code, `${channel.toUpperCase()}_ACCOUNT_ERROR`, 80),
         message: text(value.error.message, `${channel}连接尚未就绪`),

package/plugin-src/client/channels/shared/token-channel.js

@@ -10,7 +10,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
-import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from '../../channel-card-meta.js';
 
 const Button = React.forwardRef(function Button(
   { children, kind = 'secondary', className = '', ...props },
@@ -121,6 +125,10 @@ export function createTokenChannelSettings(definition) {
                 disabled: Boolean(busy),
               }, '移除接入')),
             summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+            account.lastMessageError ? h(LastMessageErrorSummary, {
+              className: 'ddt-summary',
+              error: account.lastMessageError,
+            }) : null,
             testNotice ? h('div', {
               className: 'ddt-summary dim-cardFeedback',
               role: 'status',

package/plugin-src/client/channels/wecom/api.js

@@ -1,4 +1,5 @@
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
 
 export const WECOM_RPC_CHANNEL = '/wecom';
 
@@ -103,6 +104,7 @@ function normalizeBot(value) {
       summary: text(value.health?.summary, connected ? '企业微信 WebSocket 长连接运行正常' : '企业微信连接尚未就绪'),
       lastCheckedAt: timestamp(value.health?.lastCheckedAt),
     },
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
       code: text(value.error.code, 'WECOM_ACCOUNT_ERROR', 80),
       message: text(value.error.message, '企业微信连接尚未就绪'),

package/plugin-src/client/channels/wecom/index.js

@@ -10,7 +10,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
-import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from '../../channel-card-meta.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
   WECOM_ENDPOINTS,
@@ -200,6 +204,10 @@ export function AccountCard({
             h(Button, { className: 'dim-cardAction', onClick: onReconnect, disabled: Boolean(busy) }, busy === 'reconnect' ? '检查中…' : account.connected ? '检查连接' : '重试连接'),
             h(Button, { className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy) }, '移除接入')),
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.lastMessageError ? h(LastMessageErrorSummary, {
+            className: 'ddt-summary',
+            error: account.lastMessageError,
+          }) : null,
           feedback ? h('div', {
             className: 'ddt-summary dim-cardFeedback',
             role: 'status',

package/plugin-src/client/channels/weixin/api.js

@@ -1,4 +1,5 @@
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
 
 export const WEIXIN_RPC_CHANNEL = '/weixin';
 export const WEIXIN_ENDPOINTS = Object.freeze({
@@ -48,15 +49,6 @@ function normalizeTestMessage(value) {
   return { sent: false, code };
 }
 
-function normalizeMessageError(value) {
-  if (!isRecord(value)) return null;
-  const code = string(value.code).slice(0, 64);
-  const reason = string(value.reason).slice(0, 128);
-  const message = string(value.message).slice(0, 500);
-  const at = timestamp(value.at);
-  return code && reason && message && at !== null ? { code, reason, message, at } : null;
-}
-
 export function unwrapRpcResult(result) {
   if (!isRecord(result) || typeof result.ok !== 'boolean') {
     throw new Error('微信服务返回了无法识别的响应');
@@ -141,7 +133,7 @@ function normalizeBot(value) {
       messagesReceived: Math.max(0, Number(value.stats?.messagesReceived) || 0),
       messagesReplied: Math.max(0, Number(value.stats?.messagesReplied) || 0),
     },
-    lastMessageError: normalizeMessageError(value.lastMessageError),
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error)
       ? {
           code: string(value.error.code, 'WEIXIN_ACCOUNT_ERROR'),

package/plugin-src/client/channels/weixin/index.js

@@ -22,7 +22,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
-import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from '../../channel-card-meta.js';
 import { installWeixinStyles } from './styles.js';
 
 export const name = 'weixin-settings';
@@ -247,10 +251,10 @@ export function AccountCard({
               busy === 'reconnect' ? '检查中…' : account.connected ? '检查连接' : '重试连接'),
             h(Button, { className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy) }, '移除接入')),
           summary ? h('div', { className: 'dxw-summary dim-cardSummary' }, summary) : null,
-          account.lastMessageError ? h('div', {
-            className: 'dxw-summary dim-cardSummary',
-            role: 'status',
-          }, `最近一条消息处理失败：${account.lastMessageError.message}`) : null,
+          account.lastMessageError ? h(LastMessageErrorSummary, {
+            className: 'dxw-summary',
+            error: account.lastMessageError,
+          }) : null,
           feedback ? h('div', {
             className: 'dxw-summary dim-cardFeedback',
             role: 'status',

package/plugin-src/client/channels/whatsapp/api.js

@@ -1,4 +1,5 @@
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
 
 export const WHATSAPP_RPC_CHANNEL = '/whatsapp';
 
@@ -106,6 +107,7 @@ function normalizeBot(value) {
         ? 'WhatsApp Web 关联设备运行正常' : 'WhatsApp 连接尚未就绪'),
       lastCheckedAt: timestamp(value.health?.lastCheckedAt),
     },
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
       code: text(value.error.code, 'WHATSAPP_ACCOUNT_ERROR', 80),
       message: text(value.error.message, 'WhatsApp 连接尚未就绪'),

package/plugin-src/client/channels/whatsapp/index.js

@@ -10,7 +10,11 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
-import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
+import {
+  BotStatusMeta,
+  ChannelListHeading,
+  LastMessageErrorSummary,
+} from '../../channel-card-meta.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
   WHATSAPP_ENDPOINTS,
@@ -345,6 +349,10 @@ export function WhatsappAccountCard({
               className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy),
             }, '移除接入')),
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.lastMessageError ? h(LastMessageErrorSummary, {
+            className: 'ddt-summary',
+            error: account.lastMessageError,
+          }) : null,
           testNotice ? h('div', {
             className: 'ddt-summary dim-cardFeedback',
             role: 'status',

package/plugin-src/client/i18n.js

@@ -8,6 +8,7 @@ const EN = Object.freeze({
   'IM机器人设置': 'IM bot settings',
   'IM 渠道': 'IM channels',
   '让 DeepSeek Harness 触手可及': 'DeepSeek Harness, always within reach',
+  '当前版本': 'Current version',
   'AI Office': 'AI Office',
   '（实验功能）': '(Experimental)',
   'AI Office 设置': 'AI Office settings',
@@ -113,6 +114,9 @@ const EN = Object.freeze({
   '消息通道': 'Message channel',
   '查看消息通道说明': 'View message channel details',
   '最近检查': 'Last checked',
+  '最近一条消息处理失败': 'Latest message failed',
+  '错误码': 'Code',
+  '参考号': 'Reference',
   '当前工作区': 'Current workspace',
   '选择目录': 'Choose folder',
   '选择机器人工作区目录': 'Select bot workspace folder',

package/plugin-src/client/index.js

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import manifest from '../../package.json' with { type: 'json' };
 
 import {
   DingtalkLogoGlyph,
@@ -51,6 +52,7 @@ import { WorkspaceDirectoryPickerContext } from './workspace-editor.js';
 
 export const name = 'im-settings';
 export const inject = ['slots', 'connection', 'locale', 'workspaces'];
+export const IM_PLUGIN_VERSION = manifest.version;
 
 const CHANNELS = Object.freeze([
   { id: 'weixin', label: '微信' },
@@ -159,6 +161,7 @@ export function IMSettingsTab({
 }) {
   const [selected, setSelected] = React.useState('weixin');
   const [loopbackRecovery, setLoopbackRecovery] = React.useState(null);
+  const versionTooltipId = React.useId();
   const githubTooltipId = React.useId();
   const active = CHANNELS.find((channel) => channel.id === selected) ?? CHANNELS[0];
   const reportLoopbackRecovery = React.useCallback((recovery) => {
@@ -195,9 +198,20 @@ export function IMSettingsTab({
   return h(WorkspaceDirectoryPickerContext.Provider, { value: workspaceDirectoryPicker },
     h('section', { className: 'dim-page', 'aria-label': 'IM机器人设置' },
     h('header', { className: 'dim-title' },
-      h('div', { className: 'dim-brand' },
+      h('div', {
+        className: 'dim-brand',
+        tabIndex: 0,
+        'aria-describedby': versionTooltipId,
+      },
         h('strong', { className: 'dim-brandName' }, 'DSH-IM'),
-        h('p', null, '让 DeepSeek Harness 触手可及')),
+        h('p', null, '让 DeepSeek Harness 触手可及'),
+        h('span', {
+          id: versionTooltipId,
+          className: 'dim-versionTooltip',
+          role: 'tooltip',
+        },
+        h('span', null, '当前版本'),
+        h('strong', null, `v${IM_PLUGIN_VERSION}`))),
       h('span', { className: 'dim-githubAction' },
         h('a', {
           className: 'dim-githubLink',

package/plugin-src/client/last-message-error.js

@@ -0,0 +1,17 @@
+function text(value, maxLength) {
+  if (typeof value !== 'string') return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, maxLength) : null;
+}
+
+export function normalizeLastMessageError(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  const code = text(value.code, 64);
+  const reason = text(value.reason, 64);
+  const message = text(value.message, 500);
+  const referenceId = text(value.referenceId, 40);
+  const at = Number.isFinite(value.at) ? value.at : null;
+  return code && reason && message && referenceId && at !== null
+    ? { code, reason, message, referenceId, at }
+    : null;
+}

package/plugin-src/client/styles.js

@@ -12,9 +12,13 @@ const CSS = String.raw`
 }
 .dim-page *, .dim-page *::before, .dim-page *::after { box-sizing: border-box; }
 .dim-title { display: flex; align-items: center; justify-content: space-between; gap: 16px; margin: 0 0 18px; }
-.dim-brand { min-width: 0; display: flex; flex-direction: column; align-items: flex-start; gap: 1px; }
+.dim-brand { position: relative; min-width: 0; width: max-content; max-width: 100%; display: flex; flex-direction: column; align-items: flex-start; gap: 1px; margin: -2px -6px; padding: 2px 6px; border-radius: 8px; cursor: help; }
+.dim-brand:focus-visible { outline: 2px solid color-mix(in srgb, var(--dim-blue) 70%, white); outline-offset: 2px; }
 .dim-brandName { color: var(--dsw-alias-label-primary, #1f2329); font-size: 20px; line-height: 24px; font-weight: 800; letter-spacing: .04em; }
 .dim-title p { margin: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 18px; font-weight: 500; white-space: nowrap; }
+.dim-versionTooltip { position: absolute; left: 0; bottom: calc(100% + 8px); z-index: 20; width: max-content; max-width: min(220px, 80vw); display: inline-flex; align-items: center; gap: 6px; padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; font-weight: 500; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateY(3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dim-versionTooltip strong { color: var(--dsw-alias-label-primary, #1f2329); font: 600 11px/16px ui-monospace, SFMono-Regular, Menlo, monospace; }
+.dim-brand:hover .dim-versionTooltip, .dim-brand:focus .dim-versionTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-githubAction { position: relative; display: inline-flex; flex: none; }
 .dim-githubLink { min-height: 30px; display: inline-flex; align-items: center; gap: 5px; flex: none; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); font-size: 12px; line-height: normal; font-weight: 560; text-decoration: none; transition: border-color .15s ease, color .15s ease, background .15s ease; }
 .dim-githubLink:hover { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }

package/plugin-src/host/channels/feishu/rpc.mjs

@@ -4,6 +4,7 @@ import {
   normalizeAgentPresetId,
 } from '../../../../src/channels/shared/agent-preset.mjs';
 import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
+import { publicMessageFailure } from '../../../../src/channels/shared/message-failure.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
@@ -281,6 +282,8 @@ function publicBotEntry(entry) {
     health: publicHealth(source, connected),
   };
   if (typeof source.workspace === 'string' && source.workspace) result.workspace = source.workspace;
+  const lastMessageError = publicMessageFailure(source.lastMessageError);
+  if (lastMessageError) result.lastMessageError = lastMessageError;
   const error = publicError(source.error);
   if (error) result.error = error;
   return result;

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

@@ -830,7 +830,7 @@ export function createDingtalkApi({
             clientId: appKey,
             clientSecret: appSecret,
             cardInstanceId,
-            text: t('消息处理失败，请稍后重试。'),
+            text: t('卡片已结束，请查看后续消息。'),
             signal: cleanupSignal,
           }).catch(() => undefined);
         }

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

@@ -32,6 +32,7 @@ import {
 } from '../shared/batch-input.mjs';
 import {
   hasInboundImages,
+  imagePromptDiagnostic,
   imagePromptUserMessage,
   promptContentForMessage,
 } from '../shared/image-prompt.mjs';
@@ -46,10 +47,15 @@ import {
   createDeliveryReceipt,
   providerMessageIdsFor,
 } from '../shared/semantic/delivery.mjs';
+import {
+  channelDeliveryFailure,
+  clearLastMessageFailure,
+  messageFailureText,
+  setLastMessageFailure,
+} from '../shared/message-failure.mjs';
 import { t } from '../shared/i18n.mjs';
 
 const CARD_INITIAL_TEXT = '已连接 DeepSeek Harness，正在思考…';
-const CARD_ERROR_TEXT = '消息处理失败，请稍后重试。';
 const INTERACTION_RESOLVED_TEXT = '这个问题已在其他客户端处理，无需再次回答。';
 
 const HELP_TEXT_LINES = [
@@ -326,6 +332,7 @@ export function createDingtalkBridgeStatus({ pendingSenders = [] } = {}) {
     lastReplyAt: null,
     lastRejectedAt: null,
     lastError: null,
+    lastMessageError: null,
     pendingSenders: structuredClone(pendingSenders),
     stats: {
       messagesReceived: 0,
@@ -484,9 +491,13 @@ export class DingtalkHarnessBridge {
         commandRunner,
       ).catch((error) => {
         if (error?.code === 'turn-stopped' || this.#signal?.aborted) return;
-        this.#status.lastError = t('钉钉命令处理失败。');
-        this.#logger.error?.('[dsh-dingtalk] failed to process a command', safeErrorDiagnostic(error));
-        return this.#send(sessionWebhook, t(CARD_ERROR_TEXT)).catch(() => undefined);
+        this.#status.lastError = error?.message ?? String(error);
+        const failure = setLastMessageFailure(this.#status, error);
+        this.#logger.error?.(
+          `[dsh-dingtalk] failed to process a command [${failure.referenceId}]`,
+          safeErrorDiagnostic(error),
+        );
+        return this.#send(sessionWebhook, messageFailureText(failure)).catch(() => undefined);
       }).finally(() => {
         this.#acceptedMessageIds.delete(messageId);
         this.#commandTasks.delete(task);
@@ -659,9 +670,13 @@ export class DingtalkHarnessBridge {
       this.#status.lastError = null;
     }).catch(async (error) => {
       if (this.#signal?.aborted) return;
-      this.#status.lastError = t('钉钉命令处理失败。');
-      this.#logger.error?.('[dsh-dingtalk] failed to process a batch input message', safeErrorDiagnostic(error));
-      await this.#send(sessionWebhook, t(CARD_ERROR_TEXT)).catch(() => undefined);
+      this.#status.lastError = error?.message ?? String(error);
+      const failure = setLastMessageFailure(this.#status, error);
+      this.#logger.error?.(
+        `[dsh-dingtalk] failed to process a batch input message [${failure.referenceId}]`,
+        safeErrorDiagnostic(error),
+      );
+      await this.#send(sessionWebhook, messageFailureText(failure)).catch(() => undefined);
     }).finally(() => {
       this.#acceptedMessageIds.delete(messageId);
       this.#commandTasks.delete(task);
@@ -819,7 +834,7 @@ export class DingtalkHarnessBridge {
           });
         }
       } catch (error) {
-        textDeliveryError = error;
+        textDeliveryError = channelDeliveryFailure(error);
       }
       const delivery = await this.#deliverArtifacts(
         fileTarget(message, sender, this.#clientId),
@@ -829,9 +844,15 @@ export class DingtalkHarnessBridge {
         textReceipt,
       );
       if (textDeliveryError && !delivery.userVisible) throw textDeliveryError;
+      if (textDeliveryError && delivery.artifactSendErrors === 0) {
+        setLastMessageFailure(this.#status, textDeliveryError);
+      }
       increment(this.#status, 'messagesReplied');
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
+      if (!textDeliveryError && delivery.artifactSendErrors === 0) {
+        clearLastMessageFailure(this.#status);
+      }
       return delivery.receipt;
     } catch (error) {
       let batchFailureMessage = null;
@@ -848,15 +869,19 @@ export class DingtalkHarnessBridge {
         return;
       }
       if (this.#signal?.aborted) return;
-      this.#status.lastError = t('钉钉消息处理失败。');
+      this.#status.lastError = error?.message ?? String(error);
+      const userMessage = inboundFileUserMessage(error)
+        ?? dingtalkImageErrorUserMessage(error);
+      const failure = setLastMessageFailure(this.#status, error, {
+        userMessage,
+        reason: imagePromptDiagnostic(error)?.reason,
+      });
       this.#logger.error?.(
-        '[dsh-dingtalk] failed to process an inbound message',
+        `[dsh-dingtalk] failed to process an inbound message [${failure.referenceId}]`,
         safeErrorDiagnostic(error),
       );
       try {
-        const errorText = inboundFileUserMessage(error)
-          ?? dingtalkImageErrorUserMessage(error)
-          ?? t(CARD_ERROR_TEXT);
+        const errorText = messageFailureText(failure);
         const visibleError = batchFailureMessage
           ? `${errorText}\n\n${batchFailureMessage}`
           : errorText;
@@ -1201,9 +1226,13 @@ export class DingtalkHarnessBridge {
       sendFile: typeof this.#api.sendFile === 'function'
         ? (file) => sendArtifact('sendFile', file)
         : undefined,
-      sendFailureNotice: (artifact, error) => this.#send(
+      onFailure: (artifact, error) => setLastMessageFailure(this.#status, error, {
+        userMessage: artifactFailureText(artifact?.fileName, error),
+        reason: error?.code,
+      }),
+      sendFailureNotice: (_artifact, _error, failure) => this.#send(
         sessionWebhook,
-        artifactFailureText(artifact?.fileName, error),
+        messageFailureText(failure),
       ),
       logger: this.#logger,
     });
@@ -1211,7 +1240,11 @@ export class DingtalkHarnessBridge {
       + delivery.artifactsSent;
     this.#status.artifactSendErrors = (this.#status.artifactSendErrors ?? 0)
       + delivery.artifactSendErrors;
-    return { receipt: delivery.receipt, userVisible: delivery.userVisible };
+    return {
+      receipt: delivery.receipt,
+      userVisible: delivery.userVisible,
+      artifactSendErrors: delivery.artifactSendErrors,
+    };
   }
 }
 

package/src/channels/dingtalk/dingtalk-card-stream.mjs

@@ -1,7 +1,7 @@
 import { t } from '../shared/i18n.mjs';
 
 const DEFAULT_UPDATE_INTERVAL_MS = 500;
-const FAILURE_TEXT = '消息处理失败，请稍后重试。';
+const CLOSED_TEXT = '卡片已结束，请查看后续消息。';
 
 function requiredText(value, name) {
   if (typeof value !== 'string') throw new TypeError(`${name} must be a string`);
@@ -102,7 +102,7 @@ export function createDingTalkCardStream({
     if (!cleanupPromise) {
       cleanupPromise = api.failAiCard({
         ...cardRequest,
-        text: t(FAILURE_TEXT),
+        text: t(CLOSED_TEXT),
         signal: AbortSignal.timeout(5_000),
       }).then(
         () => true,