@xmanrui/dsh-im 2.2.1 → 2.4.0

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

@@ -20,6 +20,12 @@ import {
   runPresetCommand,
 } from '../shared/preset-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
+import {
+  BatchInputManager,
+  batchInputBusyMessage,
+  batchInputGroupUnsupportedMessage,
+  isBatchInputCommand,
+} from '../shared/batch-input.mjs';
 import {
   fetchImageBuffer,
   hasInboundImages,
@@ -80,7 +86,11 @@ function helpText() {
     t('/preset --default  跟随 Host 默认'),
     t('/stop  停止当前任务'),
     t('/steer 补充指令  纠偏当前任务'),
+    t('/batch  开始批量输入（仅私聊，最多 10 条文字）'),
+    t('/send  提交当前批次'),
+    t('/cancel  取消当前批次'),
     t('/status  检查连接状态'),
+    t('/version  查看插件版本'),
     t('/help  显示本帮助'),
   ].join('\n');
 }
@@ -352,6 +362,7 @@ export class QqHarnessBridge {
   #approvalTasks = new Set();
   #commandTasks = new Set();
   #approvals;
+  #batchInputs = new BatchInputManager();
 
   constructor({
     bot,
@@ -407,14 +418,47 @@ export class QqHarnessBridge {
     }
     const pending = this.#pendingInteractions.get(key);
     const commandText = safeText(message);
+    const allowed = this.#ownerUserOpenid === '*' || sender === this.#ownerUserOpenid;
+    const addressed = message.kind !== 'group'
+      || message.rawEventType === 'GROUP_AT_MESSAGE_CREATE';
+    const batchCommand = isBatchInputCommand(commandText);
+    const batchStatus = this.#batchInputs.status(key);
+    if (batchCommand && allowed && addressed && message.kind === 'group') {
+      return this.#finishBatchResult(
+        message,
+        messageId,
+        { message: batchInputGroupUnsupportedMessage() },
+      );
+    }
+    if (allowed && message.kind === 'c2c'
+      && (batchCommand || batchStatus.phase === 'collecting')) {
+      const exactBatchStart = /^\/batch$/iu.test(commandText);
+      const result = exactBatchStart
+        && batchStatus.phase === 'idle'
+        && (this.#queues.has(key) || pending || this.#approvals.hasPending(key))
+        ? { handled: true, kind: 'busy', message: batchInputBusyMessage() }
+        : this.#batchInputs.handle(key, commandText, {
+            plainText: Boolean(commandText)
+              && !hasQqImageAttachments(message)
+              && !hasQqFileAttachments(message),
+          });
+      if (result.handled) {
+        if (result.kind === 'submit') {
+          return this.#enqueueMessage(
+            { ...message, content: result.prompt, attachments: [] },
+            messageId,
+            key,
+            { batchSubmission: result },
+          );
+        }
+        return this.#finishBatchResult(message, messageId, result);
+      }
+    }
     const commandRunner = hasQqFileAttachments(message) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
           ? runModelCommand
           : (isPresetCommand(commandText) ? runPresetCommand : null));
