@xmanrui/dsh-im 4.31.0 → 4.33.0

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "description": "Connect Telegram, WhatsApp, Slack, Discord, Matrix, WeChat, Feishu, WeCom, DingTalk, and QQ to DSH."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "description": "把微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix接入DSH。"
+  }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.31.0",
+  "version": "4.33.0",
   "icon": "./assets/logo-plugin-message-link-gradient.webp",
-  "description": "把十二种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect twelve IM channels and a public AI Office to a local DeepSeek Harness.",
+  "description": "把微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix接入DSH。 Connect Telegram, WhatsApp, Slack, Discord, Matrix, WeChat, Feishu, WeCom, DingTalk, and QQ to DSH.",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -26,76 +26,6 @@
     "ai-office"
   ],
   "author": "xmanrui (https://github.com/xmanrui)",
-  "contributors": [
-    {
-      "name": "C3H3-AI",
-      "url": "https://github.com/C3H3-AI"
-    },
-    {
-      "name": "divingleee",
-      "url": "https://github.com/divingleee"
-    },
-    {
-      "name": "Chan-0312",
-      "url": "https://github.com/Chan-0312"
-    },
-    {
-      "name": "BuvkB",
-      "url": "https://github.com/BuvkB"
-    },
-    {
-      "name": "masucc",
-      "url": "https://github.com/masucc"
-    },
-    {
-      "name": "cherryFloris",
-      "url": "https://github.com/cherryFloris"
-    },
-    {
-      "name": "geekyfoxlab",
-      "url": "https://github.com/geekyfoxlab"
-    },
-    {
-      "name": "grloper",
-      "url": "https://github.com/grloper"
-    },
-    {
-      "name": "baijian",
-      "url": "https://github.com/baijian"
-    },
-    {
-      "name": "lyzhu86",
-      "url": "https://github.com/lyzhu86"
-    },
-    {
-      "name": "Librazy",
-      "url": "https://github.com/Librazy"
-    },
-    {
-      "name": "Johnslee1207",
-      "url": "https://github.com/johnslee1207-commits"
-    },
-    {
-      "name": "Dong09",
-      "url": "https://github.com/Dong09"
-    },
-    {
-      "name": "wings1848",
-      "url": "https://github.com/wings1848"
-    },
-    {
-      "name": "Zhe (Phil) Yang",
-      "url": "https://github.com/yangzhe1991"
-    },
-    {
-      "name": "Biertolovisk",
-      "url": "https://github.com/rosalynthompson32-a11y"
-    },
-    {
-      "name": "Tianjun Cai",
-      "url": "https://github.com/Pegasus02"
-    }
-  ],
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -116,13 +46,15 @@
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
     "assets",
     "bin",
     "cordis.patch.yml",
     "lib",
+    "locale/*.json",
     "plugin-src",
     "scripts/verify-interface-language.mjs",
     "scripts/verify-injected-context.mjs",

package/plugin-src/client/i18n.js

