@xmanrui/dsh-im 0.17.0 → 0.18.0

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

@@ -5,6 +5,10 @@ import {
   SET_WORKSPACE_ENDPOINT,
   validWorkspacePayload,
 } from '../shared/workspace-rpc.mjs';
+import {
+  SET_AGENT_PRESET_ENDPOINT,
+  validAgentPresetPayload,
+} from '../shared/agent-preset-rpc.mjs';
 import {
   connectionTestTargetUnavailable,
   publicConnectionTestResult,
@@ -20,6 +24,7 @@ export const WEIXIN_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
+  setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
 export const WEIXIN_RPC_ENDPOINTS = Object.freeze(Object.values(WEIXIN_ENDPOINTS));
 
@@ -74,6 +79,10 @@ function payloadFailure(endpoint, payload) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
   }
+  if (endpoint === WEIXIN_ENDPOINTS.setAgentPreset) {
+    return validAgentPresetPayload(payload)
+      ? null : '请选择 Agent Preset。';
+  }
   return 'Unknown Weixin endpoint.';
 }
 
@@ -198,6 +207,12 @@ export function createWeixinRpcHandler(controller, { encodeQr = qrDataUrl } = {}
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WEIXIN_ENDPOINTS.setAgentPreset) {
+        if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
+        value = await publicStatus(
+          await controller.updateAgentPreset(payload.botId, payload.agentPreset),
+          cachedEncode,
+        );
       } else {
         value = await publicStatus(await controller.deleteBot(payload.botId), cachedEncode);
       }

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

@@ -14,6 +14,7 @@ import {
   createWorkspaceAwareController,
   observeBotWorkspaceRemovals,
 } from '../../../../src/channels/shared/bot-workspace-store.mjs';
+import { listAgentPresetCatalog } from '../../../../src/channels/shared/agent-preset.mjs';
 import { createTokenConnectionSupervisor } from '../shared/connection-supervisor.mjs';
 import { createHarnessCommandExecutor } from '../../harness-command-executor.mjs';
 import { createHarnessSessionExecutors } from '../../harness-session-coordinator.mjs';
@@ -64,7 +65,9 @@ export async function createProductionController(ctx, config = {}, internals = {
     ?? 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)));
+  await Promise.all(configuredBots.map((bot) => workspaces.ensure(bot.botId, {
+    defaultAgentPreset: config.agentPreset,
+  })));
   const observedConfigStore = typeof configStore.remove === 'function'
     ? observeBotWorkspaceRemovals(configStore, { workspaces })
     : configStore;
@@ -86,7 +89,6 @@ export async function createProductionController(ctx, config = {}, internals = {
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),
@@ -100,7 +102,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     logger,
     createRuntime: async ({ botId, config: botConfig, authDir }) => {
       const state = await stateFor(botId);
-      await workspaces.ensure(botId);
+      await workspaces.ensure(botId, { defaultAgentPreset: config.agentPreset });
       const workspaceScope = createBotWorkspaceScope(harness, { botId, workspaces, state });
       return new Runtime({
         config: botConfig,
@@ -136,7 +138,11 @@ export async function createProductionController(ctx, config = {}, internals = {
       }
     },
   });
-  const controller = createWorkspaceAwareController(coreController, { workspaces, stateFor });
+  const controller = createWorkspaceAwareController(coreController, {
+    workspaces,
+    stateFor,
+    agentPresetCatalog: () => listAgentPresetCatalog(ctx),
+  });
   const supervisor = createSupervisor({
     channel: 'whatsapp',
     controller,

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

@@ -3,6 +3,7 @@ import QRCode from 'qrcode';
 import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
+import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
 
 export const WHATSAPP_RPC_CHANNEL = '/whatsapp';
 export const WHATSAPP_ENDPOINTS = Object.freeze({
@@ -13,6 +14,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   reconnectBot: 'bot.reconnect',
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
+  setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
 });
 export const WHATSAPP_RPC_ENDPOINTS = Object.freeze(Object.values(WHATSAPP_ENDPOINTS));
 
@@ -52,6 +54,10 @@ function payloadFailure(endpoint, payload) {
     return validWorkspacePayload(payload)
       ? null : '请输入工作区绝对路径。';
   }
+  if (endpoint === WHATSAPP_ENDPOINTS.setAgentPreset) {
+    return validAgentPresetPayload(payload)
+      ? null : '请选择 Agent Preset。';
+  }
   return 'Unknown WhatsApp endpoint.';
 }
 
@@ -154,6 +160,12 @@ export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } =
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WHATSAPP_ENDPOINTS.setAgentPreset) {
+        if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
+        value = await publicStatus(
+          await controller.updateAgentPreset(payload.botId, payload.agentPreset),
+          cachedEncode,
+        );
       } else {
         value = await publicStatus(await controller.deleteBot(payload.botId), cachedEncode);
       }

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.17.0)',
+          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 0.18.0)',
         },
         ...(body === undefined ? {} : { body: JSON.stringify(body) }),
         signal: requestSignal(signal, timeoutMs),

