@xmanrui/dsh-im 4.9.1 → 4.11.0

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',
@@ -346,6 +351,13 @@ const EN = Object.freeze({
   '请选择 Agent Preset。': 'Choose an Agent Preset.',
   'Agent Preset 无效。': 'The Agent Preset is invalid.',
   'Agent Preset 不存在或不可用。': 'The Agent Preset does not exist or is unavailable.',
+  '模型': 'Model',
+  '查看模型设置说明': 'View model setting help',
+  '跟随默认模型': 'Follow the default model',
+  '模型修改失败，请重试。': 'Could not update the model. Try again.',
+  '模型无效。': 'The model is invalid.',
+  '模型不存在或不可用。': 'The model does not exist or is unavailable.',
+  '当前模型已不可用，请选择其他模型或跟随默认模型。': 'The current model is unavailable. Choose another model or follow the default.',
   '尚未检查': 'Not checked yet',
   '刚刚': 'Just now',
   '检查连接': 'Check connection',
@@ -761,6 +773,10 @@ const EN = Object.freeze({
   '填写接收消息的用户 ID': 'Enter the recipient user ID',
   '私聊': 'Direct message',
   '群聊': 'Group',
+  '群聊设置': 'Group settings',
+  '当前机器人': 'Current bot',
+  '飞书群聊设置暂不可用。': 'Feishu group settings are currently unavailable.',
+  '飞书服务没有返回当前机器人的设置': 'Feishu did not return settings for this bot',
   '群 Chat ID': 'Group Chat ID',
   '用户 ID': 'User ID',
   '填写钉钉用户 ID': 'Enter the DingTalk user ID',
@@ -823,6 +839,15 @@ const EN = Object.freeze({
   '？使用这个 targetId 的外部调用将返回 unknown-target。': '? External calls using this targetId will return unknown-target.',
   '正在删除…': 'Deleting…',
   '确认删除': 'Delete target',
+  '会话双向同步': 'Two-way Session sync',
+  '自动跟随该私聊的当前会话': 'Automatically follow this direct message’s current Session',
+  '等待该私聊建立新会话': 'Waiting for this direct message to establish a new Session',
+  '关闭时不发送 DSH 会话消息': 'DSH Session messages are not sent while disabled',
+  '仅支持已经聊过、已建立当前会话且使用当前 Host Harness 的私聊目标': 'Only a known direct message with a current Session on this Host Harness is supported',
+  '会话同步仅支持已经聊过、已建立当前会话且使用当前 Host Harness 的私聊目标。': 'Session sync requires a known direct message with a current Session on this Host Harness.',
+  '会话同步设置失败，请稍后重试。': 'Could not update Session sync. Try again later.',
+  '修改接收位置会关闭会话双向同步。': 'Changing the destination disables two-way Session sync.',
+  ' 会话同步设置也会一并删除。': ' Its Session sync setting will also be deleted.',
   '投递目标设置暂不可用。': 'Delivery target settings are unavailable.',
   '无法读取投递目标，请稍后重试。': 'Could not load delivery targets. Try again later.',
   '← 返回机器人列表': '← Back to bots',
@@ -837,6 +862,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 +912,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));

package/plugin-src/client/model-setting.js

@@ -0,0 +1,104 @@
+import * as React from 'react';
+
+import {
+  EMPTY_MODEL_CATALOG,
+  modelSelectionId,
+  normalizeModelCatalog,
+  normalizeModelSelection,
+} from '../../src/channels/shared/model-setting.mjs';
+import { h } from './i18n.js';
+
+export const SET_MODEL_ENDPOINT = 'bot.model.set';
+export { EMPTY_MODEL_CATALOG, normalizeModelCatalog, normalizeModelSelection };
+
+export const ModelCatalogContext = React.createContext(EMPTY_MODEL_CATALOG);
+
+function optionValue(selection) {
+  return JSON.stringify([selection.provider, selection.model]);
+}
+
+export function ModelEditor({ model = null, disabled = false, onSave }) {
+  const catalog = normalizeModelCatalog(
+    React.useContext(ModelCatalogContext) ?? EMPTY_MODEL_CATALOG,
+  );
+  const helpId = React.useId();
+  const current = normalizeModelSelection(model);
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const currentValue = current ? optionValue(current) : '';
+  const currentAvailable = !current || catalog.groups.some(
+    (group) => group.id === current.provider
+      && group.models.some((entry) => entry.id === current.model),
+  );
+
+  const selections = new Map();
+  for (const group of catalog.groups) {
+    for (const entry of group.models) {
+      const selection = { provider: group.id, model: entry.id };
+      selections.set(optionValue(selection), selection);
+    }
+  }
+  if (current && !currentAvailable) selections.set(currentValue, current);
+
+  const change = async (event) => {
+    const nextValue = event.target.value;
+    if (nextValue === currentValue || saving || disabled) return;
+    const next = nextValue ? selections.get(nextValue) : null;
+    if (nextValue && !next) return;
+    setSaving(true);
+    setError(null);
+    try {
+      await onSave?.(next);
+    } catch (cause) {
+      setError(cause?.message ?? '模型修改失败，请重试。');
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return h('div', { className: 'dim-preset dim-modelSetting' },
+    h('div', { className: 'dim-presetHeader' },
+      h('span', { className: 'dim-presetTitle' },
+        h('span', null, '模型'),
+        h('span', { className: 'dim-presetHelp' },
+          h('button', {
+            type: 'button',
+            className: 'dim-presetHelpButton',
+            'aria-label': '查看模型设置说明',
+            'aria-describedby': helpId,
+          }, h('span', { 'aria-hidden': 'true' }, '?')),
+          h('span', {
+            id: helpId,
+            className: 'dim-presetTooltip',
+            role: 'tooltip',
+          }, '只影响新建会话；若当前聊天已有会话，先发送 /new，再发送普通消息生效。'))),
+      saving ? h('span', { className: 'dim-presetStatus' }, '保存中…') : null),
+    h('select', {
+      className: 'dim-presetSelect dim-modelSelect',
+      value: currentValue,
+      disabled: disabled || saving,
+      'aria-label': '模型',
+      onChange: (event) => { void change(event); },
+    },
+      h('option', { value: '' }, '跟随默认模型'),
+      ...catalog.groups.map((group) => h(
+        'optgroup',
+        { key: group.id, label: group.name },
+        ...group.models.map((entry) => {
+          const selection = { provider: group.id, model: entry.id };
+          const id = modelSelectionId(selection);
+          return h('option', { key: id, value: optionValue(selection) },
+            entry.name && entry.name !== entry.id ? `${entry.name}（${id}）` : id);
+        }),
+      )),
+      current && !currentAvailable
+        ? h('option', { value: currentValue }, [modelSelectionId(current), '（已不可用）'])
+        : null,
+    ),
+    error || !currentAvailable ? h(
+      'p',
+      { className: 'dim-presetError', role: error ? 'alert' : 'status' },
+      error ?? '当前模型已不可用，请选择其他模型或跟随默认模型。',
+    ) : null,
+  );
+}