@xmanrui/dsh-im 4.34.1 → 4.34.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.34.1",
+  "version": "4.34.2",
   "icon": "./assets/logo-plugin-message-link-gradient.webp",
   "description": "把微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix接入DSH。 Connect Telegram, WhatsApp, Slack, Discord, Matrix, WeChat, Feishu, WeCom, DingTalk, and QQ to DSH.",
   "keywords": [

package/plugin-src/client/bot-settings-tabs.js

@@ -0,0 +1,114 @@
+import * as React from 'react';
+
+import { h } from './i18n.js';
+
+// Scroll only the tab strip: scrollIntoView can also move the host settings page.
+function revealTab(strip, tab) {
+  if (!strip || !tab) return;
+  const viewport = strip.getBoundingClientRect();
+  const bounds = tab.getBoundingClientRect();
+  if (bounds.left < viewport.left) strip.scrollLeft += bounds.left - viewport.left;
+  else if (bounds.right > viewport.right) strip.scrollLeft += bounds.right - viewport.right;
+}
+
+export function BotSettingsTabs({ tabs, activeTabId, onChange }) {
+  const barRef = React.useRef(null);
+  const stripRef = React.useRef(null);
+  const listRef = React.useRef(null);
+  const [scroll, setScroll] = React.useState({ overflow: false, left: false, right: false });
+
+  const measure = React.useCallback(() => {
+    const bar = barRef.current;
+    const strip = stripRef.current;
+    const list = listRef.current;
+    if (!bar || !strip || !list) return;
+    const next = {
+      // Compare against the whole bar, so arrows disappear as soon as all tabs fit.
+      overflow: list.scrollWidth > bar.clientWidth + 1,
+      left: strip.scrollLeft > 1,
+      right: strip.scrollWidth - strip.clientWidth - strip.scrollLeft > 1,
+    };
+    setScroll((previous) => Object.keys(next).every((key) => next[key] === previous[key])
+      ? previous : next);
+  }, []);
+
+  React.useEffect(() => {
+    const strip = stripRef.current;
+    if (!strip) return undefined;
+    const refresh = () => {
+      revealTab(strip, strip.querySelector('[aria-selected="true"]'));
+      measure();
+    };
+    refresh();
+    const view = strip.ownerDocument.defaultView;
+    const observer = view.ResizeObserver ? new view.ResizeObserver(refresh) : null;
+    for (const node of [barRef.current, strip, listRef.current]) observer?.observe(node);
+    view.addEventListener('resize', refresh);
+    return () => {
+      observer?.disconnect();
+      view.removeEventListener('resize', refresh);
+    };
+  }, [tabs, activeTabId, scroll.overflow, measure]);
+
+  const scrollTabs = (direction) => {
+    const strip = stripRef.current;
+    if (!strip) return;
+    strip.scrollLeft += direction * Math.max(80, strip.clientWidth * 0.75);
+    measure();
+  };
+
+  const handleKeyDown = (event, index) => {
+    let next;
+    if (event.key === 'Home') next = 0;
+    else if (event.key === 'End') next = tabs.length - 1;
+    else if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') {
+      next = (index + (event.key === 'ArrowRight' ? 1 : -1) + tabs.length) % tabs.length;
+    }
+    if (next === undefined) return;
+    event.preventDefault();
+    onChange(tabs[next].id);
+    const target = stripRef.current?.querySelectorAll('[role="tab"]')[next];
+    target?.focus({ preventScroll: true });
+    revealTab(stripRef.current, target);
+  };
+
+  const arrow = (direction, label, enabled) => scroll.overflow ? h('button', {
+    type: 'button',
+    className: 'dim-botSettingsScroll',
+    'aria-label': label,
+    title: label,
+    disabled: !enabled,
+    onClick: () => scrollTabs(direction),
+  }, h('svg', { width: 16, height: 16, viewBox: '0 0 16 16', 'aria-hidden': 'true' },
+    h('path', {
+      d: direction < 0 ? 'M10 3 5 8l5 5' : 'm6 3 5 5-5 5',
+      fill: 'none', stroke: 'currentColor', strokeWidth: 1.5,
+      strokeLinecap: 'round', strokeLinejoin: 'round',
+    }))) : null;
+
+  return h('div', { ref: barRef, className: 'dim-botSettingsTabsBar' },
+    arrow(-1, '向左滚动设置页签', scroll.left),
+    h('nav', {
+      ref: stripRef,
+      className: 'dim-botSettingsTabs',
+      role: 'tablist',
+      'aria-label': '机器人设置页签',
+      onScroll: measure,
+    }, h('div', { ref: listRef, className: 'dim-botSettingsTabsList', role: 'presentation' },
+      tabs.map((tab, index) => h('button', {
+        key: tab.id,
+        id: `dim-bot-settings-${tab.id}-tab`,
+        type: 'button',
+        role: 'tab',
+        className: 'dim-botSettingsTab',
+        'aria-selected': tab.id === activeTabId,
+        'aria-controls': `dim-bot-settings-${tab.id}-panel`,
+        tabIndex: tab.id === activeTabId ? 0 : -1,
+        onClick: (event) => {
+          onChange(tab.id);
+          revealTab(stripRef.current, event?.currentTarget);
+        },
+        onKeyDown: (event) => handleKeyDown(event, index),
+      }, tab.label)))),
+    arrow(1, '向右滚动设置页签', scroll.right));
+}

