@xmanrui/dsh-im 4.38.0 → 4.38.2

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

@@ -1469,9 +1469,9 @@ function resolveAgentPresetCatalog(catalog) {
     : normalizeAgentPresetCatalog(value);
 }
 
-function resolveModelCatalog(catalog) {
+function resolveModelCatalog(catalog, options) {
   if (!catalog) return null;
-  const value = typeof catalog === 'function' ? catalog() : catalog;
+  const value = typeof catalog === 'function' ? catalog(options) : catalog;
   return value && typeof value.then === 'function'
     ? value.then(normalizeModelCatalog)
     : normalizeModelCatalog(value);
@@ -2264,7 +2264,7 @@ export function createWorkspaceAwareController(controller, {
         throw error;
       }
       const catalog = model && modelCatalog
-        ? await resolveModelCatalog(modelCatalog)
+        ? await resolveModelCatalog(modelCatalog, { fresh: true })
         : null;
       const entry = modelCatalogEntry(catalog, model);
       if (model && (!modelCatalog || !entry)) {

package/src/channels/shared/connection-error.mjs

@@ -6,7 +6,7 @@ import { t } from './i18n.mjs';
 const reported = new WeakMap();
 const lastReport = new WeakMap();
 const stages = new WeakMap();
-const OWNED_REASONS = { 'connect-timeout': 'timeout', 'telegram-timeout': 'timeout', 'cli-timeout': 'timeout', 'provider-timeout': 'timeout', 'telegram-response-invalid': 'invalid-response', 'office-protocol-mismatch': 'invalid-response' };
+const OWNED_REASONS = { 'harness-interaction-timeout': 'timeout', 'harness-response-invalid': 'invalid-response', 'connect-timeout': 'timeout', 'telegram-timeout': 'timeout', 'cli-timeout': 'timeout', 'provider-timeout': 'timeout', 'telegram-response-invalid': 'invalid-response', 'office-protocol-mismatch': 'invalid-response' };
 const STANDARD_NAMES = new Set(['Error', 'TypeError', 'SyntaxError', 'AggregateError', 'DOMException', 'AxiosError', 'TimeoutError', 'AbortError']);
 const KNOWN_MESSAGES = {
   'discord-401': 'Discord Bot Token 无效，请重新填写。',
@@ -54,20 +54,45 @@ export function extractConnectionEvidence(error) {
   const allReasons = [...new Set(errors.flatMap(e => e.reason === 'multiple-causes' ? e.reasons ?? [] : [e.reason]).filter(r => r && !['unknown', 'multiple-causes'].includes(r)))];
   const precise = allReasons.filter(r => !['timeout', 'http-error', 'provider-rejected', 'invalid-response'].includes(r));
   const reasons = precise.length ? precise : allReasons;
-  const first = field => chain.map(e => normalizeDiagnosticDetails({ [field]: e[field] ?? e.details?.[field] })[field]).find(v => v !== undefined);
+  const first = field => chain.map(e => normalizeDiagnosticDetails({ [field]: stages.get(e)?.[field] ?? e[field] ?? e.details?.[field] })[field]).find(v => v !== undefined);
+  const correlation = {};
+  for (const field of ['sessionId', 'promptRpcId']) {
+    // Only locally attached identifiers belong in logs, never arbitrary RPC details.
+    const value = chain.map(e => stages.get(e)?.[field]).find(v => v !== undefined);
+    if (typeof value === 'string' && /^[A-Za-z0-9_-]{1,256}$/u.test(value)) correlation[field] = value;
+  }
   return {
-    chain, errors,
+    chain, errors, correlation,
     details: normalizeDiagnosticDetails({
       reason: reasons.length > 1 ? 'multiple-causes' : reasons[0] ?? 'unknown',
       ...(reasons.length > 1 ? { reasons } : {}),
       httpStatus: errors.find(e => e.httpStatus !== undefined)?.httpStatus,
       providerCode: errors.find(e => e.providerCode !== undefined)?.providerCode,
       method: first('method'), transport: first('transport'),
+      stage: first('stage'), submissionState: first('submissionState'),
+      attempts: first('attempts'), lastFailureReason: first('lastFailureReason'),
       durationMs: first('durationMs'), timeoutMs: first('timeoutMs'), host: first('host'), truncated,
     }),
   };
 }
 
+/** Keep request context off shared errors (for example a rejected model-catalog promise).
+ * Preserve the original prototype, properties and cause for existing business handlers. */
+export function messageDiagnosticError(cause, context) {
+  if (cause?.name === 'AbortError') return cause;
+  const source = cause && typeof cause === 'object' ? cause : new Error('Message processing failed');
+  const error = source instanceof DOMException
+    ? Object.defineProperties(new DOMException(source.message, source.name), Object.getOwnPropertyDescriptors(source))
+    : Object.defineProperties(Object.setPrototypeOf(source instanceof Error ? new Error() : {}, Object.getPrototypeOf(source)),
+      Object.getOwnPropertyDescriptors(source));
+  stages.set(error, { ...context, ...stages.get(source) });
+  return error;
+}
+
+export function runtimeDiagnosticDetails() {
+  return { pluginVersion: packageInfo.version, nodeVersion: process.versions.node, platform: process.platform };
+}
+
 export async function atConnectionStage(stage, operation, resource) {
   try { return await operation(); }
   catch (error) { throw connectionStageError(error, stage, resource); }
@@ -145,7 +170,7 @@ export function createConnectionDiagnostics({ channel, logger = console, now = D
     const details = normalizeDiagnosticDetails({
       ...evidence.details, ...context, ...safe.details, ...described.details, ...owned,
       channel, stage: owned.stage ?? described.details?.stage ?? safe.details?.stage ?? context.stage ?? operationStage(context.operation),
-      pluginVersion: packageInfo.version, nodeVersion: process.versions.node, platform: process.platform,
+      ...runtimeDiagnosticDetails(),
     });
     const code = safe.code ?? context.code ?? `${channel}-operation-failed`;
     const hint = described.hint ?? safe.hint ?? safe.details?.hint ?? connectionHint(details);

package/src/channels/shared/diagnostic-details.mjs

@@ -7,11 +7,13 @@ const OPERATIONS = new Set([
   'bot.workspace.set', 'bot.model.set', 'bot.agent-preset.set', 'bot.context-enhancement.set', 'bot.access-policy.set', 'bot.alias.set',
 ]);
 const STAGES = new Set([
+  'session.prepare', 'prompt.prepare', 'interaction.open', 'prompt.submit', 'reply.wait',
   'credential.verify', 'permission.check', 'sdk.load', 'operation', 'message.receive', 'message.send', 'connection.test', 'startup.load', 'qr.begin', 'qr.encode', 'qr.poll', 'qr.verify', 'qr.cancel', 'credential.read', 'credential.save', 'credential.remove',
   'account.save', 'account.remove', 'state.load', 'state.write', 'state.cleanup', 'workspace.write', 'workspace.cleanup',
   'runtime.prepare', 'activation', 'harness.check', 'connection.start', 'connection.poll', 'connection.stop', 'status.read', 'rollback', 'management.request',
 ]);
 const REASONS = new Set([
+  'stream-closed-before-open', 'stream-failed-before-open', 'stream-failed',
   'ENOTFOUND', 'EAI_AGAIN', 'ECONNREFUSED', 'ECONNRESET', 'EHOSTUNREACH', 'ENETUNREACH', 'ETIMEDOUT', 'EPIPE',
   'UND_ERR_CONNECT_TIMEOUT', 'UND_ERR_HEADERS_TIMEOUT', 'UND_ERR_BODY_TIMEOUT', 'UND_ERR_SOCKET',
   'CERT_HAS_EXPIRED', 'CERT_NOT_YET_VALID', 'DEPTH_ZERO_SELF_SIGNED_CERT', 'SELF_SIGNED_CERT_IN_CHAIN',
@@ -25,7 +27,8 @@ const RPC_METHODS = new Set([
   'session.history', 'session.prompt', 'session.rename', 'session.cancel', 'session.models',
   'session.permissions', 'session.selectModel', 'llm.models',
 ]);
-const TRANSPORTS = new Set(['host-api', 'http']);
+const TRANSPORTS = new Set(['host-api', 'http', 'websocket']);
+const SUBMISSION_STATES = new Set(['not-submitted', 'accepted', 'unknown']);
 const CONFIG_FILES = new Set(['config.json', 'workspaces.json']);
 export const CONFIG_ISSUE_LABELS = Object.freeze({
   'expected-object': '应为 JSON 对象。',
@@ -50,7 +53,7 @@ const CONFIG_FIELD = /^(?:\$|version|accounts(?:\[\d{1,10}\](?:\.(?:accountId|ow
 export function normalizeDiagnosticDetails(value) {
   if (!value || typeof value !== 'object' || Array.isArray(value)) return {};
   const result = {};
-  for (const [field, allowed] of [['operation', OPERATIONS], ['stage', STAGES], ['reason', REASONS], ['resource', RESOURCES], ['method', RPC_METHODS], ['transport', TRANSPORTS]]) {
+  for (const [field, allowed] of [['operation', OPERATIONS], ['stage', STAGES], ['reason', REASONS], ['resource', RESOURCES], ['method', RPC_METHODS], ['transport', TRANSPORTS], ['submissionState', SUBMISSION_STATES], ['lastFailureReason', REASONS]]) {
     if (allowed.has(value[field])) result[field] = value[field];
   }
   if (DIAGNOSTIC_CHANNELS.includes(value.channel)) result.channel = value.channel;
@@ -59,6 +62,7 @@ export function normalizeDiagnosticDetails(value) {
     if (reasons.length) result.reasons = reasons;
   }
   for (const field of ['durationMs', 'timeoutMs']) if (Number.isFinite(value[field]) && value[field] >= 0) result[field] = Math.round(value[field]);
+  if (Number.isSafeInteger(value.attempts) && value.attempts >= 0) result.attempts = value.attempts;
   for (const field of ['nodeVersion', 'dshVersion']) if (typeof value[field] === 'string' && /^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(value[field]) && value[field].length < 80) result[field] = value[field];
   if (['darwin', 'linux', 'win32', 'freebsd'].includes(value.platform)) result.platform = value.platform;
   if (['ilinkai.weixin.qq.com', 'oapi.dingtalk.com', 'api.dingtalk.com', 'api.telegram.org', 'discord.com', 'slack.com', 'open.feishu.cn', 'qyapi.weixin.qq.com'].includes(value.host)) result.host = value.host;

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

@@ -22,6 +22,7 @@ import { imSourceGuidance } from './im-source-guidance.mjs';
 import { outboundArtifactRegistry } from './semantic/artifact.mjs';
 import { t } from './i18n.mjs';
 import { watchHarnessMux } from './harness-mux.mjs';
+import { extractConnectionEvidence, messageDiagnosticError } from './connection-error.mjs';
 
 // Every channel plugin runs in the same Host process. Sharing ownership by
 // Host identity (or an explicitly configured HTTP origin) prevents clients
@@ -29,10 +30,40 @@ import { watchHarnessMux } from './harness-mux.mjs';
 // from claiming or cancelling each other's interactions.
 const interactionRegistries = new Map();
 const hostInteractionRegistries = new WeakMap();
+const modelCatalogCaches = new WeakMap();
+const MODEL_CATALOG_TTL_MS = 30_000;
 const MAX_ERROR_CLASSIFICATION_BYTES = 64;
 const IM_INPUT_ORIGIN_TTL_MS = 30 * 60 * 1000;
 const MAX_IM_INPUT_ORIGINS = 4096;
 
+function invalidateModelCatalog(entry) {
+  if (!entry) return;
+  entry.value = null;
+  entry.expiresAt = 0;
+  // Old readers may finish, but must not repopulate the cache after a fresh read.
+  entry.pending = null;
+}
+
+export function clearModelCatalogCache(apiProxy) {
+  const entry = modelCatalogCaches.get(apiProxy);
+  if (!entry) return;
+  modelCatalogCaches.delete(apiProxy);
+  invalidateModelCatalog(entry);
+  entry.controller.abort(new DOMException('Harness model catalog disposed', 'AbortError'));
+}
+
+function clientTimeZoneFields() {
+  try {
+    const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return typeof timeZone === 'string' && timeZone.trim()
+      ? { clientTimeZone: timeZone }
+      : {};
+  } catch {
+    // Time-zone metadata is optional; unresolved values are not JSON-safe.
+    return {};
+  }
+}
+
 async function smallResponseText(response) {
   const stream = response?.body;
   if (!stream || typeof stream.getReader !== 'function') return null;
@@ -1175,9 +1206,46 @@ export class HarnessClient {
   }
 
   async listModels(options = {}) {
+    options.signal?.throwIfAborted();
     await this.ensureRunning(options);
-    const value = await this.rpc('llm.models', {}, 30_000, options);
-    return validateModelCatalog(value, 'llm.models');
+    options.signal?.throwIfAborted();
+    if (!this.#apiProxy || options.fresh === true) {
+      try {
+        const value = await this.rpc('llm.models', {}, 30_000, options);
+        return validateModelCatalog(value, 'llm.models');
+      } finally {
+        if (this.#apiProxy) invalidateModelCatalog(modelCatalogCaches.get(this.#apiProxy));
+      }
+    }
+
+    let entry = modelCatalogCaches.get(this.#apiProxy);
+    if (!entry) {
+      entry = { value: null, expiresAt: 0, pending: null, controller: new AbortController() };
+      modelCatalogCaches.set(this.#apiProxy, entry);
+    }
+    if (entry.value && Date.now() < entry.expiresAt) return structuredClone(entry.value);
+    if (!entry.pending) {
+      // The Host owns this read; one caller cancelling must not cancel its peers.
+      const pending = this.rpc('llm.models', {}, 30_000, {
+        ...options, signal: entry.controller.signal,
+      }).then((value) => {
+        const catalog = structuredClone(validateModelCatalog(value, 'llm.models'));
+        if (modelCatalogCaches.get(this.#apiProxy) === entry && entry.pending === pending) {
+          entry.value = catalog;
+          entry.expiresAt = Date.now() + MODEL_CATALOG_TTL_MS;
+        }
+        return catalog;
+      }).finally(() => {
+        if (entry.pending === pending) entry.pending = null;
+      });
+      entry.pending = pending;
+    }
+    const pending = entry.pending;
+    const value = await callWithSignal(
+      () => pending,
+      options.signal ?? entry.controller.signal,
+    );
+    return structuredClone(value);
   }
 
   async getSessionModels(sessionId, options = {}) {
@@ -1212,13 +1280,18 @@ export class HarnessClient {
           : { reasoningEffort: selection.reasoningEffort }),
       }, 30_000, signal ? { ...options, signal } : options);
     };
-    const value = this.#sessionMaintenanceExecutor
-      ? await this.#sessionMaintenanceExecutor({ sessionId, operation })
-      : await operation();
-    if (!value || typeof value !== 'object' || !validModelSelection(value.selected)) {
-      throw new Error('Harness returned an invalid response for session.selectModel');
+    try {
+      const value = this.#sessionMaintenanceExecutor
+        ? await this.#sessionMaintenanceExecutor({ sessionId, operation })
+        : await operation();
+      if (!value || typeof value !== 'object' || !validModelSelection(value.selected)) {
+        throw new HarnessTransportError('harness-response-invalid', 'session.selectModel');
+      }
+      return value;
+    } catch (error) {
+      if (options.signal?.aborted) throw error;
+      throw messageDiagnosticError(error, { stage: 'session.prepare', sessionId });
     }
-    return value;
   }
 
   async isSessionRunning(sessionId, options = {}) {
@@ -1267,6 +1340,9 @@ export class HarnessClient {
     const agentPreset = requestedPreset !== undefined ? requestedPreset : this.#agentPreset;
     if (agentPreset != null) payload.agentPreset = agentPreset;
     const created = await this.rpc('session.create', payload, 30_000, rpcOptions);
+    if (typeof created?.sessionId !== 'string' || !created.sessionId) {
+      throw new HarnessTransportError('harness-response-invalid', 'session.create');
+    }
     return created.sessionId;
   }
 
@@ -1397,6 +1473,7 @@ export class HarnessClient {
     onSessionEvent,
     onOpen,
     ownership,
+    onDiagnostic,
   } = {}) {
     if (typeof sessionId !== 'string' || !sessionId) throw new TypeError('sessionId is required');
     if (!signal || typeof signal.addEventListener !== 'function') {
@@ -1414,8 +1491,17 @@ export class HarnessClient {
     if (onOpen !== undefined && typeof onOpen !== 'function') {
       throw new TypeError('onOpen must be a function');
     }
-
+    let attempts = 0;
+    let lastFailureReason;
+    const report = () => {
+      try {
+        Promise.resolve(onDiagnostic?.({ attempts, ...(lastFailureReason ? { lastFailureReason } : {}) }))
+          .catch(() => undefined);
+      } catch { /* Diagnostics cannot change stream/reconnect behavior. */ }
+    };
     while (!signal.aborted) {
+      attempts += 1;
+      report();
       try {
         await this.#watchInteractionStream(sessionId, {
           signal,
@@ -1427,6 +1513,8 @@ export class HarnessClient {
         });
       } catch (error) {
         if (signal.aborted) return;
+        lastFailureReason = extractConnectionEvidence(error).details.reason;
+        report();
         console.warn('[dsh-im] Harness interaction stream disconnected:', this.#logPrefix, error.message);
       }
       if (signal.aborted) return;
@@ -1621,7 +1709,7 @@ export class HarnessClient {
         sessionId,
         mode: 'steer',
         content: [{ type: 'text', text }],
-        clientTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        ...clientTimeZoneFields(),
       }, 30_000, { ...options, rpcId: inputRpcId });
       return true;
     } catch (error) {
@@ -1699,6 +1787,16 @@ export class HarnessClient {
 
   async ask(sessionId, prompt, options = {}) {
     if (typeof options === 'number') options = { timeoutMs: options };
+    const diagnostic = { stage: 'prompt.prepare', submissionState: 'not-submitted', sessionId };
+    try {
+      return await this.#ask(sessionId, prompt, options, diagnostic);
+    } catch (error) {
+      if (options.signal?.aborted) throw error;
+      throw messageDiagnosticError(error, diagnostic);
+    }
+  }
+
+  async #ask(sessionId, prompt, options, diagnostic) {
     const timeoutMs = options.timeoutMs ?? 600_000;
     const signal = options.signal;
     const onUpdate = typeof options.onUpdate === 'function' ? options.onUpdate : null;
@@ -1728,6 +1826,7 @@ export class HarnessClient {
     );
     const baselineSeq = Math.max(-1, ...(before.events ?? []).map(({ event }) => event.seq ?? -1));
     const promptRpcId = `${this.#rpcIdPrefix}-${randomUUID()}`;
+    diagnostic.promptRpcId = promptRpcId;
     const releasePromptInputOrigin = registerImInputOrigin(this.#interactionRegistry, promptRpcId);
     const tracker = new HarnessReplyTracker({
       promptRpcId, afterSeq: baselineSeq, reasoning, finalAnswerOnly: options.finalAnswerOnly,
@@ -1857,6 +1956,9 @@ export class HarnessClient {
         });
       }
       if (interactionSignal) {
+        diagnostic.stage = 'interaction.open';
+        const startedAt = performance.now();
+        let streamDiagnostic = { attempts: 0 };
         let markOpen;
         const opened = new Promise((resolve) => { markOpen = resolve; });
         interactionTask = this.watchInteractions(sessionId, {
@@ -1868,16 +1970,25 @@ export class HarnessClient {
             : undefined,
           onOpen: markOpen,
           ownership,
+          onDiagnostic: (value) => { streamDiagnostic = value; },
         });
         void interactionTask.catch(() => undefined);
         await Promise.race([
           opened,
           sleep(30_000, interactionSignal).then(() => {
-            throw new Error('Harness interaction stream did not open within 30 seconds');
+            throw Object.assign(new HarnessInteractionError(
+              'harness-interaction-timeout',
+              'Harness interaction stream did not open within 30 seconds',
+            ), {
+              transport: this.#apiProxy ? 'host-api' : 'websocket',
+              durationMs: Math.round(performance.now() - startedAt),
+              timeoutMs: 30_000,
+              ...streamDiagnostic,
+            });
           }),
         ]);
       }
-
+      diagnostic.stage = 'prompt.prepare';
       const content = typeof prompt === 'string'
         ? [{ type: 'text', text: prompt }]
         : prompt;
@@ -1890,13 +2001,17 @@ export class HarnessClient {
       // `content`: the prompt also carries whatever the user typed, and a
       // message that merely looks like a guidance block is not configuration.
       imSourceGuidance.publish(sessionId, options.sourceGuidance);
-      const clientTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-      const sendPrompt = (promptContent) => this.#sessionRpc('session.prompt', {
-        sessionId,
-        mode: 'queue',
-        content: promptContent,
-        clientTimeZone,
-      }, 30_000, { rpcId: promptRpcId, signal });
+      const timeZoneFields = clientTimeZoneFields();
+      const sendPrompt = (promptContent) => {
+        diagnostic.stage = 'prompt.submit';
+        diagnostic.submissionState = 'unknown';
+        return this.#sessionRpc('session.prompt', {
+          sessionId,
+          mode: 'queue',
+          content: promptContent,
+          ...timeZoneFields,
+        }, 30_000, { rpcId: promptRpcId, signal });
+      };
       try {
         await sendPrompt(content);
       } catch (error) {
@@ -1936,6 +2051,8 @@ export class HarnessClient {
         await sendPrompt(fallbackPrompt);
       }
       promptAccepted = true;
+      diagnostic.submissionState = 'accepted';
+      diagnostic.stage = 'reply.wait';
 
       try {
         // Treat timeoutMs as a stall window rather than a hard runtime limit.
@@ -2020,6 +2137,8 @@ export class HarnessClient {
             continue;
           }
           const timeoutError = new HarnessTurnError('harness-reply-timeout');
+          timeoutError.durationMs = Date.now() - lastProgressAt;
+          timeoutError.timeoutMs = timeoutMs;
           // Data-only context for deferred delivery; timeout semantics unchanged.
           timeoutError.details = { sessionId, promptRpcId, baselineSeq, turn: tracker.turn, lastSeq: tracker.lastSeq };
           throw timeoutError;

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

@@ -97,12 +97,14 @@ function watchWebSocketMux({ baseUrl, createWebSocket, signal, onOpen, onEnvelop
       }
       invoke(onEnvelope, envelope, finish);
     };
-    const handleClose = () => finish(opened ? undefined : new Error(
+    const handleClose = () => finish(opened ? undefined : Object.assign(new Error(
       'Harness event mux WebSocket closed before opening',
-    ));
-    const handleError = () => finish(new Error(opened
+    ), { code: 'stream-closed-before-open' }));
+    const handleError = () => finish(Object.assign(new Error(opened
       ? 'Harness event mux WebSocket failed'
-      : 'Harness event mux WebSocket failed before opening'));
+      : 'Harness event mux WebSocket failed before opening'), {
+      code: opened ? 'stream-failed' : 'stream-failed-before-open',
+    }));
     const handleAbort = () => finish();
     socket.addEventListener('open', handleOpen);
     socket.addEventListener('message', handleMessage);

package/src/channels/shared/i18n-en/diagnostics.mjs

@@ -1,4 +1,28 @@
 export default Object.freeze({
+  '准备会话': 'Prepare session',
+  '准备消息': 'Prepare message',
+  '建立交互通道': 'Open interaction channel',
+  '提交消息': 'Submit message',
+  '等待处理结果': 'Wait for result',
+  '消息提交状态': 'Message submission status',
+  '未提交': 'Not submitted',
+  '已确认接收': 'Acceptance confirmed',
+  '提交结果未知': 'Submission outcome unknown',
+  '连接尝试次数': 'Connection attempts',
+  '最近一次连接失败': 'Last observed connection failure',
+  '打开前关闭': 'Closed before opening',
+  '打开前失败': 'Failed before opening',
+  '通道连接失败': 'Stream connection failed',
+  '与 DSH 的交互通道在 30 秒内未就绪，本条消息尚未提交执行。请稍后重试。':
+    'The DSH interaction channel was not ready within 30 seconds. This message has not been submitted for execution. Please try again later.',
+  '消息提交前的操作超时，本条消息尚未提交执行。请稍后重试。':
+    'An operation timed out before submission. This message has not been submitted for execution. Please try again later.',
+  '消息提交前的网络请求失败，本条消息尚未提交执行。请检查连接后重试。':
+    'A network request failed before submission. This message has not been submitted for execution. Check the connection and try again.',
+  '消息在提交前处理失败，尚未提交执行。请重试；若持续发生，请将参考号提供给管理员。':
+    'Message preparation failed before submission. It has not been submitted for execution. Try again; if this persists, share the reference with your administrator.',
+  '消息已尝试提交，但任务结果尚未确认。请先到 DSH 查看状态，不要立即重复提交；若持续发生，请将参考号提供给管理员。':
+    'Message submission was attempted, but the task outcome is unconfirmed. Check its status in DSH before resubmitting; if this persists, share the reference with your administrator.',
   "DSH 版本": "DSH version",
   "依赖版本": "Dependency versions",
   "代理已配置": "Proxy configured",

package/src/channels/shared/i18n-en/wecom.mjs

@@ -30,6 +30,9 @@ export default {
   // Bot replies and status text (wecom-bridge.mjs)
 
   '当前待处理图片较多，请稍后重新发送。': 'Too many images are pending. Please send them again later.',
+  '图片 {indexes} 来自当前消息。': 'Images {indexes} are from the current message.',
+  '图片 {indexes} 来自被引用消息。图片序号与本轮附件清单一致。': 'Images {indexes} are from the quoted message. Image numbers match the attachment list for this turn.',
+  '有 {count} 张引用图片未提供可下载资源，未附上这些图片；需要看图时请用户重新发送。': '{count} quoted images have no downloadable resource and are not attached. Ask the user to send them again if needed.',
 
   '结果文件「{name}」已生成，但企业微信智能机器人缺少素材上传或文件消息能力，请检查机器人权限。': 'The result file "{name}" was generated, but the Enterprise WeChat bot lacks media upload or file message capability. Please check the bot permissions.',
   '结果文件「{name}」超过当前企业微信机器人可发送的文件大小，未发送。': 'The result file "{name}" exceeds the file size this Enterprise WeChat bot can send and was not sent.',