@xmanrui/dsh-im 0.7.2 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "通过扫码、App Manifest或机器人凭据把IM机器人接入DeepSeek Harness（支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp）。",
   "license": "MIT",
   "type": "module",
@@ -32,6 +32,7 @@
     "src",
     "LICENSE",
     "README.md",
+    "README.en.md",
     "THIRD_PARTY_NOTICES.md"
   ],
   "dsh": {

package/plugin-src/client/styles.js

@@ -132,12 +132,13 @@ const CSS = String.raw`
 .dim-panel .dim-confirm { padding: 18px 24px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-confirm strong, .dim-panel .dim-confirm h4 { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 14px; line-height: 1.4; font-weight: 650; }
 .dim-panel .dim-confirm p { margin: 7px 0 0; color: var(--dsw-alias-label-secondary, #646a73); line-height: 1.6; }
-.dim-panel .dim-cardFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; padding-top: 8px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
-.dim-panel .dim-workspace { min-width: 0; display: grid; gap: 7px; margin-top: 14px; padding: 11px 12px; border: 1px solid var(--dsw-alias-border-l1, #eef0f3); border-radius: 9px; background: var(--dsw-alias-bg-module-platform, #f7f8fa); }
-.dim-panel .dim-workspaceHeader { display: flex; align-items: center; justify-content: space-between; gap: 12px; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: normal; }
-.dim-panel .dim-workspaceEdit { padding: 0; border: 0; color: #1677ff; background: transparent; font: inherit; font-weight: 560; cursor: pointer; }
+.dim-panel .dim-cardFooter { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding-top: 6px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
+.dim-panel .dim-workspace { min-width: 0; display: grid; grid-template-columns: minmax(0, 1fr) max-content; align-items: center; column-gap: 10px; row-gap: 4px; margin-top: 6px; padding: 6px 10px; border: 1px solid var(--dsw-alias-border-l1, #eef0f3); border-radius: 9px; background: var(--dsw-alias-bg-module-platform, #f7f8fa); }
+.dim-panel .dim-workspaceHeader { display: contents; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: normal; }
+.dim-panel .dim-workspaceHeader > span { grid-column: 1; grid-row: 1; white-space: nowrap; }
+.dim-panel .dim-workspaceEdit { grid-column: 2; grid-row: 1; padding: 0; border: 0; color: #1677ff; background: transparent; font: inherit; font-weight: 560; white-space: nowrap; cursor: pointer; }
 .dim-panel .dim-workspaceEdit:disabled { cursor: not-allowed; opacity: .55; }
-.dim-panel .dim-workspacePath { min-width: 0; display: block; overflow: hidden; color: var(--dsw-alias-label-primary, #1f2329); font: 12px/1.55 ui-monospace, SFMono-Regular, Menlo, monospace; text-overflow: ellipsis; white-space: nowrap; }
+.dim-panel .dim-workspacePath { min-width: 0; max-width: 100%; grid-column: 1 / -1; grid-row: 2; display: block; overflow-x: auto; overflow-y: hidden; color: var(--dsw-alias-label-primary, #1f2329); font: 12px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace; white-space: nowrap; }
 .dim-directoryPickerBackdrop { --dim-blue: var(--dsw-alias-state-business-primary, #3370ff); --dim-blue-soft: color-mix(in srgb, var(--dim-blue) 9%, transparent); position: fixed; inset: 0; z-index: 1000; display: grid; place-items: center; padding: 24px; background: rgb(15 17 21 / 42%); backdrop-filter: blur(3px); }
 .dim-directoryPickerBackdrop, .dim-directoryPickerBackdrop *, .dim-directoryPickerBackdrop *::before, .dim-directoryPickerBackdrop *::after { box-sizing: border-box; }
 .dim-directoryPicker { width: min(720px, 100%); height: min(620px, calc(100vh - 48px)); min-height: 420px; display: grid; grid-template-rows: auto minmax(0, 1fr) auto; overflow: hidden; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 18px; outline: none; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 24px 72px rgb(15 17 21 / 24%); }
@@ -181,16 +182,16 @@ const CSS = String.raw`
 .dim-directoryPickerActions button:disabled { cursor: not-allowed; opacity: .52; }
 .dim-panel .dim-cardSummary { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font: inherit; font-size: 12px; font-weight: 400; line-height: normal; }
 .dim-panel .dim-cardActions { flex: none; display: flex; align-items: center; flex-wrap: nowrap; gap: 8px; margin: 0 0 0 auto; }
-.dim-panel .dim-cardActions .dim-cardAction { flex: none; min-height: 34px; padding: 0 13px; 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; font-weight: 560; line-height: normal; white-space: nowrap; }
+.dim-panel .dim-cardActions .dim-cardAction { flex: none; min-height: 32px; padding: 0 11px; 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; font-weight: 560; line-height: normal; white-space: nowrap; }
 .dim-panel .dim-cardActions .dim-cardAction:hover:not(:disabled) { border-color: #aeb3bb; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-cardActions .dim-cardAction[data-kind="danger"] { color: var(--dsw-alias-state-error-primary, #d54941); }
 .dim-panel .dim-botCard { position: relative; overflow: hidden; border: 1px solid var(--dsw-alias-border-l2, #e5e6eb); border-radius: 14px; background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 1px 2px rgb(31 35 41 / 3%); }
 .dim-panel .dim-botCard::before { display: none; }
-.dim-panel .dim-botCardBody { position: relative; padding: 14px; }
-.dim-panel .dim-botCardTop { display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; }
-.dim-panel .dim-botIdentity { min-width: 0; display: flex; align-items: center; gap: 12px; }
-.dim-panel .dim-botAvatar { flex: none; width: 42px; height: 42px; display: grid; place-items: center; overflow: hidden; border-radius: 12px; box-shadow: none; }
-.dim-panel .dim-botAvatar svg { width: 29px; height: 29px; }
+.dim-panel .dim-botCardBody { position: relative; padding: 12px; }
+.dim-panel .dim-botCardTop { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; }
+.dim-panel .dim-botIdentity { min-width: 0; display: flex; align-items: center; gap: 10px; }
+.dim-panel .dim-botAvatar { flex: none; width: 38px; height: 38px; display: grid; place-items: center; overflow: hidden; border-radius: 11px; box-shadow: none; }
+.dim-panel .dim-botAvatar svg { width: 27px; height: 27px; }
 .dim-panel .dim-botName { min-width: 0; }
 .dim-panel .dim-botName h3 { overflow: hidden; margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 15px; font-weight: 650; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
 .dim-panel .dim-botName p { overflow: hidden; margin: 4px 0 0; color: var(--dsw-alias-label-secondary, #646a73); font: 12px ui-monospace, SFMono-Regular, monospace; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
@@ -199,10 +200,10 @@ const CSS = String.raw`
 .dim-panel .dim-botCard .dim-healthDot[data-tone="success"] { background: var(--dsw-alias-state-success-primary, #20a162); box-shadow: 0 0 0 3px color-mix(in srgb, var(--dsw-alias-state-success-primary, #20a162) 14%, transparent); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="warning"] { background: var(--dsw-alias-state-warn-primary, #d97706); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="error"] { background: var(--dsw-alias-state-error-primary, #d54941); }
-.dim-panel .dim-botMetrics { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; margin: 8px 0; }
-.dim-panel .dim-botMetric { min-width: 0; padding: 8px; border: 0; border-radius: 9px; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-panel .dim-botMetrics { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 8px; margin: 6px 0; }
+.dim-panel .dim-botMetric { min-width: 0; padding: 6px 8px; border: 0; border-radius: 9px; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-botMetric dt { margin: 0; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; font-weight: 400; line-height: normal; }
-.dim-panel .dim-botMetric dd { overflow: hidden; margin: 5px 0 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 13px; font-weight: 400; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
+.dim-panel .dim-botMetric dd { overflow: hidden; margin: 3px 0 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 12px; font-weight: 400; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
 .dim-panel .dim-botCard .dim-cardFooter { margin-top: 0; }
 .dim-panel .ddt-headingCopy { display: none; }
 .dim-panel .ddt-qrFrame, .dim-panel .ddt-countdown { width: min(270px, 100%); }

package/plugin-src/host/channels/dingtalk/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installDingtalkRpc } from './rpc.mjs';
 
 export const name = 'dsh-dingtalk-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/dingtalk/production.mjs

@@ -15,6 +15,7 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -79,12 +80,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new Controller({
     deviceAuth,

package/plugin-src/host/channels/discord/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installDiscordRpc } from './rpc.mjs';
 
 export const name = 'dsh-im-discord-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/feishu/index.mjs

@@ -3,7 +3,7 @@ import { createProductionController } from './production.mjs';
 import { installFeishuRpc } from './rpc.mjs';
 
 export const name = 'dsh-feishu-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 function controllerFrom(ctx, config) {
   if (config?.controller) return config.controller;

package/plugin-src/host/channels/feishu/production.mjs

@@ -3,6 +3,7 @@ import { join, resolve } from 'node:path';
 import { unlink } from 'node:fs/promises';
 import * as Lark from '@larksuiteoapi/node-sdk';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { verifyFeishuApp } from '../../../../src/channels/feishu/feishu-app.mjs';
 import { FeishuRuntime } from '../../../../src/channels/feishu/feishu-runtime.mjs';
 import { HarnessClient } from '../../../../src/channels/feishu/harness-client.mjs';
@@ -105,6 +106,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     if (!botConfig) throw new Error('Unknown Feishu bot');
     return stateFor(botConfig);
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
@@ -113,6 +115,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     // second DSH would create a competing server and lifecycle.
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
 
   const coreController = new Controller({

package/plugin-src/host/channels/qq/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installQqRpc } from './rpc.mjs';
 
 export const name = 'dsh-im-qq-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/qq/production.mjs

@@ -15,6 +15,7 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -70,12 +71,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new Controller({
     qrAuth,

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

@@ -3,6 +3,7 @@ import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 
 import { createTokenConnectionSupervisor } from './connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import {
   BotWorkspaceStore,
   createBotWorkspaceScope,
@@ -64,12 +65,14 @@ export async function createTokenProductionController(ctx, config, internals, de
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new ResolvedHarness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new ResolvedController({
     credentials: ctx.credentials,

package/plugin-src/host/channels/slack/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installSlackRpc } from './rpc.mjs';
 
 export const name = 'dsh-im-slack-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) return installSlackRpc(ctx, config.controller, config.rpcAuthority);

package/plugin-src/host/channels/slack/production.mjs

@@ -14,6 +14,7 @@ import {
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
 import { harnessOrigin, pluginPaths } from '../shared/production.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 
 export async function createProductionController(ctx, config = {}, internals = {}) {
   if (!ctx?.credentials) throw new TypeError('dsh-im slack requires ctx.credentials');
@@ -49,12 +50,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new ResolvedHarness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new ResolvedController({
     credentials: ctx.credentials,

package/plugin-src/host/channels/telegram/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installTelegramRpc } from './rpc.mjs';
 
 export const name = 'dsh-im-telegram-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/wecom/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installWecomRpc } from './rpc.mjs';
 
 export const name = 'dsh-im-wecom-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/wecom/production.mjs

@@ -15,6 +15,7 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -73,12 +74,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new Controller({
     qrAuth,

package/plugin-src/host/channels/weixin/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installWeixinRpc } from './rpc.mjs';
 
 export const name = 'dsh-weixin-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/weixin/production.mjs

@@ -15,6 +15,7 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -73,12 +74,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new Controller({
     api,

package/plugin-src/host/channels/whatsapp/index.mjs

@@ -2,7 +2,7 @@ import { createProductionController } from './production.mjs';
 import { installWhatsappRpc } from './rpc.mjs';
 
 export const name = 'dsh-im-whatsapp-host';
-export const inject = ['connection', 'webServer'];
+export const inject = ['connection', 'webServer', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
   if (config?.controller) {

package/plugin-src/host/channels/whatsapp/production.mjs

@@ -15,6 +15,7 @@ import {
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
+import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 
 const AUTH_DIRECTORY_PATTERN = /^[a-f0-9-]{36}$/;
 
@@ -76,12 +77,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
+    ...(commandExecutor ? { commandExecutor } : {}),
   });
   const coreController = new Controller({
     configStore: observedConfigStore,

package/plugin-src/host/harness-command-executor.mjs

@@ -0,0 +1,21 @@
+/**
+ * Adapt the Host's Typert command gateway to the channel Harness client.
+ * Programmatic production fixtures may omit the gateway and exercise other assembly paths.
+ */
+export function createHarnessCommandExecutor(ctx, provided) {
+  if (provided !== undefined) {
+    if (typeof provided !== 'function') throw new TypeError('commandExecutor must be a function');
+    return provided;
+  }
+  const gateway = ctx?.typertGateway;
+  if (!gateway) return undefined;
+  if (typeof gateway.invoke !== 'function') {
+    throw new TypeError('dsh-im requires a callable ctx.typertGateway');
+  }
+  return (sessionId, line, options = {}) => gateway.invoke({
+    namespace: 'commands',
+    method: 'execute',
+    args: { agentId: sessionId, line },
+    signal: options.signal,
+  });
+}

package/plugin-src/host/index.mjs

@@ -9,7 +9,7 @@ import { apply as applyWeixin } from './channels/weixin/index.mjs';
 import { apply as applyWhatsapp } from './channels/whatsapp/index.mjs';
 
 export const name = 'dsh-im-host';
-export const inject = ['connection', 'credentials', 'webServer'];
+export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
 
 function channelConfig(config, name) {
   const channel = config[name] ?? {};

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

@@ -9,6 +9,7 @@ import {
   validHarnessQuestion,
 } from '../shared/harness-question.mjs';
 import { HarnessApprovalQueue } from '../shared/harness-approval.mjs';
+import { runCompactCommand } from '../shared/compact-command.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 
@@ -21,10 +22,11 @@ const HELP_TEXT = [
   '',
   '直接发送文字即可继续当前会话。',
   '/new  开启一个全新会话',
+  '/compact  压缩当前会话的较早上下文',
   '/workspace 工作区绝对路径  切换工作区',
   '/workspacelist  列出工作区绝对路径',
   '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题',
-  '/session Session ID  将当前聊天绑定到指定会话',
+  '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
   '/status  检查连接状态',
   '/help  显示本帮助',
 ].join('\n');
@@ -346,6 +348,17 @@ export class DingtalkHarnessBridge {
         }
         return;
       }
+      const compactCommand = await runCompactCommand(
+        text,
+        this.#harness,
+        this.#state,
+        key,
+        { signal: this.#signal },
+      );
+      if (compactCommand) {
+        await this.#send(sessionWebhook, compactCommand.message);
+        return;
+      }
 
       if (typeof this.#api.createAiCard === 'function'
         && typeof this.#api.updateAiCard === 'function'

package/src/channels/discord/discord-api.mjs

@@ -108,7 +108,7 @@ export class DiscordApi {
         headers: {
           authorization: `Bot ${this.#token}`,
           'content-type': 'application/json',
-          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 0.7.2)',
+          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 0.9.0)',
         },
         ...(body === undefined ? {} : { body: JSON.stringify(body) }),
         signal: requestSignal(signal, timeoutMs),

package/src/channels/feishu/bridge.mjs

@@ -11,6 +11,7 @@ import {
   validHarnessQuestion,
 } from '../shared/harness-question.mjs';
 import { HarnessApprovalQueue } from '../shared/harness-approval.mjs';
+import { runCompactCommand } from '../shared/compact-command.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 
@@ -22,10 +23,11 @@ const HELP_TEXT = [
   '',
   '直接发送问题即可继续当前会话。',
   '/new  开启一个全新会话',
+  '/compact  压缩当前会话的较早上下文',
   '/workspace 工作区绝对路径  切换工作区',
   '/workspacelist  列出工作区绝对路径',
   '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题',
-  '/session Session ID  将当前聊天绑定到指定会话',
+  '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
   '/status  检查连接状态',
   '/help  显示本帮助',
 ].join('\n');
@@ -322,6 +324,17 @@ export class FeishuHarnessBridge {
       }
       return;
     }
+    const compactCommand = await runCompactCommand(
+      text,
+      this.#harness,
+      this.#state,
+      key,
+      { signal: this.#signal },
+    );
+    if (compactCommand) {
+      await this.#send(event.message.chat_id, compactCommand.message);
+      return;
+    }
 
     this.#logger.info?.(`[dsh-feishu] processing ${event.message.chat_type} message ${messageId}`);
     try {

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

@@ -1,4 +1,5 @@
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
+import { runCompactCommand } from '../shared/compact-command.mjs';
 import {
   harnessAnswerForQuestion,
   harnessQuestionText,
@@ -14,10 +15,11 @@ const HELP_TEXT = [
   '',
   '直接发送文字即可继续当前会话。',
   '/new  开启一个全新会话',
+  '/compact  压缩当前会话的较早上下文',
   '/workspace 工作区绝对路径  切换工作区',
   '/workspacelist  列出工作区绝对路径',
   '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题',
-  '/session Session ID  将当前聊天绑定到指定会话',
+  '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
   '/status  检查连接状态',
   '/help  显示本帮助',
 ].join('\n');
@@ -241,6 +243,18 @@ export class QqHarnessBridge {
         await this.#state.markSeen(messageId);
         return;
       }
+      const compactCommand = await runCompactCommand(
+        text,
+        this.#harness,
+        this.#state,
+        key,
+        { signal: this.#signal },
+      );
+      if (compactCommand) {
+        await this.#bot.sendText(target, compactCommand.message);
+        await this.#state.markSeen(messageId);
+        return;
+      }
 
       let stream = null;
       let streamFinished = false;

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

@@ -668,6 +668,19 @@ export function createBotWorkspaceScope(harness, { botId, workspaces, state }) {
           return target.ask(sessionId, ...args);
         };
       }
+      if (property === 'executeCommand' && typeof target.executeCommand === 'function') {
+        return (sessionId, ...args) => {
+          const generation = sessionGenerations.get(sessionId);
+          sessionGenerations.delete(sessionId);
+          if (!isCurrentScope()
+            || (generation !== undefined && generation !== workspaces.generationFor(botId))) {
+            const error = new Error('The bot workspace changed before this command started.');
+            error.code = WORKSPACE_SESSION_STALE;
+            throw error;
+          }
+          return target.executeCommand(sessionId, ...args);
+        };
+      }
       const value = Reflect.get(target, property, target);
       return typeof value === 'function' ? value.bind(target) : value;
     },

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

@@ -0,0 +1,95 @@
+import { WORKSPACE_SESSION_STALE } from './workspace-session.mjs';
+
+const COMPACT_COMMAND = /^\/compact(?=$|\s)([\s\S]*)$/i;
+const COMPACT_USAGE = '用法：/compact（不带参数）';
+
+const COMPACT_RESULT_TEXT = new Map([
+  ['No compactable history yet.', '暂无可压缩的历史记录。'],
+  [
+    'Compaction is unavailable because this process has an active compaction, or the agent is not idle.',
+    '当前会话正在生成回复或执行压缩，请稍后重试。',
+  ],
+  ['Compaction cancelled.', '上下文压缩已取消。'],
+  [
+    'The history selected for compaction changed before it could be replaced. The conversation is unchanged; the attempt is recorded in the session log.',
+    '压缩期间会话历史发生变化，本次未修改会话，请重试。',
+  ],
+  [
+    'Compaction could not produce a useful summary. The conversation is unchanged; the attempt is recorded in the session log.',
+    '未能生成有效的压缩摘要，本次未修改会话。',
+  ],
+  [
+    'Compaction did not finish cleanly; some session history may have changed. Inspect the current session state before retrying.',
+    '上下文压缩未正常完成，部分会话历史可能已变化，请检查会话后再重试。',
+  ],
+  [
+    'Compaction finished, but the session could not be saved.',
+    '上下文已压缩，但会话保存失败。',
+  ],
+]);
+
+function commandResult(message) {
+  return { handled: true, message, messages: [message] };
+}
+
+function compactResultText(result) {
+  if (!result || typeof result !== 'object'
+    || !['success', 'error'].includes(result.kind)
+    || (result.text !== undefined && typeof result.text !== 'string')) {
+    throw new TypeError('Harness returned an invalid /compact result');
+  }
+  const text = result.text?.trim() ?? '';
+  const compacted = /^Compacted (\d+) history items \(~(\d+) tokens\)\.$/u.exec(text);
+  if (compacted) {
+    return `已压缩 ${compacted[1]} 条历史记录（约 ${compacted[2]} 个 token）。`;
+  }
+  if (COMPACT_RESULT_TEXT.has(text)) return COMPACT_RESULT_TEXT.get(text);
+  if (text) return text;
+  return result.kind === 'success' ? '上下文压缩完成。' : '上下文压缩失败。';
+}
+
+function compactErrorMessage(error) {
+  const code = error?.code ?? error?.failure?.code;
+  if (code === 'session-not-found') {
+    return '当前聊天绑定的会话已不存在，请发送新消息开启会话。';
+  }
+  if (code === 'agent-busy') return '当前会话正在生成回复，请稍后重试。';
+  if (code === 'cancelled' || error?.name === 'AbortError') return '上下文压缩已取消。';
+  if (code === WORKSPACE_SESSION_STALE || code === 'workspace-bot-not-found') {
+    return '工作区或机器人状态已发生变化，请重试。';
+  }
+  if (code === 'commands-unavailable') {
+    return '当前 Harness 暂不支持从机器人执行上下文压缩。';
+  }
+  return '上下文压缩失败，请稍后重试。';
+}
+
+/**
+ * Execute the explicit Harness compaction command for an existing IM conversation Session.
+ * Unknown input returns null so the caller may continue ordinary message routing.
+ */
+export async function runCompactCommand(text, harness, state, conversationKey, options = {}) {
+  if (typeof text !== 'string') return null;
+  const match = COMPACT_COMMAND.exec(text.trim());
+  if (!match) return null;
+  if (match[1].trim()) return commandResult(COMPACT_USAGE);
+  if (typeof state?.sessionFor !== 'function') {
+    return commandResult('当前机器人没有可用的会话状态。');
+  }
+  const sessionId = state.sessionFor(conversationKey);
+  if (typeof sessionId !== 'string' || !sessionId) {
+    return commandResult('当前聊天还没有可压缩的会话，请先发送一条消息。');
+  }
+  if (typeof harness?.executeCommand !== 'function') {
+    return commandResult('当前机器人暂不支持上下文压缩。');
+  }
+  try {
+    const execution = await harness.executeCommand(sessionId, '/compact', options);
+    if (execution === undefined) {
+      return commandResult('当前 Harness 未注册 /compact 命令，请确认上下文压缩组件已启用。');
+    }
+    return commandResult(compactResultText(execution?.result));
+  } catch (error) {
+    return commandResult(compactErrorMessage(error));
+  }
+}