@xmanrui/dsh-im 2.5.0 → 3.0.0

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

@@ -1,4 +1,7 @@
 import {
+  DINGTALK_DONE_REACTION_NAME,
+  DINGTALK_ERROR_REACTION_NAME,
+  DINGTALK_THINKING_REACTION_NAME,
   normalizeDingtalkSessionWebhook,
   splitDingtalkText,
 } from './dingtalk-api.mjs';
@@ -309,7 +312,15 @@ function canClaimInteractionReply(message, pending, sender) {
 
 function ensureStats(status) {
   status.stats ??= {};
-  for (const key of ['messagesReceived', 'messagesReplied', 'messagesRejected', 'messagesIgnored']) {
+  for (const key of [
+    'messagesReceived',
+    'messagesReplied',
+    'messagesRejected',
+    'messagesIgnored',
+    'reactionsAdded',
+    'reactionsRemoved',
+    'reactionErrors',
+  ]) {
     status[key] ??= 0;
     status.stats[key] = status[key];
   }
@@ -328,6 +339,9 @@ export function createDingtalkBridgeStatus({ pendingSenders = [] } = {}) {
     messagesReplied: 0,
     messagesRejected: 0,
     messagesIgnored: 0,
+    reactionsAdded: 0,
+    reactionsRemoved: 0,
+    reactionErrors: 0,
     lastMessageAt: null,
     lastReplyAt: null,
     lastRejectedAt: null,
@@ -339,6 +353,9 @@ export function createDingtalkBridgeStatus({ pendingSenders = [] } = {}) {
       messagesReplied: 0,
       messagesRejected: 0,
       messagesIgnored: 0,
+      reactionsAdded: 0,
+      reactionsRemoved: 0,
+      reactionErrors: 0,
     },
   };
 }
@@ -352,6 +369,7 @@ export class DingtalkHarnessBridge {
   #status;
   #logger;
   #replyTimeoutMs;
+  #reactionTimeoutMs;
   #maxMessageChars;
   #signal;
   #queues = new Map();
@@ -372,6 +390,7 @@ export class DingtalkHarnessBridge {
     status = createDingtalkBridgeStatus(),
     logger = console,
     replyTimeoutMs = 600_000,
+    reactionTimeoutMs = 5_000,
     maxMessageChars = 4_000,
     signal,
   }) {
@@ -389,6 +408,9 @@ export class DingtalkHarnessBridge {
     this.#logger = logger;
     this.#approvals = new HarnessApprovalQueue({ label: 'DingTalk', logger });
     this.#replyTimeoutMs = replyTimeoutMs;
+    this.#reactionTimeoutMs = Number.isFinite(reactionTimeoutMs) && reactionTimeoutMs > 0
+      ? Math.floor(reactionTimeoutMs)
+      : 5_000;
     this.#maxMessageChars = maxMessageChars;
     this.#signal = signal;
     ensureStats(this.#status);
@@ -436,15 +458,35 @@ export class DingtalkHarnessBridge {
     const commandText = nonEmptyString(promptMessage.content) ?? '';
     const addressed = String(message.conversationType) !== '2' || message?.isInAtList === true;
     const direct = String(message.conversationType) !== '2';
+    const statusReaction = sessionWebhook && addressed ? this.#startStatusReaction(message) : null;
+    const finish = (task) => Promise.resolve(task).then(
+      (value) => {
+        this.#finishStatusReaction(
+          statusReaction,
+          this.#signal?.aborted ? 'clear' : 'success',
+        );
+        return value;
+      },
+      (error) => {
+        this.#finishStatusReaction(
+          statusReaction,
+          this.#signal?.aborted || error?.name === 'AbortError' || error?.code === 'turn-stopped'
+            ? 'clear'
+            : 'error',
+        );
+        throw error;
+      },
+    );
     const batchCommand = String(message?.msgtype).toLowerCase() === 'text'
       && isBatchInputCommand(commandText);
     const batchStatus = this.#batchInputs.status(key);
     if (batchCommand && !direct && sessionWebhook && addressed) {
-      return this.#finishBatchResult(
+      return finish(this.#finishBatchResult(
         messageId,
         sessionWebhook,
         { message: batchInputGroupUnsupportedMessage() },
-      );
+        statusReaction,
+      ));
     }
     if (direct && sessionWebhook && (batchCommand || batchStatus.phase === 'collecting')) {
       const exactBatchStart = /^\/batch$/iu.test(commandText);
@@ -460,7 +502,7 @@ export class DingtalkHarnessBridge {
           });
       if (result.handled) {
         if (result.kind === 'submit') {
-          return this.#enqueueMessage(
+          return finish(this.#enqueueMessage(
             {
               ...message,
               msgtype: 'text',
@@ -469,10 +511,15 @@ export class DingtalkHarnessBridge {
             messageId,
             sender,
             key,
-            { batchSubmission: result },
-          );
+            { batchSubmission: result, statusReaction },
+          ));
         }
-        return this.#finishBatchResult(messageId, sessionWebhook, result);
+        return finish(this.#finishBatchResult(
+          messageId,
+          sessionWebhook,
+          result,
+          statusReaction,
+        ));
       }
     }
     const commandRunner = hasInboundFiles(promptMessage) ? null : isControlCommand(commandText)
