@xmanrui/dsh-im 3.1.0 → 3.2.0

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

@@ -28,6 +28,7 @@ import {
 } from '../shared/preset-command.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
+import { captureContextEnhancement, enhanceContextContent } from '../shared/context-enhancement.mjs';
 import {
   BatchInputManager,
   batchInputBusyMessage,
@@ -251,7 +252,11 @@ function conversationKey(message, sender) {
 
 function cardTarget(message, sender) {
   if (String(message?.conversationType) === '2') {
-    return { type: 'group', openConversationId: nonEmptyString(message?.conversationId) };
+    return {
+      type: 'group',
+      openConversationId: nonEmptyString(message?.conversationId),
+      atUserIds: { [sender]: nonEmptyString(message?.senderNick) ?? sender },
+    };
   }
   return { type: 'user', userId: sender };
 }
@@ -368,6 +373,7 @@ export class DingtalkHarnessBridge {
   #clientSecret;
   #harness;
   #state;
+  #contextEnhancement;
   #status;
   #logger;
   #replyTimeoutMs;
@@ -379,7 +385,8 @@ export class DingtalkHarnessBridge {
   #interactionKeys = new Map();
   #interactionTasks = new Set();
   #commandTasks = new Set();
-  #acceptedMessageIds = new Set();
+  // Keep the accepted configuration through the existing queue/reply lifecycle.
+  #acceptedMessageIds = new Map();
   #approvals;
   #batchInputs = new BatchInputManager();
 
@@ -389,6 +396,7 @@ export class DingtalkHarnessBridge {
     clientSecret,
     harness,
     state,
+    contextEnhancement,
     status = createDingtalkBridgeStatus(),
     logger = console,
     replyTimeoutMs = 600_000,
@@ -406,6 +414,7 @@ export class DingtalkHarnessBridge {
     this.#clientSecret = clientSecret.trim();
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#status = status;
     this.#logger = logger;
     this.#approvals = new HarnessApprovalQueue({ label: 'DingTalk', logger });
@@ -424,13 +433,17 @@ export class DingtalkHarnessBridge {
     return structuredClone(this.#status);
   }
 
-  accept(message) {
+  accept(message, { contextSnapshot } = {}) {
     if (this.#signal?.aborted) return Promise.resolve();
     const messageId = nonEmptyString(message?.msgId);
     const sender = senderStaffId(message);
     if (!messageId || !sender || this.#state.hasSeen(messageId)
       || this.#acceptedMessageIds.has(messageId)) return Promise.resolve();
-    this.#acceptedMessageIds.add(messageId);
+    this.#acceptedMessageIds.set(messageId, contextSnapshot === undefined ? captureContextEnhancement(
+      this.#contextEnhancement,
+      message.conversationType === '1' || message.conversationType === 1 ? 'direct'
+        : message.conversationType === '2' || message.conversationType === 2 ? 'group' : null,
+    ) : contextSnapshot);
 
     let key;
     try {
@@ -551,7 +564,7 @@ export class DingtalkHarnessBridge {
           `[dsh-dingtalk] failed to process a command [${failure.referenceId}]`,
           safeErrorDiagnostic(error),
         );
-        return this.#send(sessionWebhook, messageFailureText(failure)).catch(() => undefined);
+        return this.#send(sessionWebhook, messageFailureText(failure), this.#atUsersFor(message)).catch(() => undefined);
       }).finally(() => {
         this.#acceptedMessageIds.delete(messageId);
         this.#commandTasks.delete(task);
@@ -573,7 +586,7 @@ export class DingtalkHarnessBridge {
         : null,
       isQuestionPending: () => this.#pendingInteractions.has(key),
       send: sessionWebhook
-        ? (reply) => this.#send(sessionWebhook, reply)
+        ? (reply) => this.#send(sessionWebhook, reply, this.#atUsersFor(message))
         : async () => undefined,
     });
     if (approvalReply) {
@@ -807,7 +820,7 @@ export class DingtalkHarnessBridge {
       ]);
     }
     for (const reply of result?.messages ?? [result?.message]) {
-      if (reply) await this.#send(sessionWebhook, reply);
+      if (reply) await this.#send(sessionWebhook, reply, this.#atUsersFor(message));
     }
     this.#status.lastError = null;
   }
@@ -885,23 +898,23 @@ export class DingtalkHarnessBridge {
     let batchSettled = batchSubmission === null;
     try {
       if (!text && !hasImages && !hasFiles) {
-        await this.#send(sessionWebhook, t('目前支持文字、图片和文件消息。'));
+        await this.#send(sessionWebhook, t('目前支持文字、图片和文件消息。'), this.#atUsersFor(message));
         return;
       }
 
       const command = text.toLowerCase();
       if (isPlainText && !hasImages && !hasFiles && command === '/help') {
-        await this.#send(sessionWebhook, helpText());
+        await this.#send(sessionWebhook, helpText(), this.#atUsersFor(message));
         return;
       }
       if (isPlainText && !hasImages && !hasFiles && command === '/status') {
         await this.#harness.ensureRunning({ signal: this.#signal });
-        await this.#send(sessionWebhook, t('钉钉机器人与 DeepSeek Harness 连接正常。'));
+        await this.#send(sessionWebhook, t('钉钉机器人与 DeepSeek Harness 连接正常。'), this.#atUsersFor(message));
         return;
       }
       if (isPlainText && !hasImages && !hasFiles && command === '/new') {
         await this.#state.clearSession(key);
-        await this.#send(sessionWebhook, t('已开启新会话。请发送你的问题。'));
+        await this.#send(sessionWebhook, t('已开启新会话。请发送你的问题。'), this.#atUsersFor(message));
         return;
       }
       const workspaceCommand = isPlainText && !hasImages && !hasFiles
@@ -909,7 +922,7 @@ export class DingtalkHarnessBridge {
         : null;
       if (workspaceCommand) {
         for (const reply of workspaceCommand.messages ?? [workspaceCommand.message]) {
-          await this.#send(sessionWebhook, reply);
+          await this.#send(sessionWebhook, reply, this.#atUsersFor(message));
         }
         return;
       }
@@ -923,13 +936,21 @@ export class DingtalkHarnessBridge {
           )
         : null;
       if (compactCommand) {
-        await this.#send(sessionWebhook, compactCommand.message);
+        await this.#send(sessionWebhook, compactCommand.message, this.#atUsersFor(message));
         return;
       }
 
-      const content = hasImages
+      let content = hasImages
         ? await promptContentForMessage(promptMessage, { signal: this.#signal })
         : undefined;
+      const snapshot = this.#acceptedMessageIds.get(messageId);
+      if (snapshot) {
+        content = enhanceContextContent(content ?? text, snapshot, () => ({
+          channel: 'dingtalk',
+          senderId: sender,
+          senderName: message.senderNick,
+        }));
+      }
       if (typeof this.#api.createAiCard === 'function'
         && typeof this.#api.updateAiCard === 'function'
         && typeof this.#api.finishAiCard === 'function') {
@@ -947,7 +968,7 @@ export class DingtalkHarnessBridge {
         harness: this.#harness,
         state: this.#state,
         key,
-        ...(hasImages ? { content } : { text }),
+        ...(content !== undefined ? { content } : { text }),
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },
         askOptions: {
@@ -988,7 +1009,7 @@ export class DingtalkHarnessBridge {
           textReceipt = createDeliveryReceipt({
             deliveryId: messageId,
             presentation: 'dingtalk-text',
-            providerMessageIds: await this.#send(sessionWebhook, answerText),
+            providerMessageIds: await this.#send(sessionWebhook, answerText, this.#atUsersFor(message)),
           });
         }
       } catch (error) {
@@ -1049,7 +1070,7 @@ export class DingtalkHarnessBridge {
           ? `${errorText}\n\n${batchFailureMessage}`
           : errorText;
         const streamed = cardStarted && await cardStream.finish(visibleError);
-        if (!streamed) await this.#send(sessionWebhook, visibleError);
+        if (!streamed) await this.#send(sessionWebhook, visibleError, this.#atUsersFor(message));
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to send the safe error reply');
       }
@@ -1102,7 +1123,7 @@ export class DingtalkHarnessBridge {
     const text = message?.msgtype === 'text' ? nonEmptyString(message?.text?.content) : null;
     if (!text) {
       try {
-        await this.#send(sessionWebhook, t('请用文字回答当前问题。'));
+        await this.#send(sessionWebhook, t('请用文字回答当前问题。'), this.#atUsersFor(message));
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to reject a non-text interaction reply');
       }
@@ -1113,7 +1134,7 @@ export class DingtalkHarnessBridge {
     if (!pending || pending !== expected || pending.submitting) {
       if (claimed && (!pending || pending !== expected)) {
         try {
-          await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT));
+          await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT), this.#atUsersFor(message));
         } catch {
           this.#logger.error?.('[dsh-dingtalk] failed to send an expired interaction notice');
         }
@@ -1178,7 +1199,7 @@ export class DingtalkHarnessBridge {
       if (error?.code === 'interaction-not-pending') {
         this.#clearPendingInteraction(key, pending.interactionId);
         try {
-          await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT));
+          await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT), this.#atUsersFor(message));
         } catch {
           this.#logger.error?.('[dsh-dingtalk] failed to send an expired interaction notice');
         }
@@ -1191,7 +1212,7 @@ export class DingtalkHarnessBridge {
       this.#status.lastError = t('回答提交失败。');
       this.#logger.error?.('[dsh-dingtalk] failed to answer a Harness interaction');
       try {
-        await this.#send(sessionWebhook, t('回答提交失败，请重新发送当前问题的答案。'));
+        await this.#send(sessionWebhook, t('回答提交失败，请重新发送当前问题的答案。'), this.#atUsersFor(message));
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to send an interaction retry notice');
       }
@@ -1323,7 +1344,7 @@ export class DingtalkHarnessBridge {
       return;
     }
     try {
-      await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT));
+      await this.#send(sessionWebhook, t(INTERACTION_RESOLVED_TEXT), this.#atUsersFor(message));
     } catch {
       this.#logger.error?.('[dsh-dingtalk] failed to send an expired interaction notice');
     }
@@ -1367,7 +1388,14 @@ export class DingtalkHarnessBridge {
     }
   }
 
-  async #send(sessionWebhook, text) {
+  #atUsersFor(message) {
+    const sender = senderStaffId(message);
+    return String(message?.conversationType) === '2' && sender
+        ? { atUserIds: [sender] }
+        : undefined;
+  }
+
+  async #send(sessionWebhook, text, at) {
     const providerMessageIds = [];
     for (const chunk of splitDingtalkText(text, this.#maxMessageChars)) {
       this.#signal?.throwIfAborted();
@@ -1376,6 +1404,7 @@ export class DingtalkHarnessBridge {
         clientSecret: this.#clientSecret,
         sessionWebhook,
         text: chunk,
+        at,
         signal: this.#signal,
       });
       providerMessageIds.push(...providerMessageIdsFor(result));

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

@@ -5,6 +5,7 @@ import {
 } from './dingtalk-bridge.mjs';
 import { sendRememberedConnectionTest } from '../shared/connection-test.mjs';
 import { t } from '../shared/i18n.mjs';
+import { captureContextEnhancement } from '../shared/context-enhancement.mjs';
 
 function nonEmptyString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
@@ -128,6 +129,7 @@ export class DingtalkRuntime {
   #clientSecret;
   #harness;
   #state;
+  #contextEnhancement;
   #logger;
   #replyTimeoutMs;
   #maxMessageChars;
@@ -149,6 +151,7 @@ export class DingtalkRuntime {
     clientSecret,
     harness,
     state,
+    contextEnhancement,
     logger = console,
     replyTimeoutMs = 600_000,
     maxMessageChars = 4_000,
@@ -166,6 +169,7 @@ export class DingtalkRuntime {
     this.#clientSecret = clientSecret.trim();
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#maxMessageChars = maxMessageChars;
@@ -233,6 +237,7 @@ export class DingtalkRuntime {
         approvedSenders: this.#config.approvedSenders,
         harness: this.#harness,
         state: this.#state,
+        contextEnhancement: this.#contextEnhancement,
         status: this.#status,
         logger: this.#logger,
         replyTimeoutMs: this.#replyTimeoutMs,
@@ -268,6 +273,15 @@ export class DingtalkRuntime {
           }
         }
 
+        // Retain the committed, read-only settings at receipt without moving
+        // JSON parsing out of the existing asynchronous callback path.
+        const contextEnhancement = this.#contextEnhancement;
+        let receivedSettings;
+        try {
+          receivedSettings = contextEnhancement?.getSettings?.();
+        } catch {
+          // Optional settings failures leave the original message path active.
+        }
         const task = Promise.resolve().then(async () => {
           if (this.#bridge !== bridge) return;
           let message;
@@ -282,7 +296,12 @@ export class DingtalkRuntime {
           }
           if (!message || typeof message !== 'object') return;
           this.#status.lastCallbackAt = Date.now();
-          await bridge.accept(message);
+          const contextSnapshot = captureContextEnhancement({
+            getSettings: () => receivedSettings,
+            get botId() { return contextEnhancement?.botId; },
+          }, message.conversationType === '1' || message.conversationType === 1 ? 'direct'
+            : message.conversationType === '2' || message.conversationType === 2 ? 'group' : null);
+          await bridge.accept(message, { contextSnapshot });
         }).catch(() => {
           if (signal.aborted || this.#bridge !== bridge) return;
           this.#status.lastError = t('钉钉消息处理失败。');

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

@@ -2,6 +2,7 @@ import { createEditableMessageStream, splitMessageText } from '../shared/editabl
 import { fetchFileStream } from '../shared/file-download.mjs';
 import { fetchImageBuffer } from '../shared/image-prompt.mjs';
 import { t } from '../shared/i18n.mjs';
+import { captureContextEnhancement } from '../shared/context-enhancement.mjs';
 import { DiscordApi } from './discord-api.mjs';
 import { createDiscordBridgeStatus, DiscordHarnessBridge } from './discord-bridge.mjs';
 
@@ -213,6 +214,10 @@ export function normalizeDiscordMessage(message, botId, { fetchImpl = fetch } =
   return {
     messageId: String(message.id),
     senderId: String(message.author.id),
+    contextSource: () => ({
+      senderName: [message.member?.nick, message.author.global_name, message.author.username]
+        .find((value) => typeof value === 'string' && value.trim()),
+    }),
     senderIsBot: message.author.bot === true,
     kind: direct ? 'direct' : 'group',
     conversationId: String(message.channel_id),
@@ -427,6 +432,7 @@ export class DiscordRuntime {
   #token;
   #harness;
   #state;
+  #contextEnhancement;
   #logger;
   #replyTimeoutMs;
   #connectTimeoutMs;
@@ -457,6 +463,7 @@ export class DiscordRuntime {
     token,
     harness,
     state,
+    contextEnhancement,
     logger = console,
     replyTimeoutMs = 600_000,
     connectTimeoutMs = 20_000,
@@ -472,6 +479,7 @@ export class DiscordRuntime {
     this.#token = token;
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#connectTimeoutMs = connectTimeoutMs;
@@ -534,6 +542,7 @@ export class DiscordRuntime {
         bot: client,
         harness: this.#harness,
         state: this.#state,
+        contextEnhancement: this.#contextEnhancement,
         status: this.#status,
         logger: this.#logger,
         replyTimeoutMs: this.#replyTimeoutMs,
@@ -707,20 +716,25 @@ export class DiscordRuntime {
     if (!messageId || this.#state.hasSeen(messageId)) return;
     let route = this.#routing.get(messageId);
     if (!route) {
-      route = resolveDiscordMessageRoute(message, this.#config.platformId, {
+      const contextSnapshot = captureContextEnhancement(
+        this.#contextEnhancement,
+        message.guild_id ? 'group' : 'direct',
+      );
+      const pendingRoute = resolveDiscordMessageRoute(message, this.#config.platformId, {
         api: this.#api,
         channel: this.#channels.get(String(message.channel_id)),
         signal: this.#abortController?.signal,
         onChannel: (resolved) => this.#rememberChannel(resolved),
       });
+      route = { pendingRoute, contextSnapshot };
       this.#routing.set(messageId, route);
-      void route.finally(() => {
+      void pendingRoute.finally(() => {
         if (this.#routing.get(messageId) === route) this.#routing.delete(messageId);
       }).catch(() => undefined);
     }
     try {
-      const normalized = await route;
-      if (normalized) await bridge.accept(normalized);
+      const normalized = await route.pendingRoute;
+      if (normalized) await bridge.accept(normalized, { contextSnapshot: route.contextSnapshot });
     } catch (error) {
       if (error?.code === 'discord-thread-create-uncertain') {
         await this.#state.markSeen(messageId);

package/src/channels/feishu/bridge.mjs

@@ -46,9 +46,11 @@ import {
 } from '../shared/preset-command.mjs';
 import { runWorkspaceCommand, resolveSessionListWorkspace, workspacePathSnapshot } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
+import { captureContextEnhancement, enhanceContextContent } from '../shared/context-enhancement.mjs';
 import { deliverOutboundArtifacts } from '../shared/semantic/artifact-delivery.mjs';
 import {
   createDeliveryReceipt,
+  providerMessageIdsFor,
 } from '../shared/semantic/delivery.mjs';
 import {
   channelDeliveryFailure,
@@ -382,12 +384,14 @@ export class FeishuHarnessBridge {
   #channel;
   #harness;
   #state;
+  #contextEnhancement;
   #queues = new Map();
   #batchInputs = new BatchInputManager();
   #pendingInteractions = new Map();
   #interactionKeys = new Map();
   #resolvedQuestionReplies = new Map();
-  #acceptedMessageIds = new Set();
+  // Keep the accepted configuration through the existing queue/reply lifecycle.
+  #acceptedMessageIds = new Map();
   #interactionTasks = new Set();
   #commandTasks = new Set();
   /** All accepted card work, including tasks waiting behind an earlier click. */
@@ -446,6 +450,7 @@ export class FeishuHarnessBridge {
     channel,
     harness,
     state,
+    contextEnhancement,
     status,
     allowedSenderOpenIds = new Set(),
     botId,
@@ -482,6 +487,7 @@ export class FeishuHarnessBridge {
     this.#channel = channel;
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#status = status;
     this.#allowedSenderOpenIds = allowedSenderOpenIds;
     this.#botId = nonEmptyString(botId);
@@ -550,7 +556,10 @@ export class FeishuHarnessBridge {
       if (chatId) rememberConnectionTestTarget(this.#state, { chatId });
     }
 
-    this.#acceptedMessageIds.add(messageId);
+    this.#acceptedMessageIds.set(messageId, captureContextEnhancement(
+      this.#contextEnhancement,
+      event.message.chat_type === 'p2p' ? 'direct' : event.message.chat_type === 'group' ? 'group' : null,
+    ));
     const processingReaction = this.#beginReaction(messageId);
     const commandMessage = extractInboundMessage(event, this.#client);
     const commandText = nonEmptyString(commandMessage.content) ?? '';
@@ -3142,9 +3151,16 @@ export class FeishuHarnessBridge {
       askCompleted = true;
       onAskComplete?.();
     };
-    const content = hasInboundImages(message)
+    let content = hasInboundImages(message)
       ? await promptContentForMessage(message, { signal: this.#signal })
       : undefined;
+    const snapshot = this.#acceptedMessageIds.get(messageId);
+    if (snapshot) {
+      content = enhanceContextContent(content ?? text, snapshot, () => ({
+        channel: 'feishu',
+        senderId: senderOpenId(event),
+      }));
+    }
     if (!this.#channel?.stream) {
       const { answer, artifacts = [] } = await askInWorkspaceSession({
         harness: this.#harness,
@@ -3315,7 +3331,7 @@ export class FeishuHarnessBridge {
       createDeliveryReceipt({
         deliveryId: messageId,
         presentation: 'feishu-cardkit',
-        providerMessageIds: stream?.messageId ? [stream.messageId] : [],
+        providerMessageIds: providerMessageIdsFor(stream),
       }),
     );
     this.#status.streamResponses = (this.#status.streamResponses ?? 0) + 1;

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

@@ -126,7 +126,37 @@ function deliveryUuid(file, chatId, messageType) {
 
 function summaryOf(text) {
   const summary = String(text ?? '').replace(/\s+/g, ' ').trim();
-  return summary.length <= 50 ? summary : `${summary.slice(0, 49)}…`;
+  return summary.length <= 50 ? summary : `${streamTextPrefix(summary, 49)}…`;
+}
+
+function streamTextPrefix(text, maxChars) {
+  let end = Math.min(text.length, maxChars);
+  // Keep a UTF-16 surrogate pair together when the limit lands inside an emoji.
+  const before = text.charCodeAt(end - 1);
+  const after = text.charCodeAt(end);
+  if (before >= 0xd800 && before <= 0xdbff && after >= 0xdc00 && after <= 0xdfff) end -= 1;
+  return text.slice(0, end);
+}
+
+function streamPreview(text) {
+  if (text.length <= MAX_STREAM_CHARS) return text;
+  const notice = `\n\n${t('内容较长，生成完成后将分段发送完整回答。')}`;
+  return streamTextPrefix(text, MAX_STREAM_CHARS - notice.length) + notice;
+}
+
+function splitStreamContent(text) {
+  const chunks = [];
+  let remaining = text;
+  while (remaining.length > MAX_STREAM_CHARS) {
+    const prefix = streamTextPrefix(remaining, MAX_STREAM_CHARS);
+    let end = prefix.lastIndexOf('\n') + 1;
+    if (end < MAX_STREAM_CHARS * 0.6) end = prefix.length;
+    chunks.push(remaining.slice(0, end));
+    // Unlike plain-text fallback splitting, keep all whitespace in the answer.
+    remaining = remaining.slice(end);
+  }
+  if (remaining) chunks.push(remaining);
+  return chunks;
 }
 
 function streamingCard(initialText) {
@@ -164,7 +194,7 @@ export class VerifiedFeishuChannel {
     fileMessageTimeoutMs = MAX_FILE_OPERATION_TIMEOUT_MS,
   }) {
     this.#client = client;
-    this.#initialText = initialText ?? t(DEFAULT_INITIAL_TEXT);
+    this.#initialText = String(initialText ?? t(DEFAULT_INITIAL_TEXT)) || '…';
     this.#fileUploadTimeoutMs = boundedFileTimeout(fileUploadTimeoutMs, 'fileUploadTimeoutMs');
     this.#fileMessageTimeoutMs = boundedFileTimeout(fileMessageTimeoutMs, 'fileMessageTimeoutMs');
   }
@@ -174,59 +204,40 @@ export class VerifiedFeishuChannel {
       throw new Error('Feishu stream requires a markdown producer');
     }
 
-    let messageId = null;
-    const cardResponse = assertApiSuccess('Feishu card.create', await this.#client.cardkit.v1.card.create({
-      data: {
-        type: 'card_json',
-        data: JSON.stringify(streamingCard(this.#initialText)),
-      },
-    }));
-    const cardId = cardResponse?.data?.card_id;
-    if (!cardId) throw new Error('Feishu card.create returned no card_id');
-
+    const cards = [];
     try {
-      messageId = await this.#sendCard(chatId, cardId, options.replyTo);
-      let sequence = 0;
+      const firstCard = await this.#createStreamCard(chatId, options.replyTo);
+      cards.push(firstCard);
       let lastContent = this.#initialText;
       const controller = {
-        messageId,
+        messageId: firstCard.messageId,
         setContent: async (content) => {
           const next = String(content ?? '') || '…';
-          if (next === lastContent) return;
-          if (next.length > MAX_STREAM_CHARS) {
-            throw new Error(`Feishu stream content exceeds ${MAX_STREAM_CHARS} characters`);
-          }
-          const response = await this.#client.cardkit.v1.cardElement.content({
-            path: { card_id: cardId, element_id: STREAM_ELEMENT_ID },
-            data: {
-              content: next,
-              sequence: ++sequence,
-              uuid: `content_${cardId}_${sequence}`,
-            },
-          });
-          assertApiSuccess('Feishu cardElement.content', response);
+          await this.#updateStreamCard(firstCard, streamPreview(next));
+          // Updates are replaceable snapshots, including progress/tool text.
+          // Retain the full latest snapshot even when its preview is unchanged.
           lastContent = next;
         },
       };
 
       await input.markdown(controller);
-      const finishResponse = await this.#client.cardkit.v1.card.settings({
-        path: { card_id: cardId },
-        data: {
-          settings: JSON.stringify({
-            config: {
-              streaming_mode: false,
-              summary: { content: summaryOf(lastContent) || t('回答完成') },
-            },
-          }),
-          sequence: ++sequence,
-          uuid: `settings_${cardId}_${sequence}`,
-        },
-      });
-      assertApiSuccess('Feishu card.settings', finishResponse);
-      return { messageId };
+      const chunks = splitStreamContent(lastContent);
+      for (const [index, chunk] of chunks.entries()) {
+        const card = index === 0
+          ? firstCard
+          : await this.#createStreamCard(chatId, options.replyTo);
+        if (index > 0) cards.push(card);
+        await this.#updateStreamCard(card, chunk);
+        await this.#finishStreamCard(card);
+      }
+      return {
+        messageId: firstCard.messageId,
+        providerMessageIds: cards.map((card) => card.messageId),
+      };
     } catch (error) {
-      if (messageId) await this.#recall(messageId);
+      // Preserve the existing provider-error fallback contract: the bridge
+      // resends the completed answer, so remove any cards it would duplicate.
+      for (const card of cards) await this.#recall(card.messageId);
       throw error;
     }
   }
@@ -369,6 +380,51 @@ export class VerifiedFeishuChannel {
     });
   }
 
+  async #createStreamCard(chatId, replyTo) {
+    const content = streamPreview(this.#initialText);
+    const response = assertApiSuccess('Feishu card.create', await this.#client.cardkit.v1.card.create({
+      data: {
+        type: 'card_json',
+        data: JSON.stringify(streamingCard(content)),
+      },
+    }));
+    const cardId = response?.data?.card_id;
+    if (!cardId) throw new Error('Feishu card.create returned no card_id');
+    const messageId = await this.#sendCard(chatId, cardId, replyTo);
+    return { cardId, messageId, content, sequence: 0 };
+  }
+
+  async #updateStreamCard(card, content) {
+    if (content === card.content) return;
+    const response = await this.#client.cardkit.v1.cardElement.content({
+      path: { card_id: card.cardId, element_id: STREAM_ELEMENT_ID },
+      data: {
+        content,
+        sequence: ++card.sequence,
+        uuid: `content_${card.cardId}_${card.sequence}`,
+      },
+    });
+    assertApiSuccess('Feishu cardElement.content', response);
+    card.content = content;
+  }
+
+  async #finishStreamCard(card) {
+    const response = await this.#client.cardkit.v1.card.settings({
+      path: { card_id: card.cardId },
+      data: {
+        settings: JSON.stringify({
+          config: {
+            streaming_mode: false,
+            summary: { content: summaryOf(card.content) || t('回答完成') },
+          },
+        }),
+        sequence: ++card.sequence,
+        uuid: `settings_${card.cardId}_${card.sequence}`,
+      },
+    });
+    assertApiSuccess('Feishu card.settings', response);
+  }
+
   async #sendCard(chatId, cardId, replyTo) {
     const content = JSON.stringify({ type: 'card', data: { card_id: cardId } });
     const response = replyTo