@xmanrui/dsh-im 4.34.1 → 4.35.0

package/locale/en.json

@@ -1,5 +1,6 @@
 {
   "meta": {
+    "title": "IM bots",
     "description": "Connect Telegram, WhatsApp, Slack, Discord, Matrix, WeChat, Feishu, WeCom, DingTalk, and QQ to DSH."
   }
 }

package/locale/zh.json

@@ -1,5 +1,6 @@
 {
   "meta": {
+    "title": "IM 机器人",
     "description": "把微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix接入DSH。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.34.1",
+  "version": "4.35.0",
   "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/delivery-adapter.mjs

@@ -286,8 +286,8 @@ export function createDeliveryAdapter({ channel, workspaces, coreController, sta
       if (typeof coreController.sendProactiveText !== 'function') {
         throw new TypeError('delivery controller cannot send proactive text');
       }
-      await coreController.sendProactiveText(botId, normalized, text, options);
-      return { sent: true };
+      const result = await coreController.sendProactiveText(botId, normalized, text, options);
+      return options.receipt === true ? result : { sent: true };
     },
     async setSessionSync(botId, targetId, enabled) {
       if (typeof workspaces.setDeliveryTargetSessionSync !== 'function') {

package/plugin-src/host/delivery-service.mjs

@@ -30,6 +30,7 @@ const DELIVERY_ERROR_CODES = new Set([
   'bot-not-connected',
   'target-rejected',
   'delivery-failed',
+  'send-result-unknown',
   'session-sync-unavailable',
   'cancelled',
 ]);
@@ -314,10 +315,10 @@ export class DeliveryService {
     } catch (error) { throw publicOperationError(error); }
   }
 
-  async sendChecked(botId, targetId, text, { expectedFingerprint, expectedTargetDigest, signal, format = 'plain' } = {}) {
+  async sendChecked(botId, targetId, text, { expectedFingerprint, expectedTargetDigest, signal, format = 'plain', receipt = false } = {}) {
     const id = botIdOf(botId);
     const key = targetIdOf(targetId);
-    if (typeof text !== 'string' || !text.trim() || !['plain', 'markdown'].includes(format)
+    if (typeof text !== 'string' || !text.trim() || !['plain', 'markdown'].includes(format) || typeof receipt !== 'boolean'
       || !/^[a-f0-9]{64}$/.test(expectedFingerprint ?? '') || !/^[a-f0-9]{64}$/.test(expectedTargetDigest ?? '')) {
       throw deliveryError('bad-request');
     }
@@ -341,14 +342,22 @@ export class DeliveryService {
         throw deliveryError('capability-unavailable');
       }
       if (account.account?.fingerprint !== expectedFingerprint) throw deliveryError('account-changed');
+      if (receipt && (!account.capabilities?.includes('proactive-receipt-checked') || target.kind !== 'group'))
+        throw deliveryError('capability-unavailable');
       const beforeSend = () => {
         cancellation(signal);
         this.#assertRegistered(registration);
       };
       beforeSend();
-      await adapter.sendText(id, target, text, { signal, expectedFingerprint, beforeSend,
+      const result = await adapter.sendText(id, target, text, { signal, expectedFingerprint, beforeSend,
+        ...(receipt ? { receipt: true } : {}),
         ...(format === 'markdown' ? { format } : {}) });
-      return { sent: true };
+      if (!receipt) return { sent: true };
+      if (result?.sent !== true || result.receipt?.version !== 1
+        || typeof result.receipt.messageId !== 'string' || !result.receipt.messageId || result.receipt.messageId.length > 512
+        || result.receipt.conversationId !== target.route.chatId)
+        throw deliveryError('send-result-unknown');
+      return { sent: true, receipt: { version: 1, messageId: result.receipt.messageId, conversationId: result.receipt.conversationId } };
     } catch (error) { throw publicOperationError(error); }
   }
 

package/plugin-src/host/index.mjs

@@ -92,6 +92,7 @@ export function createImHostPlugin(internals = {}) {
       if (typeof ctx?.provide === 'function') {
         ctx.provide('dshIm', Object.freeze({
           contractVersion: 1,
+          receiptVersion: 1,
           describeBot: (botId) => deliveryService.describeBot(botId),
           sendChecked: (botId, targetId, text, options) => deliveryService.sendChecked(botId, targetId, text, options),
           send: (botId, targetId, text, options) => (

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;
   }
@@ -3035,14 +3041,14 @@ export class FeishuHarnessBridge {
 
   async #showWorkspaces({ chatId, key, replyTo = null }, { updateMessageId = null } = {}) {
     try {
-      const { current, paths } = await workspacePathSnapshot(
+      const { current, paths, titles } = await workspacePathSnapshot(
         this.#harness,
-        { signal: this.#cardDataSignal() },
+        { signal: this.#cardDataSignal(), includeTitles: true },
       );
       this.#rememberMenu(key, { kind: 'workspaces', paths });
       await this.#sendCard(
         chatId,
-        workspaceListCard(paths, current),
+        workspaceListCard(paths, current, titles),
         { key, updateMessageId, replyTo },
       );
     } catch (error) {
@@ -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}`);
     }
@@ -3225,7 +3239,7 @@ export class FeishuHarnessBridge {
     const dataSignal = this.#cardDataSignal();
     // Independent sections start together. Each one degrades on its own so a
     // slow preset/model RPC cannot force redundant session-list scans.
-    const workspaceTask = workspacePathSnapshot(this.#harness, { signal: dataSignal })
+    const workspaceTask = workspacePathSnapshot(this.#harness, { signal: dataSignal, includeTitles: true })
       .catch(() => {
         const current = typeof this.#harness.currentWorkspace === 'function'
           ? this.#harness.currentWorkspace()
@@ -3302,7 +3316,7 @@ export class FeishuHarnessBridge {
     const archiveVisible = this.#state?.includesArchivedSessions?.() ?? false;
     this.#rememberMenu(key, { kind: 'menu', chatId });
     const menuContext = {
-      workspaces, currentWorkspace,
+      workspaces, currentWorkspace, workspaceTitles: snapshot.titles,
       currentSession: currentSessionId ? { id: currentSessionId, title: currentSessionTitle } : null,
       sessions, archiveVisible, presetCatalog, modelCatalog,
       newSessionAction: { id: randomUUID(), status: 'idle' },
@@ -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-cards.mjs

@@ -14,6 +14,7 @@
  * without button callbacks.
  */
 
+import { posix, win32 } from 'node:path';
 import { t } from '../shared/i18n.mjs';
 
 export const MENU_PAGE_SIZE = 10;
@@ -87,9 +88,56 @@ function initialIndex(options, currentValue) {
   return idx >= 0 ? idx + 1 : 0;
 }
 
+function cleanTitle(value) {
+  return String(value ?? '').replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+/gu, ' ').replace(/\s+/gu, ' ').trim();
+}
+
 function safeTitle(value) {
-  const title = String(value ?? '').replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+/gu, ' ').replace(/\s+/gu, ' ').trim();
-  return title || t('暂无标题');
+  return cleanTitle(value) || t('暂无标题');
+}
+
+const WORKSPACE_LABEL_LENGTH = 22;
+
+/** Display labels only: paths and their snapshot order remain the callback identity. */
+function workspaceLabels(paths, titles = {}) {
+  const entries = paths.map((path) => {
+    const api = /^[a-z]:[\\/]|^\\\\/iu.test(path) ? win32 : posix;
+    const normalized = api.normalize(path);
+    const name = cleanTitle(api.basename(normalized) || api.parse(normalized).root);
+    const base = (typeof titles[path] === 'string' && cleanTitle(titles[path])) || name;
+    return {
+      api, base, label: base, parent: api.dirname(normalized),
+      context: base === name ? '' : api.basename(normalized),
+    };
+  });
+  const counts = () => {
+    const result = new Map();
+    for (const { label } of entries) result.set(label, (result.get(label) ?? 0) + 1);
+    return result;
+  };
+  // Grow only ambiguous path suffixes; stop at the root even if display text collides.
+  for (;;) {
+    const repeated = counts();
+    let changed = false;
+    for (const entry of entries) {
+      if (repeated.get(entry.label) < 2 || entry.parent === null) continue;
+      const { api, parent } = entry;
+      entry.context = api.join(api.basename(parent) || parent, entry.context);
+      entry.label = `${entry.base} · ${cleanTitle(entry.context)}`;
+      const next = api.dirname(parent);
+      entry.parent = next === parent ? null : next;
+      changed = true;
+    }
+    if (!changed) break;
+  }
+  for (const entry of entries) {
+    const chars = Array.from(entry.label);
+    if (chars.length > WORKSPACE_LABEL_LENGTH) {
+      entry.label = `${chars.slice(0, 11).join('')}…${chars.slice(-10).join('')}`;
+    }
+  }
+  const repeated = counts();
+  return entries.map(({ label }) => ({ label, numbered: repeated.get(label) > 1 }));
 }
 
 function cardWith(headerText, elements) {
@@ -117,6 +165,7 @@ function backButton() {
  *   4. 系统 → 状态 · 帮助
  * `ctx` bundle:
  *   - workspaces: string[]          (工作区下拉选项)
+ *   - workspaceTitles: object      (可选，按绝对路径索引的工作区名称)
  *   - currentWorkspace: string|null (当前工作区,下拉高亮)
  *   - currentSession: {id,title}|null (当前绑定会话,续写目标)
  *   - sessions: {id,title}[]        (最近会话,供会话下拉切换)
@@ -130,6 +179,7 @@ function backButton() {
 export function menuCard(ctx) {
   const {
     workspaces = [],
+    workspaceTitles = {},
     currentWorkspace = null,
     currentSession = null,
     sessions = [],
@@ -188,8 +238,9 @@ export function menuCard(ctx) {
 
   let workspaceDropdown = null;
   if (hasWorkspaces) {
-    const wsOptions = workspaces.slice(0, 20).map((path) => ({
-      text: { tag: 'plain_text', content: `${path === currentWorkspace ? '✓ ' : ''}${path}` },
+    const labels = workspaceLabels(workspaces, workspaceTitles);
+    const wsOptions = workspaces.slice(0, 20).map((path, index) => ({
+      text: { tag: 'plain_text', content: `${path === currentWorkspace ? '✓ ' : ''}${labels[index].numbered ? `${index + 1}. ` : ''}${labels[index].label}` },
       value: path,
     }));
     workspaceDropdown = {
@@ -726,7 +777,8 @@ export function sessionListCard(workspace, sessions, page, total, watchedSession
 // ── Workspace list card (preserved, with back button) ─────────────────────
 
 /** The workspace list card (switch-workspace buttons + reply fallback). */
-export function workspaceListCard(paths, current) {
+export function workspaceListCard(paths, current, titles = {}) {
+  const labels = workspaceLabels(paths, titles);
   const elements = paths.length === 0
     ? [
         { tag: 'div', text: markdown(t('当前 Host 上没有已登记的工作区。')) },
@@ -735,7 +787,7 @@ export function workspaceListCard(paths, current) {
     : [
         { tag: 'div', text: markdown(t('回复数字切换工作区，或点击按钮：')) },
         ...paths.map((path, index) => button(
-          `${index + 1}. ${path}${path === current ? t('（当前）') : ''}`,
+          `${index + 1}. ${labels[index].label}${path === current ? t('（当前）') : ''}`,
           `workspace:${path}`,
         )),
         { tag: 'hr' },