@xmanrui/dsh-im 0.19.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "0.19.0",
+  "version": "1.0.1",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

package/plugin-src/client/i18n.js

@@ -305,7 +305,14 @@ const EN = Object.freeze({
   '微信已授权，但登录凭据无法写入 DSH 凭据存储。请检查凭据存储是否可写。': 'WeChat was authorized, but the login credential could not be written to the DSH credential store. Check that the store is writable.',
   '微信已授权，但账号配置无法写入本机。请检查 DSH_HOME 目录权限。': 'WeChat was authorized, but the account configuration could not be saved locally. Check the DSH_HOME directory permissions.',
   '微信已授权，但无法初始化账号状态或工作区。请检查 DSH_HOME 和工作区目录。': 'WeChat was authorized, but the account state or workspace could not be initialized. Check DSH_HOME and the workspace directory.',
-  '微信已授权，但插件无法连接本机 Harness。请确认 dsh web 已正常启动。': 'WeChat was authorized, but the plugin could not reach the local Harness. Confirm that dsh web is running normally.',
+  '微信已授权，但插件无法连接本机 Harness。请检查 dsh web 地址和端口。': 'WeChat was authorized, but the plugin could not connect to the local Harness. Check the dsh web address and port.',
+  '微信已授权，但 Harness 健康检查超时。请确认 dsh web 未阻塞。': 'WeChat was authorized, but the Harness health check timed out. Confirm that dsh web is not blocked.',
+  '微信已授权，但 Harness 拒绝了本机健康检查。请检查 Host 信任配置。': 'WeChat was authorized, but Harness denied the local health check. Check the Host trust configuration.',
+  '微信已授权，但找不到 Harness 健康检查接口。请确认 Harness 与插件版本兼容。': 'WeChat was authorized, but the Harness health endpoint was not found. Confirm that Harness and the plugin are compatible.',
+  '微信已授权，但 Harness 健康检查返回服务错误。请查看 dsh web 日志。': 'WeChat was authorized, but the Harness health check returned a service error. Check the dsh web logs.',
+  '微信已授权，但 Harness 返回了无法识别的响应。请确认 Harness 与插件版本兼容。': 'WeChat was authorized, but Harness returned an unrecognized response. Confirm that Harness and the plugin are compatible.',
+  '微信已授权，但 Harness 拒绝了健康检查请求。请查看 dsh web 日志。': 'WeChat was authorized, but Harness rejected the health-check request. Check the dsh web logs.',
+  '微信已授权，但 Harness 健康检查发生未知错误。请查看 dsh web 日志。': 'WeChat was authorized, but the Harness health check failed unexpectedly. Check the dsh web logs.',
   '微信已授权，但消息连接初始化失败。请查看 dsh web 日志后重试。': 'WeChat was authorized, but the message connection could not be initialized. Check the dsh web logs and try again.',
   '微信已授权，但激活过程中发生未知错误。请查看 dsh web 日志。': 'WeChat was authorized, but an unknown error occurred during activation. Check the dsh web logs.',
   '微信已绑定，可以开始向已绑定的机器人发消息。': 'WeChat is connected and ready for messages.',

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

@@ -53,6 +53,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger('dsh-dingtalk')
     : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -106,7 +107,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     createRuntime: async ({ botId, config: botConfig, clientSecret }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new Runtime({
         config: botConfig,
         clientSecret,
@@ -140,7 +143,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     controller,

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

@@ -66,6 +66,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger('dsh-feishu')
     : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -136,7 +137,9 @@ export async function createProductionController(ctx, config = {}, internals = {
       const state = await stateFor(botConfig);
       const id = botId ?? botConfig.id ?? botConfig.appId;
       await workspaces.ensure(id, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId: id, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId: id, workspaces, state, agentPresetCatalog,
+      });
       return new Runtime({
         lark,
         botId: id,
@@ -170,7 +173,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor: stateForBotId,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
 
   const supervisor = createSupervisor({

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

@@ -50,6 +50,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const QrAuth = internals.QrAuth ?? QqQrAuth;
   const createSupervisor = internals.createConnectionSupervisor ?? createConnectionSupervisor;
   const logger = typeof ctx.logger === 'function' ? ctx.logger('dsh-im:qq') : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -97,7 +98,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     createRuntime: async ({ botId, config: botConfig, appSecret }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new Runtime({
         config: botConfig,
         appSecret,
@@ -130,7 +133,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     controller,

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

@@ -52,6 +52,7 @@ export async function createTokenProductionController(ctx, config, internals, de
   const createSupervisor = internals.createConnectionSupervisor ?? createTokenConnectionSupervisor;
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger(`dsh-im:${channel}`) : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config, channel);
   const configStore = await new ResolvedConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -98,7 +99,9 @@ export async function createTokenProductionController(ctx, config, internals, de
     createRuntime: async ({ botId, config: botConfig, token }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new ResolvedRuntime({
         ...channelRuntimeOptions,
         config: botConfig,
@@ -132,7 +135,7 @@ export async function createTokenProductionController(ctx, config, internals, de
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     channel,

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

@@ -30,6 +30,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const createSupervisor = internals.createConnectionSupervisor ?? createTokenConnectionSupervisor;
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger('dsh-im:slack') : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config, 'slack');
   const configStore = await new ResolvedConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -76,7 +77,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     createRuntime: async ({ botId, config: botConfig, botToken, appToken }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new ResolvedRuntime({
         config: botConfig,
         botToken,
@@ -110,7 +113,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     channel: 'slack',

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

@@ -50,6 +50,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const QrAuth = internals.QrAuth ?? WecomQrAuth;
   const createSupervisor = internals.createConnectionSupervisor ?? createConnectionSupervisor;
   const logger = typeof ctx.logger === 'function' ? ctx.logger('dsh-im:wecom') : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -100,7 +101,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     createRuntime: async ({ botId, config: botConfig, secret }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new Runtime({
         config: botConfig,
         secret,
@@ -134,7 +137,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     controller,

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

@@ -53,6 +53,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger('dsh-weixin')
     : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
@@ -100,7 +101,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     createRuntime: async ({ botId, config: accountConfig, token }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new Runtime({
         api,
         config: accountConfig,
@@ -134,7 +137,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     controller,

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

@@ -50,6 +50,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   if (!ctx?.webServer) throw new TypeError('dsh-im WhatsApp requires ctx.webServer');
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger('dsh-im:whatsapp') : (ctx.logger ?? console);
+  const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const ConfigStore = internals.ConfigStore ?? WhatsappConfigStore;
   const StateStore = internals.StateStore ?? WhatsappStateStore;
   const Harness = internals.HarnessClient ?? WhatsappHarnessClient;
@@ -103,7 +104,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     createRuntime: async ({ botId, config: botConfig, authDir }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
-      const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
+      const workspaceScope = createBotWorkspaceScope(harness, {
+        botId, workspaces, state, agentPresetCatalog,
+      });
       return new Runtime({
         config: botConfig,
         authDir,
@@ -141,7 +144,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const controller = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
-    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+    agentPresetCatalog,
   });
   const supervisor = createSupervisor({
     channel: 'whatsapp',

package/src/channels/dingtalk/dingtalk-bridge.mjs

@@ -18,6 +18,10 @@ import {
   isModelCommand,
   runModelCommand,
 } from '../shared/model-command.mjs';
+import {
+  isPresetCommand,
+  runPresetCommand,
+} from '../shared/preset-command.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 import {
@@ -44,6 +48,10 @@ const HELP_TEXT = [
   '/models  按序号列出所有可用模型',
   '/model [序号或完整模型ID]  查看或切换当前会话模型',
   '示例：先发 /models，再发 /model 2',
+  '/presetlist  按序号列出可用 Agent Preset',
+  '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset',
+  '纯数字 ID：/preset id:<ID>',
+  '/preset --default  跟随 Host 默认',
   '/stop  停止当前任务',
   '/steer 补充指令  纠偏当前任务',
   '/status  检查连接状态',
@@ -336,7 +344,9 @@ export class DingtalkHarnessBridge {
     const commandText = nonEmptyString(promptMessage.content) ?? '';
     const commandRunner = isControlCommand(commandText)
       ? runControlCommand
-      : (isModelCommand(commandText) ? runModelCommand : null);
+      : (isModelCommand(commandText)
+          ? runModelCommand
+          : (isPresetCommand(commandText) ? runPresetCommand : null));
     const addressed = String(message.conversationType) !== '2' || message?.isInAtList === true;
     if (commandRunner && sessionWebhook && addressed) {
       let task;

package/src/channels/discord/discord-api.mjs

@@ -108,7 +108,7 @@ export class DiscordApi {
         headers: {
           authorization: `Bot ${this.#token}`,
           'content-type': 'application/json',
-          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 0.19.0)',
+          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 1.0.1)',
         },
         ...(body === undefined ? {} : { body: JSON.stringify(body) }),
         signal: requestSignal(signal, timeoutMs),

package/src/channels/feishu/bridge.mjs

@@ -28,6 +28,10 @@ import {
   isModelCommand,
   runModelCommand,
 } from '../shared/model-command.mjs';
+import {
+  isPresetCommand,
+  runPresetCommand,
+} from '../shared/preset-command.mjs';
 import { runWorkspaceCommand, resolveSessionListWorkspace, workspacePathSnapshot } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 import {
@@ -88,6 +92,10 @@ const HELP_TEXT = [
   '/models  按序号列出所有可用模型',
   '/model [序号或完整模型ID]  查看或切换当前会话模型',
   '示例：先发 /models，再发 /model 2',
+  '/presetlist  按序号列出可用 Agent Preset',
+  '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset',
+  '纯数字 ID：/preset id:<ID>',
+  '/preset --default  跟随 Host 默认',
   '/stop  停止当前任务',
   '/steer 补充指令  纠偏当前任务',
   '/status  检查连接状态',
@@ -389,7 +397,9 @@ export class FeishuHarnessBridge {
     const commandText = nonEmptyString(commandMessage.content) ?? '';
     const commandRunner = isControlCommand(commandText)
       ? runControlCommand
-      : (isModelCommand(commandText) ? runModelCommand : null);
+      : (isModelCommand(commandText)
+          ? runModelCommand
+          : (isPresetCommand(commandText) ? runPresetCommand : null));
     if (commandRunner && addressed) {
       const processing = this.#processFastCommand(
         event,

package/src/channels/feishu/feishu-cards.mjs

@@ -189,6 +189,10 @@ export function menuHelpText() {
     '/watch ID 或序号  关注会话（完成后推送）',
     '/compact  压缩上下文',
     '/workspace 绝对路径  切换工作区',
+    '/presetlist  列出可用 Agent Preset',
+    '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset',
+    '纯数字 ID：/preset id:<ID>',
+    '/preset --default  跟随 Host 默认',
   ].join('\n');
 }
 

package/src/channels/qq/qq-bridge.mjs

@@ -15,6 +15,10 @@ import {
   isModelCommand,
   runModelCommand,
 } from '../shared/model-command.mjs';
+import {
+  isPresetCommand,
+  runPresetCommand,
+} from '../shared/preset-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 import {
   fetchImageBuffer,
@@ -49,6 +53,10 @@ const HELP_TEXT = [
   '/models  按序号列出所有可用模型',
   '/model [序号或完整模型ID]  查看或切换当前会话模型',
   '示例：先发 /models，再发 /model 2',
+  '/presetlist  按序号列出可用 Agent Preset',
+  '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset',
+  '纯数字 ID：/preset id:<ID>',
+  '/preset --default  跟随 Host 默认',
   '/stop  停止当前任务',
   '/steer 补充指令  纠偏当前任务',
   '/status  检查连接状态',
@@ -201,7 +209,9 @@ export class QqHarnessBridge {
     const commandText = safeText(message);
     const commandRunner = isControlCommand(commandText)
       ? runControlCommand
-      : (isModelCommand(commandText) ? runModelCommand : null);
+      : (isModelCommand(commandText)
+          ? runModelCommand
+          : (isPresetCommand(commandText) ? runPresetCommand : null));
     const allowed = this.#ownerUserOpenid === '*' || sender === this.#ownerUserOpenid;
     const addressed = message.kind !== 'group'
       || message.rawEventType === 'GROUP_AT_MESSAGE_CREATE';

package/src/channels/shared/bot-workspace-store.mjs

@@ -535,6 +535,19 @@ function resolveAgentPresetCatalog(catalog) {
     : normalizeAgentPresetCatalog(value);
 }
 
+function unavailableAgentPreset() {
+  const error = new Error('Agent Preset 不存在或不可用。');
+  error.code = 'agent-preset-unavailable';
+  return error;
+}
+
+function assertCurrentBotScope(isCurrentScope) {
+  if (isCurrentScope()) return;
+  const error = new Error('找不到要修改的机器人。');
+  error.code = 'workspace-bot-not-found';
+  throw error;
+}
+
 function decorateResult(workspaces, result, catalog) {
   const decorate = (value) => {
     const decorated = workspaces.decorateStatus(value);
@@ -580,14 +593,74 @@ export function observeBotWorkspaceRemovals(
   });
 }
 
-export function createBotWorkspaceScope(harness, { botId, workspaces, state }) {
+export function createBotWorkspaceScope(
+  harness,
+  { botId, workspaces, state, agentPresetCatalog } = {},
+) {
   if (!harness || !workspaces || !state) throw new TypeError('harness, workspaces, and state are required');
   const incarnation = workspaces.incarnationFor(botId);
   const isCurrentScope = () => workspaces.has(botId)
     && workspaces.incarnationFor(botId) === incarnation;
+  const presetSettings = async (catalog = agentPresetCatalog) => {
+    let normalizedCatalog;
+    try {
+      normalizedCatalog = await resolveAgentPresetCatalog(catalog)
+        ?? normalizeAgentPresetCatalog(null);
+    } catch (error) {
+      assertCurrentBotScope(isCurrentScope);
+      throw error;
+    }
+    assertCurrentBotScope(isCurrentScope);
+    return {
+      agentPreset: workspaces.agentPresetFor(botId),
+      agentPresetCatalog: normalizedCatalog,
+    };
+  };
   const sessionGenerations = new Map();
   const scopedHarness = new Proxy(harness, {
     get(target, property) {
+      if (property === 'agentPresetSettings') {
+        return async (options = {}) => {
+          options?.signal?.throwIfAborted();
+          assertCurrentBotScope(isCurrentScope);
+          const settings = await presetSettings();
+          options?.signal?.throwIfAborted();
+          return settings;
+        };
+      }
+      if (property === 'updateAgentPreset') {
+        return async (value, options = {}) => {
+          options?.signal?.throwIfAborted();
+          assertCurrentBotScope(isCurrentScope);
+          const agentPreset = value === '--default' ? null : validateAgentPresetId(value);
+          let catalog = null;
+          if (agentPreset) {
+            ({ agentPresetCatalog: catalog } = await presetSettings());
+            options?.signal?.throwIfAborted();
+            if (!catalog.items.some((item) => item.id === agentPreset)) {
+              throw unavailableAgentPreset();
+            }
+          }
+          await workspaces.setAgentPreset(botId, agentPreset, { incarnation });
+          assertCurrentBotScope(isCurrentScope);
+          if (catalog) {
+            return {
+              agentPreset: workspaces.agentPresetFor(botId),
+              agentPresetCatalog: catalog,
+            };
+          }
+          try {
+            return await presetSettings();
+          } catch (error) {
+            if (error?.code === 'workspace-bot-not-found') throw error;
+            assertCurrentBotScope(isCurrentScope);
+            return {
+              agentPreset: workspaces.agentPresetFor(botId),
+              agentPresetCatalog: normalizeAgentPresetCatalog(null),
+            };
+          }
+        };
+      }
       if (property === 'currentWorkspace') {
         return () => {
           if (!isCurrentScope()) {
@@ -912,9 +985,7 @@ export function createWorkspaceAwareController(controller, { workspaces, stateFo
         : null;
       if (normalizedAgentPreset && agentPresetCatalog
         && !catalog?.items.some((item) => item.id === normalizedAgentPreset)) {
-        const error = new Error('Agent Preset 不存在或不可用。');
-        error.code = 'agent-preset-unavailable';
-        throw error;
+        throw unavailableAgentPreset();
       }
       await workspaces.setAgentPreset(botId, normalizedAgentPreset, { incarnation });
       return decorateResult(

package/src/channels/shared/harness-client.mjs

@@ -364,6 +364,26 @@ export class HarnessRpcError extends Error {
   }
 }
 
+export class HarnessTransportError extends Error {
+  constructor(code, method, { cause, status } = {}) {
+    const statusDetail = Number.isInteger(status) ? `, HTTP ${status}` : '';
+    super(`Harness ${method} transport failed (${code}${statusDetail})`, { cause });
+    this.name = 'HarnessTransportError';
+    this.code = code;
+    this.method = method;
+    if (Number.isInteger(status)) this.status = status;
+  }
+}
+
+export class HarnessHealthError extends Error {
+  constructor(cause) {
+    super('Harness health RPC was rejected', { cause });
+    this.name = 'HarnessHealthError';
+    this.code = 'harness-rpc-rejected';
+    this.method = 'host.describe';
+  }
+}
+
 export class HarnessInteractionError extends Error {
   constructor(code, message) {
     super(message);
@@ -455,24 +475,60 @@ export class HarnessClient {
     const signal = options.signal
       ? AbortSignal.any([options.signal, timeoutSignal])
       : timeoutSignal;
-    const response = await this.#fetch(new URL(`/api/${method}`, this.#baseUrl), {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ type: 'client-request', rpcId, method, payload }),
-      signal,
-    });
-    if (!response.ok) throw new Error(`Harness transport ${method} failed: HTTP ${response.status}`);
-    const body = await response.json();
+    let response;
+    try {
+      response = await this.#fetch(new URL(`/api/${method}`, this.#baseUrl), {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ type: 'client-request', rpcId, method, payload }),
+        signal,
+      });
+    } catch (error) {
+      // Preserve an explicit caller cancellation; it is control flow, not a
+      // Harness availability diagnosis.
+      if (options.signal?.aborted) throw error;
+      throw new HarnessTransportError(
+        timeoutSignal.aborted ? 'harness-timeout' : 'harness-connect-failed',
+        method,
+        { cause: error },
+      );
+    }
+    if (!response.ok) {
+      const code = response.status === 401 || response.status === 403
+        ? 'harness-access-denied'
+        : response.status === 404
+          ? 'harness-api-not-found'
+          : 'harness-http-failed';
+      throw new HarnessTransportError(code, method, { status: response.status });
+    }
+    let body;
+    try {
+      body = await response.json();
+    } catch (error) {
+      throw new HarnessTransportError('harness-response-invalid', method, { cause: error });
+    }
     if (body?.type !== 'server-response' || body?.rpcId !== rpcId) {
-      throw new Error(`Harness returned an invalid response for ${method}`);
+      throw new HarnessTransportError('harness-response-invalid', method, {
+        cause: new Error(`Harness returned an invalid response for ${method}`),
+      });
+    }
+    if (!body.result || typeof body.result !== 'object' || typeof body.result.ok !== 'boolean') {
+      throw new HarnessTransportError('harness-response-invalid', method, {
+        cause: new Error(`Harness returned an invalid result for ${method}`),
+      });
     }
     if (!body.result?.ok) throw new HarnessRpcError(method, body.result?.error);
     return body.result.value;
   }
 
   async health(options = {}) {
-    await this.rpc('host.describe', {}, 5_000, options);
-    return true;
+    try {
+      await this.rpc('host.describe', {}, 5_000, options);
+      return true;
+    } catch (error) {
+      if (error instanceof HarnessRpcError) throw new HarnessHealthError(error);
+      throw error;
+    }
   }
 
   async ensureRunning(options = {}) {
@@ -506,7 +562,8 @@ export class HarnessClient {
         lastError = error;
       }
     }
-    throw new Error(`Harness did not become ready: ${lastError?.message ?? 'timeout'}`);
+    if (lastError) throw lastError;
+    throw new HarnessTransportError('harness-timeout', 'host.describe');
   }
 
   async listWorkspaces(options = {}) {