@xmanrui/dsh-im 4.23.0 → 4.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.23.0",
+  "version": "4.24.0",
   "description": "把十一种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect eleven IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
@@ -110,7 +110,12 @@
     "cordis.patch.yml",
     "lib",
     "plugin-src",
-    "scripts",
+    "scripts/verify-interface-language.mjs",
+    "scripts/verify-lan-management.mjs",
+    "scripts/verify-model-setting.mjs",
+    "scripts/verify-package.mjs",
+    "scripts/verify-session-channel-logos.mjs",
+    "scripts/verify-session-title-prefix.mjs",
     "src",
     "PROACTIVE_DELIVERY.md",
     "PROACTIVE_DELIVERY.en.md",

package/plugin-src/client/channels/feishu/index.js

@@ -466,7 +466,7 @@ function RemoveConfirmation({ bot, busy, onConfirm, onCancel }) {
   );
 }
 
-/** One select for the step-push presentation: off / per-step posts / process card. */
+/** One select for the step-push presentation. */
 function StepPushEditor({ value = false, mode = "post", disabled = false, onSave, onModeSave }) {
   const titleId = React.useId();
   const helpId = `${titleId}-help`;
@@ -496,7 +496,7 @@ function StepPushEditor({ value = false, mode = "post", disabled = false, onSave
         if (value === true) await onSave?.(false);
         return;
       }
-      const nextMode = next === "streaming_card" ? "streaming_card" : "post";
+      const nextMode = ["streaming_card", "live_cot"].includes(next) ? next : "post";
       // Enabling (or switching presentation) may need both writes; the flag
       // must land before the mode so the runtime never sees a mode without
       // step push enabled.
@@ -507,7 +507,9 @@ function StepPushEditor({ value = false, mode = "post", disabled = false, onSave
 
   const helpText = current === "off"
     ? "适合日常问答：执行过程中不显示工具调用等中间步骤，只回复最终结果"
-    : current === "streaming_card"
+    : current === "live_cot"
+      ? "使用飞书原生思考过程展示推理、工具调用与结果，最终答案单独发送"
+      : current === "streaming_card"
       ? "推荐长任务使用：过程与最终答案都在同一张卡片里实时更新，不刷屏"
       : "每一步都单独发一条消息（含工具调用和过程说明）；注意长任务会连续发送较多消息";
 
@@ -529,7 +531,7 @@ function StepPushEditor({ value = false, mode = "post", disabled = false, onSave
           id: helpId,
           className: "dim-presetTooltip",
           role: "tooltip",
-        }, "设置任务执行过程的呈现方式：不显示、实时卡片或逐步消息"))),
+        }, "设置任务执行过程的呈现方式：不显示、原生直播、实时卡片或逐步消息"))),
     saving
       ? h("span", { className: "dim-feishuGroupControlStatus", role: "status" }, "保存中…")
       : null),
@@ -541,6 +543,7 @@ function StepPushEditor({ value = false, mode = "post", disabled = false, onSave
     onChange: change,
   },
   h("option", { value: "off" }, "不显示过程（只发送最终答案）"),
+  h("option", { value: "live_cot" }, "实时直播（飞书原生思考过程）"),
   h("option", { value: "streaming_card" }, "实时过程卡（全程一张卡片动态更新）"),
   h("option", { value: "post" }, "逐步直播（每一步单独发一条消息）")),
   h("p", { className: "dim-feishuGroupHelp" }, helpText),

package/plugin-src/client/channels/shared/token-api.js

@@ -38,6 +38,7 @@ export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
   setAlias: 'bot.alias.set',
