@xmanrui/dsh-im 4.30.0 → 4.32.0

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "description": "Connect Telegram, WhatsApp, Slack, Discord, Matrix, WeChat, Feishu, WeCom, DingTalk, and QQ to DSH."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "description": "把微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix接入DSH。"
+  }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.30.0",
+  "version": "4.32.0",
   "icon": "./assets/logo-plugin-message-link-gradient.webp",
-  "description": "把十二种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect twelve IM channels and a public AI Office to a local DeepSeek Harness.",
+  "description": "把微信、飞书、企微、钉钉、QQ、Telegram、WhatsApp、Slack、Discord、Matrix接入DSH。 Connect Telegram, WhatsApp, Slack, Discord, Matrix, WeChat, Feishu, WeCom, DingTalk, and QQ to DSH.",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -90,6 +90,10 @@
     {
       "name": "Biertolovisk",
       "url": "https://github.com/rosalynthompson32-a11y"
+    },
+    {
+      "name": "Tianjun Cai",
+      "url": "https://github.com/Pegasus02"
     }
   ],
   "license": "MIT",
@@ -112,13 +116,15 @@
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
     "assets",
     "bin",
     "cordis.patch.yml",
     "lib",
+    "locale/*.json",
     "plugin-src",
     "scripts/verify-interface-language.mjs",
     "scripts/verify-injected-context.mjs",
@@ -178,7 +184,7 @@
     "mailparser": "^3.9.28",
     "nodemailer": "^10.0.10",
     "qrcode": "1.5.4",
-    "undici": "7.29.0"
+    "undici": "7.29.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",

package/plugin-src/client/context-enhancement.js

