@xmanrui/dsh-im 4.18.0 → 4.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.18.0",
+  "version": "4.19.0",
   "description": "把十一种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect eleven IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
@@ -48,6 +48,10 @@
     {
       "name": "cherryFloris",
       "url": "https://github.com/cherryFloris"
+    },
+    {
+      "name": "geekyfoxlab",
+      "url": "https://github.com/geekyfoxlab"
     }
   ],
   "license": "MIT",

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

@@ -0,0 +1,92 @@
+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;
+}
+
+export function BotName({ bot, id, disabled = false, onSave }) {
+  const [open, setOpen] = React.useState(false);
+  return h('div', { className: 'dim-aliasName' },
+    h('h3', { id, title: bot.name }, bot.name),
+    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',

package/plugin-src/client/i18n.js

@@ -4,6 +4,16 @@ export const IM_LOCALE_NAMESPACE = 'dsh-im';
 
 const EN = Object.freeze({
   '$locale': 'en',
+  '修改别名': 'Edit alias',
+  '关闭修改别名': 'Close alias editor',
+  '原名称': 'Original name',
+  '别名': 'Alias',
+  '恢复原名称': 'Restore original name',
+  '例如：客服助手': 'e.g. Customer support',
+  '仅更改显示名称，留空则显示原名称。': 'Only changes the display name. Leave blank to use the original name.',
+  '别名保存失败，请重试。': 'Could not save the alias. Try again.',
+  '别名不能包含换行或控制字符，且最多 80 个字符。': 'Use at most 80 characters without line breaks or control characters.',
+  '请输入有效的别名（最多 80 个字符）。': 'Enter a valid alias (up to 80 characters).',
   ' macOS Messages 连接': ' macOS Messages connection',
   '接入 iMessage': 'Connect iMessage',
   '先在 macOS 系统设置中授予 Messages 权限。': 'Grant Messages permissions in macOS System Settings first.',

package/plugin-src/client/styles.js

@@ -1,6 +1,32 @@
 export const IM_STYLE_ID = 'xmanrui-dsh-im-settings';
 
 const CSS = String.raw`
+.dim-aliasName { display: flex; align-items: center; gap: 4px; min-width: 0; }
+.dim-aliasName h3 { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dim-aliasEntry { display: inline-flex; flex: none; }
+.dim-aliasEdit { display: grid; place-items: center; width: 28px; height: 28px; padding: 4px; border: 0; border-radius: 5px; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; cursor: pointer; }
+.dim-aliasEdit:hover:not(:disabled) { color: var(--dsw-alias-state-business-primary, #3370ff); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-aliasDialog { box-sizing: border-box; width: min(380px, calc(100% - 32px)); max-height: calc(100dvh - 32px); overflow-y: auto; padding: 22px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 12px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 12px 36px rgb(0 0 0 / 18%); font: 13px/1.5 -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }
+.dim-aliasDialog * { box-sizing: border-box; }
+.dim-aliasDialog::backdrop { background: rgb(15 17 21 / 30%); }
+.dim-aliasHeader { display: flex; justify-content: space-between; align-items: center; gap: 12px; margin-bottom: 18px; }
+.dim-aliasHeader h3 { margin: 0; font-size: 16px; }
+.dim-aliasDialog button { font: inherit; cursor: pointer; }
+.dim-aliasDialog .dim-aliasClose { width: 28px; height: 28px; padding: 0; border: 0; border-radius: 5px; background: transparent; color: var(--dsw-alias-label-secondary, #646a73); font-size: 20px; }
+.dim-aliasOriginal { display: flex; flex-wrap: wrap; gap: 6px 14px; padding: 10px 12px; margin-bottom: 18px; border-radius: 6px; background: var(--dsw-alias-bg-layer-2, #f5f6f7); overflow-wrap: anywhere; }
+.dim-aliasOriginal > span:first-child { flex: none; color: var(--dsw-alias-label-secondary, #646a73); }
+.dim-aliasDialog label { display: block; margin-bottom: 7px; }
+.dim-aliasDialog input { width: 100%; min-height: 38px; padding: 8px 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 6px; color: inherit; background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; }
+.dim-aliasHelp { margin: 8px 0 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; }
+.dim-aliasError { color: var(--dsw-alias-state-danger-primary, #c53030); overflow-wrap: anywhere; }
+.dim-aliasFooter { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 14px; margin-top: 24px; }
+.dim-aliasRestore { padding: 4px 0; border: 0; color: var(--dsw-alias-state-business-primary, #3370ff); background: transparent; }
+.dim-aliasActions { display: flex; gap: 8px; margin-left: auto; }
+.dim-aliasActions button { padding: 7px 14px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 6px; color: inherit; background: var(--dsw-alias-bg-layer-1, #fff); }
+.dim-aliasActions .dim-aliasSave { color: #fff; border-color: var(--dsw-alias-state-business-primary, #3370ff); background: var(--dsw-alias-state-business-primary, #3370ff); }
+.dim-aliasEdit:disabled, .dim-aliasDialog button:disabled, .dim-aliasDialog input:disabled { opacity: .55; cursor: not-allowed; }
+.dim-aliasEdit:focus-visible, .dim-aliasDialog button:focus-visible, .dim-aliasDialog input:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 2px; }
+@media (pointer: coarse) { .dim-aliasEdit, .dim-aliasDialog button { min-width: 44px; min-height: 44px; } .dim-aliasDialog input { font-size: 16px; } }
 .dim-page {
   --dim-blue: var(--dsw-alias-state-business-primary, #3370ff);
   --dim-blue-soft: color-mix(in srgb, var(--dim-blue) 9%, transparent);