@xmanrui/dsh-im 1.0.2 → 1.2.0

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

@@ -77,10 +77,6 @@ const CSS = String.raw`
 .dxw-accountIdentity h3 { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 15px; }
 .dxw-accountIdentity p { color: var(--dsw-alias-label-secondary, #646a73); font: 12px ui-monospace, SFMono-Regular, monospace; margin-top: 4px; }
 .dxw-health { display: inline-flex; align-items: center; gap: 7px; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; white-space: nowrap; }
-.dxw-metrics { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin: 20px 0; }
-.dxw-metric { padding: 12px 14px; border-radius: 9px; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
-.dxw-metric dt { color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; }
-.dxw-metric dd { overflow: hidden; margin: 5px 0 0; font-size: 13px; text-overflow: ellipsis; white-space: nowrap; }
 .dxw-accountFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; padding-top: 16px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
 .dxw-accountFooter .dxw-actions { flex: none; flex-wrap: nowrap; gap: 8px; margin-top: 0; }
 .dxw-accountFooter .dxw-button { flex: none; white-space: nowrap; }
@@ -99,7 +95,6 @@ const CSS = String.raw`
   .dxw-logo { display: none; }
   .dxw-qrLayout { grid-template-columns: minmax(0, 1fr); justify-items: center; }
   .dxw-qrCopy { width: 100%; }
