@xmanrui/dsh-im 4.2.1 → 4.4.0

package/plugin-src/client/context-enhancement.js

@@ -2,9 +2,10 @@ import * as React from 'react';
 import { createPortal } from 'react-dom';
 
 import {
+  CONTEXT_DIRECT_GUIDANCE_EXAMPLE,
   CONTEXT_ENHANCEMENT_FIELDS,
   CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH,
-  CONTEXT_GUIDANCE_EXAMPLE,
+  CONTEXT_GROUP_GUIDANCE_EXAMPLE,
   normalizeContextEnhancementConfig,
   validateContextEnhancementConfig,
 } from '../../src/channels/shared/context-enhancement.mjs';
@@ -18,11 +19,34 @@ const FIELD_LABELS = Object.freeze({
   botId: '机器人标识',
 });
 
+const SCOPE_COPY = Object.freeze({
+  group: Object.freeze({
+    title: '群聊',
+    enable: '启用',
+    fieldsHelpLabel: '查看群聊来源字段说明',
+    senderNameHelpLabel: '查看群聊发送者昵称字段说明',
+    guidanceLabel: '增强提示词',
+    guidanceHelpLabel: '查看群聊增强提示词使用说明',
+    guidanceUsage: '用于告诉模型如何使用当前群聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。',
+    guidanceBehavior: '仅在群聊开关开启时使用。清空并保存后不再附加群聊增强提示词；所选来源字段仍按当前场景设置发送。',
+  }),
+  direct: Object.freeze({
+    title: '私聊',
+    enable: '启用',
+    fieldsHelpLabel: '查看私聊来源字段说明',
+    senderNameHelpLabel: '查看私聊发送者昵称字段说明',
+    guidanceLabel: '增强提示词',
+    guidanceHelpLabel: '查看私聊增强提示词使用说明',
+    guidanceUsage: '用于告诉模型如何使用当前私聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。',
+    guidanceBehavior: '仅在私聊开关开启时使用。清空并保存后不再附加私聊增强提示词；所选来源字段仍按当前场景设置发送。',
+  }),
+});
+
 export function contextEnhancementLabel(config) {
-  const { groupEnabled, directEnabled } = normalizeContextEnhancementConfig(config);
-  if (groupEnabled && directEnabled) return '群聊和私聊';
-  if (groupEnabled) return '仅群聊';
-  if (directEnabled) return '仅私聊';
+  const { group, direct } = normalizeContextEnhancementConfig(config);
+  if (group.enabled && direct.enabled) return '群聊和私聊';
+  if (group.enabled) return '仅群聊';
+  if (direct.enabled) return '仅私聊';
   return '未开启';
 }
 
@@ -37,27 +61,132 @@ function ContextIcon({ kind = 'sliders' }) {
   }, h('path', { d: path }));
 }
 
