@xmanrui/dsh-im 0.3.0 → 0.5.0

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

@@ -3,6 +3,8 @@ import * as React from 'react';
 import { CredentialActionIcon, CredentialBindingPanel } from '../../credential-binding.js';
 import { h } from '../../i18n.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
+import { WorkspaceEditor } from '../../workspace-editor.js';
+import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
 
 const Button = React.forwardRef(function Button(
   { children, kind = 'secondary', className = '', ...props },
@@ -51,7 +53,7 @@ export function createTokenChannelSettings(definition) {
     emptyActionLabel = '填写 Bot Token',
   } = definition;
 
-  function AccountCard({ account, busy, removing, onReconnect, onRequestRemove, onConfirmRemove, onCancelRemove }) {
+  function AccountCard({ account, busy, removing, onReconnect, onWorkspaceSave, 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' ? '正在连接' : '连接未就绪';
@@ -73,6 +75,11 @@ export function createTokenChannelSettings(definition) {
             h('dt', null, '消息通道'), h('dd', null, account.connected ? connectionLabel : '离线')),
           h('div', { className: 'ddt-metric dim-botMetric' },
             h('dt', null, '最近检查'), h('dd', null, checkedTime(account.health.lastCheckedAt)))),
+        h(WorkspaceEditor, {
+          workspace: account.workspace,
+          disabled: Boolean(busy),
+          onSave: onWorkspaceSave,
+        }),
         h('div', { className: 'ddt-accountFooter dim-cardFooter' },
           summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
           h('div', { className: 'ddt-actions dim-cardActions' },
@@ -106,6 +113,7 @@ export function createTokenChannelSettings(definition) {
     const [busyByBot, setBusyByBot] = React.useState({});
     const [removeTarget, setRemoveTarget] = React.useState(null);
     const mounted = React.useRef(true);
+    const workspaceFence = useWorkspaceSnapshotFence();
 
     React.useEffect(() => {
       const disposeDingtalk = installDingtalkStyles();
@@ -124,13 +132,17 @@ export function createTokenChannelSettings(definition) {
     }, [rpcCall]);
 
     const loadStatus = React.useCallback(async ({ signal, silent = false } = {}) => {
+      const workspaceVersion = workspaceFence.beginStatus();
+      if (workspaceVersion === null) return;
       if (!silent && mounted.current) setModel((current) => ({ ...current, phase: 'loading', error: null }));
       try {
         const snapshot = api.normalizeSnapshot(await invoke(endpoints.status, {}, signal));
-        if (!mounted.current || signal?.aborted) return;
+        if (!mounted.current || signal?.aborted
+          || !workspaceFence.canCommitStatus(workspaceVersion)) return;
         setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
       } catch (error) {
-        if (error?.name !== 'AbortError' && mounted.current && !signal?.aborted) {
+        if (error?.name !== 'AbortError' && mounted.current && !signal?.aborted
+          && workspaceFence.canCommitStatus(workspaceVersion)) {
           setModel((current) => ({
             ...current,
             phase: silent ? current.phase : 'error',
@@ -138,7 +150,7 @@ export function createTokenChannelSettings(definition) {
           }));
         }
       }
-    }, [invoke]);
+    }, [invoke, workspaceFence]);
 
     React.useEffect(() => {
       const controller = new AbortController();
@@ -160,6 +172,7 @@ export function createTokenChannelSettings(definition) {
     }, [loadStatus, model.phase]);
 
     const bindCredentials = React.useCallback(async (values) => {
+      const snapshotVersion = workspaceFence.beginMutation();
       setBusy(true);
       setCredentialError(null);
       try {
@@ -168,30 +181,37 @@ export function createTokenChannelSettings(definition) {
           credentialPayload(values),
         ));
         if (!mounted.current) return;
-        setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+        if (workspaceFence.canCommitMutation(snapshotVersion)) {
+          setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+        }
         setCredentialOpen(false);
       } catch (error) {
         if (mounted.current) setCredentialError(api.presentError(error));
       } finally {
+        const shouldRefresh = workspaceFence.endMutation();
+        if (shouldRefresh && mounted.current) void loadStatus({ silent: true });
         if (mounted.current) setBusy(false);
       }
-    }, [invoke]);
+    }, [invoke, loadStatus, workspaceFence]);
 
     const botAction = React.useCallback(async (account, operation, endpoint, payload) => {
+      const snapshotVersion = workspaceFence.beginMutation();
       setBusyByBot((current) => ({ ...current, [account.botId]: operation }));
       try {
         const snapshot = api.normalizeSnapshot(await invoke(endpoint, payload));
-        if (mounted.current) {
+        if (mounted.current && workspaceFence.canCommitMutation(snapshotVersion)) {
           setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
         }
       } finally {
+        const shouldRefresh = workspaceFence.endMutation();
+        if (shouldRefresh && mounted.current) void loadStatus({ silent: true });
         if (mounted.current) setBusyByBot((current) => {
           const next = { ...current };
           delete next[account.botId];
           return next;
         });
       }
-    }, [invoke]);
+    }, [invoke, loadStatus, workspaceFence]);
 
     const botList = model.bots.length > 0
       ? h('section', { className: 'dim-listSection' },
@@ -208,6 +228,12 @@ export function createTokenChannelSettings(definition) {
                 endpoints.reconnectBot,
                 { botId: account.botId },
               ),
+              onWorkspaceSave: (workspace) => botAction(
+                account,
+                'workspace',
+                endpoints.setWorkspace,
+                { botId: account.botId, workspace },
+              ),
               onRequestRemove: () => setRemoveTarget(account.botId),
               onCancelRemove: () => setRemoveTarget(null),
               onConfirmRemove: async () => {

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

@@ -8,6 +8,7 @@ export const WECOM_ENDPOINTS = Object.freeze({
   bindCredentials: 'bot.bind-credentials',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setWorkspace: 'bot.workspace.set',
 });
 
 const PROVISION_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting', 'connected', 'failed', 'cancelled']);
@@ -79,6 +80,7 @@ function normalizeBot(value) {
     botId: id(value.botId),
     connected,
     state: connected ? 'connected' : state,
+    workspace: text(value.workspace, '', 4_096),
     bot: {
       name: text(value.bot?.name, '企业微信机器人', 100),
       appIdMasked: text(value.bot?.appIdMasked, '应用标识已安全保存', 140),

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

@@ -3,6 +3,8 @@ import * as React from 'react';
 import { WecomLogoGlyph } from '../../channel-logos.js';
 import { CredentialActionIcon, CredentialBindingPanel, QrActionIcon } from '../../credential-binding.js';
 import { h } from '../../i18n.js';
+import { WorkspaceEditor } from '../../workspace-editor.js';
+import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
   WECOM_ENDPOINTS,
@@ -146,7 +148,16 @@ function RemoveConfirmation({ account, busy, onConfirm, onCancel }) {
       h(Button, { kind: 'danger', onClick: onConfirm, disabled: busy }, busy ? '正在移除…' : '确认移除接入')));
 }
 
-export function AccountCard({ account, busy, removing, onReconnect, onRequestRemove, onConfirmRemove, onCancelRemove }) {
+export function AccountCard({
+  account,
+  busy,
+  removing,
+  onReconnect,
+  onWorkspaceSave,
+  onRequestRemove,
+  onConfirmRemove,
+  onCancelRemove,
+}) {
   const tone = account.connected ? 'success' : account.state === 'error' ? 'error' : 'warning';
   const stateLabel = account.connected ? '运行正常' : account.state === 'connecting' ? '正在连接' : '连接未就绪';
   const summary = account.error?.message ?? (account.connected ? null : account.health.summary);
@@ -162,6 +173,11 @@ export function AccountCard({ account, busy, removing, onReconnect, onRequestRem
       h('dl', { className: 'ddt-metrics dim-botMetrics' },
         h('div', { className: 'ddt-metric dim-botMetric' }, h('dt', null, '消息通道'), h('dd', null, account.connected ? 'WebSocket 长连接' : '离线')),
         h('div', { className: 'ddt-metric dim-botMetric' }, h('dt', null, '最近检查'), h('dd', null, checkedTime(account.health.lastCheckedAt)))),
+      h(WorkspaceEditor, {
+        workspace: account.workspace,
+        disabled: Boolean(busy),
+        onSave: onWorkspaceSave,
+      }),
       h('div', { className: 'ddt-accountFooter dim-cardFooter' },
         summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
         h('div', { className: 'ddt-actions dim-cardActions' },
@@ -182,6 +198,7 @@ export function WecomSettingsTab({ rpcCall }) {
   const [credentialError, setCredentialError] = React.useState(null);
   const [now, setNow] = React.useState(Date.now());
   const mounted = React.useRef(true);
+  const workspaceFence = useWorkspaceSnapshotFence();
   const addButtonRef = React.useRef(null);
 
   React.useEffect(() => {
@@ -201,10 +218,13 @@ export function WecomSettingsTab({ rpcCall }) {
   }, [rpcCall]);
 
   const loadStatus = React.useCallback(async ({ signal, silent = false, restore = false } = {}) => {
+    const workspaceVersion = workspaceFence.beginStatus();
+    if (workspaceVersion === null) return undefined;
     if (!silent && mounted.current) setModel((current) => ({ ...current, phase: 'loading', error: null }));
     try {
       const snapshot = normalizeSnapshot(await invoke(WECOM_ENDPOINTS.status, {}, signal));
-      if (!mounted.current || signal?.aborted) return undefined;
+      if (!mounted.current || signal?.aborted
+        || !workspaceFence.canCommitStatus(workspaceVersion)) return undefined;
       setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
       if (restore && snapshot.provisioning) setProvision({
         ...snapshot.provisioning,
@@ -212,12 +232,13 @@ export function WecomSettingsTab({ rpcCall }) {
       });
       return snapshot;
     } catch (error) {
-      if (error?.name !== 'AbortError' && mounted.current && !signal?.aborted) {
+      if (error?.name !== 'AbortError' && mounted.current && !signal?.aborted
+        && workspaceFence.canCommitStatus(workspaceVersion)) {
         setModel((current) => ({ ...current, phase: silent ? current.phase : 'error', error: presentError(error) }));
       }
       return undefined;
     }
-  }, [invoke]);
+  }, [invoke, workspaceFence]);
 
   React.useEffect(() => {
     const controller = new AbortController();
@@ -258,6 +279,7 @@ export function WecomSettingsTab({ rpcCall }) {
   }, [invoke, provision?.attemptId]);
 
   const bindCredentials = React.useCallback(async ({ identity, secret }) => {
+    const snapshotVersion = workspaceFence.beginMutation();
     setBusy(true);
     setCredentialError(null);
     try {
@@ -266,14 +288,18 @@ export function WecomSettingsTab({ rpcCall }) {
         { botId: identity, secret },
       ));
       if (!mounted.current) return;
-      setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+      if (workspaceFence.canCommitMutation(snapshotVersion)) {
+        setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+      }
       setCredentialOpen(false);
     } catch (error) {
       if (mounted.current) setCredentialError(presentError(error));
     } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mounted.current) void loadStatus({ silent: true });
       if (mounted.current) setBusy(false);
     }
-  }, [invoke]);
+  }, [invoke, loadStatus, workspaceFence]);
 
   const closeProvision = React.useCallback(async () => {
     setBusy(true);
@@ -318,17 +344,22 @@ export function WecomSettingsTab({ rpcCall }) {
   }, [invoke, loadStatus, provision?.attemptId, provision?.pollIntervalMs, provision?.status]);
 
   const botAction = React.useCallback(async (account, operation, endpoint, payload) => {
+    const snapshotVersion = workspaceFence.beginMutation();
     setBusyByBot((current) => ({ ...current, [account.botId]: operation }));
     try {
       const snapshot = normalizeSnapshot(await invoke(endpoint, payload));
-      if (mounted.current) setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+      if (mounted.current && workspaceFence.canCommitMutation(snapshotVersion)) {
+        setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
+      }
       return snapshot;
     } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mounted.current) void loadStatus({ silent: true });
       if (mounted.current) setBusyByBot((current) => {
         const next = { ...current }; delete next[account.botId]; return next;
       });
     }
-  }, [invoke]);
+  }, [invoke, loadStatus, workspaceFence]);
 
   let provisionView = null;
   if (provision?.status === 'starting') provisionView = h('div', { className: 'ddt-card ddt-loading dim-surfaceCard' }, h('div', { className: 'ddt-spinner' }), '正在申请企业微信二维码…');
@@ -349,6 +380,12 @@ export function WecomSettingsTab({ rpcCall }) {
             busy: busyByBot[account.botId],
             removing: removeTarget === account.botId,
             onReconnect: () => void botAction(account, 'reconnect', WECOM_ENDPOINTS.reconnectBot, { botId: account.botId }),
+            onWorkspaceSave: (workspace) => botAction(
+              account,
+              'workspace',
+              WECOM_ENDPOINTS.setWorkspace,
+              { botId: account.botId, workspace },
+            ),
             onRequestRemove: () => setRemoveTarget(account.botId),
             onCancelRemove: () => setRemoveTarget(null),
             onConfirmRemove: async () => {

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

@@ -7,6 +7,7 @@ export const WEIXIN_ENDPOINTS = Object.freeze({
   cancelProvisioning: 'provision.cancel',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setWorkspace: 'bot.workspace.set',
 });
 
 const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
@@ -103,6 +104,7 @@ function normalizeBot(value) {
     state: connected ? 'connected' : state,
     connected,
     configured: value.configured === true,
+    workspace: string(value.workspace).slice(0, 4_096),
     bot: {
       name: string(value.bot.name, '微信机器人'),
       accountIdMasked: string(value.bot.accountIdMasked, '已安全保存'),

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

@@ -15,6 +15,8 @@ import {
   unwrapRpcResult,
 } from './api.js';
 import { createPollScheduler, useAnimationFrameScheduler } from '../../lifecycle.js';
+import { WorkspaceEditor } from '../../workspace-editor.js';
+import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
 import { installWeixinStyles } from './styles.js';
 
 export const name = 'weixin-settings';
@@ -193,7 +195,16 @@ function checkedTime(timestamp) {
   }
 }
 
-export function AccountCard({ account, busy, removing, onReconnect, onRequestRemove, onConfirmRemove, onCancelRemove }) {
+export function AccountCard({
+  account,
+  busy,
+  removing,
+  onReconnect,
+  onWorkspaceSave,
+  onRequestRemove,
+  onConfirmRemove,
+  onCancelRemove,
+}) {
   const state = busy === 'reconnect' ? 'connecting' : account.state;
   const tone = account.connected ? 'success' : state === 'error' ? 'error' : 'warning';
   const summary = account.error?.message ?? (account.connected ? null : account.health.summary);
@@ -211,6 +222,11 @@ export function AccountCard({ account, busy, removing, onReconnect, onRequestRem
           h('dd', null, account.connected ? 'iLink 长轮询' : '离线')),
         h('div', { className: 'dxw-metric dim-botMetric' }, h('dt', null, '最近检查'),
           h('dd', null, checkedTime(account.health.lastCheckedAt)))),
+      h(WorkspaceEditor, {
+        workspace: account.workspace,
+        disabled: Boolean(busy),
+        onSave: onWorkspaceSave,
+      }),
       h('div', { className: 'dxw-accountFooter dim-cardFooter' },
         summary ? h('div', { className: 'dxw-summary dim-cardSummary' }, summary) : null,
         h('div', { className: 'dxw-actions dim-cardActions' },
@@ -236,6 +252,7 @@ function AccountList(props) {
         busy: props.busyByBot[account.botId],
         removing: props.removeTarget === account.botId,
         onReconnect: () => props.onReconnect(account),
+        onWorkspaceSave: (workspace) => props.onWorkspaceSave(account, workspace),
         onRequestRemove: () => props.onRequestRemove(account),
         onConfirmRemove: () => props.onConfirmRemove(account),
         onCancelRemove: props.onCancelRemove,
@@ -269,8 +286,15 @@ export function WeixinSettingsTab({ rpcCall }) {
   const [notice, setNotice] = React.useState('');
   const [now, setNow] = React.useState(() => Date.now());
   const addButtonRef = React.useRef(null);
+  const mountedRef = React.useRef(true);
+  const workspaceFence = useWorkspaceSnapshotFence();
   const scheduleAnimationFrame = useAnimationFrameScheduler();
 
+  React.useEffect(() => {
+    mountedRef.current = true;
+    return () => { mountedRef.current = false; };
+  }, []);
+
   const announce = React.useCallback((value) => {
     setNotice('');
     scheduleAnimationFrame(() => {
@@ -285,10 +309,13 @@ export function WeixinSettingsTab({ rpcCall }) {
     silent = false,
     restoreProvisioning = false,
   } = {}) => {
+    const workspaceVersion = workspaceFence.beginStatus();
+    if (workspaceVersion === null || !mountedRef.current) return undefined;
     if (!silent) setModel((current) => ({ ...current, phase: 'loading', error: null }));
     try {
       const snapshot = normalizeSnapshot(await invoke(WEIXIN_ENDPOINTS.status, {}, signal));
-      if (signal?.aborted) return undefined;
+      if (signal?.aborted || !mountedRef.current
+        || !workspaceFence.canCommitStatus(workspaceVersion)) return undefined;
       setModel({
         phase: 'ready', bots: snapshot.bots, totals: snapshot.totals,
         revision: snapshot.revision, error: null,
@@ -302,7 +329,8 @@ export function WeixinSettingsTab({ rpcCall }) {
       }
       return snapshot;
     } catch (error) {
-      if (signal?.aborted || error?.name === 'AbortError') return undefined;
+      if (signal?.aborted || error?.name === 'AbortError' || !mountedRef.current
+        || !workspaceFence.canCommitStatus(workspaceVersion)) return undefined;
       setModel((current) => ({
         ...current,
         phase: silent && current.phase === 'ready' ? 'ready' : 'error',
@@ -310,7 +338,7 @@ export function WeixinSettingsTab({ rpcCall }) {
       }));
       return undefined;
     }
-  }, [invoke]);
+  }, [invoke, workspaceFence]);
 
   React.useEffect(() => {
     const controller = new AbortController();
@@ -466,35 +494,66 @@ export function WeixinSettingsTab({ rpcCall }) {
   }, []);
 
   const reconnect = React.useCallback(async (account) => {
+    const snapshotVersion = workspaceFence.beginMutation();
     setBotBusy(account.botId, 'reconnect');
     try {
       const snapshot = normalizeSnapshot(await invoke(WEIXIN_ENDPOINTS.reconnectBot, { botId: account.botId }));
-      setModel((current) => ({ ...current, bots: snapshot.bots, totals: snapshot.totals, revision: snapshot.revision }));
+      if (mountedRef.current && workspaceFence.canCommitMutation(snapshotVersion)) {
+        setModel((current) => ({ ...current, bots: snapshot.bots, totals: snapshot.totals, revision: snapshot.revision }));
+      }
       const refreshed = snapshot.bots.find((bot) => bot.botId === account.botId);
       announce(refreshed?.connected ? '微信连接检查完成。' : '微信仍未连接，插件会继续自动重试。');
     } catch (error) {
       announce(`连接检查失败：${presentError(error).message}`);
     } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
       setBotBusy(account.botId, null);
     }
-  }, [announce, invoke, setBotBusy]);
+  }, [announce, invoke, loadStatus, setBotBusy, workspaceFence]);
+
+  const saveWorkspace = React.useCallback(async (account, workspace) => {
+    const workspaceVersion = workspaceFence.beginMutation();
+    setBotBusy(account.botId, 'workspace');
+    try {
+      const snapshot = normalizeSnapshot(await invoke(
+        WEIXIN_ENDPOINTS.setWorkspace,
+        { botId: account.botId, workspace },
+      ));
+      if (mountedRef.current && workspaceFence.canCommitMutation(workspaceVersion)) {
+        setModel({
+          phase: 'ready', bots: snapshot.bots, totals: snapshot.totals,
+          revision: snapshot.revision, error: null,
+        });
+      }
+    } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
+      if (mountedRef.current) setBotBusy(account.botId, null);
+    }
+  }, [invoke, loadStatus, setBotBusy, workspaceFence]);
 
   const remove = React.useCallback(async (account) => {
+    const snapshotVersion = workspaceFence.beginMutation();
     setBotBusy(account.botId, 'delete');
     try {
       const snapshot = normalizeSnapshot(await invoke(WEIXIN_ENDPOINTS.deleteBot, {
         botId: account.botId,
         confirm: true,
       }));
-      setModel((current) => ({ ...current, bots: snapshot.bots, totals: snapshot.totals, revision: snapshot.revision }));
+      if (mountedRef.current && workspaceFence.canCommitMutation(snapshotVersion)) {
+        setModel((current) => ({ ...current, bots: snapshot.bots, totals: snapshot.totals, revision: snapshot.revision }));
+      }
       setRemoveTarget(null);
       announce('微信账号及本机凭据已移除。');
     } catch (error) {
       announce(`移除失败：${presentError(error).message}`);
     } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
       setBotBusy(account.botId, null);
     }
-  }, [announce, invoke, setBotBusy]);
+  }, [announce, invoke, loadStatus, setBotBusy, workspaceFence]);
 
   let provisionView = null;
   if (provision?.status === 'starting') {
@@ -554,6 +613,7 @@ export function WeixinSettingsTab({ rpcCall }) {
                   busyByBot,
                   removeTarget,
                   onReconnect: (account) => void reconnect(account),
+                  onWorkspaceSave: saveWorkspace,
                   onRequestRemove: (account) => setRemoveTarget(account.botId),
                   onConfirmRemove: (account) => void remove(account),
                   onCancelRemove: () => setRemoveTarget(null),

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

@@ -7,6 +7,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   cancelProvisioning: 'provision.cancel',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setWorkspace: 'bot.workspace.set',
 });
 
 const PROVISION_STATES = new Set(['starting', 'pending', 'connecting', 'connected', 'failed', 'cancelled']);
@@ -80,6 +81,7 @@ function normalizeBot(value) {
     botId: id(value.botId),
     connected,
     state: connected ? 'connected' : state,
+    workspace: text(value.workspace, '', 4_096),
     bot: {
       name: text(value.bot?.name, 'WhatsApp机器人', 100),
       idMasked: text(value.bot?.idMasked, 'WhatsApp账号', 140),

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

@@ -3,6 +3,8 @@ import * as React from 'react';
 import { WhatsappLogoGlyph } from '../../channel-logos.js';
 import { QrActionIcon } from '../../credential-binding.js';
 import { h } from '../../i18n.js';
+import { WorkspaceEditor } from '../../workspace-editor.js';
+import { useWorkspaceSnapshotFence } from '../../workspace-snapshot-fence.js';
 import { installDingtalkStyles } from '../dingtalk/styles.js';
 import {
   WHATSAPP_ENDPOINTS,
@@ -159,6 +161,7 @@ export function WhatsappAccountCard({
   busy,
   removing,
   onReconnect,
+  onWorkspaceSave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -186,6 +189,11 @@ export function WhatsappAccountCard({
           h('dd', null, account.connected ? 'WhatsApp Web' : '离线')),
         h('div', { className: 'ddt-metric dim-botMetric' },
           h('dt', null, '最近检查'), h('dd', null, checkedTime(account.health.lastCheckedAt)))),
+      h(WorkspaceEditor, {
+        workspace: account.workspace,
+        disabled: Boolean(busy),
+        onSave: onWorkspaceSave,
+      }),
       h('div', { className: 'ddt-accountFooter dim-cardFooter' },
         summary ? h('div', { className: 'ddt-summary dim-cardSummary' }, summary) : null,
         h('div', { className: 'ddt-actions dim-cardActions' },
@@ -213,6 +221,7 @@ export function WhatsappSettingsTab({ rpcCall }) {
   const [removeTarget, setRemoveTarget] = React.useState(null);
   const [now, setNow] = React.useState(Date.now());
   const mounted = React.useRef(true);
+  const workspaceFence = useWorkspaceSnapshotFence();
   const addButtonRef = React.useRef(null);
 
   React.useEffect(() => {
@@ -232,10 +241,13 @@ export function WhatsappSettingsTab({ rpcCall }) {
   }, [rpcCall]);
 
   const loadStatus = React.useCallback(async ({ signal, silent = false, restore = false } = {}) => {
+    const workspaceVersion = workspaceFence.beginStatus();
+    if (workspaceVersion === null) return undefined;
     if (!silent && mounted.current) setModel((current) => ({ ...current, phase: 'loading', error: null }));
     try {
       const snapshot = normalizeSnapshot(await invoke(WHATSAPP_ENDPOINTS.status, {}, signal));
-      if (!mounted.current || signal?.aborted) return undefined;
+      if (!mounted.current || signal?.aborted
+        || !workspaceFence.canCommitStatus(workspaceVersion)) return undefined;
       setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
       if (restore && snapshot.provisioning) setProvision({
         ...snapshot.provisioning,
@@ -243,7 +255,8 @@ export function WhatsappSettingsTab({ rpcCall }) {
       });
       return snapshot;
     } catch (error) {
-      if (error?.name !== 'AbortError' && mounted.current && !signal?.aborted) {
+      if (error?.name !== 'AbortError' && mounted.current && !signal?.aborted
+        && workspaceFence.canCommitStatus(workspaceVersion)) {
         setModel((current) => ({
           ...current,
           phase: silent ? current.phase : 'error',
@@ -252,7 +265,7 @@ export function WhatsappSettingsTab({ rpcCall }) {
       }
       return undefined;
     }
-  }, [invoke]);
+  }, [invoke, workspaceFence]);
 
   React.useEffect(() => {
     const controller = new AbortController();
@@ -350,20 +363,23 @@ export function WhatsappSettingsTab({ rpcCall }) {
   }, [invoke, loadStatus, provision?.attemptId, provision?.status]);
 
   const botAction = React.useCallback(async (account, operation, endpoint, payload) => {
+    const snapshotVersion = workspaceFence.beginMutation();
     setBusyByBot((current) => ({ ...current, [account.botId]: operation }));
     try {
       const snapshot = normalizeSnapshot(await invoke(endpoint, payload));
-      if (mounted.current) {
+      if (mounted.current && workspaceFence.canCommitMutation(snapshotVersion)) {
         setModel({ phase: 'ready', bots: snapshot.bots, totals: snapshot.totals, error: null });
       }
     } finally {
+      const shouldRefresh = workspaceFence.endMutation();
+      if (shouldRefresh && mounted.current) void loadStatus({ silent: true });
       if (mounted.current) setBusyByBot((current) => {
         const next = { ...current };
         delete next[account.botId];
         return next;
       });
     }
-  }, [invoke]);
+  }, [invoke, loadStatus, workspaceFence]);
 
   const botList = model.bots.length > 0
     ? h('section', { className: 'dim-listSection' },
@@ -380,6 +396,12 @@ export function WhatsappSettingsTab({ rpcCall }) {
               WHATSAPP_ENDPOINTS.reconnectBot,
               { botId: account.botId },
             ),
+            onWorkspaceSave: (workspace) => botAction(
+              account,
+              'workspace',
+              WHATSAPP_ENDPOINTS.setWorkspace,
+              { botId: account.botId, workspace },
+            ),
             onRequestRemove: () => setRemoveTarget(account.botId),
             onCancelRemove: () => setRemoveTarget(null),
             onConfirmRemove: async () => {

package/plugin-src/client/i18n.js

@@ -7,7 +7,8 @@ const EN = Object.freeze({
   'IM机器人': 'IM bots',
   'IM机器人设置': 'IM bot settings',
   'IM 渠道': 'IM channels',
-  '把机器人接入 DeepSeek Harness': 'Connect bots to DeepSeek Harness',
+  '让聊天机器人轻松接入 DeepSeek Harness': 'Connect IM bots to DeepSeek Harness with ease',
+  '帮助与反馈 · 前往 GitHub': 'Help & feedback · Open GitHub',
   '微信': 'WeChat',
   '飞书': 'Feishu',
   '钉钉': 'DingTalk',
@@ -43,6 +44,19 @@ const EN = Object.freeze({
   '已断开': 'Disconnected',
   '消息通道': 'Message channel',
   '最近检查': 'Last checked',
+  '当前工作区': 'Current workspace',
+  '工作区绝对路径': 'Absolute workspace path',
+  '/绝对路径/到/工作区': '/absolute/path/to/workspace',
+  '修改': 'Change',
+  '保存': 'Save',
+  '保存中…': 'Saving…',
+  '未设置': 'Not set',
+  '工作区修改失败，请重试。': 'Could not update the workspace. Try again.',
+  '请输入工作区绝对路径。': 'Enter an absolute workspace path.',
+  '工作区必须是绝对路径。': 'The workspace must be an absolute path.',
+  '工作区路径不存在。': 'The workspace path does not exist.',
+  '工作区路径必须指向一个目录。': 'The workspace path must point to a directory.',
+  '找不到要修改的机器人。': 'The bot could not be found.',
   '尚未检查': 'Not checked yet',
   '刚刚': 'Just now',
   '检查连接': 'Check connection',