@xmanrui/dsh-im 4.9.1 → 4.10.0

package/plugin-src/client/styles.js

@@ -61,6 +61,15 @@ const CSS = String.raw`
 .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; }
+.dim-generalSettingsButton { 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); cursor: pointer; transition: border-color .15s ease, color .15s ease, background .15s ease, box-shadow .15s ease; }
+.dim-generalSettingsButton svg { display: block; }
+.dim-generalSettingsButton:hover { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-generalSettingsButton[aria-current="page"] { border-color: color-mix(in srgb, var(--dim-blue) 42%, var(--dsw-alias-border-l2, #dfe1e5)); color: var(--dim-blue); background: var(--dim-blue-soft); }
+.dim-generalSettingsButton:focus-visible { outline: 2px solid color-mix(in srgb, var(--dim-blue) 70%, white); outline-offset: 2px; }
+.dim-generalSettingsTooltip { position: absolute; top: calc(100% + 8px); right: 0; z-index: 20; width: max-content; 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-generalSettingsAction:hover .dim-generalSettingsTooltip, .dim-generalSettingsButton:focus-visible + .dim-generalSettingsTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
+.dim-generalSettingsButton[aria-current="page"] + .dim-generalSettingsTooltip { opacity: 0; visibility: hidden; transform: translateY(-3px); }
 .dim-layout { display: grid; grid-template-columns: 174px 1px minmax(0, 1fr); gap: 24px; align-items: start; }
 .dim-rail { max-height: 520px; display: grid; align-content: start; gap: 8px; overflow-y: auto; padding: 0 4px 1px 1px; scrollbar-width: thin; scrollbar-color: var(--dsw-alias-border-l2, #dfe1e5) transparent; }
 .dim-rail::-webkit-scrollbar { width: 4px; }
@@ -468,6 +477,46 @@ const CSS = String.raw`
 .dim-accessFeedback[data-tone="success"] { color: var(--dsw-alias-state-success-primary, #20a162); }
 .dim-accessFeedback[data-tone="error"] { color: var(--dsw-alias-state-error-primary, #d54941); }
 .dim-accessActions { display: flex; justify-content: flex-end; }
+.dim-generalSettingsPage { min-width: 0; display: grid; }
+.dim-generalSettingsHeader { min-width: 0; margin: 0 0 8px; }
+.dim-generalSettingsHeader h2 { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 18px; line-height: 25px; font-weight: 680; }
+.dim-generalSettingsTabsBar { min-width: 0; border-bottom: 1px solid var(--dsw-alias-border-l2, #dfe1e5); }
+.dim-generalSettingsTabs { min-width: 0; display: flex; align-items: flex-end; gap: 24px; overflow-x: auto; scrollbar-width: none; }
+.dim-generalSettingsTabs::-webkit-scrollbar { display: none; }
+.dim-generalSettingsTab { position: relative; min-height: 38px; flex: none; display: inline-flex; align-items: center; justify-content: center; padding: 6px 2px 9px; border: 0; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; font: inherit; font-size: 13px; line-height: 20px; font-weight: 560; white-space: nowrap; cursor: pointer; transition: color .15s ease; }
+.dim-generalSettingsTab::after { content: ''; position: absolute; right: 0; bottom: -1px; left: 0; height: 2px; border-radius: 2px 2px 0 0; background: transparent; transform: scaleX(.45); transition: background .15s ease, transform .15s ease; }
+.dim-generalSettingsTab:hover:not([aria-selected="true"]) { color: var(--dsw-alias-label-primary, #1f2329); }
+.dim-generalSettingsTab[aria-selected="true"] { color: var(--dim-blue); font-weight: 650; }
+.dim-generalSettingsTab[aria-selected="true"]::after { background: var(--dim-blue); transform: scaleX(1); }
+.dim-generalSettingsTab:focus-visible { outline: 2px solid var(--dim-blue); outline-offset: -2px; border-radius: 5px; }
+.dim-generalSettingsTabPanel { min-width: 0; padding-top: 14px; }
+.dim-globalSection { min-width: 0; padding: 14px 16px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 12px; background: var(--dsw-alias-bg-layer-3, #fff); }
+.dim-globalHead { min-width: 0; display: flex; align-items: center; }
+.dim-globalHeadTitle { min-width: 0; display: inline-flex; align-items: center; gap: 6px; }
+.dim-globalHead h3 { min-width: 0; overflow: hidden; margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 15px; line-height: 22px; font-weight: 650; text-overflow: ellipsis; white-space: nowrap; }
+.dim-globalTtlHelp { position: relative; display: inline-flex; flex: none; }
+.dim-globalTtlTooltip { position: absolute; top: calc(100% + 7px); left: 0; z-index: 30; width: max-content; max-width: min(280px, calc(100vw - 48px)); padding: 9px 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 10px 28px rgb(31 35 41 / 16%); opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dim-globalTtlHelp:hover .dim-globalTtlTooltip, .dim-globalTtlHelpButton:focus-visible + .dim-globalTtlTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
+.dim-globalTtlHints { display: grid; gap: 4px; margin: 0; padding: 0; list-style: none; }
+.dim-globalTtlHints li { min-width: 0; display: flex; align-items: baseline; gap: 8px; }
+.dim-globalTtlHints code { flex: none; min-width: 44px; padding: 0 6px; border-radius: 5px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-module-platform, #f7f8fa); font: 10px/16px ui-monospace, SFMono-Regular, Menlo, monospace; text-align: center; }
+.dim-globalTtlHints span { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 11px; line-height: 16px; }
+.dim-globalTtlRow { display: flex; align-items: center; flex-wrap: wrap; gap: 4px 10px; margin-top: 12px; }
+.dim-globalTtlInput { width: min(160px, 100%); min-width: 110px; max-width: 160px; flex: 1 1 130px; height: 34px; 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: 13px ui-monospace, SFMono-Regular, Menlo, monospace; transition: border-color .16s ease, box-shadow .16s ease; }
+.dim-globalTtlInput:hover:not(:disabled) { border-color: var(--dsw-alias-border-l3, #bbbfc4); }
+.dim-globalTtlInput:focus { outline: none; border-color: var(--dim-blue); box-shadow: 0 0 0 3px color-mix(in srgb, var(--dim-blue) 14%, transparent); }
+.dim-globalTtlInput[aria-invalid="true"] { border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary, #d54941) 62%, var(--dsw-alias-border-l2, #dfe1e5)); }
+.dim-globalTtlInput:disabled { cursor: not-allowed; opacity: .55; }
+.dim-globalSaveButton { min-width: 58px; min-height: 34px; }
+.dim-globalSweepAction { position: relative; display: inline-flex; flex: none; margin-left: auto; }
+.dim-globalSweepButton { flex: none; }
+.dim-globalSweepConfirm { position: absolute; top: calc(100% + 8px); right: 0; z-index: 35; width: 218px; padding: 11px 12px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 9px; background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 12px 30px rgb(31 35 41 / 18%); }
+.dim-globalSweepConfirm p { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 12px; line-height: 18px; }
+.dim-globalSweepConfirmActions { display: flex; justify-content: flex-end; gap: 7px; margin-top: 10px; }
+.dim-deliveryButton.dim-globalSweepConfirmButton { border-color: var(--dsw-alias-state-error-primary, #d54941); color: #fff; background: var(--dsw-alias-state-error-primary, #d54941); }
+.dim-deliveryButton.dim-globalSweepConfirmButton:hover:not(:disabled) { border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary, #d54941) 82%, #000); background: color-mix(in srgb, var(--dsw-alias-state-error-primary, #d54941) 88%, #000); }
+.dim-globalInline { flex: 1 0 100%; min-width: 0; margin: 2px 0 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 11px; line-height: 16px; overflow-wrap: anywhere; }
+.dim-globalInline[data-tone="error"] { color: var(--dsw-alias-state-error-primary, #d54941); }
 .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/production.mjs

@@ -20,6 +20,10 @@ import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -84,10 +88,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,

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

@@ -7,6 +7,10 @@ import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.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';
@@ -158,10 +162,19 @@ export async function createProductionController(ctx, config = {}, internals = {
     return stateFor(botConfig);
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+    botIdFrom: (bot) => bot?.id,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,
@@ -202,6 +215,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         domain: botConfig.domain,
         botOpenId: botConfig.botOpenId,
         groupResponseMode: botConfig.groupResponseMode,
+        groupTopicReply: botConfig.groupTopicReply,
         ownerOpenIds: botConfig.ownerOpenIds ?? [botConfig.ownerOpenId],
         harness: workspaceScope.harness,
         state: workspaceScope.state,

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

@@ -287,6 +287,7 @@ function publicBotEntry(entry) {
     contextEnhancement: normalizeContextEnhancementConfig(source.contextEnhancement),
     accessPolicy: normalizeAccessPolicy(source.accessPolicy),
     groupResponseMode: normalizeFeishuGroupResponseMode(source.groupResponseMode),
+    groupTopicReply: source.groupTopicReply === true,
     groupMessagePermissionGranted: source.groupMessagePermissionGranted === true,
     bot: publicBot(source.bot),
     health: publicHealth(source, connected),
@@ -440,6 +441,13 @@ function validPayload(endpoint, payload) {
       ? null
       : '请选择群聊响应方式。';
   }
+  if (endpoint === FEISHU_ENDPOINTS.setGroupTopicReply) {
+    return hasOnlyKeys(payload, new Set(['botId', 'groupTopicReply']))
+      && safeOpaqueId(payload.botId)
+      && typeof payload.groupTopicReply === 'boolean'
+      ? null
+      : '请选择是否以话题方式回复。';
+  }
   return 'Unknown Feishu endpoint.';
 }
 
@@ -710,6 +718,14 @@ export function createFeishuRpcHandler(controller, { encodeQr = qrCodeDataUrl }
           await controller.updateGroupResponseMode(payload.botId, payload.groupResponseMode),
           { encodeQr: cachedEncodeQr },
         );
+      } else if (endpoint === FEISHU_ENDPOINTS.setGroupTopicReply) {
+        if (typeof controller.updateGroupTopicReply !== 'function') {
+          throw new Error('Group topic reply update is unavailable');
+        }
+        value = await toPublicFeishuStatus(
+          await controller.updateGroupTopicReply(payload.botId, payload.groupTopicReply),
+          { encodeQr: cachedEncodeQr },
+        );
       } else {
         if (typeof controller.deleteBot !== 'function') throw new Error('Multi-bot delete is unavailable');
         value = await toPublicFeishuStatus(await controller.deleteBot(payload.botId), { encodeQr: cachedEncodeQr });

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

@@ -20,6 +20,10 @@ import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -75,10 +79,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,

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

@@ -6,6 +6,10 @@ import { createTokenConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   BotWorkspaceStore,
   createBotWorkspaceScope,
@@ -84,10 +88,18 @@ export async function createTokenProductionController(ctx, config, internals, de
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new ResolvedHarness({
     ...connection,

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

@@ -19,6 +19,10 @@ import { pluginPaths } from '../shared/production.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -63,10 +67,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new ResolvedHarness({
     ...connection,

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

@@ -20,6 +20,10 @@ import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -78,10 +82,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,

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

@@ -23,6 +23,10 @@ import { createConnectionSupervisor } from './connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -81,10 +85,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,

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

@@ -23,6 +23,10 @@ import { createTokenConnectionSupervisor } from '../shared/connection-supervisor
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { harnessConnection } from '../../harness-connection.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
+import {
+  getInboundTtlRuntime,
+  registerInboundTtlWorkspaces,
+} from '../../inbound-ttl-runtime.mjs';
 import {
   accessPolicyProvider,
   initialAccessPolicyFor,
@@ -84,10 +88,18 @@ export async function createProductionController(ctx, config = {}, internals = {
     return state;
   };
   const commandExecutor = createHarnessCommandExecutor(ctx, internals.commandExecutor);
+  const inboundTtl = internals.inboundTtl ?? getInboundTtlRuntime(ctx, config);
+  const inboundTtlService = inboundTtl?.service ?? inboundTtl;
+  registerInboundTtlWorkspaces(ctx, inboundTtlService, {
+    workspaces,
+    configStore: observedConfigStore,
+    defaultWorkspace,
+  });
   const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = createHarnessSessionExecutors(ctx, {
     controlExecutor: internals.controlExecutor,
     sessionMaintenanceExecutor: internals.sessionMaintenanceExecutor,
     fileIngressExecutor: internals.fileIngressExecutor,
+    inboundTtlService,
   });
   const harness = new Harness({
     ...connection,

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

@@ -144,6 +144,7 @@ export function createDeliveryAdapter({ channel, workspaces, coreController, sta
   return Object.freeze({
     channel,
     ownsBot: (botId) => workspaces.has(botId),
+    listBots: () => workspaces.listBotIds(),
     listTargets: (botId) => workspaces.listDeliveryTargets(botId),
     async listSuggestions(botId) {
       const state = await stateFor(botId);

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

@@ -7,6 +7,7 @@ const DRAFT_TARGET_ID = '__test__';
 
 const ADAPTER_METHODS = Object.freeze([
   'ownsBot',
+  'listBots',
   'listTargets',
   'listSuggestions',
   'createTarget',
@@ -118,6 +119,20 @@ export class DeliveryService {
     }
   }
 
+  async listBots() {
+    const bots = [];
+    for (const { adapter } of this.#adapters.values()) {
+      try {
+        const ids = await adapter.listBots();
+        if (!Array.isArray(ids)) throw new TypeError('Adapter returned invalid bots');
+        for (const botId of ids) bots.push({ botId: botIdOf(botId), channel: adapter.channel });
+      } catch (error) {
+        throw publicOperationError(error);
+      }
+    }
+    return bots;
+  }
+
   async listSuggestions(botId) {
     const id = botIdOf(botId);
     const adapter = await this.#adapterFor(id);

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

@@ -22,7 +22,9 @@ function agentsFromContext(ctx) {
 
 function currentOwnedTurn(agent, expectedTurn, promptRpcId) {
   if (agent?.status !== 'running') return false;
-  const events = agent?.session?.events;
+  const events = typeof agent?.session?.snapshotEvents === 'function'
+    ? agent.session.snapshotEvents()
+    : agent?.session?.events;
   if (!Array.isArray(events)) return false;
 
   let openTurn = null;
@@ -113,7 +115,7 @@ function createSessionMaintenanceExecutor(agents) {
   };
 }
 
-function createFileIngressExecutor(agents) {
+function createFileIngressExecutor(agents, { inboundTtlService } = {}) {
   return ({ sessionId, workspace, files, signal }) => {
     const agent = agents.get(sessionId);
     const attachedWorkspace = agent?.session?.header?.cwd;
@@ -126,7 +128,19 @@ function createFileIngressExecutor(agents) {
         'The Harness Session workspace is unavailable for inbound files.',
       );
     }
-    return stageInboundFiles({ files }, { workspace: exactWorkspace, signal });
+    const staged = stageInboundFiles({ files }, {
+      workspace: exactWorkspace,
+      signal,
+      ...(inboundTtlService ? { retention: inboundTtlService.stagingRetention() } : {}),
+      // Registration at creation time closes the mid-staging sweep window;
+      // trackStaged later re-registers idempotently and owns the release.
+      ...(typeof inboundTtlService?.trackDirectory === 'function'
+        ? { onStagedDirectory: (directory) => inboundTtlService.trackDirectory(directory) }
+        : {}),
+    });
+    return inboundTtlService
+      ? staged.then((result) => (result ? inboundTtlService.trackStaged(result) : result))
+      : staged;
   };
 }
 
@@ -136,7 +150,9 @@ function createFileIngressExecutor(agents) {
  * when an Agent is attached, its live Session header remains authoritative.
  */
 export function createHarnessSessionExecutors(ctx, provided = {}) {
-  const { controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor } = provided;
+  const {
+    controlExecutor, sessionMaintenanceExecutor, fileIngressExecutor, inboundTtlService,
+  } = provided;
   if (controlExecutor !== undefined && typeof controlExecutor !== 'function') {
     throw new TypeError('controlExecutor must be a function');
   }
@@ -147,6 +163,11 @@ export function createHarnessSessionExecutors(ctx, provided = {}) {
   if (fileIngressExecutor !== undefined && typeof fileIngressExecutor !== 'function') {
     throw new TypeError('fileIngressExecutor must be a function');
   }
+  if (inboundTtlService !== undefined
+    && (typeof inboundTtlService?.stagingRetention !== 'function'
+      || typeof inboundTtlService?.trackStaged !== 'function')) {
+    throw new TypeError('inboundTtlService must expose stagingRetention() and trackStaged()');
+  }
 
   const agents = controlExecutor && sessionMaintenanceExecutor && fileIngressExecutor
     ? undefined
@@ -156,6 +177,6 @@ export function createHarnessSessionExecutors(ctx, provided = {}) {
     sessionMaintenanceExecutor: sessionMaintenanceExecutor
       ?? (agents ? createSessionMaintenanceExecutor(agents) : undefined),
     fileIngressExecutor: fileIngressExecutor
-      ?? createFileIngressExecutor(agents ?? { get: () => undefined }),
+      ?? createFileIngressExecutor(agents ?? { get: () => undefined }, { inboundTtlService }),
   };
 }

package/plugin-src/host/inbound-ttl-rpc.mjs

@@ -0,0 +1,83 @@
+import { normalizeInboundTtlHours } from '../../src/channels/shared/inbound-ttl.mjs';
+import { getInboundTtlRuntime } from './inbound-ttl-runtime.mjs';
+
+export const INBOUND_TTL_RPC_CHANNEL = '/dsh-im-settings';
+export const INBOUND_TTL_ENDPOINTS = Object.freeze({
+  get: 'settings.inbound-ttl.get',
+  set: 'settings.inbound-ttl.set',
+  sweep: 'settings.inbound-ttl.sweep',
+});
+
+const ENDPOINTS = new Set(Object.values(INBOUND_TTL_ENDPOINTS));
+
+export function validInboundTtlPayload(endpoint, payload) {
+  if (!ENDPOINTS.has(endpoint)) return false;
+  if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return false;
+  const keys = Object.keys(payload);
+  if (endpoint === INBOUND_TTL_ENDPOINTS.set) {
+    return keys.length === 1 && keys[0] === 'ttlHours'
+      && normalizeInboundTtlHours(payload.ttlHours) !== null;
+  }
+  return keys.length === 0;
+}
+
+export function createInboundTtlRpcHandler({ store, service, logger = null } = {}) {
+  if (!store || typeof store.getTtlHours !== 'function'
+    || typeof store.setTtlHours !== 'function'
+    || !service || typeof service.sweepNow !== 'function') {
+    throw new TypeError('createInboundTtlRpcHandler requires an inbound TTL store and service');
+  }
+  return async (endpoint, payload, signal) => {
+    if (!validInboundTtlPayload(endpoint, payload)) {
+      return { ok: false, error: { code: 'bad-request', message: 'Invalid inbound TTL request.' } };
+    }
+    if (signal?.aborted) {
+      return { ok: false, error: { code: 'cancelled', message: 'Request cancelled.' } };
+    }
+    try {
+      if (endpoint === INBOUND_TTL_ENDPOINTS.get) {
+        return { ok: true, value: { ttlHours: store.getTtlHours() } };
+      }
+      if (endpoint === INBOUND_TTL_ENDPOINTS.set) {
+        const ttlHours = await store.setTtlHours(payload.ttlHours);
+        // Re-arm the sweep interval so the saved value gets a full window
+        // before its first scheduled enforcement.
+        service.resetSweepSchedule?.();
+        return { ok: true, value: { ttlHours } };
+      }
+      const summary = await service.sweepNow();
+      // The UI shows no result text, so the host log is the only place a
+      // manual sweep can be diagnosed (TTL applied, coverage, deletions).
+      logger?.info?.(
+        `[dsh-im] manual inbound attachment sweep: ${summary.deletedDirectories} deleted`
+        + ` across ${summary.sweptWorkspaces} workspaces (ttl ${store.getTtlHours()}h)`,
+      );
+      return { ok: true, value: summary };
+    } catch (error) {
+      if (error?.code === 'inbound-ttl-invalid') {
+        return {
+          ok: false,
+          error: {
+            code: 'inbound-ttl-invalid',
+            message: '附件保留时长无效：请输入 -1、0 或 1-8760 之间的整数小时数。',
+          },
+        };
+      }
+      return { ok: false, error: { code: 'inbound-ttl-unavailable', message: 'inbound-ttl-unavailable' } };
+    }
+  };
+}
+
+export function installInboundTtlRpc(ctx, options = {}) {
+  if (!ctx?.connection?.rpc || typeof ctx.connection.rpc.handle !== 'function') {
+    throw new TypeError('DSH Host Connection RPC is required');
+  }
+  const runtime = options.runtime ?? getInboundTtlRuntime(ctx, options.config);
+  const logger = typeof ctx?.logger === 'function'
+    ? ctx.logger('dsh-im:inbound-ttl') : (ctx?.logger ?? null);
+  return ctx.connection.rpc.handle(
+    INBOUND_TTL_RPC_CHANNEL,
+    createInboundTtlRpcHandler({ ...runtime, logger }),
+    { authority: 'loopback' },
+  );
+}

package/plugin-src/host/inbound-ttl-runtime.mjs

@@ -0,0 +1,85 @@
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+
+import { InboundTtlStore } from '../../src/channels/shared/inbound-ttl-store.mjs';
+import { createInboundTtlService } from './inbound-ttl-service.mjs';
+
+const runtimes = new Map();
+
+/**
+ * Resolve the global settings file shared by every channel. The dshHome
+ * resolution mirrors pluginPaths: config.dshHome, then DSH_HOME, then the
+ * user's home directory. Channel-specific dataDir values never apply.
+ */
+export function inboundTtlSettingsPath(config = {}) {
+  const dshHome = resolve(config.dshHome ?? process.env.DSH_HOME ?? join(homedir(), '.dsh'));
+  return resolve(dshHome, 'integrations', 'dsh-im', 'settings.json');
+}
+
+/**
+ * Per-process inbound TTL runtime, cached by resolved settings path so every
+ * channel shares one store, one staged registry, and one sweep timer. The
+ * entry is dropped (and the sweeper stopped) when the owning context is
+ * disposed, letting a later activation rebuild from disk.
+ */
+export function getInboundTtlRuntime(ctx, config = {}) {
+  const settingsPath = inboundTtlSettingsPath(config);
+  const existing = runtimes.get(settingsPath);
+  if (existing) return existing.runtime;
+  const logger = typeof ctx?.logger === 'function'
+    ? ctx.logger('dsh-im:inbound-ttl') : (ctx?.logger ?? console);
+  const store = new InboundTtlStore(settingsPath);
+  const service = createInboundTtlService({ store, logger });
+  const runtime = Object.freeze({ store, service });
+  const entry = { runtime };
+  runtimes.set(settingsPath, entry);
+  // Load persisted settings before the first sweep so a keep-forever TTL can
+  // never be overtaken by the in-memory default. An unreadable store keeps
+  // sweeping disabled rather than deleting files of unknown intent.
+  void store.load().then(
+    () => service.start(),
+    (error) => logger.error?.('[dsh-im] unable to load inbound attachment settings; sweeping stays disabled', error),
+  );
+  if (typeof ctx?.effect === 'function') {
+    ctx.effect(() => () => {
+      if (runtimes.get(settingsPath) !== entry) return;
+      runtimes.delete(settingsPath);
+      service.stop();
+    }, 'dsh-im: stop inbound attachment TTL sweeper');
+  }
+  return runtime;
+}
+
+/**
+ * Advertise one channel's bot workspaces to the global sweeper. The provider
+ * is consulted at sweep time, so bots added or removed later are always
+ * current. The default workspace is always included.
+ */
+export function registerInboundTtlWorkspaces(ctx, service, {
+  workspaces,
+  configStore,
+  defaultWorkspace,
+  botIdFrom = (bot) => bot?.botId,
+} = {}) {
+  if (!service || typeof service.registerWorkspaceProvider !== 'function') return undefined;
+  if (!workspaces || typeof workspaces.workspaceFor !== 'function'
+    || typeof defaultWorkspace !== 'string' || !defaultWorkspace) {
+    return undefined;
+  }
+  const unregister = service.registerWorkspaceProvider(() => {
+    const bots = typeof configStore?.list === 'function' ? configStore.list() : [];
+    const paths = [defaultWorkspace];
+    for (const bot of Array.isArray(bots) ? bots : []) {
+      try {
+        paths.push(workspaces.workspaceFor(botIdFrom(bot)));
+      } catch {
+        // A malformed config entry must not hide the remaining workspaces.
+      }
+    }
+    return paths;
+  });
+  if (typeof ctx?.effect === 'function') {
+    ctx.effect(() => unregister, 'dsh-im: unregister inbound TTL workspaces');
+  }
+  return unregister;
+}