@xmanrui/dsh-im 4.15.0 → 4.16.0

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

@@ -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/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;
       }

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

@@ -96,8 +96,16 @@ function validBotCommand(value) {
   return Boolean(value)
     && typeof value === 'object' && !Array.isArray(value)
     && typeof value.command === 'string' && TELEGRAM_COMMAND_NAME.test(value.command)
-    && typeof value.description === 'string' && value.description.length >= 1
-    && value.description.length <= 256;
+    && typeof value.description === 'string' && value.description.trim().length >= 1
+    && [...value.description].length <= 256;
+}
+
+export function validateTelegramCommands(commands, { allowEmpty = false } = {}) {
+  if (!Array.isArray(commands) || (!allowEmpty && commands.length === 0)
+    || commands.length > 100 || commands.some((command) => !validBotCommand(command))
+    || new Set(commands.map((item) => item.command)).size !== commands.length) {
+    throw new TypeError('Telegram bot commands are invalid');
+  }
 }
 
 export const COMMANDS_MENU_BUTTON = Object.freeze({ type: 'commands' });
@@ -334,10 +342,7 @@ export class TelegramApi {
   }
 
   async setMyCommands({ commands, scope, languageCode, signal } = {}) {
-    if (!Array.isArray(commands) || commands.length === 0
-      || commands.some((command) => !validBotCommand(command))) {
-      throw new TypeError('Telegram bot commands are invalid');
-    }
+    validateTelegramCommands(commands);
     return this.#call('setMyCommands', {
       commands,
       ...(scope ? { scope } : {}),
@@ -345,6 +350,13 @@ export class TelegramApi {
     }, { signal });
   }
 
