@xmanrui/dsh-im 4.14.0 → 4.16.0

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

@@ -207,59 +207,120 @@ export class VerifiedFeishuChannel {
     const cards = [];
     let activeCard = null;
     let rotating = false;
+    let awaitingPresentation = false;
+    // issue #163：过程写卡与换卡定格共用一条写队列串行化——在途写必然先于
+    // 定格完成，消除「写飞越定格」竞态；前序失败不阻塞后续写入。
+    let writeQueue = Promise.resolve();
+    const enqueue = (job) => {
+      const run = writeQueue.then(job, job);
+      writeQueue = run.catch(() => undefined);
+      return run;
+    };
     try {
       activeCard = await this.#createStreamCard(chatId, options);
       cards.push(activeCard);
       let lastContent = this.#initialText;
+      let lastContentIsTransient = true;
+      // Track the current card separately from incoming snapshots: held or
+      // failed writes have not delivered any text that can be deduplicated.
+      let activeView = lastContent;
+      let activeTextPrefix = null;
       // issue #86：独立交互消息（提问/审批）落在占位卡下方后，最终答案不得
       // 回写旧卡。rotate() 把旧卡定格为「过程记录 + 指引行」并标记换卡态；
       // 下一次 setContent（过程更新或最终答案）才创建新卡——新卡必然创建于
       // 交互消息之后。旧卡纳入 cards，参与 recall 与 providerMessageIds。
+      // issue #163：定格后进入换卡挂起（awaitingPresentation），挂起期内
+      // setContent 只推进快照、不建卡不写卡；bridge 呈现交互消息后调用
+      // interactionPresented() 解除挂起，此后建的新卡必然位于交互消息下方。
       const ensureActiveCard = async () => {
         if (!rotating) return activeCard;
         activeCard = await this.#createStreamCard(chatId, options);
+        activeView = this.#initialText;
+        activeTextPrefix = null;
         cards.push(activeCard);
         rotating = false;
         return activeCard;
       };
+      // issue #163：冻结前缀去重——换卡定格时旧卡已展示 frozenContent；此后
+      // 新卡只展示剥离该前缀后的增量（重放快照剥为空白则跳过写卡），终稿
+      // 分段同样使用增量视图，提问前的过程不再重复播放。
+      let frozenContent = null;
+      const applyFrozenDedup = (next) => {
+        if (frozenContent === null || !next.startsWith(frozenContent)) return next;
+        const rest = next.slice(frozenContent.length);
+        return rest.trim().length > 0 ? rest : ''; // 不改写增量原文；全空白视为无增量
+      };
+      // 评审补充（#163）：去重基线与定格内容必须以「旧卡实际展示的内容」为准——
+      // 超长快照的旧卡只展示了截断前缀，若冻结完整 lastContent，未展示的尾部
+      // 会被整段剥掉而丢失；再次换卡时旧卡展示的是上一轮增量，不得回写完整快照。
+      const shownPrefixOf = (text) => {
+        const notice = `\n\n${t('内容较长，生成完成后将分段发送完整回答。')}`;
+        return text.length <= MAX_STREAM_CHARS
+          ? text
+          : streamTextPrefix(text, MAX_STREAM_CHARS - notice.length);
+      };
       const controller = {
         get messageId() {
           return activeCard.messageId;
         },
-        rotate: async () => {
+        interactionPresented: () => {
+          awaitingPresentation = false;
+        },
+        rotate: () => enqueue(async () => {
           if (rotating) return;
           rotating = true;
+          awaitingPresentation = true;
+          const shownPrefix = shownPrefixOf(activeView);
           try {
             await this.#updateStreamCard(
               activeCard,
-              `${streamPreview(lastContent)}\n\n${t('⤵️ 最终结果见下方')}`,
+              `${streamPreview(shownPrefix)}\n\n${t('⤵️ 最终结果见下方')}`,
             );
+            // Tool/status messages remain visible but never extend the text
+            // prefix. Only a successfully displayed text snapshot advances it.
+            if (activeTextPrefix !== null) frozenContent = activeTextPrefix;
             await this.#finishStreamCard(activeCard);
           } catch (error) {
             // 明确降级：定格失败不阻塞交互呈现，旧卡保留原内容。
             console.warn('[dsh-feishu] unable to finalize the superseded stream card:', error.message);
           }
-        },
-        setContent: async (content) => {
+        }),
+        setContent: (content, { transient = false } = {}) => enqueue(async () => {
           const next = String(content ?? '') || '…';
-          const card = await ensureActiveCard();
-          await this.#updateStreamCard(card, streamPreview(next));
-          // Updates are replaceable snapshots, including progress/tool text.
-          // Retain the full latest snapshot even when its preview is unchanged.
+          // Retain the latest snapshot even if it is a replay or a held write.
           lastContent = next;
-        },
+          lastContentIsTransient = transient;
+          const visible = transient ? next : applyFrozenDedup(next);
+          if (visible === '') return; // 重放快照不建卡不写卡
+          if (awaitingPresentation) return; // 换卡挂起：视图已推进，仅挂起卡片写入
+          const card = await ensureActiveCard();
+          await this.#updateStreamCard(card, streamPreview(visible));
+          activeView = visible;
+          const previousPrefix = frozenContent !== null && next.startsWith(frozenContent)
+            ? frozenContent
+            : '';
+          activeTextPrefix = transient ? null : previousPrefix + shownPrefixOf(visible);
+        }),
       };
 
       await input.markdown(controller);
-      const chunks = splitStreamContent(lastContent);
-      for (const [index, chunk] of chunks.entries()) {
-        const card = index === 0
-          ? await ensureActiveCard()
-          : await this.#createStreamCard(chatId, options);
-        if (index > 0) cards.push(card);
-        await this.#updateStreamCard(card, chunk);
-        await this.#finishStreamCard(card);
-      }
+      await enqueue(async () => {
+        // 终稿强制解除挂起：异常路径下呈现通知缺失时仍可收尾。
+        awaitingPresentation = false;
+        // Recompute from the final snapshot, including an empty delta, rather
+        // than retaining the last nonempty progress/tool view as the answer.
+        const finalView = (lastContentIsTransient ? lastContent : applyFrozenDedup(lastContent))
+          || lastContent;
+        const chunks = splitStreamContent(finalView);
+        for (const [index, chunk] of chunks.entries()) {
+          const card = index === 0
+            ? await ensureActiveCard()
+            : await this.#createStreamCard(chatId, options);
+          if (index > 0) cards.push(card);
+          await this.#updateStreamCard(card, chunk);
+          await this.#finishStreamCard(card);
+        }
+      });
       return {
         messageId: cards[0].messageId,
         providerMessageIds: cards.map((card) => card.messageId),
@@ -507,14 +568,16 @@ export class VerifiedFeishuChannel {
     return messageId;
   }
 
-  async #recall(messageId) {
+  async #recall(messageId, label = 'streaming card') {
     try {
       const response = await this.#client.im.v1.message.delete({
         path: { message_id: messageId },
       });
       assertApiSuccess('Feishu message delete', response);
+      return true;
     } catch (error) {
-      console.warn('[bridge] unable to recall a failed streaming card:', error.message);
+      console.warn(`[bridge] unable to recall ${label}:`, error.message);
+      return false;
     }
   }
 