+function ContextEnhancementScopeEditor({
+  kind,
+  scope,
+  example,
+  supported,
+  busy,
+  idPrefix,
+  onChange,
+}) {
+  const copy = SCOPE_COPY[kind];
+  const unavailableId = `${idPrefix}-${kind}-unavailable`;
+  const fieldsHelpId = `${idPrefix}-${kind}-fields-help`;
+  const senderNameHelpId = `${idPrefix}-${kind}-sender-name-help`;
+  const guidanceId = `${idPrefix}-${kind}-guidance`;
+  const guidanceHelpId = `${idPrefix}-${kind}-guidance-help`;
+  const disabled = busy || !supported;
+
+  return h('fieldset', {
+    className: 'dim-contextSection dim-contextScope',
+    'data-context-kind': kind,
+    'aria-label': copy.title,
+    disabled,
+  },
+  h('label', { className: 'dim-contextSwitchRow' },
+    h('span', { className: 'dim-contextSwitchLabel' },
+      h('span', null, copy.enable),
+      !supported ? h('span', {
+        id: unavailableId, className: 'dim-contextUnavailable',
+      }, '（当前渠道不支持群聊）') : null),
+    h('input', {
+      type: 'checkbox', role: 'switch', className: 'dim-contextSwitch',
+      checked: supported && scope.enabled,
+      disabled,
+      'aria-describedby': !supported ? unavailableId : undefined,
+      onChange: (event) => { if (supported) onChange('enabled', event.target.checked); },
+    })),
+  h('div', { className: 'dim-contextScopeBlock' },
+    h('div', { className: 'dim-contextLegend' },
+      h('span', null, '来源字段'),
+      h('span', { className: 'dim-contextHelp dim-contextLegendHelp' },
+        h('button', {
+          type: 'button', className: 'dim-contextHelpButton', disabled,
+          'aria-label': copy.fieldsHelpLabel, 'aria-describedby': fieldsHelpId,
+        }, h('span', { 'aria-hidden': 'true' }, '?')),
+        h('span', { id: fieldsHelpId, className: 'dim-contextTooltip dim-contextLegendTooltip', role: 'tooltip' },
+          '增强提示词中请使用字段名（如 senderId、conversationType）引用这些信息。只发送当前会话中勾选且可用的字段，不会额外查询或补全。'))),
+    h('div', { className: 'dim-contextFields' }, CONTEXT_ENHANCEMENT_FIELDS.map((field) => {
+      const fieldId = `${idPrefix}-${kind}-field-${field}`;
+      return h('div', { key: field, className: 'dim-contextField' },
+        h('input', {
+          id: fieldId, type: 'checkbox', name: `${kind}-${field}`,
+          checked: scope.fields.includes(field), disabled,
+          onChange: (event) => onChange('fields', event.target.checked
+            ? [...scope.fields, field] : scope.fields.filter((value) => value !== field)),
+        }),
+        h('span', { className: 'dim-contextFieldText' },
+          h('label', { className: 'dim-contextFieldName', htmlFor: fieldId }, FIELD_LABELS[field]),
+          field === 'senderName' ? h('span', { className: 'dim-contextHelp dim-contextFieldHelp' },
+            h('button', {
+              type: 'button', className: 'dim-contextHelpButton dim-contextFieldHelpButton', disabled,
+              'aria-label': copy.senderNameHelpLabel, 'aria-describedby': senderNameHelpId,
+            }, h('span', { 'aria-hidden': 'true' }, '?')),
+            h('span', {
+              id: senderNameHelpId,
+              className: 'dim-contextTooltip dim-contextFieldTooltip',
+              role: 'tooltip',
+            }, '该字段不是每个渠道都能提供。当前消息没有发送者昵称时，即使已选择该字段，<dsh_im_source> 中也会省略 senderName。')) : null,
+          h('label', { className: 'dim-contextFieldKey', htmlFor: fieldId }, field)));
+    }))),
+  h('div', { className: 'dim-contextGuidance dim-contextScopeBlock' },
+    h('div', { className: 'dim-contextEditorHeader' },
+      h('span', { className: 'dim-contextEditorTitle' },
+        h('label', { htmlFor: guidanceId }, copy.guidanceLabel),
+        h('span', { className: 'dim-contextHelp' },
+          h('button', {
+            type: 'button', className: 'dim-contextHelpButton', disabled,
+            'aria-label': copy.guidanceHelpLabel, 'aria-describedby': guidanceHelpId,
+          }, h('span', { 'aria-hidden': 'true' }, '?')),
+          h('span', { id: guidanceHelpId, className: 'dim-contextTooltip dim-contextGuidanceTooltip', role: 'tooltip' },
+            h('strong', null, '使用说明'),
+            h('span', null, copy.guidanceUsage),
+            h('strong', null, '生效规则'),
+            h('span', null, copy.guidanceBehavior),
+            h('strong', null, '隐私提示'),
+            h('span', null, '发送者标识可能包含平台用户 ID 或电话号码形式的标识。关闭开关不会删除已经写入会话历史的信息。'),
+            h('strong', null, '使用示例'),
+            h('span', { className: 'dim-contextTooltipExample' }, example)))),
+      h('div', { className: 'dim-contextTextActions' },
+        h('button', { type: 'button', disabled, onClick: () => onChange('guidance', example) }, '填入示例'),
+        h('button', { type: 'button', disabled, onClick: () => onChange('guidance', '') }, '清空'))),
+    h('textarea', {
+      id: guidanceId, value: scope.guidance, placeholder: example, rows: 4, disabled,
+      'data-context-kind': kind,
+      maxLength: CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH,
+      'aria-describedby': guidanceHelpId,
+      onChange: (event) => onChange('guidance', event.target.value),
+    })));
+}
+
 function ContextEnhancementDialog({ config, groupSupported, disabled, onSave, onClose, returnFocusRef, id }) {
   // A mounted dialog owns its draft; status refreshes must not replace unsaved edits.
-  const [draft, setDraft] = React.useState(() => ({
-    ...normalizeContextEnhancementConfig(config),
-    ...(!groupSupported ? { groupEnabled: false } : {}),
-  }));
+  const [draft, setDraft] = React.useState(() => {
+    const normalized = normalizeContextEnhancementConfig(config);
+    return {
+      ...normalized,
+      ...(!groupSupported ? {
+        group: { ...normalized.group, enabled: false },
+      } : {}),
+    };
+  });
   const [saving, setSaving] = React.useState(false);
   const [error, setError] = React.useState(null);
+  const [activeScope, setActiveScope] = React.useState('direct');
   const savingRef = React.useRef(false);
   const dialogRef = React.useRef(null);
   const mountedRef = React.useRef(true);
+  const groupTabRef = React.useRef(null);
+  const directTabRef = React.useRef(null);
   const titleId = React.useId();
   const descriptionId = React.useId();
-  const groupNoticeId = React.useId();
-  const guidanceId = React.useId();
-  const guidanceHelpId = React.useId();
-  const fieldIdPrefix = React.useId();
-  const fieldsHelpId = React.useId();
-  const senderNameHelpId = React.useId();
-  const guidanceExample = localizeText(CONTEXT_GUIDANCE_EXAMPLE);
+  const scopeIdPrefix = React.useId();
+  const groupGuidanceExample = localizeText(CONTEXT_GROUP_GUIDANCE_EXAMPLE);
+  const directGuidanceExample = localizeText(CONTEXT_DIRECT_GUIDANCE_EXAMPLE);
   const busy = disabled || saving;
+  const scopeKinds = ['direct', 'group'];
+  const tabRefs = { group: groupTabRef, direct: directTabRef };
 
   React.useEffect(() => {
     mountedRef.current = true;
@@ -73,9 +202,12 @@ function ContextEnhancementDialog({ config, groupSupported, disabled, onSave, on
     };
   }, [returnFocusRef]);
 
-  const change = (key, value) => {
+  const changeScope = (kind, key, value) => {
     if (busy || savingRef.current) return;
-    setDraft((current) => ({ ...current, [key]: value }));
+    setDraft((current) => ({
+      ...current,
+      [kind]: { ...current[kind], [key]: value },
+    }));
     setError(null);
   };
 
@@ -83,6 +215,25 @@ function ContextEnhancementDialog({ config, groupSupported, disabled, onSave, on
     if (!savingRef.current) onClose();
   };
 
+  const activateScope = (kind, focus = false) => {
+    if (busy || !scopeKinds.includes(kind)) return;
+    setActiveScope(kind);
+    if (focus) tabRefs[kind].current?.focus?.();
+  };
+
+  const handleTabKeyDown = (event, kind) => {
+    let next;
+    if (event.key === 'Home') next = scopeKinds[0];
+    else if (event.key === 'End') next = scopeKinds.at(-1);
+    else if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') {
+      const offset = event.key === 'ArrowRight' ? 1 : -1;
+      next = scopeKinds[(scopeKinds.indexOf(kind) + offset + scopeKinds.length) % scopeKinds.length];
+    }
+    if (!next) return;
+    event.preventDefault();
+    activateScope(next, true);
+  };
+
   const save = async () => {
     if (busy || savingRef.current) return;
     savingRef.current = true;
@@ -155,90 +306,42 @@ function ContextEnhancementDialog({ config, groupSupported, disabled, onSave, on
       type: 'button', className: 'dim-contextClose', 'aria-label': '关闭弹窗',
       disabled: saving, onClick: cancel,
     }, h(ContextIcon, { kind: 'close' }))),
-  h('fieldset', { className: 'dim-contextSection', disabled: busy },
-    h('legend', null, '启用范围'),
-    h('div', { className: 'dim-contextSwitches' },
-      h('label', { className: 'dim-contextSwitchRow' },
-        h('span', { className: 'dim-contextSwitchLabel' },
-          h('span', null, '群聊中启用'),
-          !groupSupported ? h('span', {
-            id: groupNoticeId, className: 'dim-contextUnavailable',
-          }, '（当前渠道不支持群聊）') : null),
-        h('input', {
-          type: 'checkbox', role: 'switch', className: 'dim-contextSwitch',
-          checked: groupSupported && draft.groupEnabled,
-          disabled: busy || !groupSupported,
-          'aria-describedby': !groupSupported ? groupNoticeId : undefined,
-          onChange: (event) => { if (groupSupported) change('groupEnabled', event.target.checked); },
-        })),
-      h('label', { className: 'dim-contextSwitchRow' },
-        h('span', null, '私聊中启用'),
-        h('input', {
-          type: 'checkbox', role: 'switch', className: 'dim-contextSwitch',
-          checked: draft.directEnabled, disabled: busy,
-          onChange: (event) => change('directEnabled', event.target.checked),
-        }))),
-  ),
-  h('fieldset', { className: 'dim-contextSection', disabled: busy },
-    h('legend', { className: 'dim-contextLegend' },
-      h('span', null, '来源字段'),
-      h('span', { className: 'dim-contextHelp dim-contextLegendHelp' },
-        h('button', {
-          type: 'button', className: 'dim-contextHelpButton', disabled: busy,
-          'aria-label': '查看来源字段说明', 'aria-describedby': fieldsHelpId,
-        }, h('span', { 'aria-hidden': 'true' }, '?')),
-        h('span', { id: fieldsHelpId, className: 'dim-contextTooltip dim-contextLegendTooltip', role: 'tooltip' },
-          '增强提示词中请使用字段名（如 senderId、conversationType）引用这些信息。只发送勾选且当前消息中可用的字段，不会额外查询或补全。'))),
-    h('div', { className: 'dim-contextFields' }, CONTEXT_ENHANCEMENT_FIELDS.map((field) => {
-      const fieldId = `${fieldIdPrefix}-${field}`;
-      return h('div', { key: field, className: 'dim-contextField' },
-        h('input', {
-          id: fieldId, type: 'checkbox', name: field,
-          checked: draft.fields.includes(field), disabled: busy,
-          onChange: (event) => change('fields', event.target.checked
-            ? [...draft.fields, field] : draft.fields.filter((value) => value !== field)),
-        }),
-        h('span', { className: 'dim-contextFieldText' },
-          h('label', { className: 'dim-contextFieldName', htmlFor: fieldId }, FIELD_LABELS[field]),
-          field === 'senderName' ? h('span', { className: 'dim-contextHelp dim-contextFieldHelp' },
-            h('button', {
-              type: 'button', className: 'dim-contextHelpButton dim-contextFieldHelpButton', disabled: busy,
-              'aria-label': '查看发送者昵称字段说明', 'aria-describedby': senderNameHelpId,
-            }, h('span', { 'aria-hidden': 'true' }, '?')),
-            h('span', {
-              id: senderNameHelpId,
-              className: 'dim-contextTooltip dim-contextFieldTooltip',
-              role: 'tooltip',
-            }, '该字段不是每个渠道都能提供。当前消息没有发送者昵称时，即使已选择该字段，<dsh_im_source> 中也会省略 senderName。')) : null,
-          h('label', { className: 'dim-contextFieldKey', htmlFor: fieldId }, field)));
-    }))),
-  h('div', { className: 'dim-contextGuidance' },
-    h('div', { className: 'dim-contextEditorHeader' },
-      h('span', { className: 'dim-contextEditorTitle' },
-        h('label', { htmlFor: guidanceId }, '增强提示词'),
-        h('span', { className: 'dim-contextHelp' },
-          h('button', {
-            type: 'button', className: 'dim-contextHelpButton', disabled: busy,
-            'aria-label': '查看增强提示词使用说明', 'aria-describedby': guidanceHelpId,
-          }, h('span', { 'aria-hidden': 'true' }, '?')),
-          h('span', { id: guidanceHelpId, className: 'dim-contextTooltip dim-contextGuidanceTooltip', role: 'tooltip' },
-            h('strong', null, '使用说明'),
-            h('span', null, '用于告诉模型如何使用 <dsh_im_source> 中已选择的来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。'),
-            h('strong', null, '生效规则'),
-            h('span', null, '只需填写正文，插件自动添加 <dsh_im_source_guidance> 成对标签。清空并保存后，不再附加增强提示词，已选来源字段仍按开关设置发送。'),
-            h('strong', null, '隐私提示'),
-            h('span', null, '发送者标识可能包含平台用户 ID 或电话号码形式的标识。关闭开关不会删除已经写入会话历史的信息。'),
-            h('strong', null, '使用示例'),
-            h('span', { className: 'dim-contextTooltipExample' }, guidanceExample)))),
-      h('div', { className: 'dim-contextTextActions' },
-        h('button', { type: 'button', disabled: busy, onClick: () => change('guidance', guidanceExample) }, '填入示例'),
-        h('button', { type: 'button', disabled: busy, onClick: () => change('guidance', '') }, '清空'))),
-    h('textarea', {
-      id: guidanceId, value: draft.guidance, placeholder: guidanceExample, rows: 4, disabled: busy,
-      maxLength: CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH,
-      'aria-describedby': guidanceHelpId,
-      onChange: (event) => change('guidance', event.target.value),
+  h('div', { className: 'dim-contextTabs', role: 'tablist', 'aria-label': '上下文增强范围' },
+    scopeKinds.map((kind) => {
+      const selected = activeScope === kind;
+      return h('button', {
+        key: kind,
+        id: `${scopeIdPrefix}-${kind}-tab`,
+        ref: tabRefs[kind],
+        type: 'button',
+        role: 'tab',
+        className: 'dim-contextTab',
+        'data-context-kind': kind,
+        'aria-selected': selected,
+        'aria-controls': `${scopeIdPrefix}-${kind}-panel`,
+        tabIndex: selected ? 0 : -1,
+        disabled: busy,
+        onClick: () => activateScope(kind),
+        onKeyDown: (event) => handleTabKeyDown(event, kind),
+      }, SCOPE_COPY[kind].title);
     })),
+  scopeKinds.map((kind) => h('div', {
+    key: kind,
+    id: `${scopeIdPrefix}-${kind}-panel`,
+    className: 'dim-contextTabPanel',
+    role: 'tabpanel',
+    'data-context-kind': kind,
+    'aria-labelledby': `${scopeIdPrefix}-${kind}-tab`,
+    hidden: activeScope !== kind,
+  }, h(ContextEnhancementScopeEditor, {
+    kind,
+    scope: draft[kind],
+    example: kind === 'group' ? groupGuidanceExample : directGuidanceExample,
+    supported: kind === 'group' ? groupSupported : true,
+    busy,
+    idPrefix: scopeIdPrefix,
+    onChange: (key, value) => changeScope(kind, key, value),
+  }))),
   error ? h('p', { className: 'dim-contextError', role: 'alert' }, error) : null,
   h('footer', { className: 'dim-contextFooter' },
     h('button', { type: 'button', disabled: saving, onClick: cancel }, '取消'),
@@ -256,7 +359,9 @@ export function ContextEnhancementEditor({ config, groupSupported = true, disabl
   const dialogId = React.useId();
   const statusId = React.useId();
   const saved = normalizeContextEnhancementConfig(config);
-  const label = contextEnhancementLabel(groupSupported ? saved : { ...saved, groupEnabled: false });
+  const label = contextEnhancementLabel(groupSupported ? saved : {
+    ...saved, group: { ...saved.group, enabled: false },
+  });
 
   return h(React.Fragment, null,
     h('button', {

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

@@ -1,5 +1,6 @@
 import * as React from 'react';
 
+import { AccessPolicySettingsPage } from './access-policy-settings.js';
 import { h, isEnglish, localizeText } from './i18n.js';
 
 export const DELIVERY_RPC_CHANNEL = '/dsh-im-delivery';
@@ -18,6 +19,11 @@ export const DELIVERY_ENDPOINTS = Object.freeze({
   test: 'target.test',
 });
 
+export const BOT_SETTINGS_TABS = Object.freeze([
+  Object.freeze({ id: 'delivery', label: '投递设置' }),
+  Object.freeze({ id: 'access', label: '访问设置' }),
+]);
+
 const CHANNEL_DEFINITIONS = Object.freeze({
   weixin: {
     label: '微信',
@@ -532,8 +538,15 @@ function TargetRow({ definition, target, botId, connected, rpcCall, onChanged, o
       : null);
 }
 
-export function DeliveryTargetSettingsPage({ channel, account, rpcCall, onBack }) {
+export function DeliveryTargetSettingsPage({
+  channel,
+  account,
+  rpcCall,
+  accessRpcCall,
+  onBack,
+}) {
   const definition = CHANNEL_DEFINITIONS[channel];
+  const [activeTabId, setActiveTabId] = React.useState(BOT_SETTINGS_TABS[0].id);
   const [phase, setPhase] = React.useState('loading');
   const [targets, setTargets] = React.useState([]);
   const [suggestionPhase, setSuggestionPhase] = React.useState('idle');
@@ -543,8 +556,13 @@ export function DeliveryTargetSettingsPage({ channel, account, rpcCall, onBack }
   const [editor, setEditor] = React.useState(null);
   const [saving, setSaving] = React.useState(false);
   const [botCopyState, setBotCopyState] = React.useState(null);
+  const [accessPolicy, setAccessPolicy] = React.useState(account.accessPolicy);
   const mounted = React.useRef(true);
 
+  React.useEffect(() => {
+    setAccessPolicy(account.accessPolicy);
+  }, [account.botId, account.accessPolicy]);
+
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
     if (typeof rpcCall !== 'function') throw new Error('投递目标设置暂不可用。');
     return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
@@ -654,13 +672,51 @@ export function DeliveryTargetSettingsPage({ channel, account, rpcCall, onBack }
     }
   };
 
+  const activeTab = BOT_SETTINGS_TABS.find((tab) => tab.id === activeTabId)
+    ?? BOT_SETTINGS_TABS[0];
+  const activeTabDomId = `dim-bot-settings-${activeTab.id}-tab`;
+  const activePanelId = `dim-bot-settings-${activeTab.id}-panel`;
+
   return h('section', {
     className: 'dim-deliveryPage',
     'aria-label': `${account.botName || definition.label}机器人设置`,
   },
   h('header', { className: 'dim-deliveryHeader' },
-    h(DeliveryButton, { className: 'dim-deliveryBack', onClick: onBack }, '← 返回机器人列表'),
-    h('div', { className: 'dim-deliveryHeaderMeta' },
+    h(DeliveryButton, { className: 'dim-deliveryBack', onClick: onBack }, '← 返回机器人列表')),
+  h('div', { className: 'dim-botSettingsTabsBar' },
+    h('nav', {
+      className: 'dim-botSettingsTabs',
+      role: 'tablist',
+      'aria-label': '机器人设置页签',
+    }, BOT_SETTINGS_TABS.map((tab) => h('button', {
+      key: tab.id,
+      id: `dim-bot-settings-${tab.id}-tab`,
+      type: 'button',
+      role: 'tab',
+      className: 'dim-botSettingsTab',
+      'aria-selected': tab.id === activeTab.id,
+      'aria-controls': `dim-bot-settings-${tab.id}-panel`,
+      tabIndex: tab.id === activeTab.id ? 0 : -1,
+      onClick: () => setActiveTabId(tab.id),
+    }, tab.label)))),
+  h('div', {
+    id: activePanelId,
+    className: 'dim-botSettingsTabPanel',
+    role: 'tabpanel',
+    'aria-labelledby': activeTabDomId,
+  },
+  activeTab.id === 'access'
+    ? h(AccessPolicySettingsPage, {
+        channel,
+        account: { ...account, accessPolicy },
+        rpcCall: accessRpcCall,
+        onSaved: setAccessPolicy,
+      })
+    : h(React.Fragment, null,
+  h('section', { className: 'dim-deliveryIdentity', 'aria-labelledby': 'dim-delivery-bot-title' },
+    h('div', { className: 'dim-deliveryIdentityHeading' },
+      h('h2', { id: 'dim-delivery-bot-title', className: 'dim-deliveryBotName' },
+        account.botName || '机器人设置'),
       h('a', {
         className: 'dim-deliveryDocsLink',
         href: isEnglish() ? DELIVERY_DOCS_URL.en : DELIVERY_DOCS_URL.zh,
@@ -669,11 +725,7 @@ export function DeliveryTargetSettingsPage({ channel, account, rpcCall, onBack }
         'aria-label': '打开主动投递使用文档',
       },
       h('span', null, '使用文档'),
-      h('span', { 'aria-hidden': 'true' }, '↗')))),
-  h('section', { className: 'dim-deliveryIdentity', 'aria-labelledby': 'dim-delivery-bot-title' },
-    h('div', null,
-      h('h2', { id: 'dim-delivery-bot-title', className: 'dim-deliveryBotName' },
-        account.botName || '机器人设置')),
+      h('span', { 'aria-hidden': 'true' }, '↗'))),
     h('div', { className: 'dim-deliveryBotId' },
       h('span', null, 'Bot ID'),
       h('code', { title: account.botId }, account.botId),
@@ -745,5 +797,5 @@ export function DeliveryTargetSettingsPage({ channel, account, rpcCall, onBack }
               rpcCall: invoke,
               onChanged: () => loadTargets({ silent: true }),
               onEdit: () => setEditor({ mode: 'edit', target, source: 'edit' }),
-            })))));
+            })))))));
 }

package/plugin-src/client/i18n.js

@@ -7,6 +7,62 @@ const EN = Object.freeze({
   'IM机器人': 'IM bots',
   'IM机器人设置': 'IM bot settings',
   '更多机器人设置': 'More bot settings',
+  '机器人设置': 'Bot settings',
+  '机器人设置页签': 'Bot settings tabs',
+  '投递设置': 'Delivery settings',
+  '访问设置': 'Access settings',
+  '查看访问权限说明': 'View access permission details',
+  '允许所有用户': 'Allow all users',
+  '仅白名单用户': 'Allowlisted users only',
+  '默认命令权限': 'Default command permission',
+  '命令权限': 'Command permission',
+  '可以执行命令': 'Can run commands',
+  '不可以执行命令': 'Cannot run commands',
+  '白名单用户': 'Allowlisted users',
+  '查看白名单说明': 'View allowlist details',
+  '命令权限例外': 'Command permission exceptions',
+  '当前没有白名单用户，保存后普通用户将无法使用机器人。': 'There are currently no allowlisted users. After saving, regular users will not be able to use the bot.',
+  '新增用户': 'Add user',
+  '尚未添加用户': 'No users added',
+  '当前渠道不支持群聊': 'Group chat is not supported by this channel',
+  '原所有者或扫码接入者始终可以访问并执行命令；以下设置仅约束其他用户。': 'The original owner or QR-code operator can always access the bot and run commands; the settings below apply only to other users.',
+  '此区域无需配置，保存私聊设置时会保留现有群聊策略。': 'No setup is needed here. Saving direct-message settings keeps the existing group policy.',
+  '访问设置已保存。': 'Access settings saved.',
+  '访问设置暂不可用。': 'Access settings are currently unavailable.',
+  '访问设置保存失败，请稍后重试。': 'Could not save access settings. Try again later.',
+  '服务没有返回已保存的访问策略，请刷新后重试。': 'The service did not return the saved access policy. Refresh and try again.',
+  '访问策略尚未就绪，请返回机器人列表刷新后重试。': 'The access policy is not ready. Return to the bot list, refresh, and try again.',
+  '当前渠道暂不支持访问设置。': 'Access settings are not supported by this channel yet.',
+  '用户标识无效。': 'The user ID is invalid.',
+  '用户标识必须是字符串。': 'The user ID must be a string.',
+  '用户标识不能为空、包含控制字符或超过 256 个字符。': 'The user ID cannot be empty, contain control characters, or exceed 256 characters.',
+  '用户条目必须包含用户标识和命令权限。': 'Each user entry must include a user ID and command permission.',
+  '命令权限必须是布尔值。': 'Command permission must be a boolean.',
+  '访问模式只能是 open 或 allowlist。': 'Access mode must be open or allowlist.',
+  '开放模式设置必须完整。': 'Open-mode settings must be complete.',
+  '开放模式默认命令权限必须是布尔值。': 'The open-mode default command permission must be a boolean.',
+  '开放模式命令权限覆盖用户必须是数组。': 'Open-mode command permission overrides must be an array.',
+  '开放模式命令权限覆盖用户不能包含重复的用户标识。': 'Open-mode command permission overrides cannot contain duplicate user IDs.',
+  '白名单模式设置必须完整。': 'Allowlist-mode settings must be complete.',
+  '白名单模式用户必须是数组。': 'Allowlist-mode users must be an array.',
+  '白名单模式用户不能包含重复的用户标识。': 'Allowlist-mode users cannot contain duplicate user IDs.',
+  '访问场景设置必须同时包含模式、开放模式设置和白名单模式设置。': 'Each access context must include its mode, open-mode settings, and allowlist-mode settings.',
+  '请同时提交完整的私聊和群聊访问设置。': 'Submit complete direct-message and group access settings together.',
+  '填写微信用户 ID': 'Enter a WeChat user ID',
+  '飞书 Open ID': 'Feishu Open ID',
+  '群成员 Open ID': 'Group member Open ID',
+  '钉钉用户 ID': 'DingTalk user ID',
+  '填写 senderStaffId 或 senderId': 'Enter senderStaffId or senderId',
+  '群成员用户 ID': 'Group member user ID',
+  '企业微信用户 ID': 'WeCom user ID',
+  '填写 userid': 'Enter userid',
+  '填写 member_openid': 'Enter member_openid',
+  'QQ User Open ID': 'QQ User Open ID',
+  '群成员 User ID': 'Group member User ID',
+  '填写数字 User ID': 'Enter a numeric user ID',
+  'WhatsApp 电话号码或 JID': 'WhatsApp phone number or JID',
+  '群成员电话号码或 JID': 'Group member phone number or JID',
+  '8613800000000 或完整 JID': '8613800000000 or a full JID',
   'IM 渠道': 'IM channels',
   '让 DeepSeek Harness 触手可及': 'Connecting DeepSeek Harness',
   '当前版本': 'Current version',
@@ -216,31 +272,44 @@ const EN = Object.freeze({
   '群聊和私聊': 'Groups and direct',
   '关闭弹窗': 'Close dialog',
   '查看上下文增强说明': 'View context enhancement details',
+  '上下文增强范围': 'Context enhancement scope',
   '启用范围': 'Enable in',
-  '群聊中启用': 'Enable in group chats',
-  '私聊中启用': 'Enable in direct chats',
+  '启用': 'Enabled',
   '（当前渠道不支持群聊）': '(This channel does not support group chats)',
   '来源字段': 'Source fields',
   '查看来源字段说明': 'View source field details',
+  '查看群聊来源字段说明': 'View group source field details',
+  '查看私聊来源字段说明': 'View direct source field details',
   '渠道': 'Channel',
   '会话类型': 'Conversation type',
   '发送者标识': 'Sender ID',
   '发送者昵称': 'Sender name',
   '查看发送者昵称字段说明': 'View sender name field details',
+  '查看群聊发送者昵称字段说明': 'View group sender name field details',
+  '查看私聊发送者昵称字段说明': 'View direct sender name field details',
   '该字段不是每个渠道都能提供。当前消息没有发送者昵称时，即使已选择该字段，<dsh_im_source> 中也会省略 senderName。': 'This field is not available on every channel. If the current message has no sender name, <dsh_im_source> omits senderName even when the field is selected.',
   '机器人标识': 'Bot ID',
   '增强提示词': 'Guidance',
   '查看增强提示词使用说明': 'View guidance instructions',
+  '查看群聊增强提示词使用说明': 'View group guidance instructions',
+  '查看私聊增强提示词使用说明': 'View direct guidance instructions',
   '使用说明': 'How to use',
   '用于告诉模型如何使用 <dsh_im_source> 中已选择的来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。': 'Tell the model how to use the selected fields in <dsh_im_source>. Enter only the body; the plugin adds paired <dsh_im_source_guidance> tags.',
   '生效规则': 'Behavior',
   '隐私提示': 'Privacy',
   '使用示例': 'Example',
   '仅依据当前消息的 <dsh_im_source> 中实际提供的字段理解来源；没有提供的字段不要猜测或补全。\nconversationType是群聊时回复严肃一点，conversationType是私聊时回复一定要幽默搞笑，像周星驰的电影一样搞笑': 'Understand the source only from fields actually present in <dsh_im_source> for the current message; do not guess or fill in missing fields.\nWhen conversationType is group, reply more seriously. When conversationType is direct, make the reply humorous and funny.',
+  '仅依据当前消息的 <dsh_im_source> 中实际提供的字段理解来源；没有提供的字段不要猜测或补全。\n当前消息来自群聊，请使用严肃、克制、简洁的表达方式。': 'Understand the source only from fields actually present in <dsh_im_source> for the current message; do not guess or fill in missing fields.\nThis message is from a group chat. Use a serious, restrained, and concise style.',
+  '仅依据当前消息的 <dsh_im_source> 中实际提供的字段理解来源；没有提供的字段不要猜测或补全。\n当前消息来自私聊，可以使用更轻松、幽默、详细的表达方式。': 'Understand the source only from fields actually present in <dsh_im_source> for the current message; do not guess or fill in missing fields.\nThis message is from a direct chat. You may use a lighter, more humorous, and detailed style.',
   '填入示例': 'Use example',
   '清空': 'Clear',
   '选择在哪些会话中启用、提供哪些来源字段，以及如何使用这些信息。仅使用已有消息元数据，不查询平台 API。': 'Choose which conversations to enhance, which source fields to include, and how to use them. Only existing message metadata is used; no platform APIs are queried.',
   '增强提示词中请使用字段名（如 senderId、conversationType）引用这些信息。只发送勾选且当前消息中可用的字段，不会额外查询或补全。': 'Reference these values by field name (such as senderId or conversationType) in the guidance. Only selected fields available in the current message are sent; no extra lookups are made.',
+  '增强提示词中请使用字段名（如 senderId、conversationType）引用这些信息。只发送当前会话中勾选且可用的字段，不会额外查询或补全。': 'Reference these values by field name (such as senderId or conversationType) in the guidance. Only fields selected and available in the current conversation are sent; no extra lookups are made.',
+  '用于告诉模型如何使用当前群聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。': 'Tell the model how to use <dsh_im_source> fields for the current group message. Enter only the body; the plugin adds paired <dsh_im_source_guidance> tags.',
+  '用于告诉模型如何使用当前私聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。': 'Tell the model how to use <dsh_im_source> fields for the current direct message. Enter only the body; the plugin adds paired <dsh_im_source_guidance> tags.',
+  '仅在群聊开关开启时使用。清空并保存后不再附加群聊增强提示词；所选来源字段仍按当前场景设置发送。': 'Used only when group enhancement is enabled. Clear and save to omit group guidance; selected source fields still follow the group settings.',
+  '仅在私聊开关开启时使用。清空并保存后不再附加私聊增强提示词；所选来源字段仍按当前场景设置发送。': 'Used only when direct enhancement is enabled. Clear and save to omit direct guidance; selected source fields still follow the direct settings.',
   '只需填写正文，插件自动添加 <dsh_im_source_guidance> 成对标签。清空并保存后，不再附加增强提示词，已选来源字段仍按开关设置发送。': 'Enter only the body; the plugin adds paired <dsh_im_source_guidance> tags. Clear and save to omit guidance. Selected source fields still follow the conversation switches.',
   '发送者标识可能包含平台用户 ID 或电话号码形式的标识。关闭开关不会删除已经写入会话历史的信息。': 'Sender IDs may contain platform user IDs or phone-number-like identifiers. Turning this off does not remove information already saved in conversation history.',
   '上下文增强保存失败，请重试。': 'Could not save context enhancement. Try again.',
@@ -508,7 +577,6 @@ const EN = Object.freeze({
   '先通过 @BotFather 获取 Bot Token，再在这里完成接入。': 'Get a Bot Token from @BotFather, then connect it here.',
   '填写 @BotFather 生成的 Bot Token': 'Enter the Bot Token from @BotFather',
   '访问模式': 'Access mode',
-  '访问设置': 'Access settings',
   'Telegram 访问模式': 'Telegram access mode',
   '查看 Telegram 访问模式说明': 'View Telegram access mode details',
   '群聊全部忽略，私聊仅允许白名单用户。': 'All group messages are ignored; only allowlisted users may send DMs.',

package/plugin-src/client/index.js

@@ -294,6 +294,7 @@ export function IMSettingsTab({
               channel: active.id,
               account: deliverySettings,
               rpcCall: rpcCalls.deliveryRpcCall,
+              accessRpcCall: rpcCalls[`${active.id}RpcCall`],
               onBack: () => setDeliverySettings(null),
             })
           : active.id === 'weixin'