@xmanrui/dsh-im 4.22.0 → 4.23.0

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

@@ -0,0 +1,51 @@
+export const EMAIL_STYLE_ID = 'xmanrui-dsh-im-email-settings';
+const CSS = String.raw`
+.dim-pageEmail { --ddt-accent: #2f6fd0; --ddt-accent-deep: #24559f; --ddt-accent-wash: #eef4fd; }
+.dim-avatarEmail { color: #fff; background: linear-gradient(180deg, #6ea8f5 0%, #3d7fe0 50%, #24559f 100%); box-shadow: inset 0 1px 1px rgb(255 255 255 / 45%), 0 1px 3px rgb(31 35 41 / 12%); }
+.dim-avatarEmail svg { display: block; }
+.dim-emailPanel { padding: 20px; }
+.dim-emailPanel p { color: var(--dsw-alias-label-secondary, #646a73); }
+.dim-emailFields { display: grid; gap: 12px; margin: 16px 0; }
+.dim-emailField { display: grid; gap: 6px; }
+.dim-emailField > span { font-size: 13px; color: var(--dsw-alias-label-secondary, #646a73); }
+.dim-emailField input, .dim-emailField select, .dim-emailField textarea {
+  padding: 8px 10px; border: 1px solid var(--dsw-alias-border, #dee0e3); border-radius: 6px;
+  background: var(--dsw-alias-bg-base, #fff); color: inherit; font: inherit;
+}
+.dim-emailField textarea { min-height: 76px; resize: vertical; }
+.dim-emailHint { font-size: 12px; color: var(--dsw-alias-label-tertiary, #8f959e); }
+.dim-emailGrid { display: grid; grid-template-columns: 1fr 120px; gap: 12px; }
+.dim-emailBinding { margin-top: 20px; border-top: 1px solid var(--dsw-alias-border, #dee0e3); padding-top: 16px; }
+.dim-emailBinding h4 { margin: 0 0 4px; font-size: 14px; }
+.dim-emailBindingHead { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
+/* The sender address wraps above its picker instead of squeezing the select
+   into a narrow column, so a long session title stays fully readable. */
+.dim-emailBindingRow {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: 4px;
+  align-items: center;
+  padding: 8px 0;
+  border-top: 1px dashed var(--dsw-alias-border, #eef0f2);
+}
+.dim-emailBindingRow:first-of-type { border-top: 0; }
+.dim-emailBindingSender { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 13px; }
+.dim-emailBindingRow select { width: 100%; }
+/* Selects clip their own text; a minimum width keeps the chosen title legible. */
+.dim-emailBinding select { min-width: 0; }
+/* QR authorization block for the Agent mailbox. */
+.dim-emailAuth { display: grid; gap: 8px; padding: 12px; border: 1px solid var(--dsw-alias-border, #dee0e3); border-radius: 8px; }
+.dim-emailAuthPanel { display: grid; gap: 6px; }
+.dim-emailAuthRow { display: grid; grid-template-columns: 72px minmax(0, 1fr); gap: 8px; align-items: center; font-size: 13px; }
+.dim-emailAuthLink { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* The full title of the current choice, wrapping instead of clipping. */
+.dim-emailBindingSelected { display: block; white-space: normal; overflow-wrap: anywhere; }
+`;
+export function installEmailStyles() {
+  if (typeof document === 'undefined') return () => {};
+  const existing = document.querySelector(`style[data-plugin-css="${EMAIL_STYLE_ID}"]`);
+  if (existing) return () => {};
+  const style = document.createElement('style'); style.dataset.plugin = '@xmanrui/dsh-im';
+  style.dataset.pluginCss = EMAIL_STYLE_ID; style.textContent = CSS; document.head.appendChild(style);
+  return () => style.remove();
+}

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

