@xmanrui/dsh-im 3.1.1 → 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,6 +46,7 @@ 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,
@@ -383,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. */
@@ -447,6 +450,7 @@ export class FeishuHarnessBridge {
     channel,
     harness,
     state,
+    contextEnhancement,
     status,
     allowedSenderOpenIds = new Set(),
     botId,
@@ -483,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);
@@ -551,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) ?? '';
@@ -3143,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,

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

@@ -104,6 +104,7 @@ export class FeishuRuntime {
   #ownerOpenIds;
   #harness;
   #state;
+  #contextEnhancement;
   #replyTimeoutMs;
   #connectTimeoutMs;
   #requestTimeoutMs;
@@ -131,6 +132,7 @@ export class FeishuRuntime {
     ownerOpenIds,
     harness,
     state,
+    contextEnhancement,
     repair,
     replyTimeoutMs = 600000,
     connectTimeoutMs = 15000,
@@ -162,6 +164,7 @@ export class FeishuRuntime {
     this.#ownerOpenIds = normalizedOwners;
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#repair = repair ?? null;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#connectTimeoutMs = connectTimeoutMs;
@@ -260,6 +263,7 @@ export class FeishuRuntime {
         channel,
         harness: this.#harness,
         state: this.#state,
+        contextEnhancement: this.#contextEnhancement,
         status: this.#status,
         allowedSenderOpenIds: new Set(this.#ownerOpenIds),
         botId: this.#botId,

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

@@ -21,6 +21,7 @@ import {
   runPresetCommand,
 } from '../shared/preset-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
+import { captureContextEnhancement, enhanceContextContent } from '../shared/context-enhancement.mjs';
 import {
   BatchInputManager,
   batchInputBusyMessage,
@@ -365,6 +366,7 @@ export class QqHarnessBridge {
   #ownerUserOpenid;
   #harness;
   #state;
+  #contextEnhancement;
   #status;
   #logger;
   #replyTimeoutMs;
@@ -374,7 +376,8 @@ export class QqHarnessBridge {
   #queues = new Map();
   #pendingInteractions = new Map();
   #interactionKeys = new Map();
-  #acceptedMessageIds = new Set();
+  // Keep the accepted configuration through the existing queue/reply lifecycle.
+  #acceptedMessageIds = new Map();
   #approvalTasks = new Set();
   #commandTasks = new Set();
   #approvals;
@@ -385,6 +388,7 @@ export class QqHarnessBridge {
     ownerUserOpenid,
     harness,
     state,
+    contextEnhancement,
     status = createQqBridgeStatus(),
     logger = console,
     replyTimeoutMs = 600_000,
@@ -403,6 +407,7 @@ export class QqHarnessBridge {
     this.#ownerUserOpenid = ownerUserOpenid;
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#status = status;
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
@@ -425,7 +430,10 @@ export class QqHarnessBridge {
       || this.#state.hasSeen(messageId)
       || this.#acceptedMessageIds.has(messageId)) return Promise.resolve();
     const key = conversationKey(message);
-    this.#acceptedMessageIds.add(messageId);
+    this.#acceptedMessageIds.set(messageId, captureContextEnhancement(
+      this.#contextEnhancement,
+      message.kind === 'c2c' ? 'direct' : 'group',
+    ));
     if (message.kind === 'c2c'
       && (this.#ownerUserOpenid === '*' || sender === this.#ownerUserOpenid)
       && message.replyTarget?.scope === 'c2c'
@@ -777,9 +785,17 @@ export class QqHarnessBridge {
         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: 'qq',
+          senderId: sender,
+          senderName: message.kind === 'group' ? message.senderName : undefined,
+        }));
+      }
       // QQ stream_messages can acknowledge a final frame without rendering it in
       // some C2C clients. Standard Markdown delivery is the reliable reply path.
       const toolErrors = [];
@@ -793,7 +809,7 @@ export class QqHarnessBridge {
           harness: this.#harness,
           state: this.#state,
           key,
-          ...(hasImages ? { content } : { text }),
+          ...(content !== undefined ? { content } : { text }),
           createOptions: { signal: this.#signal },
           existsOptions: { signal: this.#signal },
           askOptions: {

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

@@ -31,6 +31,7 @@ export class QqRuntime {
   #appSecret;
   #harness;
   #state;
+  #contextEnhancement;
   #logger;
   #replyTimeoutMs;
   #connectTimeoutMs;
@@ -48,6 +49,7 @@ export class QqRuntime {
     appSecret,
     harness,
     state,
+    contextEnhancement,
     logger = console,
     replyTimeoutMs = 600_000,
     connectTimeoutMs = 20_000,
@@ -61,6 +63,7 @@ export class QqRuntime {
     this.#appSecret = appSecret;
     this.#harness = harness;
     this.#state = state;
+    this.#contextEnhancement = contextEnhancement;
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#connectTimeoutMs = connectTimeoutMs;
@@ -139,6 +142,7 @@ export class QqRuntime {
       ownerUserOpenid: this.#config.ownerUserOpenid,
       harness: this.#harness,
       state: this.#state,
+      contextEnhancement: this.#contextEnhancement,
       status: this.#status,
       logger: this.#logger,
       replyTimeoutMs: this.#replyTimeoutMs,