@xmanrui/dsh-im 2.3.0 → 2.5.0

package/src/channels/feishu/bridge.mjs

@@ -9,6 +9,7 @@ import {
 } from './message-utils.mjs';
 import {
   hasInboundImages,
+  imagePromptDiagnostic,
   imagePromptUserMessage,
   promptContentForMessage,
 } from '../shared/image-prompt.mjs';
@@ -48,6 +49,12 @@ import { deliverOutboundArtifacts } from '../shared/semantic/artifact-delivery.m
 import {
   createDeliveryReceipt,
 } from '../shared/semantic/delivery.mjs';
+import {
+  channelDeliveryFailure,
+  clearLastMessageFailure,
+  messageFailureText,
+  setLastMessageFailure,
+} from '../shared/message-failure.mjs';
 import {
   MENU_PAGE_SIZE,
   PRESET_FOLLOW_DEFAULT_SENTINEL,
@@ -106,9 +113,10 @@ const CARD_OVERLOAD_NOTICE_COOLDOWN_MS = 5_000;
 const CARD_DATA_TIMEOUT_MS = 5_000;
 const REPAIR_LINK_WAIT_MS = 15_000;
 const REPAIR_POLL_INTERVAL_MS = 1_000;
-const REPAIR_ACTIVE_STATES = new Set([
-  'starting', 'qr_ready', 'polling', 'slow_down', 'domain_switched', 'saving',
+const REPAIR_AUTHORIZATION_STATES = new Set([
+  'starting', 'qr_ready', 'polling', 'slow_down', 'domain_switched',
 ]);
+const REPAIR_ACTIVE_STATES = new Set([...REPAIR_AUTHORIZATION_STATES, 'saving']);
 const REPAIR_TERMINAL_STATES = new Set([
   'succeeded', 'expired', 'cancelled', 'error',
 ]);
@@ -150,7 +158,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 并完成必要审批后重试。', { name });
+      return t('结果文件「{name}」已生成，但机器人缺少飞书文件上传权限 im:resource。请私聊机器人执行 /repair 命令，或者在插件页面点击“补全权限”按钮并扫码。完成飞书要求的发布审批后重试。', { name });
     case 'artifact-too-large':
       return t('结果文件「{name}」超过飞书 30 MB 上限，未发送。', { name });
     case 'artifact-empty':
@@ -364,6 +372,7 @@ function ensureStatus(status) {
   status.lastReplyAt ??= null;
   status.lastRejectedAt ??= null;
   status.lastError ??= null;
+  status.lastMessageError ??= null;
 }
 
 export class FeishuHarnessBridge {
@@ -410,7 +419,6 @@ export class FeishuHarnessBridge {
   #botOpenId;
   #groupResponseMode;
   #repair;
-  #repairOwnerOpenIds;
   #repairAttempt = null;
   #repairMonitorVersion = 0;
   #repairPollIntervalMs;
@@ -443,7 +451,6 @@ export class FeishuHarnessBridge {
     botOpenId,
     groupResponseMode = FEISHU_GROUP_RESPONSE_MODES.ALL,
     repair,
-    repairOwnerOpenIds,
     repairPollIntervalMs = REPAIR_POLL_INTERVAL_MS,
     repairLinkWaitMs = REPAIR_LINK_WAIT_MS,
     cardDataTimeoutMs = CARD_DATA_TIMEOUT_MS,
@@ -480,10 +487,6 @@ export class FeishuHarnessBridge {
     this.#botOpenId = nonEmptyString(botOpenId);
     this.#groupResponseMode = normalizeFeishuGroupResponseMode(groupResponseMode);
     this.#repair = repair ?? null;
-    const repairOwners = repairOwnerOpenIds ?? allowedSenderOpenIds;
-    this.#repairOwnerOpenIds = new Set(
-      [...(repairOwners ?? [])].filter((value) => typeof value === 'string' && value && value !== '*'),
-    );
     this.#repairPollIntervalMs = repairPollIntervalMs;
     this.#repairLinkWaitMs = repairLinkWaitMs;
     this.#cardDataTimeoutMs = cardDataTimeoutMs;
@@ -806,6 +809,30 @@ export class FeishuHarnessBridge {
     return current;
   }
 
+  #recordFailure(error, {
+    logLabel = 'operation',
+    logLevel = 'warn',
+    userMessage,
+    reason,
+  } = {}) {
+    this.#status.lastError = error?.message ?? String(error);
+    const failure = setLastMessageFailure(this.#status, error, { userMessage, reason });
+    this.#logger?.[logLevel]?.(
+      `[dsh-feishu] ${logLabel} failed [${failure.referenceId}]:`,
+      error?.message ?? String(error),
+    );
+    return failure;
+  }
+
+  async #sendFailure(chatId, error, options = {}) {
+    const failure = this.#recordFailure(error, options);
+    const text = options.appendMessage
+      ? `${messageFailureText(failure)}\n\n${options.appendMessage}`
+      : messageFailureText(failure);
+    await this.#send(chatId, text).catch(() => undefined);
+    return failure;
+  }
+
   async #handleMessageFailure(event, messageId, processingReaction, error) {
     if (error?.code === 'turn-stopped') {
       await this.#removeProcessingReaction(messageId, processingReaction);
@@ -818,15 +845,21 @@ export class FeishuHarnessBridge {
       await this.#removeProcessingReaction(messageId, processingReaction);
       return;
     }
-    this.#logger.error?.('[dsh-feishu] message handling failed:', error?.message ?? String(error));
-    this.#status.lastError = error?.message ?? String(error);
+    const userMessage = inboundFileUserMessage(error)
+      ?? imagePromptUserMessage(error);
+    const failure = this.#recordFailure(error, {
+      logLabel: 'message handling',
+      logLevel: 'error',
+      userMessage,
+      reason: imagePromptDiagnostic(error)?.reason,
+    });
     await this.#finishReaction(messageId, processingReaction, 'ERROR');
+    const failureText = error?.batchInputMessage
+      ? `${messageFailureText(failure)}\n\n${error.batchInputMessage}`
+      : messageFailureText(failure);
     await this.#send(
       event.message.chat_id,
-      error?.batchInputMessage
-        ?? inboundFileUserMessage(error)
-        ?? imagePromptUserMessage(error)
-        ?? t('处理失败，请稍后重试。如果问题持续，请在 DeepSeek Harness 的飞书插件页面检查连接状态。'),
+      failureText,
     ).catch(() => undefined);
   }
 
