@xmanrui/dsh-im 4.22.0 → 4.23.0

package/plugin-src/client/channels/wecom-app/index.js

@@ -1,3 +1,4 @@
+import { ConnectionError, normalizeConnectionError } from '../../connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
@@ -159,7 +160,7 @@ function BindForm({ busy, error, onSubmit, onCancel }) {
           disabled: busy,
         }, streamEnabled ? '流式回复：开' : '流式回复：关'),
         h('span', { className: 'dim-switchHint' }, '企业微信客户端实时出字；微信端不支持时自动改为整段发送'))),
-    error ? h('div', { className: 'ddt-inlineError dim-inlineError', role: 'alert' }, h('p', null, error.message)) : null,
+    error ? h('div', { className: 'ddt-inlineError dim-inlineError', role: 'alert' }, h(ConnectionError, { error: error })) : null,
     h('div', { className: 'ddt-actions dim-viewActions' },
       h(Button, { kind: 'primary', onClick: () => formRef.current?.requestSubmit(), disabled: busy }, busy ? '正在绑定…' : '保存并连接'),
       h(Button, { kind: 'quiet', onClick: onCancel, disabled: busy }, '取消'))));
@@ -327,6 +328,7 @@ export function AccountCard({
             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,
+          account.error ? h(ConnectionError, { error: account.error, showMessage: false }) : null,
           account.lastMessageError ? h(LastMessageErrorSummary, {
             className: 'ddt-summary',
             error: account.lastMessageError,
@@ -344,6 +346,7 @@ export function AccountCard({
 }
 
 export function WecomAppSettingsTab({ rpcCall }) {
+  const [operationError, setOperationError] = React.useState(null);
   const [model, setModel] = React.useState({
     phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null,
     agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
@@ -393,7 +396,16 @@ export function WecomAppSettingsTab({ rpcCall }) {
 
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
     if (typeof rpcCall !== 'function') throw new TypeError('企业微信应用设置页缺少 RPC 连接');
-    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+    const operation = !['connection.status', 'provision.poll', 'provision.begin', 'provision.cancel'].includes(endpoint);
+      if (operation && mounted.current) setOperationError(null);
+      try {
+        const value = unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+        if (operation && mounted.current) setOperationError(value?.testMessage?.error ?? value?.warnings?.[0] ?? null);
+        return value;
+      } catch (error) {
+        if (operation && mounted.current && !signal?.aborted && error?.name !== 'AbortError') setOperationError(normalizeConnectionError(error));
+        throw error;
+      }
   }, [rpcCall]);
 
   const loadStatus = React.useCallback(async ({ signal, silent = false, restore = false } = {}) => {
@@ -601,6 +613,7 @@ export function WecomAppSettingsTab({ rpcCall }) {
   }, h(AgentPresetCatalogContext.Provider, {
     value: model.agentPresetCatalog ?? EMPTY_AGENT_PRESET_CATALOG,
   }, h('section', { className: 'ddt-page dwecomapp-page dim-channelPage', 'aria-label': '企业微信应用设置' },
+    operationError ? h(ConnectionError, { error: operationError }) : null,
     h(Heading, {
       totals: model.totals,
       adding: bindOpen,
@@ -611,7 +624,7 @@ export function WecomAppSettingsTab({ rpcCall }) {
     h('div', { className: 'ddt-visuallyHidden', role: 'status', 'aria-live': 'polite' }, notice),
     model.phase === 'loading' ? h(LoadingView)
       : model.phase === 'error'
-        ? h('div', { className: 'ddt-card dim-surfaceCard' }, h('div', { className: 'ddt-inlineError dim-inlineError' }, h('h3', null, '无法读取企业微信应用状态'), h('p', null, model.error?.message), h(Button, { onClick: () => void loadStatus() }, '重新读取')))
+        ? h('div', { className: 'ddt-card dim-surfaceCard' }, h('div', { className: 'ddt-inlineError dim-inlineError' }, h('h3', null, '无法读取企业微信应用状态'), h(ConnectionError, { error: model.error }), h(Button, { onClick: () => void loadStatus() }, '重新读取')))
         : h(React.Fragment, null,
             bindView,
             model.bots.length === 0 && !bindOpen

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

@@ -1,3 +1,4 @@
+import { normalizeConnectionError as normalizeTestError } from '../../connection-error.js';
 import { normalizeWeixinDiagnosticDetails } from '../../../../src/channels/weixin/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
@@ -55,7 +56,7 @@ function normalizeTestMessage(value) {
   const code = value.code === 'test-target-unavailable'
     ? 'test-target-unavailable'
     : 'test-message-failed';
-  return { sent: false, code };
+  return { sent: false, code, ...(value.error ? { error: normalizeTestError(value.error) } : {}) };
 }
 
 export function normalizeConnectionError(value, fallbackCode = 'WEIXIN_ERROR', fallbackMessage = '微信操作失败，请稍后重试') {

package/plugin-src/client/channels/weixin/connection-error.js

@@ -1,71 +1 @@
-import * as React from 'react';
-import { h, localizeText } from '../../i18n.js';
-import { normalizeConnectionError } from './api.js';
-import { CONFIG_ISSUE_LABELS } from '../../../../src/channels/weixin/diagnostic-details.mjs';
-
-const STAGE_LABELS = {
-  'startup.load': '加载微信配置', 'qr.begin': '申请二维码', 'qr.encode': '生成二维码图片', 'qr.poll': '查询扫码状态',
-  'qr.verify': '提交配对码', 'qr.cancel': '取消绑定', 'credential.read': '读取登录凭据', 'credential.save': '保存登录凭据',
-  'credential.remove': '移除登录凭据', 'account.save': '保存账号配置', 'account.remove': '移除账号配置',
-  'state.load': '读取账号状态', 'state.write': '保存账号状态', 'state.cleanup': '清理账号状态',
-  'workspace.write': '保存工作区设置', 'workspace.cleanup': '清理工作区设置', 'runtime.prepare': '准备消息连接',
-  activation: '激活微信账号', 'harness.check': '检查 DSH 宿主', 'connection.start': '启动微信连接',
-  'connection.poll': '同步微信消息', 'connection.stop': '停止微信连接', 'status.read': '读取连接状态',
-  rollback: '恢复原账号状态', 'management.request': '访问 DSH 管理接口',
-};
-
-export function provisioningErrorTitle(error) {
-  const stage = error?.details?.stage;
-  if (stage === 'qr.begin' || stage === 'qr.encode') return '无法生成微信二维码';
-  if (stage === 'qr.poll') return '查询微信扫码状态失败';
-  if (stage === 'management.request') return '无法完成微信管理请求';
-  return '微信没有绑定完成';
-}
-
-export function formatWeixinDiagnostic(value) {
-  const error = normalizeConnectionError(value);
-  const details = error.details ?? {};
-  return [
-    localizeText(error.message), details.hint ? localizeText(details.hint) : null,
-    localizeText('错误码') + ': ' + error.code,
-    ...['operation', 'stage', 'reason', 'httpStatus', 'providerCode', 'resource', 'file', 'field', 'issue', 'referenceId', 'occurredAt', 'rollback', 'pluginVersion']
-      .filter(field => details[field] !== undefined)
-      .map(field => `${field}: ${details[field]}`),
-  ].filter(Boolean).join('\n');
-}
-
-export function WeixinConnectionError({ error: value, warning = false }) {
-  const error = normalizeConnectionError(value);
-  const details = error.details ?? {};
-  const [copyState, setCopyState] = React.useState(null);
-  React.useEffect(() => setCopyState(null), [details.referenceId, error.code, error.message]);
-  const copy = async () => {
-    try {
-      if (typeof globalThis.navigator?.clipboard?.writeText !== 'function') throw new Error('clipboard unavailable');
-      await globalThis.navigator.clipboard.writeText(formatWeixinDiagnostic(error));
-      setCopyState('copied');
-    } catch { setCopyState('manual'); }
-  };
-  const fields = [
-    ['错误码', error.code], ['失败阶段', localizeText(STAGE_LABELS[details.stage] ?? details.stage ?? '')],
-    ['底层原因', details.reason], ['HTTP 状态', details.httpStatus], ['微信返回码', details.providerCode],
-    ['配置文件', details.file], ['配置字段', details.field],
-    ['校验原因', details.issue ? localizeText(CONFIG_ISSUE_LABELS[details.issue]) : undefined],
-    ['参考号', details.referenceId], ['发生时间', details.occurredAt], ['插件版本', details.pluginVersion],
-  ].filter(([, text]) => text !== undefined && text !== '');
-  return h('div', { className: 'dxw-summary dim-cardSummary', 'data-weixin-diagnostic': true, role: warning ? 'status' : undefined },
-    h('p', null, error.message),
-    details.hint ? h('p', null, details.hint) : null,
-    h('details', { style: { marginTop: 8 } },
-      h('summary', { style: { cursor: 'pointer' } }, '诊断详情'),
-      h('dl', { style: { display: 'grid', gridTemplateColumns: 'auto minmax(0, 1fr)', gap: '4px 12px', margin: '10px 0' } },
-        ...fields.flatMap(([label, text]) => [h('dt', { key: `${label}-label` }, label),
-          React.createElement('dd', { key: label, style: { margin: 0, overflowWrap: 'anywhere' } }, String(text))])),
-      !details.referenceId ? h('p', null, '未取得 Host 诊断参考号。') : null,
-      h('div', { className: 'dim-viewActions' },
-        h('button', { type: 'button', className: 'dxw-button', onClick: copy }, copyState === 'copied' ? '诊断信息已复制' : '复制诊断信息')),
-      copyState === 'manual' ? h('div', null,
-        h('p', null, '无法访问剪贴板，请选择并复制以下诊断信息。'),
-        React.createElement('textarea', { readOnly: true, value: formatWeixinDiagnostic(error), rows: 7,
-          'aria-label': localizeText('诊断信息'), style: { width: '100%', boxSizing: 'border-box', marginTop: 8 } })) : null));
-}
+export { ConnectionError as WeixinConnectionError, formatConnectionDiagnostic as formatWeixinDiagnostic, provisioningErrorTitle } from '../../connection-error.js';

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

@@ -1,3 +1,4 @@
+import { diagnosticFields } from '../../../../src/channels/shared/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
 import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
@@ -52,6 +53,7 @@ export function unwrapRpcResult(result) {
   if (!result.ok) {
     const error = new Error(text(result.error?.message, 'WhatsApp 操作失败'));
     error.code = text(result.error?.code, 'WHATSAPP_RPC_ERROR', 80);
+    Object.assign(error, diagnosticFields(result.error));
     throw error;
   }
   return result.value;
@@ -79,6 +81,7 @@ export function normalizeProvisioning(value, now = Date.now()) {
   if (qrCodeDataUrl) result.qrCodeDataUrl = qrCodeDataUrl;
   if (id(source.botId)) result.botId = id(source.botId);
   if (isRecord(source.error)) result.error = {
+    ...diagnosticFields(source.error),
     code: text(source.error.code, 'WHATSAPP_PROVISION_FAILED', 80),
     message: text(source.error.message, 'WhatsApp 没有接入完成'),
   };
@@ -112,6 +115,7 @@ function normalizeBot(value) {
     },
     lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error) ? {
+      ...diagnosticFields(value.error),
       code: text(value.error.code, 'WHATSAPP_ACCOUNT_ERROR', 80),
       message: text(value.error.message, 'WhatsApp 连接尚未就绪'),
     } : null,
@@ -136,6 +140,7 @@ export function normalizeSnapshot(value) {
 
 export function presentError(error) {
   return {
+    ...diagnosticFields(error),
     code: text(error?.code, 'WHATSAPP_ERROR', 80),
     message: text(error?.message, 'WhatsApp 操作失败，请稍后重试'),
   };

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

@@ -1,3 +1,4 @@
+import { ConnectionError, normalizeConnectionError } from '../../connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
@@ -168,7 +169,7 @@ export function ProvisionView({ provision, busy, onRetry, onClose }) {
   return h('div', { className: 'ddt-card dim-surfaceCard' },
     h('div', { className: 'ddt-inlineError dim-inlineError', role: 'alert' },
       h('h3', null, 'WhatsApp 没有接入完成'),
-      h('p', null, error.message),
+      h(ConnectionError, { error: error }),
       h('span', { className: 'ddt-errorCode' }, error.code),
       h('div', { className: 'ddt-actions dim-viewActions' },
         h(Button, { kind: 'primary', onClick: onRetry, disabled: busy }, '重新生成二维码'),
@@ -268,6 +269,7 @@ export function WhatsappAccountCard({
               className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy),
             }, '移除接入')),
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
+          account.error ? h(ConnectionError, { error: account.error, showMessage: false }) : null,
           account.lastMessageError ? h(LastMessageErrorSummary, {
             className: 'ddt-summary',
             error: account.lastMessageError,
@@ -287,6 +289,7 @@ export function WhatsappAccountCard({
 }
 
 export function WhatsappSettingsTab({ rpcCall }) {
+  const [operationError, setOperationError] = React.useState(null);
   const [model, setModel] = React.useState({
     phase: 'loading', bots: [], totals: { configured: 0, connected: 0 }, error: null,
     agentPresetCatalog: EMPTY_AGENT_PRESET_CATALOG,
@@ -315,7 +318,16 @@ export function WhatsappSettingsTab({ rpcCall }) {
 
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
     if (typeof rpcCall !== 'function') throw new TypeError('WhatsApp 设置页缺少 RPC 连接');
-    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+    const operation = !['connection.status', 'provision.poll', 'provision.begin', 'provision.cancel'].includes(endpoint);
+      if (operation && mounted.current) setOperationError(null);
+      try {
+        const value = unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+        if (operation && mounted.current) setOperationError(value?.testMessage?.error ?? value?.warnings?.[0] ?? null);
+        return value;
+      } catch (error) {
+        if (operation && mounted.current && !signal?.aborted && error?.name !== 'AbortError') setOperationError(normalizeConnectionError(error));
+        throw error;
+      }
   }, [rpcCall]);
 
   const loadStatus = React.useCallback(async ({ signal, silent = false, restore = false } = {}) => {
@@ -558,6 +570,7 @@ export function WhatsappSettingsTab({ rpcCall }) {
     className: 'ddt-page dwa-page dim-channelPage',
     'aria-label': 'WhatsApp 设置',
   },
+    operationError ? h(ConnectionError, { error: operationError }) : null,
   h(Heading, {
     totals: model.totals,
     busy,
@@ -570,7 +583,7 @@ export function WhatsappSettingsTab({ rpcCall }) {
       ? h('div', { className: 'ddt-card dim-surfaceCard' },
           h('div', { className: 'ddt-inlineError dim-inlineError' },
             h('h3', null, '无法读取 WhatsApp 机器人状态'),
-            h('p', null, model.error?.message),
+            h(ConnectionError, { error: model.error }),
             h(Button, { onClick: () => void loadStatus() }, '重新读取')))
       : h(React.Fragment, null,
           provision?.status === 'pending'

package/plugin-src/client/connection-error.js

@@ -0,0 +1,87 @@
+import * as React from 'react';
+import { h, localizeText } from './i18n.js';
+import { normalizeDiagnosticDetails } from '../../src/channels/shared/diagnostic-details.mjs';
+import { CONFIG_ISSUE_LABELS } from '../../src/channels/shared/diagnostic-details.mjs';
+
+const STAGE_LABELS = {
+  'credential.verify': '验证凭据', 'permission.check': '检查权限', 'sdk.load': '加载渠道组件',
+  operation: '执行渠道操作', 'message.receive': '接收消息', 'message.send': '发送消息', 'connection.test': '发送测试消息',
+  'startup.load': '加载渠道配置', 'qr.begin': '申请二维码', 'qr.encode': '生成二维码图片', 'qr.poll': '查询扫码状态',
+  'qr.verify': '提交配对码', 'qr.cancel': '取消绑定', 'credential.read': '读取登录凭据', 'credential.save': '保存登录凭据',
+  'credential.remove': '移除登录凭据', 'account.save': '保存账号配置', 'account.remove': '移除账号配置',
+  'state.load': '读取账号状态', 'state.write': '保存账号状态', 'state.cleanup': '清理账号状态',
+  'workspace.write': '保存工作区设置', 'workspace.cleanup': '清理工作区设置', 'runtime.prepare': '准备消息连接',
+  activation: '激活账号', 'harness.check': '检查 DSH 宿主', 'connection.start': '启动连接',
+  'connection.poll': '监测连接与消息', 'connection.stop': '停止连接', 'status.read': '读取连接状态',
+  rollback: '恢复原账号状态', 'management.request': '访问 DSH 管理接口',
+};
+
+export function provisioningErrorTitle(error) {
+  const stage = error?.details?.stage;
+  if (stage === 'qr.begin' || stage === 'qr.encode') return '无法生成微信二维码';
+  if (stage === 'qr.poll') return '查询微信扫码状态失败';
+  if (stage === 'management.request') return '无法完成微信管理请求';
+  return '微信没有绑定完成';
+}
+
+export function formatConnectionDiagnostic(value) {
+  const error = normalizeConnectionError(value);
+  const details = error.details ?? {};
+  return [
+    localizeText(error.message), details.hint ? localizeText(details.hint) : null,
+    localizeText('错误码') + ': ' + error.code,
+    ...['channel', 'operation', 'stage', 'reason', 'reasons', 'host', 'durationMs', 'timeoutMs', 'nodeVersion', 'dshVersion', 'platform', 'dependencies', 'proxyConfigured', 'truncated', 'httpStatus', 'providerCode', 'resource', 'file', 'field', 'issue', 'referenceId', 'occurredAt', 'rollback', 'pluginVersion']
+      .filter(field => details[field] !== undefined)
+      .map(field => `${field}: ${typeof details[field] === 'object' ? JSON.stringify(details[field]) : details[field]}`),
+  ].filter(Boolean).join('\n');
+}
+
+export function ConnectionError({ error: value, warning = false, showMessage = true }) {
+  const error = normalizeConnectionError(value);
+  const details = error.details ?? {};
+  const isWarning = warning || error.code.endsWith('cleanup-failed');
+  const [copyState, setCopyState] = React.useState(null);
+  React.useEffect(() => setCopyState(null), [details.referenceId, error.code, error.message]);
+  const copy = async () => {
+    try {
+      if (typeof globalThis.navigator?.clipboard?.writeText !== 'function') throw new Error('clipboard unavailable');
+      await globalThis.navigator.clipboard.writeText(formatConnectionDiagnostic(error));
+      setCopyState('copied');
+    } catch { setCopyState('manual'); }
+  };
+  const fields = [
+    ['错误码', error.code], ['失败阶段', localizeText(STAGE_LABELS[details.stage] ?? details.stage ?? '')],
+    ['底层原因', details.reason === 'unknown' ? localizeText('暂未识别') : details.reason], ['多个原因', details.reasons?.join(', ')], ['服务域名', details.host], ['请求耗时（毫秒）', details.durationMs], ['超时阈值（毫秒）', details.timeoutMs], ['Node 版本', details.nodeVersion], ['DSH 版本', details.dshVersion], ['依赖版本', details.dependencies ? Object.entries(details.dependencies).map(([name, version]) => `${name}: ${version}`).join(', ') : undefined], ['代理已配置', details.proxyConfigured], ['原因链已截断', details.truncated], ['运行平台', details.platform], ['HTTP 状态', details.httpStatus], ['服务返回码', details.providerCode],
+    ['配置文件', details.file], ['配置字段', details.field],
+    ['校验原因', details.issue ? localizeText(CONFIG_ISSUE_LABELS[details.issue]) : undefined],
+    ['参考号', details.referenceId], ['发生时间', details.occurredAt], ['插件版本', details.pluginVersion],
+  ].filter(([, text]) => text !== undefined && text !== '');
+  return h('div', { className: 'dim-connectionDiagnostic', 'data-connection-diagnostic': true, 'data-weixin-diagnostic': details.channel === 'weixin' || /^WX-CONN/.test(details.referenceId ?? '') || undefined, role: isWarning ? 'status' : undefined, 'data-warning': isWarning || undefined },
+    showMessage ? h('p', null, error.message) : null,
+    details.hint ? h('p', null, details.hint) : null,
+    h('details', { style: { marginTop: 8 } },
+      h('summary', { style: { cursor: 'pointer' } }, '诊断详情'),
+      h('dl', { style: { display: 'grid', gridTemplateColumns: 'auto minmax(0, 1fr)', gap: '4px 12px', margin: '10px 0' } },
+        ...fields.flatMap(([label, text]) => [h('dt', { key: `${label}-label` }, label),
+          React.createElement('dd', { key: label, style: { margin: 0, overflowWrap: 'anywhere' } }, String(text))])),
+      !details.referenceId ? h('p', null, '未取得 Host 诊断参考号。') : null,
+      h('div', { className: 'dim-viewActions' },
+        h('button', { type: 'button', className: 'dxw-button', onClick: copy }, copyState === 'copied' ? '诊断信息已复制' : '复制诊断信息')),
+      copyState === 'manual' ? h('div', null,
+        h('p', null, '无法访问剪贴板，请选择并复制以下诊断信息。'),
+        React.createElement('textarea', { readOnly: true, value: formatConnectionDiagnostic(error), rows: 7,
+          'aria-label': localizeText('诊断信息'), style: { width: '100%', boxSizing: 'border-box', marginTop: 8 } })) : null));
+}
+
+export function normalizeConnectionError(value, fallbackCode = 'operation-failed', fallbackMessage = '操作失败，请查看原因和诊断详情。') {
+  const source = value && typeof value === 'object' ? value : {};
+  const text = (v, fallback, n) => typeof v === 'string' && v.trim() ? v.trim().slice(0, n) : fallback;
+  const details = normalizeDiagnosticDetails({ ...source.details,
+    referenceId: source.details?.referenceId ?? source.referenceId,
+    hint: source.details?.hint ?? source.hint,
+  });
+  return { code: text(source.code, fallbackCode, 100), message: text(source.message, fallbackMessage, 500),
+    ...(Object.keys(details).length ? { details } : {}),
+    ...(source.hint ? { hint: details.hint } : {}), ...(source.referenceId ? { referenceId: details.referenceId } : {}),
+  };
+}

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

@@ -6,6 +6,7 @@ import {
   normalizeInboundTtlHours,
 } from '../../src/channels/shared/inbound-ttl.mjs';
 import { h } from './i18n.js';
+import { DEFAULT_IMAGE_INPUT_SETTINGS, normalizeImageInputSettings } from '../../src/channels/shared/image-input-policy.mjs';
 
 export const GLOBAL_SETTINGS_RPC_CHANNEL = '/dsh-im-settings';
 
@@ -18,6 +19,8 @@ export const GLOBAL_SETTINGS_ENDPOINTS = Object.freeze({
   getTtl: 'settings.inbound-ttl.get',
   setTtl: 'settings.inbound-ttl.set',
   sweep: 'settings.inbound-ttl.sweep',
+  getImages: 'settings.image-input.get',
+  setImages: 'settings.image-input.set',
 });
 
 function presentError(error, fallback) {
@@ -56,6 +59,82 @@ function GlobalButton({ children, kind = 'secondary', className = '', ...props }
   }, children);
 }
 
+export function ImageInputSettings({ rpcCall }) {
+  const [values, setValues] = React.useState(DEFAULT_IMAGE_INPUT_SETTINGS);
+  const [phase, setPhase] = React.useState('loading');
+  const [error, setError] = React.useState(null);
+  const [saved, setSaved] = React.useState(false);
+  const mounted = React.useRef(false);
+  const saving = React.useRef(false);
+  const id = React.useId();
+  const load = React.useCallback(async (signal) => {
+    setPhase('loading');
+    setError(null);
+    try {
+      const result = unwrapRpcResult(await rpcCall(GLOBAL_SETTINGS_ENDPOINTS.getImages, {}, signal));
+      if (signal?.aborted || !mounted.current) return;
+      const settings = normalizeImageInputSettings(result);
+      if (!settings) throw new Error('通用设置返回了无法识别的响应。');
+      setValues(settings);
+      setPhase('ready');
+    } catch (caught) {
+      if (signal?.aborted || !mounted.current) return;
+      setError(presentError(caught, '无法读取或保存图片设置，请稍后重试。'));
+      setPhase('error');
+    }
+  }, [rpcCall]);
+  React.useEffect(() => {
+    mounted.current = true;
+    const controller = new AbortController();
+    void load(controller.signal);
+    return () => { mounted.current = false; controller.abort(); };
+  }, [load]);
+  const save = async (event) => {
+    event.preventDefault();
+    if (saving.current || phase !== 'ready') return;
+    const settings = normalizeImageInputSettings(values);
+    setSaved(false);
+    if (!settings) {
+      setError('图片限制无效：请输入正整数，原图接收上限和总量上限不能小于单图上限。');
+      return;
+    }
+    saving.current = true;
+    setPhase('saving');
+    setError(null);
+    try {
+      const result = unwrapRpcResult(await rpcCall(GLOBAL_SETTINGS_ENDPOINTS.setImages, settings));
+      if (!normalizeImageInputSettings(result)) throw new Error('通用设置返回了无法识别的响应。');
+      if (mounted.current) { setValues(result); setSaved(true); }
+    } catch (caught) {
+      if (mounted.current) setError(presentError(caught, '无法读取或保存图片设置，请稍后重试。'));
+    } finally {
+      saving.current = false;
+      if (mounted.current) setPhase('ready');
+    }
+  };
+  const fields = [
+    ['maxDownloadMb', '原图接收上限 (MB)'],
+    ['maxImageMb', '模型单图上限 (MB)'],
+    ['maxTotalMb', '模型图片总量上限 (MB)'],
+    ['maxImages', '每条消息最多图片数'],
+  ];
+  return h('section', { className: 'dim-globalSection', 'aria-label': '图片输入', 'aria-busy': phase === 'loading' || phase === 'saving' },
+    h('h3', null, '图片输入'),
+    h('p', null, '适用于支持图片的聊天渠道。原图按附件保留时长保存，发送给模型的副本会自动缩放或压缩；无法直接发送时交给模型按文件处理。'),
+    h('form', { onSubmit: save },
+      ...fields.map(([key, label]) => h('div', { className: 'dim-globalTtlRow', key },
+        h('label', { htmlFor: `${id}-${key}` }, label),
+        h('input', { id: `${id}-${key}`, className: 'dim-globalTtlInput', type: 'number', min: 1, step: 1,
+          value: values[key], disabled: phase !== 'ready',
+          onChange: (event) => { setValues((current) => ({ ...current, [key]: event.target.value })); setSaved(false); setError(null); },
+        }))),
+      h(GlobalButton, { type: 'submit', kind: 'primary', disabled: phase !== 'ready' }, phase === 'saving' ? '保存中…' : '保存图片设置'),
+      phase === 'error' ? h(GlobalButton, { onClick: () => void load() }, '重试') : null),
+    error ? h('p', { role: 'alert' }, error) : null,
+    saved ? h('p', { role: 'status' }, '已保存') : null,
+    phase === 'loading' ? h('p', { role: 'status' }, '正在读取图片设置…') : null);
+}
+
 export function GlobalSettingsPanel({ rpcCall }) {
   const [phase, setPhase] = React.useState('loading');
   const [loadError, setLoadError] = React.useState(null);
@@ -337,5 +416,6 @@ export function GlobalSettingsPanel({ rpcCall }) {
           role: inlineStatus.role,
           'aria-live': inlineStatus.role === 'status' ? 'polite' : undefined,
         }, inlineStatus.message)
-        : null))));
+        : null)),
+    h(ImageInputSettings, { rpcCall })));
 }

package/plugin-src/client/i18n.js

@@ -1,3 +1,5 @@
+import imageInput from '../../src/channels/shared/i18n-en/image-input.mjs';
+import diagnostics from '../../src/channels/shared/i18n-en/diagnostics.mjs';
 import weixinDiagnostics from '../../src/channels/weixin/connection-error.en.mjs';
 import * as React from 'react';
 
@@ -5,6 +7,8 @@ export const IM_LOCALE_NAMESPACE = 'dsh-im';
 
 const EN = Object.freeze({
   ...weixinDiagnostics,
+  ...diagnostics,
+  ...imageInput,
   '$locale': 'en',
   '修改别名': 'Edit alias',
   '关闭修改别名': 'Close alias editor',
@@ -1005,6 +1009,63 @@ const EN = Object.freeze({
   '企业微信应用操作失败，请稍后重试': 'The WeCom app operation failed; try again later',
   '企业微信应用服务返回了无法识别的响应': 'The WeCom app service returned an unrecognized response',
   '企业微信应用服务没有返回有效的机器人列表': 'The WeCom app service did not return a valid bot list',
+  '邮箱': 'Email',
+  ' IMAP/SMTP 邮箱': ' IMAP/SMTP mailbox',
+  'QQ 邮箱': 'QQ Mail',
+  '163 邮箱': '163 Mail',
+  '自定义服务器': 'Custom servers',
+  '在 QQ 邮箱「设置 → 账户」中开启 IMAP/SMTP 服务，并生成 16 位授权码（不是登录密码）。': 'In QQ Mail open Settings → Account, enable IMAP/SMTP, and generate a 16-character authorization code (not your login password).',
+  '在 163 邮箱「设置 → POP3/SMTP/IMAP」中开启服务，并新增授权密码。': 'In 163 Mail open Settings → POP3/SMTP/IMAP, enable the service, and add an authorization password.',
+  '需要先开启两步验证，再生成「应用专用密码」。': 'Enable two-step verification first, then generate an app-specific password.',
+  '请填写邮箱服务商提供的 IMAP 与 SMTP 服务器地址及端口。': 'Enter the IMAP and SMTP host and port provided by your mail provider.',
+  '接入邮箱': 'Connect a mailbox',
+  'DeepSeek Harness 会读取该邮箱的新邮件作为指令，并在同一邮件线程内回复处理结果。': 'DeepSeek Harness reads new mail in this mailbox as instructions and replies with the result inside the same mail thread.',
+  '邮箱服务商': 'Mail provider',
+  '邮箱地址': 'Email address',
+  '应用密码 / 授权码': 'App password / authorization code',
+  'IMAP/SMTP 授权码': 'IMAP/SMTP authorization code',
+  '不是邮箱登录密码；请在邮箱设置中单独生成。': 'This is not your login password; generate it separately in your mailbox settings.',
+  'IMAP 服务器': 'IMAP server',
+  '端口': 'Port',
+  'SMTP 服务器': 'SMTP server',
+  '允许的发件人': 'Allowed senders',
+  'me@example.com\\n同事@example.com': 'me@example.com\\ncolleague@example.com',
+  '必填。只有这些地址发来的邮件会触发 Harness；多个地址用换行或逗号分隔。': 'Required. Only mail from these addresses triggers the Harness; separate multiple addresses with newlines or commas.',
+  '正在连接邮箱…': 'Connecting the mailbox…',
+  '连接邮箱': 'Connect mailbox',
+  '保存后会重新连接邮箱以使设置立即生效。': 'Saving reconnects the mailbox so the change takes effect immediately.',
+  '使用现有邮箱收发指令：邮件进来触发 Harness，处理结果以回信形式送达。': 'Use an existing mailbox to send instructions: incoming mail triggers the Harness and the result is delivered as a reply.',
+  '配置邮箱收发': 'Configure email send and receive',
+  '配置邮箱': 'Configure mailbox',
+  '邮箱配置': 'Mailbox configuration',
+  '会话绑定': 'Session binding',
+  '会话绑定已保存。': 'Session binding saved.',
+  '不绑定则每封新邮件开启一个新会话；绑定固定会话后，来信都在该会话内继续。': 'With no binding every new mail starts a new session; with a fixed session, incoming mail continues in that session.',
+  '固定会话（账号级）': 'Fixed session (account level)',
+  '不绑定（每封新邮件新建会话）': 'No binding (new session per mail)',
+  '按发件人覆盖（优先于账号级）': 'Per-sender override (takes priority)',
+  '跟随账号级': 'Follow the account setting',
+  '尚无可覆盖的发件人（先在上方配置允许的发件人）。': 'No senders to override yet (configure allowed senders above first).',
+  '保存绑定': 'Save binding',
+  '清除绑定': 'Clear binding',
+  '所有发件人同上': 'Point every sender at the same session',
+  '已选：': 'Selected: ',
+  '接入方式': 'Access method',
+  '生成授权链接': 'Generate authorization link',
+  '重新生成': 'Regenerate',
+  '授权链接': 'Authorization link',
+  '配对码': 'Pairing code',
+  '等待授权中…': 'Waiting for authorization…',
+  '等待授权中，': 'Waiting for authorization — valid for ',
+  ' 分钟': ' minutes',
+  '内有效，可保持本页打开。': '; you can keep this page open.',
+  '授权成功，正在接入邮箱…': 'Authorized; connecting the mailbox…',
+  '授权成功；请填写邮箱地址与允许的发件人后完成接入。': 'Authorized. Enter the mailbox address and at least one allowed sender to finish connecting.',
+  '授权后自动填入': 'Filled in after authorization',
+  '由授权结果自动填入，无需手工填写。': 'Filled in from the authorization; no need to type it.',
+  '刷新会话列表': 'Refresh the session list',
+  '腾讯 Agent 邮箱需要微信扫码授权。点下面的按钮生成授权链接，在打开的页面里用微信扫码登录并确认。': 'The Tencent Agent mailbox authorizes with a WeChat QR code. Generate an authorization link, then scan it with WeChat on the page that opens and confirm.',
+  '请求失败': 'The request failed',
 });
 
 export const en = EN;