@@ -20,6 +20,7 @@ const FIELD_LABELS = Object.freeze({
   chatId: '会话标识',
   threadId: '话题标识',
   botId: '机器人标识',
+  sentAt: '发送时间',
 });
 
 const FIELD_HELP = Object.freeze({
@@ -39,6 +40,10 @@ const FIELD_HELP = Object.freeze({
     labelKey: 'threadIdHelpLabel',
     text: '该字段不是每个渠道都能提供。飞书话题群的消息会带上话题 ID，用于区分同一群组内的不同话题；当前消息不在话题中时，即使已选择该字段，<dsh_im_source> 中也会省略 threadId。',
   }),
+  sentAt: Object.freeze({
+    labelKey: 'sentAtHelpLabel',
+    text: '当前消息的发送时间，格式为 YYYY-MM-DD HH:mm:ss（本机时区）。优先使用平台给出的发送时间；平台未提供时，从微信消息 ID 中解析出发送时间；两者都不可用时，即使已选择该字段，<dsh_im_source> 中也会省略 sentAt。目前仅微信渠道提供；把本机时区写进增强提示词，模型判断先后顺序时更准确。',
+  }),
 });
 
 const SCOPE_COPY = Object.freeze({
@@ -50,6 +55,7 @@ const SCOPE_COPY = Object.freeze({
     conversationTitleHelpLabel: '查看群聊会话标题字段说明',
     chatIdHelpLabel: '查看群聊会话标识字段说明',
     threadIdHelpLabel: '查看群聊话题标识字段说明',
+    sentAtHelpLabel: '查看群聊发送时间字段说明',
     guidanceLabel: '增强提示词',
     guidanceHelpLabel: '查看群聊增强提示词使用说明',
     guidanceUsage: '用于告诉模型如何使用当前群聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。',
@@ -63,6 +69,7 @@ const SCOPE_COPY = Object.freeze({
     conversationTitleHelpLabel: '查看私聊会话标题字段说明',
     chatIdHelpLabel: '查看私聊会话标识字段说明',
     threadIdHelpLabel: '查看私聊话题标识字段说明',
+    sentAtHelpLabel: '查看私聊发送时间字段说明',
     guidanceLabel: '增强提示词',
     guidanceHelpLabel: '查看私聊增强提示词使用说明',
     guidanceUsage: '用于告诉模型如何使用当前私聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。',

package/plugin-src/client/i18n.js

@@ -42,6 +42,8 @@ const EN = Object.freeze({
   '无需安装第三方服务；请按指引授予 macOS Messages 访问权限。': 'No third-party service is required; follow the guide to grant macOS Messages access.',
   'macOS Messages 权限': 'macOS Messages permissions',
   'IM机器人': 'IM bots',
+  '打开 IM机器人': 'Open IM bots',
+  '返回插件详情': 'Back to plugin details',
   'IM机器人设置': 'IM bot settings',
   'IM 面板加载失败': 'Could not load the IM panel',
   '更多机器人设置': 'More bot settings',
@@ -420,6 +422,10 @@ const EN = Object.freeze({
   '查看私聊话题标识字段说明': 'View direct topic ID field details',
   '该字段不是每个渠道都能提供。飞书话题群的消息会带上话题 ID，用于区分同一群组内的不同话题；当前消息不在话题中时，即使已选择该字段，<dsh_im_source> 中也会省略 threadId。': 'This field is not available on every channel. Messages in a Feishu topic chat carry the topic ID, which distinguishes different topics inside the same group. If the current message is not inside a topic, <dsh_im_source> omits threadId even when the field is selected.',
   '机器人标识': 'Bot ID',
+  '发送时间': 'Sent at',
+  '查看群聊发送时间字段说明': 'View group sent-at field details',
+  '查看私聊发送时间字段说明': 'View direct sent-at field details',
+  '当前消息的发送时间，格式为 YYYY-MM-DD HH:mm:ss（本机时区）。优先使用平台给出的发送时间；平台未提供时，从微信消息 ID 中解析出发送时间；两者都不可用时，即使已选择该字段，<dsh_im_source> 中也会省略 sentAt。目前仅微信渠道提供；把本机时区写进增强提示词，模型判断先后顺序时更准确。': 'When the current message was sent, as YYYY-MM-DD HH:mm:ss in the local time zone. The platform send time is used when available; otherwise the send time is decoded from the WeChat message ID. If neither is available, <dsh_im_source> omits sentAt even when the field is selected. WeChat is the only channel that provides it today. Naming your time zone in the guidance makes ordering judgements more accurate.',
   '增强提示词': 'Guidance',
   '查看增强提示词使用说明': 'View guidance instructions',
   '查看群聊增强提示词使用说明': 'View group guidance instructions',
@@ -446,7 +452,7 @@ const EN = Object.freeze({
   '上下文增强保存失败，请重试。': 'Could not save context enhancement. Try again.',
   '请提交完整的上下文增强设置。': 'Submit the complete context enhancement settings.',
   '群聊和私聊开关必须是布尔值。': 'Group and direct switches must be booleans.',
-  '来源字段只能选择已定义的八个字段。': 'Source fields must be chosen from the eight defined fields.',
+  '来源字段只能选择已定义的字段。': 'Source fields must be chosen from the defined fields.',
   '保存中…': 'Saving…',
   '未设置': 'Not set',
   '工作区修改失败，请重试。': 'Could not update the workspace. Try again.',

package/plugin-src/client/index.js

@@ -83,6 +83,7 @@ import { installSessionChannelLogos } from './session-channel-logos.js';
 import { UpdatePanel, UPDATE_RPC_CHANNEL } from './update-panel.js';
 import { WorkspaceDirectoryPickerContext } from './workspace-editor.js';
 import { IMPanelErrorBoundary } from './panel-error-boundary.js';
+import { installImPluginPage } from './plugin-page.js';
 
 export const name = 'im-settings';
 export const inject = ['slots', 'connection', 'locale', 'workspaces'];
@@ -566,6 +567,8 @@ export function apply(ctx) {
     preferredSectionId: props.preferredSectionId,
   });
 
+  installImPluginPage(ctx, { packageName: manifest.name, renderPanel: buildPanelElement });
+
   ctx.effect(() => {
     let disposed = false;
     let stopSettings = null;

package/plugin-src/client/plugin-page.js

@@ -0,0 +1,51 @@
+import * as React from 'react';
+import { IM_LOCALE_NAMESPACE } from './i18n.js';
+
+export const IM_MAIN_PANEL_ID = 'xmanrui-dsh-im';
+const h = React.createElement;
+
+function OpenImAction({ subject, packageName, onOpen, t }) {
+  if (subject?.kind !== 'bundle' && subject?.kind !== 'row') return null;
+  if (subject.pkg?.name !== packageName) return null;
+  if (subject.kind === 'row' && subject.row?.moduleName !== packageName) return null;
+  return h('button', {
+    type: 'button', className: 'dim-pluginOpen', onClick: onOpen,
+  }, t('打开 IM机器人'));
+}
+
+function ImPluginPage({ renderPanel, onBack, t }) {
+  return h('div', { className: 'dim-pluginPage' },
+    h('div', { className: 'dim-pluginPageContent' },
+      h('button', { type: 'button', className: 'dim-pluginBack', onClick: onBack },
+        h('span', { 'aria-hidden': true }, '‹'), t('返回插件详情')),
+      renderPanel()));
+}
+
+// Optional services and slots keep the existing settings entry working on
+// older DSH versions. Reuse the same panel through public navigation APIs.
+export function installImPluginPage(ctx, { packageName, renderPanel }) {
+  if (typeof ctx.inject !== 'function') return;
+  ctx.inject(['layout', 'pluginNavigation'], (pageCtx) =>
+    pageCtx.slots.inject('main', () => {
+      const unregisterPage = pageCtx.slots.register({
+        name: 'main', key: IM_MAIN_PANEL_ID, locale: IM_LOCALE_NAMESPACE,
+        inject: () => ({
+          renderPanel,
+          onBack: () => pageCtx.pluginNavigation.openBundle(packageName),
+        }),
+      }, ImPluginPage);
+      const stopActions = pageCtx.slots.inject('plugins.detail.actions', () =>
+        pageCtx.slots.register({
+          name: 'plugins.detail.actions', id: 'xmanrui-dsh-im-open',
+          order: 20, locale: IM_LOCALE_NAMESPACE,
+          inject: () => ({
+            packageName,
+            onOpen: () => pageCtx.layout.selectPanel(IM_MAIN_PANEL_ID),
+          }),
+        }, OpenImAction));
+      return () => {
+        stopActions();
+        unregisterPage();
+      };
+    }));
+}

package/plugin-src/client/styles.js

@@ -1,6 +1,15 @@
 export const IM_STYLE_ID = 'xmanrui-dsh-im-settings';
 
 const CSS = String.raw`
+.dim-pluginOpen { display: inline-flex; align-items: center; justify-content: center; min-height: 36px; padding: 7px 14px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font: inherit; font-size: 13px; line-height: 20px; cursor: pointer; }
+.dim-pluginOpen:hover { background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-pluginOpen:focus-visible, .dim-pluginBack:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 3px; }
+.dim-pluginPage { height: 100%; min-height: 0; overflow: auto; box-sizing: border-box; padding: 24px clamp(16px, 4vw, 48px) 32px; color: var(--dsw-alias-label-primary, #1f2329); }
+.dim-pluginPageContent { max-width: 1080px; margin: 0 auto; }
+.dim-pluginBack { display: inline-flex; align-items: center; gap: 8px; min-height: 36px; margin: 0 0 24px; padding: 6px 8px; border: 0; border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: transparent; font: inherit; font-size: 13px; line-height: 20px; cursor: pointer; }
+.dim-pluginBack:hover { color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
+.dim-pluginBack > span { font-size: 22px; line-height: 20px; }
+@media (pointer: coarse) { .dim-pluginOpen, .dim-pluginBack { min-height: 44px; } }
 .dim-connectionDiagnostic { min-width: 0; width: 100%; color: var(--dsw-alias-label-secondary, #646a73); overflow-wrap: anywhere; font-size: 13px; line-height: 1.6; }
 .dim-connectionDiagnostic[data-warning="true"] { color: var(--dsw-alias-state-warn-primary, #d97706); }
 .dim-connectionDiagnostic p { margin: 4px 0; }

package/scripts/verify-package.mjs

@@ -219,7 +219,7 @@ const directDependencies = {
   '@tencent-connect/qqbot-nodejs': '1.0.4',
   '@wecom/aibot-node-sdk': '1.0.7',
   qrcode: '1.5.4',
-  undici: '7.29.0',
+  undici: '7.29.1',
 };
 for (const [name, version] of Object.entries(directDependencies)) {
   if (manifest.dependencies?.[name] !== version) {

package/src/channels/feishu/bridge.mjs

@@ -1264,7 +1264,7 @@ export class FeishuHarnessBridge {
       this.#commandTasks.add(current);
       return current;
     }
-    if (this.#isResolvedQuestionReply(event, key)) {
+    if (!hasImages && this.#isResolvedQuestionReply(event, key)) {
       const current = Promise.resolve()
         .then(() => this.#discardResolvedInteractionReply(event, messageId))
         .then(() => this.#finishReaction(messageId, processingReaction, 'DONE'))
@@ -1317,6 +1317,19 @@ export class FeishuHarnessBridge {
     if (pending && senderOpenId(event) !== pending.actor) {
       return this.#enqueueMessage(event, messageId, key, processingReaction);
     }
+    if (pending && hasImages) {
+      const previous = pending.queue ?? Promise.resolve();
+      const interruption = previous.catch(() => undefined)
+        .then(() => this.#interruptQuestionForImage(event, key, pending))
+        .finally(() => {
+          if (pending.queue === interruption) pending.queue = null;
+          this.#interactionTasks.delete(interruption);
+        });
+      pending.queue = interruption;
+      this.#interactionTasks.add(interruption);
+      // Reserve the image's FIFO position before stopping releases the original turn.
+      return this.#enqueueMessage(event, messageId, key, processingReaction);
+    }
     if (pending?.submitting || pending?.claimedReplyMessageId) {
       return this.#enqueueMessage(event, messageId, key, processingReaction);
     }
@@ -5809,6 +5822,40 @@ export class FeishuHarnessBridge {
     });
   }
 
+  async #interruptQuestionForImage(event, key, pending) {
+    if (this.#signal?.aborted || this.#pendingInteractions.get(key) !== pending) return;
+    const question = pending.questions[pending.index];
+    const questionMessageId = pending.questionCardMessageId;
+    const index = pending.index;
+    const wasSubmitting = pending.submitting;
+    pending.submitting = true;
+    try {
+      await runControlCommand('/stop', this.#harness, this.#state, key, {
+        signal: this.#signal,
+        control: { owner: this, key },
+      });
+    } catch (error) {
+      if (this.#pendingInteractions.get(key) === pending) pending.submitting = wasSubmitting;
+      this.#logger.warn?.('[dsh-feishu] could not stop the question turn for an image:', error.message);
+      await this.#send(event.message.chat_id,
+        t('图片已排队，但暂时无法结束当前提问。请先回答问题或发送 /stop，结束后会继续处理图片。'),
+        { replyTo: event.message.message_id }).catch(() => undefined);
+      return;
+    }
+    await this.#cancelPendingInteraction(key, pending.interactionId);
+    const resolvedText = t('已结束本轮提问，将在当前会话中继续处理图片。');
+    if (questionMessageId) {
+      await this.#patchCardMessage(event.message.chat_id, questionMessageId, questionCard({
+        ...question,
+        interactionId: pending.interactionId,
+        index,
+        total: pending.questions.length,
+        resolvedText,
+      }));
+    }
+    await this.#send(event.message.chat_id, resolvedText, { replyTo: event.message.message_id }).catch(() => undefined);
+  }
+
   async #submitQuestionAnswer(pending, answerText, { chatId, messageId, questionMessageId } = {}) {
     const question = pending.questions[pending.index];
     if (!question) return;
@@ -6146,8 +6193,8 @@ export class FeishuHarnessBridge {
     return this.#takePendingInteraction(key, interactionId) !== null;
   }
 
-  async #cancelPendingInteraction(key) {
-    const pending = this.#takePendingInteraction(key);
+  async #cancelPendingInteraction(key, interactionId) {
+    const pending = this.#takePendingInteraction(key, interactionId);
     if (!pending || pending.kind !== 'question') return;
     this.#rememberResolvedInteraction(key, pending);
     try {

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

@@ -1211,9 +1211,10 @@ export function splitStepStreamCardBlocks(
  * rendered as its own button; the selected option label is submitted via a
  * card callback. Multi-select questions fall back to the plain-text flow (the
  * caller decides), because a multi-select needs a confirm step.
+ * A resolvedText replaces the buttons when an image ends the question flow.
  * Action: answer:<interactionId>:<optionLabel>
  */
-export function questionCard({ interactionId, header, question, detail, options, index, total }) {
+export function questionCard({ interactionId, header, question, detail, options, index, total, resolvedText }) {
   const elements = [];
   const progress = total > 1 ? `（${index + 1}/${total}）` : '';
   if (header) elements.push({ tag: 'div', text: markdown(String(header)) });
@@ -1221,6 +1222,11 @@ export function questionCard({ interactionId, header, question, detail, options,
   elements.push({ tag: 'div', text: markdown(String(qText)) });
   if (detail) elements.push({ tag: 'div', text: markdown(String(detail)) });
 
+  if (resolvedText) {
+    elements.push({ tag: 'hr' }, { tag: 'div', text: markdown(resolvedText) });
+    return cardWith(t('⏹ 提问已结束{progress}', { progress }), elements);
+  }
+
   if (Array.isArray(options) && options.length > 0) {
     elements.push({ tag: 'hr' });
     for (const option of options) {

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

@@ -1,7 +1,7 @@
 // Shared by the Host and settings UI; keep this module browser-compatible.
 export const CONTEXT_ENHANCEMENT_FIELDS = Object.freeze([
   'channel', 'conversationType', 'senderId', 'senderName', 'conversationTitle',
-  'chatId', 'threadId', 'botId',
+  'chatId', 'threadId', 'botId', 'sentAt',
 ]);
 
 /**
@@ -56,7 +56,7 @@ const CHANNELS = new Set([
 ]);
 const SOURCE_LIMITS = {
   channel: 16, conversationType: 6, senderId: 256, senderName: 256,
-  conversationTitle: 256, chatId: 256, threadId: 256, botId: 128,
+  conversationTitle: 256, chatId: 256, threadId: 256, botId: 128, sentAt: 32,
 };
 const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g;
 
@@ -82,7 +82,7 @@ function validateContextEnhancementScope(input) {
     throw invalidConfig('群聊和私聊开关必须是布尔值。');
   }
   if (!Array.isArray(fields) || ![...fields].every((field) => CONTEXT_ENHANCEMENT_FIELDS.includes(field))) {
-    throw invalidConfig('来源字段只能选择已定义的八个字段。');
+    throw invalidConfig('来源字段只能选择已定义的字段。');
   }
   if (typeof guidance !== 'string' || guidance.length > CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH) {
     throw invalidConfig(`增强提示词不得超过 ${CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH} 个字符。`);
@@ -155,6 +155,70 @@ export function captureContextEnhancement(provider, conversationType) {
   }
 }
 
+/**
+ * Property a channel hangs its captured moment on, using `withSentAt`.
+ *
+ * It sits on the source factory instead of being read out of it, because a
+ * factory reads the inbound event's fields -- sometimes through throwing
+ * getters -- and only a prompt that actually renders a source block may do
+ * that. Local commands (`/help`, `/new`, `/steer`) take the enhancement to keep
+ * its privacy rules but never read a source, and that must stay true.
+ */
+const SENT_AT = 'sentAt';
+
+/** One-shot latch: a wiring bug is worth saying once, not once per message. */
+let warnedMissingSentAt = false;
+
+/**
+ * Wrap one channel source factory so it also publishes the moment of the
+ * message, without reading any of the message's fields yet.
+ *
+ * `value` may itself be a thunk: a channel that derives the moment from the
+ * inbound event (a `create_time_ms` field, a message-id decode) should pass one,
+ * because evaluating it here would read the inbound message even when the scope
+ * is disabled or the `sentAt` field is not selected -- and a disabled scope must
+ * read nothing at all.
+ *
+ * @param factory - the channel's source factory, or nothing.
+ * @param value - platform send time (epoch ms or ISO-8601), or a thunk
+ *   returning one. It is evaluated only when a rendered block selects `sentAt`;
+ *   an unusable value, or a thunk that throws, omits the field.
+ * @returns the same shape, plus `sentAt` when a usable value was supplied.
+ */
+export function withSentAt(factory, value) {
+  const wrapped = typeof factory === 'function' ? (...args) => factory(...args) : () => factory;
+  const published = typeof value === 'function' ? value : () => value;
+  Object.defineProperty(wrapped, SENT_AT, { value: published, enumerable: false });
+  return wrapped;
+}
+
+/**
+ * Evaluate the moment a channel published, without invoking its source factory.
+ *
+ * Called only while a prompt is rendering a block that selected `sentAt` --
+ * never at capture time -- so an unselected field, a disabled scope, a missing
+ * provider or a local command never reads the inbound message's clock. A
+ * throwing accessor (for example a getter on the inbound event) is contained
+ * here: it costs this one field, not the message.
+ *
+ * @param source - a source factory carrying `sentAt`, or a plain source object.
+ * @returns `{ published, ms }`: whether a moment was published at all, and its
+ *   epoch milliseconds when it was usable.
+ */
+function readPublishedSentAt(source) {
+  const own = typeof source === 'function' || (source !== null && typeof source === 'object')
+    ? source?.[SENT_AT]
+    : undefined;
+  if (typeof own !== 'function') return { published: false, ms: undefined };
+  let value;
+  try {
+    value = own();
+  } catch {
+    return { published: true, ms: undefined };
+  }
+  return { published: true, ms: timestampMs(value) ?? undefined };
+}
+
 /**
  * Capture the enhancement one prompt replays, together with the source factory
  * that fills its selected fields.
@@ -167,12 +231,55 @@ export function captureContextEnhancement(provider, conversationType) {
  *
  * @param provider - the bot's enhancement provider.
  * @param conversationType - the inbound message's scope.
- * @param source - factory for the currently selected source fields.
+ * @param source - factory for the currently selected source fields; attach the
+ *   moment with `withSentAt` to publish a platform send time.
  * @returns the enhancement to apply, or null when the scope is off.
  */
 export function captureContextEnhancementSource(provider, conversationType, source) {
+  // No provider means enhancement is not configured for this channel at all, so
+  // there is nothing to capture -- and the thunk a channel published must not be
+  // evaluated. Answering null here is what lets every channel call this
+  // unconditionally, including bots with no enhancement settings.
+  if (typeof provider?.getSettings !== 'function') return null;
   const snapshot = captureContextEnhancement(provider, conversationType);
-  return snapshot === null ? null : Object.freeze({ snapshot, source });
+  if (snapshot === null) return null;
+  // Nothing is read here -- not the message's fields and not the moment a
+  // channel published through `withSentAt`. Local commands capture too (to keep
+  // the privacy rules for a later prompt) but never render, and a capture whose
+  // scope does not select `sentAt` must never touch the clock; the moment is
+  // evaluated only by the render that actually needs it.
+  return Object.freeze({ snapshot, source });
+}
+
+/** Accept a millisecond epoch or an ISO-8601 string; anything else yields null. */
+function timestampMs(value) {
+  if (value === undefined || value === null || value === '') return null;
+  if (typeof value === 'bigint') value = Number(value);
+  if (typeof value === 'number') return Number.isSafeInteger(value) ? value : null;
+  if (typeof value === 'string') {
+    const parsed = Date.parse(value);
+    return Number.isSafeInteger(parsed) ? parsed : null;
+  }
+  return null;
+}
+
+/**
+ * Render one epoch instant as `YYYY-MM-DD HH:mm:ss` in local time. The zone is
+ * deliberately omitted: four independent components already carry the digits,
+ * and the guidance text is the place to name the timezone.
+ *
+ * Padding is spelled out per component instead of calling a module-level
+ * helper: `sourceBlock` can run while this module is still initializing, and
+ * reading a `const` declared below would throw a temporal-dead-zone error that
+ * the caller's catch silently swallows -- dropping the entire prefix.
+ */
+function formatTimestamp(ms) {
+  const date = new Date(ms);
+  const year = date.getFullYear();
+  if (!Number.isInteger(year)) return undefined;
+  const pad = (value) => String(value).padStart(2, '0');
+  return `${year}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+    + ` ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
 }
 
 function sourceString(value, field) {
@@ -193,6 +300,25 @@ function sourceBlock(snapshot, sourceFactory) {
   const source = needsSource ? sourceFactory?.() : null;
   const projected = {};
   for (const field of fields) {
+    if (field === 'sentAt') {
+      // Only a channel that published a moment through `withSentAt` renders
+      // this field, and the moment is evaluated here, the first and only time
+      // it is needed. A field the factory returns is never read for it: a
+      // channel that did not wire a moment omits the field rather than fall
+      // back to the local clock, which the model could not tell apart.
+      const { published, ms } = readPublishedSentAt(sourceFactory);
+      const formatted = ms === undefined ? undefined : formatTimestamp(ms);
+      if (typeof formatted === 'string' && formatted) {
+        projected[field] = formatted.slice(0, SOURCE_LIMITS[field]);
+      } else if (published && !warnedMissingSentAt) {
+        // The channel did publish a moment but it was unusable or failed to
+        // read: say so once, because the omitted field is otherwise
+        // indistinguishable from a channel that supplies none.
+        warnedMissingSentAt = true;
+        console.warn('[dsh-im] a published sentAt was unusable and was omitted from the block');
+      }
+      continue;
+    }
     const value = field === 'botId' || field === 'conversationType'
       ? snapshot[field] : source?.[field];
     const normalized = sourceString(value, field);
@@ -213,11 +339,26 @@ function guidanceBlock(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. */
+/**
+ * Add one text prefix; never inspect sources, format or copy content when off.
+ *
+ * @param content - the message body the channel is about to send.
+ * @param snapshot - either a capture from `captureContextEnhancementSource`
+ *   (which already carries the moment and its own source) or a bare scope
+ *   snapshot from `captureContextEnhancement`.
+ * @param sourceFactory - the channel's source factory, when the caller holds it
+ *   separately from the capture. Omit it for a capture: the capture's own
+ *   factory and moment are used, so a `sentAt` selection cannot be lost by
+ *   passing only its `.snapshot`.
+ */
 export function enhanceContextContent(content, snapshot, sourceFactory) {
   if (!snapshot) return content;
+  // A capture is `{snapshot, source}`; a bare scope is `{config, ...}`.
+  const scope = snapshot.config ? snapshot : snapshot.snapshot;
+  if (!scope?.config) return content;
+  const factory = sourceFactory ?? (snapshot.config ? undefined : snapshot.source);
   try {
-    const blocks = [sourceBlock(snapshot, sourceFactory), guidanceBlock(snapshot.config.guidance)]
+    const blocks = [sourceBlock(scope, factory), guidanceBlock(scope.config.guidance)]
       .filter(Boolean);
     if (blocks.length === 0) return content;
     const prefix = blocks.join(INJECTED_CONTEXT_SEPARATOR);

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

@@ -1,5 +1,10 @@
 // English translations (feishu area). Keys are exact Chinese literals passed to t().
 export default {
+  '已结束本轮提问，将在当前会话中继续处理图片。':
+    'The questions have been closed. Your image will be processed in this conversation.',
+  '图片已排队，但暂时无法结束当前提问。请先回答问题或发送 /stop，结束后会继续处理图片。':
+    'Your image is queued, but the current questions could not be closed. Answer them or send /stop; your image will be processed afterward.',
+  '⏹ 提问已结束{progress}': '⏹ Questions closed{progress}',
   '内容已合并至后续消息。': 'Content has been consolidated into the following messages.',
   // feishu/bridge.mjs — welcome / help
   '北汇星河 AIOS 已连接 DeepSeek Harness。':

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

@@ -40,6 +40,7 @@ import {
   captureContextEnhancement,
   captureContextEnhancementSource,
   enhanceContextContent,
+  withSentAt,
 } from '../shared/context-enhancement.mjs';
 import {
   hasInboundImages,
@@ -398,9 +399,20 @@ export class WeixinHarnessBridge {
       this.#acceptedMessageIds.set(messageId, null);
       return this.#finishAccessDecision(messageId, sender, message, access);
     }
-    this.#acceptedMessageIds.set(messageId, captureContextEnhancement(
+    // Capture through the *source* entry point, not the bare config snapshot:
+    // the enhancement that renders the user message is read back from this map
+    // at prompt time, and a rendered `sentAt` selection needs the factory that
+    // carries the moment. Nothing is read here; the thunk runs only when that
+    // render selects `sentAt`.
+    this.#acceptedMessageIds.set(messageId, captureContextEnhancementSource(
       this.#contextEnhancement,
       'direct',
+      withSentAt(
+        () => ({ channel: 'weixin', senderId: sender, chatId: sender }),
+        // A thunk: the platform send time (falling back to the iLink message-id
+        // clock) is only decoded when a `sentAt` selection actually renders.
+        () => message?.create_time_ms ?? weixinMessageTimestampMs(messageId),
+      ),
     ));
     if (sender === this.#ownerUserId) {
       rememberConnectionTestTarget(this.#state, { toUserId: sender });
@@ -717,7 +729,14 @@ export class WeixinHarnessBridge {
       enhancement: captureContextEnhancementSource(
         this.#contextEnhancement,
         'direct',
-        () => ({ channel: 'weixin', senderId: sender, chatId: sender }),
+        // The moment rides on the factory as a thunk, so a local command that
+        // never renders a source block -- and a scope that is off or does not
+        // select `sentAt` -- reads nothing from the inbound message.
+        withSentAt(
+          () => ({ channel: 'weixin', senderId: sender, chatId: sender }),
+          // Platform send time, falling back to the iLink message-id clock.
+          () => message?.create_time_ms ?? weixinMessageTimestampMs(messageId),
+        ),
       ),
     });
     if (result?.stopped) {
@@ -817,15 +836,14 @@ export class WeixinHarnessBridge {
         let content = hasImages || hasReply
           ? await promptContentForInboundMessage(promptMessage, { signal: this.#signal, deferImages: true })
           : undefined;
-        const snapshot = this.#acceptedMessageIds.get(messageId);
+        const captured = this.#acceptedMessageIds.get(messageId);
         let contextEnhanced = false;
-        if (snapshot) {
+        if (captured) {
           const originalContent = content ?? text;
-          content = enhanceContextContent(originalContent, snapshot, () => ({
-            channel: 'weixin',
-            senderId: sender,
-            chatId: sender,
-          }));
+          // The capture already carries the moment its own source published, so
+          // `enhanceContextContent` accepts it as-is: passing only `.snapshot`
+          // here would drop `sentAt` and silently render no block at all.
+          content = enhanceContextContent(originalContent, captured);
           contextEnhanced = content !== originalContent;
         }
         await this.#state.markSeen(messageId);
@@ -838,7 +856,7 @@ export class WeixinHarnessBridge {
           text,
           content,
           titleText: batchSubmission?.title,
-          sourceGuidance: snapshot?.config?.guidance,
+          sourceGuidance: captured?.snapshot?.config?.guidance,
           contextEnhanced,
           createOptions: { signal: this.#signal },
           existsOptions: { signal: this.#signal },