@xmanrui/dsh-im 4.18.1 → 4.19.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.18.1",
+  "version": "4.19.1",
   "description": "把十一种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect eleven IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

package/plugin-src/client/bot-alias.js

@@ -0,0 +1,169 @@
+import * as React from 'react';
+import { createPortal } from 'react-dom';
+import { MAX_BOT_ALIAS_LENGTH, validateBotAlias } from '../../src/channels/shared/bot-alias.mjs';
+import { h } from './i18n.js';
+
+function AliasDialog({ bot, onSave, onClose }) {
+  const id = React.useId();
+  const dialogRef = React.useRef(null);
+  const inputRef = React.useRef(null);
+  const savingRef = React.useRef(false);
+  const [draft, setDraft] = React.useState(bot.alias ?? '');
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  React.useEffect(() => {
+    const previous = globalThis.document?.activeElement;
+    dialogRef.current?.showModal?.();
+    inputRef.current?.focus?.();
+    inputRef.current?.select?.();
+    return () => { if (previous?.isConnected) previous.focus?.(); };
+  }, []);
+  const close = () => { if (!savingRef.current) onClose(); };
+  const save = async (value) => {
+    if (savingRef.current) return;
+    setError(null);
+    try {
+      const alias = validateBotAlias(value);
+      if (alias === (bot.alias ?? '')) { onClose(); return; }
+      savingRef.current = true;
+      setSaving(true);
+      await onSave(alias);
+      onClose();
+    } catch (cause) {
+      setError(cause?.message ?? '别名保存失败，请重试。');
+    } finally {
+      savingRef.current = false;
+      setSaving(false);
+    }
+  };
+  const content = h('dialog', {
+    ref: dialogRef, className: 'dim-aliasDialog', 'aria-labelledby': `${id}-title`,
+    'aria-busy': saving,
+    onCancel: (event) => { event.preventDefault(); close(); },
+    onClick: (event) => event.stopPropagation(),
+    onKeyDown: (event) => event.stopPropagation(),
+  },
+  h('div', { className: 'dim-aliasHeader' },
+    h('h3', { id: `${id}-title` }, '修改别名'),
+    h('button', { type: 'button', className: 'dim-aliasClose', disabled: saving,
+      'aria-label': '关闭修改别名', onClick: close }, '×')),
+  h('div', { className: 'dim-aliasOriginal' }, h('span', null, '原名称'),
+    h('span', null, bot.originalName ?? bot.name)),
+  h('label', { htmlFor: `${id}-input` }, '别名'),
+  h('input', { id: `${id}-input`, ref: inputRef, value: draft, disabled: saving,
+    maxLength: MAX_BOT_ALIAS_LENGTH, placeholder: '例如：客服助手',
+    'aria-describedby': `${id}-help`,
+    onChange: (event) => setDraft(event.target.value),
+    onKeyDown: (event) => {
+      if (event.key === 'Enter' && !event.nativeEvent?.isComposing) {
+        event.preventDefault(); void save(draft);
+      }
+    },
+  }),
+  h('p', { id: `${id}-help`, className: 'dim-aliasHelp' }, '仅更改显示名称，留空则显示原名称。'),
+  error ? h('p', { className: 'dim-aliasError', role: 'alert' }, error) : null,
+  h('div', { className: 'dim-aliasFooter' },
+    h('button', { type: 'button', className: 'dim-aliasRestore',
+      disabled: saving || !bot.alias, onClick: () => void save('') }, '恢复原名称'),
+    h('div', { className: 'dim-aliasActions' },
+      h('button', { type: 'button', disabled: saving, onClick: close }, '取消'),
+      h('button', { type: 'button', className: 'dim-aliasSave', disabled: saving,
+        onClick: () => void save(draft) }, saving ? '保存中…' : '保存'))));
+  return globalThis.document?.body ? createPortal(content, document.body) : content;
+}
+
+function BotNameTooltip({ anchorRef, id, name, onDismiss }) {
+  const tooltipRef = React.useRef(null);
+  const [position, setPosition] = React.useState(null);
+  React.useLayoutEffect(() => {
+    const anchor = anchorRef.current;
+    const tooltip = tooltipRef.current;
+    if (!anchor || !tooltip) return undefined;
+    const document = anchor.ownerDocument;
+    const view = document.defaultView;
+    const place = () => {
+      const rect = anchor.getBoundingClientRect();
+      const { width, height } = tooltip.getBoundingClientRect();
+      const viewport = document.documentElement;
+      const margin = 8;
+      const below = rect.bottom + 6;
+      setPosition({
+        left: Math.max(margin, Math.min(rect.left, viewport.clientWidth - width - margin)),
+        top: Math.max(margin, Math.min(
+          below + height <= viewport.clientHeight - margin ? below : rect.top - height - 6,
+          viewport.clientHeight - height - margin,
+        )),
+      });
+    };
+    const dismiss = (event) => {
+      if (event.key === 'Escape') { event.stopPropagation(); onDismiss(); }
+    };
+    place();
+    view.addEventListener('resize', place);
+    // Capture nested scrolling containers as well as page scrolling.
+    document.addEventListener('scroll', onDismiss, true);
+    document.addEventListener('keydown', dismiss, true);
+    return () => {
+      view.removeEventListener('resize', place);
+      document.removeEventListener('scroll', onDismiss, true);
+      document.removeEventListener('keydown', dismiss, true);
+    };
+  }, [anchorRef, name, onDismiss]);
+  const body = anchorRef.current?.ownerDocument.body;
+  return body ? createPortal(h('span', {
+    ref: tooltipRef, id, role: 'tooltip', className: 'dim-botNameTooltip',
+    style: position ?? { visibility: 'hidden' },
+  }, name), body) : null;
+}
+
+export function BotName({ bot, id, disabled = false, onSave }) {
+  const [open, setOpen] = React.useState(false);
+  const nameRef = React.useRef(null);
+  const tooltipId = React.useId();
+  const [truncated, setTruncated] = React.useState(false);
+  const [hovered, setHovered] = React.useState(false);
+  const [focused, setFocused] = React.useState(false);
+  const [dismissed, setDismissed] = React.useState(false);
+  const dismissTooltip = React.useCallback(() => setDismissed(true), []);
+  const measure = React.useCallback(() => {
+    const node = nameRef.current;
+    setTruncated(Boolean(node && node.scrollWidth > node.clientWidth));
+  }, []);
+  React.useEffect(() => {
+    const node = nameRef.current;
+    if (!node) return undefined;
+    measure();
+    const view = node.ownerDocument.defaultView;
+    const observer = view.ResizeObserver ? new view.ResizeObserver(measure) : null;
+    observer?.observe(node);
+    view.addEventListener('resize', measure);
+    return () => { observer?.disconnect(); view.removeEventListener('resize', measure); };
+  }, [bot.name, measure]);
+  const showTooltip = truncated && !dismissed && !open && (hovered || focused);
+  return h('div', { className: 'dim-aliasName' },
+    h('h3', {
+      id, ref: nameRef, tabIndex: truncated ? 0 : undefined,
+      'aria-describedby': showTooltip ? tooltipId : undefined,
+      onMouseEnter: () => { measure(); setHovered(true); setDismissed(false); },
+      onMouseLeave: () => setHovered(false),
+      onFocus: () => { measure(); setFocused(true); setDismissed(false); },
+      onBlur: () => setFocused(false),
+      onClick: dismissTooltip,
+    }, bot.name),
+    showTooltip ? h(BotNameTooltip, {
+      anchorRef: nameRef, id: tooltipId, name: bot.name, onDismiss: dismissTooltip,
+    }) : null,
+    h('span', {
+      className: 'dim-aliasEntry',
+      onClick: (event) => event.stopPropagation(),
+      onKeyDown: (event) => event.stopPropagation(),
+    },
+    h('button', { type: 'button', className: 'dim-aliasEdit',
+      'aria-label': '修改别名', title: '修改别名', 'aria-haspopup': 'dialog',
+      disabled: disabled || typeof onSave !== 'function', onClick: () => setOpen(true) },
+    h('svg', { width: 14, height: 14, viewBox: '0 0 24 24', fill: 'none',
+      stroke: 'currentColor', strokeWidth: 1.7, strokeLinecap: 'round', strokeLinejoin: 'round',
+      'aria-hidden': true },
+    h('path', { d: 'm16 3 5 5M3 21l5-1L21 7a2.1 2.1 0 0 0-5-5L3 15Z' }))),
+    open ? h(AliasDialog, { bot, onSave, onClose: () => setOpen(false) }) : null));
+}

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -19,6 +20,7 @@ export const DINGTALK_ENDPOINTS = Object.freeze({
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
 });
 
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
@@ -190,6 +192,7 @@ function normalizeBot(value) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     bot: {
+      ...normalizeBotAlias(bot),
       name: optionalString(bot.name, 100) ?? '钉钉机器人',
       clientIdMasked: optionalString(bot.clientIdMasked, 140) ?? '已安全保存',
     },

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { CredentialActionIcon, CredentialBindingPanel, QrActionIcon } from '../../credential-binding.js';
@@ -244,6 +245,7 @@ export function AccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -263,7 +265,7 @@ export function AccountCard({
         h('div', { className: 'ddt-accountIdentity dim-botIdentity' },
           h('div', { className: 'ddt-avatar dim-botAvatar', 'aria-hidden': 'true' }, h(DingtalkIcon, { size: 29 })),
           h('div', { className: 'dim-botName' },
-            h('h3', { title: account.bot.name }, account.bot.name),
+            h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }),
             h('p', { title: account.bot.clientIdMasked }, account.bot.clientIdMasked))),
         h('div', {
             className: 'dim-botCardTools',
@@ -349,6 +351,7 @@ function AccountList(props) {
         removing: props.removeTarget === account.botId,
         onReconnect: () => props.onReconnect(account),
         onWorkspaceSave: (workspace) => props.onWorkspaceSave(account, workspace),
+        onAliasSave: (alias) => props.onAliasSave(account, alias),
         onModelSave: (model) => props.onModelSave(account, model),
         onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(account, agentPreset),
         onContextEnhancementSave: (config) => props.onContextEnhancementSave(account, config),
@@ -928,6 +931,9 @@ export function DingtalkSettingsTab({ rpcCall }) {
                   removeTarget,
                   onReconnect: (account) => void reconnect(account),
                   onWorkspaceSave: saveWorkspace,
+                  onAliasSave: (account, alias) => saveBotSetting(
+                    account, 'alias', DINGTALK_ENDPOINTS.setAlias, { alias },
+                  ),
                   onModelSave: (account, selectedModel) => saveBotSetting(
                     account, 'model', DINGTALK_ENDPOINTS.setModel, { model: selectedModel },
                   ),

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

@@ -1,3 +1,4 @@
+import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 /**
  * Browser-safe contract for the Feishu Host plugin.
  *
@@ -31,6 +32,7 @@ export const FEISHU_ENDPOINTS = Object.freeze({
   setAgentPreset: "bot.preset.set",
   setContextEnhancement: "bot.context-enhancement.set",
   setAccessPolicy: "bot.access-policy.set",
+  setAlias: 'bot.alias.set',
   setGroupResponseMode: "bot.group-response-mode.set",
   setGroupTopicReply: "bot.group-topic-reply.set",
   setStepPush: "bot.step-push.set",
@@ -157,6 +159,7 @@ export function normalizeProvisioning(value, now = Date.now()) {
 function normalizeBot(value) {
   const source = isRecord(value) ? value : {};
   return {
+    ...normalizeBotAlias(source),
     name: optionalString(source.name) ?? "飞书机器人",
     avatarUrl: optionalString(source.avatarUrl),
     appIdMasked: optionalString(source.appIdMasked),

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from "react";
 
 import { FeishuLogoGlyph } from "../../channel-logos.js";
@@ -560,6 +561,7 @@ export function BotCard({
   onReconnect,
   onRepairCallback,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -600,7 +602,7 @@ export function BotCard({
             h("div", { className: "bxf-avatar dim-botAvatar", "aria-hidden": "true" },
               h(FeishuLogoGlyph, { size: 34 })),
             h("div", { className: "bxf-botName dim-botName" },
-              h("h3", { id: titleId, title: bot.name }, bot.name),
+              h(BotName, { bot, id: titleId, disabled: Boolean(busy), onSave: onAliasSave }),
               h("p", { title: bot.appIdMasked }, bot.appIdMasked ?? "应用标识已安全保存")),
           ),
           h("div", {
@@ -747,6 +749,7 @@ function BotList(props) {
           onReconnect: () => props.onReconnect(bot),
           onRepairCallback: () => props.onRepairCallback(bot),
           onWorkspaceSave: (workspace) => props.onWorkspaceSave(bot, workspace),
+          onAliasSave: (alias) => props.onAliasSave(bot, alias),
           onModelSave: (model) => props.onModelSave(bot, model),
           onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(bot, agentPreset),
           onContextEnhancementSave: (config) => props.onContextEnhancementSave(bot, config),
@@ -1517,6 +1520,9 @@ export function FeishuSettingsTab({ rpcCall }) {
                   onReconnect: (bot) => void reconnectOneBot(bot),
                   onRepairCallback: repairCallback,
                   onWorkspaceSave: saveWorkspace,
+                  onAliasSave: (connection, alias) => saveBotSetting(
+                    connection, 'alias', FEISHU_ENDPOINTS.setAlias, { alias },
+                  ),
                   onModelSave: (connection, selectedModel) => saveBotSetting(
                     connection, "model", FEISHU_ENDPOINTS.setModel, { model: selectedModel },
                   ),

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -19,6 +20,7 @@ export const QQ_ENDPOINTS = Object.freeze({
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
 });
 
 const PROVISION_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting', 'connected', 'failed', 'cancelled']);
@@ -99,6 +101,7 @@ function normalizeBot(value) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     bot: {
+      ...normalizeBotAlias(value.bot),
       name: text(value.bot?.name, 'QQ机器人', 100),
       appIdMasked: text(value.bot?.appIdMasked, '应用标识已安全保存', 140),
     },

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { QqLogoGlyph } from '../../channel-logos.js';
@@ -173,6 +174,7 @@ export function AccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -191,7 +193,7 @@ export function AccountCard({
         h('div', { className: 'ddt-accountIdentity dim-botIdentity' },
           h('div', { className: 'ddt-avatar dim-botAvatar dqq-avatar', 'aria-hidden': 'true' }, h(QqLogoGlyph, { size: 29 })),
           h('div', { className: 'dim-botName' },
-            h('h3', null, account.bot.name), h('p', null, account.bot.appIdMasked))),
+            h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }), h('p', null, account.bot.appIdMasked))),
         h('div', {
             className: 'dim-botCardTools',
             // The header is the collapse toggle; keep inner controls clickable.
@@ -504,6 +506,12 @@ export function QqSettingsTab({ rpcCall }) {
               QQ_ENDPOINTS.setWorkspace,
               { botId: account.botId, workspace },
             ),
+            onAliasSave: (alias) => botAction(
+              account,
+              'alias',
+              QQ_ENDPOINTS.setAlias,
+              { botId: account.botId, alias },
+            ),
             onModelSave: (selectedModel) => botAction(
               account,
               'model',

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -35,6 +36,7 @@ export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
 });
 
 export function createTokenChannelApi(channel, connectionSummary, {
@@ -69,6 +71,7 @@ export function createTokenChannelApi(channel, connectionSummary, {
         ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
         : {}),
       bot: {
+      ...normalizeBotAlias(value.bot),
         name: text(value.bot?.name, `${channel}机器人`, 100),
         username: text(value.bot?.username, '', 100),
         idMasked: text(value.bot?.idMasked, '机器人标识已安全保存', 140),

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { CredentialActionIcon, CredentialBindingPanel } from '../../credential-binding.js';
@@ -81,7 +82,7 @@ export function createTokenChannelSettings(definition) {
     accountSettingsEndpoint = null,
   } = definition;
 
-  function AccountCard({ account, busy, testNotice, removing, onReconnect, onWorkspaceSave, onModelSave, onAgentPresetSave, onContextEnhancementSave, onAccountSettingsSave, onRequestRemove, onConfirmRemove, onCancelRemove }) {
+  function AccountCard({ account, busy, testNotice, removing, onReconnect, onWorkspaceSave, onAliasSave, onModelSave, onAgentPresetSave, onContextEnhancementSave, onAccountSettingsSave, onRequestRemove, onConfirmRemove, onCancelRemove }) {
     const state = busy === 'reconnect' ? 'connecting' : account.state;
     const tone = account.connected ? 'success' : state === 'error' ? 'error' : 'warning';
     const stateLabel = account.connected ? '运行正常' : state === 'connecting' ? '正在连接' : '连接未就绪';
@@ -96,7 +97,7 @@ export function createTokenChannelSettings(definition) {
               h('div', { className: `ddt-avatar dim-botAvatar ${avatarClass}`, 'aria-hidden': 'true' },
                 h(LogoGlyph, { size: 29 })),
               h('div', { className: 'dim-botName' },
-                h('h3', null, account.bot.name), h('p', null, identity))),
+                h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }), h('p', null, identity))),
             h('div', {
               className: 'dim-botCardTools',
               // The header is the collapse toggle; keep inner controls clickable.
@@ -345,6 +346,12 @@ export function createTokenChannelSettings(definition) {
                 endpoints.setWorkspace,
                 { botId: account.botId, workspace },
               ),
+              onAliasSave: (alias) => botAction(
+                account,
+                'alias',
+                endpoints.setAlias,
+                { botId: account.botId, alias },
+              ),
               onModelSave: (selectedModel) => botAction(
                 account,
                 'model',

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -19,6 +20,7 @@ export const WECOM_ENDPOINTS = Object.freeze({
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
 });
 
 const PROVISION_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting', 'connected', 'failed', 'cancelled']);
@@ -108,6 +110,7 @@ function normalizeBot(value) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     bot: {
+      ...normalizeBotAlias(value.bot),
       name: text(value.bot?.name, '企业微信机器人', 100),
       appIdMasked: text(value.bot?.appIdMasked, '应用标识已安全保存', 140),
     },

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { WecomLogoGlyph } from '../../channel-logos.js';
@@ -172,6 +173,7 @@ export function AccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -190,7 +192,7 @@ export function AccountCard({
         h('div', { className: 'ddt-accountIdentity dim-botIdentity' },
           h('div', { className: 'ddt-avatar dim-botAvatar dwecom-avatar', 'aria-hidden': 'true' }, h(WecomLogoGlyph, { size: 29 })),
           h('div', { className: 'dim-botName' },
-            h('h3', null, account.bot.name), h('p', null, account.bot.appIdMasked))),
+            h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }), h('p', null, account.bot.appIdMasked))),
         h('div', {
             className: 'dim-botCardTools',
             // The header is the collapse toggle; keep inner controls clickable.
@@ -535,6 +537,12 @@ export function WecomSettingsTab({ rpcCall }) {
               WECOM_ENDPOINTS.setWorkspace,
               { botId: account.botId, workspace },
             ),
+            onAliasSave: (alias) => botAction(
+              account,
+              'alias',
+              WECOM_ENDPOINTS.setAlias,
+              { botId: account.botId, alias },
+            ),
             onModelSave: (selectedModel) => botAction(
               account,
               'model',

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -18,6 +19,7 @@ export const WECOM_APP_ENDPOINTS = Object.freeze({
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
 });
 
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
@@ -82,6 +84,7 @@ function normalizeBot(value) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     bot: {
+      ...normalizeBotAlias(value.bot),
       name: text(value.bot?.name, '企业微信应用', 100),
       corpIdMasked: text(value.bot?.corpIdMasked, '企业 ID 已保存', 140),
       agentId: text(value.bot?.agentId, '', 32),

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { WecomLogoGlyph } from '../../channel-logos.js';
@@ -246,6 +247,7 @@ export function AccountCard({
   onSettingsSave,
   onSecretReset,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -265,7 +267,7 @@ export function AccountCard({
         h('div', { className: 'ddt-accountIdentity dim-botIdentity' },
           h('div', { className: 'ddt-avatar dim-botAvatar dwecomapp-avatar', 'aria-hidden': 'true' }, h(WecomLogoGlyph, { size: 29 })),
           h('div', { className: 'dim-botName' },
-            h('h3', null, account.bot.name),
+            h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }),
             h('p', null, `${account.bot.corpIdMasked} · AgentId ${account.bot.agentId}`))),
         h('div', {
             className: 'dim-botCardTools',
@@ -552,6 +554,12 @@ export function WecomAppSettingsTab({ rpcCall }) {
               WECOM_APP_ENDPOINTS.setWorkspace,
               { botId: account.botId, workspace },
             ),
+            onAliasSave: (alias) => botAction(
+              account,
+              'alias',
+              WECOM_APP_ENDPOINTS.setAlias,
+              { botId: account.botId, alias },
+            ),
             onModelSave: (selectedModel) => botAction(
               account,
               'model',

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -18,6 +19,7 @@ export const WEIXIN_ENDPOINTS = Object.freeze({
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
   setContextEnhancement: 'bot.context-enhancement.set',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
 });
 
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
@@ -133,6 +135,7 @@ function normalizeBot(value) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     bot: {
+      ...normalizeBotAlias(value.bot),
       name: string(value.bot.name, '微信机器人'),
       accountIdMasked: string(value.bot.accountIdMasked, '已安全保存'),
     },

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { WeixinLogoGlyph } from '../../channel-logos.js';
@@ -214,6 +215,7 @@ export function AccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -231,7 +233,7 @@ export function AccountCard({
         header: h('div', { className: 'dxw-accountTop dim-botCardTop' },
         h('div', { className: 'dxw-accountIdentity dim-botIdentity' },
           h('div', { className: 'dxw-avatar dim-botAvatar', 'aria-hidden': 'true' }, h(WeixinLogoGlyph, { size: 27 })),
-          h('div', { className: 'dim-botName' }, h('h3', null, account.bot.name), h('p', null, account.bot.accountIdMasked))),
+          h('div', { className: 'dim-botName' }, h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }), h('p', null, account.bot.accountIdMasked))),
         h('div', {
             className: 'dim-botCardTools',
             // The header is the collapse toggle; keep inner controls clickable.
@@ -318,6 +320,7 @@ function AccountList(props) {
         removing: props.removeTarget === account.botId,
         onReconnect: () => props.onReconnect(account),
         onWorkspaceSave: (workspace) => props.onWorkspaceSave(account, workspace),
+        onAliasSave: (alias) => props.onAliasSave(account, alias),
         onModelSave: (model) => props.onModelSave(account, model),
         onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(account, agentPreset),
         onContextEnhancementSave: (config) => props.onContextEnhancementSave(account, config),
@@ -752,6 +755,9 @@ export function WeixinSettingsTab({ rpcCall }) {
                   removeTarget,
                   onReconnect: (account) => void reconnect(account),
                   onWorkspaceSave: saveWorkspace,
+                  onAliasSave: (account, alias) => saveBotSetting(
+                    account, 'alias', WEIXIN_ENDPOINTS.setAlias, { alias },
+                  ),
                   onModelSave: (account, selectedModel) => saveBotSetting(
                     account, 'model', WEIXIN_ENDPOINTS.setModel, { model: selectedModel },
                   ),

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

@@ -1,3 +1,4 @@
+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';
 import { normalizeLastMessageError } from '../../last-message-error.js';
@@ -14,6 +15,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setAccessPolicy: 'bot.access-policy.set',
+  setAlias: 'bot.alias.set',
   setWorkspace: 'bot.workspace.set',
   setModel: SET_MODEL_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
@@ -99,6 +101,7 @@ function normalizeBot(value) {
       ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
       : {}),
     bot: {
+      ...normalizeBotAlias(value.bot),
       name: text(value.bot?.name, 'WhatsApp机器人', 100),
       idMasked: text(value.bot?.idMasked, 'WhatsApp账号', 140),
     },

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

@@ -1,3 +1,4 @@
+import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
 import { WhatsappLogoGlyph } from '../../channel-logos.js';
@@ -191,6 +192,7 @@ export function WhatsappAccountCard({
   removing,
   onReconnect,
   onWorkspaceSave,
+  onAliasSave,
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
@@ -213,7 +215,7 @@ export function WhatsappAccountCard({
             'aria-hidden': 'true',
           }, h(WhatsappLogoGlyph, { size: 29 })),
           h('div', { className: 'dim-botName' },
-            h('h3', null, account.bot.name), h('p', null, account.bot.idMasked))),
+            h(BotName, { bot: account.bot, disabled: Boolean(busy), onSave: onAliasSave }), h('p', null, account.bot.idMasked))),
         h('div', {
             className: 'dim-botCardTools',
             // The header is the collapse toggle; keep inner controls clickable.
@@ -512,6 +514,12 @@ export function WhatsappSettingsTab({ rpcCall }) {
               WHATSAPP_ENDPOINTS.setWorkspace,
               { botId: account.botId, workspace },
             ),
+            onAliasSave: (alias) => botAction(
+              account,
+              'alias',
+              WHATSAPP_ENDPOINTS.setAlias,
+              { botId: account.botId, alias },
+            ),
             onModelSave: (selectedModel) => botAction(
               account,
               'model',