+  async deleteMyCommands({ scope, languageCode, signal } = {}) {
+    return this.#call('deleteMyCommands', {
+      ...(scope ? { scope } : {}),
+      ...(cleanString(languageCode) ? { language_code: cleanString(languageCode) } : {}),
+    }, { signal });
+  }
+
   async setChatMenuButton({ menuButton = COMMANDS_MENU_BUTTON, signal } = {}) {
     if (!menuButton || typeof menuButton !== 'object' || Array.isArray(menuButton)) {
       throw new TypeError('Telegram menu button is invalid');

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

@@ -5,7 +5,8 @@ import { createTextDeliveryBlock } from '../shared/semantic/delivery.mjs';
 import { t } from '../shared/i18n.mjs';
 import { captureContextEnhancement } from '../shared/context-enhancement.mjs';
 import { recoverAssistantTextByTimestamp } from '../shared/session-reply-recovery.mjs';
-import { COMMANDS_MENU_BUTTON, TelegramApi } from './telegram-api.mjs';
+import { SHARED_COMMAND_CATALOG, commandsForChannel } from '../shared/command-catalog.mjs';
+import { COMMANDS_MENU_BUTTON, TelegramApi, validateTelegramCommands } from './telegram-api.mjs';
 import { createTelegramHttpTransport } from './telegram-http.mjs';
 import { createTelegramBridgeStatus, TelegramHarnessBridge } from './telegram-bridge.mjs';
 import {
@@ -17,39 +18,30 @@ import {
   TELEGRAM_ACCESS_MODES,
 } from './config-store.mjs';
 
-export const TELEGRAM_COMMAND_MENU = Object.freeze([
-  { command: 'new', description: '开启一个全新会话' },
-  { command: 'compact', description: '压缩当前会话的较早上下文' },
-  { command: 'workspace', description: '切换工作区' },
-  { command: 'ws', description: '切换工作区' },
-  { command: 'workspacelist', description: '列出工作区绝对路径' },
-  { command: 'workspaces', description: '列出工作区绝对路径' },
-  { command: 'wsl', description: '列出工作区绝对路径' },
-  { command: 'sessionlist', description: '列出会话 ID 和标题' },
-  { command: 'sessions', description: '列出会话 ID 和标题' },
-  { command: 'session', description: '将当前聊天绑定到指定会话' },
-  { command: 'models', description: '按序号列出所有可用模型' },
-  { command: 'model', description: '查看或切换当前会话模型' },
-  { command: 'presetlist', description: '列出可用 Agent Preset' },
-  { command: 'presets', description: '列出可用 Agent Preset' },
-  { command: 'preset', description: '查看或设置新会话 Agent Preset' },
-  { command: 'stop', description: '停止当前任务' },
-  { command: 'steer', description: '纠偏当前任务' },
-  { command: 'batch', description: '开始批量输入（仅私聊）' },
-  { command: 'send', description: '提交当前批次' },
-  { command: 'cancel', description: '取消当前批次' },
-  { command: 'status', description: '检查连接状态' },
-  { command: 'version', description: '查看插件版本' },
-  { command: 'help', description: '显示帮助' },
-]);
+function commandMenuEntries(catalog, translate) {
+  return commandsForChannel('telegram', catalog)
+    .filter((item) => item.menuVisible !== false)
+    .flatMap((item) => [item, ...(item.aliases ?? [])]
+      .filter((entry) => entry.menuVisible !== false && entry.enabled !== false
+        && (!entry.channels || entry.channels.includes('telegram')))
+      .map((entry) => ({
+        command: entry.name,
+        description: translate(entry.description ?? item.description),
+      })));
+}
 
-export function telegramCommandMenu() {
-  return TELEGRAM_COMMAND_MENU.map((item) => ({
-    ...item,
-    description: t(item.description),
-  }));
+export function telegramCommandMenu(catalog = SHARED_COMMAND_CATALOG) {
+  const commands = commandMenuEntries(catalog, t);
+  validateTelegramCommands(commands, { allowEmpty: true });
+  return commands;
 }
 
+// Retain the source-language export for existing consumers, derived from the
+// catalog. Runtime synchronization always generates a fresh, localized list.
+export const TELEGRAM_COMMAND_MENU = Object.freeze(
+  commandMenuEntries(SHARED_COMMAND_CATALOG, (text) => text).map((item) => Object.freeze(item)),
+);
+
 function escaped(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
@@ -772,6 +764,7 @@ export class TelegramRuntime {
   #replyTimeoutMs;
   #createApi;
   #createHttpTransport;
+  #commandCatalog;
   #status = createTelegramRuntimeStatus();
   #httpTransport = null;
   #api = null;
@@ -791,6 +784,7 @@ export class TelegramRuntime {
     replyTimeoutMs = 600_000,
     createApi = (options) => new TelegramApi(options),
     createHttpTransport = createTelegramHttpTransport,
+    commandCatalog = SHARED_COMMAND_CATALOG,
   }) {
     if (!config || !token || !harness || !state) {
       throw new TypeError('TelegramRuntime requires config, token, Harness, and state');
@@ -805,6 +799,7 @@ export class TelegramRuntime {
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#createApi = createApi;
     this.#createHttpTransport = createHttpTransport;
+    this.#commandCatalog = commandCatalog;
   }
 
   get status() {
@@ -883,7 +878,14 @@ export class TelegramRuntime {
         throw error;
       }
       try {
-        await api.setMyCommands({ commands: telegramCommandMenu(), signal: controller.signal });
+        const commands = telegramCommandMenu(this.#commandCatalog);
+        // Both operations use the existing default scope and language. Sending
+        // the full list replaces old entries; an empty catalog clears that list.
+        if (commands.length > 0) {
+          await api.setMyCommands({ commands, signal: controller.signal });
+        } else {
+          await api.deleteMyCommands({ signal: controller.signal });
+        }
         await api.setChatMenuButton({ menuButton: COMMANDS_MENU_BUTTON, signal: controller.signal });
       } catch (error) {
         this.#logger.warn?.(

package/src/channels/wecom/send-error.mjs

@@ -0,0 +1,31 @@
+import { channelDeliveryFailure } from '../shared/message-failure.mjs';
+
+// Normalize only errors from SDK send calls, never Harness or menu-building errors.
+export function wecomSendError(error, operation) {
+  if (error?.wecomOperation || error?.name === 'AbortError'
+    || error instanceof TypeError || error instanceof ReferenceError || error instanceof SyntaxError) return error;
+  const value = error?.errcode ?? error?.body?.errcode ?? error?.providerCode;
+  const providerCode = typeof value === 'number'
+    || (typeof value === 'string' && /^-?\d+$/u.test(value)) ? Number(value) : NaN;
+  const rejected = Number.isSafeInteger(providerCode) && providerCode !== 0;
+  const disconnected = error?.message === 'WebSocket not connected, unable to send data';
+  const wrapped = channelDeliveryFailure(error, { uncertain: !rejected && !disconnected });
+  // Keep the same provider mappings as wecomArtifactError.
+  if (providerCode === 48002) wrapped.code = 'channel-permission';
+  if (providerCode === 45009) wrapped.code = 'channel-rate-limit';
+  if (rejected) wrapped.providerCode = providerCode;
+  wrapped.wecomOperation = operation;
+  wrapped.message = `Enterprise WeChat ${operation} failed (${wrapped.code}, provider=${wrapped.providerCode ?? '-'})`;
+  return wrapped;
+}
+
+// The SDK rejection frame can contain private payloads. Log only diagnostic fields.
+export function wecomSendDiagnostic(error) {
+  if (!error?.wecomOperation) return undefined;
+  return {
+    operation: error.wecomOperation,
+    code: error.code,
+    providerCode: error.providerCode,
+    status: error.status,
+  };
+}