@@ -490,7 +537,11 @@ export class DingtalkHarnessBridge {
         promptMessage,
         commandRunner,
       ).catch((error) => {
-        if (error?.code === 'turn-stopped' || this.#signal?.aborted) return;
+        if (error?.code === 'turn-stopped' || this.#signal?.aborted) {
+          this.#finishStatusReaction(statusReaction, 'clear');
+          return;
+        }
+        this.#finishStatusReaction(statusReaction, 'error');
         this.#status.lastError = error?.message ?? String(error);
         const failure = setLastMessageFailure(this.#status, error);
         this.#logger.error?.(
@@ -503,7 +554,7 @@ export class DingtalkHarnessBridge {
         this.#commandTasks.delete(task);
       });
       this.#commandTasks.add(task);
-      return task;
+      return finish(task);
     }
     const approvalReply = this.#approvals.claimReply({
       key,
@@ -537,7 +588,11 @@ export class DingtalkHarnessBridge {
           return true;
         })
         .catch((error) => {
-          if (this.#signal?.aborted) return;
+          if (this.#signal?.aborted) {
+            this.#finishStatusReaction(statusReaction, 'clear');
+            return;
+          }
+          this.#finishStatusReaction(statusReaction, 'error');
           this.#status.lastError = t('钉钉审批处理失败。');
           this.#logger.error?.('[dsh-dingtalk] failed to process an approval reply', error);
         })
@@ -546,18 +601,18 @@ export class DingtalkHarnessBridge {
           this.#interactionTasks.delete(current);
         });
       this.#interactionTasks.add(current);
-      return current;
+      return finish(current);
     }
 
     if (pending && pending.actor !== sender) {
-      return this.#enqueueMessage(message, messageId, sender, key);
+      return finish(this.#enqueueMessage(message, messageId, sender, key, { statusReaction }));
     }
     // Once one valid answer has been claimed, later messages are subsequent
     // prompts even if the network submission eventually needs a retry. Invalid
     // replies do not claim the question, so the next valid answer can still
     // pass through this interaction queue.
     if (pending?.submitting || pending?.claimedReplyMessageId) {
-      return this.#enqueueMessage(message, messageId, sender, key);
+      return finish(this.#enqueueMessage(message, messageId, sender, key, { statusReaction }));
     }
     if (pending) {
       if (canClaimInteractionReply(message, pending, sender)) {
@@ -566,7 +621,14 @@ export class DingtalkHarnessBridge {
       const previous = pending.queue ?? Promise.resolve();
       const current = previous
         .catch(() => undefined)
-        .then(() => this.#processInteractionReply(message, messageId, sender, key, pending))
+        .then(() => this.#processInteractionReply(
+          message,
+          messageId,
+          sender,
+          key,
+          pending,
+          statusReaction,
+        ))
         .finally(() => {
           this.#acceptedMessageIds.delete(messageId);
           if (pending.claimedReplyMessageId === messageId) {
@@ -575,15 +637,101 @@ export class DingtalkHarnessBridge {
           if (pending.queue === current) pending.queue = null;
         });
       pending.queue = current;
-      return current;
+      return finish(current);
     }
-    return this.#enqueueMessage(message, messageId, sender, key);
+    return finish(this.#enqueueMessage(message, messageId, sender, key, { statusReaction }));
+  }
+
+  #runReactionCall(method, target, reactionName, kind) {
+    const controller = new AbortController();
+    const operation = Promise.resolve().then(() => this.#api[method]({
+      clientId: this.#clientId,
+      clientSecret: this.#clientSecret,
+      ...target,
+      reactionName,
+      signal: controller.signal,
+    }));
+    let timer;
+    const timeout = new Promise((_, reject) => {
+      timer = setTimeout(() => {
+        const error = new DOMException('DingTalk reaction timed out', 'TimeoutError');
+        controller.abort(error);
+        reject(error);
+      }, this.#reactionTimeoutMs);
+      timer.unref?.();
+    });
+    return Promise.race([operation, timeout])
+      .then(() => {
+        increment(this.#status, kind === 'add' ? 'reactionsAdded' : 'reactionsRemoved');
+        return true;
+      })
+      .catch((error) => {
+        increment(this.#status, 'reactionErrors');
+        this.#logger.debug?.(`[dsh-dingtalk] ${method} failed`, safeErrorDiagnostic(error));
+        return false;
+      })
+      .finally(() => clearTimeout(timer));
+  }
+
+  #startStatusReaction(message) {
+    if (typeof this.#api.addReaction !== 'function'
+      || typeof this.#api.recallReaction !== 'function') return null;
+    const messageId = nonEmptyString(message?.msgId);
+    const conversationId = nonEmptyString(message?.conversationId);
+    if (!messageId || !conversationId) return null;
+    const target = {
+      messageId,
+      conversationId,
+      robotCode: nonEmptyString(message?.robotCode) ?? this.#clientId,
+    };
+    return {
+      target,
+      attached: this.#runReactionCall(
+        'addReaction',
+        target,
+        DINGTALK_THINKING_REACTION_NAME,
+        'add',
+      ),
+      terminal: false,
+    };
+  }
+
+  #finishStatusReaction(reaction, outcome) {
+    if (!reaction || reaction.terminal) return;
+    reaction.terminal = true;
+    const terminalName = outcome === 'success'
+      ? DINGTALK_DONE_REACTION_NAME
+      : outcome === 'error' ? DINGTALK_ERROR_REACTION_NAME : null;
+    // Preserve attach -> recall -> terminal ordering without extending the message task.
+    void reaction.attached.then(async (attached) => {
+      let cleaned = await this.#runReactionCall(
+        'recallReaction',
+        reaction.target,
+        DINGTALK_THINKING_REACTION_NAME,
+        'remove',
+      );
+      if (!attached || !cleaned) {
+        await new Promise((resolve) => {
+          const retry = setTimeout(resolve, Math.min(1_000, this.#reactionTimeoutMs));
+          retry.unref?.();
+        });
+        cleaned = await this.#runReactionCall(
+          'recallReaction',
+          reaction.target,
+          DINGTALK_THINKING_REACTION_NAME,
+          'remove',
+        ) || cleaned;
+      }
+      if (!cleaned || !terminalName || this.#signal?.aborted) return;
+      await this.#runReactionCall('addReaction', reaction.target, terminalName, 'add');
+    }).catch(() => undefined);
   }
 
   #enqueueMessage(message, messageId, sender, key, {
     releaseMessageId = true,
     alreadyRecorded = false,
     batchSubmission = null,
+    statusReaction = null,
   } = {}) {
     let hasSafeReplyRoute = false;
     try {
@@ -607,6 +755,7 @@ export class DingtalkHarnessBridge {
         alreadyRecorded,
         preparedMessage,
         batchSubmission,
+        statusReaction,
       }))
       .finally(() => {
         if (releaseMessageId) this.#acceptedMessageIds.delete(messageId);
@@ -659,7 +808,7 @@ export class DingtalkHarnessBridge {
     this.#status.lastError = null;
   }
 
-  #finishBatchResult(messageId, sessionWebhook, result) {
+  #finishBatchResult(messageId, sessionWebhook, result, statusReaction) {
     let task;
     task = Promise.resolve().then(async () => {
       if (this.#state.hasSeen(messageId)) return;
@@ -669,7 +818,11 @@ export class DingtalkHarnessBridge {
       if (result.message) await this.#send(sessionWebhook, result.message);
       this.#status.lastError = null;
     }).catch(async (error) => {
-      if (this.#signal?.aborted) return;
+      if (this.#signal?.aborted) {
+        this.#finishStatusReaction(statusReaction, 'clear');
+        return;
+      }
+      this.#finishStatusReaction(statusReaction, 'error');
       this.#status.lastError = error?.message ?? String(error);
       const failure = setLastMessageFailure(this.#status, error);
       this.#logger.error?.(
@@ -689,6 +842,7 @@ export class DingtalkHarnessBridge {
     alreadyRecorded = false,
     preparedMessage,
     batchSubmission = null,
+    statusReaction = null,
   } = {}) {
     this.#signal?.throwIfAborted();
     if (!alreadyRecorded) {
@@ -865,10 +1019,15 @@ export class DingtalkHarnessBridge {
         batchSettled = true;
       }
       if (error?.code === 'turn-stopped') {
+        this.#finishStatusReaction(statusReaction, 'clear');
         if (cardStarted) await cardStream.finish(t('已停止。')).catch(() => undefined);
         return;
       }
-      if (this.#signal?.aborted) return;
+      if (this.#signal?.aborted) {
+        this.#finishStatusReaction(statusReaction, 'clear');
+        return;
+      }
+      this.#finishStatusReaction(statusReaction, 'error');
       this.#status.lastError = error?.message ?? String(error);
       const userMessage = inboundFileUserMessage(error)
         ?? dingtalkImageErrorUserMessage(error);
@@ -896,7 +1055,14 @@ export class DingtalkHarnessBridge {
     }
   }
 
-  async #processInteractionReply(message, messageId, sender, key, expected) {
+  async #processInteractionReply(
+    message,
+    messageId,
+    sender,
+    key,
+    expected,
+    statusReaction,
+  ) {
     this.#signal?.throwIfAborted();
     const current = this.#pendingInteractions.get(key);
     const claimed = expected.claimedReplyMessageId === messageId;
@@ -904,7 +1070,10 @@ export class DingtalkHarnessBridge {
       if (claimed && (!current || current !== expected)) {
         return this.#discardResolvedInteractionReply(message, messageId);
       }
-      return this.#enqueueMessage(message, messageId, sender, key, { releaseMessageId: false });
+      return this.#enqueueMessage(message, messageId, sender, key, {
+        releaseMessageId: false,
+        statusReaction,
+      });
     }
     if (this.#state.hasSeen(messageId)) return;
     await this.#state.markSeen(messageId);
@@ -949,6 +1118,7 @@ export class DingtalkHarnessBridge {
       return this.#enqueueMessage(message, messageId, sender, key, {
         releaseMessageId: false,
         alreadyRecorded: true,
+        statusReaction,
       });
     }
     pending.sessionWebhook = sessionWebhook;
@@ -956,6 +1126,7 @@ export class DingtalkHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch {
+        this.#finishStatusReaction(statusReaction, 'error');
         this.#status.lastError = t('钉钉交互问题发送失败。');
         this.#logger.error?.('[dsh-dingtalk] failed to retry an interaction question');
         pending.interaction.reconnect?.();
@@ -975,6 +1146,7 @@ export class DingtalkHarnessBridge {
       try {
         await this.#presentInteraction(pending);
       } catch {
+        this.#finishStatusReaction(statusReaction, 'error');
         this.#status.lastError = t('钉钉交互问题发送失败。');
         this.#logger.error?.('[dsh-dingtalk] failed to send the next interaction question');
         pending.interaction.reconnect?.();
@@ -994,7 +1166,10 @@ export class DingtalkHarnessBridge {
       this.#clearPendingInteraction(key, pending.interactionId);
       this.#status.lastError = null;
     } catch (error) {
-      if (this.#signal?.aborted) return;
+      if (this.#signal?.aborted) {
+        this.#finishStatusReaction(statusReaction, 'clear');
+        return;
+      }
       if (this.#pendingInteractions.get(key) !== pending) return;
       if (error?.code === 'interaction-not-pending') {
         this.#clearPendingInteraction(key, pending.interactionId);
@@ -1005,6 +1180,7 @@ export class DingtalkHarnessBridge {
         }
         return;
       }
+      this.#finishStatusReaction(statusReaction, 'error');
       pending.submitting = false;
       pending.answers.pop();
       pending.index -= 1;

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

@@ -88,6 +88,12 @@ function snowflake(value, name) {
   return id;
 }
 
+function reactionEmoji(value) {
+  const emoji = cleanString(value);
+  if (!emoji) throw new TypeError('A Discord reaction emoji is required');
+  return emoji;
+}
+
 export function validDiscordToken(value) {
   return typeof value === 'string'
     && /^[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{4,}\.[A-Za-z0-9_-]{20,}$/.test(value.trim());
@@ -229,6 +235,35 @@ export class DiscordApi {
     });
   }
 
+  async addOwnReaction({ channelId, messageId, emoji, signal } = {}) {
+    const normalizedEmoji = reactionEmoji(emoji);
+    await this.#request(
+      `channels/${snowflake(channelId, 'channel id')}/messages/${snowflake(messageId, 'message id')}`
+        + `/reactions/${encodeURIComponent(normalizedEmoji)}/@me`,
+      {
+        method: 'PUT',
+        signal,
+        expectBody: false,
+        retry: false,
+      },
+    );
+    return normalizedEmoji;
+  }
+
+  removeOwnReaction({ channelId, messageId, emoji, signal } = {}) {
+    const normalizedEmoji = reactionEmoji(emoji);
+    return this.#request(
+      `channels/${snowflake(channelId, 'channel id')}/messages/${snowflake(messageId, 'message id')}`
+        + `/reactions/${encodeURIComponent(normalizedEmoji)}/@me`,
+      {
+        method: 'DELETE',
+        signal,
+        expectBody: false,
+        retry: false,
+      },
+    );
+  }
+
   async #request(path, {
     method,
     body,

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

@@ -4,6 +4,7 @@ export const DISCORD_DESCRIPTOR = Object.freeze({
   key: 'discord',
   label: 'Discord',
   connectionLabel: ' Gateway 长连接',
+  reactions: Object.freeze({ processing: '👀', success: '✅', error: '❌' }),
 });
 
 export class DiscordHarnessBridge extends TextHarnessBridge {

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

@@ -231,6 +231,10 @@ export function normalizeDiscordMessage(message, botId, { fetchImpl = fetch } =
       channelId: String(message.channel_id),
       replyToMessageId: String(message.id),
     },
+    reactionTarget: {
+      channelId: String(message.channel_id),
+      messageId: String(message.id),
+    },
     connectionTestTarget: { channelId: String(message.channel_id) },
   };
 }
@@ -350,6 +354,24 @@ export class DiscordBotClient {
     });
   }
 
+  addReaction(target, emoji, { signal } = {}) {
+    return this.#api.addOwnReaction({
+      channelId: target.channelId,
+      messageId: target.messageId,
+      emoji,
+      signal: this.#operationSignal(signal),
+    });
+  }
+
+  removeReaction(target, reactionKey, { signal } = {}) {
+    return this.#api.removeOwnReaction({
+      channelId: target.channelId,
+      messageId: target.messageId,
+      emoji: reactionKey,
+      signal: this.#operationSignal(signal),
+    });
+  }
+
   async openStream(target) {
     const notice = !this.#deliveredNotices.has(target) && target?.notice
       ? String(target.notice) : null;
@@ -381,6 +403,10 @@ export class DiscordBotClient {
     });
     return stream.start();
   }
+
+  #operationSignal(signal) {
+    return signal ?? this.#signal;
+  }
 }
 
 export function createDiscordRuntimeStatus() {

package/src/channels/feishu/bridge.mjs

@@ -55,6 +55,7 @@ import {
   messageFailureText,
   setLastMessageFailure,
 } from '../shared/message-failure.mjs';
+import { beginStatusReaction } from '../shared/status-reaction.mjs';
 import {
   MENU_PAGE_SIZE,
   PRESET_FOLLOW_DEFAULT_SENTINEL,
@@ -158,7 +159,7 @@ function artifactFailureText(fileName, error) {
   const name = String(fileName ?? t('结果文件')).replace(/[\r\n]+/g, ' ').trim() || t('结果文件');
   switch (error?.code) {
     case 'artifact-permission-required':
-      return t('结果文件「{name}」已生成，但机器人缺少飞书文件上传权限 im:resource。请私聊机器人执行 /repair 命令，或者在插件页面点击“补全权限”按钮并扫码。完成飞书要求的发布审批后重试。', { name });
+      return t('结果文件「{name}」已生成，但机器人缺少飞书文件上传权限 im:resource。请私聊机器人执行 /repair 命令，或者在「IM机器人」设置页点击“补全权限”按钮并扫码。完成飞书要求的发布审批后重试。', { name });
     case 'artifact-too-large':
       return t('结果文件「{name}」超过飞书 30 MB 上限，未发送。', { name });
     case 'artifact-empty':
@@ -549,7 +550,7 @@ export class FeishuHarnessBridge {
     }
 
     this.#acceptedMessageIds.add(messageId);
-    const processingReaction = this.#addReaction(messageId, 'OnIt');
+    const processingReaction = this.#beginReaction(messageId);
     const commandMessage = extractInboundMessage(event, this.#client);
     const commandText = nonEmptyString(commandMessage.content) ?? '';
     const batchText = event.message.message_type === 'text'
@@ -944,7 +945,10 @@ export class FeishuHarnessBridge {
     const text = message.content;
     const hasImages = hasInboundImages(message);
     const hasFiles = hasInboundFiles(message);
-    const commandText = event.message.message_type === 'text' && !hasImages && !hasFiles ? text : null;
+    // 命令识别对 text 与纯文本 post 一视同仁：post 富文本若仅含单个
+    // 文本段落（如复制粘贴的 /new），同样按命令处理；带图片/文件不认。
+    // accept() 侧已用 nonEmptyString(content) 判定，两侧保持一致。
+    const commandText = !hasImages && !hasFiles && text ? text.trim() : null;
     if (!text && !hasImages && !hasFiles) {
       await this.#send(event.message.chat_id, t('目前支持文字、图片和文件消息。'));
       return;
@@ -3603,35 +3607,24 @@ export class FeishuHarnessBridge {
     return t('_{text}_', { text: update.text || t('正在处理…') });
   }
 
-  async #addReaction(messageId, emojiType) {
-    if (!this.#channel?.addReaction) return null;
-    try {
-      const reactionId = await this.#channel.addReaction(messageId, emojiType);
-      this.#status.reactionsAdded = (this.#status.reactionsAdded ?? 0) + 1;
-      return reactionId;
-    } catch (error) {
-      this.#status.reactionErrors = (this.#status.reactionErrors ?? 0) + 1;
-      this.#logger.warn?.(`[dsh-feishu] unable to add ${emojiType} reaction:`, error.message);
-      return null;
-    }
+  #beginReaction(messageId) {
+    return beginStatusReaction({
+      adapter: this.#channel,
+      target: messageId,
+      reactions: { processing: 'OnIt', success: 'DONE', error: 'ERROR' },
+      status: this.#status,
+      logger: this.#logger,
+      label: 'feishu',
+    });
   }
 
-  async #removeProcessingReaction(messageId, processingReaction) {
-    const reactionId = await processingReaction;
-    if (reactionId && this.#channel?.removeReaction) {
-      try {
-        await this.#channel.removeReaction(messageId, reactionId);
-        this.#status.reactionsRemoved = (this.#status.reactionsRemoved ?? 0) + 1;
-      } catch (error) {
-        this.#status.reactionErrors = (this.#status.reactionErrors ?? 0) + 1;
-        this.#logger.warn?.('[dsh-feishu] unable to remove processing reaction:', error.message);
-      }
-    }
+  #removeProcessingReaction(_messageId, processingReaction) {
+    processingReaction.clear();
   }
 
-  async #finishReaction(messageId, processingReaction, finalEmojiType) {
-    await this.#removeProcessingReaction(messageId, processingReaction);
-    await this.#addReaction(messageId, finalEmojiType);
+  #finishReaction(_messageId, processingReaction, finalEmojiType) {
+    if (finalEmojiType === 'ERROR') processingReaction.error();
+    else processingReaction.success();
   }
 
   async #send(chatId, text) {

package/src/channels/feishu/message-utils.mjs

@@ -5,7 +5,7 @@ const FEISHU_MISSING_MESSAGE_SCOPE_CODE = 99991672;
 const FEISHU_ERROR_BODY_LIMIT = 64 * 1024;
 const FEISHU_ERROR_BODY_TIMEOUT_MS = 1_000;
 const FEISHU_IMAGE_PERMISSION_MESSAGE =
-  '飞书机器人缺少图片读取权限 im:message:readonly（飞书显示为“获取单聊、群组消息”）。请私聊机器人执行 /repair 命令，或者在插件页面点击“补全权限”按钮并扫码。按飞书提示发布新版本、完成必要审批后，再重新发送图片。';
+  '飞书机器人缺少图片读取权限 im:message:readonly（飞书显示为“获取单聊、群组消息”）。请私聊机器人执行 /repair 命令，或者在「IM机器人」设置页点击“补全权限”按钮并扫码。按飞书提示发布新版本、完成必要审批后，再重新发送图片。';
 
 export function conversationKey(event) {
   const chatType = event?.message?.chat_type;

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

@@ -29,7 +29,7 @@ export function connectionTestTarget(state) {
 
 export function connectionTestMessage(botName, channelLabel = t('机器人')) {
   const name = cleanText(botName) ?? channelLabel;
-  return `${t('✅ DeepSeek Harness 连接测试成功')}\n${t('这条消息由插件页面中的“{name}”机器人卡片发出。', { name })}`;
+  return `${t('✅ DeepSeek Harness 连接测试成功')}\n${t('这条消息由「IM机器人」设置页中的“{name}”机器人卡片发出。', { name })}`;
 }
 
 export function connectionTestTargetUnavailable(channelLabel = t('机器人')) {

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

@@ -18,8 +18,8 @@ export default {
   '机器人正在移除或已重新接入，无法操作原会话的工作区。':
     'The bot is being removed or has been reconnected; the original session’s workspace cannot be changed.',
   '操作失败，请稍后重试。': 'The operation failed. Please try again later.',
-  '结果文件「{name}」已生成，但机器人缺少飞书文件上传权限 im:resource。请私聊机器人执行 /repair 命令，或者在插件页面点击“补全权限”按钮并扫码。完成飞书要求的发布审批后重试。':
-    'The result file "{name}" was generated, but the bot lacks the Feishu file-upload scope im:resource. Run /repair in a direct chat with the bot, or click the “Complete permissions” button on the plugin page and scan the QR code. Complete any publishing approval Feishu requires, then try again.',
+  '结果文件「{name}」已生成，但机器人缺少飞书文件上传权限 im:resource。请私聊机器人执行 /repair 命令，或者在「IM机器人」设置页点击“补全权限”按钮并扫码。完成飞书要求的发布审批后重试。':
+    'The result file "{name}" was generated, but the bot lacks the Feishu file-upload scope im:resource. Run /repair in a direct chat with the bot, or click the “Complete permissions” button on the IM Bot settings page and scan the QR code. Complete any publishing approval Feishu requires, then try again.',
   '结果文件「{name}」超过飞书 30 MB 上限，未发送。':
     'The result file "{name}" exceeds the Feishu 30 MB limit and was not sent.',
   '结果文件「{name}」为空，飞书不允许发送空文件。':
@@ -28,8 +28,8 @@ export default {
     'The result file "{name}" was temporarily rate-limited by Feishu and could not be sent. Please try again later.',
   '结果文件「{name}」已生成，但暂时未能发送，请稍后重试。':
     'The result file "{name}" was generated but could not be sent right now. Please try again later.',
-  '处理失败，请稍后重试。如果问题持续，请在 DeepSeek Harness 的飞书插件页面检查连接状态。':
-    'Message processing failed. Please try again later. If the problem persists, check the connection status on the Feishu plugin page in DeepSeek Harness.',
+  '处理失败，请稍后重试。如果问题持续，请在 DeepSeek Harness 的「IM机器人」设置页检查飞书连接状态。':
+    'Message processing failed. Please try again later. If the problem persists, check the Feishu connection status on the IM Bot settings page in DeepSeek Harness.',
   '已开启全新 Harness 会话。': 'A brand-new Harness session has started.',
   '飞书机器人与 DeepSeek Harness 连接正常。':
     'The Feishu bot is connected to DeepSeek Harness and working normally.',
@@ -338,8 +338,8 @@ export default {
   '飞书机器人': 'Feishu bot',
 
   // feishu/message-utils.mjs
-  '飞书机器人缺少图片读取权限 im:message:readonly（飞书显示为“获取单聊、群组消息”）。请私聊机器人执行 /repair 命令，或者在插件页面点击“补全权限”按钮并扫码。按飞书提示发布新版本、完成必要审批后，再重新发送图片。':
-    'The Feishu bot is missing the image-read scope im:message:readonly, shown by Feishu as “Read direct and group messages.” Run /repair in a direct chat with the bot, or click the “Complete permissions” button on the plugin page and scan the QR code. Publish a new version and complete any approval requested by Feishu, then resend the image.',
+  '飞书机器人缺少图片读取权限 im:message:readonly（飞书显示为“获取单聊、群组消息”）。请私聊机器人执行 /repair 命令，或者在「IM机器人」设置页点击“补全权限”按钮并扫码。按飞书提示发布新版本、完成必要审批后，再重新发送图片。':
+    'The Feishu bot is missing the image-read scope im:message:readonly, shown by Feishu as “Read direct and group messages.” Run /repair in a direct chat with the bot, or click the “Complete permissions” button on the IM Bot settings page and scan the QR code. Publish a new version and complete any approval requested by Feishu, then resend the image.',
 
   // feishu/feishu-runtime.mjs — callback probe notices
   '✅ 修复完成：已实测收到 card.action.trigger，菜单按钮现在可用。':