-    const allowed = this.#ownerUserOpenid === '*' || sender === this.#ownerUserOpenid;
-    const addressed = message.kind !== 'group'
-      || message.rawEventType === 'GROUP_AT_MESSAGE_CREATE';
     if (commandRunner && allowed && addressed) {
       let task;
       task = this.#processFastCommand(
@@ -494,6 +538,7 @@ export class QqHarnessBridge {
   #enqueueMessage(message, messageId, key, {
     releaseMessageId = true,
     alreadyRecorded = false,
+    batchSubmission = null,
   } = {}) {
     const allowed = this.#ownerUserOpenid === '*' || message.senderId === this.#ownerUserOpenid;
     const addressed = message.kind !== 'group'
@@ -507,7 +552,11 @@ export class QqHarnessBridge {
     const previous = this.#queues.get(key) ?? Promise.resolve();
     const current = previous
       .catch(() => undefined)
-      .then(() => this.#process(message, key, { alreadyRecorded, preparedMessage }))
+      .then(() => this.#process(message, key, {
+        alreadyRecorded,
+        preparedMessage,
+        batchSubmission,
+      }))
       .finally(() => {
         if (releaseMessageId) this.#acceptedMessageIds.delete(messageId);
         if (this.#queues.get(key) === current) this.#queues.delete(key);
@@ -553,6 +602,29 @@ export class QqHarnessBridge {
     this.#status.lastError = null;
   }
 
+  #finishBatchResult(message, messageId, result) {
+    let task;
+    task = Promise.resolve().then(async () => {
+      if (this.#state.hasSeen(messageId)) return;
+      await this.#state.markSeen(messageId);
+      this.#status.messagesReceived += 1;
+      this.#status.lastMessageAt = new Date().toISOString();
+      if (result.message) await this.#bot.sendText(message.replyTarget, result.message);
+      this.#status.lastError = null;
+    }).catch(async (error) => {
+      if (this.#signal?.aborted) return;
+      this.#status.lastError = error?.message ?? String(error);
+      this.#logger.error?.('[dsh-im:qq] failed to process a batch input message:', error);
+      await this.#bot.sendText(message.replyTarget, t('消息处理失败，请稍后重试。'))
+        .catch(() => undefined);
+    }).finally(() => {
+      this.#acceptedMessageIds.delete(messageId);
+      this.#commandTasks.delete(task);
+    });
+    this.#commandTasks.add(task);
+    return task;
+  }
+
   async #deliverArtifacts(target, replyTo, artifacts = [], baseReceipt = null) {
     if (artifacts.length === 0) {
       return { receipt: baseReceipt, failureNoticeVisible: false };
@@ -589,7 +661,11 @@ export class QqHarnessBridge {
     };
   }
 
-  async #process(message, key, { alreadyRecorded = false, preparedMessage } = {}) {
+  async #process(message, key, {
+    alreadyRecorded = false,
+    preparedMessage,
+    batchSubmission = null,
+  } = {}) {
     if (this.#signal?.aborted) return;
     const messageId = nonEmptyString(message?.messageId);
     const sender = nonEmptyString(message?.senderId);
@@ -614,6 +690,7 @@ export class QqHarnessBridge {
     const hasImages = hasInboundImages(promptMessage);
     const hasFiles = hasInboundFiles(promptMessage);
     let stream = null;
+    let batchSettled = batchSubmission === null;
     try {
       if (!text && !hasImages && !hasFiles) {
         await this.#bot.sendText(target, t('目前支持文字、图片和文件消息。'));
@@ -710,6 +787,10 @@ export class QqHarnessBridge {
             files: promptMessage.files,
           },
         }));
+        if (batchSubmission) {
+          this.#batchInputs.complete(key, batchSubmission.token);
+          batchSettled = true;
+        }
       } finally {
         await Promise.allSettled([
           this.#cancelPendingInteraction(key),
@@ -771,6 +852,15 @@ export class QqHarnessBridge {
       this.#status.lastError = null;
       return delivery.receipt;
     } catch (error) {
+      let batchFailureMessage = null;
+      if (!batchSettled && batchSubmission) {
+        if (error?.code === 'turn-stopped') {
+          this.#batchInputs.complete(key, batchSubmission.token);
+        } else {
+          batchFailureMessage = this.#batchInputs.fail(key, batchSubmission.token).message ?? null;
+        }
+        batchSettled = true;
+      }
       if (error?.code === 'turn-stopped') {
         try {
           stream?.cancel?.();
@@ -794,11 +884,12 @@ export class QqHarnessBridge {
       this.#status.lastError = error?.message ?? String(error);
       this.#logger.error?.('[dsh-im:qq] failed to process an inbound message:', error);
       try {
+        const errorMessage = inboundFileUserMessage(error)
+          ?? imagePromptUserMessage(error)
+          ?? t('消息处理失败，请稍后重试。');
         await this.#bot.sendText(
           target,
-          inboundFileUserMessage(error)
-            ?? imagePromptUserMessage(error)
-            ?? t('消息处理失败，请稍后重试。'),
+          batchFailureMessage ? `${errorMessage}\n\n${batchFailureMessage}` : errorMessage,
         );
         await this.#state.markSeen(messageId);
       } catch (sendError) {

package/src/channels/shared/batch-input.mjs

@@ -0,0 +1,209 @@
+import { t } from './i18n.mjs';
+
+export const BATCH_INPUT_LIMIT = 10;
+
+const BATCH_COMMAND = /^\/(batch|send|cancel)(?=$|\s)/iu;
+const EXACT_BATCH_COMMAND = /^\/(batch|send|cancel)$/iu;
+
+function commandName(text) {
+  if (typeof text !== 'string') return null;
+  return BATCH_COMMAND.exec(text.trim())?.[1]?.toLowerCase() ?? null;
+}
+
+function result(kind, message, extra = {}) {
+  return { handled: true, kind, ...(message ? { message } : {}), ...extra };
+}
+
+function progressMessage(count) {
+  if (count === BATCH_INPUT_LIMIT) {
+    return t(`当前已处于批量输入模式，已收集 {count}/{limit} 条。
+请发送 /send 提交或 /cancel 取消。`, { count, limit: BATCH_INPUT_LIMIT });
+  }
+  return t(`当前已处于批量输入模式，已收集 {count}/{limit} 条。
+完成后发送 /send，取消请发送 /cancel。`, { count, limit: BATCH_INPUT_LIMIT });
+}
+
+function submissionPrompt(messages) {
+  const sections = messages.map((message, index) => (
+    `${t('[消息 {index}]', { index: index + 1 })}\n${message}`
+  ));
+  return [
+    t('以下是用户通过批量输入模式发送的多条内容，请按顺序作为同一次输入统一处理。'),
+    ...sections,
+  ].join('\n\n');
+}
+
+export function isBatchInputCommand(text) {
+  return commandName(text) !== null;
+}
+
+export function batchInputGroupUnsupportedMessage() {
+  return t('批量输入模式仅支持私聊，请在与机器人的私聊中使用。');
+}
+
+export function batchInputBusyMessage() {
+  return t(`当前聊天有正在运行的任务、待回答问题或待审批请求。
+请先完成当前交互或发送 /stop，再使用 /batch。`);
+}
+
+export class BatchInputManager {
+  #batches = new Map();
+
+  status(key) {
+    const batch = this.#batches.get(key);
+    if (!batch) {
+      return Object.freeze({ phase: 'idle', count: 0, limit: BATCH_INPUT_LIMIT, full: false });
+    }
+    return Object.freeze({
+      phase: batch.phase,
+      count: batch.messages.length,
+      limit: BATCH_INPUT_LIMIT,
+      full: batch.messages.length === BATCH_INPUT_LIMIT,
+    });
+  }
+
+  handle(key, text, { plainText = true } = {}) {
+    const batch = this.#batches.get(key);
+    const name = commandName(text);
+    const exact = typeof text === 'string' ? EXACT_BATCH_COMMAND.exec(text.trim()) : null;
+
+    if (name && !exact) {
+      return result('invalid-command', t('用法：/{command}（不带参数）', { command: name }));
+    }
+
+    if (!batch) {
+      if (!name) return { handled: false };
+      if (!plainText) {
+        return result('unsupported-content', t('批量输入命令仅支持纯文字，请移除图片或文件后重试。'));
+      }
+      if (name === 'send') {
+        return result('no-batch', t('当前没有待提交的批量内容，请先发送 /batch。'));
+      }
+      if (name === 'cancel') {
+        return result('no-batch', t('当前没有正在进行的批量输入。'));
+      }
+      this.#batches.set(key, { phase: 'collecting', messages: [], token: null });
+      return result('started', t(`已进入批量输入模式，最多可发送 {limit} 条文字。
+完成后发送 /send，取消请发送 /cancel。`, { limit: BATCH_INPUT_LIMIT }), {
+        count: 0,
+        limit: BATCH_INPUT_LIMIT,
+      });
+    }
+
+    if (!plainText && (batch.phase === 'collecting' || name)) {
+      return result('unsupported-content', t(`批量输入模式目前仅支持文字，这条消息未收录。
+请继续发送文字，或使用 /send、/cancel。`), {
+        count: batch.messages.length,
+        limit: BATCH_INPUT_LIMIT,
+      });
+    }
+
+    if (batch.phase === 'submitting') {
+      if (name === 'send') {
+        return result('submitting', t('当前批次正在提交，请勿重复发送 /send。'));
+      }
+      if (name === 'cancel') {
+        return result('submitting', t(`批量内容已经提交，无法取消。
+如需停止当前任务，请发送 /stop。`));
+      }
+      if (name === 'batch') {
+        return result('submitting', t('当前批次正在提交，请等待处理完成后再开启新批次。'));
+      }
+      return { handled: false };
+    }
+
+    if (name === 'batch') {
+      return result('status', progressMessage(batch.messages.length), {
+        count: batch.messages.length,
+        limit: BATCH_INPUT_LIMIT,
+      });
+    }
+
+    if (name === 'cancel') {
+      const count = batch.messages.length;
+      this.#batches.delete(key);
+      return result('cancelled', count === 0
+        ? t('已取消批量输入。')
+        : t('已取消批量输入，共丢弃 {count} 条消息。', { count }), { count });
+    }
+
+    if (name === 'send') {
+      if (batch.messages.length === 0) {
+        return result('empty', t('当前批次还没有内容，请先发送文字，或使用 /cancel 取消。'), {
+          count: 0,
+        });
+      }
+      const messages = Object.freeze([...batch.messages]);
+      const token = Object.freeze({});
+      batch.phase = 'submitting';
+      batch.token = token;
+      return result('submit', null, {
+        token,
+        messages,
+        prompt: submissionPrompt(messages),
+        count: messages.length,
+      });
+    }
+
+    if (typeof text !== 'string') {
+      return result('unsupported-content', t(`批量输入模式目前仅支持文字，这条消息未收录。
+请继续发送文字，或使用 /send、/cancel。`), {
+        count: batch.messages.length,
+        limit: BATCH_INPUT_LIMIT,
+      });
+    }
+
+    if (text.trim().startsWith('/')) {
+      return result('blocked-command', t('当前正在批量输入，请先发送 /send 提交或 /cancel 取消。'), {
+        count: batch.messages.length,
+        limit: BATCH_INPUT_LIMIT,
+      });
+    }
+
+    if (batch.messages.length === BATCH_INPUT_LIMIT) {
+      return result('full', t(`当前批次已满，这条消息未收录。
+请先发送 /send 提交或 /cancel 取消，然后重新发送这条消息。`), {
+        count: BATCH_INPUT_LIMIT,
+        limit: BATCH_INPUT_LIMIT,
+      });
+    }
+
+    batch.messages.push(text);
+    const count = batch.messages.length;
+    return result('collected', count === BATCH_INPUT_LIMIT
+      ? t('已收集 {count}/{limit} 条，当前批次已满，请发送 /send 提交或 /cancel 取消。', {
+        count,
+        limit: BATCH_INPUT_LIMIT,
+      })
+      : null, {
+      count,
+      limit: BATCH_INPUT_LIMIT,
+    });
+  }
+
+  complete(key, token) {
+    const batch = this.#batches.get(key);
+    if (!batch || batch.phase !== 'submitting' || batch.token !== token) {
+      return Object.freeze({ completed: false });
+    }
+    const count = batch.messages.length;
+    this.#batches.delete(key);
+    return Object.freeze({ completed: true, count });
+  }
+
+  fail(key, token) {
+    const batch = this.#batches.get(key);
+    if (!batch || batch.phase !== 'submitting' || batch.token !== token) {
+      return Object.freeze({ retained: false });
+    }
+    batch.phase = 'collecting';
+    batch.token = null;
+    const count = batch.messages.length;
+    return Object.freeze({
+      retained: true,
+      count,
+      message: t(`批量内容提交失败，已保留 {count} 条消息。
+请再次发送 /send 重试或 /cancel 取消。`, { count }),
+    });
+  }
+}

package/src/channels/shared/control-command.mjs

@@ -1,8 +1,11 @@
 import { t } from './i18n.mjs';
+import manifest from '../../../package.json' with { type: 'json' };
 
-const CONTROL_COMMAND = /^\/(?:stop|steer)(?=$|\s)/iu;
+const CONTROL_COMMAND = /^\/(?:stop|steer|version)(?=$|\s)/iu;
 const STOP_COMMAND = /^\/stop(?=$|\s)/iu;
+const VERSION_COMMAND = /^\/version(?=$|\s)/iu;
 const STOP_USAGE = '用法：/stop（不带参数）';
+const VERSION_USAGE = '用法：/version（不带参数）';
 const STEER_USAGE = '用法：/steer <补充指令>';
 const TEXT_ONLY = '控制命令仅支持纯文字，请移除图片后重试。';
 
@@ -41,9 +44,16 @@ export async function runControlCommand(text, harness, state, key, {
   if (!isControlCommand(text)) return null;
   const command = text.trim();
   const stop = STOP_COMMAND.test(command);
+  const version = VERSION_COMMAND.test(command);
 
   if (hasImages) return commandResult(t(TEXT_ONLY));
 
+  if (version) {
+    return /^\/version$/iu.test(command)
+      ? commandResult(`dsh-im v${manifest.version}`)
+      : commandResult(t(VERSION_USAGE));
+  }
+
   if (stop) {
     if (!/^\/stop$/iu.test(command)) return commandResult(t(STOP_USAGE));
     const session = boundSession(harness, state, key);

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

@@ -3,7 +3,7 @@ export default {
   // feishu/bridge.mjs — welcome / help
   '北汇星河 AIOS 已连接 DeepSeek Harness。':
     'BeiHui XingHe AIOS is connected to DeepSeek Harness.',
-  '/repair  修复卡片按钮回调': '/repair  Repair the card-button callback',
+  '/repair  补全飞书权限与卡片回调': '/repair  Complete Feishu permissions and the card callback',
   '/m（或 /menu）  打开交互卡片菜单': '/m (or /menu)  Open the interactive card menu',
   '/watch [Session ID 或序号]  关注会话，任务完成自动推送':
     '/watch [Session ID or index]  Watch a session; completion is pushed automatically',
@@ -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 并完成必要审批后重试。':
-    'The result file "{name}" was generated, but the bot lacks Feishu file-upload permission. Add the im:resource scope to the app, complete the required approval, and try again.',
+  '结果文件「{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}」超过飞书 30 MB 上限，未发送。':
     'The result file "{name}" exceeds the Feishu 30 MB limit and was not sent.',
   '结果文件「{name}」为空，飞书不允许发送空文件。':
@@ -41,20 +41,20 @@ export default {
   // feishu/bridge.mjs — repair flow
   '为避免授权链接暴露，请私聊机器人发送 /repair。':
     'To keep the authorization link private, send /repair to the bot in a direct message.',
-  '当前机器人没有可验证的接入者身份，不能从聊天发起修复；请先在插件页设置管理员。':
-    'This bot has no verifiable owner identity, so repair cannot be started from chat. Set an administrator on the plugin page first.',
-  '此操作只能由机器人接入者在私聊中发起，未进行任何修改。':
-    'This action can only be started by the bot owner in a direct message. Nothing was changed.',
+  '无法识别当前发送者，未发起修复。':
+    'The current sender could not be identified, so repair was not started.',
   '当前 Host 版本暂不支持聊天内修复，请先更新插件。':
     'The current Host version does not support in-chat repair. Update the plugin first.',
   '用法：/repair、/repair qr、/repair status、/repair cancel 或 /repair verify':
     'Usage: /repair, /repair qr, /repair status, /repair cancel, or /repair verify',
   '当前 Runtime 没有可恢复的修复任务记录（机器人可能刚完成密钥更新并重启）。本命令不会启动新的授权；请查看机器人发送的验证结果，确认上一次任务已结束后再发送 /repair。':
     'The current Runtime has no recoverable repair attempt (the bot may have just rotated its secret and restarted). This command starts no new authorization. Check the verification result the bot sent, then send /repair after the previous attempt has finished.',
-  '另一位管理员正在修复该机器人，本次不会显示其授权信息。':
-    'Another administrator is repairing this bot; its authorization info will not be shown this time.',
+  '另一位用户正在修复该机器人，本次不会显示其授权信息。':
+    'Another user is repairing this bot; its authorization info will not be shown this time.',
   '暂时无法取消修复任务，请稍后重试。':
     'Could not cancel the repair task right now. Please try again later.',
+  '暂时无法取消旧修复任务，未生成新链接；请稍后重试。':
+    'Could not cancel the previous repair attempt, so no new link was generated. Please try again later.',
   '暂时无法查询修复状态，请稍后重试。':
     'Could not check the repair status right now. Please try again later.',
   '修复流程暂时失败，现有机器人连接不受影响；请稍后发送 /repair 重试。':
@@ -69,10 +69,11 @@ export default {
     'The repair status query was interrupted; the existing bot connection is unaffected. Send /repair status to retry.',
   '链接为短期有效': 'The link is valid for a short time.',
   '链接约 {minutes} 分钟后过期': 'The link expires in about {minutes} minutes',
-  '已有一个修复任务在等待授权。': 'A repair task is already waiting for authorization.',
-  '🔧 准备修复卡片按钮。': '🔧 Preparing to repair the card buttons.',
-  '本次只会增量添加 card.action.trigger。请核对确认页只显示这一项；若出现其他权限或事件，请取消。':
-    'Only card.action.trigger will be added. Check that the confirmation page shows only this item; cancel if any other permission or event appears.',
+  '旧授权链接已作废，已生成新的修复链接。':
+    'The previous authorization link was invalidated and a new repair link was generated.',
+  '🔧 准备补全权限与回调。': '🔧 Preparing to complete permissions and the callback.',
+  '本次最多增量添加三项：卡片回调 card.action.trigger；飞书显示为“获取单聊、群组消息”的租户权限 im:message:readonly（用于读取用户消息中的图片或文件）；以及 im:resource（用于上传机器人发送的图片或文件）。确认页只会显示当前缺少的项；若出现上述范围之外的配置，请取消。':
+    'This may incrementally add up to three items: the card callback card.action.trigger; the tenant scope im:message:readonly, shown by Feishu as “Read direct and group messages” and used to read images or files in user messages; and im:resource, used to upload images or files sent by the bot. The confirmation page shows only items the app is currently missing; cancel if anything outside this scope appears.',
   '当前设备直接打开：': 'Open directly on this device:',
   '若要用另一台设备扫码，发送 /repair qr。{expiry}。':
     'To scan with another device, send /repair qr. {expiry}.',
@@ -199,8 +200,8 @@ export default {
   '切换归档显示': 'Toggle archived sessions',
   '📊 状态': '📊 Status',
   '📖 帮助': '📖 Help',
-  '**数字兜底**\n**1**工作区列表 · **2**新会话 · **3**会话列表 · **4**状态\n**5**🔧修复 · **6**帮助':
-    '**Number fallback**\n**1** Workspace list · **2** New session · **3** Session list · **4** Status\n**5** 🔧 Repair · **6** Help',
+  '**数字兜底**\n**1**工作区列表 · **2**新会话 · **3**会话列表 · **4**状态\n**5**🔧补全权限 · **6**帮助':
+    '**Number fallback**\n**1** Workspace list · **2** New session · **3** Session list · **4** Status\n**5** 🔧 Complete permissions · **6** Help',
   '跟随 Host 默认{default}': 'Follow Host default{default}',
   '**当前**：{value}': '**Current**: {value}',
   '**Host 默认**：{value}': '**Host default**: {value}',
@@ -228,22 +229,24 @@ export default {
   '/new  开启全新会话': '/new  Start a new session',
   '📊 状态 / 压缩': '📊 Status / compact',
   '/status  连接状态': '/status  Connection status',
+  '`/version` — 查看插件版本': '`/version` — show the plugin version',
   '/compact  压缩当前会话上下文': '/compact  Compact the current session context',
   '/archived on/off  会话列表显示/隐藏归档': '/archived on/off  Show/hide archived sessions',
   '👁 关注': '👁 Watches',
   '/watch ID  关注会话（完成后推送）': '/watch ID  Watch a session (push on completion)',
   '/watchlist  关注列表': '/watchlist  List watched sessions',
   '/unwatch ID  取消关注': '/unwatch ID  Stop watching a session',
+  '📦 批量输入（仅私聊）': '📦 Batch input (direct messages only)',
   '🤖 预设 / 模型': '🤖 Presets / models',
   '/models  列出模型': '/models  List models',
   '🎮 任务控制': '🎮 Task controls',
   '/steer 指令  给 Agent 补充指令': '/steer INSTRUCTION  Steer the Agent',
   '**📋 卡片功能**\n\n1. 会话下拉 — 切换当前绑定会话\n2. 工作区下拉 — 切换工作区\n3. 🤖 预设下拉 — 切换 Agent 预设\n4. 🧠 模型下拉 — 切换模型\n5. 🆕 新会话 — 开启全新会话\n6. 📋 会话/关注 — 查看/绑定会话，管理关注\n7. ⏹ 停止 — 停止当前任务\n8. 📐 压缩 — 压缩当前会话上下文\n9. 补充指令 — 给 Agent 发送指令\n10. 🗄 归档切换 — 显示/隐藏归档会话\n11. 📊 状态 — 查看系统连接状态\n12. 📖 帮助 — 查看本帮助':
     '**📋 Card features**\n\n1. Session dropdown — switch the bound session\n2. Workspace dropdown — switch workspace\n3. 🤖 Preset dropdown — switch Agent Preset\n4. 🧠 Model dropdown — switch model\n5. 🆕 New session — start fresh\n6. 📋 Sessions/watches — view or bind sessions and manage watches\n7. ⏹ Stop — stop the current task\n8. 📐 Compact — compact the current session context\n9. Steer task — send an instruction to the Agent\n10. 🗄 Archived toggle — show or hide archived sessions\n11. 📊 Status — view connection status\n12. 📖 Help — view this help',
-  '**⌨️ 文本命令**\n\n`/m` — 打开菜单卡片\n`/new` — 开启全新会话\n`/session ID` — 绑定已有会话\n`/sessionlist [工作区]` — 列出会话\n`/workspace 路径` — 切换工作区\n`/workspacelist` — 列出工作区\n`/status` — 查看连接状态\n`/compact` — 压缩上下文\n`/stop` — 停止当前任务\n`/steer 指令` — 补充指令\n`/watch ID` — 关注会话\n`/watchlist` — 关注列表\n`/unwatch ID` — 取消关注\n`/archived on/off` — 归档显隐\n`/presetlist` — 列出预设\n`/preset [序号/ID]` — 切换预设\n`/preset --default` — 跟随默认\n`/models` — 列出模型\n`/reasoninglist` 或 `/reasonings` — 按序号列出当前模型可用推理等级\n`/reasoning [序号、等级ID或 --default]` — 查看或切换当前推理等级\n`/model [序号或完整模型ID] [推理等级ID]` — 查看或切换当前会话模型\n`/repair` — 修复卡片按钮':
-    '**⌨️ Text commands**\n\n`/m` — open the menu card\n`/new` — start a new session\n`/session ID` — bind an existing session\n`/sessionlist [workspace]` — list sessions\n`/workspace PATH` — switch workspace\n`/workspacelist` — list workspaces\n`/status` — view connection status\n`/compact` — compact context\n`/stop` — stop the current task\n`/steer INSTRUCTION` — steer the task\n`/watch ID` — watch a session\n`/watchlist` — list watched sessions\n`/unwatch ID` — stop watching\n`/archived on/off` — show or hide archived sessions\n`/presetlist` — list presets\n`/preset [index/ID]` — switch preset\n`/preset --default` — follow default\n`/models` — list models\n`/reasoninglist` or `/reasonings` — list reasoning efforts for the current model\n`/reasoning [index, effort ID, or --default]` — show or switch reasoning effort\n`/model [index or full model ID] [reasoning effort ID]` — show or switch the current Session model\n`/repair` — repair card buttons',
-  '**💡 数字兜底**\n回复数字快速操作：\n**1**工作区列表 · **2**新会话 · **3**会话/关注\n**4**状态 · **5**修复 · **6**帮助':
-    '**💡 Number fallback**\nReply with a number for a quick action:\n**1** Workspace list · **2** New session · **3** Sessions/watches\n**4** Status · **5** Repair · **6** Help',
+  '**⌨️ 文本命令**\n\n`/m` — 打开菜单卡片\n`/new` — 开启全新会话\n`/session ID` — 绑定已有会话\n`/sessionlist [工作区]` — 列出会话\n`/workspace 路径` — 切换工作区\n`/workspacelist` — 列出工作区\n`/status` — 查看连接状态\n`/compact` — 压缩上下文\n`/stop` — 停止当前任务\n`/steer 指令` — 补充指令\n`/watch ID` — 关注会话\n`/watchlist` — 关注列表\n`/unwatch ID` — 取消关注\n`/archived on/off` — 归档显隐\n`/presetlist` — 列出预设\n`/preset [序号/ID]` — 切换预设\n`/preset --default` — 跟随默认\n`/models` — 列出模型\n`/reasoninglist` 或 `/reasonings` — 按序号列出当前模型可用推理等级\n`/reasoning [序号、等级ID或 --default]` — 查看或切换当前推理等级\n`/model [序号或完整模型ID] [推理等级ID]` — 查看或切换当前会话模型\n`/batch` — 开启批量输入（仅私聊，最多 10 条文字）\n`/send` — 提交当前批次\n`/cancel` — 取消当前批次\n`/repair` — 补全飞书权限与卡片回调':
+    '**⌨️ Text commands**\n\n`/m` — open the menu card\n`/new` — start a new session\n`/session ID` — bind an existing session\n`/sessionlist [workspace]` — list sessions\n`/workspace PATH` — switch workspace\n`/workspacelist` — list workspaces\n`/status` — view connection status\n`/compact` — compact context\n`/stop` — stop the current task\n`/steer INSTRUCTION` — steer the task\n`/watch ID` — watch a session\n`/watchlist` — list watched sessions\n`/unwatch ID` — stop watching\n`/archived on/off` — show or hide archived sessions\n`/presetlist` — list presets\n`/preset [index/ID]` — switch preset\n`/preset --default` — follow default\n`/models` — list models\n`/reasoninglist` or `/reasonings` — list reasoning efforts for the current model\n`/reasoning [index, effort ID, or --default]` — show or switch reasoning effort\n`/model [index or full model ID] [reasoning effort ID]` — show or switch the current Session model\n`/batch` — start batch input (direct messages only, up to 10 text messages)\n`/send` — submit the current batch\n`/cancel` — cancel the current batch\n`/repair` — complete Feishu permissions and the card callback',
+  '**💡 数字兜底**\n回复数字快速操作：\n**1**工作区列表 · **2**新会话 · **3**会话/关注\n**4**状态 · **5**补全权限 · **6**帮助':
+    '**💡 Number fallback**\nReply with a number for a quick action:\n**1** Workspace list · **2** New session · **3** Sessions/watches\n**4** Status · **5** Complete permissions · **6** Help',
   '从下方下拉选择补充指令；最后一项可自定义输入。':
     'Choose an instruction below; the last option lets you enter a custom one.',
   '当前没有绑定会话，请先绑定会话再补充指令。':
@@ -261,8 +264,8 @@ export default {
   '3 · 新会话': '3 · New session',
   '4 · 状态': '4 · Status',
   '5 · 帮助': '5 · Help',
-  '**6 · 修复卡片按钮**（请直接回复数字 **6**）':
-    '**6 · Repair card buttons** (reply with the number **6**)',
+  '**6 · 补全权限**（请直接回复数字 **6**）':
+    '**6 · Complete permissions** (reply with the number **6**)',
   '7 · 关注列表': '7 · Watch list',
   '🧪 验证卡片按钮': '🧪 Verify card buttons',
   '授权已提交。请点击下方按钮；机器人真实收到回调后才会判定修复成功。':
@@ -289,8 +292,8 @@ export default {
   '3 · /new  开启新会话': '3 · /new  Start a new session',
   '4 · /status  连接状态': '4 · /status  Connection status',
   '5 · /help  本帮助': '5 · /help  This help',
-  '6 · /repair  修复卡片按钮（请回复数字 6）':
-    '6 · /repair  Repair card buttons (reply with the number 6)',
+  '6 · /repair  补全权限与回调（请回复数字 6）':
+    '6 · /repair  Complete permissions and callback (reply with the number 6)',
   '7 · /watchlist  关注列表': '7 · /watchlist  Watch list',
   '直接发送文字/图片即继续当前会话。':
     'Send text or an image directly to continue the current session.',
@@ -335,8 +338,8 @@ export default {
   '飞书机器人': 'Feishu bot',
 
   // feishu/message-utils.mjs
-  '飞书机器人缺少图片读取权限。请在飞书开放平台为该应用添加 im:message:readonly，发布新版本并完成必要的管理员审批后，再重新发送图片。':
-    'The Feishu bot is missing image-read permission. Add im:message:readonly to the app in Feishu Open Platform, publish a new version, complete the required admin approval, then resend the image.',
+  '飞书机器人缺少图片读取权限 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.',
 
   // feishu/feishu-runtime.mjs — callback probe notices
   '✅ 修复完成：已实测收到 card.action.trigger，菜单按钮现在可用。':

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

@@ -69,6 +69,7 @@ export default {
   '/stop  停止当前任务': '/stop  Stop the current task',
   '/steer 补充指令  纠偏当前任务': '/steer <additional instruction>  Steer the current task',
   '/status  检查连接状态': '/status  Check the connection status',
+  '/version  查看插件版本': '/version  Show the plugin version',
   '/help  显示本帮助': '/help  Show this help',
   '{label}机器人与 DeepSeek Harness 连接正常。':
     'The {label} bot is connected to DeepSeek Harness and working normally.',

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

@@ -242,6 +242,7 @@ export default {
 
   // control-command.mjs
   '用法：/stop（不带参数）': 'Usage: /stop (no arguments)',
+  '用法：/version（不带参数）': 'Usage: /version (no arguments)',
   '用法：/steer <补充指令>': 'Usage: /steer <additional instruction>',
   '控制命令仅支持纯文字，请移除图片后重试。':
     'Control commands support text only; please remove images and try again.',