@xmanrui/dsh-im 2.3.0 → 2.4.0

package/package.json

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

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

@@ -265,7 +265,7 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
               ? h("img", {
                 src: qrSource,
                 alt: repairing
-                  ? `用于修复${botName}卡片按钮的一次性授权二维码`
+                  ? `用于为${botName}补全权限与回调的一次性授权二维码`
                   : grantingGroupMessages
                     ? `用于为${botName}开通群消息权限的一次性授权二维码`
                     : "用于新增 DeepSeek Harness 飞书机器人的一次性授权二维码",
@@ -293,31 +293,31 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
         h("div", { className: "bxf-stateLabel dim-stateLabel" },
           h("span", { className: "bxf-dot dim-stateDot", "data-tone": "warning" }),
           h("span", null, repairing
-            ? `正在修复「${botName}」`
+            ? `正在为「${botName}」补全权限与回调`
             : grantingGroupMessages
               ? `正在为「${botName}」开通群消息权限`
               : "正在添加新机器人")),
         h("h3", null, expired
           ? "刷新二维码后继续"
           : repairing
-            ? "使用飞书扫码修复卡片按钮"
+            ? "使用飞书扫码补全权限"
             : grantingGroupMessages
               ? "使用飞书确认群消息权限"
               : "使用飞书扫码创建机器人"),
         h("p", null, repairing
-          ? "扫码会更新现有飞书应用，只增量补充卡片按钮回调；不会创建新应用。确认后此机器人会短暂重连，其他机器人不受影响。"
+          ? "扫码会更新现有飞书应用，最多增量补充卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”），以及上传机器人图片或文件所需的 im:resource；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。"
           : grantingGroupMessages
             ? "扫码会更新现有飞书应用，只增量开通“获取群组中所有消息”权限；不会创建新应用。确认后会自动启用“响应所有群消息”，其他机器人不受影响。"
             : "扫码只会新增一个机器人，已接入的机器人会继续正常收发消息。"),
         h("ol", { className: "bxf-steps dim-steps" },
           h("li", null, "打开飞书移动端，使用扫一扫读取二维码"),
           h("li", null, repairing
-            ? "核对现有应用名称，并确认只新增卡片回调"
+            ? "核对现有应用名称，并确认只新增当前缺少的上述配置"
             : grantingGroupMessages
               ? "核对现有应用，并确认“获取群组中所有消息”权限"
               : "核对应用名称与权限范围，并确认创建"),
           h("li", null, repairing
-            ? "保持本页打开，等待卡片按钮修复完成"
+            ? "保持本页打开，等待权限与回调补全完成"
             : grantingGroupMessages
               ? "保持本页打开，等待权限生效并自动切换响应方式"
               : "保持本页打开，等待新机器人的长连接就绪")),
@@ -336,7 +336,7 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
             ? h(Button, { onClick: onRefresh, disabled: busy }, "换一个二维码")
             : null,
           h(Button, { onClick: onCancel, disabled: busy }, repairing
-            ? "取消修复"
+            ? "取消补全"
             : grantingGroupMessages ? "取消授权" : "取消添加")),
       ),
     ),