@@ -1,3 +1,4 @@
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 /**
  * Browser-safe contract for the Feishu Host plugin.
@@ -119,6 +120,7 @@ export function unwrapRpcResult(result) {
     const message = optionalString(result.error?.message) ?? "飞书服务请求失败";
     const error = new Error(message);
     error.code = optionalString(result.error?.code) ?? "FEISHU_RPC_ERROR";
+    Object.assign(error, diagnosticFields(result.error));
     throw error;
   }
   return result.value;
@@ -190,7 +192,7 @@ function normalizeError(value) {
   if (!isRecord(value)) return undefined;
   const message = optionalString(value.message);
   if (!message) return undefined;
-  return { message, code: optionalString(value.code) };
+  return { ...diagnosticFields(value), message, code: optionalString(value.code) };
 }
 
 function authoritativeState(value, connected) {
@@ -386,7 +388,7 @@ export function presentError(error) {
   const message = raw
     .replace(/(client[_-]?secret|app[_-]?secret|secret|token)\s*[:=]\s*[^\s,;]+/gi, "$1=••••••")
     .slice(0, 240);
-  return { message, code: optionalString(error?.code) };
+  return { message, code: optionalString(error?.code), ...diagnosticFields(error) };
 }
 
 export function formatRemaining(milliseconds) {

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

@@ -1,3 +1,4 @@
+import { ConnectionError, normalizeConnectionError } from '../../connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from "react";
 
@@ -396,7 +397,7 @@ function ProvisionError({ error, provision, onRetry, onCancel, busy }) {
         h("h3", null, repairing
           ? "权限与回调没有补全完成"
           : grantingGroupMessages ? "群消息权限没有开通完成" : "新机器人没有添加完成"),
-        h("p", null, error.message),
+        h(ConnectionError, { error: error }),
         error.code ? h("span", { className: "bxf-errorCode" }, error.code) : null,
         h("div", { className: "bxf-actions dim-viewActions" },
           h(Button, { kind: "primary", onClick: onRetry, disabled: busy },
@@ -700,6 +701,7 @@ export function BotCard({
             }, "移除接入")),
           summary ? h("div", { className: "bxf-healthSummary dim-cardSummary", "data-error": actionError || connection.error ? "true" : undefined },
             summary) : null,
+          (actionError || connection.error) ? h(ConnectionError, { error: actionError || connection.error, showMessage: false }) : null,
           connection.lastMessageError ? h(LastMessageErrorSummary, {
             className: "bxf-healthSummary",
             error: connection.lastMessageError,
@@ -770,7 +772,7 @@ function PageError({ error, onRetry, busy }) {
     h("div", { className: "bxf-error dim-inlineError", role: "alert" },
       h("div", null,
         h("h3", null, "无法读取飞书机器人"),
-        h("p", null, error.message),
+        h(ConnectionError, { error: error }),
         error.code ? h("span", { className: "bxf-errorCode" }, error.code) : null,
         h("div", { className: "bxf-actions dim-viewActions" },
           h(Button, { kind: "primary", onClick: onRetry, disabled: busy },
@@ -812,6 +814,7 @@ export function mergeFeishuSnapshotState(
 }
 
 export function FeishuSettingsTab({ rpcCall }) {
+  const [operationError, setOperationError] = React.useState(null);
   const [model, setModel] = React.useState({
     phase: "loading",
     revision: 0,
@@ -857,7 +860,16 @@ export function FeishuSettingsTab({ rpcCall }) {
   }, [scheduleAnimationFrame]);
 
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
-    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+    const operation = !['connection.status', 'provision.poll', 'provision.begin', 'provision.cancel'].includes(endpoint);
+    if (operation && mountedRef.current) setOperationError(null);
+    try {
+      const value = unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+      if (operation && mountedRef.current) setOperationError(value?.testMessage?.error ?? value?.warnings?.[0] ?? null);
+      return value;
+    } catch (error) {
+      if (endpoint === 'bot.delete' && mountedRef.current && !signal?.aborted && error?.name !== 'AbortError') setOperationError(normalizeConnectionError(error));
+      throw error;
+    }
   }, [rpcCall]);
 
   const mergeSnapshot = React.useCallback((snapshot, { restoreProvisioning = false } = {}) => {
@@ -1490,6 +1502,7 @@ export function FeishuSettingsTab({ rpcCall }) {
   }, h(AgentPresetCatalogContext.Provider, {
     value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
   }, h("section", { className: "bxf-page dim-channelPage", "aria-label": "飞书机器人设置" },
+    operationError ? h(ConnectionError, { error: operationError }) : null,
     h(Heading, {
       totals: model.totals,
       onAdd: () => void startProvisioning(),

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

@@ -1,3 +1,4 @@
+import { ConnectionError } from '../../connection-error.js';
 import * as React from 'react';
 import { IMessageLogoGlyph } from '../../channel-logos.js';
 import { createTokenChannelSettings } from '../shared/token-channel.js';
@@ -21,7 +22,7 @@ function PermissionPanel({ permissions, busy, error, onSubmit, onCancel }) {
         h('strong', null, automationReady ? '✓ Messages 自动化权限已授予' : '2. 允许自动化控制 Messages'),
         automationReady ? null : h('p', null, '在“系统设置 → 隐私与安全性 → 自动化”中，允许运行 DeepSeek Harness 的应用控制 Messages。'),
         automationReady ? null : h('a', { href: 'x-apple.systempreferences:com.apple.preference.security?Privacy_Automation' }, '打开自动化设置'))),
-    error ? h('p', { className: 'dim-inlineError', role: 'alert' }, error.message ?? String(error)) : null,
+    error ? h(ConnectionError, { error: error }) : null,
     h('div', { className: 'ddt-actions dim-viewActions' },
       h('button', { type: 'button', className: 'ddt-button', onClick: onCancel, disabled: busy }, '取消'),
       h('button', { type: 'button', className: 'ddt-button', 'data-kind': 'primary', onClick: () => onSubmit({}), disabled: busy },

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

@@ -1,3 +1,4 @@
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import {
   OFFICE_PROTOCOL_VERSION,
   OFFICE_RPC_CHANNEL,
@@ -12,6 +13,7 @@ export function unwrapOfficeRpc(result) {
   if (!result.ok) {
     const error = new Error(typeof result.error?.message === 'string' ? result.error.message : 'AI Office 操作失败');
     error.code = typeof result.error?.code === 'string' ? result.error.code : 'office-rpc-error';
+    Object.assign(error, diagnosticFields(result.error));
     throw error;
   }
   return result.value;

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

@@ -1,3 +1,4 @@
+import { ConnectionError } from '../../connection-error.js';
 import * as React from 'react';
 
 import { h } from '../../i18n.js';
@@ -76,15 +77,15 @@ export function OfficeSettingsTab({ rpcCall, initialStatus }) {
 
   const load = React.useCallback(async () => {
     try { adopt(await invoke(OFFICE_RPC_ENDPOINTS.status)); setPhase('ready'); setError(''); }
-    catch (caught) { setPhase('error'); setError(caught.message); }
+    catch (caught) { setPhase('error'); setError(caught); }
   }, [adopt, invoke]);
 
   React.useEffect(() => { void load(); }, [load]);
 
   const run = async (name, operation) => {
     setBusy(name); setError(''); setNotice('');
-    try { const value = await operation(); adopt(value); setNotice(name === 'test' ? '连接测试通过。' : '配置已保存。'); }
-    catch (caught) { setError(caught.message); }
+    try { const value = await operation(); adopt(value); if (value?.warnings?.length) setError(value.warnings[0]); setNotice(name === 'test' ? '连接测试通过。' : '配置已保存。'); }
+    catch (caught) { setError(caught); }
     finally { setBusy(''); }
   };
 
@@ -128,9 +129,9 @@ export function OfficeSettingsTab({ rpcCall, initialStatus }) {
         h('label', { className: 'dof-field', 'data-wide': 'true' }, 'Instruction Preset 映射',
           h('textarea', { value: form.instructionPresets, placeholder: 'action-items=转换为负责人、截止和验收明确的工单', onChange: (event) => setForm({ ...form, instructionPresets: event.target.value }) }),
           h('small', null, '每行 alias=指令；新增 preset 不需要改 Office 代码。'))),
-      error ? h('p', { className: 'dof-error', role: 'alert' }, error) : null,
+      error ? h(ConnectionError, { error }) : null,
       notice ? h('p', { className: 'dof-notice', role: 'status' }, notice) : null,
-      health.error?.message ? h('p', { className: 'dof-error' }, health.error.message) : null,
+      health.error?.message ? h(ConnectionError, { error: health.error }) : null,
       h('div', { className: 'dof-actions' },
         h(Button, { kind: 'primary', disabled: Boolean(busy), onClick: () => void run('save', () => invoke(OFFICE_RPC_ENDPOINTS.configure, {
           baseUrl: form.baseUrl,

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

@@ -1,3 +1,5 @@
+import { normalizeConnectionError as normalizeTestError } from '../../connection-error.js';
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
 import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
@@ -52,6 +54,7 @@ export function unwrapRpcResult(result) {
   if (!result.ok) {
     const error = new Error(text(result.error?.message, 'QQ 操作失败'));
     error.code = text(result.error?.code, 'QQ_RPC_ERROR', 80);
+    Object.assign(error, diagnosticFields(result.error));
     throw error;
   }
   return result.value;
@@ -79,6 +82,7 @@ export function normalizeProvisioning(value, now = Date.now()) {
   if (qrCodeDataUrl) result.qrCodeDataUrl = qrCodeDataUrl;
   if (id(source.botId)) result.botId = id(source.botId);
   if (isRecord(source.error)) result.error = {
+    ...diagnosticFields(source.error),
     code: text(source.error.code, 'QQ_PROVISION_FAILED', 80),
     message: text(source.error.message, 'QQ 机器人没有接入完成'),
   };
@@ -111,6 +115,7 @@ function normalizeBot(value) {
     },
     lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
+      ...diagnosticFields(value.error),
       code: text(value.error.code, 'QQ_ACCOUNT_ERROR', 80),
       message: text(value.error.message, 'QQ 连接尚未就绪'),
     } : null,
@@ -123,6 +128,7 @@ function normalizeTestMessage(value) {
   const code = text(value.code, 'test-message-failed', 80);
   return {
     sent: false,
+    ...(value.error ? { error: normalizeTestError(value.error) } : {}),
     code: TEST_MESSAGE_CODES.has(code) ? code : 'test-message-failed',
   };
 }
@@ -153,6 +159,7 @@ export function connectionTestFeedback(result) {
 
 export function presentError(error) {
   return {
+    ...diagnosticFields(error),
     code: text(error?.code, 'QQ_ERROR', 80),
     message: text(error?.message, 'QQ 操作失败，请稍后重试'),
   };

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

@@ -1,3 +1,4 @@
+import { ConnectionError, normalizeConnectionError } from '../../connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
@@ -151,7 +152,7 @@ function ProvisionView({ provision, busy, onRetry, onClose }) {
   return h('div', { className: 'ddt-card dim-surfaceCard' },
     h('div', { className: 'ddt-inlineError dim-inlineError', role: 'alert' },
       h('h3', null, 'QQ 机器人没有绑定完成'),
-      h('p', null, error.message),
+      h(ConnectionError, { error: error }),
       h('span', { className: 'ddt-errorCode' }, error.code),
       h('div', { className: 'ddt-actions dim-viewActions' },
         h(Button, { kind: 'primary', onClick: onRetry, disabled: busy }, '重新生成二维码'),
@@ -242,6 +243,7 @@ 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.error ? h(ConnectionError, { error: account.error, showMessage: false }) : null,
           account.lastMessageError ? h(LastMessageErrorSummary, {
             className: 'ddt-summary',
             error: account.lastMessageError,
@@ -259,6 +261,7 @@ export function AccountCard({
 }
 
 export function QqSettingsTab({ rpcCall }) {
+  const [operationError, setOperationError] = React.useState(null);
   const [model, setModel] = React.useState({
     phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null,
     agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
@@ -289,7 +292,16 @@ export function QqSettingsTab({ rpcCall }) {
 
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
     if (typeof rpcCall !== 'function') throw new TypeError('QQ 设置页缺少 RPC 连接');
-    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+    const operation = !['connection.status', 'provision.poll', 'provision.begin', 'provision.cancel'].includes(endpoint);
+      if (operation && mounted.current) setOperationError(null);
+      try {
+        const value = unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+        if (operation && mounted.current) setOperationError(value?.testMessage?.error ?? value?.warnings?.[0] ?? null);
+        return value;
+      } catch (error) {
+        if (operation && mounted.current && !signal?.aborted && error?.name !== 'AbortError') setOperationError(normalizeConnectionError(error));
+        throw error;
+      }
   }, [rpcCall]);
 
   const loadStatus = React.useCallback(async ({ signal, silent = false, restore = false } = {}) => {
@@ -558,6 +570,7 @@ export function QqSettingsTab({ rpcCall }) {
   }, h(AgentPresetCatalogContext.Provider, {
     value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
   }, h('section', { className: 'ddt-page dqq-page dim-channelPage', 'aria-label': 'QQ 设置' },
+    operationError ? h(ConnectionError, { error: operationError }) : null,
     h(Heading, {
       totals: model.totals,
       adding: Boolean(provision),
@@ -569,7 +582,7 @@ export function QqSettingsTab({ rpcCall }) {
     }),
     model.phase === 'loading' ? h(LoadingView)
       : model.phase === 'error'
-        ? h('div', { className: 'ddt-card dim-surfaceCard' }, h('div', { className: 'ddt-inlineError dim-inlineError' }, h('h3', null, '无法读取 QQ 机器人状态'), h('p', null, model.error?.message), h(Button, { onClick: () => void loadStatus() }, '重新读取')))
+        ? h('div', { className: 'ddt-card dim-surfaceCard' }, h('div', { className: 'ddt-inlineError dim-inlineError' }, h('h3', null, '无法读取 QQ 机器人状态'), h(ConnectionError, { error: model.error }), h(Button, { onClick: () => void loadStatus() }, '重新读取')))
         : h(React.Fragment, null,
             credentialView,
             provisionView,

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

@@ -1,3 +1,4 @@
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
 import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
@@ -49,7 +50,8 @@ export function createTokenChannelApi(channel, connectionSummary, {
     if (!result.ok) {
       const error = new Error(text(result.error?.message, `${channel} 操作失败`));
       error.code = text(result.error?.code, `${channel.toUpperCase()}_RPC_ERROR`, 80);
-      throw error;
+      Object.assign(error, diagnosticFields(result.error));
+    throw error;
     }
     return result.value;
   };
@@ -85,6 +87,7 @@ export function createTokenChannelApi(channel, connectionSummary, {
       },
       lastMessageError: normalizeLastMessageError(value.lastMessageError),
       error: isRecord(value.error) ? {
+        ...diagnosticFields(value.error),
         code: text(value.error.code, `${channel.toUpperCase()}_ACCOUNT_ERROR`, 80),
         message: text(value.error.message, `${channel}连接尚未就绪`),
       } : null,
@@ -109,6 +112,7 @@ export function createTokenChannelApi(channel, connectionSummary, {
   };
 
   const presentError = (error) => ({
+    ...diagnosticFields(error),
     code: text(error?.code, `${channel.toUpperCase()}_ERROR`, 80),
     message: text(error?.message, `${channel}操作失败，请稍后重试`),
   });

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

@@ -1,3 +1,4 @@
+import { ConnectionError, normalizeConnectionError } from '../../connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
@@ -82,7 +83,7 @@ export function createTokenChannelSettings(definition) {
     accountSettingsEndpoint = null,
   } = definition;
 
-  function AccountCard({ account, busy, testNotice, removing, onReconnect, onWorkspaceSave, onAliasSave, onModelSave, onAgentPresetSave, onContextEnhancementSave, onAccountSettingsSave, onRequestRemove, onConfirmRemove, onCancelRemove }) {
+  function AccountCard({ account, busy, testNotice, removing, onReconnect, onWorkspaceSave, onAliasSave, onModelSave, onAgentPresetSave, onContextEnhancementSave, onAccountSettingsSave, onRequestRemove, onConfirmRemove, onCancelRemove, rpcCall, reload }) {
     const state = busy === 'reconnect' ? 'connecting' : account.state;
     const tone = account.connected ? 'success' : state === 'error' ? 'error' : 'warning';
     const stateLabel = account.connected ? '运行正常' : state === 'connecting' ? '正在连接' : '连接未就绪';
@@ -144,6 +145,11 @@ export function createTokenChannelSettings(definition) {
           account,
           busy: Boolean(busy),
           onSave: onAccountSettingsSave,
+          // Channels with extra settings panels (email session binding) call
+          // their own endpoints through the same RPC bridge.
+          rpcCall,
+          endpoints,
+          onChanged: reload,
         }) : null,
         h('div', { className: 'ddt-accountFooter dim-cardFooter' },
           h('div', { className: 'dim-cardFooterLayout' },
@@ -160,6 +166,7 @@ export function createTokenChannelSettings(definition) {
                 disabled: Boolean(busy),
               }, '移除接入')),
             summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.error ? h(ConnectionError, { error: account.error, showMessage: false }) : null,
             account.lastMessageError ? h(LastMessageErrorSummary, {
               className: 'ddt-summary',
               error: account.lastMessageError,
@@ -180,6 +187,7 @@ export function createTokenChannelSettings(definition) {
   }
 
   function SettingsTab({ rpcCall }) {
+    const [operationError, setOperationError] = React.useState(null);
     const [model, setModel] = React.useState({
       phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null,
       agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
@@ -207,7 +215,16 @@ export function createTokenChannelSettings(definition) {
 
     const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
       if (typeof rpcCall !== 'function') throw new TypeError(`${channel} 设置页缺少 RPC 连接`);
-      return api.unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+      const operation = !['connection.status', 'provision.poll', 'provision.begin', 'provision.cancel'].includes(endpoint);
+      if (operation && mounted.current) setOperationError(null);
+      try {
+        const value = api.unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+        if (operation && mounted.current) setOperationError(value?.testMessage?.error ?? value?.warnings?.[0] ?? null);
+        return value;
+      } catch (error) {
+        if (operation && mounted.current && !signal?.aborted && error?.name !== 'AbortError') setOperationError(normalizeConnectionError(error));
+        throw error;
+      }
     }, [rpcCall]);
 
     const loadStatus = React.useCallback(async ({ signal, silent = false } = {}) => {
@@ -331,6 +348,8 @@ export function createTokenChannelSettings(definition) {
           h('ul', { className: 'ddt-list dim-botList' }, model.bots.map((account) =>
             h('li', { key: account.botId }, h(AccountCard, {
               account,
+              rpcCall,
+              reload: loadStatus,
               busy: busyByBot[account.botId],
               testNotice: testNoticeByBot[account.botId],
               removing: removeTarget === account.botId,
@@ -398,6 +417,7 @@ export function createTokenChannelSettings(definition) {
       className: `ddt-page ${pageClass} dim-channelPage`,
       'aria-label': `${channel} 设置`,
     },
+    operationError ? h(ConnectionError, { error: operationError }) : null,
     h('div', { className: 'ddt-heading' },
       h('div', { className: 'ddt-tools' },
         h('div', { className: 'dim-bindActions' },
@@ -422,7 +442,7 @@ export function createTokenChannelSettings(definition) {
         ? h('div', { className: 'ddt-card dim-surfaceCard' },
             h('div', { className: 'ddt-inlineError dim-inlineError' },
               h('h3', null, `无法读取 ${channel} 机器人状态`),
-              h('p', null, model.error?.message),
+              h(ConnectionError, { error: model.error }),
               h(Button, { onClick: () => void loadStatus() }, '重新读取')))
         : h(React.Fragment, null,
             credentialOpen ? (CredentialPanel
@@ -433,6 +453,11 @@ export function createTokenChannelSettings(definition) {
                   error: credentialError,
                   onSubmit: bindCredentials,
                   onCancel: () => { setCredentialOpen(false); setCredentialError(null); },
+                  // A transport that authorizes out of band (the Agent mailbox
+                  // shows a QR code) drives its own endpoints through the bridge.
+                  rpcCall,
+                  endpoints,
+                  onAuthorized: bindCredentials,
                 })
               : h(CredentialBindingPanel, {
                   channel,

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

@@ -1,3 +1,4 @@
+import { ConnectionError } from '../../connection-error.js';
 import * as React from 'react';
 
 import { SlackLogoGlyph } from '../../channel-logos.js';
@@ -89,7 +90,7 @@ export function SlackCredentialPanel({ busy, error, onSubmit, onCancel }) {
           required: true,
         })),
       h('p', { className: 'dsl-tokenHint' }, 'Bot Token 来自 OAuth & Permissions；App Token 来自 Basic Information，并且必须包含 connections:write。')),
-    error ? h('p', { className: 'dim-credentialError', role: 'alert' }, error.message ?? String(error)) : null,
+    error ? h(ConnectionError, { error: error }) : null,
     h('div', { className: 'ddt-actions dim-viewActions dim-credentialActions' },
       h('button', {
         type: 'submit',

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

@@ -1,3 +1,5 @@
+import { normalizeConnectionError as normalizeTestError } from '../../connection-error.js';
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
 import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
@@ -53,7 +55,7 @@ function normalizeTestMessage(value) {
   const code = value.code === 'test-target-unavailable'
     ? 'test-target-unavailable'
     : 'test-message-failed';
-  return { sent: false, code };
+  return { sent: false, code, ...(value.error ? { error: normalizeTestError(value.error) } : {}) };
 }
 
 export function unwrapRpcResult(result) {
@@ -61,6 +63,7 @@ export function unwrapRpcResult(result) {
   if (!result.ok) {
     const error = new Error(text(result.error?.message, '企业微信操作失败'));
     error.code = text(result.error?.code, 'WECOM_RPC_ERROR', 80);
+    Object.assign(error, diagnosticFields(result.error));
     throw error;
   }
   return result.value;
@@ -88,6 +91,7 @@ export function normalizeProvisioning(value, now = Date.now()) {
   if (qrCodeDataUrl) result.qrCodeDataUrl = qrCodeDataUrl;
   if (id(source.botId)) result.botId = id(source.botId);
   if (isRecord(source.error)) result.error = {
+    ...diagnosticFields(source.error),
     code: text(source.error.code, 'WECOM_PROVISION_FAILED', 80),
     message: text(source.error.message, '企业微信机器人没有接入完成'),
   };
@@ -120,6 +124,7 @@ function normalizeBot(value) {
     },
     lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
+      ...diagnosticFields(value.error),
       code: text(value.error.code, 'WECOM_ACCOUNT_ERROR', 80),
       message: text(value.error.message, '企业微信连接尚未就绪'),
     } : null,
@@ -143,6 +148,7 @@ export function normalizeSnapshot(value) {
 
 export function presentError(error) {
   return {
+    ...diagnosticFields(error),
     code: text(error?.code, 'WECOM_ERROR', 80),
     message: text(error?.message, '企业微信操作失败，请稍后重试'),
   };

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

@@ -1,3 +1,4 @@
+import { ConnectionError, normalizeConnectionError } from '../../connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
@@ -150,7 +151,7 @@ function ProvisionView({ provision, busy, onRetry, onClose }) {
   return h('div', { className: 'ddt-card dim-surfaceCard' },
     h('div', { className: 'ddt-inlineError dim-inlineError', role: 'alert' },
       h('h3', null, '企业微信机器人没有绑定完成'),
-      h('p', null, error.message),
+      h(ConnectionError, { error: error }),
       h('span', { className: 'ddt-errorCode' }, error.code),
       h('div', { className: 'ddt-actions dim-viewActions' },
         h(Button, { kind: 'primary', onClick: onRetry, disabled: busy }, '重新生成二维码'),
@@ -241,6 +242,7 @@ 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.error ? h(ConnectionError, { error: account.error, showMessage: false }) : null,
           account.lastMessageError ? h(LastMessageErrorSummary, {
             className: 'ddt-summary',
             error: account.lastMessageError,
@@ -258,6 +260,7 @@ export function AccountCard({
 }
 
 export function WecomSettingsTab({ rpcCall }) {
+  const [operationError, setOperationError] = React.useState(null);
   const [model, setModel] = React.useState({
     phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null,
     agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
@@ -309,7 +312,16 @@ export function WecomSettingsTab({ rpcCall }) {
 
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
     if (typeof rpcCall !== 'function') throw new TypeError('企业微信设置页缺少 RPC 连接');
-    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+    const operation = !['connection.status', 'provision.poll', 'provision.begin', 'provision.cancel'].includes(endpoint);
+      if (operation && mounted.current) setOperationError(null);
+      try {
+        const value = unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+        if (operation && mounted.current) setOperationError(value?.testMessage?.error ?? value?.warnings?.[0] ?? null);
+        return value;
+      } catch (error) {
+        if (operation && mounted.current && !signal?.aborted && error?.name !== 'AbortError') setOperationError(normalizeConnectionError(error));
+        throw error;
+      }
   }, [rpcCall]);
 
   const loadStatus = React.useCallback(async ({ signal, silent = false, restore = false } = {}) => {
@@ -589,6 +601,7 @@ export function WecomSettingsTab({ rpcCall }) {
   }, h(AgentPresetCatalogContext.Provider, {
     value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
   }, h('section', { className: 'ddt-page dwecom-page dim-channelPage', 'aria-label': '企业微信设置' },
+    operationError ? h(ConnectionError, { error: operationError }) : null,
     h(Heading, {
       totals: model.totals,
       adding: Boolean(provision),
@@ -601,7 +614,7 @@ export function WecomSettingsTab({ rpcCall }) {
     h('div', { className: 'ddt-visuallyHidden', role: 'status', 'aria-live': 'polite' }, notice),
     model.phase === 'loading' ? h(LoadingView)
       : model.phase === 'error'
-        ? h('div', { className: 'ddt-card dim-surfaceCard' }, h('div', { className: 'ddt-inlineError dim-inlineError' }, h('h3', null, '无法读取企业微信机器人状态'), h('p', null, model.error?.message), h(Button, { onClick: () => void loadStatus() }, '重新读取')))
+        ? h('div', { className: 'ddt-card dim-surfaceCard' }, h('div', { className: 'ddt-inlineError dim-inlineError' }, h('h3', null, '无法读取企业微信机器人状态'), h(ConnectionError, { error: model.error }), h(Button, { onClick: () => void loadStatus() }, '重新读取')))
         : h(React.Fragment, null,
             credentialView,
             provisionView,

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

@@ -1,3 +1,5 @@
+import { normalizeConnectionError as normalizeTestError } from '../../connection-error.js';
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
 import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
@@ -55,7 +57,7 @@ function normalizeTestMessage(value) {
   const code = value.code === 'test-target-unavailable'
     ? 'test-target-unavailable'
     : 'test-message-failed';
-  return { sent: false, code };
+  return { sent: false, code, ...(value.error ? { error: normalizeTestError(value.error) } : {}) };
 }
 
 export function unwrapRpcResult(result) {
@@ -63,6 +65,7 @@ export function unwrapRpcResult(result) {
   if (!result.ok) {
     const error = new Error(text(result.error?.message, '企业微信应用操作失败'));
     error.code = text(result.error?.code, 'WECOM_APP_RPC_ERROR', 80);
+    Object.assign(error, diagnosticFields(result.error));
     throw error;
   }
   return result.value;
@@ -99,6 +102,7 @@ function normalizeBot(value) {
     },
     lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
+      ...diagnosticFields(value.error),
       code: text(value.error.code, 'WECOM_APP_ACCOUNT_ERROR', 80),
       message: text(value.error.message, '企业微信应用连接尚未就绪'),
     } : null,
@@ -121,6 +125,7 @@ export function normalizeSnapshot(value) {
 
 export function presentError(error) {
   return {
+    ...diagnosticFields(error),
     code: text(error?.code, 'WECOM_APP_ERROR', 80),
     message: text(error?.message, '企业微信应用操作失败，请稍后重试'),
   };