@xmanrui/dsh-im 4.20.2 → 4.21.1

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

@@ -32,11 +32,16 @@ import {
   validateModelSelection,
 } from './model-setting.mjs';
 import { WORKSPACE_SESSION_STALE } from './workspace-session.mjs';
+import { configValidationError, withConfigResource } from './config-read-error.mjs';
 
 const DELIVERY_DOCUMENT_VERSION = 2;
 export const CURRENT_DOCUMENT_VERSION = 3;
 const EMPTY_DOCUMENT = Object.freeze({ version: 1, workspaces: Object.freeze({}) });
 
+function invalidWorkspaceConfig(field, issue) {
+  throw configValidationError('dsh-im workspace config is invalid', field, issue);
+}
+
 function workspaceSessionStale(message) {
   const error = new Error(message);
   error.code = WORKSPACE_SESSION_STALE;
@@ -185,13 +190,17 @@ function sameDeliveryRoute(left, right) {
 function normalizeDeliveryTargets(value, { version } = {}) {
   const deliveryTargets = Object.create(null);
   if (value === undefined) return deliveryTargets;
-  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return invalidWorkspaceConfig('deliveryTargets', 'expected-object');
+  let field = 'deliveryTargets';
   try {
-    for (const [botId, targets] of Object.entries(value)) {
+    for (const [botIndex, [botId, targets]] of Object.entries(value).entries()) {
+      field = `deliveryTargets[${botIndex}].key`;
       botIdOf(botId);
-      if (!targets || typeof targets !== 'object' || Array.isArray(targets)) return null;
+      field = `deliveryTargets[${botIndex}].targets`;
+      if (!targets || typeof targets !== 'object' || Array.isArray(targets)) throw new TypeError('Invalid targets');
       const normalizedTargets = Object.create(null);
-      for (const [targetId, target] of Object.entries(targets)) {
+      for (const [targetIndex, [targetId, target]] of Object.entries(targets).entries()) {
+        field = `deliveryTargets[${botIndex}].targets[${targetIndex}]`;
         // Backward compatibility: some released builds persisted the target id
         // inside the stored object as well. Accept a redundant targetId that
         // matches the map key when loading a stored document; a mismatch stays
@@ -215,7 +224,7 @@ function normalizeDeliveryTargets(value, { version } = {}) {
       deliveryTargets[botId] = normalizedTargets;
     }
   } catch {
-    return null;
+    return invalidWorkspaceConfig(field, 'invalid-delivery-target');
   }
   return deliveryTargets;
 }
@@ -241,44 +250,44 @@ function normalizeAccessPolicies(value, workspaces) {
 }
 
 function normalizeDocument(value) {
-  if (!value || ![1, DELIVERY_DOCUMENT_VERSION, CURRENT_DOCUMENT_VERSION].includes(value.version)
-    || !value.workspaces
-    || typeof value.workspaces !== 'object' || Array.isArray(value.workspaces)) return null;
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return invalidWorkspaceConfig('$', 'expected-object');
+  if (![1, DELIVERY_DOCUMENT_VERSION, CURRENT_DOCUMENT_VERSION].includes(value.version)) return invalidWorkspaceConfig('version', 'unsupported-version');
+  if (!value.workspaces || typeof value.workspaces !== 'object' || Array.isArray(value.workspaces)) return invalidWorkspaceConfig('workspaces', 'expected-object');
   const workspaces = {};
-  for (const [botId, workspace] of Object.entries(value.workspaces)) {
-    if (!/^[A-Za-z0-9_-]{1,128}$/.test(botId)
-      || typeof workspace !== 'string' || !isAbsolute(workspace)) return null;
+  for (const [index, [botId, workspace]] of Object.entries(value.workspaces).entries()) {
+    if (!/^[A-Za-z0-9_-]{1,128}$/.test(botId)) return invalidWorkspaceConfig(`workspaces[${index}].key`, 'invalid-identifier');
+    if (typeof workspace !== 'string' || !isAbsolute(workspace)) return invalidWorkspaceConfig(`workspaces[${index}].value`, 'invalid-workspace-path');
     workspaces[botId] = resolve(workspace);
   }
   const conversationWorkspaces = normalizeConversationWorkspaces(value.conversationWorkspaces);
   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;
+      || Array.isArray(value.agentPresets)) return invalidWorkspaceConfig('agentPresets', 'expected-object');
+    for (const [index, [botId, agentPreset]] of Object.entries(value.agentPresets).entries()) {
+      if (!/^[A-Za-z0-9_-]{1,128}$/.test(botId)) return invalidWorkspaceConfig(`agentPresets[${index}].key`, 'invalid-identifier');
       try {
         const normalized = validateAgentPresetId(agentPreset);
-        if (!normalized) return null;
+        if (!normalized) return invalidWorkspaceConfig(`agentPresets[${index}].value`, 'invalid-agent-preset');
         agentPresets[botId] = normalized;
       } catch {
-        return null;
+        return invalidWorkspaceConfig(`agentPresets[${index}].value`, 'invalid-agent-preset');
       }
     }
   }
   const models = {};
   if (value.models !== undefined) {
     if (!value.models || typeof value.models !== 'object' || Array.isArray(value.models)) {
-      return null;
+      return invalidWorkspaceConfig('models', 'expected-object');
     }
-    for (const [botId, model] of Object.entries(value.models)) {
-      if (!/^[A-Za-z0-9_-]{1,128}$/.test(botId)) return null;
+    for (const [index, [botId, model]] of Object.entries(value.models).entries()) {
+      if (!/^[A-Za-z0-9_-]{1,128}$/.test(botId)) return invalidWorkspaceConfig(`models[${index}].key`, 'invalid-identifier');
       try {
         const normalized = validateModelSelection(model);
-        if (!normalized) return null;
+        if (!normalized) return invalidWorkspaceConfig(`models[${index}].value`, 'invalid-model-selection');
         models[botId] = normalized;
       } catch {
-        return null;
+        return invalidWorkspaceConfig(`models[${index}].value`, 'invalid-model-selection');
       }
     }
   }
@@ -292,9 +301,8 @@ function normalizeDocument(value) {
       }
     }
   }
-  if (value.version === 1 && value.deliveryTargets !== undefined) return null;
+  if (value.version === 1 && value.deliveryTargets !== undefined) return invalidWorkspaceConfig('deliveryTargets', 'unexpected-field');
   const deliveryTargets = normalizeDeliveryTargets(value.deliveryTargets, { version: value.version });
-  if (!deliveryTargets) return null;
   const aliases = Object.create(null);
   if (value.aliases && typeof value.aliases === 'object' && !Array.isArray(value.aliases)) {
     for (const [botId, alias] of Object.entries(value.aliases)) {
@@ -421,7 +429,6 @@ export class BotWorkspaceStore {
   async load() {
     try {
       const normalized = normalizeDocument(JSON.parse(await readFile(this.#path, 'utf8')));
-      if (!normalized) throw new Error('dsh-im workspace config is invalid');
       this.#version = normalized.version;
       this.#workspaces = normalized.workspaces;
       this.#agentPresets = normalized.agentPresets;
@@ -432,7 +439,7 @@ export class BotWorkspaceStore {
       this.#accessPolicies = normalized.accessPolicies;
       this.#conversationWorkspaces = normalized.conversationWorkspaces;
     } catch (error) {
-      if (error?.code !== 'ENOENT') throw error;
+      if (error?.code !== 'ENOENT') throw withConfigResource(error, 'workspace-config');
       this.#version = 1;
       this.#workspaces = {};
       this.#agentPresets = {};
@@ -1371,6 +1378,18 @@ export class BotWorkspaceStore {
       await this.#persist();
       return;
     }
+    try {
+      const parent = await stat(dirname(this.#path));
+      if (!parent.isDirectory()) {
+        const error = new Error('workspace config parent is not a directory');
+        error.code = 'ENOTDIR';
+        throw error;
+      }
+    } catch (error) {
+      if (error?.code !== 'ENOENT') throw error;
+      this.#dirtyRemovals.clear();
+      return;
+    }
     try {
       await unlink(this.#path);
       this.#dirtyRemovals.clear();
@@ -2277,7 +2296,8 @@ export function createWorkspaceAwareController(controller, {
           await state.clearSessions();
         } catch (error) {
           console.warn(
-            `[dsh-im] ignored session cleanup failure while deleting bot ${botId}:`,
+            '[dsh-im] ignored session cleanup failure while deleting bot:',
+            botId,
             error?.message ?? error,
           );
         }

package/src/channels/shared/config-read-error.mjs

@@ -0,0 +1,24 @@
+// Metadata belongs to the validation/read boundary, never to parser excerpts or
+// arbitrary error properties. Keep the original exception type/message so other
+// channels retain their existing startup classification.
+const details = new WeakMap();
+
+export function configValidationError(message, field, issue) {
+  const error = new Error(message);
+  details.set(error, { reason: 'invalid-config', field, issue });
+  return error;
+}
+
+export function withConfigResource(error, resource) {
+  if (error && typeof error === 'object') {
+    details.set(error, {
+      ...details.get(error), resource,
+      ...(error instanceof SyntaxError ? { reason: 'invalid-json' } : {}),
+    });
+  }
+  return error;
+}
+
+export function configReadErrorDetails(error) {
+  return details.get(error);
+}

package/src/channels/shared/context-enhancement.mjs

@@ -4,6 +4,23 @@ export const CONTEXT_ENHANCEMENT_FIELDS = Object.freeze([
   'chatId', 'threadId', 'botId',
 ]);
 
+/**
+ * Tag grammar of the injected context prefix. The producer here and the
+ * Host-side splitter in `injected-context.mjs` share these literals, so the
+ * prefix a channel writes can never drift from the parser that pairs it.
+ */
+export const INJECTED_CONTEXT_TAGS = Object.freeze({
+  sourceOpen: '<dsh_im_source>',
+  sourceClose: '</dsh_im_source>',
+  guidanceOpen: '<dsh_im_source_guidance>',
+  guidanceClose: '</dsh_im_source_guidance>',
+  replyOpen: '<dsh_im_reply_to>',
+  replyClose: '</dsh_im_reply_to>',
+});
+
+/** Separator the producer joins prefix blocks with, and the splitter consumes. */
+export const INJECTED_CONTEXT_SEPARATOR = '\n\n';
+
 export const CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH = 8_000;
 export const CONTEXT_GROUP_GUIDANCE_EXAMPLE = `仅依据当前消息的 <dsh_im_source> 中实际提供的字段理解来源；没有提供的字段不要猜测或补全。
 当前消息来自群聊，请使用严肃、克制、简洁的表达方式。`;
@@ -138,6 +155,26 @@ export function captureContextEnhancement(provider, conversationType) {
   }
 }
 
+/**
+ * Capture the enhancement one prompt replays, together with the source factory
+ * that fills its selected fields.
+ *
+ * Ordinary messages snapshot this when they are accepted, so a queued message
+ * keeps the settings it arrived under. A control command is never queued, so it
+ * captures at the moment it runs -- and it must, because the source fields of a
+ * steering instruction belong to whoever issued it, not to the message that
+ * opened the turn.
+ *
+ * @param provider - the bot's enhancement provider.
+ * @param conversationType - the inbound message's scope.
+ * @param source - factory for the currently selected source fields.
+ * @returns the enhancement to apply, or null when the scope is off.
+ */
+export function captureContextEnhancementSource(provider, conversationType, source) {
+  const snapshot = captureContextEnhancement(provider, conversationType);
+  return snapshot === null ? null : Object.freeze({ snapshot, source });
+}
+
 function sourceString(value, field) {
   if (field === 'senderId' && (typeof value === 'bigint' || Number.isFinite(value))) {
     value = String(value);
@@ -165,7 +202,7 @@ function sourceBlock(snapshot, sourceFactory) {
   const json = JSON.stringify(projected).replace(/[<>&]/g, (character) => ({
     '<': '\\u003c', '>': '\\u003e', '&': '\\u0026',
   })[character]);
-  return `<dsh_im_source>${json}</dsh_im_source>`;
+  return `${INJECTED_CONTEXT_TAGS.sourceOpen}${json}${INJECTED_CONTEXT_TAGS.sourceClose}`;
 }
 
 function guidanceBlock(guidance) {
@@ -173,7 +210,7 @@ function guidanceBlock(guidance) {
   const body = guidance.replace(/<\/?dsh_im_source_guidance\b[^>]*(?:>|$)/gi, (tag) => (
     tag.replace(/</g, '&lt;').replace(/>/g, '&gt;')
   ));
-  return `<dsh_im_source_guidance>\n${body}\n</dsh_im_source_guidance>`;
+  return `${INJECTED_CONTEXT_TAGS.guidanceOpen}\n${body}\n${INJECTED_CONTEXT_TAGS.guidanceClose}`;
 }
 
 /** Add one text prefix; never inspect sources, format or copy content when off. */
@@ -183,7 +220,7 @@ export function enhanceContextContent(content, snapshot, sourceFactory) {
     const blocks = [sourceBlock(snapshot, sourceFactory), guidanceBlock(snapshot.config.guidance)]
       .filter(Boolean);
     if (blocks.length === 0) return content;
-    const prefix = blocks.join('\n\n');
+    const prefix = blocks.join(INJECTED_CONTEXT_SEPARATOR);
     if (typeof content === 'string') return `${prefix}\n\n${content}`;
     if (Array.isArray(content)) return [{ type: 'text', text: prefix }, ...content];
     return content;

package/src/channels/shared/control-command.mjs

@@ -1,3 +1,4 @@
+import { enhanceContextContent } from './context-enhancement.mjs';
 import { t } from './i18n.mjs';
 import manifest from '../../../package.json' with { type: 'json' };
 
@@ -41,6 +42,7 @@ export async function runControlCommand(text, harness, state, key, {
   pendingInteraction = false,
   control,
   deferredDelivery,
+  enhancement,
 } = {}) {
   if (!isControlCommand(text)) return null;
   const command = text.trim();
@@ -93,8 +95,13 @@ export async function runControlCommand(text, harness, state, key, {
   if (typeof session.steerActiveTurn !== 'function') {
     throw new TypeError('Harness session does not support steering active turns');
   }
+  // A mid-turn correction carries the same provenance as the message that
+  // opened the turn, so a group member who steers is identified too.
+  const steering = enhancement
+    ? enhanceContextContent(instruction, enhancement.snapshot, enhancement.source)
+    : instruction;
   const steered = await session.steerActiveTurn(
-    instruction,
+    steering,
     control,
     requestOptions(signal),
   );

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

@@ -13,6 +13,7 @@ import {
   imageFileSourcesFromContent,
   isModelImageRejection,
 } from './image-prompt.mjs';
+import { imSourceGuidance } from './im-source-guidance.mjs';
 import { outboundArtifactRegistry } from './semantic/artifact.mjs';
 import { t } from './i18n.mjs';
 import { watchHarnessMux } from './harness-mux.mjs';
@@ -893,7 +894,7 @@ export class HarnessClient {
         stdio: ['ignore', 'inherit', 'inherit'],
       });
       this.#managedProcess.on('error', (error) => {
-        console.error(`[${this.#logPrefix}] failed to start Harness:`, error.message);
+        console.error('[dsh-im] failed to start Harness:', this.#logPrefix, error.message);
       });
     }
 
@@ -1123,7 +1124,7 @@ export class HarnessClient {
         });
       } catch (error) {
         if (signal.aborted) return;
-        console.warn(`[${this.#logPrefix}] Harness interaction stream disconnected:`, error.message);
+        console.warn('[dsh-im] Harness interaction stream disconnected:', this.#logPrefix, error.message);
       }
       if (signal.aborted) return;
       try {
@@ -1462,7 +1463,7 @@ export class HarnessClient {
           deliveredArtifactCount += 1;
         } catch (error) {
           outboundArtifactRegistry.release(artifact);
-          console.warn(`[${this.#logPrefix}] ignored an artifact handoff failure:`, error.message);
+          console.warn('[dsh-im] ignored an artifact handoff failure:', this.#logPrefix, error.message);
         }
       }
       return deliveredArtifactCount;
@@ -1508,6 +1509,12 @@ export class HarnessClient {
       if (!Array.isArray(content) || content.length === 0) {
         throw new TypeError('Harness prompt content is required');
       }
+      // Publish the guidance the channel's own captured settings produced, so
+      // the Host materializes it once per Session as prompt context instead of
+      // per user message. It is passed in and never parsed back out of
+      // `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.rpc('session.prompt', {
         sessionId,
@@ -1534,7 +1541,8 @@ export class HarnessClient {
         } catch (stagingError) {
           if (signal?.aborted) throw signal.reason ?? stagingError;
           console.warn(
-            `[${this.#logPrefix}] unable to restage rejected images as workspace files:`,
+            '[dsh-im] unable to restage rejected images as workspace files:',
+            this.#logPrefix,
             stagingError?.message ?? String(stagingError),
           );
           throw error;
@@ -1586,7 +1594,7 @@ export class HarnessClient {
               try {
                 await onUpdate(update);
               } catch (error) {
-                console.warn(`[${this.#logPrefix}] ignored a progress update failure:`, error.message);
+                console.warn('[dsh-im] ignored a progress update failure:', this.#logPrefix, error.message);
               }
             }
           }
@@ -1643,7 +1651,7 @@ export class HarnessClient {
           try {
             await staged?.cleanup?.();
           } catch (error) {
-            console.warn(`[${this.#logPrefix}] unable to clean inbound files:`, error.message);
+            console.warn('[dsh-im] unable to clean inbound files:', this.#logPrefix, error.message);
           }
         }
       }
@@ -1677,7 +1685,7 @@ export class HarnessClient {
       try {
         onOpen?.();
       } catch (error) {
-        console.warn(`[${this.#logPrefix}] ignored an interaction open callback failure:`, error.message);
+        console.warn('[dsh-im] ignored an interaction open callback failure:', this.#logPrefix, error.message);
       }
       if (ownership) {
         void this.#refreshInteractionOwnerships(sessionId, signal).then(() => {
@@ -1769,7 +1777,7 @@ export class HarnessClient {
         if (!ownershipReady) bufferedEnvelopes.push(envelope);
         else processEnvelope(envelope);
       } catch (error) {
-        console.warn(`[${this.#logPrefix}] ignored a malformed Harness interaction frame:`, error.message);
+        console.warn('[dsh-im] ignored a malformed Harness interaction frame:', this.#logPrefix, error.message);
       }
     };
     try {
@@ -1806,7 +1814,7 @@ export class HarnessClient {
             try {
               onReconnect?.();
             } catch (error) {
-              console.warn(`[${this.#logPrefix}] mux reconnect hook failed:`, error.message);
+              console.warn('[dsh-im] mux reconnect hook failed:', this.#logPrefix, error.message);
             }
           },
           onEnvelope: (envelope) => {
@@ -1822,13 +1830,13 @@ export class HarnessClient {
                 || typeof payload.event !== 'object') return;
               onSessionEvent({ sessionId: payload.sessionId, event: payload.event });
             } catch (error) {
-              console.warn(`[${this.#logPrefix}] ignored a malformed global mux frame:`, error.message);
+              console.warn('[dsh-im] ignored a malformed global mux frame:', this.#logPrefix, error.message);
             }
           },
         });
       } catch (error) {
         if (signal.aborted) return;
-        console.warn(`[${this.#logPrefix}] Harness event mux disconnected:`, error.message);
+        console.warn('[dsh-im] Harness event mux disconnected:', this.#logPrefix, error.message);
       }
       if (signal.aborted) return;
       try {
@@ -1848,7 +1856,7 @@ export class HarnessClient {
       rpcId: `${this.#rpcIdPrefix}-${randomUUID()}`,
       ...options,
       onMalformed: (error) => {
-        console.warn(`[${this.#logPrefix}] ignored a malformed Harness mux frame:`, error.message);
+        console.warn('[dsh-im] ignored a malformed Harness mux frame:', this.#logPrefix, error.message);
       },
     });
   }

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

@@ -16,7 +16,13 @@ export function validHarnessQuestion(question) {
       ))));
 }
 
-export function harnessQuestionText(question, index, total, { requiresMention = false } = {}) {
+/** Render the question prompt. `hasButtons` only swaps the closing hint: the
+ * numbered list stays, because a channel whose keyboard fails still answers by text.
+ */
+export function harnessQuestionText(question, index, total, {
+  requiresMention = false,
+  hasButtons = false,
+} = {}) {
   const lines = [];
   const progress = total > 1 ? `（${index + 1}/${total}）` : '';
   lines.push(t('DeepSeek Harness 需要你补充信息{progress}：', { progress }));
@@ -34,7 +40,9 @@ export function harnessQuestionText(question, index, total, { requiresMention =
     });
     lines.push('', question.multiSelect === true
       ? t('请回复选项序号或文字；多选用逗号分隔，也可补充其他内容。')
-      : t('请回复一个选项序号或文字，也可直接输入其他答案。'));
+      : hasButtons
+        ? t('请点击下方按钮选择，也可直接回复文字。')
+        : t('请回复一个选项序号或文字，也可直接输入其他答案。'));
   } else {
     lines.push('', t('请直接回复你的答案。'));
   }

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

@@ -16,6 +16,7 @@ export default {
 
   '钉钉未能换取图片下载地址，请重新发送；若持续失败，请检查机器人的“企业内机器人发送消息权限”。': 'DingTalk could not provide the image download address. Please resend; if it keeps failing, check the bot\'s "Send messages as an internal robot" permission.',
   '钉钉没有返回图片下载地址，请重新发送。': 'DingTalk did not return an image download address. Please resend.',
+  '钉钉未提供引用附件的下载信息，无法读取原附件。请直接重新发送附件后再提问。': 'DingTalk did not provide download information for the quoted attachment, so it cannot be read. Please resend the attachment directly with your question.',
   '钉钉返回的图片临时地址无法读取，请重新发送。': 'The temporary image address returned by DingTalk could not be read. Please resend.',
   '结果文件「{name}」发送结果未能确认，请先检查聊天内是否已收到，不要立即重试。': 'Delivery of the result file "{name}" could not be confirmed. Please check whether it already arrived in the chat before retrying.',
   '结果文件「{name}」已生成，但钉钉应用或机器人缺少文件消息权限。请开通应用 qyapi_base 权限，并确认机器人具备文件消息发送能力。': 'Result file "{name}" was generated, but the DingTalk app or bot lacks file message permission. Enable the app\'s qyapi_base permission and make sure the bot can send file messages.',

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

@@ -1,5 +1,8 @@
 // English translations (qq area). Keys are exact Chinese literals passed to t().
 export default {
+  '无法读取 QQ 本地状态，请检查数据目录及访问权限。': 'Unable to read local QQ state. Check the data directory and access permissions.',
+  'QQ 本地状态已损坏，但无法备份，原文件已保留。': 'Local QQ state is corrupt and could not be backed up. The original file has been preserved.',
+  '无法保存 QQ 本地状态，请检查磁盘空间及目录写入权限。': 'Unable to save local QQ state. Check disk space and directory write permissions.',
   '返回主菜单': 'Back to main menu',
   '模式／预设': 'Mode / preset',
   '归档显示': 'Archived sessions',

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

@@ -226,4 +226,15 @@ export default {
     'Failed to submit the answer. Please resend your answer to the current question.',
   '检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。':
     'A pending question left over in this Session was detected. It has been safely cancelled, and your latest message is being processed.',
+  // Inline-keyboard question cards (text-harness-bridge.mjs).
+  '该问题已处理，无需再次选择。':
+    'This question has already been handled; no further choice is needed.',
+  '只有发起当前任务的用户可以处理这条问题。':
+    'Only the user who started this task can answer this question.',
+  '正在提交你的选择，请稍候。': 'Submitting your choice, please wait.',
+  '这个选项已失效，请使用最新一条问题。':
+    'This option has expired. Please use the most recent question message.',
+  '多选问题请直接回复文字。':
+    'Please answer a multi-select question by replying with text.',
+  '已选择：{label}': 'Selected: {label}',
 };

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

@@ -83,6 +83,8 @@ export default {
     'Reply with option numbers or text; separate multiple choices with commas, or add anything else.',
   '请回复一个选项序号或文字，也可直接输入其他答案。':
     'Reply with an option number or its text, or type your own answer directly.',
+  '请点击下方按钮选择，也可直接回复文字。':
+    'Tap a button below to choose, or reply with text directly.',
   '请直接回复你的答案。': 'Please reply with your answer directly.',
   '群聊中请 @机器人 后发送答案。':
     'In group chats, please @ the bot before sending your answer.',

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

@@ -6,6 +6,7 @@ export default {
   '微信已连接 DeepSeek Harness。': 'WeChat is connected to DeepSeek Harness.',
   '结果文件「{name}」已生成，但微信机器人当前没有文件消息发送权限，请检查机器人文件消息能力。': 'The result file "{name}" was generated, but the WeChat bot currently has no permission to send file messages. Please check the bot\'s file messaging capability.',
   '结果文件「{name}」超过当前微信会话可发送的文件大小，未发送。': 'The result file "{name}" exceeds the file size limit of the current WeChat conversation and was not sent.',
+  '结果文件「{name}」上传微信时长时间没有进展，已超时，文件尚未发送。请检查网络后重试，或压缩、拆分文件后发送。': 'The upload of "{name}" to WeChat stalled and timed out. The file has not been sent. Check your network and retry, or compress or split the file before sending.',
   '结果文件「{name}」暂时被微信限流，未能发送，请稍后重试。': 'The result file "{name}" was temporarily rate-limited by WeChat and was not sent. Please try again later.',
   '结果文件「{name}」已生成，但微信拒绝了该文件消息。': 'The result file "{name}" was generated, but WeChat rejected the file message.',
   '结果文件「{name}」已生成，但暂时未能通过微信发送，请稍后重试。': 'The result file "{name}" was generated but could not be sent via WeChat right now. Please try again later.',
@@ -72,6 +73,7 @@ export default {
   '微信文件上传失败（HTTP {status}）。': 'The WeChat file upload failed (HTTP {status}).',
   '微信文件上传响应缺少下载参数。': 'The WeChat file upload response is missing the download parameter.',
   '微信文件上传失败。': 'The WeChat file upload failed.',
+  '微信文件上传长时间没有进展，已超时。': 'The WeChat file upload stalled and timed out.',
   '拒绝访问不受信任的微信服务地址。': 'Refusing to access an untrusted WeChat service URL.',
   '微信服务请求失败（HTTP {status}）。': 'The WeChat service request failed (HTTP {status}).',
   '微信服务返回了无法解析的响应。': 'The WeChat service returned an unparseable response.',

package/src/channels/shared/im-source-guidance.mjs

@@ -0,0 +1,65 @@
+// Session-keyed source guidance for the current conversation.
+//
+// The prompt RPC carries no message source, so a channel publishes the guidance
+// it would otherwise repeat inside every user message when it dispatches the
+// prompt. The Host materializes it once per session as dynamic prompt context
+// (`systemPrompt.context`), which appends a durable snapshot only when the
+// rendered text changes. The registry is module-level because one process owns
+// exactly one, the same shape `outboundArtifactRegistry` uses.
+
+/** Prompt-context name the Host materializes this guidance under. */
+export const IM_SOURCE_GUIDANCE_CONTEXT = 'dsh-im:source-guidance';
+
+/** Contexts are joined in ascending order; this one follows the policy facts. */
+export const IM_SOURCE_GUIDANCE_ORDER = 125;
+
+/** Bound for one session's guidance; the settings cap is the same size. */
+const GUIDANCE_MAX_LENGTH = 8_000;
+
+/** Bound on retained sessions, so an abandoned conversation cannot grow it. */
+const MAX_SESSIONS = 1_024;
+
+class ImSourceGuidanceRegistry {
+  #bySession = new Map();
+
+  /**
+   * Publish the guidance in force for one session. Empty guidance clears it, so
+   * a conversation that turns enhancement off stops contributing a snapshot.
+   * @param sessionId - the Session the prompt was dispatched to.
+   * @param guidance - the scope's guidance text, or empty when none applies.
+   */
+  publish(sessionId, guidance) {
+    if (typeof sessionId !== 'string' || !sessionId) return;
+    const text = typeof guidance === 'string' ? guidance.slice(0, GUIDANCE_MAX_LENGTH) : '';
+    // Delete first so the re-inserted key is the most recently used one.
+    this.#bySession.delete(sessionId);
+    if (!text.trim()) return;
+    this.#bySession.set(sessionId, text);
+    while (this.#bySession.size > MAX_SESSIONS) {
+      this.#bySession.delete(this.#bySession.keys().next().value);
+    }
+  }
+
+  /**
+   * @param sessionId - a Session id, or anything else.
+   * @returns the guidance in force for that session, or undefined.
+   */
+  get(sessionId) {
+    return typeof sessionId === 'string' ? this.#bySession.get(sessionId) : undefined;
+  }
+
+  /**
+   * Drop one session's guidance.
+   * @param sessionId - the Session leaving the registry.
+   */
+  forget(sessionId) {
+    if (typeof sessionId === 'string') this.#bySession.delete(sessionId);
+  }
+
+  /** @returns how many sessions currently carry guidance. */
+  get size() {
+    return this.#bySession.size;
+  }
+}
+
+export const imSourceGuidance = new ImSourceGuidanceRegistry();