@@ -354,16 +354,16 @@ function ProvisionProgress({ phase, provision, onCancel, busy }) {
     h("div", { className: "dim-spinner", "aria-hidden": "true" }),
     h("h3", null, connecting
       ? repairing
-        ? "已确认，正在完成卡片按钮修复"
+        ? "已确认，正在完成权限与回调配置"
         : grantingGroupMessages
           ? "已确认，正在启用全部消息模式"
           : "已确认，正在连接新机器人"
       : repairing
-        ? "正在准备修复二维码"
+        ? "正在准备权限补全二维码"
         : grantingGroupMessages ? "正在准备权限授权二维码" : "正在准备授权二维码"),
     h("p", null, connecting
       ? repairing
-        ? "配置已提交，正在验证卡片按钮回调并重连此机器人；此阶段无法取消，其他机器人不会中断。"
+        ? "配置已提交，正在保存权限、验证卡片回调并重连此机器人；此阶段无法取消，其他机器人不会中断。"
         : grantingGroupMessages
           ? "权限配置已提交，正在保存设置并重连此机器人；此阶段无法取消，其他机器人不会中断。"
           : "正在安全保存凭据并检查新机器人的消息通道，其他机器人不会中断。"
@@ -375,7 +375,7 @@ function ProvisionProgress({ phase, provision, onCancel, busy }) {
     connecting && onCancel
       ? h("div", { className: "bxf-actions dim-viewActions", style: { justifyContent: "center" } },
           h(Button, { onClick: onCancel, disabled: busy }, repairing
-            ? "取消修复"
+            ? "取消补全"
             : grantingGroupMessages ? "取消授权" : "取消添加"))
       : null,
   );
@@ -388,7 +388,7 @@ function ProvisionError({ error, provision, onRetry, onCancel, busy }) {
     h("div", { className: "bxf-inlineError dim-inlineError", role: "alert" },
       h("div", null,
         h("h3", null, repairing
-          ? "卡片按钮没有修复完成"
+          ? "权限与回调没有补全完成"
           : grantingGroupMessages ? "群消息权限没有开通完成" : "新机器人没有添加完成"),
         h("p", null, error.message),
         error.code ? h("span", { className: "bxf-errorCode" }, error.code) : null,
@@ -564,6 +564,7 @@ export function BotCard({
   removeButtonRef,
 }) {
   const { bot, health, state, connected } = connection;
+  const repairTooltipId = React.useId();
   const stateForDisplay = busy === "reconnect"
     ? "connecting"
     : state;
@@ -637,13 +638,22 @@ export function BotCard({
               disabled: Boolean(busy), "aria-busy": busy === "reconnect" ? "true" : undefined,
               "aria-label": `${connected ? "检查连接" : "重试连接"}${bot.name}`,
             }, busy === "reconnect" ? (connected ? "检查中…" : "正在连接…") : connected ? "检查连接" : "重试连接"),
-            h(Button, {
-              className: "bxf-repairButton dim-cardAction",
-              onClick: onRepairCallback,
-              disabled: Boolean(busy) || repairDisabled,
-              "aria-busy": busy === "callback-repair" ? "true" : undefined,
-              "aria-label": `修复${bot.name}的卡片按钮`,
-            }, busy === "callback-repair" ? "等待扫码…" : "修复卡片按钮"),
+            h("span", { className: "bxf-repairAction" },
+              h(Button, {
+                className: "bxf-repairButton dim-cardAction",
+                onClick: onRepairCallback,
+                disabled: Boolean(busy) || repairDisabled,
+                "aria-busy": busy === "callback-repair" ? "true" : undefined,
+                "aria-label": `为${bot.name}补全权限与回调`,
+                "aria-describedby": repairTooltipId,
+              }, busy === "callback-repair" ? "等待扫码…" : "补全权限"),
+              h("span", {
+                id: repairTooltipId,
+                className: "bxf-repairTooltip",
+                role: "tooltip",
+              },
+                h("strong", null, "补全范围"),
+                h("span", null, "最多增量添加卡片回调 card.action.trigger、读取消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”），以及上传机器人图片或文件所需的 im:resource；确认页只显示当前缺少项，不会创建新应用。"))),
             h(Button, {
               className: "dim-cardAction", kind: "danger", onClick: onRequestRemove,
               disabled: Boolean(busy), ref: removeButtonRef,
@@ -933,7 +943,7 @@ export function FeishuSettingsTab({ rpcCall }) {
         && (provision.operation !== operation || provision.botId !== botId)) {
         throw new Error(grantingGroupMessages
           ? "飞书服务返回了不匹配的群消息权限二维码"
-          : "飞书服务返回了不匹配的卡片修复二维码");
+          : "飞书服务返回了不匹配的权限补全二维码");
       }
       const timestamp = Date.now();
       setNow(timestamp);
@@ -948,7 +958,7 @@ export function FeishuSettingsTab({ rpcCall }) {
         },
       }));
       announce(repairing
-        ? `${botName ?? "机器人"}的修复二维码已生成，请使用飞书扫码。`
+        ? `${botName ?? "机器人"}的权限补全二维码已生成，请使用飞书扫码。`
         : grantingGroupMessages
           ? `${botName ?? "机器人"}的群消息权限二维码已生成，请使用飞书确认。`
           : "授权二维码已生成，请使用飞书扫码。");
@@ -1032,7 +1042,7 @@ export function FeishuSettingsTab({ rpcCall }) {
             : current);
           announce(grantingGroupMessages
             ? "权限配置已提交，正在启用全部消息模式并重连此机器人；此阶段无法取消，其他机器人不会中断。"
-            : "配置已提交，正在验证卡片按钮回调并重连此机器人；此阶段无法取消，其他机器人不会中断。");
+            : "配置已提交，正在保存权限、验证卡片回调并重连此机器人；此阶段无法取消，其他机器人不会中断。");
           return;
         }
         if (result.status === "connected") {
@@ -1040,7 +1050,7 @@ export function FeishuSettingsTab({ rpcCall }) {
           setModel((current) => ({ ...current, provisioning: null }));
           announce(grantingGroupMessages
             ? `${targetBotName}已开通群消息权限，并启用“响应所有群消息”。`
-            : `${targetBotName}的卡片按钮已修复。`);
+            : `${targetBotName}的权限与回调已补全。`);
           if (activeProvision.botId) setFocusBotId(activeProvision.botId);
           await loadStatus({ silent: true, restoreProvisioning: false });
           return;
@@ -1048,7 +1058,7 @@ export function FeishuSettingsTab({ rpcCall }) {
       }
       setModel((current) => ({ ...current, provisioning: null }));
       announce(repairing
-        ? "已取消卡片按钮修复。"
+        ? "已取消补全权限与回调。"
         : grantingGroupMessages ? "已取消群消息权限授权。" : "已取消添加机器人。");
       await loadStatus({ silent: true, restoreProvisioning: false });
       scheduleAnimationFrame(() => {
@@ -1117,7 +1127,7 @@ export function FeishuSettingsTab({ rpcCall }) {
           const targetBot = snapshot?.bots.find((bot) => bot.botId === result.botId);
           if (!snapshot) {
             throw new Error(isCallbackRepair(provision)
-              ? "卡片按钮已更新，但暂时无法确认机器人连接状态"
+              ? "权限与回调已更新，但暂时无法确认机器人连接状态"
               : isGroupMessagePermission(provision)
                 ? "群消息权限已更新，但暂时无法确认机器人连接状态"
                 : "机器人已经创建，但暂时无法确认连接状态");
@@ -1130,7 +1140,7 @@ export function FeishuSettingsTab({ rpcCall }) {
           }
           setModel((current) => ({ ...current, provisioning: null }));
           announce(isCallbackRepair(provision)
-            ? `${targetBot.bot.name}的卡片按钮已修复。`
+            ? `${targetBot.bot.name}的权限与回调已补全。`
             : isGroupMessagePermission(provision)
               ? `${targetBot.bot.name}已开通群消息权限，并启用“响应所有群消息”。`
               : targetBot
@@ -1142,7 +1152,7 @@ export function FeishuSettingsTab({ rpcCall }) {
         if (result.status === "failed") {
           const error = new Error(result.message
             ?? (isCallbackRepair(provision)
-              ? "飞书卡片按钮修复失败"
+              ? "飞书权限与回调补全失败"
               : isGroupMessagePermission(provision)
                 ? "飞书群消息权限开通失败"
                 : "飞书应用创建失败"));

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

@@ -450,10 +450,35 @@ const CSS = String.raw`
 .bxf-connectedFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; margin-top: 20px; padding-top: 16px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
 .bxf-healthSummary { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 18px; }
 .bxf-healthSummary[data-error="true"] { color: var(--bxf-error); }
-.bxf-botActions { flex: none; width: 100%; flex-wrap: wrap; gap: 8px; margin-top: 0; justify-content: flex-end; }
+.bxf-botActions { position: relative; flex: none; width: 100%; flex-wrap: wrap; gap: 8px; margin-top: 0; justify-content: flex-end; }
 .bxf-botActions .bxf-button { flex: none; white-space: nowrap; }
 .bxf-botActions .bxf-repairButton { color: var(--bxf-accent); border-color: color-mix(in srgb, var(--bxf-accent) 35%, var(--dsw-alias-border-l2, #dee0e3)); }
 .bxf-botActions .bxf-repairButton:hover:not(:disabled) { background: color-mix(in srgb, var(--bxf-accent) 7%, transparent); }
+.bxf-repairAction { display: inline-flex; }
+.bxf-repairTooltip {
+  position: absolute;
+  right: 0;
+  bottom: calc(100% + 8px);
+  z-index: 40;
+  width: min(330px, 100%);
+  display: grid;
+  gap: 3px;
+  padding: 9px 10px;
+  border: 1px solid var(--dsw-alias-border-l2, #dfe1e5);
+  border-radius: 8px;
+  color: var(--dsw-alias-label-primary, #1f2329);
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  box-shadow: 0 10px 28px rgb(31 35 41 / 16%);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(3px);
+  pointer-events: none;
+  transition: opacity .15s ease, transform .15s ease, visibility .15s ease;
+}
+.bxf-repairTooltip strong { font-size: 12px; line-height: 17px; font-weight: 650; }
+.bxf-repairTooltip > span { color: var(--dsw-alias-label-secondary, #646a73); font-size: 11px; line-height: 17px; font-weight: 400; overflow-wrap: anywhere; }
+.bxf-repairAction:hover .bxf-repairTooltip,
+.bxf-repairAction:focus-within .bxf-repairTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 
 .bxf-confirm {
   border-top: 1px solid var(--dsw-alias-border-l2, #dee0e3);

package/plugin-src/client/i18n.js

@@ -231,7 +231,7 @@ const EN = Object.freeze({
   '保持本页打开，等待新机器人的长连接就绪': 'Keep this page open until the bot connection is ready',
   '在飞书中打开': 'Open in Feishu',
   '取消添加': 'Cancel',
-  '使用飞书扫码修复卡片按钮': 'Scan with Feishu to repair card buttons',
+  '使用飞书扫码补全权限': 'Scan with Feishu to complete permissions',
   '使用飞书确认群消息权限': 'Confirm group-message permission with Feishu',
   '扫码会更新现有飞书应用，只增量开通“获取群组中所有消息”权限；不会创建新应用。确认后会自动启用“响应所有群消息”，其他机器人不受影响。': 'Scanning updates the existing Feishu app with only the “Read all messages in associated group chat” scope. It does not create a new app. After confirmation, “Respond to all group messages” is enabled automatically; other bots are unaffected.',
   '核对现有应用，并确认“获取群组中所有消息”权限': 'Review the existing app and confirm the “Read all messages in associated group chat” permission',
@@ -242,18 +242,20 @@ const EN = Object.freeze({
   '权限配置已提交，正在启用全部消息模式并重连此机器人；此阶段无法取消，其他机器人不会中断。': 'The permission update was submitted. Enabling all-message mode and reconnecting this bot. This stage cannot be cancelled; other bots will not be interrupted.',
   '正在为现有飞书应用申请群消息权限二维码，请稍候。': 'Requesting a group-message permission QR code for the existing Feishu app…',
   '群消息权限没有开通完成': 'Group-message permission was not granted',
-  '扫码会更新现有飞书应用，只增量补充卡片按钮回调；不会创建新应用。确认后此机器人会短暂重连，其他机器人不受影响。': 'Scanning updates the existing Feishu app with only the card-button callback. It does not create a new app. This bot reconnects briefly after confirmation; other bots are not affected.',
-  '核对现有应用名称，并确认只新增卡片回调': 'Review the existing app name and confirm that only the card callback is added',
-  '保持本页打开，等待卡片按钮修复完成': 'Keep this page open until card-button repair finishes',
-  '取消修复': 'Cancel repair',
-  '已确认，正在完成卡片按钮修复': 'Confirmed. Finishing card-button repair',
-  '正在准备修复二维码': 'Preparing the repair QR code',
-  '配置已提交，正在验证卡片按钮回调并重连此机器人；此阶段无法取消，其他机器人不会中断。': 'The update was submitted. Verifying the card callback and reconnecting this bot. This stage cannot be cancelled; other bots will not be interrupted.',
+  '扫码会更新现有飞书应用，最多增量补充卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”），以及上传机器人图片或文件所需的 im:resource；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。': 'Scanning updates the existing Feishu app with up to three missing items: the card-button callback, im:message:readonly for reading images or files in user messages (shown by Feishu as “Read direct and group messages”), and im:resource for uploading images or files sent by the bot. It does not create a new app. The confirmation page shows only missing items; this bot reconnects briefly afterward, while other bots are unaffected.',
+  '核对现有应用名称，并确认只新增当前缺少的上述配置': 'Review the existing app name and confirm that only the missing items described above are added',
+  '保持本页打开，等待权限与回调补全完成': 'Keep this page open until permissions and the callback are complete',
+  '取消补全': 'Cancel setup',
+  '已确认，正在完成权限与回调配置': 'Confirmed. Completing permissions and callback setup',
+  '正在准备权限补全二维码': 'Preparing the permission-completion QR code',
+  '配置已提交，正在保存权限、验证卡片回调并重连此机器人；此阶段无法取消，其他机器人不会中断。': 'The update was submitted. Saving permissions, verifying the card callback, and reconnecting this bot. This stage cannot be cancelled; other bots will not be interrupted.',
   '正在为现有飞书应用申请一次性更新二维码，请稍候。': 'Requesting a one-time update QR code for the existing Feishu app…',
-  '卡片按钮没有修复完成': 'Card-button repair did not finish',
-  '修复卡片按钮': 'Repair card buttons',
+  '权限与回调没有补全完成': 'Permissions and callback setup did not finish',
+  '补全权限': 'Complete permissions',
+  '补全范围': 'Completion scope',
+  '最多增量添加卡片回调 card.action.trigger、读取消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”），以及上传机器人图片或文件所需的 im:resource；确认页只显示当前缺少项，不会创建新应用。': 'Adds up to the missing card callback card.action.trigger, im:message:readonly for reading images or files in messages (shown by Feishu as “Read direct and group messages”), and im:resource for uploading images or files sent by the bot. The confirmation page shows only missing items; no new app is created.',
   '等待扫码…': 'Waiting for scan…',
-  '飞书服务返回了不匹配的卡片修复二维码': 'Feishu returned a repair QR code for a different bot',
+  '飞书服务返回了不匹配的权限补全二维码': 'Feishu returned a permission-completion QR code for a different bot',
   '飞书服务返回了不匹配的群消息权限二维码': 'Feishu returned a group-message permission QR code for a different bot',
   '飞书服务返回的修复信息缺少 botId': 'Feishu repair status is missing the bot ID',
   '飞书服务返回的应用更新信息缺少 botId': 'Feishu app-update status is missing the bot ID',
@@ -261,16 +263,16 @@ const EN = Object.freeze({
   '此机器人': 'this bot',
   '用于为${botName}开通群消息权限的一次性授权二维码': 'One-time QR code for granting group-message permission to ${botName}',
   '正在为「${botName}」开通群消息权限': 'Granting group-message permission to “${botName}”',
-  '${botName ?? "机器人"}的修复二维码已生成，请使用飞书扫码。': 'Repair QR code generated for ${botName ?? "bot"}. Scan it with Feishu.',
+  '${botName ?? "机器人"}的权限补全二维码已生成，请使用飞书扫码。': 'Permission-completion QR code generated for ${botName ?? "bot"}. Scan it with Feishu.',
   '${botName ?? "机器人"}的群消息权限二维码已生成，请使用飞书确认。': 'Group-message permission QR code generated for ${botName ?? "bot"}. Confirm it with Feishu.',
   '${targetBotName}已开通群消息权限，并启用“响应所有群消息”。': '${targetBotName} now has group-message permission and “Respond to all group messages” is enabled.',
   '${targetBot.bot.name}已开通群消息权限，并启用“响应所有群消息”。': '${targetBot.bot.name} now has group-message permission and “Respond to all group messages” is enabled.',
   '${targetBot.bot.name}已连接，可以在飞书中开始聊天。': '${targetBot.bot.name} is connected and ready to chat in Feishu.',
-  '已取消卡片按钮修复。': 'Card-button repair was cancelled.',
+  '已取消补全权限与回调。': 'Completing permissions and the callback was cancelled.',
   '已取消群消息权限授权。': 'Group-message permission authorization was cancelled.',
-  '卡片按钮已更新，但暂时无法确认机器人连接状态': 'The card callback was updated, but the bot connection could not be confirmed yet',
+  '权限与回调已更新，但暂时无法确认机器人连接状态': 'Permissions and the callback were updated, but the bot connection could not be confirmed yet',
   '群消息权限已更新，但暂时无法确认机器人连接状态': 'The group-message permission was updated, but the bot connection could not be confirmed yet',
-  '飞书卡片按钮修复失败': 'Could not repair the Feishu card buttons',
+  '飞书权限与回调补全失败': 'Could not complete Feishu permissions and callback setup',
   '飞书群消息权限开通失败': 'Could not grant the Feishu group-message permission',
   '请先完成当前飞书授权操作，再开通群消息权限。': 'Finish the current Feishu authorization before granting group-message permission.',
   '已确认，正在连接新机器人': 'Confirmed. Connecting the new bot',
@@ -598,22 +600,22 @@ function translateDynamic(text) {
   if (match) return `Remove ${match[1]} from DeepSeek Harness`;
   match = /^(.+)的飞书授权流程$/.exec(text);
   if (match) return `Feishu authorization flow for ${match[1]}`;
-  match = /^用于修复(.+)卡片按钮的一次性授权二维码$/.exec(text);
-  if (match) return `One-time QR code for repairing card buttons for ${match[1]}`;
+  match = /^用于为(.+)补全权限与回调的一次性授权二维码$/.exec(text);
+  if (match) return `One-time QR code for completing permissions and the callback for ${match[1]}`;
   match = /^用于为(.+)开通群消息权限的一次性授权二维码$/.exec(text);
   if (match) return `One-time QR code for granting group-message permission to ${match[1]}`;
-  match = /^正在修复「(.+)」$/.exec(text);
-  if (match) return `Repairing “${match[1]}”`;
+  match = /^正在为「(.+)」补全权限与回调$/.exec(text);
+  if (match) return `Completing permissions and the callback for “${match[1]}”`;
   match = /^正在为「(.+)」开通群消息权限$/.exec(text);
   if (match) return `Granting group-message permission to “${match[1]}”`;
-  match = /^修复(.+)的卡片按钮$/.exec(text);
-  if (match) return `Repair card buttons for ${match[1]}`;
-  match = /^(.+)的修复二维码已生成，请使用飞书扫码。$/.exec(text);
-  if (match) return `Repair QR code generated for ${match[1]}. Scan it with Feishu.`;
+  match = /^为(.+)补全权限与回调$/.exec(text);
+  if (match) return `Complete permissions and the callback for ${match[1]}`;
+  match = /^(.+)的权限补全二维码已生成，请使用飞书扫码。$/.exec(text);
+  if (match) return `Permission-completion QR code generated for ${match[1]}. Scan it with Feishu.`;
   match = /^(.+)的群消息权限二维码已生成，请使用飞书确认。$/.exec(text);
   if (match) return `Group-message permission QR code generated for ${match[1]}. Confirm it with Feishu.`;
-  match = /^(.+)的卡片按钮已修复。$/.exec(text);
-  if (match) return `Card buttons repaired for ${match[1]}.`;
+  match = /^(.+)的权限与回调已补全。$/.exec(text);
+  if (match) return `Permissions and the callback completed for ${match[1]}.`;
   match = /^(.+)已开通群消息权限，并启用“响应所有群消息”。$/.exec(text);
   if (match) return `${match[1]} now has group-message permission and “Respond to all group messages” is enabled.`;
   match = /^(检查连接|重试连接)(.+)$/.exec(text);

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

@@ -77,6 +77,7 @@ const HELP_TEXT_LINES = [
   '/send  提交当前批次',
   '/cancel  取消当前批次',
   '/status  检查连接状态',
+  '/version  查看插件版本',
   '/help  显示本帮助',
 ];
 

package/src/channels/feishu/bridge.mjs

@@ -106,9 +106,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 +151,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':
@@ -410,7 +411,6 @@ export class FeishuHarnessBridge {
   #botOpenId;
   #groupResponseMode;
   #repair;
-  #repairOwnerOpenIds;
   #repairAttempt = null;
   #repairMonitorVersion = 0;
   #repairPollIntervalMs;
@@ -443,7 +443,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 +479,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;
@@ -1075,13 +1070,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 +1100,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 +1152,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 +1247,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 +1325,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,

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

@@ -869,22 +869,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 +992,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 } : {}),
       });