package/src/channels/shared/agent-preset.mjs

@@ -0,0 +1,74 @@
+/** Matches DeepSeek Harness agent-preset directory ids. */
+export const AGENT_PRESET_ID = /^[a-z0-9][a-z0-9-]*$/;
+
+export const EMPTY_AGENT_PRESET_CATALOG = Object.freeze({
+  defaultId: '',
+  items: Object.freeze([]),
+});
+
+export function normalizeAgentPresetId(value) {
+  if (value == null) return null;
+  if (typeof value !== 'string') return null;
+  const id = value.trim();
+  return AGENT_PRESET_ID.test(id) ? id : null;
+}
+
+export function validateAgentPresetId(value) {
+  if (value == null || value === '') return null;
+  const id = normalizeAgentPresetId(value);
+  if (!id) {
+    const error = new Error('Agent Preset 无效。');
+    error.code = 'agent-preset-invalid';
+    throw error;
+  }
+  return id;
+}
+
+function catalogItem(value) {
+  if (typeof value === 'string') {
+    const id = normalizeAgentPresetId(value);
+    return id ? { id, label: id } : null;
+  }
+  if (!value || typeof value !== 'object') return null;
+  if (value.broken !== undefined) return null;
+  const id = normalizeAgentPresetId(value.id);
+  if (!id) return null;
+  const label = typeof value.name === 'string' && value.name.trim()
+    ? value.name.trim().slice(0, 128)
+    : typeof value.label === 'string' && value.label.trim()
+      ? value.label.trim().slice(0, 128)
+      : id;
+  return { id, label };
+}
+
+export function normalizeAgentPresetCatalog(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return { defaultId: '', items: [] };
+  }
+  const items = [];
+  const seen = new Set();
+  for (const entry of Array.isArray(value.items) ? value.items : []) {
+    const item = catalogItem(entry);
+    if (!item || seen.has(item.id)) continue;
+    seen.add(item.id);
+    items.push(item);
+  }
+  return {
+    defaultId: normalizeAgentPresetId(value.defaultId) ?? '',
+    items,
+  };
+}
+
+export async function listAgentPresetCatalog(ctx) {
+  try {
+    const service = typeof ctx?.get === 'function' ? ctx.get('agentPresets') : ctx?.agentPresets;
+    if (!service || typeof service.list !== 'function') return { defaultId: '', items: [] };
+    const listed = await service.list();
+    return normalizeAgentPresetCatalog({
+      defaultId: typeof service.defaultId === 'string' ? service.defaultId : '',
+      items: Array.isArray(listed) ? listed : [],
+    });
+  } catch {
+    return { defaultId: '', items: [] };
+  }
+}

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

@@ -9,6 +9,10 @@ import {
 } from 'node:fs/promises';
 import { dirname, isAbsolute, resolve } from 'node:path';
 
+import {
+  normalizeAgentPresetCatalog,
+  validateAgentPresetId,
+} from './agent-preset.mjs';
 import { CONNECTION_TEST_STATE_IDENTITY } from './connection-test.mjs';
 import { WORKSPACE_SESSION_STALE } from './workspace-session.mjs';
 
@@ -49,7 +53,22 @@ function normalizeDocument(value) {
       || typeof workspace !== 'string' || !isAbsolute(workspace)) return null;
     workspaces[botId] = resolve(workspace);
   }
