@xmanrui/dsh-im 0.17.0 → 0.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

package/plugin-src/client/agent-preset.js

@@ -0,0 +1,110 @@
+import * as React from 'react';
+
+import { h } from './i18n.js';
+
+export const SET_AGENT_PRESET_ENDPOINT = 'bot.preset.set';
+
+const PRESET_ID = /^[a-z0-9][a-z0-9-]*$/;
+
+export const EMPTY_AGENT_PRESET_CATALOG = Object.freeze({
+  defaultId: '',
+  items: Object.freeze([]),
+});
+
+export const AgentPresetCatalogContext = React.createContext(EMPTY_AGENT_PRESET_CATALOG);
+
+export function normalizeAgentPresetId(value) {
+  if (typeof value !== 'string') return '';
+  const id = value.trim();
+  return PRESET_ID.test(id) ? id : '';
+}
+
+export function normalizeAgentPresetCatalog(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return { defaultId: '', items: [] };
+  }
+  const items = [];
+  const seen = new Set();
+  for (const entry of Array.isArray(value.items) ? value.items : []) {
+    const id = typeof entry === 'string'
+      ? normalizeAgentPresetId(entry)
+      : normalizeAgentPresetId(entry?.id);
+    if (!id || seen.has(id)) continue;
+    seen.add(id);
+    const label = typeof entry?.label === 'string' && entry.label.trim()
+      ? entry.label.trim().slice(0, 128)
+      : typeof entry?.name === 'string' && entry.name.trim()
+        ? entry.name.trim().slice(0, 128)
+        : id;
+    items.push({ id, label });
+  }
+  return {
+    defaultId: normalizeAgentPresetId(value.defaultId),
+    items,
+  };
+}
+
+export function AgentPresetEditor({ agentPreset = '', disabled = false, onSave }) {
+  const catalog = React.useContext(AgentPresetCatalogContext) ?? EMPTY_AGENT_PRESET_CATALOG;
+  const current = normalizeAgentPresetId(agentPreset);
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+
+  const items = [];
+  const seen = new Set();
+  for (const item of Array.isArray(catalog.items) ? catalog.items : []) {
+    if (!item?.id || seen.has(item.id)) continue;
+    seen.add(item.id);
+    items.push(item);
+  }
+  const currentUnavailable = Boolean(current && !seen.has(current));
+  if (currentUnavailable) items.push({ id: current, label: current, unavailable: true });
+
+  const inheritLabel = '跟随 Host 默认';
+
+  const change = async (event) => {
+    const next = event.target.value;
+    if (next === current || saving || disabled) return;
+    setSaving(true);
+    setError(null);
+    try {
+      await onSave?.(next || null);
+    } catch (cause) {
+      setError(cause?.message ?? 'Agent Preset 修改失败，请重试。');
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return h('div', { className: 'dim-preset' },
+    h('div', { className: 'dim-presetHeader' },
+      h('span', null, 'Agent Preset'),
+      saving ? h('span', { className: 'dim-presetStatus' }, '保存中…') : null),
+    React.createElement('select', {
+      className: 'dim-presetSelect',
+      value: current,
+      disabled: disabled || saving,
+      'aria-label': 'Agent Preset',
+      onChange: (event) => { void change(event); },
+    },
+      h('option', { value: '' }, inheritLabel),
+      ...items.map((item) => h(
+        'option',
+        { key: item.id, value: item.id },
+        item.unavailable
+          ? [item.id, '（已不可用）']
+          : item.label && item.label !== item.id ? `${item.label}（${item.id}）` : item.id,
+      )),
+    ),
+    h(
+      'small',
+      { className: 'dim-presetHelp' },
+      '只影响新建会话；若当前聊天已有会话，先发送 /new，再发送普通消息生效。',
+    ),
+    error || currentUnavailable ? h(
+      'p',
+      { className: 'dim-presetError', role: error ? 'alert' : 'status' },
+      error ?? '当前 Agent Preset 已不可用，请选择其他 Preset 或跟随 Host 默认。',
+    ) : null,
+  );
+}

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

@@ -1,3 +1,5 @@
+import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+
 export const DINGTALK_RPC_CHANNEL = '/dingtalk';
 
 export const DINGTALK_ENDPOINTS = Object.freeze({
@@ -9,6 +11,7 @@ export const DINGTALK_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: 'bot.workspace.set',
+  setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
 
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
@@ -157,6 +160,7 @@ function normalizeBot(value) {
     connected,
     configured: value.configured !== false,
     workspace: optionalString(value.workspace, 4_096) ?? '',
+    agentPreset: normalizeAgentPresetId(value.agentPreset),
     bot: {
       name: optionalString(bot.name, 100) ?? '钉钉机器人',
       clientIdMasked: optionalString(bot.clientIdMasked, 140) ?? '已安全保存',
@@ -200,6 +204,7 @@ export function normalizeSnapshot(value) {
     },
     provisioning: source.provisioning ? normalizeProvisioning(source.provisioning) : null,
     testMessage: normalizeTestMessage(source.testMessage),
+    agentPresetCatalog: normalizeAgentPresetCatalog(source.agentPresetCatalog),
   };
 }
 

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

@@ -3,6 +3,11 @@ import * as React from 'react';
 import { CredentialActionIcon, CredentialBindingPanel, QrActionIcon } from '../../credential-binding.js';
 import { h } from '../../i18n.js';
 import { WorkspaceEditor } from '../../workspace-editor.js';
+import {
+  AgentPresetCatalogContext,
+  AgentPresetEditor,
+  EMPTY_AGENT_PRESET_CATALOG,
+} from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
 import {
   DINGTALK_ENDPOINTS,
@@ -213,6 +218,7 @@ export function AccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAgentPresetSave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -241,6 +247,11 @@ export function AccountCard({
         disabled: Boolean(busy),
         onSave: onWorkspaceSave,
       }),
+      h(AgentPresetEditor, {
+        agentPreset: account.agentPreset,
+        disabled: Boolean(busy),
+        onSave: onAgentPresetSave,
+      }),
       h('div', { className: 'ddt-accountFooter dim-cardFooter' },
         summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
         feedback ? h('div', {
@@ -272,6 +283,7 @@ function AccountList(props) {
         removing: props.removeTarget === account.botId,
         onReconnect: () => props.onReconnect(account),
         onWorkspaceSave: (workspace) => props.onWorkspaceSave(account, workspace),
+        onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(account, agentPreset),
         onRequestRemove: () => props.onRequestRemove(account),
         onConfirmRemove: () => props.onConfirmRemove(account),
         onCancelRemove: props.onCancelRemove,
@@ -283,6 +295,7 @@ const EMPTY_TOTALS = Object.freeze({ configured: 0, connected: 0 });
 export function DingtalkSettingsTab({ rpcCall }) {
   const [model, setModel] = React.useState({
     phase: 'loading', bots: [], totals: EMPTY_TOTALS, revision: 0, error: null,
+    agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
   });
   const [provision, setProvision] = React.useState(null);
   const [busy, setBusy] = React.useState(false);
@@ -389,6 +402,7 @@ export function DingtalkSettingsTab({ rpcCall }) {
         totals: snapshot.totals,
         revision: snapshot.revision,
         error: null,
+        agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
       });
       discardStaleFeedback(snapshot);
       if (restoreProvisioning && snapshot.provisioning) {
@@ -504,6 +518,7 @@ export function DingtalkSettingsTab({ rpcCall }) {
           totals: snapshot.totals,
           revision: snapshot.revision,
           error: null,
+          agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
         });
         discardStaleFeedback(snapshot);
       }
@@ -638,6 +653,7 @@ export function DingtalkSettingsTab({ rpcCall }) {
           totals: snapshot.totals,
           revision: snapshot.revision,
           error: null,
+          agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
         });
         discardStaleFeedback(snapshot);
       }
@@ -700,6 +716,33 @@ export function DingtalkSettingsTab({ rpcCall }) {
           totals: snapshot.totals,
           revision: snapshot.revision,
           error: null,
+          agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+        });
+        discardStaleFeedback(snapshot);
+      }
+    } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
+      if (mountedRef.current) setBotBusy(account.botId, null);
+    }
+  }, [discardStaleFeedback, invoke, loadStatus, setBotBusy, workspaceFence]);
+
+  const saveAgentPreset = React.useCallback(async (account, agentPreset) => {
+    const snapshotVersion = workspaceFence.beginMutation();
+    setBotBusy(account.botId, 'preset');
+    try {
+      const snapshot = normalizeSnapshot(await invoke(
+        DINGTALK_ENDPOINTS.setAgentPreset,
+        { botId: account.botId, agentPreset },
+      ));
+      if (mountedRef.current && workspaceFence.canCommitMutation(snapshotVersion)) {
+        setModel({
+          phase: 'ready',
+          bots: snapshot.bots,
+          totals: snapshot.totals,
+          revision: snapshot.revision,
+          error: null,
+          agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
         });
         discardStaleFeedback(snapshot);
       }
@@ -762,7 +805,9 @@ export function DingtalkSettingsTab({ rpcCall }) {
       })
     : null;
 
-  return h('section', { className: 'ddt-page dim-channelPage', 'aria-label': '钉钉设置' },
+  return h(AgentPresetCatalogContext.Provider, {
+    value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+  }, h('section', { className: 'ddt-page dim-channelPage', 'aria-label': '钉钉设置' },
     h(Heading, {
       totals: model.totals,
       adding: Boolean(provision),
@@ -798,11 +843,12 @@ export function DingtalkSettingsTab({ rpcCall }) {
                   removeTarget,
                   onReconnect: (account) => void reconnect(account),
                   onWorkspaceSave: saveWorkspace,
+                  onAgentPresetSave: saveAgentPreset,
                   onRequestRemove: (account) => setRemoveTarget(account.botId),
                   onConfirmRemove: (account) => void remove(account),
                   onCancelRemove: () => setRemoveTarget(null),
                 })
-              : null));
+              : null)));
 }
 
 export function apply(ctx) {

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

@@ -6,6 +6,8 @@
  * must never be returned by any endpoint on this channel.
  */
 
+import { normalizeAgentPresetCatalog, normalizeAgentPresetId } from "../../agent-preset.js";
+
 export const FEISHU_RPC_CHANNEL = "/feishu";
 
 export const FEISHU_ENDPOINTS = Object.freeze({
@@ -19,6 +21,7 @@ export const FEISHU_ENDPOINTS = Object.freeze({
   disconnectBot: "bot.disconnect",
   deleteBot: "bot.delete",
   setWorkspace: "bot.workspace.set",
+  setAgentPreset: "bot.preset.set",
   // Kept for rolling upgrades. The multi-bot UI never calls these endpoints.
   testConnection: "connection.test",
   disconnect: "connection.disconnect",
@@ -182,6 +185,7 @@ export function normalizeBotConnection(value, fallbackBotId) {
     connected,
     configured: value.configured !== false,
     workspace: optionalString(value.workspace)?.slice(0, 4_096) ?? "",
+    agentPreset: normalizeAgentPresetId(value.agentPreset),
     bot: normalizeBot(value.bot),
     health: normalizeHealth(value.health, connected),
     error: normalizeError(value.error),
@@ -236,6 +240,7 @@ export function normalizeBotsSnapshot(value) {
       ? normalizeProvisioning(value.provisioning)
       : undefined,
     error: normalizeError(value.error),
+    agentPresetCatalog: normalizeAgentPresetCatalog(value.agentPresetCatalog),
   };
 }
 

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

@@ -16,6 +16,11 @@ import {
 } from "./api.js";
 import { useAnimationFrameScheduler } from "../../lifecycle.js";
 import { WorkspaceEditor } from "../../workspace-editor.js";
+import {
+  AgentPresetCatalogContext,
+  AgentPresetEditor,
+  EMPTY_AGENT_PRESET_CATALOG,
+} from "../../agent-preset.js";
 import { useWorkspaceSnapshotFence } from "../../workspace-snapshot-fence.js";
 import { installFeishuStyles } from "./styles.js";
 
@@ -418,6 +423,7 @@ export function BotCard({
   onReconnect,
   onRepairCallback,
   onWorkspaceSave,
+  onAgentPresetSave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -468,6 +474,11 @@ export function BotCard({
         disabled: Boolean(busy),
         onSave: onWorkspaceSave,
       }),
+      h(AgentPresetEditor, {
+        agentPreset: connection.agentPreset,
+        disabled: Boolean(busy),
+        onSave: onAgentPresetSave,
+      }),
       h("div", { className: "bxf-connectedFooter dim-cardFooter" },
         summary ? h("div", { className: "bxf-healthSummary dim-cardSummary", "data-error": actionError || connection.error ? "true" : undefined },
           summary) : null,
@@ -524,6 +535,7 @@ function BotList(props) {
           onReconnect: () => props.onReconnect(bot),
           onRepairCallback: () => props.onRepairCallback(bot),
           onWorkspaceSave: (workspace) => props.onWorkspaceSave(bot, workspace),
+          onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(bot, agentPreset),
           onRequestRemove: () => props.onRequestRemove(bot),
           onConfirmRemove: () => props.onConfirmRemove(bot),
           onCancelRemove: props.onCancelRemove,
@@ -575,6 +587,7 @@ export function mergeFeishuSnapshotState(
     provisioning,
     pageError: null,
     statusError: null,
+    agentPresetCatalog: snapshot.agentPresetCatalog ?? current.agentPresetCatalog,
   };
 }
 
@@ -587,6 +600,7 @@ export function FeishuSettingsTab({ rpcCall }) {
     provisioning: null,
     pageError: null,
     statusError: null,
+    agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
   });
   const [pageBusy, setPageBusy] = React.useState(false);
   const [provisionBusy, setProvisionBusy] = React.useState(false);
@@ -1067,6 +1081,26 @@ export function FeishuSettingsTab({ rpcCall }) {
     }
   }, [invoke, loadStatus, mergeSnapshot, setBotBusy, setBotError, workspaceFence]);
 
+  const saveAgentPreset = React.useCallback(async (connection, agentPreset) => {
+    const { botId } = connection;
+    const snapshotVersion = workspaceFence.beginMutation();
+    setBotBusy(botId, "preset");
+    setBotError(botId, null);
+    try {
+      const snapshot = normalizeBotsSnapshot(await invoke(
+        FEISHU_ENDPOINTS.setAgentPreset,
+        { botId, agentPreset },
+      ));
+      if (mountedRef.current && workspaceFence.canCommitMutation(snapshotVersion)) {
+        mergeSnapshot(snapshot);
+      }
+    } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
+      if (mountedRef.current) setBotBusy(botId, null);
+    }
+  }, [invoke, loadStatus, mergeSnapshot, setBotBusy, setBotError, workspaceFence]);
+
   const requestRemove = React.useCallback((connection) => {
     setRemoveTargetId(connection.botId);
   }, []);
@@ -1173,7 +1207,9 @@ export function FeishuSettingsTab({ rpcCall }) {
     else removeButtonRefs.current.delete(botId);
   }, []);
 
-  return h("section", { className: "bxf-page dim-channelPage", "aria-label": "飞书机器人设置" },
+  return h(AgentPresetCatalogContext.Provider, {
+    value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+  }, h("section", { className: "bxf-page dim-channelPage", "aria-label": "飞书机器人设置" },
     h(Heading, {
       totals: model.totals,
       onAdd: () => void startProvisioning(),
@@ -1217,6 +1253,7 @@ export function FeishuSettingsTab({ rpcCall }) {
                   onReconnect: (bot) => void reconnectOneBot(bot),
                   onRepairCallback: repairCallback,
                   onWorkspaceSave: saveWorkspace,
+                  onAgentPresetSave: saveAgentPreset,
                   onRequestRemove: requestRemove,
                   onConfirmRemove: (bot) => void confirmRemove(bot),
                   onCancelRemove: cancelRemove,
@@ -1225,7 +1262,7 @@ export function FeishuSettingsTab({ rpcCall }) {
                 })
               : null,
           ),
-  );
+  ));
 }
 
 export function apply(ctx) {

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

@@ -1,3 +1,5 @@
+import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+
 export const QQ_RPC_CHANNEL = '/qq';
 
 export const QQ_ENDPOINTS = Object.freeze({
@@ -9,6 +11,7 @@ export const QQ_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: 'bot.workspace.set',
+  setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
 
 const PROVISION_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting', 'connected', 'failed', 'cancelled']);
@@ -82,6 +85,7 @@ function normalizeBot(value) {
     connected,
     state: connected ? 'connected' : state,
     workspace: text(value.workspace, '', 4_096),
+    agentPreset: normalizeAgentPresetId(value.agentPreset),
     bot: {
       name: text(value.bot?.name, 'QQ机器人', 100),
       appIdMasked: text(value.bot?.appIdMasked, '应用标识已安全保存', 140),
@@ -117,6 +121,7 @@ export function normalizeSnapshot(value) {
     bots,
     totals: { configured: bots.length, connected: bots.filter((bot) => bot.connected).length },
     provisioning: source.provisioning ? normalizeProvisioning(source.provisioning) : null,
+    agentPresetCatalog: normalizeAgentPresetCatalog(source.agentPresetCatalog),
     ...(testMessage ? { testMessage } : {}),
   };
 }

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

@@ -4,6 +4,11 @@ import { QqLogoGlyph } from '../../channel-logos.js';
 import { CredentialActionIcon, CredentialBindingPanel, QrActionIcon } from '../../credential-binding.js';
 import { h } from '../../i18n.js';
 import { WorkspaceEditor } from '../../workspace-editor.js';
+import {
+  AgentPresetCatalogContext,
+  AgentPresetEditor,
+  EMPTY_AGENT_PRESET_CATALOG,
+} from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
@@ -156,6 +161,7 @@ export function AccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAgentPresetSave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -180,6 +186,11 @@ export function AccountCard({
         disabled: Boolean(busy),
         onSave: onWorkspaceSave,
       }),
+      h(AgentPresetEditor, {
+        agentPreset: account.agentPreset,
+        disabled: Boolean(busy),
+        onSave: onAgentPresetSave,
+      }),
       h('div', { className: 'ddt-accountFooter dim-cardFooter' },
         summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
         feedback ? h('div', {
@@ -196,7 +207,10 @@ export function AccountCard({
 }
 
 export function QqSettingsTab({ rpcCall }) {
-  const [model, setModel] = React.useState({ phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null });
+  const [model, setModel] = React.useState({
+    phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null,
+    agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
+  });
   const [provision, setProvision] = React.useState(null);
   const [busy, setBusy] = React.useState(false);
   const [busyByBot, setBusyByBot] = React.useState({});
@@ -233,7 +247,10 @@ export function QqSettingsTab({ rpcCall }) {
       const snapshot = normalizeSnapshot(await invoke(QQ_ENDPOINTS.status, {}, signal));
       if (!mounted.current || signal?.aborted
         || !workspaceFence.canCommitStatus(workspaceVersion)) return undefined;
-      setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+      setModel({
+        phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null,
+        agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+      });
       if (restore && snapshot.provisioning) setProvision({
         ...snapshot.provisioning,
         durationMs: Math.max(1, snapshot.provisioning.expiresAt - Date.now()),
@@ -297,7 +314,10 @@ export function QqSettingsTab({ rpcCall }) {
       ));
       if (!mounted.current) return;
       if (workspaceFence.canCommitMutation(snapshotVersion)) {
-        setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+        setModel({
+          phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null,
+          agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+        });
       }
       setCredentialOpen(false);
     } catch (error) {
@@ -357,7 +377,10 @@ export function QqSettingsTab({ rpcCall }) {
     try {
       const snapshot = normalizeSnapshot(await invoke(endpoint, payload));
       if (mounted.current && workspaceFence.canCommitMutation(snapshotVersion)) {
-        setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+        setModel({
+          phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null,
+          agentPresetCatalog: snapshot.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+        });
       }
       return snapshot;
     } finally {
@@ -424,6 +447,12 @@ export function QqSettingsTab({ rpcCall }) {
               QQ_ENDPOINTS.setWorkspace,
               { botId: account.botId, workspace },
             ),
+            onAgentPresetSave: (agentPreset) => botAction(
+              account,
+              'preset',
+              QQ_ENDPOINTS.setAgentPreset,
+              { botId: account.botId, agentPreset },
+            ),
             onRequestRemove: () => setRemoveTarget(account.botId),
             onCancelRemove: () => setRemoveTarget(null),
             onConfirmRemove: async () => {
@@ -447,7 +476,9 @@ export function QqSettingsTab({ rpcCall }) {
       })
     : null;
 
-  return h('section', { className: 'ddt-page dqq-page dim-channelPage', 'aria-label': 'QQ 设置' },
+  return h(AgentPresetCatalogContext.Provider, {
+    value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
+  }, h('section', { className: 'ddt-page dqq-page dim-channelPage', 'aria-label': 'QQ 设置' },
     h(Heading, {
       totals: model.totals,
       adding: Boolean(provision),
@@ -465,7 +496,7 @@ export function QqSettingsTab({ rpcCall }) {
             provisionView,
             model.bots.length === 0 && !provision && !credentialOpen
               ? h(EmptyView, { busy, onStart: () => void startProvisioning() }) : null,
-            botList));
+            botList)));
 }
 
 export function apply(ctx) {

package/plugin-src/client/channels/shared/token-api.js

@@ -1,3 +1,5 @@
+import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
 
 function isRecord(value) {
@@ -25,6 +27,7 @@ export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: 'bot.workspace.set',
+  setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
 
 export function createTokenChannelApi(channel, connectionSummary, {
@@ -52,6 +55,7 @@ export function createTokenChannelApi(channel, connectionSummary, {
       connected,
       state: connected ? 'connected' : state,
       workspace: text(value.workspace, '', 4_096),
+      agentPreset: normalizeAgentPresetId(value.agentPreset),
       bot: {
         name: text(value.bot?.name, `${channel}机器人`, 100),
         username: text(value.bot?.username, '', 100),
@@ -82,6 +86,7 @@ export function createTokenChannelApi(channel, connectionSummary, {
       revision: Number.isSafeInteger(source.revision) ? source.revision : 0,
       bots,
       totals: { configured: bots.length, connected: bots.filter((bot) => bot.connected).length },
+      agentPresetCatalog: normalizeAgentPresetCatalog(source.agentPresetCatalog),
     };
   };