@@ -1030,7 +1063,11 @@ export class FeishuHarnessBridge {
     const batchSubmission = event.batchSubmission ?? null;
     let batchAskCompleted = false;
     try {
-      const receipt = await this.#answerWithStream(event, key, message, {
+      const {
+        receipt,
+        artifactSendErrors,
+        textDeliveryErrors = 0,
+      } = await this.#answerWithStream(event, key, message, {
         onAskComplete: batchSubmission
           ? () => {
               batchAskCompleted = this.#batchInputs.complete(
@@ -1043,6 +1080,9 @@ export class FeishuHarnessBridge {
       this.#status.messagesReplied += 1;
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
+      if (textDeliveryErrors === 0 && artifactSendErrors === 0) {
+        clearLastMessageFailure(this.#status);
+      }
       return receipt;
     } catch (error) {
       if (batchSubmission && !batchAskCompleted) {
@@ -1054,6 +1094,9 @@ export class FeishuHarnessBridge {
         if (failed.retained) {
           const batchError = new Error(error?.message ?? String(error), { cause: error });
           batchError.code = error?.code;
+          batchError.providerCode = error?.providerCode;
+          batchError.method = error?.method;
+          if (Number.isInteger(error?.status)) batchError.status = error.status;
           batchError.batchInputMessage = failed.message;
           throw batchError;
         }
@@ -1075,13 +1118,8 @@ export class FeishuHarnessBridge {
       return;
     }
     const actorOpenId = strictSenderOpenId(event);
-    if (!actorOpenId || !this.#repairOwnerOpenIds.has(actorOpenId)) {
-      await this.#send(
-        event.message.chat_id,
-        this.#repairOwnerOpenIds.size === 0
-          ? t('当前机器人没有可验证的接入者身份，不能从聊天发起修复；请先在插件页设置管理员。')
-          : t('此操作只能由机器人接入者在私聊中发起，未进行任何修改。'),
-      );
+    if (!actorOpenId) {
+      await this.#send(event.message.chat_id, t('无法识别当前发送者，未发起修复。'));
       return;
     }
     if (!this.#repair) {
@@ -1110,7 +1148,7 @@ export class FeishuHarnessBridge {
       return;
     }
     if (attempt.actorOpenId !== actorOpenId) {
-      await this.#send(chatId, t('另一位管理员正在修复该机器人，本次不会显示其授权信息。'));
+      await this.#send(chatId, t('另一位用户正在修复该机器人，本次不会显示其授权信息。'));
       return;
     }
     if (operation === 'cancel') {
@@ -1162,21 +1200,53 @@ export class FeishuHarnessBridge {
 
   async #startRepair({ actorOpenId, chatId }) {
     const previous = this.#repairAttempt;
+    let restarted = false;
     if (previous && REPAIR_ACTIVE_STATES.has(previous.snapshot.state)) {
       if (previous.actorOpenId !== actorOpenId) {
-        await this.#send(chatId, t('另一位管理员正在修复该机器人，本次不会显示其授权信息。'));
+        await this.#send(chatId, t('另一位用户正在修复该机器人，本次不会显示其授权信息。'));
         return;
       }
+      let current;
       try {
-        const current = await this.#refreshRepairAttempt(previous);
-        if (REPAIR_ACTIVE_STATES.has(current.state) && previous.verificationUrl) {
-          await this.#sendRepairLink(chatId, previous.verificationUrl, current, { existing: true });
-          return;
-        }
+        current = await this.#refreshRepairAttempt(previous);
       } catch {
         await this.#send(chatId, t('暂时无法查询修复状态，请稍后重试。'));
         return;
       }
+      // Once Feishu has accepted the update, starting another attempt could
+      // race the credential swap and callback probe. Status commands remain
+      // available while that non-cancellable convergence is in progress.
+      if (current.state === 'saving') {
+        await this.#send(chatId, this.#repairStatusText(current));
+        return;
+      }
+      // Feishu launcher links carry one-time user codes. Opening one with the
+      // wrong Open Platform account can consume it even though authorization
+      // did not succeed, so a fresh bare /repair must replace a still-waiting
+      // attempt instead of redisplaying the same unusable URL.
+      if (REPAIR_AUTHORIZATION_STATES.has(current.state)) {
+        let cancelled;
+        try {
+          cancelled = repairSnapshot(
+            await this.#repair.cancel(this.#repairArgs(previous)),
+            { botId: this.#botId },
+          );
+          previous.snapshot = cancelled;
+        } catch {
+          await this.#send(chatId, t('暂时无法取消旧修复任务，未生成新链接；请稍后重试。'));
+          return;
+        }
+        if (!REPAIR_TERMINAL_STATES.has(cancelled.state)) {
+          await this.#send(chatId, this.#repairStatusText(cancelled));
+          return;
+        }
+        previous.stopped = true;
+        this.#repairMonitorVersion += 1;
+        restarted = cancelled.state === 'cancelled';
+      } else if (REPAIR_TERMINAL_STATES.has(current.state)) {
+        previous.stopped = true;
+        this.#repairMonitorVersion += 1;
+      }
     }
 
     let snapshot;
@@ -1225,7 +1295,7 @@ export class FeishuHarnessBridge {
       await this.#send(chatId, t('飞书未返回授权链接，已中止本次修复。'));
       return;
     }
-    await this.#sendRepairLink(chatId, attempt.verificationUrl, snapshot);
+    await this.#sendRepairLink(chatId, attempt.verificationUrl, snapshot, { restarted });
     this.#monitorRepair(attempt);
   }
 
@@ -1303,15 +1373,15 @@ export class FeishuHarnessBridge {
     });
   }
 
-  async #sendRepairLink(chatId, url, snapshot, { existing = false } = {}) {
+  async #sendRepairLink(chatId, url, snapshot, { restarted = false } = {}) {
     const remaining = snapshot.remainingSeconds
       ?? (snapshot.expiresAt ? Math.max(0, Math.ceil((snapshot.expiresAt - Date.now()) / 1000)) : null);
     const expiry = remaining === null
       ? t('链接为短期有效')
       : t('链接约 {minutes} 分钟后过期', { minutes: Math.max(1, Math.ceil(remaining / 60)) });
     await this.#send(chatId, [
-      existing ? t('已有一个修复任务在等待授权。') : t('🔧 准备修复卡片按钮。'),
-      t('本次只会增量添加 card.action.trigger。请核对确认页只显示这一项；若出现其他权限或事件，请取消。'),
+      restarted ? t('旧授权链接已作废，已生成新的修复链接。') : t('🔧 准备补全权限与回调。'),
+      t('本次最多增量添加三项：卡片回调 card.action.trigger；飞书显示为“获取单聊、群组消息”的租户权限 im:message:readonly（用于读取用户消息中的图片或文件）；以及 im:resource（用于上传机器人发送的图片或文件）。确认页只会显示当前缺少的项；若出现上述范围之外的配置，请取消。'),
       '',
       t('当前设备直接打开：'),
       url,
@@ -1621,9 +1691,7 @@ export class FeishuHarnessBridge {
       })
       .catch(async (error) => {
         if (this.#signal?.aborted) return;
-        this.#logger.warn?.('[dsh-feishu] card action failed:', error?.message ?? String(error));
-        this.#status.lastError = error?.message ?? String(error);
-        await this.#send(entry.chatId, t('卡片操作失败，请稍后重试。')).catch(() => undefined);
+        await this.#sendFailure(entry.chatId, error, { logLabel: 'card action' });
       })
       .finally(() => {
         if (this.#cardActionInFlight.get(dedupeKey) === tracked) {
@@ -1986,8 +2054,7 @@ export class FeishuHarnessBridge {
         },
       );
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] session list failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取会话列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'session list' });
     }
   }
 
@@ -2004,8 +2071,7 @@ export class FeishuHarnessBridge {
         { key, updateMessageId },
       );
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] workspace list failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取工作区列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'workspace list' });
     }
   }
 
