@xmanrui/dsh-im 2.3.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "2.3.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";
@@ -265,7 +269,7 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
               ? h("img", {
                 src: qrSource,
                 alt: repairing
-                  ? `用于修复${botName}卡片按钮的一次性授权二维码`
+                  ? `用于为${botName}补全权限与回调的一次性授权二维码`
                   : grantingGroupMessages
                     ? `用于为${botName}开通群消息权限的一次性授权二维码`
                     : "用于新增 DeepSeek Harness 飞书机器人的一次性授权二维码",
@@ -293,31 +297,31 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
         h("div", { className: "bxf-stateLabel dim-stateLabel" },
           h("span", { className: "bxf-dot dim-stateDot", "data-tone": "warning" }),
           h("span", null, repairing
-            ? `正在修复「${botName}」`
+            ? `正在为「${botName}」补全权限与回调`
             : grantingGroupMessages
               ? `正在为「${botName}」开通群消息权限`
               : "正在添加新机器人")),
         h("h3", null, expired
           ? "刷新二维码后继续"
           : repairing
-            ? "使用飞书扫码修复卡片按钮"
+            ? "使用飞书扫码补全权限"
             : grantingGroupMessages
               ? "使用飞书确认群消息权限"
               : "使用飞书扫码创建机器人"),
         h("p", null, repairing
-          ? "扫码会更新现有飞书应用，只增量补充卡片按钮回调；不会创建新应用。确认后此机器人会短暂重连，其他机器人不受影响。"
+          ? "扫码会更新现有飞书应用，最多增量补充卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”），以及上传机器人图片或文件所需的 im:resource；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。"
           : grantingGroupMessages
             ? "扫码会更新现有飞书应用，只增量开通“获取群组中所有消息”权限；不会创建新应用。确认后会自动启用“响应所有群消息”，其他机器人不受影响。"
             : "扫码只会新增一个机器人，已接入的机器人会继续正常收发消息。"),
         h("ol", { className: "bxf-steps dim-steps" },
           h("li", null, "打开飞书移动端，使用扫一扫读取二维码"),
           h("li", null, repairing
-            ? "核对现有应用名称，并确认只新增卡片回调"
+            ? "核对现有应用名称，并确认只新增当前缺少的上述配置"
             : grantingGroupMessages
               ? "核对现有应用，并确认“获取群组中所有消息”权限"
               : "核对应用名称与权限范围，并确认创建"),
           h("li", null, repairing
-            ? "保持本页打开，等待卡片按钮修复完成"
+            ? "保持本页打开，等待权限与回调补全完成"
             : grantingGroupMessages
               ? "保持本页打开，等待权限生效并自动切换响应方式"
               : "保持本页打开，等待新机器人的长连接就绪")),
@@ -336,7 +340,7 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
             ? h(Button, { onClick: onRefresh, disabled: busy }, "换一个二维码")
             : null,
           h(Button, { onClick: onCancel, disabled: busy }, repairing
-            ? "取消修复"
+            ? "取消补全"
             : grantingGroupMessages ? "取消授权" : "取消添加")),
       ),
     ),