-  return { version: 1, workspaces };
+  let agentPresets = {};
+  if (value.agentPresets !== undefined) {
+    if (!value.agentPresets || typeof value.agentPresets !== 'object'
+      || Array.isArray(value.agentPresets)) return null;
+    for (const [botId, agentPreset] of Object.entries(value.agentPresets)) {
+      if (!/^[A-Za-z0-9_-]{1,128}$/.test(botId)) return null;
+      try {
+        const normalized = validateAgentPresetId(agentPreset);
+        if (!normalized) return null;
+        agentPresets[botId] = normalized;
+      } catch {
+        return null;
+      }
+    }
+  }
+  return { version: 1, workspaces, agentPresets };
 }
 
 export async function validateWorkspacePath(value) {
@@ -79,6 +98,7 @@ export class BotWorkspaceStore {
   #path;
   #defaultWorkspace;
   #workspaces = {};
+  #agentPresets = {};
   #generations = new Map();
   #nextGeneration = 1;
   #incarnations = new Map();
@@ -100,9 +120,11 @@ export class BotWorkspaceStore {
       const normalized = normalizeDocument(JSON.parse(await readFile(this.#path, 'utf8')));
       if (!normalized) throw new Error('dsh-im workspace config is invalid');
       this.#workspaces = normalized.workspaces;
+      this.#agentPresets = normalized.agentPresets;
     } catch (error) {
       if (error?.code !== 'ENOENT') throw error;
       this.#workspaces = {};
+      this.#agentPresets = {};
     }
     this.#generations.clear();
     this.#nextGeneration = 1;
@@ -130,6 +152,10 @@ export class BotWorkspaceStore {
     return this.#workspaces[botIdOf(botId)] ?? this.#defaultWorkspace;
   }
 
+  agentPresetFor(botId) {
+    return this.#agentPresets[botIdOf(botId)] ?? null;
+  }
+
   generationFor(botId) {
     return this.#generations.get(botIdOf(botId)) ?? null;
   }
@@ -148,18 +174,24 @@ export class BotWorkspaceStore {
     }
   }
 
-  async ensure(botId, { workspace = this.#defaultWorkspace } = {}) {
+  async ensure(botId, { workspace = this.#defaultWorkspace, defaultAgentPreset } = {}) {
     const id = botIdOf(botId);
     const initialWorkspace = resolve(workspace);
     return this.#enqueue(id, async () => {
       if (!this.#workspaces[id]) {
+        const agentPreset = validateAgentPresetId(defaultAgentPreset);
+        const hadAgentPreset = Object.hasOwn(this.#agentPresets, id);
+        const previousAgentPreset = this.#agentPresets[id];
         this.#workspaces[id] = initialWorkspace;
+        if (agentPreset) this.#agentPresets[id] = agentPreset;
         this.#generations.set(id, this.#freshGeneration());
         this.#incarnations.set(id, this.#freshIncarnation());
         try {
           await this.#persist();
         } catch (error) {
           delete this.#workspaces[id];
+          if (hadAgentPreset) this.#agentPresets[id] = previousAgentPreset;
+          else delete this.#agentPresets[id];
           this.#generations.delete(id);
           this.#incarnations.delete(id);
           throw error;
@@ -207,6 +239,37 @@ export class BotWorkspaceStore {
     });
   }
 
+  async setAgentPreset(botId, value, { incarnation } = {}) {
+    const id = botIdOf(botId);
+    if (!this.has(id)
+      || (incarnation !== undefined && incarnation !== this.incarnationFor(id))) {
+      const error = new Error('找不到要修改的机器人。');
+      error.code = 'workspace-bot-not-found';
+      throw error;
+    }
+    const agentPreset = validateAgentPresetId(value);
+    return this.#enqueue(id, async () => {
+      if (!this.has(id)
+        || (incarnation !== undefined && incarnation !== this.incarnationFor(id))) {
+        const error = new Error('找不到要修改的机器人。');
+        error.code = 'workspace-bot-not-found';
+        throw error;
+      }
+      const previous = this.#agentPresets[id] ?? null;
+      if (previous === agentPreset) return agentPreset;
+      if (agentPreset) this.#agentPresets[id] = agentPreset;
+      else delete this.#agentPresets[id];
+      try {
+        await this.#persist();
+      } catch (error) {
+        if (previous) this.#agentPresets[id] = previous;
+        else delete this.#agentPresets[id];
+        throw error;
+      }
+      return agentPreset;
+    });
+  }
+
   async bindWorkspaceSession(botId, value, {
     conversationKey,
     sessionId,
@@ -353,7 +416,11 @@ export class BotWorkspaceStore {
 
   async reconcile(activeBotIds) {
     const active = new Set([...activeBotIds].map(botIdOf));
-    const candidates = new Set([...Object.keys(this.#workspaces), ...this.#dirtyRemovals]);
+    const candidates = new Set([
+      ...Object.keys(this.#workspaces),
+      ...Object.keys(this.#agentPresets),
+      ...this.#dirtyRemovals,
+    ]);
     for (const botId of candidates) {
       if (!active.has(botId)) await this.remove(botId);
     }
@@ -364,7 +431,11 @@ export class BotWorkspaceStore {
     return {
       ...status,
       bots: status.bots.map((bot) => bot?.botId
-        ? { ...bot, workspace: this.workspaceFor(bot.botId) }
+        ? {
+          ...bot,
+          workspace: this.workspaceFor(bot.botId),
+          agentPreset: this.agentPresetFor(bot.botId),
+        }
         : bot),
     };
   }
@@ -392,8 +463,10 @@ export class BotWorkspaceStore {
 
   async #retireCurrentIncarnation(id) {
     const hadWorkspace = Object.hasOwn(this.#workspaces, id);
-    const needsCleanup = hadWorkspace || this.#dirtyRemovals.has(id);
+    const hadPreset = Object.hasOwn(this.#agentPresets, id);
+    const needsCleanup = hadWorkspace || hadPreset || this.#dirtyRemovals.has(id);
     delete this.#workspaces[id];
+    delete this.#agentPresets[id];
     this.#generations.delete(id);
     this.#incarnations.delete(id);
     if (!needsCleanup) return {
@@ -425,6 +498,9 @@ export class BotWorkspaceStore {
 
   async #persist() {
     const document = { version: 1, workspaces: this.#workspaces };
+    if (Object.keys(this.#agentPresets).length > 0) {
+      document.agentPresets = this.#agentPresets;
+    }
     await mkdir(dirname(this.#path), { recursive: true, mode: 0o700 });
     const temporary = `${this.#path}.tmp`;
     await writeFile(temporary, `${JSON.stringify(document, null, 2)}\n`, {
@@ -436,7 +512,8 @@ export class BotWorkspaceStore {
   }
 
   async #persistCurrentDocument() {
-    if (Object.keys(this.#workspaces).length > 0) {
+    if (Object.keys(this.#workspaces).length > 0
+      || Object.keys(this.#agentPresets).length > 0) {
       await this.#persist();
       return;
     }
@@ -450,10 +527,29 @@ export class BotWorkspaceStore {
   }
 }
 
-function decorateResult(workspaces, result) {
+function resolveAgentPresetCatalog(catalog) {
+  if (!catalog) return null;
+  const value = typeof catalog === 'function' ? catalog() : catalog;
+  return value && typeof value.then === 'function'
+    ? value.then(normalizeAgentPresetCatalog)
+    : normalizeAgentPresetCatalog(value);
+}
+
+function decorateResult(workspaces, result, catalog) {
+  const decorate = (value) => {
+    const decorated = workspaces.decorateStatus(value);
+    if (!catalog || !decorated || typeof decorated !== 'object') return decorated;
+    const attachCatalog = (agentPresetCatalog) => (
+      agentPresetCatalog ? { ...decorated, agentPresetCatalog } : decorated
+    );
+    const agentPresetCatalog = resolveAgentPresetCatalog(catalog);
+    return agentPresetCatalog && typeof agentPresetCatalog.then === 'function'
+      ? agentPresetCatalog.then(attachCatalog)
+      : attachCatalog(agentPresetCatalog);
+  };
   return result && typeof result.then === 'function'
-    ? result.then((value) => workspaces.decorateStatus(value))
-    : workspaces.decorateStatus(result);
+    ? result.then(decorate)
+    : decorate(result);
 }
 
 function targetStatus(controller) {
@@ -608,9 +704,11 @@ export function createBotWorkspaceScope(harness, { botId, workspaces, state }) {
             throw error;
           }
           const generation = workspaces.generationFor(botId);
+          const agentPreset = workspaces.agentPresetFor(botId);
           const sessionId = await target.createSession({
             ...options,
             workspace: workspaces.workspaceFor(botId),
+            ...(agentPreset == null ? {} : { agentPreset }),
           });
           sessionGenerations.set(sessionId, generation);
           return sessionId;
@@ -765,7 +863,7 @@ export function createBotScopedHarness(harness, options) {
   return createBotWorkspaceScope(harness, options).harness;
 }
 
-export function createWorkspaceAwareController(controller, { workspaces, stateFor }) {
+export function createWorkspaceAwareController(controller, { workspaces, stateFor, agentPresetCatalog } = {}) {
   if (!controller || !workspaces || typeof stateFor !== 'function') {
     throw new TypeError('controller, workspaces, and stateFor are required');
   }
@@ -778,6 +876,7 @@ export function createWorkspaceAwareController(controller, { workspaces, stateFo
       if (transitions.get(botId) === current) transitions.delete(botId);
     });
   };
+  const decorate = (value) => decorateResult(workspaces, value, agentPresetCatalog);
   const updateWorkspace = (botId, workspace) => {
     // Capture at API invocation, before even waiting for an older outer
     // transition. A queued request still belongs to the incarnation that the
@@ -795,7 +894,34 @@ export function createWorkspaceAwareController(controller, { workspaces, stateFo
         clearSessions: () => state.clearSessions(),
         incarnation,
       });
-      return workspaces.decorateStatus(await controller.status());
+      return decorate(await controller.status());
+    });
+  };
+  const updateAgentPreset = (botId, agentPreset) => {
+    const incarnation = workspaces.incarnationFor(botId);
+    const normalizedAgentPreset = validateAgentPresetId(agentPreset);
+    return withBotTransition(botId, async () => {
+      const snapshot = await controller.status();
+      if (!snapshot?.bots?.some((bot) => bot?.botId === botId)) {
+        const error = new Error('找不到要修改的机器人。');
+        error.code = 'workspace-bot-not-found';
+        throw error;
+      }
+      const catalog = normalizedAgentPreset && agentPresetCatalog
+        ? await resolveAgentPresetCatalog(agentPresetCatalog)
+        : null;
+      if (normalizedAgentPreset && agentPresetCatalog
+        && !catalog?.items.some((item) => item.id === normalizedAgentPreset)) {
+        const error = new Error('Agent Preset 不存在或不可用。');
+        error.code = 'agent-preset-unavailable';
+        throw error;
+      }
+      await workspaces.setAgentPreset(botId, normalizedAgentPreset, { incarnation });
+      return decorateResult(
+        workspaces,
+        await controller.status(),
+        catalog ?? agentPresetCatalog,
+      );
     });
   };
   const deleteWithWorkspace = (botId, invokeDelete) => withBotTransition(botId, async () => {
@@ -822,7 +948,7 @@ export function createWorkspaceAwareController(controller, { workspaces, stateFo
     try {
       const result = await invokeDelete();
       await workspaces.finishRemoval(removal);
-      return workspaces.decorateStatus(result);
+      return decorate(result);
     } catch (error) {
       const after = await targetStatus(controller).catch(() => null);
       const knownAbsent = Array.isArray(after?.bots)
@@ -836,6 +962,7 @@ export function createWorkspaceAwareController(controller, { workspaces, stateFo
   return new Proxy(controller, {
     get(target, property) {
       if (property === 'updateWorkspace') return updateWorkspace;
+      if (property === 'updateAgentPreset') return updateAgentPreset;
       const value = Reflect.get(target, property, target);
       if (typeof value !== 'function') return value;
       if (property === 'deleteBot') {
@@ -848,11 +975,11 @@ export function createWorkspaceAwareController(controller, { workspaces, stateFo
         return async (...args) => {
           const before = await target.status();
           const botId = before?.bots?.[0]?.botId;
-          if (!botId) return decorateResult(workspaces, value.apply(target, args));
+          if (!botId) return decorate(value.apply(target, args));
           return deleteWithWorkspace(botId, () => value.apply(target, args));
         };
       }
-      return (...args) => decorateResult(workspaces, value.apply(target, args));
+      return (...args) => decorate(value.apply(target, args));
     },
   });
 }

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

@@ -592,11 +592,13 @@ export class HarnessClient {
   }
 
   async createSession(options = {}) {
-    await this.ensureRunning(options);
-    const workspaceId = await this.workspaceId(options);
+    const { agentPreset: requestedPreset, ...rpcOptions } = options;
+    await this.ensureRunning(rpcOptions);
+    const workspaceId = await this.workspaceId(rpcOptions);
     const payload = { workspaceId };
-    if (this.#agentPreset !== undefined) payload.agentPreset = this.#agentPreset;
-    const created = await this.rpc('session.create', payload, 30_000, options);
+    const agentPreset = requestedPreset !== undefined ? requestedPreset : this.#agentPreset;
+    if (agentPreset != null) payload.agentPreset = agentPreset;
+    const created = await this.rpc('session.create', payload, 30_000, rpcOptions);
     return created.sessionId;
   }
 

package/src/channels/shared/image-prompt.mjs

@@ -13,6 +13,18 @@ export class ImagePromptError extends Error {
   }
 }
 
+const HOST_ATTACHMENT_USER_MESSAGES = Object.freeze({
+  MODEL_DOES_NOT_SUPPORT_IMAGES:
+    '当前模型不支持图片，请用 /models 查看可用模型，再用 /model <序号> 切换后重发。',
+  IMAGE_TOO_LARGE: '图片超过宿主允许的大小，请压缩后重试。',
+  IMAGE_TOO_MANY_PIXELS: '图片分辨率过高，请压缩后重试。',
+  INVALID_IMAGE: '图片内容无效或格式不受支持，请重新发送。',
+  INVALID_IMAGE_BASE64: '未能读取图片内容，请重新发送。',
+  IMAGE_TYPE_MISMATCH: '图片格式与实际内容不一致，请重新发送。',
+  TOO_MANY_IMAGES: '一次发送的图片数量超过宿主限制，请减少后重试。',
+  IMAGES_TOO_LARGE: '图片总大小超过宿主限制，请减少图片或压缩后重试。',
+});
+
 function requestSignal(signal, timeoutMs) {
   const timeout = AbortSignal.timeout(timeoutMs);
   return signal ? AbortSignal.any([signal, timeout]) : timeout;
@@ -263,6 +275,25 @@ export async function promptContentForMessage(message, {
   return content;
 }
 
+/** Return only allowlisted, user-safe image failure details. */
+export function imagePromptDiagnostic(error) {
+  if (error instanceof ImagePromptError) {
+    return {
+      code: 'image-prompt-error',
+      reason: error.code,
+      userMessage: error.userMessage,
+    };
+  }
+  if (error?.code !== 'attachment-error' || typeof error?.details?.reason !== 'string') {
+    return null;
+  }
+  const reason = error.details.reason;
+  const userMessage = Object.hasOwn(HOST_ATTACHMENT_USER_MESSAGES, reason)
+    ? HOST_ATTACHMENT_USER_MESSAGES[reason]
+    : null;
+  return userMessage ? { code: 'attachment-error', reason, userMessage } : null;
+}
+
 export function imagePromptUserMessage(error) {
-  return error instanceof ImagePromptError ? error.userMessage : null;
+  return imagePromptDiagnostic(error)?.userMessage ?? null;
 }

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

@@ -184,7 +184,7 @@ function authenticatedHeaders(token) {
 function baseInfo() {
   return {
     channel_version: WEIXIN_PROTOCOL_VERSION,
-    bot_agent: 'DeepSeekHarness/0.17.0',
+    bot_agent: 'DeepSeekHarness/0.18.0',
   };
 }