package/plugin-src/client/delivery-settings.js

@@ -1,6 +1,7 @@
 import * as React from 'react';
 
 import { AccessPolicySettingsPage } from './access-policy-settings.js';
+import { BotSettingsTabs } from './bot-settings-tabs.js';
 import { FeishuGroupSettingsPage } from './channels/feishu/group-settings.js';
 import { FeishuVoiceSettingsPage } from './channels/feishu/voice-settings.js';
 import { FeishuSlashPanelSettingsPage } from './channels/feishu/slash-panel-settings.js';
@@ -770,22 +771,7 @@ export function DeliveryTargetSettingsPage({
   },
   h('header', { className: 'dim-deliveryHeader' },
     h(DeliveryButton, { className: 'dim-deliveryBack', onClick: onBack }, '← 返回机器人列表')),
-  h('div', { className: 'dim-botSettingsTabsBar' },
-    h('nav', {
-      className: 'dim-botSettingsTabs',
-      role: 'tablist',
-      'aria-label': '机器人设置页签',
-    }, settingsTabs.map((tab) => h('button', {
-      key: tab.id,
-      id: `dim-bot-settings-${tab.id}-tab`,
-      type: 'button',
-      role: 'tab',
-      className: 'dim-botSettingsTab',
-      'aria-selected': tab.id === activeTab.id,
-      'aria-controls': `dim-bot-settings-${tab.id}-panel`,
-      tabIndex: tab.id === activeTab.id ? 0 : -1,
-      onClick: () => setActiveTabId(tab.id),
-    }, tab.label)))),
+  h(BotSettingsTabs, { tabs: settingsTabs, activeTabId: activeTab.id, onChange: setActiveTabId }),
   h('div', {
     id: activePanelId,
     className: 'dim-botSettingsTabPanel',

package/plugin-src/client/i18n.js

@@ -48,6 +48,8 @@ const EN = Object.freeze({
   'IM 面板加载失败': 'Could not load the IM panel',
   '更多机器人设置': 'More bot settings',
   '更多设置': 'More settings',
+  '向左滚动设置页签': 'Scroll settings tabs left',
+  '向右滚动设置页签': 'Scroll settings tabs right',
   '常用配置': 'Common settings',
   '机器人设置': 'Bot settings',
   '机器人设置页签': 'Bot settings tabs',

package/plugin-src/client/styles.js

@@ -467,9 +467,14 @@ const CSS = String.raw`
 .dim-moreSettingsChevron { width: 6px; height: 6px; margin-right: 2px; border-right: 1.5px solid currentColor; border-bottom: 1.5px solid currentColor; transform: rotate(-45deg); }
 .dim-deliveryPage { min-width: 0; display: grid; }
 .dim-deliveryHeader { min-width: 0; display: flex; align-items: center; justify-content: space-between; gap: 16px; }
-.dim-botSettingsTabsBar { min-width: 0; margin-top: 10px; border-bottom: 1px solid var(--dsw-alias-border-l2, #dfe1e5); }
-.dim-botSettingsTabs { min-width: 0; display: flex; align-items: flex-end; gap: 24px; overflow-x: auto; scrollbar-width: none; }
+.dim-botSettingsTabsBar { min-width: 0; display: flex; align-items: center; gap: 4px; margin-top: 10px; border-bottom: 1px solid var(--dsw-alias-border-l2, #dfe1e5); }
+.dim-botSettingsTabs { min-width: 0; flex: 1; overflow-x: auto; overscroll-behavior-x: contain; scrollbar-width: none; }
 .dim-botSettingsTabs::-webkit-scrollbar { display: none; }
+.dim-botSettingsTabsList { width: max-content; min-width: 100%; display: flex; align-items: flex-end; gap: 24px; }
+.dim-botSettingsScroll { flex: 0 0 30px; width: 30px; height: 32px; display: inline-flex; align-items: center; justify-content: center; padding: 0; border: 0; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-secondary, #646a73); cursor: pointer; }
+.dim-botSettingsScroll:hover:not(:disabled) { color: var(--dsw-alias-state-business-primary, #3370ff); background: var(--dsw-alias-interactive-bg-hover, #eef0f3); }
+.dim-botSettingsScroll:disabled { opacity: .3; cursor: default; }
+.dim-botSettingsScroll:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: -2px; }
 .dim-botSettingsTab { position: relative; min-height: 38px; flex: none; display: inline-flex; align-items: center; justify-content: center; padding: 6px 2px 9px; border: 0; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; font: inherit; font-size: 13px; line-height: 20px; font-weight: 560; white-space: nowrap; cursor: pointer; transition: color .15s ease; }
 .dim-botSettingsTab::after { content: ''; position: absolute; right: 0; bottom: -1px; left: 0; height: 2px; border-radius: 2px 2px 0 0; background: transparent; transform: scaleX(.45); transition: background .15s ease, transform .15s ease; }
 .dim-botSettingsTab:hover:not([aria-selected="true"]) { color: var(--dsw-alias-label-primary, #1f2329); }
@@ -735,7 +740,7 @@ const CSS = String.raw`
   .dim-loopbackRecovery { align-items: stretch; flex-direction: column; gap: 12px; }
   .dim-loopbackRecoveryAction { width: 100%; }
   .dim-deliverySectionHeading { align-items: stretch; flex-direction: column; }
-  .dim-botSettingsTabs { gap: 18px; }
+  .dim-botSettingsTabsList { gap: 18px; }
   .dim-deliveryBotId { grid-template-columns: minmax(0, 1fr) max-content; }
   .dim-deliveryBotId > span { grid-column: 1 / -1; }
   .dim-targetActions .dim-deliveryButton { flex: 1 1 auto; }

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

@@ -35,6 +35,7 @@ import { createDeliveryAdapter } from '../../delivery-adapter.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
+  newBotAccessPolicyFor,
 } from '../shared/access-policy-production.mjs';
 
 // The WebSocket agent built here is only used for the Feishu long connection,
@@ -230,7 +231,7 @@ export async function createProductionController(ctx, config = {}, internals = {
       const id = botId ?? botConfig.id ?? botConfig.appId;
       await workspaces.ensure(id, {
         defaultAgentPreset: config.agentPreset,
-        initialAccessPolicy: initialAccessPolicyFor('feishu', botConfig),
+        initialAccessPolicy: newBotAccessPolicyFor('feishu', botConfig),
       });
       const workspaceScope = createBotWorkspaceScope(harness, {
         botId: id, workspaces, state, agentPresetCatalog,

package/plugin-src/host/channels/qq/production.mjs

@@ -30,6 +30,7 @@ import {
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
+  newBotAccessPolicyFor,
 } from '../shared/access-policy-production.mjs';
 
 function pluginPaths(config) {
@@ -117,7 +118,7 @@ export async function createProductionController(ctx, config = {}, internals = {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, {
         defaultAgentPreset: config.agentPreset,
-        initialAccessPolicy: initialAccessPolicyFor('qq', botConfig),
+        initialAccessPolicy: newBotAccessPolicyFor('qq', botConfig),
       });
       const workspaceScope = createBotWorkspaceScope(harness, {
         botId, workspaces, state, agentPresetCatalog,

package/plugin-src/host/channels/shared/access-policy-production.mjs

@@ -97,6 +97,19 @@ export function initialAccessPolicyFor(channel, config = {}) {
   throw new TypeError(`Unsupported access-policy channel: ${channel}`);
 }
 
+/**
+ * Seed newly connected bots after startup has migrated existing bots with
+ * initialAccessPolicyFor(). Open Feishu/QQ messages and commands in both chat
+ * types; workspace ensure() preserves any policy already saved.
+ */
+export function newBotAccessPolicyFor(channel, config = {}) {
+  const key = String(channel ?? '').trim().toLowerCase();
+  if (key === 'feishu' || key === 'qq') {
+    return createAccessPolicy({ direct: openScope(), group: openScope() });
+  }
+  return initialAccessPolicyFor(channel, config);
+}
+
 export function privilegedSenderIdsFor(channel, config = {}) {
   const key = String(channel ?? '').trim().toLowerCase();
   if (key === 'weixin') return cleanIds(config.ownerUserId);

package/plugin-src/host/modern-harness-api.mjs

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 
 import { hasActiveHarnessInteractionOwner } from '../../src/channels/shared/harness-client.mjs';
+import { extractConnectionEvidence } from '../../src/channels/shared/connection-error.mjs';
 
 const modernApis = new WeakMap();
 
@@ -25,7 +26,7 @@ function failureOf(error) {
   return {
     code: 'internal',
     message: error instanceof Error ? error.message : String(error),
-    details: {},
+    details: extractConnectionEvidence(error).details,
   };
 }
 

package/src/channels/feishu/bridge.mjs

@@ -1,6 +1,7 @@
 import { isPermissionCommand, runPermissionCommand } from '../shared/permission-command.mjs';
 import { randomUUID } from 'node:crypto';
 import QRCode from 'qrcode';
+import { waitForFeishuOperation } from './feishu-channel.mjs';
 import {
   conversationKey,
   conversationScope,
@@ -77,6 +78,7 @@ import {
 import {
   channelDeliveryFailure,
   clearLastMessageFailure,
+  messageFailureDiagnostic,
   messageFailureText,
   setLastMessageFailure,
 } from '../shared/message-failure.mjs';
@@ -720,6 +722,7 @@ export class FeishuHarnessBridge {
   /** Conversation keys with an IM ask in flight (set BEFORE the turn starts). */
   #imTurnKeys = new Set();
   #cardDataTimeoutMs;
+  #requestTimeoutMs;
   /** When true, approval/question interactions render as Feishu cards (buttons). */
   #interactionCards = true;
 
@@ -744,6 +747,7 @@ export class FeishuHarnessBridge {
     repairPollIntervalMs = REPAIR_POLL_INTERVAL_MS,
     repairLinkWaitMs = REPAIR_LINK_WAIT_MS,
     cardDataTimeoutMs = CARD_DATA_TIMEOUT_MS,
+    requestTimeoutMs = 15_000,
     replyTimeoutMs = 600_000,
     interactionCards = true,
     sessionSyncTargetsFor = null,
@@ -766,7 +770,8 @@ export class FeishuHarnessBridge {
     }
     if (!Number.isFinite(repairPollIntervalMs) || repairPollIntervalMs <= 0
       || !Number.isFinite(repairLinkWaitMs) || repairLinkWaitMs <= 0
-      || !Number.isFinite(cardDataTimeoutMs) || cardDataTimeoutMs <= 0) {
+      || !Number.isFinite(cardDataTimeoutMs) || cardDataTimeoutMs <= 0
+      || !Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) {
       throw new TypeError('Feishu timing values must be positive numbers');
     }
     if (stepPushClock !== null
@@ -803,6 +808,7 @@ export class FeishuHarnessBridge {
     this.#repairPollIntervalMs = repairPollIntervalMs;
     this.#repairLinkWaitMs = repairLinkWaitMs;
     this.#cardDataTimeoutMs = cardDataTimeoutMs;
+    this.#requestTimeoutMs = requestTimeoutMs;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#interactionCards = interactionCards === true;
     this.#sessionSyncTargetsFor = typeof sessionSyncTargetsFor === 'function'
@@ -1493,7 +1499,7 @@ export class FeishuHarnessBridge {
     const failure = setLastMessageFailure(this.#status, error, { userMessage, reason });
     this.#logger?.[logLevel]?.(
       `[dsh-feishu] ${logLabel} failed [${failure.referenceId}]:`,
-      error?.message ?? String(error),
+      messageFailureDiagnostic(error, failure),
     );
     return failure;
   }
@@ -3127,6 +3133,14 @@ export class FeishuHarnessBridge {
     }
   }
 
+  #cardRequest(stage, operation) {
+    return waitForFeishuOperation(operation, {
+      signal: this.#signal,
+      timeoutMs: this.#requestTimeoutMs,
+      stage: `${stage} (${this.#requestTimeoutMs}ms)`,
+    });
+  }
+
   async #sendCard(chatId, cardJson, options = {}) {
     const updateMessageId = nonEmptyString(options.updateMessageId);
     const replyTo = nonEmptyString(options.replyTo);
@@ -3134,14 +3148,14 @@ export class FeishuHarnessBridge {
     // Session-sync cards target the user's openId (the synced DM is a user,
     // not a chat), delivered fresh without topic/thread handling.
     if (options.receiveIdType === 'open_id') {
-      const response = await this.#client.im.v1.message.create({
+      const response = await this.#cardRequest('card create', () => this.#client.im.v1.message.create({
         params: { receive_id_type: 'open_id' },
         data: {
           receive_id: chatId,
           msg_type: 'interactive',
           content: cardJson,
         },
-      });
+      }));
       if (response?.code && response.code !== 0) {
         throw new Error(`Feishu card send failed: ${response.msg || response.code}`);
       }
@@ -3152,10 +3166,10 @@ export class FeishuHarnessBridge {
 
     if (updateMessageId) {
       try {
-        const response = await this.#client.im.v1.message.patch({
+        const response = await this.#cardRequest('card patch', () => this.#client.im.v1.message.patch({
           path: { message_id: updateMessageId },
           data: { content: cardJson },
-        });
+        }));
         if (response?.code && response.code !== 0) {
           throw new Error(`Feishu card update failed: ${response.msg || response.code}`);
         }
@@ -3172,14 +3186,14 @@ export class FeishuHarnessBridge {
     const content = cardJson;
     if (replyTo) {
       try {
-        const response = await this.#client.im.v1.message.reply({
+        const response = await this.#cardRequest('card reply', () => this.#client.im.v1.message.reply({
           path: { message_id: replyTo },
           data: {
             msg_type: 'interactive',
             content,
             ...(this.#replyInThreadFor(replyTo) ? { reply_in_thread: true } : {}),
           },
-        });
+        }));
         if (response?.code && response.code !== 0) {
           throw new Error(`Feishu card reply failed: ${response.msg || response.code}`);
         }
@@ -3195,10 +3209,10 @@ export class FeishuHarnessBridge {
         this.#forgetTopicRoot(replyTo);
       }
     }
-    const response = await this.#client.im.v1.message.create({
+    const response = await this.#cardRequest('card create', () => this.#client.im.v1.message.create({
       params: { receive_id_type: 'chat_id' },
       data: { receive_id: chatId, msg_type: 'interactive', content: cardJson },
-    });
+    }));
     if (response?.code && response.code !== 0) {
       throw new Error(`Feishu card send failed: ${response.msg || response.code}`);
     }
@@ -4834,7 +4848,8 @@ export class FeishuHarnessBridge {
       );
       if (card.deliveryViaOpenId) {
         this.#logger.warn?.('[dsh-feishu] session-sync mirror card render failed:',
-          error?.message ?? String(error));
+          error?.message ?? String(error),
+          { sessionId: card.sessionSyncSessionId, turn: card.sessionSyncTurn });
       }
     }
   }
@@ -4885,6 +4900,7 @@ export class FeishuHarnessBridge {
       this.#logger.warn?.(
         '[dsh-feishu] step streaming card finish failed:',
         error?.message ?? String(error),
+        { sessionId: card.sessionSyncSessionId, turn: card.sessionSyncTurn },
       );
       return null;
     }
