@xmanrui/dsh-im 4.12.0 → 4.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.12.0",
+  "version": "4.14.0",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

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

@@ -32,6 +32,7 @@ export const FEISHU_ENDPOINTS = Object.freeze({
   setAccessPolicy: "bot.access-policy.set",
   setGroupResponseMode: "bot.group-response-mode.set",
   setGroupTopicReply: "bot.group-topic-reply.set",
+  setStepPush: "bot.step-push.set",
   // Kept for rolling upgrades. The multi-bot UI never calls these endpoints.
   testConnection: "connection.test",
   disconnect: "connection.disconnect",
@@ -217,6 +218,7 @@ export function normalizeBotConnection(value, fallbackBotId) {
       : {}),
     groupResponseMode: normalizeGroupResponseMode(value.groupResponseMode),
     groupTopicReply: value.groupTopicReply === true,
+    stepPush: value.stepPush === true,
     groupMessagePermissionGranted: value.groupMessagePermissionGranted === true,
     bot: normalizeBot(value.bot),
     health: normalizeHealth(value.health, connected),

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

@@ -464,6 +464,53 @@ function RemoveConfirmation({ bot, busy, onConfirm, onCancel }) {
   );
 }
 
+/** Toggle row for 分步直推, mirroring the group-topic reply toggle pattern. */
+function StepPushEditor({ value = false, disabled = false, onSave }) {
+  const titleId = React.useId();
+  const current = value === true ? "on" : "off";
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+
+  const change = async (event) => {
+    const next = event.target.value === "on";
+    if ((next ? "on" : "off") === current || saving || disabled) return;
+    setSaving(true);
+    setError(null);
+    try {
+      await onSave?.(next);
+    } catch (cause) {
+      setError(cause?.message ?? "分步直推设置保存失败，请重试。");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return h("section", {
+    className: "dim-feishuGroupControl",
+    "aria-labelledby": titleId,
+  },
+  h("div", { className: "dim-feishuGroupControlHeader" },
+    h("h3", { id: titleId }, "分步直推"),
+    saving
+      ? h("span", { className: "dim-feishuGroupControlStatus", role: "status" }, "保存中…")
+      : null),
+  h("select", {
+    className: "dim-feishuGroupSelect",
+    value: current,
+    disabled: disabled || saving,
+    "aria-label": "分步直推",
+    onChange: (event) => { void change(event); },
+  },
+  h("option", { value: "off" }, "关闭（保持流式卡模式）"),
+  h("option", { value: "on" }, "开启（逐步推送工具调用与过程说明）")),
+  h("p", { className: "dim-feishuGroupHelp" },
+    "开启后逐步推送工具调用与过程说明"),
+  error ? h("p", {
+    className: "dim-feishuGroupError",
+    role: "alert",
+  }, error) : null);
+}
+
 export function BotCard({
   connection,
   busy,
@@ -479,6 +526,7 @@ export function BotCard({
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
+  onStepPushSave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -565,6 +613,11 @@ export function BotCard({
         disabled: Boolean(busy),
         onSave: onContextEnhancementSave,
       }),
+      h(StepPushEditor, {
+        value: connection.stepPush,
+        disabled: Boolean(busy),
+        onSave: onStepPushSave,
+      }),
       provisionContent
         ? h("section", {
             className: "bxf-botProvision dim-botProvision",
@@ -657,6 +710,7 @@ function BotList(props) {
           onModelSave: (model) => props.onModelSave(bot, model),
           onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(bot, agentPreset),
           onContextEnhancementSave: (config) => props.onContextEnhancementSave(bot, config),
+          onStepPushSave: (stepPush) => props.onStepPushSave(bot, stepPush),
           onRequestRemove: () => props.onRequestRemove(bot),
           onConfirmRemove: () => props.onConfirmRemove(bot),
           onCancelRemove: props.onCancelRemove,
@@ -1431,6 +1485,9 @@ export function FeishuSettingsTab({ rpcCall }) {
                   onContextEnhancementSave: (connection, config) => saveBotSetting(
                     connection, "context-enhancement", FEISHU_ENDPOINTS.setContextEnhancement, { config },
                   ),
+                  onStepPushSave: (connection, stepPush) => saveBotSetting(
+                    connection, "step-push", FEISHU_ENDPOINTS.setStepPush, { stepPush },
+                  ),
                   onRequestRemove: requestRemove,
                   onConfirmRemove: (bot) => void confirmRemove(bot),
                   onCancelRemove: cancelRemove,

package/plugin-src/client/i18n.js

@@ -220,6 +220,11 @@ const EN = Object.freeze({
   '关闭（群内直接回复）': 'Off (reply in the group feed)',
   '开启（自动开启独立飞书话题）': 'On (auto-open a dedicated Feishu topic)',
   '开启后，群聊中向机器人提问会自动开启独立飞书话题，回复落在话题内；每个话题是 dsh 会话列表里一条独立会话，上下文互不串。私聊不受影响。': 'When enabled, questions to the bot in a group auto-open a dedicated Feishu topic and replies stay inside it. Each topic is an independent conversation in dsh with its own context. Private chats are unaffected.',
+  '分步直推': 'Step push',
+  '开启后逐步推送工具调用与过程说明': 'Push tool calls and process notes step by step',
+  '关闭（保持流式卡模式）': 'Off (keep the streaming card)',
+  '开启（逐步推送工具调用与过程说明）': 'On (push tool calls and process notes step by step)',
+  '分步直推设置保存失败，请重试。': 'Could not save the step push setting. Try again.',
   '钉钉设置': 'DingTalk settings',
   '企业微信设置': 'WeCom settings',
   '扫码接入机器人': 'Scan QR code',

package/plugin-src/client/styles.js

@@ -355,7 +355,8 @@ const CSS = String.raw`
 .dim-panel .dim-cardActions .dim-cardAction { flex: none; min-height: 32px; padding: 0 11px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 13px; font-weight: 560; line-height: normal; white-space: nowrap; }
 .dim-panel .dim-cardActions .dim-cardAction:hover:not(:disabled) { border-color: #aeb3bb; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-cardActions .dim-cardAction[data-kind="danger"] { color: var(--dsw-alias-state-error-primary, #d54941); }
-.dim-panel .dim-botCard { position: relative; min-width: 0; width: 100%; max-width: 100%; overflow: hidden; border: 1px solid var(--dsw-alias-border-l2, #e5e6eb); border-radius: 14px; background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 1px 2px rgb(31 35 41 / 3%); }
+/* Header tooltips may extend beyond the card; the collapsible body clips its own content. */
+.dim-panel .dim-botCard { position: relative; min-width: 0; width: 100%; max-width: 100%; overflow: visible; border: 1px solid var(--dsw-alias-border-l2, #e5e6eb); border-radius: 14px; background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 1px 2px rgb(31 35 41 / 3%); }
 .dim-panel .dim-botCard::before { display: none; }
 .dim-panel .dim-botCardBody { position: relative; min-width: 0; width: 100%; max-width: 100%; padding: 12px; }
 .dim-collapsibleAccount { min-width: 0; display: flex; flex-direction: column; }

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

@@ -218,6 +218,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         botOpenId: botConfig.botOpenId,
         groupResponseMode: botConfig.groupResponseMode,
         groupTopicReply: botConfig.groupTopicReply,
+        stepPush: botConfig.stepPush,
         ownerOpenIds: botConfig.ownerOpenIds ?? [botConfig.ownerOpenId],
         harness: workspaceScope.harness,
         state: workspaceScope.state,

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

@@ -294,6 +294,7 @@ function publicBotEntry(entry) {
     accessPolicy: normalizeAccessPolicy(source.accessPolicy),
     groupResponseMode: normalizeFeishuGroupResponseMode(source.groupResponseMode),
     groupTopicReply: source.groupTopicReply === true,
+    stepPush: source.stepPush === true,
     groupMessagePermissionGranted: source.groupMessagePermissionGranted === true,
     bot: publicBot(source.bot),
     health: publicHealth(source, connected),
@@ -458,6 +459,13 @@ function validPayload(endpoint, payload) {
       ? null
       : '请选择是否以话题方式回复。';
   }
+  if (endpoint === FEISHU_ENDPOINTS.setStepPush) {
+    return hasOnlyKeys(payload, new Set(['botId', 'stepPush']))
+      && safeOpaqueId(payload.botId)
+      && typeof payload.stepPush === 'boolean'
+      ? null
+      : '请选择是否分步直推。';
+  }
   return 'Unknown Feishu endpoint.';
 }
 
@@ -742,6 +750,14 @@ export function createFeishuRpcHandler(controller, { encodeQr = qrCodeDataUrl }
           await controller.updateGroupTopicReply(payload.botId, payload.groupTopicReply),
           { encodeQr: cachedEncodeQr },
         );
+      } else if (endpoint === FEISHU_ENDPOINTS.setStepPush) {
+        if (typeof controller.updateStepPush !== 'function') {
+          throw new Error('Step push update is unavailable');
+        }
+        value = await toPublicFeishuStatus(
+          await controller.updateStepPush(payload.botId, payload.stepPush),
+          { encodeQr: cachedEncodeQr },
+        );
       } else {
         if (typeof controller.deleteBot !== 'function') throw new Error('Multi-bot delete is unavailable');
         value = await toPublicFeishuStatus(await controller.deleteBot(payload.botId), { encodeQr: cachedEncodeQr });

package/plugin-src/host/harness-command-executor.mjs

@@ -22,19 +22,26 @@ export function createHarnessCommandExecutor(ctx, provided) {
     try {
       return await gateway.invoke(request);
     } catch (error) {
-      // Newer Hosts require images; older Hosts reject that field before
-      // invoking the command. Retry only that exact pre-dispatch failure so
+      // Host versions use no attachments, images, or submittedAttachments.
+      // Adapt only exact descriptor rejections before command dispatch, so
       // a business failure can never cause compaction to run twice.
       if (error?.name !== 'TypertGatewayError'
-        || error.code !== 'arguments-invalid'
-        || error.endpoint !== 'commands/execute'
-        || error.message !== 'typert gateway: commands/execute: args fields do not match the descriptor: unexpected "images"') {
+        || !['arguments-invalid', 'gateway/arguments-invalid'].includes(error.code)
+        || error.endpoint !== 'commands/execute') {
+        throw error;
+      }
+      let args;
+      if (error.message === 'typert gateway: commands/execute: args fields do not match the descriptor: unexpected "images"') {
+        args = { agentId: sessionId, line };
+      } else if (error.message === 'typert gateway: commands/execute: args fields do not match the descriptor: missing "submittedAttachments"; unexpected "images"') {
+        args = { agentId: sessionId, line, submittedAttachments: [] };
+      } else {
         throw error;
       }
       options.signal?.throwIfAborted();
       return gateway.invoke({
         ...request,
-        args: { agentId: sessionId, line },
+        args,
       });
     }
   };

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

@@ -3,6 +3,7 @@ import { extname } from 'node:path';
 
 import { fetchImageBuffer, ImagePromptError } from '../shared/image-prompt.mjs';
 import { t } from '../shared/i18n.mjs';
+import { DINGTALK_MENU_TEMPLATE_ID, dingtalkMenuCardData } from './dingtalk-menu.mjs';
 
 export const DINGTALK_REGISTRATION_BASE_URL = 'https://oapi.dingtalk.com/';
 export const DINGTALK_API_BASE_URL = 'https://api.dingtalk.com/';
@@ -876,6 +877,38 @@ export function createDingtalkApi({
       }
     },
 
+    async createMenuCard({ clientId, clientSecret, target, data, signal }) {
+      const normalizedTarget = normalizeCardTarget(target);
+      const token = await accessToken({ clientId, clientSecret, signal });
+      const cardInstanceId = `dsh_menu_${randomUUID()}`;
+      const headers = { 'x-acs-dingtalk-access-token': token };
+      await cardRequest('v1.0/card/instances/createAndDeliver', {
+        body: {
+          ...cardDeliverBody(cardInstanceId, normalizedTarget, clientId),
+          cardTemplateId: DINGTALK_MENU_TEMPLATE_ID,
+          outTrackId: cardInstanceId,
+          cardData: dingtalkMenuCardData(data),
+          callbackType: 'STREAM',
+          imGroupOpenSpaceModel: { supportForward: false },
+          imRobotOpenSpaceModel: { supportForward: false },
+        },
+        headers, signal, action: '菜单卡片创建',
+      });
+      return { cardInstanceId };
+    },
+
+    async updateMenuCard({ clientId, clientSecret, cardInstanceId, data, signal }) {
+      if (!nonEmptyString(cardInstanceId)) throw new TypeError('cardInstanceId is required');
+      const token = await accessToken({ clientId, clientSecret, signal });
+      await cardRequest('v1.0/card/instances', {
+        method: 'PUT',
+        body: { outTrackId: cardInstanceId, cardData: dingtalkMenuCardData(data),
+          cardUpdateOptions: { updateCardDataByKey: true } },
+        headers: { 'x-acs-dingtalk-access-token': token }, signal, action: '菜单卡片更新',
+      });
+      return true;
+    },
+
     async createAiCard({ clientId, clientSecret, target, initialText, signal }) {
       const appKey = nonEmptyString(clientId);
       const appSecret = nonEmptyString(clientSecret);

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

@@ -1,3 +1,4 @@
+import { createDeferredDeliveryCoordinator, deferredOutcomeText } from '../shared/deferred-delivery-coordinator.mjs';
 import {
   DINGTALK_DONE_REACTION_NAME,
   DINGTALK_ERROR_REACTION_NAME,
@@ -6,6 +7,7 @@ import {
   splitDingtalkText,
 } from './dingtalk-api.mjs';
 import { createDingTalkCardStream } from './dingtalk-card-stream.mjs';
+import { dingtalkMenuSnapshot, dingtalkMenuCommand, isDingtalkMenuCommand } from './dingtalk-menu.mjs';
 import {
   harnessAnswerForQuestion,
   harnessQuestionText,
@@ -76,6 +78,7 @@ const HELP_TEXT_LINES = [
   '钉钉机器人已连接 DeepSeek Harness。',
   '',
   '直接发送文字、图片或文件即可继续当前会话。',
+  '/m 或 /menu  打开下拉操作菜单',
   '/new  开启一个全新会话',
   '/compact  压缩当前会话的较早上下文',
   '/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）',
@@ -475,6 +478,7 @@ export class DingtalkHarnessBridge {
   #clientSecret;
   #harness;
   #state;
+  #deferred;
   #contextEnhancement;
   #accessPolicy;
   #status;
@@ -488,6 +492,7 @@ export class DingtalkHarnessBridge {
   #interactionKeys = new Map();
   #interactionTasks = new Set();
   #commandTasks = new Set();
+  #menus = new Map();
   // Keep the accepted configuration through the existing queue/reply lifecycle.
   #acceptedMessageIds = new Map();
   #approvals;
@@ -529,6 +534,9 @@ export class DingtalkHarnessBridge {
       : 5_000;
     this.#maxMessageChars = maxMessageChars;
     this.#signal = signal;
+    this.#deferred = createDeferredDeliveryCoordinator({ harness, state, signal, logger,
+      deliver: (entry, outcome) => this.#deliverDeferredOutcome(entry, outcome),
+    });
     ensureStats(this.#status);
     this.#refreshPendingSenders();
   }
@@ -574,6 +582,7 @@ export class DingtalkHarnessBridge {
         text: commandText,
         hasImages: hasInboundImages(promptMessage),
         hasFiles: hasInboundFiles(promptMessage),
+        ...(isDingtalkMenuCommand(commandText) ? { isCommand: true } : {}),
       });
       if (!access.allowed) {
         this.#acceptedMessageIds.set(messageId, null);
@@ -617,7 +626,8 @@ export class DingtalkHarnessBridge {
         statusReaction,
       ));
     }
-    if (direct && sessionWebhook && (batchCommand || batchStatus.phase === 'collecting')) {
+    if (direct && sessionWebhook && !isDingtalkMenuCommand(commandText)
+      && (batchCommand || batchStatus.phase === 'collecting')) {
       const exactBatchStart = /^\/batch$/iu.test(commandText);
       const result = exactBatchStart
         && batchStatus.phase === 'idle'
@@ -652,7 +662,10 @@ export class DingtalkHarnessBridge {
         ));
       }
     }
-    const commandRunner = isHistoryCommand(commandText) ? runHistoryCommand
+    const commandRunner = isDingtalkMenuCommand(commandText)
+      && !hasInboundFiles(promptMessage) && !hasInboundImages(promptMessage)
+      ? async () => { await this.#showMenu(message, key); }
+      : isHistoryCommand(commandText) ? runHistoryCommand
       : hasInboundFiles(promptMessage) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
@@ -773,6 +786,111 @@ export class DingtalkHarnessBridge {
     return finish(this.#enqueueMessage(message, messageId, sender, key, { statusReaction }));
   }
 
+  async #showMenu(message, key) {
+    if (typeof this.#api.createMenuCard !== 'function') {
+      await this.#send(message.sessionWebhook, helpText(), this.#atUsersFor(message));
+      return;
+    }
+    const snapshot = await dingtalkMenuSnapshot(this.#harness, this.#state, key, this.#signal);
+    const now = Date.now();
+    for (const [id, entry] of this.#menus) {
+      if (entry.expiresAt <= now || entry.key === key) this.#menus.delete(id);
+    }
+    while (this.#menus.size >= 256) this.#menus.delete(this.#menus.keys().next().value);
+    const { cardInstanceId } = await this.#api.createMenuCard({
+      clientId: this.#clientId, clientSecret: this.#clientSecret,
+      target: cardTarget(message, senderStaffId(message)), data: snapshot.data, signal: this.#signal,
+    });
+    this.#menus.set(cardInstanceId, {
+      ...snapshot, key, message, cardInstanceId, expiresAt: now + 30 * 60_000, busy: false,
+    });
+  }
+
+  acceptCard(callback, messageId) {
+    if (this.#signal?.aborted || !nonEmptyString(messageId) || this.#state.hasSeen(messageId)) {
+      return Promise.resolve();
+    }
+    const entry = this.#menus.get(callback?.outTrackId);
+    if (!entry || entry.busy || entry.expiresAt <= Date.now()
+      || callback?.userId !== senderStaffId(entry.message)) return Promise.resolve();
+    const command = dingtalkMenuCommand(entry, callback);
+    if (!command) return Promise.resolve();
+    entry.busy = true;
+    let task;
+    task = this.#processMenuAction(entry, command, messageId).catch(async (error) => {
+      if (this.#signal?.aborted) return;
+      this.#status.lastError = error?.message ?? String(error);
+      this.#logger.warn?.('[dsh-dingtalk] menu action failed', safeErrorDiagnostic(error));
+      await this.#api.updateMenuCard({
+        clientId: this.#clientId, clientSecret: this.#clientSecret,
+        cardInstanceId: entry.cardInstanceId,
+        data: { notice: t('操作未完成，请重新发送 /m 后重试。') }, signal: this.#signal,
+      }).catch(() => undefined);
+    }).finally(() => { entry.busy = false; this.#commandTasks.delete(task); });
+    this.#commandTasks.add(task);
+    return task;
+  }
+
+  async #processMenuAction(entry, command, messageId) {
+    await this.#state.markSeen(messageId);
+    const { key, message } = entry;
+    const options = {
+      signal: this.#signal, isDirect: String(message.conversationType) === '1',
+      pendingInteraction: this.#pendingInteractions.has(key) || this.#approvals.hasPending(key),
+      control: { owner: this, key }, deferredDelivery: this.#deferred,
+    };
+    const access = evaluateInboundAccess(this.#accessPolicy, {
+      conversationType: options.isDirect ? 'direct' : 'group',
+      senderIds: senderStaffId(message), text: command, isCommand: true,
+    });
+    let result;
+    if (!access.allowed) {
+      await this.#api.updateMenuCard({
+        clientId: this.#clientId, clientSecret: this.#clientSecret,
+        cardInstanceId: entry.cardInstanceId,
+        data: { notice: t(COMMAND_PERMISSION_DENIED_MESSAGE) }, signal: this.#signal,
+      });
+      return;
+    }
+    if (entry.workspace !== this.#harness.currentWorkspace?.()
+      || entry.sessionId !== this.#state.sessionFor(key)) {
+      result = { message: t('会话或工作区已变化，菜单已刷新，请重新选择。') };
+    } else if ((this.#queues.has(key) || options.pendingInteraction || this.#batchInputs.status(key).phase !== 'idle')
+      && !['/stop', '/help', '/status', '/history'].includes(command)) {
+      result = { message: t('当前任务尚未结束，请先停止任务或等待完成后再操作。') };
+    } else if (command === '/new') {
+      await this.#state.clearSession(key);
+      result = { message: t('已开启新会话。请发送你的问题。') };
+    } else if (command === '/status') {
+      await this.#harness.ensureRunning({ signal: this.#signal });
+      result = { message: t('钉钉机器人与 DeepSeek Harness 连接正常。') };
+    } else if (command === '/help') {
+      result = { message: helpText() };
+    } else {
+      result = await runWorkspaceCommand(command, this.#harness, key)
+        ?? await runCompactCommand(command, this.#harness, this.#state, key, options)
+        ?? await runControlCommand(command, this.#harness, this.#state, key, options)
+        ?? await runHistoryCommand(command, this.#harness, this.#state, key, options)
+        ?? await runModelCommand(command, this.#harness, this.#state, key, options)
+        ?? await runPresetCommand(command, this.#harness, this.#state, key, options);
+    }
+    if (result?.stopped) await Promise.allSettled([
+      this.#cancelPendingInteraction(key), this.#approvals.closeRoute(key),
+    ]);
+    const snapshot = await dingtalkMenuSnapshot(this.#harness, this.#state, key, this.#signal);
+    if (command === '/help' || command === '/history') {
+      for (const reply of result?.messages ?? [result?.message]) {
+        if (reply) await this.#send(message.sessionWebhook, reply, this.#atUsersFor(message));
+      }
+    } else snapshot.data.notice = (result?.message ?? '').slice(0, 300);
+    await this.#api.updateMenuCard({
+      clientId: this.#clientId, clientSecret: this.#clientSecret,
+      cardInstanceId: entry.cardInstanceId, data: snapshot.data, signal: this.#signal,
+    });
+    Object.assign(entry, snapshot);
+    this.#status.lastError = null;
+  }
+
   #runReactionCall(method, target, reactionName, kind) {
     const controller = new AbortController();
     const operation = Promise.resolve().then(() => this.#api[method]({
@@ -936,6 +1054,19 @@ export class DingtalkHarnessBridge {
     return { content: text };
   }
 
+  async #deliverDeferredOutcome(entry, outcome) {
+    const text = deferredOutcomeText(outcome);
+    if (outcome.found && ['createAiCard', 'updateAiCard', 'finishAiCard'].every((name) => typeof this.#api[name] === 'function')) {
+      const card = createDingTalkCardStream({ api: this.#api, clientId: this.#clientId,
+        clientSecret: this.#clientSecret, target: entry.target, signal: this.#signal, logger: this.#logger });
+      if (await card.start(t(CARD_INITIAL_TEXT)) && await card.finish(text)) return true;
+      this.#logger.warn?.('[dsh-dingtalk] deferred card unavailable; sending robot text');
+    }
+    await this.#api.sendRobotText({ clientId: this.#clientId, clientSecret: this.#clientSecret,
+      target: entry.target, text, signal: this.#signal });
+    return true;
+  }
+
   async waitForIdle() {
     await Promise.allSettled([
       ...this.#queues.values(),
@@ -945,6 +1076,7 @@ export class DingtalkHarnessBridge {
       ...this.#interactionTasks,
       ...this.#commandTasks,
     ]);
+    await this.#deferred.whenIdle();
   }
 
   async #processFastCommand(message, messageId, key, sessionWebhook, prompt, runner) {
@@ -966,6 +1098,7 @@ export class DingtalkHarnessBridge {
         pendingInteraction: this.#pendingInteractions.has(key)
           || this.#approvals.hasPending(key),
         control: { owner: this, key },
+        deferredDelivery: this.#deferred,
       },
     );
     if (result?.stopped) {
@@ -1157,6 +1290,7 @@ export class DingtalkHarnessBridge {
         if (cardStarted) cardStartedAt = startedAt;
       }
       const { answer, artifacts = [] } = await askInWorkspaceSession({
+        deferredDelivery: () => ({ coordinator: this.#deferred, target: { ...cardTarget(message, sender), robotCode: this.#clientId } }),
         harness: this.#harness,
         state: this.#state,
         key,

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

@@ -0,0 +1,91 @@
+import { randomUUID } from 'node:crypto';
+import { workspacePathSnapshot } from '../shared/workspace-command.mjs';
+import { t } from '../shared/i18n.mjs';
+
+export const DINGTALK_MENU_TEMPLATE_ID = '9ca31362-e5b3-409c-a694-6993706a6004.schema';
+export const DINGTALK_CARD_TOPIC = '/v1.0/card/instances/callback';
+export const DINGTALK_MENU_BUTTONS = Object.freeze({
+  new: '/new', history: '/history', stop: '/stop', compact: '/compact',
+  status: '/status', help: '/help',
+});
+
+export function isDingtalkMenuCommand(text) {
+  return typeof text === 'string' && /^\/(?:m|menu)$/iu.test(text.trim());
+}
+
+const presetCommand = (id) => `/preset ${/^\d+$/u.test(id) ? 'id:' : ''}${id}`;
+
+// Keep exact commands alongside the displayed options. Never interpret a callback
+// as a command supplied by the client or as a prompt for the model.
+export async function dingtalkMenuSnapshot(harness, state, key, signal) {
+  const workspace = harness.currentWorkspace?.();
+  const sessionId = state.sessionFor(key);
+  const options = { signal };
+  const results = await Promise.allSettled([
+    workspacePathSnapshot(harness, options),
+    harness.listWorkspaceSessions?.(workspace, options),
+    (async () => {
+      const session = sessionId ? harness.workspaceSession?.(sessionId) : null;
+      return typeof session?.models === 'function'
+        ? session.models(options) : harness.listModels?.(options);
+    })(),
+    harness.agentPresetSettings?.(options),
+  ]);
+  signal?.throwIfAborted();
+  if (harness.currentWorkspace?.() !== workspace || state.sessionFor(key) !== sessionId) {
+    throw new Error(t('会话或工作区已变化，请重新发送 /m。'));
+  }
+  const [paths, listed, catalog, settings] = results.map((r) => r.status === 'fulfilled' ? r.value : null);
+  const selections = {
+    session: [[t('新会话'), '/new'], ...(listed?.sessions ?? []).map((item) => [
+      item.title || item.sessionId, `/session ${item.sessionId}`,
+    ])],
+    workspace: (paths?.paths ?? (workspace ? [workspace] : [])).map((path) => [path, `/workspace ${path}`]),
+    preset: [[t('跟随 Host 默认'), '/preset --default'], ...(settings?.agentPresetCatalog?.items ?? []).map((item) => [
+      item.label || item.id, presetCommand(item.id),
+    ])],
+    model: (catalog?.groups ?? []).flatMap((group) => group.models.map((model) => [
+      `${model.name} (${group.id})`, `/model ${group.id}/${model.id}`,
+    ])),
+  };
+  const current = {
+    session: sessionId ? `/session ${sessionId}` : '/new',
+    workspace: `/workspace ${workspace}`,
+    preset: settings?.agentPreset ? presetCommand(settings.agentPreset) : '/preset --default',
+    model: catalog?.current ? `/model ${catalog.current.provider}/${catalog.current.model}` : null,
+  };
+  const data = { revision: randomUUID(), notice: '' };
+  for (const [name, entries] of Object.entries(selections)) {
+    // Keep the active value visible even when the session listing is paginated.
+    if (current[name] && !entries.some(([, command]) => command === current[name])) {
+      entries.unshift([name === 'session' ? sessionId : current[name].replace(/^\/\w+\s+/u, ''), current[name]]);
+    }
+    data[`${name}_options`] = entries.map(([label], index) => ({
+      value: String(index), text: { zh_CN: label, en_US: label },
+    }));
+    data[`${name}_index`] = entries.findIndex(([, command]) => command === current[name]);
+  }
+  return { workspace, sessionId, selections, data };
+}
+
+export function dingtalkMenuCommand(entry, callback) {
+  let content;
+  try {
+    content = typeof callback?.content === 'string' ? JSON.parse(callback.content) : callback?.content;
+  } catch { return null; }
+  const { actionIds, params } = content?.cardPrivateData ?? {};
+  if (!Array.isArray(actionIds) || actionIds.length !== 1
+    || params?.revision !== entry.data.revision) return null;
+  const action = actionIds[0];
+  if (Object.hasOwn(DINGTALK_MENU_BUTTONS, action)) return DINGTALK_MENU_BUTTONS[action];
+  const entries = entry.selections[action];
+  const index = params[action]?.index;
+  if (!Array.isArray(entries) || !Number.isSafeInteger(index) || index < 0) return null;
+  return entries[index]?.[1] ?? null;
+}
+
+export function dingtalkMenuCardData(data) {
+  return { cardParamMap: Object.fromEntries(Object.entries(data).map(([key, value]) => [
+    key, typeof value === 'string' ? value : JSON.stringify(value),
+  ])) };
+}

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

@@ -7,6 +7,7 @@ import { sendRememberedConnectionTest } from '../shared/connection-test.mjs';
 import { t } from '../shared/i18n.mjs';
 import { captureContextEnhancement } from '../shared/context-enhancement.mjs';
 import { dingtalkRuntimeStartError } from './connection-error.mjs';
+import { DINGTALK_CARD_TOPIC } from './dingtalk-menu.mjs';
 
 function nonEmptyString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
@@ -271,6 +272,22 @@ export class DingtalkRuntime {
       const client = this.#client;
       const bridge = this.#bridge;
       startStage = 'dingtalk-stream-listener-failed';
+      client.registerCallbackListener(DINGTALK_CARD_TOPIC, (response) => {
+        if (this.#client !== client || this.#bridge !== bridge) return;
+        const messageId = nonEmptyString(response?.headers?.messageId);
+        if (messageId) {
+          try { client.socketCallBackResponse(messageId, { success: true }); }
+          catch { this.#logger.warn?.('[dsh-dingtalk] unable to acknowledge a card callback'); }
+        }
+        const task = Promise.resolve().then(async () => {
+          if (this.#bridge !== bridge) return;
+          const callback = typeof response?.data === 'string' ? JSON.parse(response.data) : response?.data;
+          await bridge.acceptCard(callback, messageId);
+        }).catch(() => {
+          if (!signal.aborted) this.#logger.warn?.('[dsh-dingtalk] card callback processing failed');
+        }).finally(() => this.#callbackTasks.delete(task));
+        this.#callbackTasks.add(task);
+      });
       client.registerCallbackListener(this.#topic, (response) => {
         if (this.#client !== client || this.#bridge !== bridge) return;
         const callbackMessageId = nonEmptyString(response?.headers?.messageId);

package/src/channels/dingtalk/state-store.mjs

@@ -1,3 +1,4 @@
+import { deferredStateAccess, normalizeDeferredState } from '../shared/deferred-state.mjs';
 import { randomUUID } from 'node:crypto';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
@@ -114,6 +115,7 @@ function normalizeState(value) {
   return {
     version: 1,
     sessions,
+    ...(value.deferred ? { deferred: normalizeDeferredState(value.deferred) } : {}),
     seenMessageIds: Array.isArray(value.seenMessageIds)
       ? [...new Set(value.seenMessageIds.map(nonEmptyString).filter(Boolean))].slice(-1_000)
       : [],
@@ -126,6 +128,7 @@ export class DingtalkStateStore {
   #path;
   #state = structuredClone(EMPTY_STATE);
   #writeQueue = Promise.resolve();
+  #deferred = deferredStateAccess(() => this.#state, () => this.#persist());
   #idFactory;
   #now;
 
@@ -150,6 +153,11 @@ export class DingtalkStateStore {
     return this;
   }
 
+  deferredEntries() { return this.#deferred.entries(); }
+  putDeferred(entry) { return this.#deferred.put(entry); }
+  patchDeferred(id, patch) { return this.#deferred.patch(id, patch); }
+  removeDeferred(id) { return this.#deferred.remove(id); }
+
   sessionFor(key) {
     return this.#state.sessions[key] ?? null;
   }