@@ -2016,7 +2082,10 @@ export class FeishuHarnessBridge {
       await this.#send(chatId, t('已绑定会话「{title}」\nID：{id}', { title, id: bound?.sessionId ?? sessionId }));
       await this.#sendMenuCard(key, chatId, { updateMessageId });
     } catch (error) {
-      await this.#send(chatId, t('绑定失败：{message}', { message: safeErrorText(error) }));
+      await this.#sendFailure(chatId, error, {
+        logLabel: 'session binding',
+        userMessage: t('绑定失败：{message}', { message: safeErrorText(error) }),
+      });
     }
   }
 
@@ -2026,7 +2095,10 @@ export class FeishuHarnessBridge {
       await this.#send(chatId, t('工作区已切换为：{workspace}', { workspace: current }));
       await this.#sendMenuCard(key, chatId, { updateMessageId });
     } catch (error) {
-      await this.#send(chatId, t('切换失败：{message}', { message: safeErrorText(error) }));
+      await this.#sendFailure(chatId, error, {
+        logLabel: 'workspace switch',
+        userMessage: t('切换失败：{message}', { message: safeErrorText(error) }),
+      });
     }
   }
 
@@ -2225,8 +2297,7 @@ export class FeishuHarnessBridge {
       catalog._currentId = settings.agentPreset;
       await this.#sendCard(chatId, presetCard(catalog), { key, updateMessageId });
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] preset card failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取预设列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'preset card' });
     }
   }
 
