@xmanrui/dsh-im 4.36.1 → 4.38.0

package/src/channels/shared/harness-approval.mjs

@@ -19,6 +19,11 @@ const APPROVAL_UNAVAILABLE_TEXT = '机器人端无法处理这次审批，请到
 const APPROVAL_PROMPT = '请精准回复「批准」或「拒绝」（也支持：同意 / 不同意 / yes / no）。';
 const APPROVAL_AFTER_QUESTION_PROMPT = '请先完成当前问题，再精准回复「批准」或「拒绝」。';
 const APPROVAL_RESOLVED_TEXT = '该审批已处理，无需再次回复。';
+const APPROVAL_TIMEOUT_TEXT = '审批已超时，已自动拒绝此次操作。';
+const APPROVAL_TIMEOUT_UNCONFIRMED_TEXT = '审批已超时，正在自动拒绝，但暂未得到确认，稍后会自动重试。';
+const DEFAULT_APPROVAL_TIMEOUT_MS = 60 * 60_000;
+const EXPIRY_RETRY_BASE_MS = 30_000;
+const EXPIRY_RETRY_MAX_MS = 5 * 60_000;
 const RESOLVED_ROUTE_TTL_MS = 5 * 60_000;
 const MAX_RESOLVED_ROUTES = 2_048;
 