@@ -4935,10 +4951,10 @@ export class FeishuHarnessBridge {
   }
 
   async #patchStepCard(messageId, cardJson) {
-    const response = await this.#client.im.v1.message.patch({
+    const response = await this.#cardRequest('step card patch', () => this.#client.im.v1.message.patch({
       path: { message_id: messageId },
       data: { content: cardJson },
-    });
+    }));
     if (response?.code && response.code !== 0) {
       throw new Error(`Feishu step card patch failed: ${response.msg || response.code}`);
     }

package/src/channels/feishu/feishu-channel.mjs

@@ -80,12 +80,13 @@ function abortReason(signal) {
 }
 
 function operationTimeout(stage) {
-  const error = new Error(`Feishu file ${stage} timed out.`);
+  const error = new Error(`Feishu ${stage} timed out.`);
   error.code = 'provider-timeout';
   return error;
 }
 
-function waitForFileOperation(operation, { signal, timeoutMs, stage }) {
+// Bound the caller's wait even when the SDK does not honor cancellation.
+export function waitForFeishuOperation(operation, { signal, timeoutMs, stage = 'request' }) {
   signal?.throwIfAborted();
   const deadline = new AbortController();
   const operationSignal = signal
@@ -108,7 +109,10 @@ function waitForFileOperation(operation, { signal, timeoutMs, stage }) {
     const timer = setTimeout(() => deadline.abort(), timeoutMs);
     operationSignal.addEventListener('abort', onAbort, { once: true });
 
-    Promise.resolve().then(() => operation(operationSignal)).then(
+    Promise.resolve().then(() => {
+      operationSignal.throwIfAborted();
+      return operation(operationSignal);
+    }).then(
       (value) => finish(resolve, value),
       (error) => finish(reject, error),
     );
@@ -116,6 +120,10 @@ function waitForFileOperation(operation, { signal, timeoutMs, stage }) {
   });
 }
 
+function waitForFileOperation(operation, { stage, ...options }) {
+  return waitForFeishuOperation(operation, { ...options, stage: `file ${stage}` });
+}
+
 function deliveryUuid(file, chatId, messageType) {
   const seed = `${file.deliveryKey}\u0000${chatId}`;
   const digest = createHash('sha256')

package/src/channels/feishu/feishu-runtime.mjs

@@ -2,7 +2,7 @@ import { createConnectionDiagnostics, atConnectionStage } from '../shared/connec
 import { randomUUID } from 'node:crypto';
 import { FeishuHarnessBridge } from './bridge.mjs';
 import { cardActionProbeCard } from './feishu-cards.mjs';
-import { VerifiedFeishuChannel } from './feishu-channel.mjs';
+import { VerifiedFeishuChannel, waitForFeishuOperation } from './feishu-channel.mjs';
 import { normalizeFeishuGroupResponseMode } from './group-response-mode.mjs';
 import { normalizeFeishuStepPushMode } from './step-push-mode.mjs';
 import { createVoice } from './voice.mjs';
@@ -367,6 +367,7 @@ export class FeishuRuntime {
         voice: this.#voice,
         sessionSyncTargetsFor: this.#sessionSyncTargetsFor,
         repair: this.#repair,
+        requestTimeoutMs: this.#requestTimeoutMs,
         replyTimeoutMs: this.#replyTimeoutMs,
         // Interaction cards (approval/question buttons) are on by default.
         // Set DSH_IM_INTERACTION_CARDS=0 to fall back to plain-text replies.
@@ -703,13 +704,20 @@ export class FeishuRuntime {
     const content = format === 'markdown'
       ? { schema: '2.0', body: { elements: [{ tag: 'markdown', content: text }] } }
       : { text };
-    const response = await this.#client.im.v1.message.create({
+    const activeSignal = signal
+      ? AbortSignal.any([signal, this.#abortController.signal])
+      : this.#abortController.signal;
+    const response = await waitForFeishuOperation(() => this.#client.im.v1.message.create({
       params: { receive_id_type: receiveIdType },
       data: {
         receive_id: receiveId,
         msg_type: format === 'markdown' ? 'interactive' : 'text',
         content: JSON.stringify(content),
       },
+    }), {
+      signal: activeSignal,
+      timeoutMs: this.#requestTimeoutMs,
+      stage: `proactive text send (${this.#requestTimeoutMs}ms)`,
     });
     if (response?.code && response.code !== 0) {
       const error = new Error(`Feishu proactive delivery failed: ${response.msg || response.code}`);

package/src/channels/shared/connection-error.mjs

@@ -6,7 +6,7 @@ import { t } from './i18n.mjs';
 const reported = new WeakMap();
 const lastReport = new WeakMap();
 const stages = new WeakMap();
-const OWNED_REASONS = { 'connect-timeout': 'timeout', 'telegram-timeout': 'timeout', 'cli-timeout': 'timeout', 'telegram-response-invalid': 'invalid-response', 'office-protocol-mismatch': 'invalid-response' };
+const OWNED_REASONS = { 'connect-timeout': 'timeout', 'telegram-timeout': 'timeout', 'cli-timeout': 'timeout', 'provider-timeout': 'timeout', 'telegram-response-invalid': 'invalid-response', 'office-protocol-mismatch': 'invalid-response' };
 const STANDARD_NAMES = new Set(['Error', 'TypeError', 'SyntaxError', 'AggregateError', 'DOMException', 'AxiosError', 'TimeoutError', 'AbortError']);
 const KNOWN_MESSAGES = {
   'discord-401': 'Discord Bot Token 无效，请重新填写。',
@@ -37,18 +37,24 @@ export function extractConnectionEvidence(error) {
   const { chain, truncated } = connectionErrorChain(error);
   const errors = chain.map(e => ({
     type: STANDARD_NAMES.has(e.name) ? e.name : 'Error',
+    // Host RPC adapters carry safe diagnostic facts without the original Error graph.
     ...normalizeDiagnosticDetails({
-      reason: OWNED_REASONS[e.code] ?? e.code ?? (e.name === 'TimeoutError' ? 'timeout' : e instanceof SyntaxError ? 'invalid-json' : undefined),
+      reason: e.details?.reason, reasons: e.details?.reasons,
+      httpStatus: e.details?.httpStatus, providerCode: e.details?.providerCode,
+    }),
+    ...normalizeDiagnosticDetails({
+      // DOMException TimeoutError has a numeric legacy code; its name is authoritative.
+      reason: OWNED_REASONS[e.code] ?? (e.name === 'TimeoutError' ? 'timeout' : e.code ?? (e instanceof SyntaxError ? 'invalid-json' : undefined)),
       httpStatus: e.status ?? e.statusCode ?? e.response?.status,
       providerCode: e.providerCode,
     }),
     hasCause: Boolean(e.cause && typeof e.cause === 'object'),
     hasErrors: Array.isArray(e.errors),
   }));
-  const allReasons = [...new Set(errors.map(e => e.reason).filter(r => r && !['unknown', 'multiple-causes'].includes(r)))];
+  const allReasons = [...new Set(errors.flatMap(e => e.reason === 'multiple-causes' ? e.reasons ?? [] : [e.reason]).filter(r => r && !['unknown', 'multiple-causes'].includes(r)))];
   const precise = allReasons.filter(r => !['timeout', 'http-error', 'provider-rejected', 'invalid-response'].includes(r));
   const reasons = precise.length ? precise : allReasons;
-  const first = field => chain.map(e => normalizeDiagnosticDetails({ [field]: e[field] })[field]).find(v => v !== undefined);
+  const first = field => chain.map(e => normalizeDiagnosticDetails({ [field]: e[field] ?? e.details?.[field] })[field]).find(v => v !== undefined);
   return {
     chain, errors,
     details: normalizeDiagnosticDetails({

package/src/channels/shared/i18n-en/shared-a.mjs

@@ -104,6 +104,10 @@ export default {
     'This message contains an image or file that cannot be processed. Adjust it and send it again.',
   '任务未完成，暂时无法确定原因。请重试；若持续发生，请将参考号提供给管理员。':
     'The task did not finish and the cause could not be determined. Try again; if it persists, give the reference ID to an administrator.',
+  '请求超时，当前操作结果尚未确认。请先检查任务状态或聊天记录，不要立即重复提交。':
+    'The request timed out and its outcome is unconfirmed. Check the task status or chat history before submitting it again.',
+  '网络请求失败，当前操作结果尚未确认。请先检查任务状态或聊天记录，不要立即重复提交。':
+    'The network request failed and its outcome is unconfirmed. Check the task status or chat history before submitting it again.',
   '错误码：{code}；参考号：{referenceId}': 'Error code: {code}; reference: {referenceId}',
   '{label}机器人': '{label} bot',
   '目前支持文字和图片消息。': 'Only text and image messages are supported at the moment.',

package/src/channels/shared/message-failure.mjs

@@ -1,4 +1,4 @@
-import { extractConnectionEvidence } from './connection-error.mjs';
+import { connectionHint, extractConnectionEvidence } from './connection-error.mjs';
 import { diagnosticFields } from './diagnostic-details.mjs';
 import { randomUUID } from 'node:crypto';
 
@@ -90,6 +90,10 @@ const FAILURE_MESSAGES = Object.freeze({
     '回复已经生成，但当前渠道暂时无法发送。请稍后重试。',
   INPUT_INVALID:
     '当前消息包含无法处理的图片或文件。请调整后重新发送。',
+  REQUEST_TIMEOUT:
+    '请求超时，当前操作结果尚未确认。请先检查任务状态或聊天记录，不要立即重复提交。',
+  NETWORK_ERROR:
+    '网络请求失败，当前操作结果尚未确认。请先检查任务状态或聊天记录，不要立即重复提交。',
   INTERNAL_UNKNOWN:
     '任务未完成，暂时无法确定原因。请重试；若持续发生，请将参考号提供给管理员。',
 });
@@ -156,16 +160,30 @@ function failureCode(error) {
     return 'CHANNEL_RATE_LIMIT';
   }
   if (['channel-delivery-uncertain', 'delivery-uncertain', 'artifact-delivery-uncertain']
-    .includes(code)) {
+    .includes(code) || error?.deliveryOutcome === 'unknown') {
     return 'CHANNEL_DELIVERY_UNCERTAIN';
   }
   if (code === 'channel-delivery-failed' || code.startsWith('artifact-')
-    || ['network-error', 'timeout'].includes(code)) {
+    || code === 'network-error') {
     return 'CHANNEL_DELIVERY';
   }
   return 'INTERNAL_UNKNOWN';
 }
 
+// Only refine the unknown fallback, using the same allowlisted evidence as the UI.
+// Mixed unrelated causes and cancellation do not establish a network diagnosis.
+function transportFailureCode(error, details) {
+  if (error?.name === 'AbortError' || error?.code === 'cancelled') return 'INTERNAL_UNKNOWN';
+  const reasons = details.reason === 'multiple-causes' ? details.reasons : [details.reason];
+  const timeout = reason => reason === 'timeout' || reason === 'ETIMEDOUT' || /_TIMEOUT$/u.test(reason);
+  if (reasons?.length && reasons.every(timeout)) return 'REQUEST_TIMEOUT';
+  const network = reason => timeout(reason) || [
+    'ENOTFOUND', 'EAI_AGAIN', 'ECONNREFUSED', 'ECONNRESET', 'EPIPE', 'UND_ERR_SOCKET',
+    'ENETUNREACH', 'EHOSTUNREACH', 'ERR_NETWORK_ACCESS_DENIED', 'ERR_PROXY_CONNECTION_FAILED',
+  ].includes(reason) || /CERT|TLS|SSL|ISSUER|SIGNATURE/u.test(reason);
+  return reasons?.length && reasons.every(network) ? 'NETWORK_ERROR' : 'INTERNAL_UNKNOWN';
+}
+
 function safeReferenceId(value) {
   return typeof value === 'string' && /^[A-Z0-9-]{6,40}$/u.test(value)
     ? value
@@ -185,13 +203,17 @@ export function classifyMessageFailure(error, {
 } = {}) {
   const safeReason = safeFailureReason(reason);
   const classifiedCode = failureCode(error);
-  const code = classifiedCode === 'INTERNAL_UNKNOWN'
+  const businessCode = classifiedCode === 'INTERNAL_UNKNOWN'
     && safeReason
     && typeof userMessage === 'string'
     && userMessage.trim()
     ? 'INPUT_INVALID'
     : classifiedCode;
   const details = extractConnectionEvidence(error).details;
+  const code = businessCode === 'INTERNAL_UNKNOWN'
+    ? transportFailureCode(error, details)
+    : businessCode;
+  if (code === 'REQUEST_TIMEOUT' || code === 'NETWORK_ERROR') details.hint = connectionHint(details);
   return Object.freeze({
     ...(code === 'INTERNAL_UNKNOWN' || details.reason !== 'unknown' || details.httpStatus || details.providerCode ? { details } : {}),
     code,

package/src/channels/shared/text-harness-bridge.mjs

@@ -936,12 +936,12 @@ export class TextHarnessBridge {
       const finalDeliveryUnknown = textReceipt?.deliveryOutcome === 'unknown';
       if (textReceipt?.deliveryOutcome === 'failed') {
         textDeliveryError = channelDeliveryFailure(
-          new Error(`Final text delivery failed (${textReceipt.reason ?? 'unknown'})`),
+          Object.assign(new Error('Final text delivery failed'), { code: textReceipt.reason }),
           { uncertain: false },
         );
       } else if (finalDeliveryUnknown) {
         textDeliveryError = channelDeliveryFailure(
-          new Error(`Final text delivery outcome is unknown (${textReceipt.reason ?? 'unknown'})`),
+          Object.assign(new Error('Final text delivery outcome is unknown'), { code: textReceipt.reason }),
         );
       }
       // A failed final text must not discard an already registered result file.