@@ -2251,8 +2322,7 @@ export class FeishuHarnessBridge {
       }
       await this.#sendCard(chatId, modelCard(catalog), { key, updateMessageId });
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] model card failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取模型列表，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'model card' });
     }
   }
 
@@ -2280,8 +2350,7 @@ export class FeishuHarnessBridge {
       }
       await this.#send(chatId, lines.join('\n'));
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] status text failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取系统状态，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'status text' });
     }
   }
 
@@ -2333,8 +2402,7 @@ export class FeishuHarnessBridge {
 
       await this.#sendCard(chatId, statusCard(info), { key, updateMessageId });
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] status card failed:', error.message);
-      await this.#send(chatId, t('暂时无法获取系统状态，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'status card' });
     }
   }
 
@@ -2359,8 +2427,7 @@ export class FeishuHarnessBridge {
       );
       await this.#send(chatId, result?.message || t('上下文压缩失败。'));
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] compact failed:', error.message, error.code);
-      await this.#send(chatId, t('上下文压缩失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'compact' });
     }
   }
 
@@ -2383,8 +2450,7 @@ export class FeishuHarnessBridge {
       }
       await this.#send(chatId, result?.message || t('/stop 执行完成。'));
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] stop failed:', error.message);
-      await this.#send(chatId, t('停止任务失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'stop' });
     }
   }
 
