@xmanrui/dsh-im 0.4.0 → 0.5.0

package/plugin-src/client/workspace-editor.js

@@ -0,0 +1,96 @@
+import * as React from 'react';
+
+import { h } from './i18n.js';
+
+function looksLikeAbsolutePath(value) {
+  return value.startsWith('/') || /^[A-Za-z]:[\\/]/.test(value) || /^\\\\/.test(value);
+}
+
+export function WorkspaceEditor({ workspace, disabled = false, onSave }) {
+  const [editing, setEditing] = React.useState(false);
+  const [draft, setDraft] = React.useState(workspace ?? '');
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const inputRef = React.useRef(null);
+  const editButtonRef = React.useRef(null);
+  const restoreFocus = React.useRef(false);
+
+  React.useEffect(() => {
+    if (!editing) setDraft(workspace ?? '');
+  }, [workspace, editing]);
+
+  React.useEffect(() => {
+    if (editing) inputRef.current?.focus();
+    else if (restoreFocus.current) {
+      restoreFocus.current = false;
+      editButtonRef.current?.focus();
+    }
+  }, [editing]);
+
+  const cancel = () => {
+    setDraft(workspace ?? '');
+    setError(null);
+    restoreFocus.current = true;
+    setEditing(false);
+  };
+
+  const submit = async (event) => {
+    event.preventDefault();
+    const value = draft.trim();
+    if (!value || saving || disabled) return;
+    if (!looksLikeAbsolutePath(value)) {
+      setError('工作区必须是绝对路径。');
+      return;
+    }
+    setSaving(true);
+    setError(null);
+    try {
+      await onSave?.(value);
+      restoreFocus.current = true;
+      setEditing(false);
+    } catch (cause) {
+      setError(cause?.message ?? '工作区修改失败，请重试。');
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return h('div', { className: 'dim-workspace' },
+    h('div', { className: 'dim-workspaceHeader' },
+      h('span', null, '当前工作区'),
+      editing ? null : h('button', {
+        type: 'button',
+        ref: editButtonRef,
+        className: 'dim-workspaceEdit',
+        onClick: () => { setEditing(true); setError(null); },
+        disabled,
+      }, '修改')),
+    editing
+      ? h('form', { className: 'dim-workspaceForm', onSubmit: submit },
+          h('input', {
+            ref: inputRef,
+            value: draft,
+            onChange: (event) => setDraft(event.target.value),
+            placeholder: '/绝对路径/到/工作区',
+            'aria-label': '工作区绝对路径',
+            autoCapitalize: 'none',
+            autoCorrect: 'off',
+            spellCheck: false,
+            maxLength: 4_096,
+            required: true,
+            disabled: saving || disabled,
+          }),
+          h('div', { className: 'dim-workspaceActions' },
+            h('button', {
+              type: 'submit', disabled: saving || disabled || !draft.trim(),
+            }, saving ? '保存中…' : '保存'),
+            h('button', { type: 'button', onClick: cancel, disabled: saving || disabled }, '取消')),
+          error ? h('p', { className: 'dim-workspaceError', role: 'alert' }, error) : null)
+      : workspace
+        ? React.createElement('code', {
+            className: 'dim-workspacePath',
+            title: workspace,
+          }, workspace)
+        : h('code', { className: 'dim-workspacePath' }, '未设置'),
+  );
+}

package/plugin-src/client/workspace-snapshot-fence.js

@@ -0,0 +1,28 @@
+import * as React from 'react';
+
+/** Keep every full-snapshot response ordered behind the latest client mutation. */
+export function useWorkspaceSnapshotFence() {
+  const state = React.useRef({ version: 0, pendingMutations: 0 });
+  return React.useMemo(() => Object.freeze({
+    beginStatus() {
+      return state.current.pendingMutations === 0 ? state.current.version : null;
+    },
+    canCommitStatus(version) {
+      return version !== null
+        && state.current.pendingMutations === 0
+        && state.current.version === version;
+    },
+    beginMutation() {
+      state.current.pendingMutations += 1;
+      state.current.version += 1;
+      return state.current.version;
+    },
+    canCommitMutation(version) {
+      return state.current.version === version;
+    },
+    endMutation() {
+      state.current.pendingMutations = Math.max(0, state.current.pendingMutations - 1);
+      return state.current.pendingMutations === 0;
+    },
+  }), []);
+}

package/plugin-src/host/channels/dingtalk/production.mjs

@@ -8,6 +8,12 @@ import { DingtalkController } from '../../../../src/channels/dingtalk/dingtalk-c
 import { DingtalkRuntime } from '../../../../src/channels/dingtalk/dingtalk-runtime.mjs';
 import { HarnessClient } from '../../../../src/channels/dingtalk/harness-client.mjs';
 import { DingtalkStateStore } from '../../../../src/channels/dingtalk/state-store.mjs';
+import {
+  BotWorkspaceStore,
+  createBotWorkspaceScope,
+  createWorkspaceAwareController,
+  observeBotWorkspaceRemovals,
+} from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
 
 function harnessOrigin(webServer, configured) {
@@ -26,6 +32,7 @@ function pluginPaths(config) {
     root,
     config: resolve(config.configPath ?? join(root, 'config.json')),
     bots: resolve(config.botsDir ?? join(root, 'bots')),
+    workspaces: resolve(config.workspacesPath ?? join(root, 'workspaces.json')),
   };
 }
 
@@ -45,6 +52,19 @@ export async function createProductionController(ctx, config = {}, internals = {
     : (ctx.logger ?? console);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
+  const defaultWorkspace = resolve(config.workspace ?? process.cwd());
+  const WorkspaceStore = internals.WorkspaceStore ?? BotWorkspaceStore;
+  const workspaces = internals.workspaces
+    ?? await new WorkspaceStore(paths.workspaces, { defaultWorkspace }).load();
+  const canListConfiguredBots = typeof configStore.list === 'function';
+  const configuredBots = canListConfiguredBots ? configStore.list() : [];
+  if (canListConfiguredBots) {
+    await workspaces.reconcile(configuredBots.map((bot) => bot.botId));
+  }
+  await Promise.all(configuredBots.map((bot) => workspaces.ensure(bot.botId)));
+  const observedConfigStore = typeof configStore.remove === 'function'
+    ? observeBotWorkspaceRemovals(configStore, { workspaces })
+    : configStore;
   const deviceAuth = internals.deviceAuth ?? new DeviceAuth({
     baseUrl: config.registrationBaseUrl,
   });
@@ -61,23 +81,25 @@ export async function createProductionController(ctx, config = {}, internals = {
   };
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
-    workspace: resolve(config.workspace ?? process.cwd()),
+    workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
   });
-  const controller = new Controller({
+  const coreController = new Controller({
     deviceAuth,
     credentials: ctx.credentials,
-    configStore,
+    configStore: observedConfigStore,
     logger,
     createRuntime: async ({ botId, config: botConfig, clientSecret }) => {
       const state = await stateFor(botId);
+      await workspaces.ensure(botId);
+      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
       return new Runtime({
         config: botConfig,
         clientSecret,
-        harness,
-        state,
+        harness: workspaceScope.harness,
+        state: workspaceScope.state,
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         maxMessageChars: config.maxMessageChars ?? 4_000,
         connectTimeoutMs: config.connectTimeoutMs ?? 15_000,
@@ -94,15 +116,16 @@ export async function createProductionController(ctx, config = {}, internals = {
       stateStores.delete(botId);
       if (state && typeof state.remove === 'function') {
         await state.remove();
-        return;
-      }
-      try {
-        await unlink(statePath(botId));
-      } catch (error) {
-        if (error?.code !== 'ENOENT') throw error;
+      } else {
+        try {
+          await unlink(statePath(botId));
+        } catch (error) {
+          if (error?.code !== 'ENOENT') throw error;
+        }
       }
     },
   });
+  const controller = createWorkspaceAwareController(coreController, { workspaces, stateFor });
   const supervisor = createSupervisor({
     controller,
     harness,

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

@@ -1,5 +1,6 @@
 import QRCode from 'qrcode';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
+import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 
 export const DINGTALK_RPC_CHANNEL = '/dingtalk';
 export const DINGTALK_ENDPOINTS = Object.freeze({
@@ -10,6 +11,7 @@ export const DINGTALK_ENDPOINTS = Object.freeze({
   bindCredentials: 'bot.bind-credentials',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setWorkspace: SET_WORKSPACE_ENDPOINT,
   approveSender: 'bot.sender.approve',
   revokeSender: 'bot.sender.revoke',
 });
@@ -76,6 +78,10 @@ function payloadFailure(endpoint, payload) {
       ? null
       : 'bot.delete requires a botId and confirm=true.';
   }
+  if (endpoint === DINGTALK_ENDPOINTS.setWorkspace) {
+    return validWorkspacePayload(payload)
+      ? null : '请输入工作区绝对路径。';
+  }
   if (endpoint === DINGTALK_ENDPOINTS.approveSender) {
     return exactKeys(payload, ['botId', 'requestId', 'confirm'])
       && validId(payload.botId)
@@ -207,6 +213,12 @@ export function createDingtalkRpcHandler(controller, { encodeQr = qrDataUrl } =
         value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
       } else if (endpoint === DINGTALK_ENDPOINTS.deleteBot) {
         value = await publicStatus(await controller.deleteBot(payload.botId), cachedEncode);
+      } else if (endpoint === DINGTALK_ENDPOINTS.setWorkspace) {
+        if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
+        value = await publicStatus(
+          await controller.updateWorkspace(payload.botId, payload.workspace),
+          cachedEncode,
+        );
       } else if (endpoint === DINGTALK_ENDPOINTS.approveSender) {
         value = await publicStatus(
           await controller.approveSender(payload.botId, payload.requestId),
@@ -219,8 +231,11 @@ export function createDingtalkRpcHandler(controller, { encodeQr = qrDataUrl } =
         );
       }
       return signal?.aborted ? cancelled() : { ok: true, value };
-    } catch {
-      return signal?.aborted ? cancelled() : internalFailure();
+    } catch (error) {
+      const workspaceError = publicWorkspaceError(error);
+      return signal?.aborted ? cancelled() : workspaceError
+        ? { ok: false, error: workspaceError }
+        : internalFailure();
     }
   };
 }

package/plugin-src/host/channels/feishu/production.mjs

@@ -12,6 +12,12 @@ import {
 } from '../../../../src/channels/feishu/plugin-config-store.mjs';
 import { MultiBotDshFeishuController } from '../../../../src/channels/feishu/multi-bot-controller.mjs';
 import { StateStore } from '../../../../src/channels/feishu/state-store.mjs';
+import {
+  BotWorkspaceStore,
+  createBotWorkspaceScope,
+  createWorkspaceAwareController,
+  observeBotWorkspaceRemovals,
+} from '../../../../src/channels/shared/bot-workspace-store.mjs';
 
 function harnessOrigin(webServer, configured) {
   if (configured !== undefined) return new URL(configured);
@@ -34,6 +40,7 @@ function pluginPaths(config) {
     config: resolve(config.configPath ?? join(root, 'config.json')),
     legacyState: resolve(config.statePath ?? join(root, 'state.json')),
     bots: resolve(config.botsDir ?? join(root, 'bots')),
+    workspaces: resolve(config.workspacesPath ?? join(root, 'workspaces.json')),
   };
 }
 
@@ -58,6 +65,24 @@ export async function createProductionController(ctx, config = {}, internals = {
     : (ctx.logger ?? console);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
+  const defaultWorkspace = resolve(config.workspace ?? process.cwd());
+  const WorkspaceStore = internals.WorkspaceStore ?? BotWorkspaceStore;
+  const workspaces = internals.workspaces
+    ?? await new WorkspaceStore(paths.workspaces, { defaultWorkspace }).load();
+  const canListConfiguredBots = typeof configStore.list === 'function';
+  const listConfiguredBots = () => canListConfiguredBots ? configStore.list() : [];
+  const configuredBots = listConfiguredBots();
+  if (canListConfiguredBots) {
+    await workspaces.reconcile(configuredBots.map((bot) => bot.id));
+  }
+  await Promise.all(configuredBots.map((bot) => workspaces.ensure(bot.id)));
+  const observedConfigStore = typeof configStore.removeBot === 'function'
+    ? observeBotWorkspaceRemovals(configStore, {
+        workspaces,
+        method: 'removeBot',
+        botIdFromRemoved: (removed) => removed.id,
+      })
+    : configStore;
   // State is lazy per bot. A corrupt legacy file can therefore fail only the
   // migrated bot and cannot prevent healthy v2 bots from starting.
   const stateStores = new Map();
@@ -75,9 +100,14 @@ export async function createProductionController(ctx, config = {}, internals = {
     }
     return state;
   };
+  const stateForBotId = async (botId) => {
+    const botConfig = listConfiguredBots().find((bot) => bot.id === botId);
+    if (!botConfig) throw new Error('Unknown Feishu bot');
+    return stateFor(botConfig);
+  };
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
-    workspace: resolve(config.workspace ?? process.cwd()),
+    workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     // This plugin is already hosted by a running DSH process. Starting a
     // second DSH would create a competing server and lifecycle.
@@ -85,21 +115,24 @@ export async function createProductionController(ctx, config = {}, internals = {
     dshBin: config.dshBin ?? 'dsh',
   });
 
-  const controller = new Controller({
+  const coreController = new Controller({
     registerApp: (options) => lark.registerApp(options),
     verifyApp,
     credentials: ctx.credentials,
-    configStore,
+    configStore: observedConfigStore,
     createRuntime: async ({ botId, config: botConfig, appSecret }) => {
       const state = await stateFor(botConfig);
+      const id = botId ?? botConfig.id ?? botConfig.appId;
+      await workspaces.ensure(id);
+      const workspaceScope = createBotWorkspaceScope(harness, { botId: id, workspaces, state });
       return new Runtime({
         lark,
         appId: botConfig.appId,
         appSecret,
         domain: botConfig.domain,
         ownerOpenIds: botConfig.ownerOpenIds ?? [botConfig.ownerOpenId],
-        harness,
-        state,
+        harness: workspaceScope.harness,
+        state: workspaceScope.state,
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         logger: {
           error: (...args) => logger.error?.(`[${botId ?? botConfig.id}]`, ...args),
@@ -118,6 +151,10 @@ export async function createProductionController(ctx, config = {}, internals = {
       }
     },
   });
+  const controller = createWorkspaceAwareController(coreController, {
+    workspaces,
+    stateFor: stateForBotId,
+  });
 
   const supervisor = createSupervisor({
     controller,

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

@@ -1,5 +1,6 @@
 import QRCode from 'qrcode';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
+import { publicWorkspaceError, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import {
   FEISHU_ENDPOINTS,
   FEISHU_RPC_CHANNEL,
@@ -174,6 +175,7 @@ function publicBotEntry(entry) {
     bot: publicBot(source.bot),
     health: publicHealth(source, connected),
   };
+  if (typeof source.workspace === 'string' && source.workspace) result.workspace = source.workspace;
   const error = publicError(source.error);
   if (error) result.error = error;
   return result;
@@ -268,6 +270,10 @@ function validPayload(endpoint, payload) {
       ? null
       : 'Deleting a bot requires a valid botId and confirm=true.';
   }
+  if (endpoint === FEISHU_ENDPOINTS.setWorkspace) {
+    return validWorkspacePayload(payload)
+      ? null : '请输入工作区绝对路径。';
+  }
   return 'Unknown Feishu endpoint.';
 }
 
@@ -429,14 +435,23 @@ export function createFeishuRpcHandler(controller, { encodeQr = qrCodeDataUrl }
       } else if (endpoint === FEISHU_MULTI_ENDPOINTS.disconnectBot) {
         if (typeof controller.disconnectBot !== 'function') throw new Error('Multi-bot disconnect is unavailable');
         value = await toPublicFeishuStatus(await controller.disconnectBot(payload.botId), { encodeQr: cachedEncodeQr });
+      } else if (endpoint === FEISHU_ENDPOINTS.setWorkspace) {
+        if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
+        value = await toPublicFeishuStatus(
+          await controller.updateWorkspace(payload.botId, payload.workspace),
+          { encodeQr: cachedEncodeQr },
+        );
       } else {
         if (typeof controller.deleteBot !== 'function') throw new Error('Multi-bot delete is unavailable');
         value = await toPublicFeishuStatus(await controller.deleteBot(payload.botId), { encodeQr: cachedEncodeQr });
       }
       if (signal?.aborted) return cancelled();
       return { ok: true, value };
-    } catch {
-      return signal?.aborted ? cancelled() : internalFailure();
+    } catch (error) {
+      const workspaceError = publicWorkspaceError(error);
+      return signal?.aborted ? cancelled() : workspaceError
+        ? { ok: false, error: { ...workspaceError, details: {} } }
+        : internalFailure();
     }
   };
 }

package/plugin-src/host/channels/qq/production.mjs

@@ -8,6 +8,12 @@ import { QqController } from '../../../../src/channels/qq/qq-controller.mjs';
 import { QqRuntime } from '../../../../src/channels/qq/qq-runtime.mjs';
 import { QqQrAuth } from '../../../../src/channels/qq/qr-auth.mjs';
 import { QqStateStore } from '../../../../src/channels/qq/state-store.mjs';
+import {
+  BotWorkspaceStore,
+  createBotWorkspaceScope,
+  createWorkspaceAwareController,
+  observeBotWorkspaceRemovals,
+} from '../../../../src/channels/shared/bot-workspace-store.mjs';
 import { createConnectionSupervisor } from './connection-supervisor.mjs';
 
 function harnessOrigin(webServer, configured) {
@@ -25,6 +31,7 @@ function pluginPaths(config) {
   return {
     config: resolve(config.configPath ?? join(root, 'config.json')),
     bots: resolve(config.botsDir ?? join(root, 'bots')),
+    workspaces: resolve(config.workspacesPath ?? join(root, 'workspaces.json')),
   };
 }
 
@@ -42,6 +49,16 @@ export async function createProductionController(ctx, config = {}, internals = {
   const logger = typeof ctx.logger === 'function' ? ctx.logger('dsh-im:qq') : (ctx.logger ?? console);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
+  const defaultWorkspace = resolve(config.workspace ?? process.cwd());
+  const WorkspaceStore = internals.WorkspaceStore ?? BotWorkspaceStore;
+  const workspaces = internals.workspaces
+    ?? await new WorkspaceStore(paths.workspaces, { defaultWorkspace }).load();
+  const configuredBots = configStore.list();
+  await workspaces.reconcile(configuredBots.map((bot) => bot.botId));
+  await Promise.all(configuredBots.map((bot) => workspaces.ensure(bot.botId)));
+  const observedConfigStore = typeof configStore.remove === 'function'
+    ? observeBotWorkspaceRemovals(configStore, { workspaces })
+    : configStore;
   const qrAuth = internals.qrAuth ?? new QrAuth({ source: config.qrSource ?? 'deepseek-harness' });
   const stateStores = new Map();
   const statePath = (botId) => resolve(paths.bots, botId, 'state.json');
@@ -55,41 +72,50 @@ export async function createProductionController(ctx, config = {}, internals = {
   };
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
-    workspace: resolve(config.workspace ?? process.cwd()),
+    workspace: defaultWorkspace,
     agentPreset: config.agentPreset ?? 'standard',
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
   });
-  const controller = new Controller({
+  const coreController = new Controller({
     qrAuth,
     credentials: ctx.credentials,
-    configStore,
+    configStore: observedConfigStore,
     logger,
-    createRuntime: async ({ botId, config: botConfig, appSecret }) => new Runtime({
-      config: botConfig,
-      appSecret,
-      harness,
-      state: await stateFor(botId),
-      replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
-      connectTimeoutMs: config.connectTimeoutMs ?? 20_000,
-      logger: {
-        error: (...args) => logger.error?.(`[${botId}]`, ...args),
-        warn: (...args) => logger.warn?.(`[${botId}]`, ...args),
-        info: (...args) => logger.info?.(`[${botId}]`, ...args),
-        debug: (...args) => logger.debug?.(`[${botId}]`, ...args),
-      },
-    }),
+    createRuntime: async ({ botId, config: botConfig, appSecret }) => {
+      const state = await stateFor(botId);
+      await workspaces.ensure(botId);
+      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      return new Runtime({
+        config: botConfig,
+        appSecret,
+        harness: workspaceScope.harness,
+        state: workspaceScope.state,
+        replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
+        connectTimeoutMs: config.connectTimeoutMs ?? 20_000,
+        logger: {
+          error: (...args) => logger.error?.(`[${botId}]`, ...args),
+          warn: (...args) => logger.warn?.(`[${botId}]`, ...args),
+          info: (...args) => logger.info?.(`[${botId}]`, ...args),
+          debug: (...args) => logger.debug?.(`[${botId}]`, ...args),
+        },
+      });
+    },
     deleteState: async ({ botId }) => {
       const state = stateStores.get(botId);
       stateStores.delete(botId);
-      if (state && typeof state.remove === 'function') return state.remove();
-      try {
-        await unlink(statePath(botId));
-      } catch (error) {
-        if (error?.code !== 'ENOENT') throw error;
+      if (state && typeof state.remove === 'function') {
+        await state.remove();
+      } else {
+        try {
+          await unlink(statePath(botId));
+        } catch (error) {
+          if (error?.code !== 'ENOENT') throw error;
+        }
       }
     },
   });
+  const controller = createWorkspaceAwareController(coreController, { workspaces, stateFor });
   const supervisor = createSupervisor({
     controller,
     harness,

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

@@ -1,5 +1,6 @@
 import QRCode from 'qrcode';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
+import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 
 export const QQ_RPC_CHANNEL = '/qq';
 export const QQ_ENDPOINTS = Object.freeze({
@@ -10,6 +11,7 @@ export const QQ_ENDPOINTS = Object.freeze({
   bindCredentials: 'bot.bind-credentials',
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
+  setWorkspace: SET_WORKSPACE_ENDPOINT,
 });
 export const QQ_RPC_ENDPOINTS = Object.freeze(Object.values(QQ_ENDPOINTS));
 
@@ -57,6 +59,10 @@ function payloadFailure(endpoint, payload) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId) && payload.confirm === true
       ? null : 'bot.delete requires a botId and confirm=true.';
   }
+  if (endpoint === QQ_ENDPOINTS.setWorkspace) {
+    return validWorkspacePayload(payload)
+      ? null : '请输入工作区绝对路径。';
+  }
   return 'Unknown QQ endpoint.';
 }
 
@@ -120,16 +126,24 @@ export function createQqRpcHandler(controller, { encodeQr = qrDataUrl } = {}) {
         value = await publicStatus(await controller.bindCredentials(payload), cachedEncode);
       } else if (endpoint === QQ_ENDPOINTS.reconnectBot) {
         value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+      } else if (endpoint === QQ_ENDPOINTS.setWorkspace) {
+        if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
+        value = await publicStatus(
+          await controller.updateWorkspace(payload.botId, payload.workspace),
+          cachedEncode,
+        );
       } else {
         value = await publicStatus(await controller.deleteBot(payload.botId), cachedEncode);
       }
       return signal?.aborted
         ? { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } }
         : { ok: true, value };
-    } catch {
+    } catch (error) {
+      const workspaceError = publicWorkspaceError(error);
       return signal?.aborted
         ? { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } }
-        : { ok: false, error: { code: 'qq-operation-failed', message: 'QQ 操作失败，请稍后重试。' } };
+        : { ok: false, error: workspaceError
+          ?? { code: 'qq-operation-failed', message: 'QQ 操作失败，请稍后重试。' } };
     }
   };
 }