@xmanrui/dsh-im 0.9.0 → 0.11.0

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

@@ -1,4 +1,5 @@
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
+import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import {
   publicWorkspaceError,
   SET_WORKSPACE_ENDPOINT,
@@ -53,7 +54,8 @@ function payloadFailure(endpoint, payload) {
       ? null : 'bot.bind-credentials requires xoxb Bot Token and xapp App Token.';
   }
   if (endpoint === SLACK_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
+    return exactKeys(payload, ['botId', 'sendTest']) && validId(payload.botId)
+      && (payload.sendTest === undefined || typeof payload.sendTest === 'boolean')
       ? null : 'bot.reconnect requires a botId.';
   }
   if (endpoint === SLACK_ENDPOINTS.deleteBot) {
@@ -114,7 +116,31 @@ export function createSlackRpcHandler(controller) {
       let value;
       if (endpoint === SLACK_ENDPOINTS.status) value = await controller.status();
       else if (endpoint === SLACK_ENDPOINTS.bindCredentials) value = await controller.bindCredentials(payload);
-      else if (endpoint === SLACK_ENDPOINTS.reconnectBot) value = await controller.reconnectBot(payload.botId);
+      else if (endpoint === SLACK_ENDPOINTS.reconnectBot) {
+        value = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        if (payload.sendTest === true) {
+          let testError = null;
+          try {
+            if (value?.bots?.find((bot) => bot?.botId === payload.botId)?.connected !== true) {
+              const unavailable = new Error('Bot is not connected');
+              unavailable.code = 'test-target-unavailable';
+              throw unavailable;
+            }
+            if (typeof controller.sendConnectionTest !== 'function') {
+              const unavailable = new Error('Connection test is unavailable');
+              unavailable.code = 'test-target-unavailable';
+              throw unavailable;
+            }
+            await controller.sendConnectionTest(payload.botId);
+          } catch (error) {
+            testError = error;
+          }
+          value = { ...value, testMessage: publicConnectionTestResult(testError) };
+        }
+      }
       else if (endpoint === SLACK_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await controller.updateWorkspace(payload.botId, payload.workspace);

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

@@ -78,7 +78,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),

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

@@ -1,6 +1,10 @@
 import QRCode from 'qrcode';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
+import {
+  connectionTestTargetUnavailable,
+  publicConnectionTestResult,
+} from '../../../../src/channels/shared/connection-test.mjs';
 
 export const WECOM_RPC_CHANNEL = '/wecom';
 export const WECOM_ENDPOINTS = Object.freeze({
@@ -53,7 +57,10 @@ function payloadFailure(endpoint, payload) {
       ? null : 'bot.bind-credentials requires Bot ID and Secret.';
   }
   if (endpoint === WECOM_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId) ? null : 'bot.reconnect requires a botId.';
+    return exactKeys(payload, ['botId', 'sendTest'])
+      && validId(payload.botId)
+      && (payload.sendTest === undefined || payload.sendTest === true)
+      ? null : 'bot.reconnect requires a botId and optional sendTest=true.';
   }
   if (endpoint === WECOM_ENDPOINTS.deleteBot) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId) && payload.confirm === true
@@ -130,7 +137,29 @@ export function createWecomRpcHandler(controller, { encodeQr = qrDataUrl } = {})
       } else if (endpoint === WECOM_ENDPOINTS.bindCredentials) {
         value = await publicStatus(await controller.bindCredentials(payload), cachedEncode);
       } else if (endpoint === WECOM_ENDPOINTS.reconnectBot) {
-        value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+        const snapshot = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        let testMessage;
+        if (payload.sendTest === true) {
+          const connected = snapshot?.bots?.some(
+            (bot) => bot?.botId === payload.botId && bot?.connected === true,
+          );
+          if (!connected || typeof controller.sendConnectionTest !== 'function') {
+            testMessage = publicConnectionTestResult(
+              connectionTestTargetUnavailable('企业微信机器人'),
+            );
+          } else {
+            try {
+              await controller.sendConnectionTest(payload.botId);
+              testMessage = publicConnectionTestResult();
+            } catch (error) {
+              testMessage = publicConnectionTestResult(error);
+            }
+          }
+        }
+        value = await publicStatus({ ...snapshot, ...(testMessage ? { testMessage } : {}) }, cachedEncode);
       } else if (endpoint === WECOM_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await publicStatus(

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

@@ -78,7 +78,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),

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

@@ -5,6 +5,10 @@ import {
   SET_WORKSPACE_ENDPOINT,
   validWorkspacePayload,
 } from '../shared/workspace-rpc.mjs';
+import {
+  connectionTestTargetUnavailable,
+  publicConnectionTestResult,
+} from '../../../../src/channels/shared/connection-test.mjs';
 
 export const WEIXIN_RPC_CHANNEL = '/weixin';
 export const WEIXIN_ENDPOINTS = Object.freeze({
@@ -55,9 +59,11 @@ function payloadFailure(endpoint, payload) {
       : 'provision.verify requires an attemptId and a 4-to-8-digit code.';
   }
   if (endpoint === WEIXIN_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
+    return exactKeys(payload, ['botId', 'sendTest'])
+      && validId(payload.botId)
+      && (payload.sendTest === undefined || payload.sendTest === true)
       ? null
-      : 'bot.reconnect requires a botId.';
+      : 'bot.reconnect requires a botId and optional sendTest=true.';
   }
   if (endpoint === WEIXIN_ENDPOINTS.deleteBot) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId) && payload.confirm === true
@@ -165,7 +171,27 @@ export function createWeixinRpcHandler(controller, { encodeQr = qrDataUrl } = {}
         value = await controller.cancelProvisioning(payload.attemptId);
         if (!value) return badRequest('The provisioning attempt no longer exists.');
       } else if (endpoint === WEIXIN_ENDPOINTS.reconnectBot) {
-        value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+        const snapshot = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) return cancelled();
+        let testMessage;
+        if (payload.sendTest === true) {
+          const connected = snapshot?.bots?.some(
+            (bot) => bot?.botId === payload.botId && bot?.connected === true,
+          );
+          if (!connected || typeof controller.sendConnectionTest !== 'function') {
+            testMessage = publicConnectionTestResult(
+              connectionTestTargetUnavailable('微信机器人'),
+            );
+          } else {
+            try {
+              await controller.sendConnectionTest(payload.botId);
+              testMessage = publicConnectionTestResult();
+            } catch (error) {
+              testMessage = publicConnectionTestResult(error);
+            }
+          }
+        }
+        value = await publicStatus({ ...snapshot, ...(testMessage ? { testMessage } : {}) }, cachedEncode);
       } else if (endpoint === WEIXIN_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await publicStatus(

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

@@ -81,7 +81,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const harness = new Harness({
     baseUrl: harnessOrigin(ctx.webServer, config.harnessBaseUrl),
     workspace: defaultWorkspace,
-    agentPreset: config.agentPreset ?? 'standard',
+    ...(config.agentPreset == null ? {} : { agentPreset: config.agentPreset }),
     autostart: false,
     dshBin: config.dshBin ?? 'dsh',
     ...(commandExecutor ? { commandExecutor } : {}),

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

@@ -1,5 +1,6 @@
 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';
 
@@ -39,8 +40,9 @@ function payloadFailure(endpoint, payload) {
       ? null : `${endpoint} requires an attemptId.`;
   }
   if (endpoint === WHATSAPP_ENDPOINTS.reconnectBot) {
-    return exactKeys(payload, ['botId']) && validId(payload.botId)
-      ? null : 'bot.reconnect requires a botId.';
+    return exactKeys(payload, ['botId', 'sendTest']) && validId(payload.botId)
+      && (payload.sendTest === undefined || typeof payload.sendTest === 'boolean')
+      ? null : 'bot.reconnect requires a botId and optional sendTest flag.';
   }
   if (endpoint === WHATSAPP_ENDPOINTS.deleteBot) {
     return exactKeys(payload, ['botId', 'confirm']) && validId(payload.botId)
@@ -119,7 +121,33 @@ export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } =
       } else if (endpoint === WHATSAPP_ENDPOINTS.cancelProvisioning) {
         value = sanitizePublic(await controller.cancelProvisioning(payload.attemptId));
       } else if (endpoint === WHATSAPP_ENDPOINTS.reconnectBot) {
-        value = await publicStatus(await controller.reconnectBot(payload.botId), cachedEncode);
+        const checked = await controller.reconnectBot(payload.botId);
+        if (signal?.aborted) {
+          return { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } };
+        }
+        value = await publicStatus(checked, cachedEncode);
+        if (payload.sendTest === true) {
+          let testError = null;
+          const connected = checked?.bots?.some(
+            (bot) => bot?.botId === payload.botId && bot.connected === true,
+          ) === true;
+          if (!connected) {
+            testError = new Error('WhatsApp bot is not connected');
+            testError.code = 'test-target-unavailable';
+          } else {
+            try {
+              if (typeof controller.sendConnectionTest !== 'function') {
+                const unavailable = new Error('Connection test is unavailable');
+                unavailable.code = 'test-target-unavailable';
+                throw unavailable;
+              }
+              await controller.sendConnectionTest(payload.botId);
+            } catch (error) {
+              testError = error;
+            }
+          }
+          value = { ...value, testMessage: publicConnectionTestResult(testError) };
+        }
       } else if (endpoint === WHATSAPP_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await publicStatus(

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

@@ -1,5 +1,7 @@
 import { randomUUID } from 'node:crypto';
 
+import { fetchImageBuffer, ImagePromptError } from '../shared/image-prompt.mjs';
+
 export const DINGTALK_REGISTRATION_BASE_URL = 'https://oapi.dingtalk.com/';
 export const DINGTALK_API_BASE_URL = 'https://api.dingtalk.com/';
 export const DINGTALK_REGISTRATION_SOURCE = 'DING_DWS_CLAW';
@@ -14,6 +16,7 @@ export class DingtalkApiError extends Error {
     this.name = 'DingtalkApiError';
     this.code = code;
     this.status = options.status;
+    this.providerCode = options.providerCode;
   }
 }
 
@@ -21,6 +24,25 @@ function nonEmptyString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
 }
 
+function safeProviderCode(value) {
+  const code = nonEmptyString(value);
+  return code && /^[A-Za-z0-9_.:-]{1,160}$/.test(code) ? code : undefined;
+}
+
+function secureDingtalkDownloadUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch (error) {
+    throw new DingtalkApiError('invalid-image-download', '钉钉服务返回了无效的图片下载地址。', { cause: error });
+  }
+  if (url.protocol === 'http:' && (!url.port || url.port === '80')) {
+    url.protocol = 'https:';
+    url.port = '';
+  }
+  return url;
+}
+
 function isDingtalkHost(hostname) {
   const normalized = hostname.toLowerCase().replace(/\.$/, '');
   return normalized === 'dingtalk.com' || normalized.endsWith('.dingtalk.com');
@@ -123,10 +145,17 @@ async function requestJson(fetchImpl, url, {
       signal: controller.signal,
     });
     if (!response.ok) {
+      let providerCode;
+      try {
+        const errorBody = await response.json();
+        providerCode = safeProviderCode(errorBody?.code ?? errorBody?.errcode);
+      } catch {
+        // DingTalk occasionally returns an empty or non-JSON error body.
+      }
       throw new DingtalkApiError(
         'http-error',
         `钉钉服务请求失败（HTTP ${response.status}）。`,
-        { status: response.status },
+        { status: response.status, providerCode },
       );
     }
     try {
@@ -403,6 +432,58 @@ export function createDingtalkApi({
 
     accessToken,
 
+    async downloadImage({
+      clientId,
+      clientSecret,
+      robotCode,
+      downloadCode,
+      signal,
+      maxBytes,
+    }) {
+      const botCode = nonEmptyString(robotCode);
+      const fileCode = nonEmptyString(downloadCode);
+      if (!botCode || !fileCode) throw new TypeError('robotCode and downloadCode are required');
+      const token = await accessToken({ clientId, clientSecret, signal });
+      let response;
+      try {
+        response = await requestJson(
+          fetchImpl,
+          endpoint(apiBase, 'v1.0/robot/messageFiles/download'),
+          {
+            body: { downloadCode: fileCode, robotCode: botCode },
+            headers: { 'x-acs-dingtalk-access-token': token },
+            signal,
+            action: '图片下载地址',
+          },
+        );
+      } catch (error) {
+        if (signal?.aborted) throw error;
+        throw new DingtalkApiError(
+          'image-download-address-failed',
+          '钉钉图片下载地址获取失败。',
+          { cause: error, status: error?.status, providerCode: error?.providerCode },
+        );
+      }
+      const downloadUrl = nonEmptyString(response?.downloadUrl ?? response?.download_url);
+      if (!downloadUrl) {
+        throw new DingtalkApiError('invalid-image-download', '钉钉服务没有返回图片下载地址。');
+      }
+      try {
+        return await fetchImageBuffer(secureDingtalkDownloadUrl(downloadUrl), {
+          fetchImpl,
+          signal,
+          maxBytes,
+        });
+      } catch (error) {
+        if (signal?.aborted || error instanceof ImagePromptError) throw error;
+        throw new DingtalkApiError(
+          'image-content-download-failed',
+          '钉钉图片内容下载失败。',
+          { cause: error },
+        );
+      }
+    },
+
     async createAiCard({ clientId, clientSecret, target, initialText, signal }) {
       const appKey = nonEmptyString(clientId);
       const appSecret = nonEmptyString(clientSecret);

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

@@ -12,6 +12,12 @@ import { HarnessApprovalQueue } from '../shared/harness-approval.mjs';
 import { runCompactCommand } from '../shared/compact-command.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
+import {
+  hasInboundImages,
+  imagePromptUserMessage,
+  promptContentForMessage,
+} from '../shared/image-prompt.mjs';
+import { rememberConnectionTestTarget } from '../shared/connection-test.mjs';
 
 const CARD_INITIAL_TEXT = '已连接 DeepSeek Harness，正在思考…';
 const CARD_ERROR_TEXT = '消息处理失败，请稍后重试。';
@@ -20,7 +26,7 @@ const INTERACTION_RESOLVED_TEXT = '这个问题已在其他客户端处理，无
 const HELP_TEXT = [
   '钉钉机器人已连接 DeepSeek Harness。',
   '',
-  '直接发送文字即可继续当前会话。',
+  '直接发送文字或图片即可继续当前会话。',
   '/new  开启一个全新会话',
   '/compact  压缩当前会话的较早上下文',
   '/workspace 工作区绝对路径  切换工作区',
@@ -35,10 +41,123 @@ function nonEmptyString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
 }
 
+function safeErrorDiagnostic(error) {
+  const chain = [];
+  const seen = new Set();
+  let current = error;
+  while (current && typeof current === 'object' && chain.length < 3 && !seen.has(current)) {
+    seen.add(current);
+    const name = nonEmptyString(current.name)?.slice(0, 80);
+    const code = nonEmptyString(current.code)?.slice(0, 80);
+    const providerCode = nonEmptyString(current.providerCode)?.slice(0, 160);
+    const status = Number.isInteger(current.status) ? current.status : undefined;
+    chain.push({
+      ...(name ? { name } : {}),
+      ...(code ? { code } : {}),
+      ...(providerCode ? { providerCode } : {}),
+      ...(status ? { status } : {}),
+    });
+    current = current.cause;
+  }
+  return chain;
+}
+
+function dingtalkImageErrorUserMessage(error) {
+  let current = error;
+  const seen = new Set();
+  while (current && typeof current === 'object' && !seen.has(current)) {
+    seen.add(current);
+    if (current.code === 'image-download-address-failed') {
+      return '钉钉未能换取图片下载地址，请重新发送；若持续失败，请检查机器人的“企业内机器人发送消息权限”。';
+    }
+    if (current.code === 'invalid-image-download') {
+      return '钉钉没有返回图片下载地址，请重新发送。';
+    }
+    if (current.code === 'image-content-download-failed') {
+      return '钉钉返回的图片临时地址无法读取，请重新发送。';
+    }
+    current = current.cause;
+  }
+  return imagePromptUserMessage(error);
+}
+
 function senderStaffId(message) {
   return nonEmptyString(message?.senderStaffId) ?? nonEmptyString(message?.senderId);
 }
 
+function parsedMessageContent(message) {
+  if (message?.content && typeof message.content === 'object') return message.content;
+  if (typeof message?.content !== 'string') return null;
+  try {
+    const parsed = JSON.parse(message.content);
+    return parsed && typeof parsed === 'object' ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function richTextEntries(content) {
+  const entries = content?.richText ?? content?.rich_text;
+  return Array.isArray(entries) ? entries : [];
+}
+
+function richTextEntryText(entry) {
+  if (typeof entry?.text === 'string') return nonEmptyString(entry.text);
+  if (typeof entry?.text?.content === 'string') return nonEmptyString(entry.text.content);
+  if (String(entry?.type).toLowerCase() === 'text' && typeof entry?.content === 'string') {
+    return nonEmptyString(entry.content);
+  }
+  return null;
+}
+
+function downloadCodeFor(value) {
+  return nonEmptyString(value?.downloadCode) ?? nonEmptyString(value?.pictureDownloadCode);
+}
+
+/** Normalize DingTalk picture and richText callbacks into lazy image references. */
+export function dingtalkInboundMessage(message, {
+  api,
+  clientId,
+  clientSecret,
+} = {}) {
+  const msgtype = String(message?.msgtype ?? '').toLowerCase();
+  const content = parsedMessageContent(message);
+  const richEntries = msgtype === 'richtext' ? richTextEntries(content) : [];
+  const text = msgtype === 'text'
+    ? nonEmptyString(message?.text?.content) ?? ''
+    : richEntries.map(richTextEntryText).filter(Boolean).join('\n');
+  const imageCodes = [];
+  if (msgtype === 'picture') {
+    const code = downloadCodeFor(content);
+    if (code) imageCodes.push(code);
+  } else if (msgtype === 'richtext') {
+    for (const entry of richEntries) {
+      if (String(entry?.type ?? '').toLowerCase() !== 'picture') continue;
+      const code = downloadCodeFor(entry);
+      if (code) imageCodes.push(code);
+    }
+  }
+  return {
+    content: text,
+    images: imageCodes.map((downloadCode, index) => ({
+      name: index === 0 ? 'image' : `image-${index + 1}`,
+      load: ({ signal, maxBytes }) => {
+        if (typeof api?.downloadImage !== 'function') {
+          throw new Error('DingTalk API does not support image downloads');
+        }
+        return api.downloadImage({
+          clientId,
+          clientSecret,
+          robotCode: message?.robotCode,
+          downloadCode,
+          signal,
+          maxBytes,
+        });
+      },
+    })),
+  };
+}
+
 function conversationKey(message, sender) {
   if (String(message?.conversationType) === '2') {
     const conversationId = nonEmptyString(message?.conversationId);
@@ -191,6 +310,9 @@ export class DingtalkHarnessBridge {
     } catch {
       // An unsafe reply route must never be able to submit an approval.
     }
+    if (sessionWebhook && String(message.conversationType) !== '2') {
+      rememberConnectionTestTarget(this.#state, { sessionWebhook });
+    }
     const pending = this.#pendingInteractions.get(key);
     const approvalReply = this.#approvals.claimReply({
       key,
@@ -317,49 +439,63 @@ export class DingtalkHarnessBridge {
       return;
     }
 
-    const text = message?.msgtype === 'text' ? nonEmptyString(message?.text?.content) : null;
+    const promptMessage = dingtalkInboundMessage(message, {
+      api: this.#api,
+      clientId: this.#clientId,
+      clientSecret: this.#clientSecret,
+    });
+    const text = promptMessage.content;
+    const hasImages = hasInboundImages(promptMessage);
+    const isPlainText = String(message?.msgtype).toLowerCase() === 'text';
     let cardStream = null;
     let cardStarted = false;
     try {
-      if (!text) {
-        await this.#send(sessionWebhook, '目前仅支持文字消息。');
+      if (!text && !hasImages) {
+        await this.#send(sessionWebhook, '目前支持文字和图片消息。');
         return;
       }
 
       const command = text.toLowerCase();
-      if (command === '/help') {
+      if (isPlainText && !hasImages && command === '/help') {
         await this.#send(sessionWebhook, HELP_TEXT);
         return;
       }
-      if (command === '/status') {
+      if (isPlainText && !hasImages && command === '/status') {
         await this.#harness.ensureRunning({ signal: this.#signal });
         await this.#send(sessionWebhook, '钉钉机器人与 DeepSeek Harness 连接正常。');
         return;
       }
-      if (command === '/new') {
+      if (isPlainText && !hasImages && command === '/new') {
         await this.#state.clearSession(key);
         await this.#send(sessionWebhook, '已开启新会话。请发送你的问题。');
         return;
       }
-      const workspaceCommand = await runWorkspaceCommand(text, this.#harness, key);
+      const workspaceCommand = isPlainText && !hasImages
+        ? await runWorkspaceCommand(text, this.#harness, key)
+        : null;
       if (workspaceCommand) {
         for (const reply of workspaceCommand.messages ?? [workspaceCommand.message]) {
           await this.#send(sessionWebhook, reply);
         }
         return;
       }
-      const compactCommand = await runCompactCommand(
-        text,
-        this.#harness,
-        this.#state,
-        key,
-        { signal: this.#signal },
-      );
+      const compactCommand = isPlainText && !hasImages
+        ? await runCompactCommand(
+            text,
+            this.#harness,
+            this.#state,
+            key,
+            { signal: this.#signal },
+          )
+        : null;
       if (compactCommand) {
         await this.#send(sessionWebhook, compactCommand.message);
         return;
       }
 
+      const content = hasImages
+        ? await promptContentForMessage(promptMessage, { signal: this.#signal })
+        : undefined;
       if (typeof this.#api.createAiCard === 'function'
         && typeof this.#api.updateAiCard === 'function'
         && typeof this.#api.finishAiCard === 'function') {
@@ -377,7 +513,7 @@ export class DingtalkHarnessBridge {
         harness: this.#harness,
         state: this.#state,
         key,
-        text,
+        ...(hasImages ? { content } : { text }),
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },
         askOptions: {
@@ -400,13 +536,17 @@ export class DingtalkHarnessBridge {
       increment(this.#status, 'messagesReplied');
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
-    } catch {
+    } catch (error) {
       if (this.#signal?.aborted) return;
       this.#status.lastError = '钉钉消息处理失败。';
-      this.#logger.error?.('[dsh-dingtalk] failed to process an inbound message');
+      this.#logger.error?.(
+        '[dsh-dingtalk] failed to process an inbound message',
+        safeErrorDiagnostic(error),
+      );
       try {
-        const streamed = cardStarted && await cardStream.finish(CARD_ERROR_TEXT);
-        if (!streamed) await this.#send(sessionWebhook, CARD_ERROR_TEXT);
+        const errorText = dingtalkImageErrorUserMessage(error) ?? CARD_ERROR_TEXT;
+        const streamed = cardStarted && await cardStream.finish(errorText);
+        if (!streamed) await this.#send(sessionWebhook, errorText);
       } catch {
         this.#logger.error?.('[dsh-dingtalk] failed to send the safe error reply');
       }

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

@@ -6,6 +6,10 @@ import {
   maskDingtalkClientId,
   maskDingtalkSenderId,
 } from './config-store.mjs';
+import {
+  connectionTestMessage,
+  connectionTestTargetUnavailable,
+} from '../shared/connection-test.mjs';
 
 const ACTIVE_ATTEMPT_STATES = new Set(['starting', 'pending', 'connecting']);
 const TERMINAL_ATTEMPT_STATES = new Set(['connected', 'expired', 'failed', 'cancelled']);
@@ -386,6 +390,20 @@ export class DingtalkController {
     return this.status();
   }
 
+  async sendConnectionTest(botId) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error('Unknown DingTalk bot');
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendConnectionTest !== 'function') {
+        throw connectionTestTargetUnavailable('钉钉机器人');
+      }
+      return runtime.sendConnectionTest(connectionTestMessage(
+        `钉钉机器人（${maskDingtalkClientId(config.clientId)}）`,
+      ));
+    });
+  }
+
   /** Removes one bot, its secret, runtime, and local conversation state. */
   async deleteBot(botId) {
     const config = this.#configStore.get(botId);