@xmanrui/dsh-im 4.9.1 → 4.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.9.1",
+  "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",
@@ -87,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": {

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))));
+}

package/plugin-src/client/i18n.js

@@ -215,6 +215,11 @@ const EN = Object.freeze({
   '需在飞书为该机器人开通“获取群组中所有消息”权限（im:message.group_msg）；开通后，机器人会处理群聊中的所有可见消息。': 'Grant this bot the “Read all messages in associated group chat” Feishu scope (im:message.group_msg); once granted, it will process every visible group message.',
   '群聊响应方式修改失败，请重试。': 'Could not update the group response mode. Try again.',
   '群消息权限授权失败，请重试。': 'Could not authorize group-message permission. Try again.',
+  '群聊以话题方式回复': 'Reply to group chats as Feishu topics',
+  '群聊以话题方式回复设置保存失败，请重试。': 'Could not save the topic reply setting. Try again.',
+  '关闭（群内直接回复）': 'Off (reply in the group feed)',
+  '开启（自动开启独立飞书话题）': 'On (auto-open a dedicated Feishu topic)',
+  '开启后，群聊中向机器人提问会自动开启独立飞书话题，回复落在话题内；每个话题是 dsh 会话列表里一条独立会话，上下文互不串。私聊不受影响。': 'When enabled, questions to the bot in a group auto-open a dedicated Feishu topic and replies stay inside it. Each topic is an independent conversation in dsh with its own context. Private chats are unaffected.',
   '钉钉设置': 'DingTalk settings',
   '企业微信设置': 'WeCom settings',
   '扫码接入机器人': 'Scan QR code',
@@ -837,6 +842,28 @@ const EN = Object.freeze({
   '正在读取投递目标…': 'Loading delivery targets…',
   '尚未配置投递目标': 'No delivery targets yet',
   '点击“新建目标”可从已聊过的会话选择，也可手动填写。': 'Select New target to choose a conversation or enter the details manually.',
+  '全局设置': 'Global settings',
+  '通用设置': 'General settings',
+  '通用设置分类': 'General settings categories',
+  '附件': 'Attachments',
+  'IM 设置导航': 'IM settings navigation',
+  '附件保留时长 (小时)': 'Attachment retention (hours)',
+  '查看附件保留时长说明': 'View attachment retention details',
+  '永久保留，不会自动清理': 'Keep forever; nothing is removed automatically',
+  '每 Turn 结束后立即清理': 'Cleaned up as soon as each turn ends',
+  '小时后自动清理': 'hours until automatic cleanup',
+  '请输入 -1、0 或 1~${INBOUND_TTL_MAX_HOURS} 之间的整数。': 'Enter -1, 0, or an integer from 1 to ${INBOUND_TTL_MAX_HOURS}.',
+  '设置保存失败，请稍后重试。': 'Could not save the setting. Try again later.',
+  '已保存': 'Saved',
+  '通用设置暂不可用。': 'General settings are unavailable.',
+  '正在读取通用设置…': 'Loading general settings…',
+  '无法读取通用设置，请稍后重试。': 'Could not load general settings. Try again later.',
+  '通用设置返回了无法识别的响应。': 'General settings returned an unrecognized response.',
+  '清理过期附件': 'Clean up expired attachments',
+  '确认清理过期附件': 'Confirm expired attachment cleanup',
+  '确认清理当前已过期的附件？': 'Clean up the attachments that are currently expired?',
+  '确认清理': 'Confirm cleanup',
+  '正在清理…': 'Cleaning up…',
 });
 
 export const en = EN;
@@ -865,6 +892,8 @@ function translateDynamic(text) {
   if (match) return `${match[1]}/${match[2]} online`;
   match = /^已接入 (\d+) 个机器人，其中 (\d+) 个在线$/.exec(text);
   if (match) return `${match[2]} of ${match[1]} bots online`;
+  match = /^请输入 -1、0 或 1~(\d+) 之间的整数。$/.exec(text);
+  if (match) return `Enter -1, 0, or an integer from 1 to ${match[1]}.`;
   match = /^正在读取\s*(.+?)\s*机器人状态…$/.exec(text);
   if (match) return `Loading ${channelName(match[1])} bot status…`;
   match = /^无法读取\s*(.+?)\s*机器人状态$/.exec(text);

package/plugin-src/client/index.js

@@ -48,6 +48,12 @@ import {
   DELIVERY_RPC_CHANNEL,
   DeliveryTargetSettingsPage,
 } from './delivery-settings.js';
+import {
+  GLOBAL_SETTINGS_RPC_CHANNEL,
+  GLOBAL_SETTINGS_TAB_ID,
+  GlobalSettingsLogoGlyph,
+  GlobalSettingsPanel,
+} from './global-settings.js';
 import {
   createLoopbackAwareRpcCalls,
   replacePageLocation,
@@ -173,6 +179,7 @@ export function IMSettingsTab({
   officeRpcCall,
   updateRpcCall,
   deliveryRpcCall,
+  globalSettingsRpcCall,
   workspaceDirectoryPicker,
   browserLocation = globalThis.location,
   navigateToRecoveryUrl = replacePageLocation,
@@ -182,7 +189,15 @@ export function IMSettingsTab({
   const [runningVersion, setRunningVersion] = React.useState(IM_PLUGIN_VERSION);
   const [deliverySettings, setDeliverySettings] = React.useState(null);
   const githubTooltipId = React.useId();
+  const generalSettingsTooltipId = React.useId();
+  const globalSettingsSelected = selected === GLOBAL_SETTINGS_TAB_ID;
   const active = CHANNELS.find((channel) => channel.id === selected) ?? CHANNELS[0];
+  const activeTabId = globalSettingsSelected
+    ? 'dim-general-settings-trigger'
+    : `dim-tab-${active.id}`;
+  const activePanelId = globalSettingsSelected
+    ? `dim-panel-${GLOBAL_SETTINGS_TAB_ID}`
+    : `dim-panel-${active.id}`;
   const reportLoopbackRecovery = React.useCallback((recovery) => {
     setLoopbackRecovery((current) => current?.url === recovery.url ? current : recovery);
   }, []);
@@ -202,6 +217,7 @@ export function IMSettingsTab({
     officeRpcCall,
     updateRpcCall,
     deliveryRpcCall,
+    globalSettingsRpcCall,
   }, {
     location: browserLocation,
     onRecovery: reportLoopbackRecovery,
@@ -211,6 +227,7 @@ export function IMSettingsTab({
     discordRpcCall,
     deliveryRpcCall,
     feishuRpcCall,
+    globalSettingsRpcCall,
     officeRpcCall,
     qqRpcCall,
     reportLoopbackRecovery,
@@ -253,17 +270,36 @@ export function IMSettingsTab({
           id: githubTooltipId,
           className: 'dim-githubTooltip',
           role: 'tooltip',
-        }, '帮助与反馈 · 前往 GitHub'))),
+        }, '帮助与反馈 · 前往 GitHub')),
+      h('span', { className: 'dim-generalSettingsAction' },
+        h('button', {
+          type: 'button',
+          id: 'dim-general-settings-trigger',
+          className: 'dim-generalSettingsButton',
+          'aria-label': '通用设置',
+          'aria-describedby': generalSettingsTooltipId,
+          'aria-controls': `dim-panel-${GLOBAL_SETTINGS_TAB_ID}`,
+          'aria-current': globalSettingsSelected ? 'page' : undefined,
+          onClick: () => {
+            setSelected(GLOBAL_SETTINGS_TAB_ID);
+            setDeliverySettings(null);
+          },
+        }, h(GlobalSettingsLogoGlyph, { size: 17 })),
+        h('span', {
+          id: generalSettingsTooltipId,
+          className: 'dim-generalSettingsTooltip',
+          role: 'tooltip',
+        }, '通用设置'))),
     ),
     h('div', { className: 'dim-layout' },
-      h('nav', { className: 'dim-rail', role: 'tablist', 'aria-label': 'IM 渠道' },
+      h('nav', { className: 'dim-rail', role: 'tablist', 'aria-label': 'IM 设置导航' },
         CHANNELS.map((channel) => h('button', {
           key: channel.id,
           type: 'button',
           role: 'tab',
           id: `dim-tab-${channel.id}`,
           className: 'dim-channel',
-          'aria-selected': channel.id === active.id,
+          'aria-selected': !globalSettingsSelected && channel.id === active.id,
           'aria-controls': `dim-panel-${channel.id}`,
           onClick: () => {
             setSelected(channel.id);
@@ -279,8 +315,8 @@ export function IMSettingsTab({
       h('main', {
         className: 'dim-panel',
         role: 'tabpanel',
-        id: `dim-panel-${active.id}`,
-        'aria-labelledby': `dim-tab-${active.id}`,
+        id: activePanelId,
+        'aria-labelledby': activeTabId,
       },
       loopbackRecovery
         ? h(LoopbackRecoveryNotice, {
@@ -289,7 +325,9 @@ export function IMSettingsTab({
           })
         : null,
       h(BotSettingsContext.Provider, { value: botSettingsContext },
-        deliverySettings?.channel === active.id
+        globalSettingsSelected
+          ? h(GlobalSettingsPanel, { rpcCall: rpcCalls.globalSettingsRpcCall })
+          : deliverySettings?.channel === active.id
           ? h(DeliveryTargetSettingsPage, {
               channel: active.id,
               account: deliverySettings,
@@ -370,6 +408,8 @@ export function apply(ctx) {
     ctx.connection.rpc.call(UPDATE_RPC_CHANNEL, endpoint, payload, signal);
   const deliveryRpcCall = (endpoint, payload, signal) =>
     ctx.connection.rpc.call(DELIVERY_RPC_CHANNEL, endpoint, payload, signal);
+  const globalSettingsRpcCall = (endpoint, payload, signal) =>
+    ctx.connection.rpc.call(GLOBAL_SETTINGS_RPC_CHANNEL, endpoint, payload, signal);
   const workspaceDirectoryPicker = Object.freeze({
     listDirectory: (path, signal) =>
       callWorkspaceDirectoryApi(ctx, 'listDirectory', path, signal),
@@ -395,6 +435,7 @@ export function apply(ctx) {
       officeRpcCall,
       updateRpcCall,
       deliveryRpcCall,
+      globalSettingsRpcCall,
       workspaceDirectoryPicker,
     }),
   }, IMSettingsTab));