@@ -42,6 +42,8 @@ const EN = Object.freeze({
   '无需安装第三方服务；请按指引授予 macOS Messages 访问权限。': 'No third-party service is required; follow the guide to grant macOS Messages access.',
   'macOS Messages 权限': 'macOS Messages permissions',
   'IM机器人': 'IM bots',
+  '打开 IM机器人': 'Open IM bots',
+  '返回插件详情': 'Back to plugin details',
   'IM机器人设置': 'IM bot settings',
   'IM 面板加载失败': 'Could not load the IM panel',
   '更多机器人设置': 'More bot settings',

package/plugin-src/client/index.js

@@ -83,6 +83,7 @@ import { installSessionChannelLogos } from './session-channel-logos.js';
 import { UpdatePanel, UPDATE_RPC_CHANNEL } from './update-panel.js';
 import { WorkspaceDirectoryPickerContext } from './workspace-editor.js';
 import { IMPanelErrorBoundary } from './panel-error-boundary.js';
+import { installImPluginPage } from './plugin-page.js';
 
 export const name = 'im-settings';
 export const inject = ['slots', 'connection', 'locale', 'workspaces'];
@@ -566,6 +567,8 @@ export function apply(ctx) {
     preferredSectionId: props.preferredSectionId,
   });
 
+  installImPluginPage(ctx, { packageName: manifest.name, renderPanel: buildPanelElement });
+
   ctx.effect(() => {
     let disposed = false;
     let stopSettings = null;

package/plugin-src/client/plugin-page.js

@@ -0,0 +1,51 @@
+import * as React from 'react';
+import { IM_LOCALE_NAMESPACE } from './i18n.js';
+
+export const IM_MAIN_PANEL_ID = 'xmanrui-dsh-im';
+const h = React.createElement;
+
+function OpenImAction({ subject, packageName, onOpen, t }) {
+  if (subject?.kind !== 'bundle' && subject?.kind !== 'row') return null;
+  if (subject.pkg?.name !== packageName) return null;
+  if (subject.kind === 'row' && subject.row?.moduleName !== packageName) return null;
+  return h('button', {
+    type: 'button', className: 'dim-pluginOpen', onClick: onOpen,
+  }, t('打开 IM机器人'));
+}
+
+function ImPluginPage({ renderPanel, onBack, t }) {
+  return h('div', { className: 'dim-pluginPage' },
+    h('div', { className: 'dim-pluginPageContent' },
+      h('button', { type: 'button', className: 'dim-pluginBack', onClick: onBack },
+        h('span', { 'aria-hidden': true }, '‹'), t('返回插件详情')),
+      renderPanel()));
+}
+
+// Optional services and slots keep the existing settings entry working on
+// older DSH versions. Reuse the same panel through public navigation APIs.
+export function installImPluginPage(ctx, { packageName, renderPanel }) {
+  if (typeof ctx.inject !== 'function') return;
+  ctx.inject(['layout', 'pluginNavigation'], (pageCtx) =>
+    pageCtx.slots.inject('main', () => {
+      const unregisterPage = pageCtx.slots.register({
+        name: 'main', key: IM_MAIN_PANEL_ID, locale: IM_LOCALE_NAMESPACE,
+        inject: () => ({
+          renderPanel,
+          onBack: () => pageCtx.pluginNavigation.openBundle(packageName),
+        }),
+      }, ImPluginPage);
+      const stopActions = pageCtx.slots.inject('plugins.detail.actions', () =>
+        pageCtx.slots.register({
+          name: 'plugins.detail.actions', id: 'xmanrui-dsh-im-open',
+          order: 20, locale: IM_LOCALE_NAMESPACE,
+          inject: () => ({
+            packageName,
+            onOpen: () => pageCtx.layout.selectPanel(IM_MAIN_PANEL_ID),
+          }),
+        }, OpenImAction));
+      return () => {
+        stopActions();
+        unregisterPage();
+      };
+    }));
+}

package/plugin-src/client/styles.js

@@ -1,6 +1,15 @@
 export const IM_STYLE_ID = 'xmanrui-dsh-im-settings';
 
 const CSS = String.raw`
+.dim-pluginOpen { display: inline-flex; align-items: center; justify-content: center; min-height: 36px; padding: 7px 14px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 13px; line-height: 20px; cursor: pointer; }
+.dim-pluginOpen:hover { background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-pluginOpen:focus-visible, .dim-pluginBack:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 3px; }
+.dim-pluginPage { height: 100%; min-height: 0; overflow: auto; box-sizing: border-box; padding: 24px clamp(16px, 4vw, 48px) 32px; color: var(--dsw-alias-label-primary, #1f2329); }
+.dim-pluginPageContent { max-width: 1080px; margin: 0 auto; }
+.dim-pluginBack { display: inline-flex; align-items: center; gap: 8px; min-height: 36px; margin: 0 0 24px; padding: 6px 8px; border: 0; border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; font: inherit; font-size: 13px; line-height: 20px; cursor: pointer; }
+.dim-pluginBack:hover { color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-pluginBack > span { font-size: 22px; line-height: 20px; }
+@media (pointer: coarse) { .dim-pluginOpen, .dim-pluginBack { min-height: 44px; } }
 .dim-connectionDiagnostic { min-width: 0; width: 100%; color: var(--dsw-alias-label-secondary, #646a73); overflow-wrap: anywhere; font-size: 13px; line-height: 1.6; }
 .dim-connectionDiagnostic[data-warning="true"] { color: var(--dsw-alias-state-warn-primary, #d97706); }
 .dim-connectionDiagnostic p { margin: 4px 0; }

package/plugin-src/host/delivery-adapter.mjs

@@ -233,6 +233,14 @@ export function createDeliveryAdapter({ channel, workspaces, coreController, sta
   }
   return Object.freeze({
     channel,
+    describeAccount: (botId) => {
+      if (typeof coreController.describeDeliveryAccount !== 'function') {
+        const error = new Error('Verified account capability unavailable');
+        error.code = 'capability-unavailable';
+        throw error;
+      }
+      return coreController.describeDeliveryAccount(botId);
+    },
     ownsBot: (botId) => workspaces.has(botId),
     listBots: () => workspaces.listBotIds(),
     async listTargets(botId) {

package/plugin-src/host/delivery-service.mjs

@@ -1,3 +1,4 @@
+import { createHash } from 'node:crypto';
 import { normalizeDeliveryTarget } from './delivery-adapter.mjs';
 
 const BOT_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
@@ -18,6 +19,10 @@ const ADAPTER_METHODS = Object.freeze([
 
 const DELIVERY_ERROR_CODES = new Set([
   'bad-request',
+  'account-unverified',
+  'account-changed',
+  'target-changed',
+  'capability-unavailable',
   'unknown-bot',
   'unknown-target',
   'target-conflict',
@@ -290,6 +295,63 @@ export class DeliveryService {
     }
   }
 
+  #assertRegistered(registration) {
+    if (this.#adapters.get(registration.adapter.channel) !== registration) {
+      throw deliveryError('capability-unavailable');
+    }
+  }
+
+  async describeBot(botId) {
+    const id = botIdOf(botId);
+    const registration = await this.#checkedRegistrationFor(id);
+    const { adapter } = registration;
+    if (typeof adapter.describeAccount !== 'function') throw deliveryError('capability-unavailable');
+    this.#assertRegistered(registration);
+    try {
+      const account = await adapter.describeAccount(id);
+      this.#assertRegistered(registration);
+      return account;
+    } catch (error) { throw publicOperationError(error); }
+  }
+
+  async sendChecked(botId, targetId, text, { expectedFingerprint, expectedTargetDigest, signal, format = 'plain' } = {}) {
+    const id = botIdOf(botId);
+    const key = targetIdOf(targetId);
+    if (typeof text !== 'string' || !text.trim() || !['plain', 'markdown'].includes(format)
+      || !/^[a-f0-9]{64}$/.test(expectedFingerprint ?? '') || !/^[a-f0-9]{64}$/.test(expectedTargetDigest ?? '')) {
+      throw deliveryError('bad-request');
+    }
+    cancellation(signal);
+    const registration = await this.#checkedRegistrationFor(id);
+    const { adapter } = registration;
+    if (typeof adapter.describeAccount !== 'function') throw deliveryError('capability-unavailable');
+    this.#assertRegistered(registration);
+    try {
+      const candidates = await adapter.listTargets(id);
+      const saved = candidates.find((target) => target?.targetId === key);
+      if (!saved) throw deliveryError('unknown-target');
+      const target = normalizeDeliveryTarget(adapter.channel, {
+        targetId: saved.targetId, kind: saved.kind, route: structuredClone(saved.route),
+      });
+      const digest = createHash('sha256').update(JSON.stringify({ kind: target.kind,
+        route: Object.fromEntries(Object.entries(target.route).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) })).digest('hex');
+      if (digest !== expectedTargetDigest) throw deliveryError('target-changed');
+      const account = await adapter.describeAccount(id);
+      if (account?.version !== 1 || !account.capabilities?.includes('proactive-text-checked')) {
+        throw deliveryError('capability-unavailable');
+      }
+      if (account.account?.fingerprint !== expectedFingerprint) throw deliveryError('account-changed');
+      const beforeSend = () => {
+        cancellation(signal);
+        this.#assertRegistered(registration);
+      };
+      beforeSend();
+      await adapter.sendText(id, target, text, { signal, expectedFingerprint, beforeSend,
+        ...(format === 'markdown' ? { format } : {}) });
+      return { sent: true };
+    } catch (error) { throw publicOperationError(error); }
+  }
+
   async send(botId, targetIdOrDraft, text, { signal, format = 'plain' } = {}) {
     const id = botIdOf(botId);
     const targetKey = typeof targetIdOrDraft === 'string'
@@ -328,6 +390,19 @@ export class DeliveryService {
     }
   }
 
+  async #checkedRegistrationFor(botId) {
+    for (const registration of this.#adapters.values()) {
+      let ownsBot;
+      try { ownsBot = await registration.adapter.ownsBot(botId); }
+      catch (error) { throw publicOperationError(error); }
+      if (ownsBot) {
+        this.#assertRegistered(registration);
+        return registration;
+      }
+    }
+    throw deliveryError('unknown-bot', 'Unknown bot');
+  }
+
   async #adapterFor(botId) {
     for (const { adapter } of this.#adapters.values()) {
       let ownsBot;

package/plugin-src/host/host-language.mjs

@@ -125,33 +125,33 @@ export function installHostLanguage(ctx, config = {}, internals = {}) {
     config: config.language ?? process.env.DSH_IM_LANGUAGE,
     logger,
   });
-  // Read an already-attached settings service synchronously: channels start
-  // inside the same activation, and waiting for the injection callback would
-  // let the first bot register its command menu in the previous language and
-  // then need a second push. The injection below keeps it live afterwards and
-  // covers a provider that attaches later.
-  controller.observeSettings(
-    () => ctx?.settings?.get?.(DSH_LOCALE_NAMESPACE)?.[DSH_LOCALE_PREFERENCE_FIELD],
-  );
-  const ready = Promise.resolve()
+  // Only the injected context may access settings. Waiting for its current
+  // lifecycle work does not wait for an absent provider to arrive.
+  let settingsBinding;
+  const readPreference = (settings) => typeof settings?.describe === 'function'
+    ? settings.describe().find((row) => row.ns === DSH_LOCALE_NAMESPACE)
+      ?.value?.[DSH_LOCALE_PREFERENCE_FIELD]
+    : settings?.get?.(DSH_LOCALE_NAMESPACE)?.[DSH_LOCALE_PREFERENCE_FIELD];
+  if (typeof ctx?.inject === 'function') {
+    settingsBinding = ctx.inject(['settings'], (settingsCtx) => {
+      controller.observeSettings(() => readPreference(settingsCtx.settings));
+      for (const event of ['settings/updated', 'settings/document-updated']) {
+        settingsCtx.on(event, (namespace) => {
+          if (namespace === DSH_LOCALE_NAMESPACE) controller.apply();
+        });
+      }
+      // Do not retain a reader bound to a withdrawn service/context.
+      return () => { controller.observeSettings(); };
+    });
+  }
+  const ready = Promise.resolve(settingsBinding)
     .then(() => store.load?.())
     .then(() => controller.apply(), (error) => {
       logger?.error?.(
-        '[dsh-im] could not read the mirrored DSH interface language; falling back to Chinese',
+        '[dsh-im] could not initialize the DSH interface language; falling back to the available language',
         error,
       );
       return controller.snapshot();
     });
-  if (typeof ctx?.inject === 'function') {
-    ctx.inject(['settings'], (settingsCtx) => {
-      controller.observeSettings(
-        () => settingsCtx.settings?.get?.(DSH_LOCALE_NAMESPACE)?.[DSH_LOCALE_PREFERENCE_FIELD],
-      );
-      settingsCtx.on('settings/updated', (namespace) => {
-        if (namespace !== DSH_LOCALE_NAMESPACE) return;
-        controller.apply();
-      });
-    });
-  }
   return Object.freeze({ ...controller, ready });
 }

package/plugin-src/host/index.mjs

@@ -91,6 +91,9 @@ export function createImHostPlugin(internals = {}) {
       const deliveryService = makeDeliveryService({ unavailableSessionSyncChannels });
       if (typeof ctx?.provide === 'function') {
         ctx.provide('dshIm', Object.freeze({
+          contractVersion: 1,
+          describeBot: (botId) => deliveryService.describeBot(botId),
+          sendChecked: (botId, targetId, text, options) => deliveryService.sendChecked(botId, targetId, text, options),
           send: (botId, targetId, text, options) => (
             deliveryService.send(botId, targetId, text, options)
           ),

package/plugin-src/host/session-sync-coordinator.mjs

@@ -23,6 +23,7 @@ function sessionIdOf(session) {
 
 function userInputOrigin(scope, event) {
   const source = event?.data?.source;
+  if (source?.kind === 'schedule') return 'dsh';
   if (source?.kind !== 'user' || typeof source.rpcId !== 'string' || !source.rpcId) {
     return 'other';
   }
@@ -112,12 +113,9 @@ export function createSessionSyncCoordinator({ deliveryService, logger = console
       if (event.surfaceOp !== 'append') return;
       if (state.origin === 'unknown') state.origin = origin;
       if (state.origin !== 'dsh' || origin !== 'dsh') return;
-      // The user echo stays as plain text even when the mirror owns the
-      // turn: the card also quotes the question, but keeping the echo here
-      // guarantees recipients are established so a failed mirror can still
-      // fall back to the final-answer text delivery.
+      const scheduled = event.data?.source?.kind === 'schedule';
       const text = textFromHarnessContent(event.data?.content);
-      if (!text) return;
+      if (!text && !scheduled) return;
 
       let targets;
       try {
@@ -126,17 +124,16 @@ export function createSessionSyncCoordinator({ deliveryService, logger = console
         logFailure('lookup', null, error);
         targets = [];
       }
-      const successful = await deliver(
-        sessionId,
-        targets,
-        `${DSH_USER_PREFIX}${text}`,
-        'user delivery',
-      );
+      // Scheduled framing is internal: select its recipients without echoing it.
+      // Direct DSH input still requires a successful echo before the final answer.
+      const recipients = scheduled
+        ? new Map(targets.filter(validRecipient).map((target) => [recipientKey(target), target]))
+        : await deliver(sessionId, targets, `${DSH_USER_PREFIX}${text}`, 'user delivery');
       if (state.recipients === null) {
-        state.recipients = successful;
+        state.recipients = recipients;
       } else {
         for (const key of [...state.recipients.keys()]) {
-          if (!successful.has(key)) state.recipients.delete(key);
+          if (!recipients.has(key)) state.recipients.delete(key);
         }
       }
       return;

package/src/channels/feishu/bridge.mjs

@@ -1,3 +1,4 @@
+import { randomUUID } from 'node:crypto';
 import QRCode from 'qrcode';
 import {
   conversationKey,
@@ -2307,7 +2308,9 @@ export class FeishuHarnessBridge {
     // A used card is recent even if it was first created long ago.
     this.#cardKeys.delete(messageId);
     this.#cardKeys.set(messageId, route);
-    const entry = { ...route, messageId, selections: multiValues, operatorOpenId };
+    const newSessionActionId = nonEmptyString(actionValue.newSessionActionId);
+    if (resolvedAction === 'new' && (!route.menuContext || !newSessionActionId)) return Promise.resolve();
+    const entry = { ...route, messageId, selections: multiValues, operatorOpenId, newSessionActionId };
     const source = nonEmptyString(actionValue.source);
     const formText = nonEmptyString(formValue.steer_text);
     const eventId = nonEmptyString(event?.event_id)
@@ -2316,6 +2319,7 @@ export class FeishuHarnessBridge {
       ?? nonEmptyString(event?.header?.uuid);
     const identity = JSON.stringify({
       messageId,
+      newSessionActionId,
       resolvedAction,
       option,
       multiValues,
@@ -2517,6 +2521,8 @@ export class FeishuHarnessBridge {
     sessionLimit = null,
     selections = [],
     actor = null,
+    menuContext = null,
+    newSessionActionId = null,
   }) {
     // Confirmations triggered by a card interaction stay anchored to the
     // card's message so they land inside the same Feishu topic.
@@ -2666,6 +2672,10 @@ export class FeishuHarnessBridge {
       return;
     }
     if (action === 'new') {
+      if (menuContext || newSessionActionId) {
+        await this.#handleNewSessionMenu({ key, chatId, messageId, menuContext, newSessionActionId });
+        return;
+      }
       if (this.#queues.has(key) || this.#hasPendingInteraction(key)) {
         await reply(t('当前任务仍在运行，请先停止任务或等待任务完成后再开启新会话。'));
         return;
@@ -2799,6 +2809,61 @@ export class FeishuHarnessBridge {
     }
   }
 
+  async #handleNewSessionMenu({ key, chatId, messageId, menuContext, newSessionActionId }) {
+    // The generation belongs to this rendered menu, not the whole conversation.
+    // Check inside the queue as well as consuming the action before any await:
+    // distinct provider events and late callbacks must not clear a later session.
+    const action = menuContext?.newSessionAction;
+    if (!action || this.#cardKeys.get(messageId)?.menuContext !== menuContext
+      || action.id !== newSessionActionId
+      || !['idle', 'failed'].includes(action.status)) return;
+
+    action.status = 'processing';
+    delete action.message;
+    await this.#patchCardMessage(chatId, messageId, menuCard(menuContext));
+
+    const finish = async (status, message = null) => {
+      if (menuContext.currentSession && !this.#state.sessionFor(key)) {
+        menuContext.currentSession = null;
+        // The old menu may show a session-specific model. After unbinding,
+        // refresh the bot default just as opening a fresh menu would.
+        try {
+          menuContext.modelCatalog = await this.#harness.listModels({ signal: this.#cardDataSignal() });
+        } catch {
+          menuContext.modelCatalog = null;
+        }
+      }
+      menuContext.newSessionAction = {
+        id: status === 'failed' ? randomUUID() : action.id,
+        status,
+        message,
+      };
+      const patched = await this.#patchCardMessage(chatId, messageId, menuCard(menuContext));
+      if (!patched) {
+        await this.#send(chatId, t('新会话操作的卡片状态未能更新，请发送 /m 重新打开菜单。'), { replyTo: messageId })
+          .catch((error) => this.#logger.warn?.('[dsh-feishu] menu state notice failed:', error?.message));
+      }
+    };
+    // A task can start while Feishu is updating the processing card.
+    if (this.#queues.has(key) || this.#hasPendingInteraction(key)) {
+      const message = t('当前任务仍在运行，请先停止任务或等待任务完成后再开启新会话。');
+      await finish('failed', message);
+      await this.#send(chatId, message, { replyTo: messageId });
+      return;
+    }
+    try {
+      await this.#state.clearSession(key);
+    } catch (error) {
+      // A persistence error can still leave the in-memory binding cleared.
+      await finish('failed', safeErrorText(error));
+      throw error;
+    }
+    await finish('success');
+    // A receipt delivery failure must not turn a completed reset into a retry.
+    await this.#send(chatId, t('已开启全新 Harness 会话。'), { replyTo: messageId })
+      .catch((error) => this.#logger.warn?.('[dsh-feishu] new session receipt failed:', error?.message));
+  }
+
   #rememberMenu(key, menu) {
     if (this.#menus.size >= MAX_TRACKED_MENUS) {
       const oldest = this.#menus.keys().next().value;
@@ -3002,6 +3067,7 @@ export class FeishuHarnessBridge {
       key: options.key,
       chatId,
       conversationWorkspace: options.conversationWorkspace,
+      menuContext: options.menuContext ?? null,
       sessionWorkspace: typeof options.sessionWorkspace === 'string' && options.sessionWorkspace
         ? options.sessionWorkspace
         : null,
@@ -3213,14 +3279,16 @@ export class FeishuHarnessBridge {
     }
     const archiveVisible = this.#state?.includesArchivedSessions?.() ?? false;
     this.#rememberMenu(key, { kind: 'menu', chatId });
+    const menuContext = {
+      workspaces, currentWorkspace,
+      currentSession: currentSessionId ? { id: currentSessionId, title: currentSessionTitle } : null,
+      sessions, archiveVisible, presetCatalog, modelCatalog,
+      newSessionAction: { id: randomUUID(), status: 'idle' },
+    };
     await this.#sendCard(
       chatId,
-      menuCard({
-        workspaces, currentWorkspace,
-        currentSession: currentSessionId ? { id: currentSessionId, title: currentSessionTitle } : null,
-        sessions, archiveVisible, presetCatalog, modelCatalog,
-      }),
-      { key, updateMessageId, replyTo, conversationWorkspace },
+      menuCard(menuContext),
+      { key, updateMessageId, replyTo, conversationWorkspace, menuContext },
     );
   }
 

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

@@ -123,6 +123,7 @@ function backButton() {
  *   - archiveVisible: boolean       (归档显隐开关当前值)
  *   - presetCatalog: object|null    (预设目录, {items,defaultId,_currentId})
  *   - modelCatalog: object|null     (模型目录, {groups,current})
+ *   - newSessionAction: {id,status,message?}|null (新会话按钮的执行状态)
  * Number fallback: 1=续写 2=新会话 3=会话列表 4=状态
  * 5=补全权限 6=帮助.
  */
@@ -135,6 +136,7 @@ export function menuCard(ctx) {
     archiveVisible = false,
     presetCatalog = null,
     modelCatalog = null,
+    newSessionAction = null,
   } = ctx || {};
 
   // currentSession 提供 id/title；为兼容旧调用，也接受 currentSessionTitle
@@ -146,6 +148,19 @@ export function menuCard(ctx) {
   const hasWorkspaces = Array.isArray(workspaces) && workspaces.length > 0;
   const elements = [];
 
+  let newSessionLabel = t('🆕 新会话');
+  if (newSessionAction?.status === 'processing') {
+    newSessionLabel = t('正在开启…');
+    elements.push({ tag: 'div', text: plainText(t('正在开启新会话…')) });
+  } else if (newSessionAction?.status === 'success') {
+    newSessionLabel = t('已执行：新会话');
+    elements.push({ tag: 'div', text: plainText(t('已执行：新会话。发送消息即可开始。')) });
+  } else if (newSessionAction?.status === 'failed') {
+    elements.push({ tag: 'div', text: plainText(t('新会话操作失败：{message}', {
+      message: newSessionAction.message || t('卡片操作失败，请稍后重试。'),
+    })) });
+  }
+
   // ── 设置区 ──────────────────────────────────────────────────
   elements.push({ tag: 'div', text: markdown(t('**设置**')) });
 
@@ -270,7 +285,15 @@ export function menuCard(ctx) {
   });
 
   // 新会话 + 全部会话按钮
-  elements.push(buttonPair(t('🆕 新会话'), 'new', t('📋 会话/关注'), 'sessions'));
+  const sessionButtons = buttonPair(newSessionLabel, 'new', t('📋 会话/关注'), 'sessions');
+  const newSessionButton = sessionButtons.columns[0].elements[0];
+  if (newSessionAction?.id) {
+    newSessionButton.behaviors[0].value.newSessionActionId = newSessionAction.id;
+  }
+  if (newSessionAction?.status === 'processing' || newSessionAction?.status === 'success') {
+    newSessionButton.disabled = true;
+  }
+  elements.push(sessionButtons);
   if (!hasSessions && !hasWorkspaces) {
     elements.push(button(t('🗂 工作区列表'), 'workspaces'));
   }