@@ -528,6 +591,11 @@ export class VerifiedFeishuChannel {
     return reactionId;
   }
 
+  /** Delete one previously sent message (step-push heartbeat cleanup). */
+  async recallMessage(messageId) {
+    return this.#recall(messageId, 'thinking status heartbeat');
+  }
+
   async removeReaction(messageId, reactionId) {
     assertApiSuccess('Feishu reaction.delete', await this.#client.im.v1.messageReaction.delete({
       path: { message_id: messageId, reaction_id: reactionId },

package/src/channels/feishu/plugin-controller.mjs

@@ -6,6 +6,7 @@ export const FEISHU_SECRET_REF = 'DSH_FEISHU_APP_SECRET';
 export const REQUIRED_TENANT_SCOPES = Object.freeze([
   'im:message.p2p_msg:readonly',
   'im:message.group_at_msg:readonly',
+  'im:message.group_at_msg.include_bot:readonly',
   'im:message:readonly',
   'im:message:send_as_bot',
   'im:message.reactions:write_only',

package/src/channels/feishu/repair-manager.mjs

@@ -76,8 +76,8 @@ export function assertCallbackRepairUrl(value, expectedAppId, domain = 'feishu')
  * shares RegistrationManager's polling/state implementation while fixing the
  * update manifest in one place so callers can add only the card callback, the
  * message-read scope needed to download user-sent media, the resource scope
- * needed to upload bot-sent images/files, and the Slash Command scopes needed
- * for the native command panel, without adding unrelated scopes, events,
+ * needed to upload bot-sent images/files, the group bot-mention scope, and the
+ * Slash Command scopes for the native command panel, without adding unrelated scopes, events,
  * presets, or createOnly.
  */
 export class CallbackRepairManager {
@@ -116,6 +116,7 @@ export class CallbackRepairManager {
           tenant: [
             FEISHU_MESSAGE_READ_SCOPE,
             FEISHU_RESOURCE_SCOPE,
+            'im:message.group_at_msg.include_bot:readonly',
             ...SLASH_COMMAND_TENANT_SCOPES,
           ],
         },

package/src/channels/shared/bot-workspace-store.mjs

@@ -24,7 +24,8 @@ import {
   validateContextEnhancementConfig,
 } from './context-enhancement.mjs';
 import {
-  modelCatalogHas,
+  confirmsModelSelection,
+  modelCatalogEntry,
   normalizeModelCatalog,
   sameModelSelection,
   validateModelSelection,
@@ -1372,7 +1373,7 @@ export function createBotWorkspaceScope(
               model,
               options.signal ? { signal: options.signal } : {},
             );
-            if (!sameModelSelection(selected?.selected, model)) {
+            if (!confirmsModelSelection(selected?.selected, model)) {
               const error = new Error('Harness did not confirm the selected model');
               error.code = 'model-selection-mismatch';
               throw error;
@@ -1625,9 +1626,16 @@ export function createWorkspaceAwareController(controller, {
       const catalog = model && modelCatalog
         ? await resolveModelCatalog(modelCatalog)
         : null;
-      if (model && (!modelCatalog || !modelCatalogHas(catalog, model))) {
+      const entry = modelCatalogEntry(catalog, model);
+      if (model && (!modelCatalog || !entry)) {
         throw unavailableModel();
       }
+      if (model?.reasoningEffort !== undefined
+        && !entry.reasoning?.efforts.some((effort) => effort.id === model.reasoningEffort)) {
+        const error = new Error('当前模型不支持所选思考强度，请重新选择。');
+        error.code = 'model-reasoning-unavailable';
+        throw error;
+      }
       await workspaces.setModel(botId, model, { incarnation });
       return decorateResult(
         workspaces,

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

@@ -0,0 +1,102 @@
+import { t } from './i18n.mjs';
+
+const TEXT_CHANNELS = Object.freeze(['telegram', 'slack', 'discord', 'whatsapp']);
+
+function defineCatalogCommand(name, description, help, { aliases = [], ...options } = {}) {
+  return Object.freeze({
+    name,
+    description,
+    channels: TEXT_CHANNELS,
+    menuVisible: true,
+    ...options,
+    aliases: Object.freeze(aliases.map((alias) => Object.freeze({
+      menuVisible: true,
+      ...(typeof alias === 'string' ? { name: alias } : alias),
+    }))),
+    help: Object.freeze(help),
+  });
+}
+
+// Presentation metadata for TextHarnessBridge commands, in help order.
+// Keep each command's aliases, short description and full usage together here.
+// Handlers still own parsing and authorization; privateOnly is descriptive.
+// enabled: false removes a definition from both consumers; menuVisible: false
+// hides a command (or alias) only from the native menu, leaving help available.
+export const SHARED_COMMAND_CATALOG = Object.freeze([
+  defineCatalogCommand('new', '开启一个全新会话', [
+    '/new  开启一个全新会话',
+  ]),
+  defineCatalogCommand('compact', '压缩当前会话的较早上下文', [
+    '/compact  压缩当前会话的较早上下文',
+  ]),
+  defineCatalogCommand('history', '查看最近历史消息（仅私聊）', [
+    '/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）',
+  ], { privateOnly: true }),
+  defineCatalogCommand('workspace', '切换工作区', [
+    '/workspace 工作区序号或绝对路径  切换工作区',
+  ], { aliases: ['ws'] }),
+  defineCatalogCommand('workspacelist', '列出工作区绝对路径', [
+    '/workspacelist  列出工作区绝对路径',
+    '/ws、/wsl、/workspaces  工作区命令别名',
+  ], { aliases: ['workspaces', 'wsl'] }),
+  defineCatalogCommand('sessionlist', '列出会话 ID 和标题', [
+    '/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题',
+    '/sessionlist --limit N  仅列出当前工作区前 N 个会话',
+  ], { aliases: ['sessions'] }),
+  defineCatalogCommand('session', '将当前聊天绑定到指定会话', [
+    '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
+  ]),
+  defineCatalogCommand('models', '按序号列出所有可用模型', [
+    '/models  按序号列出所有可用模型',
+  ]),
+  defineCatalogCommand('reasoninglist', '按序号列出当前模型可用推理等级', [
+    '/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级',
+  ], { aliases: ['reasonings'] }),
+  defineCatalogCommand('reasoning', '查看或切换当前推理等级', [
+    '/reasoning [序号、等级ID或 --default]  查看或切换当前推理等级',
+  ]),
+  defineCatalogCommand('model', '查看或切换当前会话模型', [
+    '/model [序号或完整模型ID] [推理等级ID]  查看或切换当前会话模型',
+    '示例：先发 /models，再发 /model 2 [推理等级ID]',
+  ]),
+  defineCatalogCommand('presetlist', '列出可用 Agent Preset', [
+    '/presetlist 或 /presets  按序号列出可用 Agent Preset',
+  ], { aliases: ['presets'] }),
+  defineCatalogCommand('preset', '查看或设置新会话 Agent Preset', [
+    '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset',
+    '纯数字 ID：/preset id:<ID>',
+    '/preset --default  跟随 Host 默认',
+  ]),
+  defineCatalogCommand('stop', '停止当前任务', [
+    '/stop  停止当前任务',
+  ]),
+  defineCatalogCommand('steer', '纠偏当前任务', [
+    '/steer 补充指令  纠偏当前任务',
+  ]),
+  defineCatalogCommand('batch', '开始批量输入（仅私聊）', [
+    '/batch  开始批量输入（仅私聊，最多 10 条文字）',
+  ], { privateOnly: true }),
+  defineCatalogCommand('send', '提交当前批次', [
+    '/send  提交当前批次',
+  ], { privateOnly: true }),
+  defineCatalogCommand('cancel', '取消当前批次', [
+    '/cancel  取消当前批次',
+  ], { privateOnly: true }),
+  defineCatalogCommand('status', '检查连接状态', [
+    '/status  检查连接状态',
+  ]),
+  defineCatalogCommand('version', '查看插件版本', [
+    '/version  查看插件版本',
+  ]),
+  defineCatalogCommand('help', '显示帮助', [
+    '/help  显示本帮助',
+  ]),
+]);
+
+export function commandsForChannel(channel, catalog = SHARED_COMMAND_CATALOG) {
+  return catalog.filter((item) => item.enabled !== false && item.channels.includes(channel));
+}
+
+export function commandHelpLines(channel, catalog = SHARED_COMMAND_CATALOG) {
+  return commandsForChannel(channel, catalog).flatMap((item) => item.help.map((line) => t(line)));
+}

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

@@ -72,8 +72,8 @@ export default {
   '旧授权链接已作废，已生成新的修复链接。':
     '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（用于上传机器人发送的图片或文件）；以及原生命令面板所需的 application:app_slash_command:read / write。确认页只会显示当前缺少的项；若出现上述范围之外的配置，请取消。':
-    'This incrementally adds the currently missing 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; im:resource, used to upload images or files sent by the bot; and application:app_slash_command:read / write for the native command panel. The confirmation page shows only items the app is currently missing; cancel if anything outside this scope appears.',
+  '本次会增量添加当前缺少项：卡片回调 card.action.trigger；飞书显示为“获取单聊、群组消息”的租户权限 im:message:readonly（用于读取用户消息中的图片或文件）；im:resource（用于上传机器人发送的图片或文件）；im:message.group_at_msg.include_bot:readonly（用于接收群内其他机器人 @ 当前机器人的消息）；以及原生命令面板所需的 application:app_slash_command:read / write。确认页只会显示当前缺少的项；若出现上述范围之外的配置，请取消。':
+    'This incrementally adds the currently missing 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; im:resource, used to upload images or files sent by the bot; im:message.group_at_msg.include_bot:readonly, used to receive group messages from other bots that mention this bot; and application:app_slash_command:read / write for the native command panel. 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}.',
@@ -375,4 +375,16 @@ export default {
   '任务失败': 'Failed',
   // feishu/bridge.mjs — step push context injection
   '📎 已注入会话上下文': '📎 Context injected',
+  // feishu/feishu-cards.mjs — question card answered state + custom entry (issue #162)
+  '✏️ 其他答案…': '✏️ Other answer…',
+  '✅ 已回答{progress}': '✅ Answered{progress}',
+  '✅ 已选择：{label}': '✅ Selected: {label}',
+  '回答已提交，对话将继续。': 'Answer submitted. The conversation will continue.',
+  // feishu/bridge.mjs — answered interaction notices + custom answer guidance (issue #162)
+  '这个问题已经回答过了。': 'This question has already been answered.',
+  '想自定义答案？直接发送文字消息即可，将作为本题答案提交。':
+    'Want a custom answer? Just send a text message and it will be submitted as your answer.',
+  // feishu/bridge.mjs — thinking status heartbeat
+  '⏳ 正在思考中…（已运行 {elapsed}）': '⏳ Thinking… (elapsed {elapsed})',
+  '⏳ 正在思考中…': '⏳ Thinking…',
 };

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

@@ -118,6 +118,9 @@ export default {
   '直接发送文字、图片、文件或带文字识别结果的语音即可继续当前会话。':
     'Send text, an image, a file, or a voice message already transcribed to text to continue the current session.',
   '{label}机器人已连接 DeepSeek Harness。': 'The {label} bot is connected to DeepSeek Harness.',
+  '查看最近历史消息（仅私聊）': 'Show recent history (private chats only)',
+  '按序号列出当前模型可用推理等级': 'List reasoning efforts for the current model by index',
+  '查看或切换当前推理等级': 'Show or switch the current reasoning effort',
   '/new  开启一个全新会话': '/new  Start a brand-new session',
   '/compact  压缩当前会话的较早上下文': '/compact  Compact the earlier context of the current session',
   '/workspace 工作区序号或绝对路径  切换工作区':

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

@@ -1,5 +1,14 @@
 // English translations (shared-c area). Keys are exact Chinese literals passed to t().
 export default {
+  '微信': 'Weixin',
+  '飞书': 'Feishu',
+  '钉钉': 'DingTalk',
+  '企业微信': 'Enterprise WeChat',
+  '{channel}正在初始化，请稍后重新读取。': '{channel} is initializing. Please reload shortly.',
+  '{channel}配置格式错误。请检查其数据目录中的 config.json 和 workspaces.json，修复后重启 DSH。详细原因请查看启动日志。': 'The {channel} configuration is invalid. Check config.json and workspaces.json in its data directory, then restart DSH. See the startup log for details.',
+  '{channel}配置格式错误。请检查其数据目录中的 config.json，修复后重启 DSH。详细原因请查看启动日志。': 'The {channel} configuration is invalid. Check config.json in its data directory, then restart DSH. See the startup log for details.',
+  '无法读取或写入{channel}配置。请检查其数据目录的访问权限，修复后重启 DSH。详细原因请查看启动日志。': 'The {channel} configuration could not be read or written. Check access to its data directory, then restart DSH. See the startup log for details.',
+  '{channel}初始化失败。请查看 DSH 启动日志中 failed to activate {id} 后的错误，修复后重启 DSH。': '{channel} initialization failed. Check the error after "failed to activate {id}" in the DSH startup log, fix it, then restart DSH.',
   // history-command.mjs / command help
   '/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）':
     '/history [count]  Preview recent messages (default 3, maximum 5)',

package/src/channels/shared/i18n-en/wecom-app.mjs

@@ -0,0 +1,33 @@
+// English translations (wecom-app area). Keys are exact Chinese literals passed to t().
+export default {
+  '企业微信应用': 'WeCom app',
+  '企业微信应用凭据缺失，请重新绑定。': 'WeCom app credentials are missing; please bind the app again.',
+  '企业微信应用凭据不完整，请重新绑定。': 'WeCom app credentials are incomplete; please bind the app again.',
+  '企业微信应用连接未就绪，插件会自动重试。': 'The WeCom app connection is not ready; the plugin will retry automatically.',
+  '企业微信应用连接未就绪，插件会自动重试': 'The WeCom app connection is not ready; the plugin will retry automatically',
+  '企业微信应用已绑定，但尚未就绪。': 'The WeCom app is bound but not ready yet.',
+  '企业微信应用已更新，但尚未就绪。': 'The WeCom app settings were saved, but the connection is not ready yet.',
+  '企业微信应用仍未就绪，请稍后重试。': 'The WeCom app is still not ready; please try again later.',
+  '企业微信应用当前离线': 'The WeCom app is currently offline',
+  '企业微信应用回调通道就绪': 'The WeCom app callback channel is ready',
+  '企业微信应用（{corpId}）': 'WeCom app ({corpId})',
+  '请输入正确的企业 ID（例如 ww1234567890abcdef）。': 'Enter a valid corp ID (for example ww1234567890abcdef).',
+  '请输入正确的应用 AgentId（纯数字）。': 'Enter a valid AgentId (digits only).',
+  '应用 Secret 格式不正确。': 'The app Secret format is invalid.',
+  '回调 Token 格式不正确。': 'The callback Token format is invalid.',
+  'EncodingAESKey 必须是 43 位字母或数字。': 'EncodingAESKey must be 43 alphanumeric characters.',
+  '代理地址必须是 http(s) 地址': 'The API proxy address must be an http(s) URL',
+  '代理地址必须是 http(s) 地址。': 'The API proxy address must be an http(s) URL.',
+  '回调基址必须是 http(s) 地址': 'The callback base URL must be an http(s) URL',
+  '回调基址必须是 http(s) 地址。': 'The callback base URL must be an http(s) URL.',
+  '回调密钥已重置，但机器人重启失败，请手动重连。': 'The callback secret was reset, but the bot failed to restart; please reconnect manually.',
+  '企业微信应用交互问题发送失败。': 'Failed to send the WeCom app interaction question.',
+  '企业微信应用目前支持文字和图片消息。': 'The WeCom app currently supports text and image messages.',
+  '企业微信应用已连接 DeepSeek Harness，可在微信中直接使用。': 'The WeCom app is connected to DeepSeek Harness and works directly inside WeChat.',
+  '企业微信应用已连接 DeepSeek Harness。直接发送文字或图片即可开始，发送 /help 查看可用命令。': 'The WeCom app is connected to DeepSeek Harness. Send text or images to start, or send /help for available commands.',
+  '企业微信应用与 DeepSeek Harness 连接正常。': 'The WeCom app and DeepSeek Harness are connected.',
+  '结果文件「{name}」已生成，但企业微信应用当前没有文件消息发送权限，请检查应用的文件发送能力。': 'The result file "{name}" was generated, but the WeCom app currently lacks file-message permission; check the app file capability.',
+  '结果文件「{name}」超过企业微信可发送的文件大小，未发送。': 'The result file "{name}" exceeds the WeCom file size limit and was not sent.',
+  '结果文件「{name}」已生成，但企业微信拒绝了该文件消息。': 'The result file "{name}" was generated, but WeCom rejected the file message.',
+  '结果文件「{name}」发送失败，请稍后重试。': 'The result file "{name}" failed to send; please try again later.',
+};

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

@@ -9,6 +9,7 @@ import sharedC from './i18n-en/shared-c.mjs';
 import feishu from './i18n-en/feishu.mjs';
 import dingtalk from './i18n-en/dingtalk.mjs';
 import wecom from './i18n-en/wecom.mjs';
+import wecomApp from './i18n-en/wecom-app.mjs';
 import qq from './i18n-en/qq.mjs';
 import weixin from './i18n-en/weixin.mjs';
 import slack from './i18n-en/slack.mjs';
@@ -25,6 +26,7 @@ export const EN = Object.freeze(Object.assign(
   feishu,
   dingtalk,
   wecom,
+  wecomApp,
   qq,
   weixin,
   slack,

package/src/channels/shared/model-setting.mjs

@@ -1,5 +1,6 @@
 const MAX_PROVIDER_ID_LENGTH = 256;
 const MAX_MODEL_ID_LENGTH = 1_024;
+const MAX_EFFORT_ID_LENGTH = 256;
 const MAX_LABEL_LENGTH = 256;
 const UNSAFE_DISPLAY_TEXT = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+/gu;
 const UNSAFE_ID_TEXT = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u;
@@ -27,7 +28,10 @@ export function normalizeModelSelection(value) {
   if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
   const provider = cleanId(value.provider, MAX_PROVIDER_ID_LENGTH);
   const model = cleanId(value.model, MAX_MODEL_ID_LENGTH);
-  return provider && model ? { provider, model } : null;
+  const reasoningEffort = value.reasoningEffort === undefined
+    ? undefined : cleanId(value.reasoningEffort, MAX_EFFORT_ID_LENGTH);
+  if (!provider || !model || reasoningEffort === '') return null;
+  return { provider, model, ...(reasoningEffort === undefined ? {} : { reasoningEffort }) };
 }
 
 export function validateModelSelection(value) {
@@ -42,7 +46,31 @@ export function validateModelSelection(value) {
 }
 
 export function sameModelSelection(left, right) {
-  return left?.provider === right?.provider && left?.model === right?.model;
+  return left?.provider === right?.provider && left?.model === right?.model
+    && left?.reasoningEffort === right?.reasoningEffort;
+}
+
+// Harness may resolve an omitted effort to the model's default.
+export function confirmsModelSelection(actual, requested) {
+  return actual?.provider === requested?.provider && actual?.model === requested?.model
+    && (requested?.reasoningEffort === undefined
+      || actual?.reasoningEffort === requested.reasoningEffort);
+}
+
+function normalizeReasoning(value) {
+  if (!value || typeof value !== 'object' || !Array.isArray(value.efforts)) return undefined;
+  const efforts = [];
+  const seen = new Set();
+  for (const entry of value.efforts) {
+    const id = cleanId(entry?.id, MAX_EFFORT_ID_LENGTH);
+    if (!id || seen.has(id)) continue;
+    seen.add(id);
+    const description = cleanLabel(entry.description, '');
+    efforts.push({ id, name: cleanLabel(entry.name, id), ...(description ? { description } : {}) });
+  }
+  if (!efforts.length) return undefined;
+  const defaultEffort = cleanId(value.defaultEffort, MAX_EFFORT_ID_LENGTH);
+  return { efforts, ...(seen.has(defaultEffort) ? { defaultEffort } : {}) };
 }
 
 export function modelSelectionId(value) {
@@ -68,9 +96,13 @@ export function normalizeModelCatalog(value) {
       const key = `${provider}\u0000${model}`;
       if (seen.has(key)) continue;
       seen.add(key);
+      const description = cleanLabel(entry.description, '');
+      const reasoning = normalizeReasoning(entry.reasoning);
       models.push({
         id: model,
         name: cleanLabel(entry.name, model),
+        ...(description ? { description } : {}),
+        ...(reasoning ? { reasoning } : {}),
       });
     }
     if (models.length > 0) {
@@ -91,13 +123,16 @@ export function normalizeModelCatalog(value) {
   return { groups, failures };
 }
 
-export function modelCatalogHas(catalog, selection) {
+export function modelCatalogEntry(catalog, selection) {
   const normalized = normalizeModelSelection(selection);
-  if (!normalized) return false;
-  return normalizeModelCatalog(catalog).groups.some(
-    (group) => group.id === normalized.provider
-      && group.models.some((model) => model.id === normalized.model),
-  );
+  if (!normalized) return undefined;
+  return normalizeModelCatalog(catalog).groups
+    .filter((group) => group.id === normalized.provider)
+    .flatMap((group) => group.models).find((model) => model.id === normalized.model);
+}
+
+export function modelCatalogHas(catalog, selection) {
+  return modelCatalogEntry(catalog, selection) !== undefined;
 }
 
 export async function listModelCatalog(harness, options = {}) {

package/src/channels/shared/session-channel-labels.mjs

@@ -0,0 +1,26 @@
+export const SESSION_CHANNEL_LABELS = Object.freeze(Object.fromEntries(Object.entries({
+  weixin: ['微信', 'WeChat'],
+  feishu: ['飞书', 'Feishu'],
+  dingtalk: ['钉钉', 'DingTalk'],
+  wecom: ['企业微信', 'WeCom'],
+  qq: ['QQ', 'QQ'],
+  slack: ['Slack', 'Slack'],
+  telegram: ['Telegram', 'Telegram'],
+  discord: ['Discord', 'Discord'],
+  whatsapp: ['WhatsApp', 'WhatsApp'],
+  office: ['AI Office', 'AI Office'],
+}).map(([channel, labels]) => [channel, Object.freeze(labels)])));
+
+/** Read only the exact, leading title prefix emitted by dsh-im. */
+export function parseSessionChannelTitle(title) {
+  if (typeof title !== 'string') return null;
+  for (const [channel, labels] of Object.entries(SESSION_CHANNEL_LABELS)) {
+    for (const label of labels) {
+      const prefix = `${label} · `;
+      if (title.startsWith(prefix) && title.slice(prefix.length).trim()) {
+        return { channel, title: title.slice(prefix.length) };
+      }
+    }
+  }
+  return null;
+}

package/src/channels/shared/text-harness-bridge.mjs

@@ -1,5 +1,6 @@
 import { createDeferredDeliveryCoordinator, deferredOutcomeText } from './deferred-delivery-coordinator.mjs';
 import { t } from './i18n.mjs';
+import { commandHelpLines } from './command-catalog.mjs';
 import {
   COMMAND_PERMISSION_DENIED_MESSAGE,
   evaluateInboundAccess,
@@ -605,32 +606,7 @@ export class TextHarnessBridge {
           t('{label}机器人已连接 DeepSeek Harness。', { label: this.#descriptor.label }),
           '',
           t('直接发送文字、图片或文件即可继续当前会话。'),
-          t('/new  开启一个全新会话'),
-          t('/compact  压缩当前会话的较早上下文'),
-          t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
-          t('/workspace 工作区序号或绝对路径  切换工作区'),
-          t('/workspacelist  列出工作区绝对路径'),
-          t('/ws、/wsl、/workspaces  工作区命令别名'),
-          t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
-          t('/sessionlist --limit N  仅列出当前工作区前 N 个会话'),
-          t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
-          t('/models  按序号列出所有可用模型'),
-          t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
-          t('/reasoning [序号、等级ID或 --default]  查看或切换当前推理等级'),
-          t('/model [序号或完整模型ID] [推理等级ID]  查看或切换当前会话模型'),
-          t('示例：先发 /models，再发 /model 2 [推理等级ID]'),
-          t('/presetlist 或 /presets  按序号列出可用 Agent Preset'),
-          t('/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset'),
-          t('纯数字 ID：/preset id:<ID>'),
-          t('/preset --default  跟随 Host 默认'),
-          t('/stop  停止当前任务'),
-          t('/steer 补充指令  纠偏当前任务'),
-          t('/batch  开始批量输入（仅私聊，最多 10 条文字）'),
-          t('/send  提交当前批次'),
-          t('/cancel  取消当前批次'),
-          t('/status  检查连接状态'),
-          t('/version  查看插件版本'),
-          t('/help  显示本帮助'),
+          ...commandHelpLines(this.#descriptor.key),
         ].join('\n'));
         return;
       }