@@ -2424,8 +2490,7 @@ export class FeishuHarnessBridge {
         if (reply) await this.#send(chatId, reply);
       }
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] preset default failed:', error.message);
-      await this.#send(chatId, t('预设重置失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'preset reset' });
       return;
     }
     try {
@@ -2448,8 +2513,7 @@ export class FeishuHarnessBridge {
         if (reply) await this.#send(chatId, reply);
       }
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] preset select failed:', error.message);
-      await this.#send(chatId, t('预设切换失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'preset selection' });
       return;
     }
     try {
@@ -2481,8 +2545,7 @@ export class FeishuHarnessBridge {
         if (reply) await this.#send(chatId, reply);
       }
     } catch (error) {
-      this.#logger.warn?.('[dsh-feishu] model select failed:', error.message);
-      await this.#send(chatId, t('模型切换失败，请稍后重试。'));
+      await this.#sendFailure(chatId, error, { logLabel: 'model selection' });
       return;
     }
     try {
@@ -3024,10 +3087,14 @@ export class FeishuHarnessBridge {
             signal: this.#signal,
           })
         : undefined,
-      sendFailureNotice: async (artifact, error) => ({
+      onFailure: (artifact, error) => setLastMessageFailure(this.#status, error, {
+        userMessage: artifactFailureText(artifact?.fileName, error),
+        reason: error?.code,
+      }),
+      sendFailureNotice: async (_artifact, _error, failure) => ({
         messageId: await this.#send(
           chatId,
-          artifactFailureText(artifact?.fileName, error),
+          messageFailureText(failure),
         ),
       }),
       logger: this.#logger,
@@ -3043,11 +3110,13 @@ export class FeishuHarnessBridge {
           presentation: 'feishu-files',
         }),
         failureNoticeVisible: delivery.failureNoticeVisible,
+        artifactSendErrors: delivery.artifactSendErrors,
       };
     }
     return {
       receipt: delivery.receipt,
       failureNoticeVisible: delivery.failureNoticeVisible,
+      artifactSendErrors: delivery.artifactSendErrors,
     };
   }
 
