@xmanrui/dsh-im 4.12.0 → 4.13.0

package/src/channels/feishu/state-store.mjs

@@ -1,3 +1,4 @@
+import { deferredStateAccess, normalizeDeferredState } from '../shared/deferred-state.mjs';
 import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 
@@ -6,6 +7,7 @@ const EMPTY_STATE = Object.freeze({
   sessions: {},
   seenMessageIds: [],
   watches: {},
+  deferred: {},
   includeArchivedSessions: false,
   topics: {},
 });
@@ -25,6 +27,7 @@ export class StateStore {
   #path;
   #state = structuredClone(EMPTY_STATE);
   #writeQueue = Promise.resolve();
+  #deferred = deferredStateAccess(() => this.#state, () => this.#persist());
 
   constructor(path) {
     this.#path = path;
@@ -38,6 +41,7 @@ export class StateStore {
         sessions: parsed.sessions && typeof parsed.sessions === 'object' ? parsed.sessions : {},
         seenMessageIds: Array.isArray(parsed.seenMessageIds) ? parsed.seenMessageIds.slice(-1000) : [],
         watches: parsed.watches && typeof parsed.watches === 'object' ? parsed.watches : {},
+        deferred: normalizeDeferredState(parsed.deferred),
         includeArchivedSessions: typeof parsed.includeArchivedSessions === 'boolean'
           ? parsed.includeArchivedSessions
           : false,
@@ -50,6 +54,11 @@ export class StateStore {
     return this;
   }
 
+  deferredEntries() { return this.#deferred.entries(); }
+  putDeferred(entry) { return this.#deferred.put(entry); }
+  patchDeferred(id, patch) { return this.#deferred.patch(id, patch); }
+  removeDeferred(id) { return this.#deferred.remove(id); }
+
   sessionFor(key) {
     return this.#state.sessions[key] ?? null;
   }
@@ -138,6 +147,8 @@ export class StateStore {
     return [...ids];
   }
 
+  // ── Deferred delivery (persisted: surviving restarts) ───────────────────
+
   // ── Managed Feishu topics (thread_id → root message, persisted) ────────
 
   topicRootFor(threadId) {

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

@@ -1,3 +1,4 @@
+import { createDeferredDeliveryCoordinator, deferredOutcomeText } from '../shared/deferred-delivery-coordinator.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
 import { isHistoryCommand, runHistoryCommand } from '../shared/history-command.mjs';
@@ -62,6 +63,11 @@ import {
   evaluateInboundAccess,
 } from '../shared/inbound-access.mjs';
 import { sendMarkdownReply } from './markdown-reply.mjs';
+import {
+  isQqMenuCommand, parseQqMenuCommand, QqMenuStore,
+  qqMenuPage, qqMenuView, sendQqMenu,
+} from './qq-menu.mjs';
+import { withSessionBindingLock } from '../shared/session-binding-lock.mjs';
 import { t } from '../shared/i18n.mjs';
 
 function interactionResolvedText() {
@@ -85,6 +91,7 @@ function helpText() {
     t('QQ 机器人已连接 DeepSeek Harness。'),
     '',
     t('直接发送文字、图片或文件即可继续当前会话。'),
+    t('/menu 或 /m  打开可点击的功能菜单'),
     t('/new  开启一个全新会话'),
     t('/compact  压缩当前会话的较早上下文'),
     t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
@@ -418,6 +425,7 @@ export class QqHarnessBridge {
   #ownerUserOpenid;
   #harness;
   #state;
+  #deferred;
   #contextEnhancement;
   #accessPolicy;
   #status;
@@ -435,6 +443,8 @@ export class QqHarnessBridge {
   #commandTasks = new Set();
   #approvals;
   #batchInputs = new BatchInputManager();
+  #menus = new QqMenuStore();
+  #menuTasks = new Map();
 
   constructor({
     bot,
@@ -467,6 +477,9 @@ export class QqHarnessBridge {
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#signal = signal;
+    this.#deferred = createDeferredDeliveryCoordinator({ harness, state, signal, logger,
+      deliver: (entry, outcome) => this.#deliverDeferredOutcome(entry, outcome),
+    });
     this.#fetchImpl = fetchImpl;
     this.#fileUploadTimeoutMs = Math.min(fileUploadTimeoutMs, DEFAULT_FILE_UPLOAD_TIMEOUT_MS);
     this.#approvals = new HarnessApprovalQueue({ label: 'qq', logger });
@@ -488,6 +501,15 @@ export class QqHarnessBridge {
     const addressed = message.kind !== 'group'
       || message.rawEventType === 'GROUP_AT_MESSAGE_CREATE';
     const commandText = safeText(message);
+    const menuTextOnly = !hasQqImageAttachments(message) && !hasQqFileAttachments(message)
+      && !qqReplyReference(message);
+    const explicitMenu = menuTextOnly && isQqMenuCommand(commandText);
+    const numericMenu = menuTextOnly && /^\d{1,2}$/u.test(commandText)
+      && this.#menus.has(key, sender)
+      && !this.#pendingInteractions.has(key) && !this.#approvals.hasPending(key)
+      && this.#batchInputs.status(key).phase === 'idle';
+    const menuInput = numericMenu
+      ? `/m pick ${this.#menus.tokenFor(key, sender)} ${commandText}` : commandText;
     if (addressed) {
       const access = this.#accessPolicy
         ? evaluateInboundAccess(this.#accessPolicy, {
@@ -496,6 +518,7 @@ export class QqHarnessBridge {
             text: commandText,
             hasImages: hasQqImageAttachments(message),
             hasFiles: hasQqFileAttachments(message),
+            ...(explicitMenu || numericMenu ? { isCommand: true } : {}),
           })
         : senderAllowed(message, this.#ownerUserOpenid)
           ? { allowed: true, reason: 'legacy-owner' }
@@ -518,6 +541,9 @@ export class QqHarnessBridge {
     const pending = this.#pendingInteractions.get(key);
     const batchCommand = isBatchInputCommand(commandText);
     const batchStatus = this.#batchInputs.status(key);
+    // Ordinary prompts and other commands end number selection. A pending
+    // question/approval or batch keeps its existing interpretation of digits.
+    if (addressed && !explicitMenu && !numericMenu) this.#menus.clear(key, sender);
     if (batchCommand && addressed && message.kind === 'group') {
       return this.#finishBatchResult(
         message,
@@ -527,6 +553,9 @@ export class QqHarnessBridge {
     }
     if (message.kind === 'c2c'
       && (batchCommand || batchStatus.phase === 'collecting')) {
+      if (explicitMenu) return this.#finishBatchResult(message, messageId, {
+        message: t('当前正在批量输入，请先发送 /send 或 /cancel，再打开菜单。'),
+      });
       const exactBatchStart = /^\/batch$/iu.test(commandText);
       const result = exactBatchStart
         && batchStatus.phase === 'idle'
@@ -550,7 +579,9 @@ export class QqHarnessBridge {
         return this.#finishBatchResult(message, messageId, result);
       }
     }
-    const commandRunner = isHistoryCommand(commandText) ? runHistoryCommand
+    const commandRunner = explicitMenu || numericMenu
+      ? () => this.#runMenuCommand(message, menuInput, key)
+      : isHistoryCommand(commandText) ? runHistoryCommand
       : hasQqFileAttachments(message) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
@@ -665,6 +696,92 @@ export class QqHarnessBridge {
     return current;
   }
 
+  async #deliverDeferredOutcome(entry, outcome) {
+    await sendMarkdownReply(this.#bot, entry.target, deferredOutcomeText(outcome), { logger: this.#logger });
+    return true;
+  }
+
+  #menuContext(key) {
+    return { workspace: this.#harness.currentWorkspace?.(), sessionId: this.#state.sessionFor(key) };
+  }
+
+  async #showMenu(message, key, name, pageView = null) {
+    const actor = message.senderId;
+    const context = this.#menuContext(key);
+    const entry = this.#menus.begin(key, actor, context);
+    const view = pageView ?? await qqMenuView(name, this.#harness, this.#state, key, {
+      signal: this.#signal, busy: this.#queues.has(key)
+        || this.#pendingInteractions.has(key) || this.#approvals.hasPending(key),
+    });
+    this.#signal?.throwIfAborted();
+    this.#harness.assertWorkspaceScope?.();
+    const current = this.#menuContext(key);
+    if (current.workspace !== context.workspace || current.sessionId !== context.sessionId) {
+      return { message: t('会话或工作区已变化，请重新发送 /m。') };
+    }
+    if (!this.#menus.publish(key, actor, entry, view)) return { messages: [] };
+    await sendQqMenu(this.#bot, message.replyTarget, view, entry.token, { logger: this.#logger });
+    this.#status.messagesReplied += 1;
+    this.#status.lastReplyAt = new Date().toISOString();
+    return { messages: [] };
+  }
+
+  async #runMenuCommand(message, text, key) {
+    const parsed = isQqMenuCommand(text) ? parseQqMenuCommand(text) : { number: Number(text) };
+    if (parsed.error) return { message: t('菜单命令无效，请发送 /m 重新打开。') };
+    if (parsed.name) return this.#showMenu(message, key, parsed.name);
+    const choice = this.#menus.take(key, message.senderId, parsed.number, parsed.token, this.#menuContext(key));
+    if (choice.error) return { message: choice.error };
+    const action = choice.action;
+    if (action.kind === 'section') return this.#showMenu(message, key, action.name);
+    if (action.kind === 'page') return this.#showMenu(message, key, '', qqMenuPage(action.list, action.page));
+    if (action.kind === 'archive') {
+      await this.#state.setIncludeArchivedSessions(action.include);
+      return this.#showMenu(message, key, 'main');
+    }
+    const command = action.text;
+    const pendingInteraction = this.#pendingInteractions.has(key) || this.#approvals.hasPending(key);
+    const isBusy = () => this.#queues.has(key) || this.#pendingInteractions.has(key)
+      || this.#approvals.hasPending(key) || this.#batchInputs.status(key).phase !== 'idle';
+    const needsIdle = /^\/(?:new|session|workspace|compact)(?:\s|$)/u.test(command);
+    if (isBusy() && needsIdle) {
+      return { message: t('当前任务仍在运行，请先停止任务或等待任务完成后再执行此操作。') };
+    }
+    const options = { signal: this.#signal, isDirect: message.kind === 'c2c', pendingInteraction,
+      control: { owner: this, key }, deferredDelivery: this.#deferred };
+    // Existing runners own all Host mutations and control authorization.
+    const execute = async () => {
+      this.#signal?.throwIfAborted();
+      const current = this.#menuContext(key);
+      if (current.workspace !== choice.context.workspace || current.sessionId !== choice.context.sessionId) {
+        return { message: t('会话或工作区已变化，请重新发送 /m。') };
+      }
+      // A prompt may have started while this action waited for a prior menu command.
+      if (needsIdle && isBusy()) return { message: t('当前任务仍在运行，请先停止任务或等待任务完成后再执行此操作。') };
+      if (isControlCommand(command)) return runControlCommand(command, this.#harness, this.#state, key, options);
+      if (isModelCommand(command)) return runModelCommand(command, this.#harness, this.#state, key, options);
+      if (isPresetCommand(command)) return runPresetCommand(command, this.#harness, this.#state, key, options);
+      if (command === '/new') return withSessionBindingLock(this.#state, key, async () => {
+        if (isBusy()) return { message: t('当前任务仍在运行，请先停止任务或等待任务完成后再执行此操作。') };
+        const locked = this.#menuContext(key);
+        if (locked.workspace !== choice.context.workspace || locked.sessionId !== choice.context.sessionId) {
+          return { message: t('会话或工作区已变化，请重新发送 /m。') };
+        }
+        await this.#state.clearSession(key);
+        return { message: t('已开启新会话。请发送你的问题。') };
+      });
+      if (command === '/compact') return runCompactCommand(command, this.#harness, this.#state, key, options);
+      return runWorkspaceCommand(command, this.#harness, key);
+    };
+    // Stop/steer must stay available while a slower menu mutation is pending.
+    if (isControlCommand(command)) return execute();
+    const previous = this.#menuTasks.get(key) ?? Promise.resolve();
+    const task = previous.catch(() => undefined).then(execute);
+    this.#menuTasks.set(key, task);
+    try { return await task; }
+    finally { if (this.#menuTasks.get(key) === task) this.#menuTasks.delete(key); }
+  }
+
   async waitForIdle() {
     await Promise.allSettled([
       ...this.#queues.values(),
@@ -674,6 +791,7 @@ export class QqHarnessBridge {
       ...this.#approvalTasks,
       ...this.#commandTasks,
     ]);
+    await this.#deferred.whenIdle();
   }
 
   async #processFastCommand(message, messageId, key, text, runner) {
@@ -690,6 +808,7 @@ export class QqHarnessBridge {
       pendingInteraction: this.#pendingInteractions.has(key)
         || this.#approvals.hasPending(key),
       control: { owner: this, key },
+      deferredDelivery: this.#deferred,
     });
     if (result?.stopped) {
       await Promise.allSettled([
@@ -905,6 +1024,7 @@ export class QqHarnessBridge {
         // redelivery after a failed error notice must never execute it twice.
         await markMessageSeen();
         ({ answer, artifacts = [] } = await askInWorkspaceSession({
+          deferredDelivery: () => ({ coordinator: this.#deferred, target: { scope: target.scope, targetId: target.targetId } }),
           harness: this.#harness,
           state: this.#state,
           key,

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

@@ -0,0 +1,205 @@
+import { randomBytes } from 'node:crypto';
+import { ApiError } from '@tencent-connect/qqbot-nodejs';
+import { workspacePathSnapshot } from '../shared/workspace-command.mjs';
+import { t } from '../shared/i18n.mjs';
+
+export const QQ_MENU_TTL_MS = 15 * 60_000;
+const PAGE_SIZE = 6;
+const MAX_MENUS = 256;
+const SECTIONS = new Set(['main', 'sessions', 'workspaces', 'presets', 'models', 'steer', 'custom', 'status', 'help']);
+const clean = (value, limit = 160) => [...String(value ?? '').replace(/[\p{Cc}\p{Cf}]/gu, ' ')].slice(0, limit).join('');
+const command = (label, text) => ({ label, action: { kind: 'command', text } });
+const section = (label, name) => ({ label, action: { kind: 'section', name } });
+const back = () => section(t('返回主菜单'), 'main');
+
+export function isQqMenuCommand(text) {
+  return typeof text === 'string' && /^\/(?:m|menu)(?=$|\s)/iu.test(text.trim());
+}
+
+export function parseQqMenuCommand(text) {
+  const match = /^\/(?:m|menu)(?:\s+(\S+))?(?:\s+(\S+))?(?:\s+(\S+))?$/iu.exec(text.trim());
+  if (!match) return { error: true };
+  const name = match[1]?.toLowerCase() ?? 'main';
+  if (SECTIONS.has(name) && !match[2]) return { name };
+  if (name === 'pick' && /^[a-f0-9]{24}$/u.test(match[2] ?? '') && /^\d{1,2}$/u.test(match[3] ?? '')) {
+    return { token: match[2], number: Number(match[3]) };
+  }
+  return { error: true };
+}
+
+// A menu belongs to its actor and route. The exact displayed actions, including
+// paginated choices, stay in memory; clients only send an opaque token + index.
+export class QqMenuStore {
+  #entries = new Map();
+  #now;
+  constructor({ now = Date.now } = {}) { this.#now = now; }
+  #key(route, actor) { return `${route}\0${actor}`; }
+  has(route, actor) { return this.#entries.has(this.#key(route, actor)); }
+  tokenFor(route, actor) { return this.#entries.get(this.#key(route, actor))?.token; }
+  clear(route, actor) { this.#entries.delete(this.#key(route, actor)); }
+  begin(route, actor, context) {
+    const key = this.#key(route, actor);
+    const entry = { ...context, token: randomBytes(12).toString('hex'),
+      expiresAt: this.#now() + QQ_MENU_TTL_MS, used: false, view: null };
+    this.#entries.delete(key);
+    this.#entries.set(key, entry);
+    while (this.#entries.size > MAX_MENUS) this.#entries.delete(this.#entries.keys().next().value);
+    return entry;
+  }
+  publish(route, actor, entry, view) {
+    if (this.#entries.get(this.#key(route, actor)) !== entry) return false;
+    entry.view = view;
+    return true;
+  }
+  take(route, actor, number, token, context) {
+    const entry = this.#entries.get(this.#key(route, actor));
+    if (!entry || entry.used || !entry.view || entry.expiresAt <= this.#now()
+      || (token && token !== entry.token)) return { error: t('这个菜单已过期，请回复 /m 重新打开。') };
+    if (entry.workspace !== context.workspace || entry.sessionId !== context.sessionId) {
+      entry.used = true;
+      return { error: t('会话或工作区已变化，请重新发送 /m。') };
+    }
+    const choice = entry.view.entries[number - 1];
+    if (!Number.isSafeInteger(number) || number < 1 || !choice) {
+      return { error: t('菜单没有这个编号，回复 /m 重新打开。') };
+    }
+    // Claim before awaiting anything: retries cannot repeat a destructive action.
+    entry.used = true;
+    return { action: choice.action, context: entry };
+  }
+}
+
+export function qqMenuPage(list, requestedPage = 0) {
+  const pages = Math.max(1, Math.ceil(list.choices.length / PAGE_SIZE));
+  const page = Math.min(Math.max(0, requestedPage), pages - 1);
+  const entries = list.choices.slice(page * PAGE_SIZE, (page + 1) * PAGE_SIZE);
+  if (page > 0) entries.push({ label: t('上一页'), action: { kind: 'page', list, page: page - 1 } });
+  if (page + 1 < pages) entries.push({ label: t('下一页'), action: { kind: 'page', list, page: page + 1 } });
+  entries.push(back());
+  return { title: list.title, detail: [list.detail, t('第 {page} / {pages} 页', { page: page + 1, pages }),
+    list.choices.length ? '' : t('暂无可用选项。')].filter(Boolean).join('\n'), entries, columns: 2 };
+}
+
+async function catalogFor(harness, sessionId, options) {
+  const session = sessionId ? harness.workspaceSession?.(sessionId) : null;
+  return typeof session?.models === 'function' ? session.models(options) : harness.listModels(options);
+}
+
+export async function qqMenuView(name, harness, state, key, { signal, busy = false } = {}) {
+  const workspace = harness.currentWorkspace?.();
+  const sessionId = state.sessionFor(key);
+  const options = { signal };
+  const archived = state.includesArchivedSessions?.() === true;
+  const visibleSessions = (listed) => (listed?.sessions ?? []).filter((item) => archived || item.archived !== true);
+  if (name === 'main' || name === 'status') {
+    if (name === 'status') await harness.ensureRunning(options);
+    const results = await Promise.allSettled([
+      harness.listWorkspaceSessions?.(workspace, options),
+      catalogFor(harness, sessionId, options),
+      harness.agentPresetSettings?.(options),
+    ]);
+    signal?.throwIfAborted();
+    const [listed, catalog, settings] = results.map((r) => r.status === 'fulfilled' ? r.value : null);
+    const bound = listed?.sessions?.find((item) => item.sessionId === sessionId);
+    const presetId = settings?.agentPreset ?? settings?.agentPresetCatalog?.defaultId;
+    const preset = settings?.agentPresetCatalog?.items?.find((item) => item.id === presetId);
+    const model = catalog?.groups?.find((group) => group.id === catalog.current?.provider)
+      ?.models?.find((item) => item.id === catalog.current?.model);
+    const detail = [
+      name === 'status' ? t('QQ 机器人与 DeepSeek Harness 连接正常。') : '',
+      t('工作区：{workspace}', { workspace: clean(workspace) || t('未设置') }),
+      t('当前会话：{session}', { session: clean(bound?.title || sessionId) || t('新会话') }),
+      t('模式／预设：{preset}', { preset: clean(preset?.label || presetId) || t('跟随 Host 默认') }),
+      t('当前模型：{model}', { model: clean(model?.name || catalog?.current?.model) || t('暂不可用') }),
+      t('归档会话：{state}', { state: archived ? t('显示') : t('隐藏') }),
+      t('任务状态：{state}', { state: busy ? t('处理中') : t('空闲') }),
+      results.some((r) => r.status === 'rejected') ? t('部分设置暂未加载，可进入对应列表重试。') : '',
+    ].filter(Boolean).join('\n');
+    return { title: name === 'main' ? t('🤖 助手中心') : t('📊 状态'), detail,
+      columns: 3, entries: name === 'status' ? [back()] : [
+        section(t('💬 会话选择'), 'sessions'), section(t('📁 工作区'), 'workspaces'), section(t('🤖 模式／预设'), 'presets'),
+        section(t('🧠 模型'), 'models'), command(t('🆕 新会话'), '/new'), section(t('📋 会话列表'), 'sessions'),
+        command(t('⏹ 停止'), '/stop'), command(t('📐 压缩'), '/compact'), section(t('💬 补充指令'), 'steer'),
+        { label: t('切换归档显示'), action: { kind: 'archive', include: !archived } },
+        section(t('📊 状态'), 'status'), section(t('📖 帮助'), 'help'),
+      ] };
+  }
+  if (name === 'sessions') {
+    const listed = await harness.listWorkspaceSessions(workspace, options);
+    return qqMenuPage({ title: t('📋 会话列表'), detail: clean(workspace), choices: visibleSessions(listed).map((item) =>
+      command(`${item.sessionId === sessionId ? '✓ ' : ''}${clean(item.title || item.sessionId, 70)}${item.archived ? t('（已归档）') : ''}`, `/session ${item.sessionId}`)) });
+  }
+  if (name === 'workspaces') {
+    const { paths } = await workspacePathSnapshot(harness, options);
+    return qqMenuPage({ title: t('📁 工作区'), choices: paths.map((path) =>
+      command(`${path === workspace ? '✓ ' : ''}${clean(path)}`, `/workspace ${path}`)) });
+  }
+  if (name === 'models') {
+    const catalog = await catalogFor(harness, sessionId, options);
+    return qqMenuPage({ title: t('🧠 模型'), detail: catalog.failures?.length ? t('部分模型暂不可用，可稍后重试。') : '',
+      choices: catalog.groups.flatMap((group) => group.models.map((model) => command(
+        `${catalog.current?.provider === group.id && catalog.current?.model === model.id ? '✓ ' : ''}${clean(group.name, 30)} · ${clean(model.name, 60)}`,
+        `/model ${group.id}/${model.id}`))) });
+  }
+  if (name === 'presets') {
+    const settings = await harness.agentPresetSettings(options);
+    return qqMenuPage({ title: t('🤖 模式／预设'), detail: t('预设仅用于之后的新会话。'), choices: [
+      command(`${settings.agentPreset === null ? '✓ ' : ''}${t('跟随 Host 默认')}`, '/preset --default'),
+      ...settings.agentPresetCatalog.items.map((item) => command(
+        `${settings.agentPreset === item.id ? '✓ ' : ''}${clean(item.label || item.id, 70)}`,
+        `/preset ${/^\d+$/u.test(item.id) ? 'id:' : ''}${item.id}`)),
+    ] });
+  }
+  if (name === 'steer') return { title: t('💬 补充指令'), columns: 2,
+    detail: t('给当前正在运行的任务补充指令。'), entries: [
+      ...['继续', '加速运行', '总结当前进展', '更简洁些', '更详细些'].map((text) => command(t(text), `/steer ${t(text)}`)),
+      section(t('自定义指令'), 'custom'), back(),
+    ] };
+  if (name === 'custom') return { title: t('自定义指令'), detail: t('请发送 /steer 你的补充指令。'), entries: [back()] };
+  return { title: t('📖 帮助'), detail: [
+    t('发送 /m 打开助手中心，点击按钮或回复当前列表的数字选择。'),
+    t('设置：会话、工作区、模式／预设、模型。'),
+    t('会话：新会话、会话列表、归档显示切换。'),
+    t('任务：停止、压缩、快捷或自定义补充指令。'),
+    t('信息：状态、帮助。'),
+    t('菜单有效期为 15 分钟；发送普通消息会退出数字选择。'),
+    t('回答问题、审批和批量输入时，数字优先用于当前交互。'),
+    t('完整命令说明：/help'),
+  ].join('\n'), entries: [back()] };
+}
+
+export function qqMenuText(view, { fallback = false } = {}) {
+  return [view.title, view.detail, '', ...view.entries.map((entry, index) => `${index + 1}. ${entry.label}`), '',
+    fallback ? t('当前无法展示按钮，请回复数字选择。') : t('点击按钮或回复数字选择，/m 返回主菜单。'),
+    t('回答问题、审批和批量输入时，请先完成当前交互。'),
+  ].filter((line) => line !== undefined).join('\n');
+}
+
+export function qqMenuKeyboard(view, token) {
+  const buttons = view.entries.map((entry, index) => ({
+    id: `${token}_${index + 1}`,
+    render_data: { label: view.columns === 3
+      ? clean(entry.label, 24).replace(t('模式／预设'), t('预设')).replace(t('切换归档显示'), t('归档显示'))
+      : `${index + 1}. ${clean(entry.label, 32)}`, visited_label: t('已选择'), style: 0 },
+    action: { type: 2, permission: { type: 2 }, data: `/m pick ${token} ${index + 1}`, enter: true,
+      unsupport_tips: t('请回复数字选择，或发送 /m 重新打开菜单。') },
+  }));
+  const rows = [];
+  for (let i = 0; i < buttons.length; i += view.columns ?? 2) rows.push({ buttons: buttons.slice(i, i + (view.columns ?? 2)) });
+  return { content: { rows } };
+}
+
+export async function sendQqMenu(bot, target, view, token, { logger = console } = {}) {
+  if (typeof bot.send === 'function') {
+    try {
+      const content = qqMenuText(view).replace(/[\\`*_{}\[\]()<>#|!]/gu, '\\$&');
+      return await bot.send({ target, msgType: 2, markdown: { content }, keyboard: qqMenuKeyboard(view, token) });
+    } catch (error) {
+      // A timeout may have delivered already. Only a definite provider rejection
+      // permits another send, so a network fault never creates duplicate menus.
+      if (!(error instanceof ApiError) || error.httpStatus < 400 || error.httpStatus >= 500 || error.httpStatus === 429) throw error;
+      logger.warn?.('[dsh-im:qq] menu rejected; using numbered text:', error.bizCode);
+    }
+  }
+  return bot.sendText(target, qqMenuText(view, { fallback: true }));
+}

package/src/channels/qq/state-store.mjs

@@ -1,3 +1,4 @@
+import { deferredStateAccess, normalizeDeferredState } from '../shared/deferred-state.mjs';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 
@@ -16,6 +17,8 @@ function normalizeState(value) {
   return {
     version: 1,
     sessions,
+    includeArchivedSessions: value.includeArchivedSessions === true,
+    ...(value.deferred ? { deferred: normalizeDeferredState(value.deferred) } : {}),
     seenMessageIds: Array.isArray(value.seenMessageIds)
       ? value.seenMessageIds.filter((id) => typeof id === 'string').slice(-1_000)
       : [],
@@ -26,6 +29,7 @@ export class QqStateStore {
   #path;
   #state = structuredClone(EMPTY_STATE);
   #writeQueue = Promise.resolve();
+  #deferred = deferredStateAccess(() => this.#state, () => this.#persist());
 
   constructor(path) {
     this.#path = path;
@@ -42,6 +46,18 @@ export class QqStateStore {
     return this;
   }
 
+  deferredEntries() { return this.#deferred.entries(); }
+  putDeferred(entry) { return this.#deferred.put(entry); }
+  patchDeferred(id, patch) { return this.#deferred.patch(id, patch); }
+  removeDeferred(id) { return this.#deferred.remove(id); }
+
+  includesArchivedSessions() { return this.#state.includeArchivedSessions === true; }
+
+  async setIncludeArchivedSessions(include) {
+    this.#state.includeArchivedSessions = include === true;
+    await this.#persist();
+  }
+
   sessionFor(key) {
     return this.#state.sessions[key] ?? null;
   }

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

@@ -1436,6 +1436,9 @@ export function createBotWorkspaceScope(
             stopActiveTurn(...args) {
               return invokeStartedSessionMutation('stopActiveTurn', args, 'turn stop');
             },
+            stopDeferredTurn(...args) {
+              return invokeStartedSessionMutation('stopDeferredTurn', args, 'deferred turn stop');
+            },
             steerActiveTurn(...args) {
               return invokeStartedSessionMutation('steerActiveTurn', args, 'turn steering');
             },

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

@@ -40,6 +40,7 @@ export async function runControlCommand(text, harness, state, key, {
   hasImages = false,
   pendingInteraction = false,
   control,
+  deferredDelivery,
 } = {}) {
   if (!isControlCommand(text)) return null;
   const command = text.trim();
@@ -62,6 +63,13 @@ export async function runControlCommand(text, harness, state, key, {
       throw new TypeError('Harness session does not support stopping active turns');
     }
     const stopped = await session.stopActiveTurn(control, requestOptions(signal));
+    if (!stopped && deferredDelivery) {
+      const background = await deferredDelivery.stop(key);
+      if (background === 'stopped') return commandResult(t('已请求停止后台任务。'), { stopped: true });
+      if (background === 'unavailable') {
+        return commandResult(t('无法安全停止后台任务，请在 Harness 中查看并停止对应任务。'));
+      }
+    }
     return stopped
       ? commandResult(t('已请求停止当前任务。'), { stopped: true })
       : commandResult(t('当前聊天没有正在运行的任务。'));

package/src/channels/shared/conversation-state-store.mjs

@@ -1,3 +1,4 @@
+import { deferredStateAccess, normalizeDeferredState } from './deferred-state.mjs';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 
@@ -16,6 +17,7 @@ function normalizeState(value) {
   return {
     version: 1,
     sessions,
+    ...(value.deferred ? { deferred: normalizeDeferredState(value.deferred) } : {}),
     seenMessageIds: Array.isArray(value.seenMessageIds)
       ? value.seenMessageIds.filter((id) => typeof id === 'string' && id).slice(-1_000)
       : [],
@@ -27,6 +29,7 @@ export class ConversationStateStore {
   #path;
   #state = structuredClone(EMPTY_STATE);
   #writeQueue = Promise.resolve();
+  #deferred = deferredStateAccess(() => this.#state, () => this.#persist());
 
   constructor(path) {
     this.#path = path;
@@ -43,6 +46,11 @@ export class ConversationStateStore {
     return this;
   }
 
+  deferredEntries() { return this.#deferred.entries(); }
+  putDeferred(entry) { return this.#deferred.put(entry); }
+  patchDeferred(id, patch) { return this.#deferred.patch(id, patch); }
+  removeDeferred(id) { return this.#deferred.remove(id); }
+
   sessionFor(key) {
     return this.#state.sessions[key] ?? null;
   }