@@ -102,6 +107,7 @@ function approvalResult(pending, outcome) {
 }
 
 function approvalOutcomeText(outcome) {
+  if (outcome === 'expired') return t(APPROVAL_TIMEOUT_TEXT);
   if (outcome === 'unavailable') return t(APPROVAL_UNAVAILABLE_TEXT);
   if (outcome === 'allowed-once') return t('已批准，仅对本次操作有效。');
   if (outcome === 'rejected') return t('已拒绝此次操作。');
@@ -114,10 +120,14 @@ export class HarnessApprovalQueue {
   #byId = new Map();
   #routes = new Map();
   #resolvedRoutes = new Map();
+  #approvalTimeoutMs;
 
-  constructor({ label = 'IM', logger = console } = {}) {
+  constructor({ label = 'IM', logger = console, approvalTimeoutMs = DEFAULT_APPROVAL_TIMEOUT_MS } = {}) {
     this.#label = label;
     this.#logger = logger;
+    this.#approvalTimeoutMs = Number.isFinite(approvalTimeoutMs) && approvalTimeoutMs > 0
+      ? approvalTimeoutMs
+      : DEFAULT_APPROVAL_TIMEOUT_MS;
   }
 
   hasPending(key) {
@@ -184,6 +194,10 @@ export class HarnessApprovalQueue {
             }
             await pending.activationTask?.catch(() => undefined);
             await pending.presentationTask?.catch(() => undefined);
+            if (!pending.inactive && pending.expiring) {
+              await send(t(APPROVAL_TIMEOUT_UNCONFIRMED_TEXT));
+              return;
+            }
             if (pending.inactive || pending.resolving) {
               await send(t(APPROVAL_RESOLVED_TEXT));
               return;
@@ -338,11 +352,22 @@ export class HarnessApprovalQueue {
       closedOutcome: null,
       resolutionNotified: false,
       activationTask: null,
+      timeoutTimer: null,
+      expired: false,
+      expiring: false,
+      expiryAttempts: 0,
+      expiryNoticeSent: false,
     };
     this.#byId.set(approvalId, pending);
     const route = this.#routes.get(key) ?? { items: [] };
     route.items.push(pending);
     this.#routes.set(key, route);
+    pending.timeoutTimer = setTimeout(() => {
+      void this.#expire(pending).catch((error) => {
+        this.#logger.warn?.(`[dsh-im:${this.#label}] failed to expire an approval:`, error);
+      });
+    }, this.#approvalTimeoutMs);
+    pending.timeoutTimer.unref?.();
     if (route.items[0] === pending) await this.#present(pending);
     return true;
   }
@@ -377,13 +402,15 @@ export class HarnessApprovalQueue {
     const shouldNotify = pending.presented || presentationTask;
     const send = pending.send;
     const next = this.#remove(pending);
+    // The host reports our own timeout rejection as a plain rejection.
+    const outcome = pending.expiring && resolution.outcome === 'rejected' ? 'expired' : resolution.outcome;
     await this.#transition(next, async () => {
       let delivered = pending.presented;
       if (presentationTask) {
         delivered = await presentationTask.then(() => true, () => false);
       }
       if (shouldNotify && delivered) {
-        await this.#notifyResolved(pending, resolution.outcome, send);
+        await this.#notifyResolved(pending, outcome, send);
       }
     });
     return true;
@@ -453,6 +480,70 @@ export class HarnessApprovalQueue {
     }
   }
 
+  async #expire(pending) {
+    pending.timeoutTimer = null;
+    pending.expired = true;
+    // An in-flight decision wins; #submit expires the approval if it fails.
+    if (pending.inactive || pending.resolving || pending.submitting) return;
+    pending.resolving = true;
+    pending.expiring = true;
+    // Keep the route barrier: an earlier confirmation must finish before a
+    // later approval can be presented.
+    await pending.activationTask?.catch(() => undefined);
+    if (pending.inactive || this.#byId.get(pending.approvalId) !== pending) return;
+    await this.#releaseExpired(pending);
+  }
+
+  async #releaseExpired(pending) {
+    pending.timeoutTimer = null;
+    if (pending.inactive) return;
+    let outcome = 'expired';
+    try {
+      // Reject rather than withdraw: a withdrawal only retires the IM side and
+      // would leave a shared Web approval waiting without a bound.
+      await pending.interaction.respond(
+        approvalResult(pending, 'rejected'),
+        { signal: AbortSignal.timeout(5_000) },
+      );
+    } catch (error) {
+      if (error?.code !== 'interaction-not-pending') {
+        if (pending.inactive) return;
+        this.#logger.warn?.(`[dsh-im:${this.#label}] failed to release an expired approval:`, error);
+        this.#retryExpiry(pending);
+        if (!pending.expiryNoticeSent && pending.presented) {
+          pending.expiryNoticeSent = true;
+          await pending.send(t(APPROVAL_TIMEOUT_UNCONFIRMED_TEXT)).catch(() => undefined);
+        }
+        return;
+      }
+      outcome = 'resolved';
+    }
+    if (pending.inactive) return;
+    const presentationTask = pending.presentationTask;
+    const shouldNotify = pending.presented || presentationTask;
+    const send = pending.send;
+    const next = this.#remove(pending);
+    pending.closedOutcome = outcome;
+    await this.#transition(next, async () => {
+      let delivered = pending.presented;
+      if (presentationTask) {
+        delivered = await presentationTask.then(() => true, () => false);
+      }
+      if (shouldNotify && delivered) await this.#notifyResolved(pending, outcome, send);
+    });
+  }
+
+  #retryExpiry(pending) {
+    const delay = Math.min(EXPIRY_RETRY_BASE_MS * 2 ** pending.expiryAttempts, EXPIRY_RETRY_MAX_MS);
+    pending.expiryAttempts += 1;
+    pending.timeoutTimer = setTimeout(() => {
+      void this.#releaseExpired(pending).catch((error) => {
+        this.#logger.warn?.(`[dsh-im:${this.#label}] failed to expire an approval:`, error);
+      });
+    }, delay);
+    pending.timeoutTimer.unref?.();
+  }
+
   async #submit(pending, outcome) {
     pending.submitting = true;
     try {
@@ -478,6 +569,11 @@ export class HarnessApprovalQueue {
       if (pending.inactive) return;
       pending.submitting = false;
       this.#logger.error?.(`[dsh-im:${this.#label}] failed to submit an approval:`, error);
+      // The deadline passed while this decision was in flight.
+      if (pending.expired) {
+        await this.#expire(pending);
+        return;
+      }
       await pending.send(t('审批提交失败，请重新回复「批准」或「拒绝」。')).catch(() => undefined);
       return;
     }
@@ -536,6 +632,10 @@ export class HarnessApprovalQueue {
   #remove(pending) {
     if (pending.inactive) return null;
     pending.inactive = true;
+    if (pending.timeoutTimer) {
+      clearTimeout(pending.timeoutTimer);
+      pending.timeoutTimer = null;
+    }
     this.#rememberResolvedRoute(pending.key);
     this.#byId.delete(pending.approvalId);
     const route = this.#routes.get(pending.key);

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

@@ -259,10 +259,10 @@ export default {
     '/presetlist or /presets  List available Agent Presets',
   '🎮 任务控制': '🎮 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 [工作区]` 或 `/sessions [工作区]` — 列出会话\n`/sessionlist --limit N` 或 `/sessions --limit N` — 仅列出当前工作区前 N 个会话\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` 或 `/presets` — 列出预设\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]` or `/sessions [workspace]` — list sessions\n`/sessionlist --limit N` or `/sessions --limit N` — list only the first N sessions in the current workspace\n`/workspace <workspace index or absolute 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` or `/presets` — 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\n1. 会话下拉 — 切换当前绑定会话\n2. 工作区下拉 — 切换工作区\n3. 🤖 预设下拉 — 切换 Agent 预设\n4. 🧠 模型下拉 — 切换模型\n5. 🆕 新会话 — 开启全新会话\n6. 📋 会话/关注 — 查看/绑定会话，管理关注\n7. ⏹ 停止 — 停止当前任务\n8. 📐 压缩 — 压缩当前会话上下文\n9. 🧹 清空上下文 — 清空上下文并保留绑定和历史记录\n10. 补充指令 — 给 Agent 发送指令\n11. 🗄 归档切换 — 显示/隐藏归档会话\n12. 📊 状态 — 查看系统连接状态\n13. 📖 帮助 — 查看本帮助':
+    '**📋 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. 🧹 Clear context — clear context while keeping the binding and history\n10. Steer task — send an instruction to the Agent\n11. 🗄 Archived toggle — show or hide archived sessions\n12. 📊 Status — view connection status\n13. 📖 Help — view this help',
+  '**⌨️ 文本命令**\n\n`/m` — 打开菜单卡片\n`/new` — 开启全新会话\n`/session ID` — 绑定已有会话\n`/sessionlist [工作区]` 或 `/sessions [工作区]` — 列出会话\n`/sessionlist --limit N` 或 `/sessions --limit N` — 仅列出当前工作区前 N 个会话\n`/workspace 工作区序号或绝对路径` — 切换工作区\n`/workspacelist` — 列出工作区\n`/status` — 查看连接状态\n`/compact` — 压缩上下文\n`/clear` — 清空上下文并保留 Session 绑定和历史记录\n`/stop` — 停止当前任务\n`/steer 指令` — 补充指令\n`/watch ID` — 关注会话\n`/watchlist` — 关注列表\n`/unwatch ID` — 取消关注\n`/archived on/off` — 归档显隐\n`/presetlist` 或 `/presets` — 列出预设\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]` or `/sessions [workspace]` — list sessions\n`/sessionlist --limit N` or `/sessions --limit N` — list only the first N sessions in the current workspace\n`/workspace <workspace index or absolute path>` — switch workspace\n`/workspacelist` — list workspaces\n`/status` — view connection status\n`/compact` — compact context\n`/clear` — clear context while keeping the Session binding and history\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` or `/presets` — 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',
   '从下方下拉选择补充指令；最后一项可自定义输入。':
@@ -319,6 +319,8 @@ export default {
   '/watch ID 或序号  关注会话（完成后推送）':
     '/watch ID or index  Watch a session (push when done)',
   '/compact  压缩上下文': '/compact  Compact the context',
+  '🧹 清空上下文': '🧹 Clear context',
+  '清空当前会话上下文并保留绑定和历史记录': 'Clear the current session context while keeping the binding and history',
   '/workspace 绝对路径  切换工作区': '/workspace <absolute path>  Switch workspace',
   '/presetlist  列出可用 Agent Preset': '/presetlist  List available Agent Presets',
   '任务完成会自动推送，回复数字或点按钮取消关注：':

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

@@ -29,7 +29,8 @@ export default {
   '发送 /m 打开助手中心，点击按钮或回复当前列表的数字选择。': 'Send /m to open the assistant menu. Click a button or reply with a number from the current list.',
   '设置：会话、工作区、模式／预设、模型。': 'Settings: session, workspace, mode / preset, model.',
   '会话：新会话、会话列表、归档显示切换。': 'Sessions: new session, session list, show or hide archived sessions.',
-  '任务：停止、压缩、快捷或自定义补充指令。': 'Tasks: stop, compact, quick or custom steering instructions.',
+  '任务：停止、压缩、清空上下文、快捷或自定义补充指令。':
+    'Tasks: stop, compact, clear context, quick or custom steering instructions.',
   '信息：状态、帮助。': 'Information: status, help.',
   '菜单有效期为 15 分钟；发送普通消息会退出数字选择。': 'Menus expire after 15 minutes. Sending an ordinary message exits number selection.',
   '回答问题、审批和批量输入时，数字优先用于当前交互。': 'During questions, approvals and batch input, numbers belong to that interaction.',

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

@@ -244,6 +244,32 @@ export default {
   '当前 Harness 未注册 /compact 命令，请确认上下文压缩组件已启用。':
     'The current Harness has not registered the /compact command; please make sure the context compaction component is enabled.',
 
+  // clear-command.mjs
+  '/clear  清空当前会话上下文（保留 Session 绑定和历史记录）':
+    '/clear  Clear the current session context (keep the Session binding and history)',
+  '清空当前会话上下文并保留会话绑定':
+    'Clear the current session context and keep the Session binding',
+  '用法：/clear（不带参数且不可附带图片或文件）':
+    'Usage: /clear (no arguments, images or files)',
+  '当前聊天绑定的会话已不存在，未清空上下文；请先发送新消息开启会话。':
+    'The Session bound to this chat no longer exists; the context was not cleared. Send a new message to start a Session first.',
+  '当前会话正在生成回复或等待交互，请先完成交互或发送 /stop，再执行 /clear。':
+    'The current Session is generating a reply or waiting for an interaction. Finish it or send /stop before running /clear.',
+  '上下文清理已取消，当前会话未修改。':
+    'Context clearing was cancelled; the current Session was not changed.',
+  '工作区或机器人状态已发生变化，未清空当前会话，请重试。':
+    'The workspace or bot state changed, so the current Session was not cleared. Please try again.',
+  '当前 Host 不支持 /clear，当前会话未修改。':
+    'The current Host does not support /clear; the current Session was not changed.',
+  '清空当前会话上下文失败，当前会话未修改，请稍后重试。':
+    'Failed to clear the current Session context; the Session was not changed. Please try again later.',
+  '当前机器人没有可用的会话状态，未清空当前会话。':
+    'This bot has no available Session state; the current Session was not cleared.',
+  '当前聊天还没有可清空的会话，请先发送一条消息。':
+    'This chat has no Session to clear yet; please send a message first.',
+  '当前会话上下文已清空；Session 绑定和历史记录仍保留。':
+    'The current Session context was cleared; its binding and history were retained.',
+
   // control-command.mjs
   '用法：/stop（不带参数）': 'Usage: /stop (no arguments)',
   '用法：/version（不带参数）': 'Usage: /version (no arguments)',
@@ -258,6 +284,7 @@ export default {
     'No session is bound to this chat, so an additional instruction cannot be given. Bind a session first.',
   '任务已结束，没有正在运行的任务，无法补充指令。请直接发送消息开始新任务。':
     'The task has ended and there is no running task to steer. Send a message to start a new task.',
+  '已排队，等待前序消息处理。': 'Queued. Waiting for the preceding messages to finish.',
   '已提交补充指令，Agent 会在下一步读取。':
     'Additional instruction submitted; the Agent will read it at the next step.',
 };

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

@@ -56,6 +56,10 @@ export default {
     'Please finish the current question first, then reply exactly with 「批准」 (approve) or 「拒绝」 (reject).',
   '该审批已处理，无需再次回复。':
     'This approval has already been handled; no need to reply again.',
+  '审批已超时，已自动拒绝此次操作。':
+    'This approval timed out and the operation was rejected automatically.',
+  '审批已超时，正在自动拒绝，但暂未得到确认，稍后会自动重试。':
+    'This approval timed out. Automatic rejection has not been confirmed yet and will be retried shortly.',
   'DeepSeek Harness 需要你的审批：':
     'DeepSeek Harness needs your approval:',
   '工具：{tool}': 'Tool: {tool}',

package/src/channels/shared/message-mode.mjs

@@ -0,0 +1,19 @@
+export const SET_MESSAGE_MODE_ENDPOINT = 'bot.message-mode.set';
+
+export function normalizeBusyMessageMode(value) {
+  return value === 'steer' ? 'steer' : 'queue';
+}
+
+export function validateBusyMessageMode(value) {
+  if (value !== 'queue' && value !== 'steer') {
+    throw new TypeError('Message mode must be queue or steer');
+  }
+  return value;
+}
+
+export function validMessageModePayload(payload) {
+  return payload !== null && typeof payload === 'object' && !Array.isArray(payload)
+    && Object.keys(payload).length === 2
+    && typeof payload.botId === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(payload.botId)
+    && (payload.busyMessageMode === 'queue' || payload.busyMessageMode === 'steer');
+}

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

@@ -1,3 +1,4 @@
+import { BusyMessageDispatcher, canAutomaticallySteer } from './busy-message-dispatcher.mjs';
 import { randomUUID } from 'node:crypto';
 
 import { createDeferredDeliveryCoordinator, deferredOutcomeText } from './deferred-delivery-coordinator.mjs';
@@ -14,6 +15,7 @@ import {
 } from './context-enhancement.mjs';
 import { runWorkspaceCommand } from './workspace-command.mjs';
 import { runCompactCommand } from './compact-command.mjs';
+import { isClearCommand, runClearCommand } from './clear-command.mjs';
 import { isHistoryCommand, runHistoryCommand } from './history-command.mjs';
 import {
   isControlCommand,
@@ -178,6 +180,7 @@ export class TextHarnessBridge {
   #signal;
   #keepaliveIntervalMs;
   #queues = new Map();
+  #busyMessages = new BusyMessageDispatcher();
   #pendingInteractions = new Map();
   #interactionKeys = new Map();
   // Keep the accepted configuration through the existing queue/reply lifecycle.
@@ -236,7 +239,7 @@ export class TextHarnessBridge {
     return structuredClone(this.#status);
   }
 
-  accept(message, { contextSnapshot, accessDecision } = {}) {
+  accept(message, { contextSnapshot, accessDecision, busyMessageMode } = {}) {
     if (this.#signal?.aborted) return Promise.resolve();
     const conversationId = cleanText(message?.conversationId);
     const kind = message?.kind === 'group' ? 'group' : 'direct';
@@ -300,7 +303,7 @@ export class TextHarnessBridge {
     });
     normalized.statusReaction = statusReaction;
 
-    const processing = this.#acceptAcceptedMessage(normalized, messageId, senderId);
+    const processing = this.#acceptAcceptedMessage(normalized, messageId, senderId, busyMessageMode);
     void processing.then(
       () => statusReaction.success(),
       () => statusReaction.error(),
@@ -308,7 +311,7 @@ export class TextHarnessBridge {
     return processing;
   }
 
-  #acceptAcceptedMessage(normalized, messageId, senderId) {
+  #acceptAcceptedMessage(normalized, messageId, senderId, busyMessageMode) {
     if (normalized.kind === 'direct') {
       rememberConnectionTestTarget(
         this.#state,
@@ -319,6 +322,18 @@ export class TextHarnessBridge {
     const key = `${normalized.kind}:${normalized.conversationId}`;
     const pending = this.#pendingInteractions.get(key);
     const text = controlTextOf(normalized);
+    if (isClearCommand(text) && (
+      this.#queues.has(key)
+      || pending
+      || this.#approvals.hasPending(key)
+      || this.#batches.status(key).phase !== 'idle'
+    )) {
+      return this.#finishLocalMessage(
+        normalized,
+        messageId,
+        t('当前会话正在生成回复或等待交互，请先完成交互或发送 /stop，再执行 /clear。'),
+      );
+    }
     const batchCommand = isBatchInputCommand(text);
     if (batchCommand && normalized.kind === 'group' && normalized.addressed === true) {
       return this.#finishLocalMessage(
@@ -373,7 +388,8 @@ export class TextHarnessBridge {
     }
     const collectingBatch = normalized.kind === 'direct'
       && this.#batches.status(key).phase === 'collecting';
-    const commandRunner = collectingBatch ? null : isHistoryCommand(text) ? runHistoryCommand
+    const commandRunner = collectingBatch ? null : isClearCommand(text) ? runClearCommand
+      : isHistoryCommand(text) ? runHistoryCommand
       : hasInboundFiles(normalized) ? null : isControlCommand(text)
       ? runControlCommand
       : (isModelCommand(text)
@@ -458,7 +474,33 @@ export class TextHarnessBridge {
       pending.queue = current;
       return current;
     }
-    return this.#enqueueMessage(normalized, messageId, senderId, key);
+    return this.#busyMessages.dispatch({
+      key, messageId, text: normalized.content,
+      commandText: text, mode: busyMessageMode,
+      onFailure: (error) => this.#signal?.aborted || error?.code === 'turn-stopped'
+        ? normalized.statusReaction?.clear() : normalized.statusReaction?.error(),
+      eligible: () => normalized.plainText !== false
+        && !hasInboundImages(normalized) && !hasInboundFiles(normalized)
+        && !hasReplyReference(normalized)
+        && canAutomaticallySteer(this.#accessPolicy, normalized.kind,
+          [senderId, normalized.senderAlternateId].filter(Boolean)),
+      harness: this.#harness, state: this.#state, status: this.#status,
+      signal: this.#signal, control: { owner: this, key }, logger: this.#logger,
+      acceptedMessageIds: this.#acceptedMessageIds,
+      pendingInteraction: () => this.#pendingInteractions.has(key) || this.#approvals.hasPending(key),
+      enhancement: {
+        snapshot: this.#acceptedMessageIds.get(messageId),
+        source: () => {
+          const source = normalized.contextSource?.();
+          return { channel: this.#descriptor.key, senderId, senderName: source?.senderName,
+            conversationTitle: source?.conversationTitle,
+            chatId: source?.chatId ?? normalized.conversationId, threadId: source?.threadId };
+        },
+      },
+      isQueued: () => this.#queues.has(key),
+      enqueue: (options) => this.#enqueueMessage(normalized, messageId, senderId, key, options),
+      send: (reply) => this.#bot.sendText(normalized.replyTarget, reply),
+    });
   }
 
   #finishLocalMessage(message, messageId, reply, { recordReceived = true } = {}) {
@@ -522,6 +564,7 @@ export class TextHarnessBridge {
   }
 
   async waitForIdle() {
+    await this.#busyMessages.whenIdle();
     await Promise.allSettled([
       ...this.#queues.values(),
       ...[...this.#pendingInteractions.values()].flatMap((pending) => (

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

@@ -1,3 +1,4 @@
+import { BusyMessageDispatcher, canAutomaticallySteer } from '../shared/busy-message-dispatcher.mjs';
 import { imageInputLimits } from '../shared/image-input-policy.mjs';
 import { imageDownloadLimitMessage } from '../shared/image-prompt.mjs';
 import { createDeferredDeliveryCoordinator, deferredOutcomeText } from '../shared/deferred-delivery-coordinator.mjs';
@@ -20,6 +21,7 @@ import {
   isBatchInputCommand,
 } from '../shared/batch-input.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
+import { isClearCommand, runClearCommand } from '../shared/clear-command.mjs';
 import { isHistoryCommand, runHistoryCommand } from '../shared/history-command.mjs';
 import {
   isControlCommand,
@@ -82,6 +84,7 @@ function helpText() {
     t('/menu 或 /m  打开可点击的功能菜单'),
     t('/new  开启一个全新会话'),
     t('/compact  压缩当前会话的较早上下文'),
+    t('/clear  清空当前会话上下文（保留 Session 绑定和历史记录）'),
     t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
     t('/workspace 工作区序号或绝对路径  切换工作区'),
     t('/workspacelist  列出工作区绝对路径'),
@@ -565,6 +568,7 @@ export class WecomHarnessBridge {
   #signal;
   #fileUploadTimeoutMs;
   #queues = new Map();
+  #busyMessages = new BusyMessageDispatcher();
   #pendingInteractions = new Map();
   #interactionKeys = new Map();
   // Keep the accepted configuration through the existing queue/reply lifecycle.
@@ -870,6 +874,7 @@ export class WecomHarnessBridge {
       return { message: t('已开启新会话。请发送你的问题。') };
     }
     return await runWorkspaceCommand(text, this.#harness, key)
+      ?? await runClearCommand(text, this.#harness, this.#state, key, options)
       ?? await runCompactCommand(text, this.#harness, this.#state, key, options);
   }
 
@@ -951,7 +956,8 @@ export class WecomHarnessBridge {
     const menuCommand = !hasInboundImages(commandMessage) && !hasInboundFiles(commandMessage)
       && (parseWecomMenu(commandText) || ['/help', '/status', '/new'].includes(commandText.toLowerCase())
         || this.#cardFrames.has(frame));
-    const commandRunner = isHistoryCommand(commandText) ? runHistoryCommand
+    const commandRunner = isClearCommand(commandText) ? runClearCommand
+      : isHistoryCommand(commandText) ? runHistoryCommand
       : hasInboundFiles(commandMessage) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
@@ -1048,7 +1054,23 @@ export class WecomHarnessBridge {
       pending.queue = current;
       return current;
     }
-    return this.#enqueueMessage(frame, messageId, key);
+    return this.#busyMessages.dispatch({
+      key, messageId, text: commandText,
+      eligible: () => isNativeWecomText(frame) && !hasReplyReference(commandMessage)
+        && !parseWecomMenu(commandText) && !this.#cardFrames.has(frame)
+        && canAutomaticallySteer(this.#accessPolicy, conversationType, senderId),
+      harness: this.#harness, state: this.#state, status: this.#status,
+      signal: this.#signal, control: { owner: this, key }, logger: this.#logger,
+      acceptedMessageIds: this.#acceptedMessageIds,
+      pendingInteraction: () => this.#pendingInteractions.has(key) || this.#approvals.hasPending(key),
+      enhancement: {
+        snapshot: this.#acceptedMessageIds.get(messageId),
+        source: () => ({ channel: 'wecom', senderId, chatId }),
+      },
+      isQueued: () => this.#queues.has(key),
+      enqueue: (options) => this.#enqueueMessage(frame, messageId, key, options),
+      send: (reply) => this.#sendImmediate(frame, chatId, reply),
+    });
   }
 
   #enqueueMessage(frame, messageId, key, {
@@ -1151,6 +1173,7 @@ export class WecomHarnessBridge {
   }
 
   async waitForIdle() {
+    await this.#busyMessages.whenIdle();
     await Promise.allSettled([
       ...this.#queues.values(),
       ...[...this.#pendingInteractions.values()].flatMap((pending) => (
@@ -1176,6 +1199,7 @@ export class WecomHarnessBridge {
       hasFiles: hasInboundFiles(message),
       pendingInteraction: this.#pendingInteractions.has(key)
         || this.#approvals.hasPending(key),
+      busy: this.#queues.has(key) || this.#batchInputs.status(key).phase !== 'idle',
       control: { owner: this, key },
       deferredDelivery: this.#deferred,
       enhancement: captureContextEnhancementSource(

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

@@ -48,7 +48,7 @@ export function wecomMenu({ workspace, workspaces = [] } = {}) {
     entries: [
       [t('切换工作区'), 'select:workspace'],
       [t('🆕 新会话'), '/new'],
-      [t('⏹ 停止'), '/stop'], [t('📐 压缩'), '/compact'],
+      [t('⏹ 停止'), '/stop'], [t('📐 压缩'), '/compact'], [t('🧹 清空上下文'), '/clear'],
       [t('📊 状态'), '/status'], [t('📖 帮助'), '/help'],
     ],
   };

package/src/channels/wecom-app/wecom-app-bridge.mjs

@@ -1,3 +1,4 @@
+import { BusyMessageDispatcher, canAutomaticallySteer } from '../shared/busy-message-dispatcher.mjs';
 import { createDeferredDeliveryCoordinator, deferredOutcomeText } from '../shared/deferred-delivery-coordinator.mjs';
 import {
   harnessAnswerForQuestion,
@@ -11,6 +12,7 @@ import {
   isBatchInputCommand,
 } from '../shared/batch-input.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
+import { isClearCommand, runClearCommand } from '../shared/clear-command.mjs';
 import { isHistoryCommand, runHistoryCommand } from '../shared/history-command.mjs';
 import {
   isControlCommand,
@@ -75,6 +77,7 @@ const HELP_TEXT = () => [
   t('直接发送文字或图片即可继续当前会话。'),
   t('/new  开启一个全新会话'),
   t('/compact  压缩当前会话的较早上下文'),
+  t('/clear  清空当前会话上下文（保留 Session 绑定和历史记录）'),
   t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
   t('/workspace 工作区序号或绝对路径  切换工作区'),
   t('/workspacelist  列出工作区绝对路径'),
@@ -202,6 +205,7 @@ export class WecomAppBridge {
   #streamRegistry;
   #maxChunkBytes;
   #queues = new Map();
+  #busyMessages = new BusyMessageDispatcher();
   #acceptedMessageIds = new Map();
   #commandTasks = new Set();
   #approvalTasks = new Set();
@@ -311,7 +315,8 @@ export class WecomAppBridge {
         return this.#finishBatchResult(messageId, key, sender, result);
       }
     }
-    const commandRunner = isHistoryCommand(commandText) ? runHistoryCommand
+    const commandRunner = isClearCommand(commandText) ? runClearCommand
+      : isHistoryCommand(commandText) ? runHistoryCommand
       : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
@@ -385,7 +390,24 @@ export class WecomAppBridge {
       pending.queue = current;
       return current;
     }
-    return this.#enqueueMessage(message, messageId, key, { sink });
+    return this.#busyMessages.dispatch({
+      key, messageId, text: commandText,
+      eligible: () => message.msgtype === 'text' && !hasImages
+        && !hasReplyReference(wecomAppInboundMessage(message, this.#api))
+        && canAutomaticallySteer(this.#accessPolicy, 'direct', sender),
+      harness: this.#harness, state: this.#state, status: this.#status,
+      signal: this.#signal, control: { owner: this, key }, logger: this.#logger,
+      acceptedMessageIds: this.#acceptedMessageIds,
+      pendingInteraction: () => this.#pendingInteractions.has(key) || this.#approvals.hasPending(key),
+      enhancement: {
+        snapshot: this.#acceptedMessageIds.get(messageId),
+        source: () => ({ channel: 'wecom-app', senderId: sender, chatId: sender }),
+      },
+      isQueued: () => this.#queues.has(key),
+      enqueue: (options) => this.#enqueueMessage(message, messageId, key, { ...options, sink }),
+      send: (reply) => this.#send(sender, reply),
+      onError: (error) => this.#handleInteractionFailure(message, messageId, error),
+    });
   }
 
   #enqueueMessage(message, messageId, key, {
@@ -472,6 +494,7 @@ export class WecomAppBridge {
   }
 
   async waitForIdle() {
+    await this.#busyMessages.whenIdle();
     await Promise.allSettled([
       ...this.#queues.values(),
       ...[...this.#pendingInteractions.values()].flatMap((pending) => (
@@ -501,6 +524,7 @@ export class WecomAppBridge {
       hasFiles: false,
       pendingInteraction: this.#pendingInteractions.has(key)
         || this.#approvals.hasPending(key),
+      busy: this.#queues.has(key) || this.#batchInputs.status(key).phase !== 'idle',
       control: { owner: this, key },
       deferredDelivery: this.#deferred,
       enhancement: captureContextEnhancementSource(