@@ -3088,7 +3157,7 @@ export class FeishuHarnessBridge {
           },
         );
       } catch (error) {
-        textSendError = error;
+        textSendError = channelDeliveryFailure(error);
         this.#logger.warn?.(
           '[dsh-feishu] final text delivery failed; continuing with result files:',
           error,
@@ -3101,8 +3170,11 @@ export class FeishuHarnessBridge {
       if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
         throw textSendError;
       }
+      if (textSendError && delivery.artifactSendErrors === 0) {
+        setLastMessageFailure(this.#status, textSendError);
+      }
       this.#status.streamFallbacks = (this.#status.streamFallbacks ?? 0) + 1;
-      return delivery.receipt;
+      return { ...delivery, textDeliveryErrors: textSendError ? 1 : 0 };
     }
 
     let promptStarted = false;
@@ -3155,7 +3227,7 @@ export class FeishuHarnessBridge {
             },
           );
         } catch (fallbackError) {
-          textSendError = fallbackError;
+          textSendError = channelDeliveryFailure(fallbackError);
           this.#logger.warn?.(
             '[dsh-feishu] fallback text delivery failed; continuing with result files:',
             fallbackError,
@@ -3173,8 +3245,11 @@ export class FeishuHarnessBridge {
         if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
           throw textSendError;
         }
+        if (textSendError && delivery.artifactSendErrors === 0) {
+          setLastMessageFailure(this.#status, textSendError);
+        }
         this.#status.streamFallbacks = (this.#status.streamFallbacks ?? 0) + 1;
-        return delivery.receipt;
+        return { ...delivery, textDeliveryErrors: textSendError ? 1 : 0 };
       }
       if (promptStarted) throw error;
 
@@ -3202,7 +3277,7 @@ export class FeishuHarnessBridge {
           },
         );
       } catch (fallbackError) {
-        textSendError = fallbackError;
+        textSendError = channelDeliveryFailure(fallbackError);
         this.#logger.warn?.(
           '[dsh-feishu] fallback text delivery failed; continuing with result files:',
           fallbackError,
@@ -3215,8 +3290,11 @@ export class FeishuHarnessBridge {
       if (textSendError && !artifactDispatched && !delivery.failureNoticeVisible) {
         throw textSendError;
       }
+      if (textSendError && delivery.artifactSendErrors === 0) {
+        setLastMessageFailure(this.#status, textSendError);
+      }
       this.#status.streamFallbacks = (this.#status.streamFallbacks ?? 0) + 1;
-      return delivery.receipt;
+      return { ...delivery, textDeliveryErrors: textSendError ? 1 : 0 };
     }
     const delivery = await this.#deliverArtifacts(
       chatId,
@@ -3229,7 +3307,7 @@ export class FeishuHarnessBridge {
       }),
     );
     this.#status.streamResponses = (this.#status.streamResponses ?? 0) + 1;
-    return delivery.receipt;
+    return delivery;
   }
 
   async #processInteractionReply(event, messageId, key, expected, processingReaction) {

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

