@xmanrui/dsh-im 4.9.0 → 4.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.9.0",
+  "version": "4.10.0",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
@@ -22,10 +22,7 @@
     "whatsapp",
     "ai-office"
   ],
-  "author": {
-    "name": "xmanrui",
-    "url": "https://github.com/xmanrui"
-  },
+  "author": "xmanrui (https://github.com/xmanrui)",
   "contributors": [
     {
       "name": "C3H3-AI",
@@ -47,7 +44,9 @@
     "url": "git+https://github.com/xmanrui/dsh-im.git"
   },
   "homepage": "https://github.com/xmanrui/dsh-im#readme",
-  "bugs": "https://github.com/xmanrui/dsh-im/issues",
+  "bugs": {
+    "url": "https://github.com/xmanrui/dsh-im/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -88,6 +87,17 @@
         "@deepseek-ai/dsh-client-locale"
       ],
       "platform": "web"
+    },
+    "compatibility": {
+      "dsh": "0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1",
+      "dshReleases": {
+        "0.1.2-alpha.4": "compatible",
+        "0.1.2-alpha.5": "compatible",
+        "0.1.2-rc.1": "compatible"
+      },
+      "profiles": [
+        "web"
+      ]
     }
   },
   "scripts": {
@@ -116,5 +126,10 @@
     "react-dom": "18.3.1",
     "react-test-renderer": "18.3.1",
     "semver": "7.8.5"
+  },
+  "directories": {
+    "doc": "docs",
+    "lib": "lib",
+    "test": "test"
   }
 }

package/plugin-src/client/channels/dingtalk/api.js

@@ -85,11 +85,20 @@ function sanitizeMessage(value, fallback) {
   return message.replace(/([=:]\s*)[^\s,;，。]+/g, '$1••••••').slice(0, 240);
 }
 
+function safeReferenceId(value) {
+  const referenceId = optionalString(value, 40);
+  return referenceId && /^DT-CONN-[A-F0-9]{8}$/.test(referenceId) ? referenceId : undefined;
+}
+
 function normalizeError(value, fallbackCode, fallbackMessage) {
   if (!isRecord(value)) return undefined;
+  const hint = sanitizeMessage(value.hint, '');
+  const referenceId = safeReferenceId(value.referenceId);
   return {
     code: safeErrorCode(value.code, fallbackCode),
     message: sanitizeMessage(value.message, fallbackMessage),
+    ...(hint ? { hint } : {}),
+    ...(referenceId ? { referenceId } : {}),
   };
 }
 
@@ -108,8 +117,15 @@ export function unwrapRpcResult(result) {
     throw new Error('钉钉服务返回了无法识别的响应');
   }
   if (!result.ok) {
-    const error = new Error(sanitizeMessage(result.error?.message, '钉钉操作失败'));
-    error.code = safeErrorCode(result.error?.code, 'DINGTALK_RPC_ERROR');
+    const visible = normalizeError(
+      result.error,
+      'DINGTALK_RPC_ERROR',
+      '钉钉操作失败',
+    ) ?? { code: 'DINGTALK_RPC_ERROR', message: '钉钉操作失败' };
+    const error = new Error(visible.message);
+    error.code = visible.code;
+    if (visible.hint) error.hint = visible.hint;
+    if (visible.referenceId) error.referenceId = visible.referenceId;
     throw error;
   }
   return result.value;
@@ -227,10 +243,11 @@ export function connectionTestFeedback(result) {
 }
 
 export function presentError(error) {
-  return {
-    code: safeErrorCode(error?.code, 'DINGTALK_ERROR'),
-    message: sanitizeMessage(error?.message, '钉钉操作失败，请稍后重试'),
-  };
+  return normalizeError(
+    error,
+    'DINGTALK_ERROR',
+    '钉钉操作失败，请稍后重试',
+  ) ?? { code: 'DINGTALK_ERROR', message: '钉钉操作失败，请稍后重试' };
 }
 
 export function formatRemaining(milliseconds) {

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

@@ -169,19 +169,36 @@ function ProgressPanel({ status, busy, onCancel }) {
       h(Button, { onClick: onCancel, disabled: busy }, '取消接入')));
 }
 