+  setThinkingTraces: 'bot.thinking-traces.set',
 });
 
 export function createTokenChannelApi(channel, connectionSummary, {
@@ -69,6 +70,8 @@ export function createTokenChannelApi(channel, connectionSummary, {
       model: normalizeModelSelection(value.model),
       agentPreset: normalizeAgentPresetId(value.agentPreset),
       contextEnhancement: normalizeContextEnhancementConfig(value.contextEnhancement),
+      // Absent from the backend means ON; only an explicit false opts out.
+      thinkingTraces: value.thinkingTraces !== false,
       ...(Object.hasOwn(value, 'accessPolicy')
         ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
         : {}),

package/plugin-src/client/channels/telegram/index.js

@@ -4,6 +4,7 @@ import {
   TELEGRAM_ENDPOINTS,
   telegramClientApi,
 } from './api.js';
+import { ThinkingTracesSettings } from './thinking-traces.js';
 import { installTelegramStyles } from './styles.js';
 
 const channel = createTokenChannelSettings({
@@ -19,6 +20,8 @@ const channel = createTokenChannelSettings({
   emptyTitle: '接入 Telegram 机器人',
   emptyDescription: '先通过 @BotFather 获取 Bot Token，再在这里完成接入。',
   platformLabel: 'Telegram',
+  AccountSettings: ThinkingTracesSettings,
+  accountSettingsEndpoint: 'bot.thinking-traces.set',
 });
 
 export const TelegramSettingsTab = channel.SettingsTab;

package/plugin-src/client/channels/telegram/styles.js

@@ -4,6 +4,18 @@ const CSS = String.raw`
 .dtg-page { --ddt-accent: #229ed9; --ddt-accent-deep: #1687bd; --ddt-accent-wash: #eaf7fd; }
 .dtg-avatar { color: #fff; background: #229ed9; }
 .dtg-avatar svg { display: block; }
+.dim-accountSettings { margin-top: 14px; padding-top: 12px; border-top: 1px solid var(--dsw-alias-border-l2, #eceef1); }
+.dim-accountSettingsTitle { margin: 0 0 8px; font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-secondary, #646a73); letter-spacing: 0.02em; }
+.dim-accountSettingsRow { display: flex; align-items: center; justify-content: space-between; gap: 12px; min-height: 40px; cursor: pointer; }
+.dim-accountSettingsText { min-width: 0; display: flex; flex-direction: column; gap: 2px; }
+.dim-accountSettingsLabel { font-size: 13px; font-weight: 500; color: var(--dsw-alias-label, #1f2329); }
+.dim-accountSettingsHelp { font-size: 12px; color: var(--dsw-alias-label-tertiary, #8a919f); }
+.dim-accountSettingsSwitch { appearance: none; flex: none; width: 32px; height: 19px; margin: 0; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 12px; background: var(--dsw-alias-interactive-bg-hover, #eef0f3); cursor: pointer; position: relative; }
+.dim-accountSettingsSwitch::before { content: ""; position: absolute; top: 2px; left: 2px; width: 13px; height: 13px; border-radius: 50%; background: var(--dsw-alias-label-secondary, #646a73); transition: transform 120ms ease, background 120ms ease; }
+.dim-accountSettingsSwitch:checked { border-color: #229ed9; background: #229ed9; }
+.dim-accountSettingsSwitch:checked::before { transform: translateX(13px); background: #fff; }
+.dim-accountSettingsSwitch:disabled { opacity: 0.5; cursor: not-allowed; }
+@media (prefers-reduced-motion: reduce) { .dim-accountSettingsSwitch::before { transition: none; } }
 `;
 
 export function installTelegramStyles() {

package/plugin-src/client/channels/telegram/thinking-traces.js

@@ -0,0 +1,25 @@
+/**
+ * 会话行为设置块：思考过程留痕开关（Telegram 专属）。
+ *
+ * 开启后，机器人把 agent 的推理与工具调用作为独立的 💭/🔧 消息实时发出来，
+ * 最终答案单独成条；关闭则回到「占位符被最终答案覆盖」的原有单消息行为。
+ */
+import { h } from '../../i18n.js';
+
+export function ThinkingTracesSettings({ account, busy, onSave }) {
+  const checked = account.thinkingTraces !== false;
+  return h('div', { className: 'dim-accountSettings' },
+    h('h4', { className: 'dim-accountSettingsTitle' }, '会话行为'),
+    h('label', { className: 'dim-accountSettingsRow' },
+      h('span', { className: 'dim-accountSettingsText' },
+        h('span', { className: 'dim-accountSettingsLabel' }, '思考过程留痕'),
+        h('span', { className: 'dim-accountSettingsHelp' },
+          '实时显示思考步骤与工具调用，最终答案单独成条')),
+      h('input', {
+        type: 'checkbox',
+        className: 'dim-accountSettingsSwitch',
+        checked,
+        disabled: Boolean(busy),
+        onChange: (event) => { onSave?.({ thinkingTraces: event.target.checked }); },
+      })));
+}

package/plugin-src/client/i18n.js

@@ -262,11 +262,13 @@ const EN = Object.freeze({
   '查看分步直推说明': 'View step push help',
   '开启后逐步推送工具调用与过程说明': 'Push tool calls and process notes step by step',
   '任务过程展示': 'Task progress display',
-  '设置任务执行过程的呈现方式：不显示、实时卡片或逐步消息': 'Choose how the execution is presented: hidden, one live card, or step-by-step messages',
+  '设置任务执行过程的呈现方式：不显示、原生直播、实时卡片或逐步消息': 'Choose how execution is presented: hidden, native live process, one live card, or step-by-step messages',
   '不显示过程（只发送最终答案）': 'Hide the process (send the final answer only)',
+  '实时直播（飞书原生思考过程）': 'Live process (native Feishu thinking process)',
   '实时过程卡（全程一张卡片动态更新）': 'Live process card (one card updated throughout)',
   '逐步直播（每一步单独发一条消息）': 'Step-by-step feed (one message per step)',
   '适合日常问答：执行过程中不显示工具调用等中间步骤，只回复最终结果': 'For everyday Q&A: tool calls and other interim steps stay hidden, only the final result is replied',
+  '使用飞书原生思考过程展示推理、工具调用与结果，最终答案单独发送': 'Use Feishu’s native thinking process for reasoning, tool calls, and results, then send the final answer separately',
   '推荐长任务使用：过程与最终答案都在同一张卡片里实时更新，不刷屏': 'Recommended for long tasks: the process and the final answer update live in one card without flooding the chat',
   '每一步都单独发一条消息（含工具调用和过程说明）；注意长任务会连续发送较多消息': 'Every step is sent as its own message (including tool calls and notes); long tasks may send many messages in a row',
   '分步直推设置保存失败，请重试。': 'Could not save the step push setting. Try again.',
@@ -667,6 +669,11 @@ const EN = Object.freeze({
   '接入 Telegram 机器人': 'Connect a Telegram bot',
   '先通过 @BotFather 获取 Bot Token，再在这里完成接入。': 'Get a Bot Token from @BotFather, then connect it here.',
   '填写 @BotFather 生成的 Bot Token': 'Enter the Bot Token from @BotFather',
+  '会话行为': 'Conversation behavior',
+  '思考过程留痕': 'Thinking traces',
+  '实时显示思考步骤与工具调用，最终答案单独成条': 'Show thinking steps and tool calls as they happen; the final answer arrives as its own message',
+  '请提交有效的思考过程留痕设置。': 'Submit a valid thinking-traces setting.',
+  '正在使用{name}…': 'Using {name}…',
   '访问模式': 'Access mode',
   'Telegram 访问模式': 'Telegram access mode',
   '查看 Telegram 访问模式说明': 'View Telegram access mode details',

package/plugin-src/client/index.js

@@ -324,8 +324,16 @@ export function IMSettingsTab({
           'aria-label': 'dsh-im GitHub',
           'aria-describedby': githubTooltipId,
         },
-        h('span', null, 'GitHub'),
-        h('span', { className: 'dim-githubArrow', 'aria-hidden': 'true' }, '↗')),
+        h('svg', {
+          width: 18,
+          height: 18,
+          viewBox: '0 0 16 16',
+          fill: 'currentColor',
+          focusable: 'false',
+          'aria-hidden': 'true',
+        }, h('path', {
+          d: 'M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82a7.65 7.65 0 0 1 2-.27c.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8Z',
+        }))),
         h('span', {
           id: githubTooltipId,
           className: 'dim-githubTooltip',

package/plugin-src/client/styles.js

@@ -93,10 +93,10 @@ const CSS = String.raw`
 .dim-updateFooter .dim-updateButton:first-child { margin-right: auto; }
 .dim-updatePrimary, .dim-updatePrimary:hover:not(:disabled) { border-color: var(--dsw-alias-state-business-primary, #3370ff); color: #fff; background: var(--dsw-alias-state-business-primary, #3370ff); }
 .dim-githubAction { position: relative; display: inline-flex; flex: none; }
-.dim-githubLink { min-height: 30px; display: inline-flex; align-items: center; gap: 5px; flex: none; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); font-size: 12px; line-height: normal; font-weight: 560; text-decoration: none; transition: border-color .15s ease, color .15s ease, background .15s ease; }
+.dim-githubLink { width: 30px; height: 30px; display: grid; place-items: center; flex: none; padding: 0; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); text-decoration: none; transition: border-color .15s ease, color .15s ease, background .15s ease; }
+.dim-githubLink svg { display: block; }
 .dim-githubLink:hover { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-githubLink:focus-visible { outline: 2px solid color-mix(in srgb, var(--dim-blue) 70%, white); outline-offset: 2px; }
-.dim-githubArrow { font-size: 13px; line-height: 1; }
 .dim-githubTooltip { position: absolute; top: calc(100% + 8px); right: 0; z-index: 20; width: max-content; max-width: min(220px, 80vw); padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; font-weight: 500; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
 .dim-githubAction:hover .dim-githubTooltip, .dim-githubAction:focus-within .dim-githubTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-generalSettingsAction { position: relative; display: inline-flex; flex: none; }

package/plugin-src/host/channels/shared/rpc.mjs

@@ -15,6 +15,7 @@ import {
   validAgentPresetPayload,
 } from './agent-preset-rpc.mjs';
 import { SET_MODEL_ENDPOINT, validModelPayload } from './model-setting-rpc.mjs';
+import { SET_THINKING_TRACES_ENDPOINT, validThinkingTracesPayload } from './thinking-traces-rpc.mjs';
 
 export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   status: 'connection.status',
@@ -27,6 +28,7 @@ export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
   setAccessPolicy: SET_ACCESS_POLICY_ENDPOINT,
   setAlias: SET_ALIAS_ENDPOINT,
+  setThinkingTraces: SET_THINKING_TRACES_ENDPOINT,
 });
 
 const ENDPOINTS = Object.freeze(Object.values(TOKEN_BOT_ENDPOINTS));
@@ -97,6 +99,10 @@ function payloadFailure(endpoint, payload) {
     return validAliasPayload(payload)
       ? null : '请输入有效的别名（最多 80 个字符）。';
   }
+  if (endpoint === TOKEN_BOT_ENDPOINTS.setThinkingTraces) {
+    return validThinkingTracesPayload(payload)
+      ? null : '请提交有效的思考过程留痕设置。';
+  }
   return 'Unknown bot endpoint.';
 }
 
@@ -194,6 +200,9 @@ export function createTokenBotRpcHandler(controller, { channel }) {
       } else if (endpoint === TOKEN_BOT_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await controller.updateAgentPreset(payload.botId, payload.agentPreset);
+      } else if (endpoint === TOKEN_BOT_ENDPOINTS.setThinkingTraces) {
+        if (typeof controller.setThinkingTraces !== 'function') throw new Error('Thinking traces update is unavailable');
+        value = await controller.setThinkingTraces(payload.botId, payload.thinkingTraces);
       } else {
         value = await controller.deleteBot(payload.botId);
       }

package/plugin-src/host/channels/shared/thinking-traces-rpc.mjs

@@ -0,0 +1,11 @@
+export const SET_THINKING_TRACES_ENDPOINT = 'bot.thinking-traces.set';
+
+export function validThinkingTracesPayload(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)
+    || Reflect.ownKeys(payload).length !== 2
+    || !Object.hasOwn(payload, 'botId') || !Object.hasOwn(payload, 'thinkingTraces')
+    || typeof payload.botId !== 'string'
+    || !/^[A-Za-z0-9_-]{1,128}$/.test(payload.botId)
+    || typeof payload.thinkingTraces !== 'boolean') return false;
+  return true;
+}

package/plugin-src/host/modern-harness-api.mjs

@@ -382,7 +382,7 @@ class ModernHarnessApi {
       return;
     }
     if (frame.type !== 'chunk' || frame.index !== stream.entries.length) return;
-    stream.entries.push({
+    const entry = {
       type: 'transient',
       event: {
         type: 'assistant/chunk',
@@ -392,7 +392,12 @@ class ModernHarnessApi {
         time: frame.time,
         data: { turn: stream.turn, step: stream.step, chunk: frame.chunk },
       },
-    });
+    };
+    stream.entries.push(entry);
+    // History only exposes these transient chunks while the attempt is open.
+    // Broadcast each one as it arrives so live IM renderers cannot miss a
+    // short reasoning phase that starts and commits between two history polls.
+    this.#broadcast({ type: 'session/event', sessionId, event: entry.event });
   }
 
   #withAssistantStream(sessionId, entries) {

package/scripts/verify-package.mjs

@@ -142,22 +142,28 @@ if (client.includes('settings.plugins.tab') || clientSources.includes('settings.
   throw new Error('client source or bundle still contains the legacy Plugins-tab settings entry');
 }
 // Connections still have no channel-enable toggle. Checkable inputs are owned
-// only by the shared context editor and the saved-target Session sync row.
+// only by the shared context editor, the saved-target Session sync row, the
+// email settings, and the Telegram thinking-traces block.
 // The context editor contains one switch template and one mapped field-input
-// template; the delivery target adds one ordinary checkbox template.
+// template; the delivery target adds one ordinary checkbox template; the
+// Telegram thinking-traces block adds one ordinary checkbox template.
 const contextEditorSource = await readFile(resolve(root, 'plugin-src/client/context-enhancement.js'), 'utf8');
 const deliverySettingsSource = await readFile(resolve(root, 'plugin-src/client/delivery-settings.js'), 'utf8');
 const emailSettingsSource = await readFile(resolve(root, 'plugin-src/client/channels/email/index.js'), 'utf8');
+const thinkingTracesSource = await readFile(resolve(root, 'plugin-src/client/channels/telegram/thinking-traces.js'), 'utf8');
 const otherClientSources = clientSources
   .replace(contextEditorSource, '')
   .replace(deliverySettingsSource, '')
-  .replace(emailSettingsSource, '');
+  .replace(emailSettingsSource, '')
+  .replace(thinkingTracesSource, '');
 if (/role:\s*["']switch|type:\s*["']checkbox/.test(otherClientSources)
   || (deliverySettingsSource.match(/type:\s*["']checkbox["']/g) ?? []).length !== 1
   || /role:\s*["']switch["']/u.test(deliverySettingsSource)
+  || (thinkingTracesSource.match(/type:\s*["']checkbox["']/g) ?? []).length !== 1
+  || /role:\s*["']switch["']/u.test(thinkingTracesSource)
   || (client.match(/role:\s*["']switch["']/g) ?? []).length !== 1
-  || (client.match(/type:\s*["']checkbox["']/g) ?? []).length !== 3) {
-  throw new Error('checkable inputs must be limited to context enhancement and Session sync');
+  || (client.match(/type:\s*["']checkbox["']/g) ?? []).length !== 4) {
+  throw new Error('checkable inputs must be limited to context enhancement, Session sync, email settings, and the Telegram thinking-traces toggle');
 }
 for (const marker of ['bot.context-enhancement.set', '<dsh_im_source>', '<dsh_im_source_guidance>']) {
   if (!host.includes(marker) || !client.includes(marker)) {

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

@@ -200,8 +200,15 @@ export function normalizeEmail(parsed, { address, state } = {}) {
       // attachment type under any other key is silently dropped.
       ...(attachment.contentType ? { mediaType: String(attachment.contentType) } : {}),
       // The bridge streams files via a loader so large attachments are not
-      // held in memory until they are actually needed.
-      load: async () => attachment.content,
+      // held in memory until they are actually needed. Transports differ in
+      // what `content` is: IMAP hands over a Buffer (already fetched with the
+      // body), while the Agent mailbox can only fetch bytes on demand and so
+      // exposes a function. Returning that function unchanged made the loader
+      // resolve to a function, which the inbound-file layer rejects as
+      // `inbound-file-data-invalid` — the download never happened.
+      load: async () => (typeof attachment.content === 'function'
+        ? attachment.content()
+        : attachment.content),
     })),
     reactionTarget: null,
     replyTarget: {

package/src/channels/email/transports/agent-mail.mjs

@@ -301,10 +301,21 @@ export class AgentMailTransport {
     this.#connected = false;
   }
 
-  /** The newest id, used to seed a cursor. */
+  /**
+   * The newest id, used to seed a cursor.
+   *
+   * Reads the list summary only. Going through `listMessages` without an
+   * allowlist meant "no filter", so seeding a cursor downloaded the body of the
+   * newest message — mail the policy may well refuse, fetched before anyone
+   * asked for it. The newest id is in the first summary already.
+   */
   async latestUid() {
-    const listed = await this.listMessages({ afterUid: null, limit: 1 });
-    return listed.length > 0 ? listed[0].uid : 0;
+    const { document } = await this.#call(
+      ['message', '+list', '--dir', INBOX, '--limit', '1'],
+      { signal: this.#signal },
+    );
+    const items = Array.isArray(document?.data?.data) ? document.data.data : [];
+    return String(items[0]?.message_id ?? '').trim() || 0;
   }
 
   /**

package/src/channels/feishu/bridge.mjs

@@ -115,6 +115,7 @@ import {
   FEISHU_STEP_PUSH_MODES,
   normalizeFeishuStepPushMode,
 } from './step-push-mode.mjs';
+import { FeishuLiveCot } from './live-cot.mjs';
 
 // Lazily evaluated: t() must run after setImHostLanguage, not at import time.
 const INTERACTION_RESOLVED_TEXT = () => t('这个问题已在其他客户端处理，无需再次回答。');
@@ -607,7 +608,7 @@ export class FeishuHarnessBridge {
   #groupTopicReply = false;
   /** When true, streaming turns push tool calls and interim notes as discrete messages. */
   #stepPush = false;
-  /** Step push presentation: 'post' (discrete messages) or 'streaming_card'. */
+  /** Step push presentation: discrete posts, a CardKit card, or native live CoT. */
   #stepPushMode = FEISHU_STEP_PUSH_MODES.POST;
   /** Per-conversation step push state: key → { lastSentAt, count, breakerLogged }. */
   #stepPushSendState = new Map();
@@ -4931,6 +4932,19 @@ export class FeishuHarnessBridge {
     // 流式卡片模式：每轮一张过程卡（原地 patch），过程与最终答案都进卡；
     // post 模式维持逐条直推。先预建卡片状态，纯问答回合也能在收尾时开卡。
     const streamingCard = this.#stepPushMode === FEISHU_STEP_PUSH_MODES.STREAMING_CARD;
+    const liveCot = this.#stepPushMode === FEISHU_STEP_PUSH_MODES.LIVE_COT
+      && typeof this.#channel?.createCot === 'function'
+      && typeof this.#channel?.writeCotEvents === 'function';
+    const cot = liveCot
+      ? new FeishuLiveCot(this.#channel, chatId, {
+          replyTo: messageId,
+          hidden: false,
+          onFailure: (error) => this.#logger.warn?.(
+            '[dsh-feishu] native live process failed; final answer will continue:',
+            error?.message ?? String(error),
+          ),
+        })
+      : null;
     if (streamingCard) {
       if (this.#stepCards.has(key)) {
         // 上一轮异常退出留下的「运行中」卡片先收尾，避免与本轮混淆。
@@ -4983,7 +4997,9 @@ export class FeishuHarnessBridge {
         messageId,
       );
     };
-    const watchdog = streamingCard ? null : this.#startThinkingStatusWatchdog(key, chatId, messageId);
+    const watchdog = streamingCard || liveCot
+      ? null
+      : this.#startThinkingStatusWatchdog(key, chatId, messageId);
     let completed;
     try {
       completed = await askInWorkspaceSession({
@@ -5000,7 +5016,7 @@ export class FeishuHarnessBridge {
       existsOptions: { signal: this.#signal },
       askOptions: {
         ...baseAskOptions,
-        progressMode: 'all',
+        progressMode: liveCot ? 'live' : 'all',
         // 提问/审批卡弹出前先定格当前过程卡，答案随之流到交互消息之后
         // 的新卡上（与主流式路径的 rotate 语义一致）。
         ...(streamingCard ? {
@@ -5012,6 +5028,15 @@ export class FeishuHarnessBridge {
           },
         } : {}),
         onUpdate: async (update) => {
+          if (liveCot) {
+            await cot.handle(update);
+            if (update.type === 'assistant-message') {
+              pendingStep = update;
+            } else if (update.type === 'tool') {
+              pendingStep = null;
+            }
+            return;
+          }
           if (update.type === 'assistant-message') {
             if (pendingStep && Number(update.step) > Number(pendingStep.step)) {
               await flushPendingStep();
@@ -5054,6 +5079,7 @@ export class FeishuHarnessBridge {
       },
       });
     } catch (error) {
+      await cot?.finish(error);
       if (streamingCard) {
         this.#stepStopFlags.delete(key);
         await this.#finishStepCard(key, { stopped: true });
@@ -5063,6 +5089,7 @@ export class FeishuHarnessBridge {
       // 回合结束（成功/失败/中断）：停看门狗并撤回残留思考中心跳。
       await watchdog?.stop();
     }
+    await cot?.finish();
     markAskComplete();
     const finalStepText = pendingStep ? pendingStep.text : null;
     pendingStep = null;
@@ -5130,7 +5157,7 @@ export class FeishuHarnessBridge {
       }
       textReceipt = createDeliveryReceipt({
         deliveryId: messageId,
-        presentation: 'feishu-step-push-post',
+        presentation: liveCot ? 'feishu-live-cot-answer' : 'feishu-step-push-post',
         providerMessageIds,
       });
       this.#status.streamResponses = (this.#status.streamResponses ?? 0) + 1;

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

@@ -8,6 +8,7 @@ const STREAM_ELEMENT_ID = 'stream_md';
 const DEFAULT_INITIAL_TEXT = '已连接 DeepSeek Harness，正在思考…';
 const MAX_STREAM_CHARS = 28000;
 const MAX_FILE_OPERATION_TIMEOUT_MS = 120_000;
+const COT_API = '/open-apis/im/v1/message_cot';
 
 const FILE_DELIVERY_ERRORS = new Map([
   [99991672, ['artifact-permission-required', 'Feishu file delivery requires the im:resource permission.']],
@@ -365,6 +366,40 @@ export class VerifiedFeishuChannel {
     });
   }
 
+  /** Open one native Feishu thinking-process message. */
+  async createCot(chatId, { replyTo, hidden = false } = {}) {
+    const response = assertApiSuccess('Feishu message_cot.create', await this.#client.request({
+      method: 'POST',
+      url: `${COT_API}?receive_id_type=chat_id`,
+      data: {
+        receive_id: chatId,
+        ...(replyTo ? { origin_message_id: replyTo } : {}),
+        cot_hidden: hidden === true,
+        enable_badge: false,
+        update_feed_rank: false,
+      },
+    }));
+    const cotId = response?.data?.cot_id;
+    const messageId = response?.data?.message_id;
+    if (!cotId || !messageId) {
+      throw new Error('Feishu message_cot.create returned no cot_id/message_id');
+    }
+    return { cotId, messageId };
+  }
+
+  /** Append ordered AG-UI events to one native thinking process. */
+  async writeCotEvents(handle, events) {
+    assertApiSuccess('Feishu message_cot.write', await this.#client.request({
+      method: 'PUT',
+      url: COT_API,
+      data: {
+        events,
+        message_id: handle.messageId,
+        cot_id: handle.cotId,
+      },
+    }));
+  }
+
   async #sendArtifact(chatId, file, {
     replyTo,
     signal,