@@ -124,7 +124,7 @@ function backButton() {
  *   - presetCatalog: object|null    (预设目录, {items,defaultId,_currentId})
  *   - modelCatalog: object|null     (模型目录, {groups,current})
  * Number fallback: 1=续写 2=新会话 3=会话列表 4=状态
- * 5=修复 6=帮助.
+ * 5=补全权限 6=帮助.
  */
 export function menuCard(ctx) {
   const {
@@ -323,7 +323,7 @@ export function menuCard(ctx) {
 
   // 命令与数字兜底说明
   elements.push({ tag: 'div', text: markdown(t(
-    '**数字兜底**\n**1**工作区列表 · **2**新会话 · **3**会话列表 · **4**状态\n**5**🔧修复 · **6**帮助',
+    '**数字兜底**\n**1**工作区列表 · **2**新会话 · **3**会话列表 · **4**状态\n**5**🔧补全权限 · **6**帮助',
   )) });
   return cardWith(t('🤖 助手中心'), elements);
 }
@@ -495,6 +495,7 @@ export function menuHelpText() {
     '',
     '📊 状态 / 压缩',
     '/status  连接状态',
+    '/version  查看插件版本',
     '/compact  压缩当前会话上下文',
     '/archived on/off  会话列表显示/隐藏归档',
     '',
@@ -521,7 +522,7 @@ export function menuHelpText() {
     '🎮 任务控制',
     '/stop  停止当前任务',
     '/steer 指令  给 Agent 补充指令',
-    '/repair  修复卡片按钮回调',
+    '/repair  补全飞书权限与卡片回调',
   ].map((line) => t(line)).join('\n');
 }
 
@@ -572,14 +573,14 @@ const HELP_TEXT_COMMANDS = [
   '`/batch` — 开启批量输入（仅私聊，最多 10 条文字）',
   '`/send` — 提交当前批次',
   '`/cancel` — 取消当前批次',
-  '`/repair` — 修复卡片按钮',
+  '`/repair` — 补全飞书权限与卡片回调',
 ].join('\n');
 
 const HELP_NUMBER_FALLBACK = [
   '**💡 数字兜底**',
   '回复数字快速操作：',
   '**1**工作区列表 · **2**新会话 · **3**会话/关注',
-  '**4**状态 · **5**修复 · **6**帮助',
+    '**4**状态 · **5**补全权限 · **6**帮助',
 ].join('\n');
 
 export function helpCard(extraTextLines = []) {
@@ -589,7 +590,10 @@ export function helpCard(extraTextLines = []) {
   const elements = [
     { tag: 'div', text: markdown(t(HELP_CARD_FEATURES)) },
     { tag: 'hr' },
-    { tag: 'div', text: markdown(t(HELP_TEXT_COMMANDS) + extraText) },
+    { tag: 'div', text: markdown([
+      t(HELP_TEXT_COMMANDS),
+      t('`/version` — 查看插件版本'),
+    ].join('\n') + extraText) },
     { tag: 'hr' },
     { tag: 'div', text: markdown(t(HELP_NUMBER_FALLBACK)) },
     { tag: 'hr' },

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

@@ -267,7 +267,6 @@ export class FeishuRuntime {
         botOpenId: this.#botOpenId,
         groupResponseMode: this.#groupResponseMode,
         repair: this.#repair,
-        repairOwnerOpenIds: new Set(this.#ownerOpenIds.filter((value) => value !== '*')),
         replyTimeoutMs: this.#replyTimeoutMs,
         signal,
         logger: this.#logger,

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，发布新版本并完成必要的管理员审批后，再重新发送图片。';
+  '飞书机器人缺少图片读取权限 im:message:readonly（飞书显示为“获取单聊、群组消息”）。请私聊机器人执行 /repair 命令，或者在插件页面点击“补全权限”按钮并扫码。按飞书提示发布新版本、完成必要审批后，再重新发送图片。';
 
 export function conversationKey(event) {
   const chatType = event?.message?.chat_type;

package/src/channels/feishu/multi-bot-controller.mjs

@@ -1,5 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { connectionTestMessage } from '../shared/connection-test.mjs';
+import { publicMessageFailure } from '../shared/message-failure.mjs';
 import { RegistrationManager } from './registration-manager.mjs';
 import {
   CALLBACK_REPAIR_OPERATION,
@@ -633,6 +634,7 @@ export class MultiBotDshFeishuController {
         groupMessagePermissionGranted: config.groupMessagePermissionGranted === true,
         bot: publicBot(config),
         connection,
+        lastMessageError: publicMessageFailure(connection.lastMessageError),
         error,
       };
     });
@@ -869,22 +871,6 @@ export class MultiBotDshFeishuController {
         'Feishu returned credentials for a different account domain.',
       );
     }
-    if (record.initiator.actorOpenId && record.initiator.actorOpenId !== ownerOpenId) {
-      throw this.#callbackRepairError(
-        record,
-        'repair_owner_mismatch',
-        'The Feishu repair was confirmed by a different operator.',
-      );
-    }
-    if (!target.ownerOpenIds.includes(ALL_VISIBLE_SENDERS)
-      && !target.ownerOpenIds.includes(ownerOpenId)) {
-      throw this.#callbackRepairError(
-        record,
-        'repair_owner_mismatch',
-        'The Feishu repair operator is not an owner of this configured bot.',
-      );
-    }
-
     record.stage = 'verifying_identity';
     let verified;
     try {
@@ -1008,7 +994,7 @@ export class MultiBotDshFeishuController {
     record.stage = 'awaiting_callback';
     try {
       const proof = await runtime.beginCardActionProbe({
-        expectedOperatorOpenId: ownerOpenId,
+        expectedOperatorOpenId: record.initiator.actorOpenId ?? ownerOpenId,
         timeoutMs: this.#callbackProbeTimeoutMs,
         ...(record.initiator.chatId ? { chatId: record.initiator.chatId } : {}),
       });