@xmanrui/dsh-im 0.3.0 → 0.5.0

package/plugin-src/client/index.js

@@ -43,6 +43,8 @@ import { installImStyles } from './styles.js';
 export const name = 'im-settings';
 export const inject = ['slots', 'connection', 'locale'];
 
+const IM_PLUGIN_LOGO_URL = globalThis.__DSH_IM_LOGO_DATA_URL__ ?? 'assets/logo-icon.png';
+
 const CHANNELS = Object.freeze([
   { id: 'weixin', label: '微信' },
   { id: 'feishu', label: '飞书' },
@@ -122,10 +124,35 @@ export function IMSettingsTab({
   whatsappRpcCall,
 }) {
   const [selected, setSelected] = React.useState('weixin');
+  const githubTooltipId = React.useId();
   const active = CHANNELS.find((channel) => channel.id === selected) ?? CHANNELS[0];
   return h('section', { className: 'dim-page', 'aria-label': 'IM机器人设置' },
     h('header', { className: 'dim-title' },
-      h('p', null, '把机器人接入 DeepSeek Harness'),
+      h('div', { className: 'dim-brand' },
+        h('img', {
+          className: 'dim-brandLogo',
+          src: IM_PLUGIN_LOGO_URL,
+          alt: 'dsh-im',
+          width: 48,
+          height: 48,
+        }),
+        h('p', null, '让聊天机器人轻松接入 DeepSeek Harness')),
+      h('span', { className: 'dim-githubAction' },
+        h('a', {
+          className: 'dim-githubLink',
+          href: 'https://github.com/xmanrui/dsh-im',
+          target: '_blank',
+          rel: 'noopener noreferrer',
+          'aria-label': 'dsh-im GitHub',
+          'aria-describedby': githubTooltipId,
+        },
+        h('span', null, 'GitHub'),
+        h('span', { className: 'dim-githubArrow', 'aria-hidden': 'true' }, '↗')),
+        h('span', {
+          id: githubTooltipId,
+          className: 'dim-githubTooltip',
+          role: 'tooltip',
+        }, '帮助与反馈 · 前往 GitHub')),
     ),
     h('div', { className: 'dim-layout' },
       h('nav', { className: 'dim-rail', role: 'tablist', 'aria-label': 'IM 渠道' },

package/plugin-src/client/styles.js

@@ -11,8 +11,17 @@ const CSS = String.raw`
   box-sizing: border-box;
 }
 .dim-page *, .dim-page *::before, .dim-page *::after { box-sizing: border-box; }
-.dim-title { margin: 0 0 26px; }
-.dim-title p { margin: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 13px; line-height: 20px; white-space: nowrap; }
+.dim-title { display: flex; align-items: center; justify-content: space-between; gap: 16px; margin: 0 0 18px; }
+.dim-brand { min-width: 0; display: flex; align-items: center; gap: 12px; }
+.dim-brandLogo { width: 48px; height: 48px; flex: 0 0 48px; display: block; object-fit: contain; filter: grayscale(1) contrast(1.08); }
+.dim-title p { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 14px; line-height: 20px; font-weight: 600; white-space: nowrap; }
+.dim-githubAction { position: relative; display: inline-flex; flex: none; }
+.dim-githubLink { min-height: 30px; display: inline-flex; align-items: center; gap: 5px; flex: none; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); font-size: 12px; line-height: normal; font-weight: 560; text-decoration: none; transition: border-color .15s ease, color .15s ease, background .15s ease; }
+.dim-githubLink:hover { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-githubLink:focus-visible { outline: 2px solid color-mix(in srgb, var(--dim-blue) 70%, white); outline-offset: 2px; }
+.dim-githubArrow { font-size: 13px; line-height: 1; }
+.dim-githubTooltip { position: absolute; right: 0; bottom: calc(100% + 8px); z-index: 20; width: max-content; max-width: min(220px, 80vw); padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; font-weight: 500; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateY(3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dim-githubAction:hover .dim-githubTooltip, .dim-githubAction:focus-within .dim-githubTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-layout { display: grid; grid-template-columns: 174px 1px minmax(0, 1fr); gap: 24px; align-items: start; }
 .dim-rail { max-height: 520px; display: grid; align-content: start; gap: 8px; overflow-y: auto; padding: 1px 4px 1px 1px; scrollbar-width: thin; scrollbar-color: var(--dsw-alias-border-l2, #dfe1e5) transparent; }
 .dim-rail::-webkit-scrollbar { width: 4px; }
@@ -57,7 +66,7 @@ const CSS = String.raw`
 .dim-panel .dim-credentialButton:hover:not(:disabled) { border-color: #4e5969; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-credentialButton[aria-pressed="true"] { border-color: #4e5969; background: var(--dsw-alias-bg-module-platform, #f2f3f5); box-shadow: inset 0 0 0 1px rgb(78 89 105 / 8%); }
 .dim-panel .bxf-headingTools .dim-onlineBadge, .dim-panel .dxw-tools .dim-onlineBadge, .dim-panel .ddt-tools .dim-onlineBadge { min-height: 30px; display: inline-flex; align-items: center; justify-self: end; gap: 0; padding: 0 11px; border: 0; border-radius: 999px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-module-platform, #f2f3f5); font: inherit; font-size: 12px; font-weight: 400; line-height: normal; white-space: nowrap; }
-.dim-panel .dim-channelPage { width: 100%; max-width: none; display: flex; flex-direction: column; gap: 18px; padding: 0 0 24px; color: var(--dsw-alias-label-primary, #1f2329); box-sizing: border-box; }
+.dim-panel .dim-channelPage { width: 100%; max-width: none; display: flex; flex-direction: column; gap: 12px; padding: 0 0 24px; color: var(--dsw-alias-label-primary, #1f2329); box-sizing: border-box; }
 .dim-panel .dim-surfaceCard { position: relative; overflow: hidden; border: 1px solid var(--dsw-alias-border-l2, #e5e6eb); border-radius: 14px; background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 1px 2px rgb(31 35 41 / 3%); }
 .dim-panel .dim-surfaceCard::before { display: none; }
 .dim-panel .dim-surfaceBody { padding: 24px; }
@@ -73,9 +82,9 @@ const CSS = String.raw`
 .dim-panel .dim-credentialError { margin: 0; color: var(--dsw-alias-state-error-primary, #d54941); font-size: 12px; line-height: 1.5; }
 .dim-panel .dim-credentialActions { margin-top: 0; }
 .dim-panel .dim-listSection { display: flex; flex-direction: column; gap: 0; }
-.dim-panel .dim-listHeading { min-height: 0; display: flex; align-items: center; justify-content: space-between; gap: 16px; margin: 2px 0 9px; padding: 0; }
+.dim-panel .dim-listHeading { min-height: 0; display: flex; align-items: center; justify-content: space-between; gap: 16px; margin: 0 0 6px; padding: 0; }
 .dim-panel .dim-listHeading h3 { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 14px; line-height: normal; font-weight: 650; }
-.dim-panel .dim-botList { display: grid; gap: 12px; margin: 0; padding: 0; list-style: none; }
+.dim-panel .dim-botList { display: grid; gap: 8px; margin: 0; padding: 0; list-style: none; }
 .dim-panel .dim-loadingView { padding: 38px; color: var(--dsw-alias-label-secondary, #646a73); text-align: center; }
 .dim-panel .dim-loadingView h3 { margin: 0 0 7px; color: var(--dsw-alias-label-primary, #1f2329); font-size: 17px; line-height: normal; font-weight: 650; }
 .dim-panel .dim-loadingView p { margin: 0; line-height: 1.6; }
@@ -123,7 +132,20 @@ const CSS = String.raw`
 .dim-panel .dim-confirm { padding: 18px 24px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-confirm strong, .dim-panel .dim-confirm h4 { margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 14px; line-height: 1.4; font-weight: 650; }
 .dim-panel .dim-confirm p { margin: 7px 0 0; color: var(--dsw-alias-label-secondary, #646a73); line-height: 1.6; }
-.dim-panel .dim-cardFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; padding-top: 12px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
+.dim-panel .dim-cardFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; padding-top: 8px; border-top: 1px solid var(--dsw-alias-border-l1, #eef0f3); }
+.dim-panel .dim-workspace { min-width: 0; display: grid; gap: 7px; margin-top: 14px; padding: 11px 12px; border: 1px solid var(--dsw-alias-border-l1, #eef0f3); border-radius: 9px; background: var(--dsw-alias-bg-module-platform, #f7f8fa); }
+.dim-panel .dim-workspaceHeader { display: flex; align-items: center; justify-content: space-between; gap: 12px; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: normal; }
+.dim-panel .dim-workspaceEdit { padding: 0; border: 0; color: #1677ff; background: transparent; font: inherit; font-weight: 560; cursor: pointer; }
+.dim-panel .dim-workspaceEdit:disabled { cursor: not-allowed; opacity: .55; }
+.dim-panel .dim-workspacePath { min-width: 0; display: block; overflow: hidden; color: var(--dsw-alias-label-primary, #1f2329); font: 12px/1.55 ui-monospace, SFMono-Regular, Menlo, monospace; text-overflow: ellipsis; white-space: nowrap; }
+.dim-panel .dim-workspaceForm { min-width: 0; display: grid; grid-template-columns: minmax(0, 1fr) max-content; gap: 8px; }
+.dim-panel .dim-workspaceForm input { width: 100%; min-width: 0; height: 34px; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; outline: none; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: 12px ui-monospace, SFMono-Regular, Menlo, monospace; }
+.dim-panel .dim-workspaceForm input:focus { border-color: #1677ff; box-shadow: 0 0 0 2px rgb(22 119 255 / 10%); }
+.dim-panel .dim-workspaceActions { display: flex; gap: 6px; }
+.dim-panel .dim-workspaceActions button { min-height: 34px; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 12px; cursor: pointer; }
+.dim-panel .dim-workspaceActions button[type="submit"] { border-color: #1677ff; color: white; background: #1677ff; }
+.dim-panel .dim-workspaceActions button:disabled { cursor: not-allowed; opacity: .55; }
+.dim-panel .dim-workspaceError { grid-column: 1 / -1; margin: 0; color: var(--dsw-alias-state-error-primary, #d54941); font-size: 12px; line-height: 1.5; }
 .dim-panel .dim-cardSummary { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font: inherit; font-size: 12px; font-weight: 400; line-height: normal; }
 .dim-panel .dim-cardActions { flex: none; display: flex; align-items: center; flex-wrap: nowrap; gap: 8px; margin: 0 0 0 auto; }
 .dim-panel .dim-cardActions .dim-cardAction { flex: none; min-height: 34px; padding: 0 13px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 13px; font-weight: 560; line-height: normal; white-space: nowrap; }
@@ -131,7 +153,7 @@ const CSS = String.raw`
 .dim-panel .dim-cardActions .dim-cardAction[data-kind="danger"] { color: var(--dsw-alias-state-error-primary, #d54941); }
 .dim-panel .dim-botCard { position: relative; overflow: hidden; border: 1px solid var(--dsw-alias-border-l2, #e5e6eb); border-radius: 14px; background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 1px 2px rgb(31 35 41 / 3%); }
 .dim-panel .dim-botCard::before { display: none; }
-.dim-panel .dim-botCardBody { position: relative; padding: 16px; }
+.dim-panel .dim-botCardBody { position: relative; padding: 14px; }
 .dim-panel .dim-botCardTop { display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; }
 .dim-panel .dim-botIdentity { min-width: 0; display: flex; align-items: center; gap: 12px; }
 .dim-panel .dim-botAvatar { flex: none; width: 42px; height: 42px; display: grid; place-items: center; overflow: hidden; border-radius: 12px; box-shadow: none; }
@@ -144,8 +166,8 @@ const CSS = String.raw`
 .dim-panel .dim-botCard .dim-healthDot[data-tone="success"] { background: var(--dsw-alias-state-success-primary, #20a162); box-shadow: 0 0 0 3px color-mix(in srgb, var(--dsw-alias-state-success-primary, #20a162) 14%, transparent); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="warning"] { background: var(--dsw-alias-state-warn-primary, #d97706); }
 .dim-panel .dim-botCard .dim-healthDot[data-tone="error"] { background: var(--dsw-alias-state-error-primary, #d54941); }
-.dim-panel .dim-botMetrics { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; margin: 12px 0; }
-.dim-panel .dim-botMetric { min-width: 0; padding: 10px; border: 0; border-radius: 9px; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-panel .dim-botMetrics { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; margin: 8px 0; }
+.dim-panel .dim-botMetric { min-width: 0; padding: 8px; border: 0; border-radius: 9px; background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-panel .dim-botMetric dt { margin: 0; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; font-weight: 400; line-height: normal; }
 .dim-panel .dim-botMetric dd { overflow: hidden; margin: 5px 0 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 13px; font-weight: 400; line-height: normal; text-overflow: ellipsis; white-space: nowrap; }
 .dim-panel .dim-botCard .dim-cardFooter { margin-top: 0; }
@@ -182,6 +204,7 @@ const CSS = String.raw`
 @media (max-width: 560px) {
   .dim-title { flex-direction: column; gap: 10px; }
   .dim-title p { white-space: normal; }
+  .dim-githubTooltip { right: auto; left: 0; }
   .dim-rail { grid-template-columns: minmax(0, 1fr); }
 }
 @media (prefers-reduced-motion: reduce) {

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();
     }
   };
 }