-  .dxw-metrics { grid-template-columns: minmax(0, 1fr); }
   .dxw-cardBody { padding: 20px; }
 }
 @media (prefers-reduced-motion: reduce) {

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

@@ -9,6 +9,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   cancelProvisioning: 'provision.cancel',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setAccessPolicy: 'bot.access-policy.set',
   setWorkspace: 'bot.workspace.set',
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
@@ -86,6 +87,16 @@ function normalizeBot(value) {
     state: connected ? 'connected' : state,
     workspace: text(value.workspace, '', 4_096),
     agentPreset: normalizeAgentPresetId(value.agentPreset),
+    accessPolicy: {
+      accessMode: ['self-only', 'private-allowlist', 'open'].includes(
+        value.accessPolicy?.accessMode,
+      ) ? value.accessPolicy.accessMode : 'self-only',
+      allowedNumbers: Array.isArray(value.accessPolicy?.allowedNumbers)
+        ? [...new Set(value.accessPolicy.allowedNumbers.filter((entry) => (
+            typeof entry === 'string' && /^[1-9]\d{4,14}$/.test(entry)
+          )))]
+        : [],
+    },
     bot: {
       name: text(value.bot?.name, 'WhatsApp机器人', 100),
       idMasked: text(value.bot?.idMasked, 'WhatsApp账号', 140),

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

@@ -10,6 +10,7 @@ import {
   EMPTY_AGENT_PRESET_CATALOG,
 } from '../../agent-preset.js';
 import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
+import { BotStatusMeta, ChannelListHeading } from '../../channel-card-meta.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
   WHATSAPP_ENDPOINTS,
@@ -24,6 +25,119 @@ import { installWhatsappStyles } from './styles.js';
 
 const ACTIVE_STATES = new Set(['pending', 'connecting']);
 
+function accessPolicyFor(account) {
+  const accessMode = ['self-only', 'private-allowlist', 'open'].includes(
+    account?.accessPolicy?.accessMode,
+  ) ? account.accessPolicy.accessMode : 'self-only';
+  return {
+    accessMode,
+    allowedNumbers: Array.isArray(account?.accessPolicy?.allowedNumbers)
+      ? account.accessPolicy.allowedNumbers : [],
+  };
+}
+
+function allowedNumbersFromText(value) {
+  const entries = value.split(/\r?\n/).map((entry) => entry.trim()).filter(Boolean);
+  const normalized = entries.map((entry) => entry.replace(/^\+/, ''));
+  if (normalized.some((entry) => !/^[1-9]\d{4,14}$/.test(entry))) {
+    throw new TypeError('电话号码必须包含国家或地区代码，每行一个。');
+  }
+  return [...new Set(normalized)];
+}
+
+export function WhatsappAccessSettings({ account, busy = false, onSave }) {
+  const policy = accessPolicyFor(account);
+  const sourceNumbers = policy.allowedNumbers.join('\n');
+  const helpId = React.useId();
+  const [accessMode, setAccessMode] = React.useState(policy.accessMode);
+  const [allowedNumbers, setAllowedNumbers] = React.useState(sourceNumbers);
+  const [error, setError] = React.useState(null);
+
+  React.useEffect(() => {
+    setAccessMode(policy.accessMode);
+    setAllowedNumbers(sourceNumbers);
+    setError(null);
+  }, [policy.accessMode, sourceNumbers]);
+
+  const save = async (event) => {
+    event.preventDefault();
+    setError(null);
+    try {
+      const normalized = allowedNumbersFromText(allowedNumbers);
+      if (typeof onSave !== 'function') throw new Error('WhatsApp 访问设置暂不可用。');
+      await onSave({ accessMode, allowedNumbers: normalized });
+    } catch (caught) {
+      setError(caught?.message ?? 'WhatsApp 访问设置保存失败。');
+    }
+  };
+
+  const allowlistEnabled = accessMode === 'private-allowlist';
+  const labels = {
+    'self-only': '仅自己模式',
+    'private-allowlist': '指定联系人模式',
+    open: '开放响应模式',
+  };
+  return h('form', { className: 'dwa-access', onSubmit: save },
+    h('div', { className: 'dwa-accessHeading' },
+      h('strong', null, '访问设置'),
+      h('span', { className: 'dwa-accessStatus' },
+        h('span', { className: 'dwa-accessBadge', 'data-mode': policy.accessMode },
+          ['已生效：', labels[policy.accessMode]]),
+        h('span', { className: 'dwa-accessHelp' },
+          h('button', {
+            type: 'button',
+            className: 'dwa-accessHelpButton',
+            'aria-label': '查看 WhatsApp 访问模式说明',
+            'aria-describedby': helpId,
+          }, h('span', { 'aria-hidden': 'true' }, '?')),
+          h('span', { id: helpId, className: 'dwa-accessTooltip', role: 'tooltip' },
+            h('span', { className: 'dwa-accessTooltipItem' },
+              h('strong', null, '仅自己模式'),
+              h('span', null, '只响应已绑定 WhatsApp 账号的自聊消息。')),
+            h('span', { className: 'dwa-accessTooltipItem' },
+              h('strong', null, '指定联系人模式'),
+              h('span', null, '响应自聊和白名单联系人的私聊，忽略群聊。')),
+            h('span', { className: 'dwa-accessTooltipItem' },
+              h('strong', null, '开放响应模式'),
+              h('span', null, '响应所有私聊，以及群聊中的提及或回复。')))))),
+    h('label', { className: 'dwa-accessField' },
+      h('span', null, '模式'),
+      h('select', {
+        value: accessMode,
+        disabled: busy,
+        'aria-label': 'WhatsApp 访问模式',
+        onChange: (event) => { setAccessMode(event.target.value); setError(null); },
+      },
+      h('option', { value: 'self-only' }, '仅自己模式（默认）'),
+      h('option', { value: 'private-allowlist' }, '指定联系人模式'),
+      h('option', { value: 'open' }, '开放响应模式'))),
+    allowlistEnabled
+      ? h('label', { className: 'dwa-accessField' },
+          h('span', null, '允许私聊的 WhatsApp 电话号码'),
+          h('textarea', {
+            value: allowedNumbers,
+            disabled: busy,
+            rows: 3,
+            placeholder: '每行一个含国家或地区代码的号码',
+            'aria-label': '允许私聊的 WhatsApp 电话号码',
+            onChange: (event) => { setAllowedNumbers(event.target.value); setError(null); },
+          }),
+          h('small', null, '可以包含开头的 +，保存时会自动移除。'))
+      : null,
+    allowlistEnabled && allowedNumbers.trim() === ''
+      ? h('p', { className: 'dwa-accessWarning', role: 'status' },
+          '白名单为空；保存后将只接受自聊消息。')
+      : null,
+    error ? h('p', { className: 'dwa-accessError', role: 'alert' }, error) : null,
+    h('div', { className: 'dwa-accessActions' },
+      h('button', {
+        type: 'submit',
+        className: 'ddt-button',
+        'data-kind': 'secondary',
+        disabled: busy,
+      }, busy ? '正在保存…' : '保存访问设置')));
+}
+
 const Button = React.forwardRef(function Button(
   { children, kind = 'secondary', className = '', ...props },
   ref,
@@ -179,6 +293,7 @@ export function WhatsappAccountCard({
   onReconnect,
   onWorkspaceSave,
   onAgentPresetSave,
+  onAccessPolicySave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -197,15 +312,14 @@ export function WhatsappAccountCard({
           }, h(WhatsappLogoGlyph, { size: 29 })),
           h('div', { className: 'dim-botName' },
             h('h3', null, account.bot.name), h('p', null, account.bot.idMasked))),
-        h('div', { className: 'ddt-health dim-botHealth' },
-          h('span', { className: 'ddt-dot dim-healthDot', 'data-tone': tone }),
-          h('span', null, stateLabel))),
-      h('dl', { className: 'ddt-metrics dim-botMetrics' },
-        h('div', { className: 'ddt-metric dim-botMetric' },
-          h('dt', null, '消息通道'),
-          h('dd', null, account.connected ? 'WhatsApp Web' : '离线')),
-        h('div', { className: 'ddt-metric dim-botMetric' },
-          h('dt', null, '最近检查'), h('dd', null, checkedTime(account.health.lastCheckedAt)))),
+        h(BotStatusMeta, {
+          className: 'ddt-health',
+          dotClassName: 'ddt-dot',
+          tone,
+          stateLabel,
+          lastCheckedAt: account.health.lastCheckedAt,
+          formatCheckedTime: checkedTime,
+        })),
       h(WorkspaceEditor, {
         workspace: account.workspace,
         disabled: Boolean(busy),
@@ -216,19 +330,25 @@ export function WhatsappAccountCard({
         disabled: Boolean(busy),
         onSave: onAgentPresetSave,
       }),
+      h(WhatsappAccessSettings, {
+        account,
+        busy: Boolean(busy),
+        onSave: onAccessPolicySave,
+      }),
       h('div', { className: 'ddt-accountFooter dim-cardFooter' },
-        summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
-        testNotice ? h('div', {
-          className: 'ddt-summary dim-cardSummary',
-          role: 'status',
-        }, testNotice) : null,
-        h('div', { className: 'ddt-actions dim-cardActions' },
-          h(Button, {
-            className: 'dim-cardAction', onClick: onReconnect, disabled: Boolean(busy),
-          }, busy === 'reconnect' ? '检查中…' : account.connected ? '检查连接' : '重试连接'),
-          h(Button, {
-            className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy),
-          }, '移除接入')))),
+        h('div', { className: 'dim-cardFooterLayout' },
+          h('div', { className: 'ddt-actions dim-cardActions' },
+            h(Button, {
+              className: 'dim-cardAction', onClick: onReconnect, disabled: Boolean(busy),
+            }, busy === 'reconnect' ? '检查中…' : account.connected ? '检查连接' : '重试连接'),
+            h(Button, {
+              className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy),
+            }, '移除接入')),
+          summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          testNotice ? h('div', {
+            className: 'ddt-summary dim-cardFeedback',
+            role: 'status',
+          }, testNotice) : null))),
     removing ? h(RemoveConfirmation, {
       account,
       busy: busy === 'delete',
@@ -439,8 +559,11 @@ export function WhatsappSettingsTab({ rpcCall }) {
 
   const botList = model.bots.length > 0
     ? h('section', { className: 'dim-listSection' },
-        h('div', { className: 'ddt-listHeading dim-listHeading' },
-          h('h3', null, '已接入的 WhatsApp 机器人')),
+        h(ChannelListHeading, {
+          className: 'ddt-listHeading',
+          title: '已接入的 WhatsApp 机器人',
+          connectionLabel: 'WhatsApp Web',
+        }),
         h('ul', { className: 'ddt-list dim-botList' }, model.bots.map((account) =>
           h('li', { key: account.botId }, h(WhatsappAccountCard, {
             account,
@@ -465,6 +588,12 @@ export function WhatsappSettingsTab({ rpcCall }) {
               WHATSAPP_ENDPOINTS.setAgentPreset,
               { botId: account.botId, agentPreset },
             ),
+            onAccessPolicySave: (accessPolicy) => botAction(
+              account,
+              'access',
+              WHATSAPP_ENDPOINTS.setAccessPolicy,
+              { botId: account.botId, ...accessPolicy },
+            ),
             onRequestRemove: () => setRemoveTarget(account.botId),
             onCancelRemove: () => setRemoveTarget(null),
             onConfirmRemove: async () => {

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

@@ -4,6 +4,31 @@ const CSS = String.raw`
 .dwa-page { --ddt-accent: #25d366; --ddt-accent-deep: #128c7e; --ddt-accent-wash: #eafbf0; }
 .dwa-avatar { color: #fff; background: #25d366; }
 .dwa-avatar svg { display: block; }
+.dwa-access { display: grid; gap: 10px; padding: 12px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 10px; background: var(--dsw-alias-bg-layer-2, #f7f8fa); }
+.dwa-accessHeading { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.dwa-accessHeading > strong { font-size: 13px; }
+.dwa-accessStatus { min-width: 0; display: inline-flex; align-items: center; justify-content: flex-end; gap: 6px; }
+.dwa-accessBadge { flex: none; padding: 3px 8px; border-radius: 999px; color: #08785f; background: #eafbf0; font-size: 11px; font-weight: 700; }
+.dwa-accessBadge[data-mode="private-allowlist"] { color: #0f6f8f; background: #eaf7fd; }
+.dwa-accessBadge[data-mode="open"] { color: #a15c00; background: #fff3d6; }
+.dwa-accessHelp { position: relative; display: inline-flex; flex: none; }
+.dwa-accessHelpButton { width: 20px; height: 20px; display: grid; place-items: center; padding: 0; border: 1px solid color-mix(in srgb, #25d366 34%, var(--dsw-alias-border-l2, #dfe1e5)); border-radius: 50%; color: #128c7e; background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 12px; line-height: 1; font-weight: 750; cursor: help; }
+.dwa-accessTooltip { position: absolute; top: calc(100% + 8px); right: 0; z-index: 30; width: 270px; max-width: min(290px, calc(100vw - 48px)); display: grid; gap: 8px; padding: 10px 11px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 9px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 10px 28px rgb(31 35 41 / 16%); opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dwa-accessTooltipItem { display: grid; gap: 2px; }
+.dwa-accessTooltipItem + .dwa-accessTooltipItem { padding-top: 8px; border-top: 1px solid var(--dsw-alias-border-l2, #eef0f3); }
+.dwa-accessTooltipItem strong { font-size: 12px; line-height: 17px; }
+.dwa-accessTooltipItem > span { color: var(--dsw-alias-label-secondary, #646a73); font-size: 11px; line-height: 16px; }
+.dwa-accessHelp:hover .dwa-accessTooltip, .dwa-accessHelp:focus-within .dwa-accessTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
+.dwa-accessField { display: grid; gap: 5px; color: var(--dsw-alias-label-primary, #1f2329); font-size: 12px; font-weight: 600; }
+.dwa-accessField select, .dwa-accessField textarea { width: 100%; box-sizing: border-box; border: 1px solid var(--dsw-alias-border-l1, #c9cdd4); border-radius: 7px; color: inherit; background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-weight: 400; }
+.dwa-accessField select { height: 34px; padding: 0 9px; }
+.dwa-accessField textarea { min-height: 68px; padding: 8px 9px; resize: vertical; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
+.dwa-accessField textarea:disabled { color: var(--dsw-alias-label-tertiary, #8f959e); background: var(--dsw-alias-bg-module-platform, #f2f3f5); cursor: not-allowed; resize: none; opacity: 1; }
+.dwa-accessField small { color: var(--dsw-alias-label-secondary, #646a73); font-weight: 400; }
+.dwa-accessWarning, .dwa-accessError { margin: 0; font-size: 12px; line-height: 1.5; }
+.dwa-accessWarning { color: #a15c00; }
+.dwa-accessError { color: var(--dsw-alias-state-error-primary, #d83931); }
+.dwa-accessActions { display: flex; justify-content: flex-end; }
 `;
 
 export function installWhatsappStyles() {

package/plugin-src/client/i18n.js

@@ -107,6 +107,7 @@ const EN = Object.freeze({
   '离线': 'Offline',
   '已断开': 'Disconnected',
   '消息通道': 'Message channel',
+  '查看消息通道说明': 'View message channel details',
   '最近检查': 'Last checked',
   '当前工作区': 'Current workspace',
   '选择目录': 'Choose folder',
@@ -136,6 +137,7 @@ const EN = Object.freeze({
   '工作区路径必须指向一个目录。': 'The workspace path must point to a directory.',
   '找不到要修改的机器人。': 'The bot could not be found.',
   'Agent Preset': 'Agent Preset',
+  '查看 Agent Preset 说明': 'View Agent Preset help',
   '跟随 Host 默认': 'Follow the Host default',
   '（已不可用）': ' (unavailable)',
   '只影响新建会话；若当前聊天已有会话，先发送 /new，再发送普通消息生效。': 'This affects only new sessions. If the current chat already has a session, send /new, then send a regular message to apply it.',
@@ -358,6 +360,24 @@ const EN = Object.freeze({
   '正在建立安全的关联设备会话。': 'Creating a secure linked-device session.',
   '关联设备正在接入 DeepSeek Harness。': 'Linking the device to DeepSeek Harness.',
   'WhatsApp Web 关联设备运行正常': 'WhatsApp linked device is healthy',
+  '查看 WhatsApp 访问模式说明': 'View WhatsApp access mode details',
+  'WhatsApp 访问模式': 'WhatsApp access mode',
+  '仅自己模式': 'Only me',
+  '指定联系人模式': 'Selected contacts',
+  '开放响应模式': 'Open responses',
+  '仅自己模式（默认）': 'Only me (default)',
+  '已生效：': 'Active: ',
+  '只响应已绑定 WhatsApp 账号的自聊消息。': 'Only respond to self-chat messages from the linked WhatsApp account.',
+  '响应自聊和白名单联系人的私聊，忽略群聊。': 'Respond to self-chat and allowlisted direct messages; ignore group messages.',
+  '响应所有私聊，以及群聊中的提及或回复。': 'Respond to all direct messages and to group mentions or replies.',
+  '允许私聊的 WhatsApp 电话号码': 'WhatsApp phone numbers allowed to send direct messages',
+  '每行一个含国家或地区代码的号码': 'One number with country or region code per line',
+  '可以包含开头的 +，保存时会自动移除。': 'A leading + is allowed and removed when saved.',
+  '仅指定联系人模式使用白名单，切换模式时会保留。': 'Only Selected contacts uses the allowlist; it is retained when modes change.',
+  '白名单为空；保存后将只接受自聊消息。': 'The allowlist is empty; only self-chat messages will be accepted after saving.',
+  '电话号码必须包含国家或地区代码，每行一个。': 'Each phone number must include a country or region code on its own line.',
+  'WhatsApp 访问设置暂不可用。': 'WhatsApp access settings are currently unavailable.',
+  'WhatsApp 访问设置保存失败。': 'Could not save WhatsApp access settings.',
   'Bot API 长轮询': 'Bot API long polling',
   ' Gateway 长连接': ' Gateway persistent connection',
   'Gateway 长连接': 'Gateway persistent connection',

package/plugin-src/client/styles.js

@@ -87,6 +87,14 @@ const CSS = String.raw`
 .dim-panel .dim-listSection { display: flex; flex-direction: column; gap: 0; }
 .dim-panel .dim-listHeading { min-height: 0; display: flex; align-items: center; justify-content: space-between; gap: 16px; margin: 0 0 6px; padding: 0; }
 .dim-panel .dim-listHeading h3 { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 14px; line-height: normal; font-weight: 650; }
+.dim-panel .dim-listTitle { min-width: 0; display: inline-flex; align-items: center; gap: 6px; }
+.dim-panel .dim-channelHelp { position: relative; display: inline-flex; flex: none; }
+.dim-panel .dim-channelHelpButton { width: 17px; height: 17px; display: grid; place-items: center; padding: 0; border: 1px solid color-mix(in srgb, #1677ff 28%, var(--dsw-alias-border-l2, #dfe1e5)); border-radius: 50%; color: #1677ff; background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 11px; line-height: 1; font-weight: 700; cursor: help; transition: border-color .15s ease, color .15s ease, background .15s ease, box-shadow .15s ease; }
+.dim-panel .dim-channelHelpButton:hover { border-color: #1677ff; color: #0f5fce; background: color-mix(in srgb, #1677ff 8%, var(--dsw-alias-bg-layer-1, #fff)); }
+.dim-panel .dim-channelHelpButton:focus-visible { outline: none; border-color: #1677ff; box-shadow: 0 0 0 3px color-mix(in srgb, #1677ff 16%, transparent); }
+.dim-panel .dim-channelTooltip { position: absolute; top: calc(100% + 7px); left: 0; z-index: 30; width: max-content; max-width: min(280px, calc(100vw - 48px)); display: flex; align-items: baseline; gap: 5px; padding: 8px 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 10px 28px rgb(31 35 41 / 16%); font-size: 11px; line-height: 16px; font-weight: 400; white-space: normal; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dim-panel .dim-channelTooltip strong { color: var(--dsw-alias-label-primary, #1f2329); font-weight: 600; white-space: nowrap; }
+.dim-panel .dim-channelHelp:hover .dim-channelTooltip, .dim-panel .dim-channelHelp:focus-within .dim-channelTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-panel .dim-botList { display: grid; gap: 8px; margin: 0; padding: 0; list-style: none; }
 .dim-panel .dim-loadingView { padding: 38px; color: var(--dsw-alias-label-secondary, #646a73); text-align: center; }
 .dim-panel .dim-loadingView h3 { margin: 0 0 7px; color: var(--dsw-alias-label-primary, #1f2329); font-size: 17px; line-height: normal; font-weight: 650; }
@@ -143,13 +151,18 @@ const CSS = String.raw`
 .dim-panel .dim-workspaceEdit:disabled { cursor: not-allowed; opacity: .55; }
 .dim-panel .dim-workspacePath { min-width: 0; max-width: 100%; grid-column: 1 / -1; grid-row: 2; display: block; overflow-x: auto; overflow-y: hidden; color: var(--dsw-alias-label-primary, #1f2329); font: 12px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace; white-space: nowrap; }
 .dim-panel .dim-preset { min-width: 0; display: grid; grid-template-columns: minmax(0, 1fr) max-content; align-items: center; column-gap: 10px; row-gap: 4px; margin-top: 6px; padding: 6px 10px; border: 1px solid var(--dsw-alias-border-l1, #eef0f3); border-radius: 9px; background: var(--dsw-alias-bg-module-platform, #f7f8fa); }
-.dim-panel .dim-presetHeader { display: contents; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: normal; }
-.dim-panel .dim-presetHeader > span { grid-column: 1; grid-row: 1; white-space: nowrap; }
+.dim-panel .dim-presetHeader { position: relative; min-width: 0; grid-column: 1 / -1; grid-row: 1; display: flex; align-items: center; justify-content: space-between; gap: 10px; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: normal; }
+.dim-panel .dim-presetTitle { min-width: 0; display: inline-flex; align-items: center; gap: 5px; white-space: nowrap; }
+.dim-panel .dim-presetHelp { display: inline-flex; align-items: center; flex: none; }
+.dim-panel .dim-presetHelpButton { width: 17px; height: 17px; display: grid; place-items: center; padding: 0; border: 1px solid color-mix(in srgb, #1677ff 28%, var(--dsw-alias-border-l2, #dfe1e5)); border-radius: 50%; color: #1677ff; background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 11px; line-height: 1; font-weight: 700; cursor: help; transition: border-color .15s ease, color .15s ease, background .15s ease, box-shadow .15s ease; }
+.dim-panel .dim-presetHelpButton:hover { border-color: #1677ff; color: #0f5fce; background: color-mix(in srgb, #1677ff 8%, var(--dsw-alias-bg-layer-1, #fff)); }
+.dim-panel .dim-presetHelpButton:focus-visible { outline: none; border-color: #1677ff; box-shadow: 0 0 0 3px color-mix(in srgb, #1677ff 16%, transparent); }
+.dim-panel .dim-presetTooltip { position: absolute; top: calc(100% + 7px); left: 0; z-index: 30; width: min(320px, 100%); padding: 9px 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 10px 28px rgb(31 35 41 / 16%); font-size: 11px; line-height: 16px; font-weight: 400; overflow-wrap: anywhere; white-space: normal; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dim-panel .dim-presetHelp:hover .dim-presetTooltip, .dim-panel .dim-presetHelp:focus-within .dim-presetTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-panel .dim-presetStatus { grid-column: 2; grid-row: 1; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 12px; white-space: nowrap; }
 .dim-panel .dim-presetSelect { min-width: 0; max-width: 100%; grid-column: 1 / -1; grid-row: 2; height: 30px; padding: 0 8px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 12px; }
 .dim-panel .dim-presetSelect:disabled { cursor: not-allowed; opacity: .55; }
-.dim-panel .dim-presetHelp { grid-column: 1 / -1; grid-row: 3; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; line-height: 1.4; }
-.dim-panel .dim-presetError { grid-column: 1 / -1; grid-row: 4; margin: 0; color: var(--dsw-alias-state-error-primary, #d54941); font-size: 12px; line-height: 1.4; }
+.dim-panel .dim-presetError { grid-column: 1 / -1; grid-row: 3; margin: 0; color: var(--dsw-alias-state-error-primary, #d54941); font-size: 12px; line-height: 1.4; }
 .dim-directoryPickerBackdrop { --dim-blue: var(--dsw-alias-state-business-primary, #3370ff); --dim-blue-soft: color-mix(in srgb, var(--dim-blue) 9%, transparent); position: fixed; inset: 0; z-index: 1000; display: grid; place-items: center; padding: 24px; background: rgb(15 17 21 / 42%); backdrop-filter: blur(3px); }
 .dim-directoryPickerBackdrop, .dim-directoryPickerBackdrop *, .dim-directoryPickerBackdrop *::before, .dim-directoryPickerBackdrop *::after { box-sizing: border-box; }
 .dim-directoryPicker { width: min(720px, 100%); height: min(620px, calc(100vh - 48px)); min-height: 420px; display: grid; grid-template-rows: auto minmax(0, 1fr) auto; overflow: hidden; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 18px; outline: none; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 24px 72px rgb(15 17 21 / 24%); }
@@ -192,6 +205,9 @@ const CSS = String.raw`
 .dim-directoryPickerActions button:hover:not(:disabled) { filter: brightness(.97); }
 .dim-directoryPickerActions button:disabled { cursor: not-allowed; opacity: .52; }
 .dim-panel .dim-cardSummary { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font: inherit; font-size: 12px; font-weight: 400; line-height: normal; }
+.dim-panel .dim-cardFooterLayout { min-width: 0; width: 100%; display: flex; flex-direction: column; align-items: stretch; gap: 9px; }
+.dim-panel .dim-cardFooterLayout > .dim-cardActions { align-self: flex-end; }
+.dim-panel .dim-cardFeedback { width: 100%; padding: 8px 10px; border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-module-platform, #f7f8fa); font: inherit; font-size: 12px; font-weight: 400; line-height: 18px; overflow-wrap: anywhere; white-space: normal; }
 .dim-panel .dim-cardActions { flex: none; display: flex; align-items: center; flex-wrap: nowrap; gap: 8px; margin: 0 0 0 auto; }
 .dim-panel .dim-cardActions .dim-cardAction { flex: none; min-height: 32px; padding: 0 11px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 13px; font-weight: 560; line-height: normal; white-space: nowrap; }
 .dim-panel .dim-cardActions .dim-cardAction:hover:not(:disabled) { border-color: #aeb3bb; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
@@ -206,15 +222,13 @@ const CSS = String.raw`
 .dim-panel .dim-botName { min-width: 0; }
 .dim-panel .dim-botName h3 { overflow: hidden; margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 15px; font-weight: 650; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
 .dim-panel .dim-botName p { overflow: hidden; margin: 4px 0 0; color: var(--dsw-alias-label-secondary, #646a73); font: 12px ui-monospace, SFMono-Regular, monospace; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
+.dim-panel .dim-botHealthGroup { flex: none; display: grid; justify-items: end; gap: 5px; }
 .dim-panel .dim-botCard .dim-botHealth { flex: none; min-height: 0; display: inline-flex; align-items: center; gap: 7px; padding: 0; border: 0; border-radius: 0; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; font: inherit; font-size: 12px; font-weight: 400; line-height: normal; white-space: nowrap; }
+.dim-panel .dim-lastChecked { display: inline-flex; align-items: baseline; gap: 4px; color: var(--dsw-alias-label-tertiary, #8f959e); font: inherit; font-size: 11px; font-weight: 400; line-height: normal; white-space: nowrap; }
 .dim-panel .dim-botCard .dim-healthDot { flex: none; width: 8px; height: 8px; border-radius: 50%; background: #aeb3bb; box-shadow: none; }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="success"] { background: var(--dsw-alias-state-success-primary, #20a162); box-shadow: 0 0 0 3px color-mix(in srgb, var(--dsw-alias-state-success-primary, #20a162) 14%, transparent); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="warning"] { background: var(--dsw-alias-state-warn-primary, #d97706); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="error"] { background: var(--dsw-alias-state-error-primary, #d54941); }
-.dim-panel .dim-botMetrics { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 8px; margin: 6px 0; }
-.dim-panel .dim-botMetric { min-width: 0; padding: 6px 8px; border: 0; border-radius: 9px; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
-.dim-panel .dim-botMetric dt { margin: 0; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; font-weight: 400; line-height: normal; }
-.dim-panel .dim-botMetric dd { overflow: hidden; margin: 3px 0 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 12px; font-weight: 400; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
 .dim-panel .dim-botCard .dim-cardFooter { margin-top: 0; }
 .dim-panel .ddt-headingCopy { display: none; }
 .dim-panel .ddt-qrFrame, .dim-panel .ddt-countdown { width: min(270px, 100%); }
@@ -245,6 +259,7 @@ const CSS = String.raw`
 }
 @media (max-width: 720px) {
   .dim-panel .dim-botCardTop { flex-direction: column; align-items: stretch; }
+  .dim-panel .dim-botHealthGroup { justify-items: start; }
 }
 @media (max-width: 560px) {
   .dim-title { flex-direction: column; gap: 10px; }

package/plugin-src/host/channels/whatsapp/rpc.mjs

@@ -1,6 +1,7 @@
 import QRCode from 'qrcode';
 
 import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
+import { normalizeWhatsappAccessPolicy } from '../../../../src/channels/whatsapp/config-store.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
@@ -13,6 +14,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   cancelProvisioning: 'provision.cancel',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setAccessPolicy: 'bot.access-policy.set',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
@@ -50,6 +52,17 @@ function payloadFailure(endpoint, payload) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId)
       && payload.confirm === true ? null : 'bot.delete requires a botId and confirm=true.';
   }
+  if (endpoint === WHATSAPP_ENDPOINTS.setAccessPolicy) {
+    if (!exactKeys(payload, ['botId', 'accessMode', 'allowedNumbers'])
+      || Object.keys(payload).length !== 3
+      || !validId(payload.botId)) return '请输入有效的 WhatsApp 访问模式和电话号码。';
+    try {
+      normalizeWhatsappAccessPolicy(payload);
+      return null;
+    } catch {
+      return '请输入有效的 WhatsApp 访问模式和电话号码。';
+    }
+  }
   if (endpoint === WHATSAPP_ENDPOINTS.setWorkspace) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
@@ -92,7 +105,7 @@ async function publicStatus(value, encodeQr) {
 }
 
 export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } = {}) {
-  for (const method of ['status', 'startProvisioning', 'registrationStatus', 'cancelProvisioning', 'reconnectBot', 'deleteBot']) {
+  for (const method of ['status', 'startProvisioning', 'registrationStatus', 'cancelProvisioning', 'reconnectBot', 'deleteBot', 'setAccessPolicy']) {
     if (typeof controller?.[method] !== 'function') {
       throw new TypeError(`A complete WhatsApp controller is required (${method})`);
     }
@@ -166,6 +179,11 @@ export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } =
           await controller.updateAgentPreset(payload.botId, payload.agentPreset),
           cachedEncode,
         );
+      } else if (endpoint === WHATSAPP_ENDPOINTS.setAccessPolicy) {
+        value = await publicStatus(
+          await controller.setAccessPolicy(payload.botId, normalizeWhatsappAccessPolicy(payload)),
+          cachedEncode,
+        );
       } else {
         value = await publicStatus(await controller.deleteBot(payload.botId), cachedEncode);
       }

package/plugin-src/host/index.mjs

@@ -8,9 +8,15 @@ import { apply as applyTelegram } from './channels/telegram/index.mjs';
 import { apply as applyWecom } from './channels/wecom/index.mjs';
 import { apply as applyWeixin } from './channels/weixin/index.mjs';
 import { apply as applyWhatsapp } from './channels/whatsapp/index.mjs';
+import { installOutboundArtifactTool } from '../../src/channels/shared/semantic/artifact.mjs';
 
 export const name = 'dsh-im-host';
-export const inject = ['connection', 'credentials', 'webServer', 'typertGateway'];
+export const inject = [
+  'connection',
+  'credentials',
+  'webServer',
+  'typertGateway',
+];
 
 function channelConfig(config, name) {
   const channel = config[name] ?? {};
@@ -34,6 +40,13 @@ export function createImHostPlugin(internals = {}) {
     name,
     inject,
     async apply(ctx, config = {}) {
+      if (typeof ctx?.inject === 'function') {
+        ctx.inject(['tools', 'systemPrompt'], (artifactCtx) => {
+          installOutboundArtifactTool(artifactCtx);
+        });
+      } else {
+        installOutboundArtifactTool(ctx);
+      }
       await startFeishu(ctx, channelConfig(config, 'feishu'));
       await startWeixin(ctx, channelConfig(config, 'weixin'));
       await startDingtalk(ctx, channelConfig(config, 'dingtalk'));