+function ConnectionErrorDiagnostic({ error }) {
+  if (!error) return null;
+  return h('div', { className: 'ddt-errorDiagnostic' },
+    error.hint ? h('p', { className: 'ddt-errorHint' }, error.hint) : null,
+    h('span', { className: 'ddt-errorCode' },
+      h('span', null, '错误码'), `: ${error.code}`,
+      error.referenceId
+        ? h(React.Fragment, null, ' · ', h('span', null, '参考号'), `: ${error.referenceId}`)
+        : null));
+}
+
 function ProvisionError({ provision, busy, onRetry, onClose }) {
   const error = provision.error ?? {
     code: 'DINGTALK_PROVISION_FAILED',
     message: '钉钉机器人没有接入完成',
   };
+  const connectionFailed = Boolean(error.referenceId);
   return h('div', { className: 'ddt-card dim-surfaceCard' },
     h('div', { className: 'ddt-inlineError dim-inlineError', role: 'alert' },
-      h('h3', null, provision.status === 'expired' ? '二维码已过期' : '钉钉机器人没有接入完成'),
+      h('h3', null, provision.status === 'expired'
+        ? '二维码已过期'
+        : connectionFailed ? '机器人已保存，但连接未就绪' : '钉钉机器人没有接入完成'),
       h('p', null, error.message),
-      h('span', { className: 'ddt-errorCode' }, error.code),
+      h(ConnectionErrorDiagnostic, { error }),
       h('div', { className: 'ddt-actions dim-viewActions' },
-        h(Button, { kind: 'primary', onClick: onRetry, disabled: busy }, '重新生成二维码'),
-        h(Button, { onClick: onClose, disabled: busy }, '关闭'))));
+        connectionFailed
+          ? h(Button, { kind: 'primary', onClick: onClose, disabled: busy }, '查看已保存的机器人')
+          : h(React.Fragment, null,
+              h(Button, { kind: 'primary', onClick: onRetry, disabled: busy }, '重新生成二维码'),
+              h(Button, { onClick: onClose, disabled: busy }, '关闭')))));
 }
 
 function checkedTime(value) {
@@ -278,6 +295,7 @@ export function AccountCard({
             h(Button, { className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy) },
               '移除接入')),
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.error ? h(ConnectionErrorDiagnostic, { error: account.error }) : null,
           account.lastMessageError ? h(LastMessageErrorSummary, {
             className: 'ddt-summary',
             error: account.lastMessageError,
@@ -614,6 +632,12 @@ export function DingtalkSettingsTab({ rpcCall }) {
             ? snapshot?.bots.find((bot) => bot.botId === result.botId)
             : snapshot?.bots.find((bot) => bot.connected);
           if (!account?.connected) {
+            if (account?.error) {
+              setProvision((current) => current?.attemptId === attemptId
+                ? { ...current, ...result, status: 'failed', error: account.error }
+                : current);
+              return;
+            }
             setProvision((current) => current?.attemptId === attemptId
               ? { ...current, ...result, status: 'connecting' }
               : current);
@@ -698,9 +722,12 @@ export function DingtalkSettingsTab({ rpcCall }) {
       return snapshot;
     } catch (error) {
       if (!mountedRef.current) return undefined;
+      const visibleError = presentError(error);
       const failureMessage = operation === 'reconnect'
-        ? '连接检查失败，请稍后重试。'
-        : `操作失败：${presentError(error).message}`;
+        ? visibleError.referenceId
+          ? `连接检查失败：${visibleError.message}（参考号：${visibleError.referenceId}）`
+          : '连接检查失败，请稍后重试。'
+        : `操作失败：${visibleError.message}`;
       if (operation === 'reconnect') {
         setFeedbackByBot((current) => ({
           ...current,

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

@@ -77,6 +77,8 @@ const CSS = String.raw`
 .ddt-inlineError h3 { font-size: 17px; }
 .ddt-inlineError p { line-height: 1.55; }
 .ddt-errorCode { font: 11px ui-monospace, SFMono-Regular, monospace; opacity: .8; }
+.ddt-errorDiagnostic { display: grid; gap: 5px; color: var(--ddt-error); }
+.ddt-errorHint { margin: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 1.55; }
 .ddt-listHeading { display: flex; align-items: center; justify-content: space-between; margin: 2px 0 9px; }
 .ddt-listHeading h3 { margin: 0; font-size: 14px; }
 .ddt-list { display: grid; gap: 12px; margin: 0; padding: 0; list-style: none; }

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

@@ -29,6 +29,7 @@ export const FEISHU_ENDPOINTS = Object.freeze({
   setContextEnhancement: "bot.context-enhancement.set",
   setAccessPolicy: "bot.access-policy.set",
   setGroupResponseMode: "bot.group-response-mode.set",
+  setGroupTopicReply: "bot.group-topic-reply.set",
   // Kept for rolling upgrades. The multi-bot UI never calls these endpoints.
   testConnection: "connection.test",
   disconnect: "connection.disconnect",
@@ -212,6 +213,7 @@ export function normalizeBotConnection(value, fallbackBotId) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     groupResponseMode: normalizeGroupResponseMode(value.groupResponseMode),
+    groupTopicReply: value.groupTopicReply === true,
     groupMessagePermissionGranted: value.groupMessagePermissionGranted === true,
     bot: normalizeBot(value.bot),
     health: normalizeHealth(value.health, connected),

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

@@ -542,6 +542,50 @@ function GroupResponseModeEditor({
   );
 }
 
+function GroupTopicReplyEditor({ value = false, disabled = false, onSave }) {
+  const current = value === true ? "on" : "off";
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+
+  const change = async (event) => {
+    const next = event.target.value === "on";
+    if ((next ? "on" : "off") === current || saving || disabled) return;
+    setSaving(true);
+    setError(null);
+    try {
+      await onSave?.(next);
+    } catch (cause) {
+      setError(cause?.message ?? "群聊以话题方式回复设置保存失败，请重试。");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return h("div", { className: "bxf-responseMode dim-responseMode" },
+    h("div", { className: "bxf-responseModeHeader dim-responseModeHeader" },
+      h("span", null, "群聊以话题方式回复"),
+      saving
+        ? h("span", { className: "bxf-responseModeStatus dim-responseModeStatus" }, "保存中…")
+        : null),
+    h("select", {
+      className: "bxf-responseModeSelect dim-responseModeSelect",
+      value: current,
+      disabled: disabled || saving,
+      "aria-label": "群聊以话题方式回复",
+      onChange: (event) => { void change(event); },
+    },
+      h("option", { value: "off" }, "关闭（群内直接回复）"),
+      h("option", { value: "on" }, "开启（自动开启独立飞书话题）"),
+    ),
+    h("small", { className: "bxf-responseModeHelp dim-responseModeHelp" },
+      "开启后，群聊中向机器人提问会自动开启独立飞书话题，回复落在话题内；每个话题是 dsh 会话列表里一条独立会话，上下文互不串。私聊不受影响。"),
+    error ? h("p", {
+      className: "bxf-responseModeError dim-responseModeError",
+      role: "alert",
+    }, error) : null,
+  );
+}
+
 export function BotCard({
   connection,
   busy,
@@ -557,6 +601,7 @@ export function BotCard({
   onAgentPresetSave,
   onContextEnhancementSave,
   onGroupResponseModeSave,
+  onGroupTopicReplySave,
   onGroupMessagePermissionAuthorize,
   onRequestRemove,
   onConfirmRemove,
@@ -635,6 +680,11 @@ export function BotCard({
         onSave: onGroupResponseModeSave,
         onAuthorize: onGroupMessagePermissionAuthorize,
       }),
+      h(GroupTopicReplyEditor, {
+        value: connection.groupTopicReply,
+        disabled: Boolean(busy),
+        onSave: onGroupTopicReplySave,
+      }),
       provisionContent
         ? h("section", {
             className: "bxf-botProvision dim-botProvision",
@@ -726,6 +776,7 @@ function BotList(props) {
           onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(bot, agentPreset),
           onContextEnhancementSave: (config) => props.onContextEnhancementSave(bot, config),
           onGroupResponseModeSave: (groupResponseMode) => props.onGroupResponseModeSave(bot, groupResponseMode),
+          onGroupTopicReplySave: (groupTopicReply) => props.onGroupTopicReplySave(bot, groupTopicReply),
           onGroupMessagePermissionAuthorize: () => props.onGroupMessagePermissionAuthorize(bot),
           onRequestRemove: () => props.onRequestRemove(bot),
           onConfirmRemove: () => props.onConfirmRemove(bot),
@@ -1545,6 +1596,9 @@ export function FeishuSettingsTab({ rpcCall }) {
                     connection, "context-enhancement", FEISHU_ENDPOINTS.setContextEnhancement, { config },
                   ),
                   onGroupResponseModeSave: saveGroupResponseMode,
+                  onGroupTopicReplySave: (connection, groupTopicReply) => saveBotSetting(
+                    connection, "group-topic-reply", FEISHU_ENDPOINTS.setGroupTopicReply, { groupTopicReply },
+                  ),
                   onGroupMessagePermissionAuthorize: authorizeGroupMessages,
                   onRequestRemove: requestRemove,
                   onConfirmRemove: (bot) => void confirmRemove(bot),

package/plugin-src/client/global-settings.js

@@ -0,0 +1,341 @@
+import * as React from 'react';
+
+import {
+  DEFAULT_INBOUND_TTL_HOURS,
+  INBOUND_TTL_MAX_HOURS,
+  normalizeInboundTtlHours,
+} from '../../src/channels/shared/inbound-ttl.mjs';
+import { h } from './i18n.js';
+
+export const GLOBAL_SETTINGS_RPC_CHANNEL = '/dsh-im-settings';
+
+export const GLOBAL_SETTINGS_TAB_ID = 'global-settings';
+
+const ATTACHMENTS_TAB_ID = 'dim-general-settings-tab-attachments';
+const ATTACHMENTS_PANEL_ID = 'dim-general-settings-panel-attachments';
+
+export const GLOBAL_SETTINGS_ENDPOINTS = Object.freeze({
+  getTtl: 'settings.inbound-ttl.get',
+  setTtl: 'settings.inbound-ttl.set',
+  sweep: 'settings.inbound-ttl.sweep',
+});
+
+function presentError(error, fallback) {
+  return error?.message || fallback;
+}
+
+function unwrapRpcResult(result) {
+  if (result?.ok === true) return result.value;
+  if (result?.ok === false) {
+    const error = new Error(result.error?.message || '请求失败，请稍后重试。');
+    error.code = result.error?.code;
+    throw error;
+  }
+  return result;
+}
+
+export function GlobalSettingsLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...(size === undefined ? {} : { width: size, height: size }),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-icon': 'global-settings',
+  }, h('path', {
+    fill: 'currentColor',
+    d: 'M19.14 12.94c.04-.3.06-.61.06-.94 0-.32-.02-.64-.07-.94l2.03-1.58a.49.49 0 0 0 .12-.61l-1.92-3.32a.488.488 0 0 0-.59-.22l-2.39.96c-.5-.38-1.03-.7-1.62-.94l-.36-2.54a.484.484 0 0 0-.48-.41h-3.84c-.24 0-.43.17-.47.41l-.36 2.54c-.59.24-1.13.57-1.62.94l-2.39-.96a.488.488 0 0 0-.59.22L2.74 8.87c-.12.21-.08.47.12.61l2.03 1.58c-.05.3-.09.63-.09.94s.02.64.07.94l-2.03 1.58a.49.49 0 0 0-.12.61l1.92 3.32c.12.22.37.29.59.22l2.39-.96c.5.38 1.03.7 1.62.94l.36 2.54c.05.24.24.41.48.41h3.84c.24 0 .44-.17.47-.41l.36-2.54c.59-.24 1.13-.56 1.62-.94l2.39.96c.22.08.47 0 .59-.22l1.92-3.32c.12-.22.07-.47-.12-.61l-2.01-1.58ZM12 15.6A3.61 3.61 0 0 1 8.4 12c0-1.98 1.62-3.6 3.6-3.6s3.6 1.62 3.6 3.6-1.62 3.6-3.6 3.6Z',
+  }));
+}
+
+function GlobalButton({ children, kind = 'secondary', className = '', ...props }) {
+  return h('button', {
+    ...props,
+    type: props.type ?? 'button',
+    className: `dim-deliveryButton ${className}`.trim(),
+    'data-kind': kind,
+  }, children);
+}
+
+export function GlobalSettingsPanel({ rpcCall }) {
+  const [phase, setPhase] = React.useState('loading');
+  const [loadError, setLoadError] = React.useState(null);
+  const [ttlInput, setTtlInput] = React.useState('');
+  const [savedTtl, setSavedTtl] = React.useState(null);
+  const [ttlError, setTtlError] = React.useState(false);
+  const [saveError, setSaveError] = React.useState(null);
+  const [saveSucceeded, setSaveSucceeded] = React.useState(false);
+  const [isSaving, setIsSaving] = React.useState(false);
+  const [sweepConfirming, setSweepConfirming] = React.useState(false);
+  const [sweeping, setSweeping] = React.useState(false);
+  const ttlErrorId = React.useId();
+  const ttlHintsId = React.useId();
+  const sweepTriggerId = React.useId();
+  const sweepConfirmId = React.useId();
+  const sweepConfirmTextId = React.useId();
+  const sweepConfirmButtonId = React.useId();
+  const mounted = React.useRef(true);
+  const saving = React.useRef(false);
+
+  const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
+    if (typeof rpcCall !== 'function') throw new Error('通用设置暂不可用。');
+    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+  }, [rpcCall]);
+
+  const loadSettings = React.useCallback(async ({ signal } = {}) => {
+    setPhase('loading');
+    setLoadError(null);
+    try {
+      const value = await invoke(GLOBAL_SETTINGS_ENDPOINTS.getTtl, {}, signal);
+      if (signal?.aborted || !mounted.current) return;
+      const ttlHours = normalizeInboundTtlHours(value?.ttlHours);
+      if (ttlHours === null) {
+        setLoadError('通用设置返回了无法识别的响应。');
+        setPhase('error');
+        return;
+      }
+      setSavedTtl(ttlHours);
+      setTtlInput(String(ttlHours));
+      setTtlError(false);
+      setSaveError(null);
+      setSaveSucceeded(false);
+      setPhase('ready');
+    } catch (caught) {
+      if (signal?.aborted || caught?.name === 'AbortError' || !mounted.current) return;
+      setLoadError(presentError(caught, '无法读取通用设置，请稍后重试。'));
+      setPhase('error');
+    }
+  }, [invoke]);
+
+  React.useEffect(() => {
+    mounted.current = true;
+    const controller = new AbortController();
+    void loadSettings({ signal: controller.signal });
+    return () => {
+      mounted.current = false;
+      controller.abort();
+    };
+  }, [loadSettings]);
+
+  React.useEffect(() => {
+    if (!sweepConfirming) return;
+    globalThis.document?.getElementById(sweepConfirmButtonId)?.focus();
+  }, [sweepConfirmButtonId, sweepConfirming]);
+
+  const commitTtl = async () => {
+    if (phase === 'loading' || saving.current) return;
+    const proposed = normalizeInboundTtlHours(ttlInput.trim());
+    if (proposed === null) {
+      setSaveError(null);
+      setSaveSucceeded(false);
+      setTtlError(true);
+      return;
+    }
+    setTtlError(false);
+    if (proposed === savedTtl) return;
+    saving.current = true;
+    setIsSaving(true);
+    setSaveError(null);
+    setSaveSucceeded(false);
+    try {
+      const value = await invoke(GLOBAL_SETTINGS_ENDPOINTS.setTtl, { ttlHours: proposed });
+      if (!mounted.current) return;
+      const confirmed = normalizeInboundTtlHours(value?.ttlHours);
+      const finalTtl = confirmed === null ? proposed : confirmed;
+      setSavedTtl(finalTtl);
+      // Never clobber the field if the user kept typing while the save was in flight.
+      setTtlInput((current) => current.trim() === String(proposed) ? String(finalTtl) : current);
+      setLoadError(null);
+      setSaveSucceeded(true);
+      setPhase('ready');
+    } catch (caught) {
+      if (mounted.current) {
+        setSaveError(presentError(caught, '设置保存失败，请稍后重试。'));
+      }
+    } finally {
+      saving.current = false;
+      if (mounted.current) setIsSaving(false);
+    }
+  };
+
+  const requestSweep = () => {
+    if (sweeping) return;
+    setSweepConfirming(true);
+  };
+
+  const cancelSweep = ({ restoreFocus = false } = {}) => {
+    setSweepConfirming(false);
+    if (restoreFocus) globalThis.document?.getElementById(sweepTriggerId)?.focus();
+  };
+
+  const runSweep = async () => {
+    setSweepConfirming(false);
+    setSweeping(true);
+    try {
+      // Manual sweeps are silent by design: the busy label on the button is
+      // the only feedback, and RPC results or failures are not announced.
+      await invoke(GLOBAL_SETTINGS_ENDPOINTS.sweep, {});
+    } catch {
+      // Intentionally swallowed — no result feedback for manual sweeps.
+    } finally {
+      if (mounted.current) setSweeping(false);
+    }
+  };
+
+  const inlineStatus = phase === 'loading'
+    ? { role: 'status', message: '正在读取通用设置…' }
+    : ttlError
+      ? { role: 'alert', message: `请输入 -1、0 或 1~${INBOUND_TTL_MAX_HOURS} 之间的整数。` }
+      : saveError
+        ? { role: 'alert', message: saveError }
+        : phase === 'error' && loadError
+          ? { role: 'alert', message: loadError }
+          : saveSucceeded
+            ? { role: 'status', message: '已保存' }
+            : null;
+
+  const proposedTtl = normalizeInboundTtlHours(ttlInput.trim());
+  const canSave = phase !== 'loading'
+    && !isSaving
+    && proposedTtl !== null
+    && proposedTtl !== savedTtl;
+
+  return h('section', { className: 'dim-generalSettingsPage', 'aria-label': '通用设置' },
+    h('header', { className: 'dim-generalSettingsHeader' },
+      h('h2', null, '通用设置')),
+    h('div', { className: 'dim-generalSettingsTabsBar' },
+      h('div', {
+        className: 'dim-generalSettingsTabs',
+        role: 'tablist',
+        'aria-label': '通用设置分类',
+      },
+      h('button', {
+        type: 'button',
+        id: ATTACHMENTS_TAB_ID,
+        className: 'dim-generalSettingsTab',
+        role: 'tab',
+        'aria-selected': true,
+        'aria-controls': ATTACHMENTS_PANEL_ID,
+      }, '附件'))),
+    h('div', {
+      id: ATTACHMENTS_PANEL_ID,
+      className: 'dim-generalSettingsTabPanel',
+      role: 'tabpanel',
+      'aria-labelledby': ATTACHMENTS_TAB_ID,
+    },
+    h('section', {
+      className: 'dim-globalSection',
+      'aria-label': '附件',
+      'aria-busy': phase === 'loading',
+    },
+    h('div', { className: 'dim-globalHead' },
+      h('div', { className: 'dim-globalHeadTitle' },
+        h('h3', { id: 'dim-globalTtlTitle' }, '附件保留时长 (小时)'),
+        h('div', { className: 'dim-globalTtlHelp' },
+          h('button', {
+            type: 'button',
+            className: 'dim-channelHelpButton dim-globalTtlHelpButton',
+            'aria-label': '查看附件保留时长说明',
+            'aria-describedby': ttlHintsId,
+          }, h('span', { 'aria-hidden': 'true' }, '?')),
+          h('div', {
+            id: ttlHintsId,
+            className: 'dim-globalTtlTooltip',
+            role: 'tooltip',
+          },
+          h('ul', { className: 'dim-globalTtlHints' },
+            h('li', null,
+              h('code', null, '-1'),
+              h('span', null, '永久保留，不会自动清理')),
+            h('li', null,
+              h('code', null, '0'),
+              h('span', null, '每 Turn 结束后立即清理')),
+            h('li', null,
+              h('code', null, `1~${INBOUND_TTL_MAX_HOURS}`),
+              h('span', null, '小时后自动清理'))))))),
+    h('form', {
+      className: 'dim-globalTtlRow',
+      onSubmit: (event) => {
+        event.preventDefault();
+        void commitTtl();
+      },
+    },
+      h('input', {
+        id: 'dim-globalTtlInput',
+        className: 'dim-globalTtlInput',
+        type: 'text',
+        value: ttlInput,
+        placeholder: String(DEFAULT_INBOUND_TTL_HOURS),
+        autoComplete: 'off',
+        disabled: phase === 'loading' || isSaving,
+        'aria-labelledby': 'dim-globalTtlTitle',
+        'aria-invalid': ttlError ? 'true' : undefined,
+        'aria-describedby': ttlError ? ttlErrorId : ttlHintsId,
+        onBlur: () => {
+          setTtlError(normalizeInboundTtlHours(ttlInput.trim()) === null);
+        },
+        onKeyDown: (event) => {
+          if (event.key !== 'Enter') return;
+          event.preventDefault();
+          void commitTtl();
+        },
+        onChange: (event) => {
+          setTtlInput(event.target.value);
+          setTtlError(false);
+          setSaveError(null);
+          setSaveSucceeded(false);
+        },
+      }),
+      h(GlobalButton, {
+        type: 'submit',
+        kind: 'primary',
+        className: 'dim-globalSaveButton',
+        disabled: !canSave,
+      }, isSaving ? '保存中…' : '保存'),
+      h('div', {
+        className: 'dim-globalSweepAction',
+        onBlur: (event) => {
+          if (sweepConfirming && !event.currentTarget.contains(event.relatedTarget)) cancelSweep();
+        },
+      },
+      h(GlobalButton, {
+        id: sweepTriggerId,
+        className: 'dim-globalSweepButton',
+        onClick: () => (sweepConfirming ? cancelSweep() : requestSweep()),
+        disabled: sweeping,
+        'aria-haspopup': 'dialog',
+        'aria-expanded': sweepConfirming,
+        'aria-controls': sweepConfirmId,
+      }, sweeping ? '正在清理…' : '清理过期附件'),
+      sweepConfirming
+        ? h('div', {
+          id: sweepConfirmId,
+          className: 'dim-globalSweepConfirm',
+          role: 'alertdialog',
+          'aria-label': '确认清理过期附件',
+          'aria-describedby': sweepConfirmTextId,
+          onKeyDown: (event) => {
+            if (event.key !== 'Escape') return;
+            event.preventDefault();
+            cancelSweep({ restoreFocus: true });
+          },
+        },
+        h('p', { id: sweepConfirmTextId }, '确认清理当前已过期的附件？'),
+        h('div', { className: 'dim-globalSweepConfirmActions' },
+          h(GlobalButton, { onClick: () => cancelSweep({ restoreFocus: true }) }, '取消'),
+          h(GlobalButton, {
+            id: sweepConfirmButtonId,
+            kind: 'danger',
+            className: 'dim-globalSweepConfirmButton',
+            onClick: () => void runSweep(),
+          }, '确认清理')))
+        : null),
+      inlineStatus
+        ? h('p', {
+          id: ttlErrorId,
+          className: 'dim-globalInline',
+          'data-tone': inlineStatus.role === 'alert' ? 'error' : undefined,
+          role: inlineStatus.role,
+          'aria-live': inlineStatus.role === 'status' ? 'polite' : undefined,
+        }, inlineStatus.message)
+        : null))));
+}