@xmanrui/dsh-im 4.36.1 → 4.38.0

package/src/channels/feishu/bridge.mjs

@@ -1,3 +1,4 @@
+import { BusyMessageDispatcher, canAutomaticallySteer } from '../shared/busy-message-dispatcher.mjs';
 import { isPermissionCommand, runPermissionCommand } from '../shared/permission-command.mjs';
 import { randomUUID } from 'node:crypto';
 import QRCode from 'qrcode';
@@ -43,6 +44,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,
@@ -120,6 +122,7 @@ import {
 import {
   FEISHU_STEP_PUSH_MODES,
   normalizeFeishuStepPushMode,
+  normalizeFeishuStepCardPanels,
 } from './step-push-mode.mjs';
 import { FeishuLiveCot } from './live-cot.mjs';
 
@@ -178,7 +181,7 @@ const REPAIR_URL_HOSTS = new Set([
 
 const ARCHIVED_COMMAND = /^\/archived(?:\s+(on|off))?$/i;
 /** Matches fast card commands that should not be queued behind a running task. */
-const CARD_COMMAND = /^\/(?:m(?:enu)?|new|help|status|compact|(?:sessionlist|sessions)(?:\s|$)|workspacelist|workspaces|wsl|watchlist|archived(?:\s+(on|off))?)$/i;
+const CARD_COMMAND = /^\/(?:m(?:enu)?|new|help|status|compact|clear|(?:sessionlist|sessions)(?:\s|$)|workspacelist|workspaces|wsl|watchlist|archived(?:\s+(on|off))?)$/i;
 
 // ── Step push (分步直推) limits ──────────────────────────────────────────────
 /** Feishu allows 5 msg/s per chat; step push stays well below that. */
@@ -617,6 +620,7 @@ export class FeishuHarnessBridge {
   #contextEnhancement;
   #accessPolicy;
   #queues = new Map();
+  #busyMessages = new BusyMessageDispatcher();
   #batchInputs = new BatchInputManager();
   #pendingInteractions = new Map();
   #interactionKeys = new Map();
@@ -677,6 +681,7 @@ export class FeishuHarnessBridge {
   #stepPush = false;
   /** Step push presentation: discrete posts, a CardKit card, or native live CoT. */
   #stepPushMode = FEISHU_STEP_PUSH_MODES.POST;
+  #stepCardPanels;
   /** Per-conversation step push state: key → { lastSentAt, count, breakerLogged }. */
   #stepPushSendState = new Map();
   /** Live streaming step cards: key → per-turn card state (streaming_card mode). */
@@ -742,6 +747,7 @@ export class FeishuHarnessBridge {
     mentionTopicReply = true,
     stepPush = false,
     stepPushMode = FEISHU_STEP_PUSH_MODES.POST,
+    stepCardPanels,
     stepPushClock = null,
     repair,
     repairPollIntervalMs = REPAIR_POLL_INTERVAL_MS,
@@ -802,6 +808,7 @@ export class FeishuHarnessBridge {
     this.#mentionTopicReply = mentionTopicReply !== false;
     this.#stepPush = stepPush === true;
     this.#stepPushMode = normalizeFeishuStepPushMode(stepPushMode);
+    this.#stepCardPanels = normalizeFeishuStepCardPanels(stepCardPanels);
     this.#stepPushClock = stepPushClock ?? DEFAULT_STEP_PUSH_CLOCK;
     this.#voice = voice ?? null;
     this.#repair = repair ?? null;
@@ -898,6 +905,10 @@ export class FeishuHarnessBridge {
     this.#stepPushMode = normalizeFeishuStepPushMode(value);
   }
 
+  setStepCardPanels(value) {
+    this.#stepCardPanels = normalizeFeishuStepCardPanels(value);
+  }
+
   setVoice(voice) {
     this.#voice = voice ?? null;
   }
@@ -1388,7 +1399,27 @@ export class FeishuHarnessBridge {
       this.#interactionTasks.add(current);
       return current;
     }
-    return this.#enqueueMessage(event, messageId, key, processingReaction);
+    return this.#busyMessages.dispatch({
+      key, messageId, text: commandText,
+      eligible: () => event.message.message_type === 'text' && !hasImages && !hasFiles
+        && !hasReplyReference(commandMessage) && !isFeishuLocalCommand(commandText)
+        && !(NUMBER_REPLY.test(commandText) && this.#menus.has(key))
+        && canAutomaticallySteer(this.#accessPolicy, conversationType, senderOpenId(event)),
+      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: 'feishu', senderId: senderOpenId(event),
+          chatId: event.message.chat_id, threadId: event.message.thread_id }),
+      },
+      isQueued: () => this.#queues.has(key),
+      enqueue: (options) => this.#enqueueMessage(event, messageId, key, processingReaction, options),
+      send: (reply) => this.#send(event.message.chat_id, reply, { replyTo: messageId }),
+      onSteered: () => this.#finishReaction(messageId, processingReaction, 'DONE'),
+      onError: (error) => this.#handleMessageFailure(event, messageId, processingReaction, error),
+    });
   }
 
   #finishBatchResult(event, messageId, processingReaction, result) {
@@ -1545,6 +1576,7 @@ export class FeishuHarnessBridge {
   }
 
   async waitForIdle() {
+    await this.#busyMessages.whenIdle();
     // Drain to a fixed point: awaited work can register compensation or
     // another serialized tail before it settles.
     for (;;) {
@@ -1600,6 +1632,7 @@ export class FeishuHarnessBridge {
         deferredDelivery: this.#deferred,
         hasFiles: hasInboundFiles(message),
         pendingInteraction: this.#hasPendingInteraction(key),
+        busy: this.#queues.has(key),
         control: { owner: this, key },
         enhancement: captureContextEnhancementSource(
           this.#contextEnhancement,
@@ -1691,7 +1724,8 @@ export class FeishuHarnessBridge {
     // 命令识别对 text 与纯文本 post 一视同仁：post 富文本若仅含单个
     // 文本段落（如复制粘贴的 /new），同样按命令处理；带图片/文件不认。
     // accept() 侧已用 nonEmptyString(content) 判定，两侧保持一致。
-    const commandText = !hasImages && !hasFiles && text ? text.trim() : null;
+    const rawCommandText = text ? text.trim() : '';
+    const commandText = !hasImages && !hasFiles && text ? rawCommandText : null;
     if (!text && !hasImages && !hasFiles && !hasReply) {
       // An "@bot" with nothing else carries no instruction to parse, and the
       // menu card is what the reader is reaching for — answer it the way `/m`
@@ -1751,6 +1785,19 @@ export class FeishuHarnessBridge {
       }
       return;
     }
+    if (isClearCommand(rawCommandText)) {
+      const clearCommand = await runClearCommand(rawCommandText, this.#harness, this.#state, key, {
+        signal: this.#signal,
+        hasImages,
+        hasFiles,
+        pendingInteraction: this.#hasPendingInteraction(key),
+        busy: this.#queues.has(key),
+      });
+      if (clearCommand) {
+        await this.#send(event.message.chat_id, clearCommand.message, { replyTo: event.message.message_id });
+      }
+      return;
+    }
     if (SESSION_LIST_PREFIX.test(commandText)) {
       const argument = commandText.replace(/^\/(?:sessionlist|sessions)/i, '').trim();
       const request = parseSessionListArgument(argument);
@@ -2551,6 +2598,7 @@ export class FeishuHarnessBridge {
     actor = null,
     menuContext = null,
     newSessionActionId = null,
+    fromMessageQueue = false,
   }) {
     // Confirmations triggered by a card interaction stay anchored to the
     // card's message so they land inside the same Feishu topic.
@@ -2704,7 +2752,9 @@ export class FeishuHarnessBridge {
         await this.#handleNewSessionMenu({ key, chatId, messageId, menuContext, newSessionActionId });
         return;
       }
-      if (this.#queues.has(key) || this.#hasPendingInteraction(key)) {
+      // A queued menu pick runs after earlier messages; its own unfinished
+      // queue (including later messages) must not prevent the reset.
+      if ((!fromMessageQueue && this.#queues.has(key)) || this.#hasPendingInteraction(key)) {
         await reply(t('当前任务仍在运行，请先停止任务或等待任务完成后再开启新会话。'));
         return;
       }
@@ -2739,6 +2789,10 @@ export class FeishuHarnessBridge {
       await this.#handleCompact(key, chatId, messageId);
       return;
     }
+    if (action === 'clear') {
+      await this.#handleClear(key, chatId, messageId);
+      return;
+    }
     if (action === 'stop') {
       await this.#handleStop(key, chatId, messageId);
       return;
@@ -2927,7 +2981,9 @@ export class FeishuHarnessBridge {
         await this.#handleRepairCommand(event, '/repair');
         return;
       }
-      await this.#handleCardAction(action, { chatId, key, messageId: replyTo });
+      await this.#handleCardAction(action, {
+        chatId, key, messageId: replyTo, fromMessageQueue: action === 'new',
+      });
       return;
     }
     if (menu.kind === 'sessions') {
@@ -3509,6 +3565,22 @@ export class FeishuHarnessBridge {
     }
   }
 
+  /** Run /clear while retaining the current Session binding. */
+  async #handleClear(key, chatId, replyTo = null) {
+    try {
+      const result = await runClearCommand(
+        '/clear', this.#harness, this.#state, key, {
+          signal: this.#signal,
+          pendingInteraction: this.#hasPendingInteraction(key),
+          busy: this.#queues.has(key),
+        },
+      );
+      await this.#send(chatId, result?.message || t('清空当前会话上下文失败，当前会话未修改，请稍后重试。'), { replyTo });
+    } catch (error) {
+      await this.#sendFailure(chatId, error, { logLabel: 'clear', replyTo });
+    }
+  }
+
   /**
    * Stop the running task in the bound session (mirrors `/stop`).
    */
@@ -4781,7 +4853,7 @@ export class FeishuHarnessBridge {
    * their lifecycle is owned by the ask path, not the mirror recovery.
    * lastContent keeps stepStreamCard's raw JSON string (single-encoded).
    */
-  async #persistMirrorState(card, liveBlocks, status) {
+  async #persistMirrorState(card, liveBlocks, status, stepCardPanels) {
     const sessionId = card.sessionSyncSessionId;
     if (!sessionId || typeof this.#state.setMirror !== 'function') return;
     await this.#state.setMirror(card.sessionSyncKey, {
@@ -4789,7 +4861,7 @@ export class FeishuHarnessBridge {
       chatId: card.chatId,
       cardIds: [...card.cardIds],
       claimedAt: Date.now(),
-      lastContent: stepStreamCard(liveBlocks, { status }),
+      lastContent: stepStreamCard(liveBlocks, { status, stepCardPanels }),
       blocks: structuredClone(card.blocks), answerStart: card.answerStart, answerEnd: card.answerEnd,
       lastSeq: this.#sessionSyncTurns.get(card.sessionSyncKey)?.lastSeq ?? -1,
       pendingStep: this.#sessionSyncTurns.get(card.sessionSyncKey)?.pendingStep ?? null,
@@ -4797,7 +4869,7 @@ export class FeishuHarnessBridge {
   }
 
   /** Sync only this interaction's cards; earlier interactions remain sealed. */
-  async #syncStepCardChunks(card, chunks, status) {
+  async #syncStepCardChunks(card, chunks, status, stepCardPanels) {
     const answerVersion = card.answerVersion ?? 0;
     const activeIds = card.cardIds.slice(card.activeCardStart);
     const groups = chunks.length ? [...chunks] : [[]];
@@ -4810,6 +4882,7 @@ export class FeishuHarnessBridge {
     // payload halfway through this render or be marked as already delivered.
     const contents = groups.map((blocks, index) => stepStreamCard(blocks, {
       status: index === groups.length - 1 ? status : 'sealed',
+      stepCardPanels,
     }));
     for (let index = 0; index < contents.length; index += 1) {
       let id = activeIds[index];
@@ -4834,12 +4907,13 @@ export class FeishuHarnessBridge {
 
   async #renderStepCardNow(chatId, card) {
     if (card.broken) return;
-    const chunks = splitStepStreamCardBlocks(card.blocks);
+    const stepCardPanels = this.#stepCardPanels;
+    const chunks = splitStepStreamCardBlocks(card.blocks, undefined, undefined, stepCardPanels);
     if (!chunks.length && card.messageId === null) return;
     const live = chunks[chunks.length - 1] ?? [];
     try {
-      await this.#syncStepCardChunks(card, chunks, 'running');
-      await this.#persistMirrorState(card, live, 'running');
+      await this.#syncStepCardChunks(card, chunks, 'running', stepCardPanels);
+      await this.#persistMirrorState(card, live, 'running', stepCardPanels);
       card.lastRenderAt = this.#stepPushClock.now();
     } catch (error) {
       card.broken = true;
@@ -4879,9 +4953,10 @@ export class FeishuHarnessBridge {
     if (body.trim()) {
       this.#writeStepCardAnswer(card, body);
     }
-    const chunks = splitStepStreamCardBlocks(card.blocks);
+    const stepCardPanels = this.#stepCardPanels;
+    const chunks = splitStepStreamCardBlocks(card.blocks, undefined, undefined, stepCardPanels);
     try {
-      await this.#syncStepCardChunks(card, chunks, status);
+      await this.#syncStepCardChunks(card, chunks, status, stepCardPanels);
       return { ok: true, cardIds: card.cardIds };
     } catch (error) {
       // Only trust the streamed draft when the LAST SUCCESSFUL render actually
@@ -4932,8 +5007,9 @@ export class FeishuHarnessBridge {
     if (card.broken) return;
     if (card.messageId === null) return;
     try {
-      const chunks = splitStepStreamCardBlocks(card.blocks);
-      await this.#syncStepCardChunks(card, chunks, 'sealed');
+      const stepCardPanels = this.#stepCardPanels;
+      const chunks = splitStepStreamCardBlocks(card.blocks, undefined, undefined, stepCardPanels);
+      await this.#syncStepCardChunks(card, chunks, 'sealed', stepCardPanels);
     } catch (error) {
       this.#logger.warn?.(
         '[dsh-feishu] step streaming card rotate seal failed:',

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

@@ -16,6 +16,7 @@
 
 import { posix, win32 } from 'node:path';
 import { t } from '../shared/i18n.mjs';
+import { normalizeFeishuStepCardPanels } from './step-push-mode.mjs';
 
 export const MENU_PAGE_SIZE = 10;
 
@@ -353,6 +354,7 @@ export function menuCard(ctx) {
   // ── 任务控制（对运行中任务的操作）────────────────────────
   elements.push({ tag: 'div', text: markdown(t('**任务控制**')) });
   elements.push(buttonPair(t('⏹ 停止'), 'stop', t('📐 压缩'), 'compact'));
+  elements.push(button(t('🧹 清空上下文'), 'clear'));
   elements.push({ tag: 'hr' });
 
   // ── 补充指令 + 归档切换（并列）────────────────────────────
@@ -573,6 +575,7 @@ export function menuHelpText() {
     '/status  连接状态',
     '/version  查看插件版本',
     '/compact  压缩当前会话上下文',
+    '/clear  清空当前会话上下文（保留 Session 绑定和历史记录）',
     '/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）',
     '/archived on/off  会话列表显示/隐藏归档',
     '',
@@ -620,10 +623,11 @@ const HELP_CARD_FEATURES = [
   '6. 📋 会话/关注 — 查看/绑定会话，管理关注',
   '7. ⏹ 停止 — 停止当前任务',
   '8. 📐 压缩 — 压缩当前会话上下文',
-  '9. 补充指令 — 给 Agent 发送指令',
-  '10. 🗄 归档切换 — 显示/隐藏归档会话',
-  '11. 📊 状态 — 查看系统连接状态',
-  '12. 📖 帮助 — 查看本帮助',
+  '9. 🧹 清空上下文 — 清空上下文并保留绑定和历史记录',
+  '10. 补充指令 — 给 Agent 发送指令',
+  '11. 🗄 归档切换 — 显示/隐藏归档会话',
+  '12. 📊 状态 — 查看系统连接状态',
+  '13. 📖 帮助 — 查看本帮助',
 ].join('\n');
 
 const HELP_TEXT_COMMANDS = [
@@ -638,6 +642,7 @@ const HELP_TEXT_COMMANDS = [
   '`/workspacelist` — 列出工作区',
   '`/status` — 查看连接状态',
   '`/compact` — 压缩上下文',
+  '`/clear` — 清空上下文并保留 Session 绑定和历史记录',
   '`/stop` — 停止当前任务',
   '`/steer 指令` — 补充指令',
   '`/watch ID` — 关注会话',
@@ -996,15 +1001,16 @@ export const STEP_STREAM_CARD_MAX_BYTES = 24_000;
  * Build one streaming step card from the accumulated process blocks:
  *   { kind: 'message', text }         — interim note / warning / context line
  *   { kind: 'tools', lines: string[] } — tool-call summary panel
- * `status`: 'running' keeps panels expanded and ends with an italic status
+ * `status`: 'running' uses the configured panel expansion and ends with an italic status
  * line; 'completed' / 'stopped' collapse the panels and swap the status text;
  * 'sealed' is an overflow spill chunk with no status line at all. Finished
  * turns (and sealed spill chunks) merge every tool/thinking panel into one
  * collapsed "process details" panel so the sealed card stays compact.
  */
 
-export function stepStreamCard(rawBlocks, { status = 'running' } = {}) {
+export function stepStreamCard(rawBlocks, { status = 'running', stepCardPanels } = {}) {
   const running = status === 'running';
+  const panels = normalizeFeishuStepCardPanels(stepCardPanels);
   const elements = [];
   const panelElements = [];
   for (const block of Array.isArray(rawBlocks) ? rawBlocks : []) {
@@ -1017,10 +1023,8 @@ export function stepStreamCard(rawBlocks, { status = 'running' } = {}) {
         title: block.kind === 'tools'
           ? t('🛠️ 工具摘要（{count}）', { count })
           : t('💭 思考过程（{count}）', { count }),
-        // Tool summaries stay visible while the turn runs; thinking notes
-        // remain folded at all times. Finished turns keep both panels but
-        // tuck them inside one collapsed "process details" wrapper.
-        expanded: block.kind === 'tools' && running,
+        // Finished turns keep both panels inside the collapsed details wrapper.
+        expanded: running && (block.kind === 'tools' ? panels.toolsExpanded : panels.thinkingExpanded),
       });
       if (running) elements.push(panel);
       else panelElements.push(panel);
@@ -1261,6 +1265,7 @@ export function splitStepStreamCardBlocks(
   blocks,
   limit = STEP_STREAM_CARD_MAX_BYTES,
   maxTables = STEP_STREAM_CARD_MAX_TABLES,
+  stepCardPanels,
 ) {
   // A single block can carry more tables than a card accepts — one short answer
   // with six small tables — and splitting only between blocks cannot help. Each
@@ -1273,7 +1278,7 @@ export function splitStepStreamCardBlocks(
   const chunks = [];
   let current = [];
   for (const block of list) {
-    const tooLarge = Buffer.byteLength(stepStreamCard([...current, block]), 'utf8') > limit;
+    const tooLarge = Buffer.byteLength(stepStreamCard([...current, block], { stepCardPanels }), 'utf8') > limit;
     const tooManyTables = stepStreamCardTableCount([...current, block]) > maxTables;
     if (current.length > 0 && (tooLarge || tooManyTables)) {
       chunks.push(current);

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

@@ -5,7 +5,7 @@ import { FeishuHarnessBridge } from './bridge.mjs';
 import { cardActionProbeCard } from './feishu-cards.mjs';
 import { VerifiedFeishuChannel, waitForFeishuOperation } from './feishu-channel.mjs';
 import { normalizeFeishuGroupResponseMode } from './group-response-mode.mjs';
-import { normalizeFeishuStepPushMode } from './step-push-mode.mjs';
+import { normalizeFeishuStepPushMode, normalizeFeishuStepCardPanels } from './step-push-mode.mjs';
 import { createVoice } from './voice.mjs';
 import {
   syncSlashCommands,
@@ -119,6 +119,7 @@ export class FeishuRuntime {
   #mentionTopicReply;
   #stepPush;
   #stepPushMode;
+  #stepCardPanels;
   #voice = null;
   #sessionSyncTargetsFor;
   #ownerOpenIds;
@@ -171,6 +172,7 @@ export class FeishuRuntime {
     mentionTopicReply = true,
     stepPush = false,
     stepPushMode = 'post',
+    stepCardPanels,
     voice = null,
     sessionSyncTargetsFor = null,
     ownerOpenId,
@@ -214,6 +216,7 @@ export class FeishuRuntime {
     this.#mentionTopicReply = mentionTopicReply !== false;
     this.#stepPush = stepPush === true;
     this.#stepPushMode = normalizeFeishuStepPushMode(stepPushMode);
+    this.#stepCardPanels = normalizeFeishuStepCardPanels(stepCardPanels);
     // voice 为 { config, secret } 来源;凭据缺失时 createVoice 返回禁用对象,
     // 桥接层完全跳过语音路径,不影响连接。
     this.#voice = voice == null
@@ -262,6 +265,11 @@ export class FeishuRuntime {
     this.#bridge?.setStepPushMode(this.#stepPushMode);
   }
 
+  setStepCardPanels(value) {
+    this.#stepCardPanels = normalizeFeishuStepCardPanels(value);
+    this.#bridge?.setStepCardPanels(this.#stepCardPanels);
+  }
+
   setVoice(source) {
     this.#voice = source == null
       ? null
@@ -371,6 +379,7 @@ export class FeishuRuntime {
         mentionTopicReply: this.#mentionTopicReply,
         stepPush: this.#stepPush,
         stepPushMode: this.#stepPushMode,
+        stepCardPanels: this.#stepCardPanels,
         voice: this.#voice,
         sessionSyncTargetsFor: this.#sessionSyncTargetsFor,
         repair: this.#repair,

package/src/channels/feishu/multi-bot-controller.mjs

@@ -21,6 +21,8 @@ import {
   DEFAULT_FEISHU_STEP_PUSH_MODE,
   isFeishuStepPushMode,
   normalizeFeishuStepPushMode,
+  isFeishuStepCardPanels,
+  normalizeFeishuStepCardPanels,
 } from './step-push-mode.mjs';
 import { normalizeFeishuVoiceConfig } from './voice-config.mjs';
 import {
@@ -106,6 +108,7 @@ function configuredBotFingerprint(config) {
     mentionTopicReply: config.mentionTopicReply !== false,
     stepPush: config.stepPush === true,
     stepPushMode: normalizeFeishuStepPushMode(config.stepPushMode),
+    stepCardPanels: normalizeFeishuStepCardPanels(config.stepCardPanels),
     voice: config.voice,
     slashPanel: normalizeSlashPanelConfig(config.slashPanel),
     groupMessagePermissionGranted: config.groupMessagePermissionGranted === true,
@@ -816,6 +819,20 @@ export class MultiBotDshFeishuController {
     }));
   }
 
+  async updateStepCardPanels(botId, stepCardPanels) {
+    this.#assertOpen();
+    if (!isFeishuStepCardPanels(stepCardPanels)) {
+      throw new TypeError('Invalid Feishu step card panels');
+    }
+    return this.#serializeConfig(() => this.#withBotTransition(botId, async () => {
+      const config = this.#requireBot(botId);
+      const saved = await this.#configStore.saveBot({ ...config, stepCardPanels });
+      this.#runtimes.get(botId)?.setStepCardPanels?.(saved.stepCardPanels);
+      this.#touch();
+      return this.status(botId);
+    }));
+  }
+
   async updateVoice(botId, voice) {
     this.#assertOpen();
     if (voice !== null && (typeof voice !== 'object' || Array.isArray(voice))) {
@@ -901,6 +918,7 @@ export class MultiBotDshFeishuController {
         mentionTopicReply: config.mentionTopicReply !== false,
         stepPush: config.stepPush === true,
         stepPushMode: normalizeFeishuStepPushMode(config.stepPushMode),
+        stepCardPanels: normalizeFeishuStepCardPanels(config.stepCardPanels),
         voice: normalizeFeishuVoiceConfig(config.voice),
         slashPanel: normalizeSlashPanelConfig(config.slashPanel),
         groupMessagePermissionGranted: config.groupMessagePermissionGranted === true,

package/src/channels/feishu/plugin-config-store.mjs

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { normalizeFeishuGroupResponseMode } from './group-response-mode.mjs';
-import { normalizeFeishuStepPushMode } from './step-push-mode.mjs';
+import { normalizeFeishuStepPushMode, normalizeFeishuStepCardPanels } from './step-push-mode.mjs';
 import { normalizeFeishuVoiceConfig } from './voice-config.mjs';
 import { normalizeSlashPanelConfig } from './slash-command-panel.mjs';
 
@@ -52,6 +52,7 @@ function normalizeBot(value, { legacy = false } = {}) {
     mentionTopicReply: value.mentionTopicReply !== false,
     stepPush: value.stepPush === true,
     stepPushMode: normalizeFeishuStepPushMode(value.stepPushMode),
+    stepCardPanels: normalizeFeishuStepCardPanels(value.stepCardPanels),
     voice: normalizeFeishuVoiceConfig(value.voice),
     slashPanel: normalizeSlashPanelConfig(value.slashPanel),
     groupMessagePermissionGranted: value.groupMessagePermissionGranted === true,

package/src/channels/feishu/slash-command-panel.mjs

@@ -30,6 +30,7 @@ export const SLASH_COMMAND_MANIFEST = Object.freeze([
   { command: 'help', icon: 'promptword_outlined', default: '查看帮助', en_us: 'Show help' },
   { command: 'status', icon: 'ai-functions_outlined', default: '查看机器人状态', en_us: 'Show bot status' },
   { command: 'compact', icon: 'ai-block_outlined', default: '压缩当前会话上下文', en_us: 'Compact the current session' },
+  { command: 'clear', icon: 'clear_outlined', default: '清空当前会话上下文', en_us: 'Clear the current session context' },
   { command: 'sessionlist', icon: 'chat-ai_outlined', default: '列出会话', en_us: 'List sessions' },
   { command: 'workspacelist', icon: 'folder_outlined', default: '列出工作区', en_us: 'List workspaces' },
   { command: 'workspaces', icon: 'folder_outlined', default: '列出工作区', en_us: 'List workspaces' },

package/src/channels/feishu/step-push-mode.mjs

@@ -7,6 +7,27 @@ export const FEISHU_STEP_PUSH_MODES = Object.freeze({
 /** New connections explicitly opt into the process-card presentation. */
 export const DEFAULT_FEISHU_STEP_PUSH_MODE = FEISHU_STEP_PUSH_MODES.STREAMING_CARD;
 
+export const DEFAULT_FEISHU_STEP_CARD_PANELS = Object.freeze({
+  thinkingExpanded: false,
+  toolsExpanded: true,
+});
+
+export function normalizeFeishuStepCardPanels(value) {
+  return Object.freeze({
+    thinkingExpanded: typeof value?.thinkingExpanded === 'boolean'
+      ? value.thinkingExpanded : DEFAULT_FEISHU_STEP_CARD_PANELS.thinkingExpanded,
+    toolsExpanded: typeof value?.toolsExpanded === 'boolean'
+      ? value.toolsExpanded : DEFAULT_FEISHU_STEP_CARD_PANELS.toolsExpanded,
+  });
+}
+
+export function isFeishuStepCardPanels(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    && Object.keys(value).every((key) => key === 'thinkingExpanded' || key === 'toolsExpanded')
+    && typeof value.thinkingExpanded === 'boolean'
+    && typeof value.toolsExpanded === 'boolean';
+}
+
 export function normalizeFeishuStepPushMode(value) {
   // Bots created before modes existed used posts when step push was enabled.
   if (value === FEISHU_STEP_PUSH_MODES.STREAMING_CARD) {

package/src/channels/matrix/matrix-crypto.mjs

@@ -97,6 +97,7 @@ export class MatrixCryptoEngine {
   #seenIndex = new Map();
   #pendingEvents = new Map();
   #requestState = new Map();
+  #pendingTasks = new Set();
   #lastKeyMaintenanceAt = 0;
   #stats = {
     undecryptable: 0,
@@ -239,6 +240,12 @@ export class MatrixCryptoEngine {
   }
 
   async stop() {
+    this.#ready = false;
+    // A key request can enqueue persistence after shutdown starts. Drain both
+    // before releasing sessions or allowing the caller to remove the store.
+    while (this.#pendingTasks.size > 0) {
+      await Promise.allSettled([...this.#pendingTasks]);
+    }
     for (const entry of this.#inbound.values()) entry.session.free?.();
     for (const entry of this.#outbound.values()) entry.session.free?.();
     this.#inbound.clear();
@@ -247,7 +254,12 @@ export class MatrixCryptoEngine {
     this.#memberCache.clear();
     this.#pendingEvents.clear();
     this.#seenIndex.clear();
-    this.#ready = false;
+  }
+
+  #trackTask(task) {
+    const tracked = task.finally(() => this.#pendingTasks.delete(tracked));
+    this.#pendingTasks.add(tracked);
+    return tracked;
   }
 
   async maintain() {
@@ -717,7 +729,9 @@ export class MatrixCryptoEngine {
     if (!entry) {
       this.#stats.undecryptable += 1;
       this.#pendingEvents.set(`${key}|${event?.event_id ?? 'x'}`, { roomId, event, at: this.#now() });
-      void this.#requestRoomKey(roomId, event);
+      void this.#trackTask(this.#requestRoomKey(roomId, event).catch((error) => {
+        this.#logger.warn?.('[dsh-im:matrix] a room key request failed:', error?.message ?? error);
+      }));
       return null;
     }
     const seen = this.#seenIndexes(key);
@@ -908,7 +922,7 @@ export class MatrixCryptoEngine {
     } catch {
       return Promise.resolve();
     }
-    return this.#store.apply({ groupOutbound }).catch(() => undefined);
+    return this.#trackTask(this.#store.apply({ groupOutbound }).catch(() => undefined));
   }
 
   #persistInbound(key) {
@@ -936,7 +950,7 @@ export class MatrixCryptoEngine {
         lastUsedAt: entry.lastUsedAt,
       },
     ].slice(-900);
-    return this.#store.apply({ groupInbound }).catch(() => undefined);
+    return this.#trackTask(this.#store.apply({ groupInbound }).catch(() => undefined));
   }
 
   #persistRequestState() {
@@ -944,7 +958,7 @@ export class MatrixCryptoEngine {
     if (!snapshot) return Promise.resolve();
     const requestState = {};
     for (const [key, state] of [...this.#requestState].slice(-200)) requestState[key] = { ...state };
-    return this.#store.apply({ requestState }).catch(() => undefined);
+    return this.#trackTask(this.#store.apply({ requestState }).catch(() => undefined));
   }
 
   // ---- key registration ---------------------------------------------------