@@ -354,16 +358,16 @@ function ProvisionProgress({ phase, provision, onCancel, busy }) {
     h("div", { className: "dim-spinner", "aria-hidden": "true" }),
     h("h3", null, connecting
       ? repairing
-        ? "已确认，正在完成卡片按钮修复"
+        ? "已确认，正在完成权限与回调配置"
         : grantingGroupMessages
           ? "已确认，正在启用全部消息模式"
           : "已确认，正在连接新机器人"
       : repairing
-        ? "正在准备修复二维码"
+        ? "正在准备权限补全二维码"
         : grantingGroupMessages ? "正在准备权限授权二维码" : "正在准备授权二维码"),
     h("p", null, connecting
       ? repairing
-        ? "配置已提交，正在验证卡片按钮回调并重连此机器人；此阶段无法取消，其他机器人不会中断。"
+        ? "配置已提交，正在保存权限、验证卡片回调并重连此机器人；此阶段无法取消，其他机器人不会中断。"
         : grantingGroupMessages
           ? "权限配置已提交，正在保存设置并重连此机器人；此阶段无法取消，其他机器人不会中断。"
           : "正在安全保存凭据并检查新机器人的消息通道，其他机器人不会中断。"
@@ -375,7 +379,7 @@ function ProvisionProgress({ phase, provision, onCancel, busy }) {
     connecting && onCancel
       ? h("div", { className: "bxf-actions dim-viewActions", style: { justifyContent: "center" } },
           h(Button, { onClick: onCancel, disabled: busy }, repairing
-            ? "取消修复"
+            ? "取消补全"
             : grantingGroupMessages ? "取消授权" : "取消添加"))
       : null,
   );
@@ -388,7 +392,7 @@ function ProvisionError({ error, provision, onRetry, onCancel, busy }) {
     h("div", { className: "bxf-inlineError dim-inlineError", role: "alert" },
       h("div", null,
         h("h3", null, repairing
-          ? "卡片按钮没有修复完成"
+          ? "权限与回调没有补全完成"
           : grantingGroupMessages ? "群消息权限没有开通完成" : "新机器人没有添加完成"),
         h("p", null, error.message),
         error.code ? h("span", { className: "bxf-errorCode" }, error.code) : null,
@@ -564,6 +568,7 @@ export function BotCard({
   removeButtonRef,
 }) {
   const { bot, health, state, connected } = connection;
+  const repairTooltipId = React.useId();
   const stateForDisplay = busy === "reconnect"
     ? "connecting"
     : state;
@@ -637,13 +642,22 @@ export function BotCard({
               disabled: Boolean(busy), "aria-busy": busy === "reconnect" ? "true" : undefined,
               "aria-label": `${connected ? "检查连接" : "重试连接"}${bot.name}`,
             }, busy === "reconnect" ? (connected ? "检查中…" : "正在连接…") : connected ? "检查连接" : "重试连接"),
-            h(Button, {
-              className: "bxf-repairButton dim-cardAction",
-              onClick: onRepairCallback,
-              disabled: Boolean(busy) || repairDisabled,
-              "aria-busy": busy === "callback-repair" ? "true" : undefined,
-              "aria-label": `修复${bot.name}的卡片按钮`,
-            }, busy === "callback-repair" ? "等待扫码…" : "修复卡片按钮"),
+            h("span", { className: "bxf-repairAction" },
+              h(Button, {
+                className: "bxf-repairButton dim-cardAction",
+                onClick: onRepairCallback,
+                disabled: Boolean(busy) || repairDisabled,
+                "aria-busy": busy === "callback-repair" ? "true" : undefined,
+                "aria-label": `为${bot.name}补全权限与回调`,
+                "aria-describedby": repairTooltipId,
+              }, busy === "callback-repair" ? "等待扫码…" : "补全权限"),
+              h("span", {
+                id: repairTooltipId,
+                className: "bxf-repairTooltip",
+                role: "tooltip",
+              },
+                h("strong", null, "补全范围"),
+                h("span", null, "最多增量添加卡片回调 card.action.trigger、读取消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”），以及上传机器人图片或文件所需的 im:resource；确认页只显示当前缺少项，不会创建新应用。"))),
             h(Button, {
               className: "dim-cardAction", kind: "danger", onClick: onRequestRemove,
               disabled: Boolean(busy), ref: removeButtonRef,
@@ -651,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",
@@ -933,7 +951,7 @@ export function FeishuSettingsTab({ rpcCall }) {
         && (provision.operation !== operation || provision.botId !== botId)) {
         throw new Error(grantingGroupMessages
           ? "飞书服务返回了不匹配的群消息权限二维码"
-          : "飞书服务返回了不匹配的卡片修复二维码");
+          : "飞书服务返回了不匹配的权限补全二维码");
       }
       const timestamp = Date.now();
       setNow(timestamp);
@@ -948,7 +966,7 @@ export function FeishuSettingsTab({ rpcCall }) {
         },
       }));
       announce(repairing
-        ? `${botName ?? "机器人"}的修复二维码已生成，请使用飞书扫码。`
+        ? `${botName ?? "机器人"}的权限补全二维码已生成，请使用飞书扫码。`
         : grantingGroupMessages
           ? `${botName ?? "机器人"}的群消息权限二维码已生成，请使用飞书确认。`
           : "授权二维码已生成，请使用飞书扫码。");
@@ -1032,7 +1050,7 @@ export function FeishuSettingsTab({ rpcCall }) {
             : current);
           announce(grantingGroupMessages
             ? "权限配置已提交，正在启用全部消息模式并重连此机器人；此阶段无法取消，其他机器人不会中断。"
-            : "配置已提交，正在验证卡片按钮回调并重连此机器人；此阶段无法取消，其他机器人不会中断。");
+            : "配置已提交，正在保存权限、验证卡片回调并重连此机器人；此阶段无法取消，其他机器人不会中断。");
           return;
         }
         if (result.status === "connected") {
@@ -1040,7 +1058,7 @@ export function FeishuSettingsTab({ rpcCall }) {
           setModel((current) => ({ ...current, provisioning: null }));
           announce(grantingGroupMessages
             ? `${targetBotName}已开通群消息权限，并启用“响应所有群消息”。`
-            : `${targetBotName}的卡片按钮已修复。`);
+            : `${targetBotName}的权限与回调已补全。`);
           if (activeProvision.botId) setFocusBotId(activeProvision.botId);
           await loadStatus({ silent: true, restoreProvisioning: false });
           return;
@@ -1048,7 +1066,7 @@ export function FeishuSettingsTab({ rpcCall }) {
       }
       setModel((current) => ({ ...current, provisioning: null }));
       announce(repairing
-        ? "已取消卡片按钮修复。"
+        ? "已取消补全权限与回调。"
         : grantingGroupMessages ? "已取消群消息权限授权。" : "已取消添加机器人。");
       await loadStatus({ silent: true, restoreProvisioning: false });
       scheduleAnimationFrame(() => {
@@ -1117,7 +1135,7 @@ export function FeishuSettingsTab({ rpcCall }) {
           const targetBot = snapshot?.bots.find((bot) => bot.botId === result.botId);
           if (!snapshot) {
             throw new Error(isCallbackRepair(provision)
-              ? "卡片按钮已更新，但暂时无法确认机器人连接状态"
+              ? "权限与回调已更新，但暂时无法确认机器人连接状态"
               : isGroupMessagePermission(provision)
                 ? "群消息权限已更新，但暂时无法确认机器人连接状态"
                 : "机器人已经创建，但暂时无法确认连接状态");
@@ -1130,7 +1148,7 @@ export function FeishuSettingsTab({ rpcCall }) {
           }
           setModel((current) => ({ ...current, provisioning: null }));
           announce(isCallbackRepair(provision)
-            ? `${targetBot.bot.name}的卡片按钮已修复。`
+            ? `${targetBot.bot.name}的权限与回调已补全。`
             : isGroupMessagePermission(provision)
               ? `${targetBot.bot.name}已开通群消息权限，并启用“响应所有群消息”。`
               : targetBot
@@ -1142,7 +1160,7 @@ export function FeishuSettingsTab({ rpcCall }) {
         if (result.status === "failed") {
           const error = new Error(result.message
             ?? (isCallbackRepair(provision)
-              ? "飞书卡片按钮修复失败"
+              ? "飞书权限与回调补全失败"
               : isGroupMessagePermission(provision)
                 ? "飞书群消息权限开通失败"
                 : "飞书应用创建失败"));

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

@@ -450,10 +450,35 @@ const CSS = String.raw`
 .bxf-connectedFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; margin-top: 20px; padding-top: 16px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
 .bxf-healthSummary { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 18px; }
 .bxf-healthSummary[data-error="true"] { color: var(--bxf-error); }
-.bxf-botActions { flex: none; width: 100%; flex-wrap: wrap; gap: 8px; margin-top: 0; justify-content: flex-end; }
+.bxf-botActions { position: relative; flex: none; width: 100%; flex-wrap: wrap; gap: 8px; margin-top: 0; justify-content: flex-end; }
 .bxf-botActions .bxf-button { flex: none; white-space: nowrap; }
 .bxf-botActions .bxf-repairButton { color: var(--bxf-accent); border-color: color-mix(in srgb, var(--bxf-accent) 35%, var(--dsw-alias-border-l2, #dee0e3)); }
 .bxf-botActions .bxf-repairButton:hover:not(:disabled) { background: color-mix(in srgb, var(--bxf-accent) 7%, transparent); }
+.bxf-repairAction { display: inline-flex; }
+.bxf-repairTooltip {
+  position: absolute;
+  right: 0;
+  bottom: calc(100% + 8px);
+  z-index: 40;
+  width: min(330px, 100%);
+  display: grid;
+  gap: 3px;
+  padding: 9px 10px;
+  border: 1px solid var(--dsw-alias-border-l2, #dfe1e5);
+  border-radius: 8px;
+  color: var(--dsw-alias-label-primary, #1f2329);
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  box-shadow: 0 10px 28px rgb(31 35 41 / 16%);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(3px);
+  pointer-events: none;
+  transition: opacity .15s ease, transform .15s ease, visibility .15s ease;
+}
+.bxf-repairTooltip strong { font-size: 12px; line-height: 17px; font-weight: 650; }
+.bxf-repairTooltip > span { color: var(--dsw-alias-label-secondary, #646a73); font-size: 11px; line-height: 17px; font-weight: 400; overflow-wrap: anywhere; }
+.bxf-repairAction:hover .bxf-repairTooltip,
+.bxf-repairAction:focus-within .bxf-repairTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 
 .bxf-confirm {
   border-top: 1px solid var(--dsw-alias-border-l2, #dee0e3);

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',