@xmanrui/dsh-im 4.20.2 → 4.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.20.2",
+  "version": "4.21.0",
   "description": "把十一种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect eleven IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
@@ -64,6 +64,22 @@
     {
       "name": "lyzhu86",
       "url": "https://github.com/lyzhu86"
+    },
+    {
+      "name": "Librazy",
+      "url": "https://github.com/Librazy"
+    },
+    {
+      "name": "Johnslee1207",
+      "url": "https://github.com/johnslee1207-commits"
+    },
+    {
+      "name": "Dong09",
+      "url": "https://github.com/Dong09"
+    },
+    {
+      "name": "wings1848",
+      "url": "https://github.com/wings1848"
     }
   ],
   "license": "MIT",

package/plugin-src/client/channel-logos.js

@@ -109,13 +109,26 @@ export function DiscordLogoGlyph({ size } = {}) {
 export function SlackLogoGlyph({ size } = {}) {
   return h('svg', {
     ...dimensions(size),
-    viewBox: '0 0 24 24',
+    viewBox: '0 0 100 100',
     focusable: 'false',
     'aria-hidden': 'true',
     'data-im-channel-logo': 'slack',
-  }, h('path', {
-    fill: 'currentColor',
-    d: 'M6 15a2 2 0 1 1-2-2h2v2Zm1 0a2 2 0 1 1 4 0v5a2 2 0 1 1-4 0v-5Zm2-8a2 2 0 1 1 2-2v2H9Zm0 1a2 2 0 1 1 0 4H4a2 2 0 1 1 0-4h5Zm8 2a2 2 0 1 1 2 2h-2v-2Zm-1 0a2 2 0 1 1-4 0V5a2 2 0 1 1 4 0v5Zm-2 8a2 2 0 1 1-2 2v-2h2Zm0-1a2 2 0 1 1 0-4h5a2 2 0 1 1 0 4h-5Z',
+  },
+  h('path', {
+    fill: '#36C5F0',
+    d: 'M36.5 0A10.5 10.5 0 0 0 36.5 21H47V10.5A10.5 10.5 0 0 0 36.5 0ZM10.5 26a10.5 10.5 0 0 0 0 21h26a10.5 10.5 0 0 0 0-21Z',
+  }),
+  h('path', {
+    fill: '#2EB67D',
+    d: 'M100 36.5A10.5 10.5 0 0 0 79 36.5V47h10.5A10.5 10.5 0 0 0 100 36.5ZM74 10.5a10.5 10.5 0 0 0-21 0v26a10.5 10.5 0 0 0 21 0Z',
+  }),
+  h('path', {
+    fill: '#ECB22E',
+    d: 'M63.5 100a10.5 10.5 0 0 0 0-21H53v10.5A10.5 10.5 0 0 0 63.5 100ZM89.5 74a10.5 10.5 0 0 0 0-21h-26a10.5 10.5 0 0 0 0 21Z',
+  }),
+  h('path', {
+    fill: '#E01E5A',
+    d: 'M0 63.5a10.5 10.5 0 0 0 21 0V53H10.5A10.5 10.5 0 0 0 0 63.5ZM26 89.5a10.5 10.5 0 0 0 21 0v-26a10.5 10.5 0 0 0-21 0Z',
   }));
 }
 
@@ -138,7 +151,7 @@ export function IMessageLogoGlyph({ size } = {}) {
     'aria-hidden': 'true', 'data-im-channel-logo': 'imessage',
   }, h('path', {
     fill: 'currentColor',
-    d: 'M12 2.2c-5.52 0-10 3.75-10 8.38 0 2.63 1.52 4.98 3.9 6.52l-.92 3.43a.5.5 0 0 0 .72.56l3.54-1.96c.87.23 1.8.35 2.76.35 5.52 0 10-3.75 10-8.9S17.52 2.2 12 2.2Zm-3.4 8.2a1.2 1.2 0 1 1 0 2.4 1.2 1.2 0 0 1 0-2.4Zm3.4 0a1.2 1.2 0 1 1 0 2.4 1.2 1.2 0 0 1 0-2.4Zm3.4 0a1.2 1.2 0 1 1 0 2.4 1.2 1.2 0 0 1 0-2.4Z',
+    d: 'M12 2.5C5.65 2.5.5 6.66.5 11.8c0 2.76 1.49 5.24 3.85 6.94.28 1.34-.35 2.76-1.6 4.01 2.1-.2 3.87-.86 5.26-1.85 1.25.4 2.6.62 3.99.62 6.35 0 11.5-4.35 11.5-9.72S18.35 2.5 12 2.5Z',
   }));
 }
 

package/plugin-src/client/channels/imessage/styles.js

@@ -1,7 +1,7 @@
 export const IMESSAGE_STYLE_ID = 'xmanrui-dsh-im-imessage-settings';
 const CSS = String.raw`
 .dim-pageIMessage { --ddt-accent: #32a852; --ddt-accent-deep: #248a40; --ddt-accent-wash: #edf9f0; }
-.dim-avatarIMessage { color: #fff; background: #32a852; }
+.dim-avatarIMessage { color: #fff; background: linear-gradient(180deg, #5bf675 0%, #28d944 50%, #0fbd2c 100%); box-shadow: inset 0 1px 1px rgb(255 255 255 / 45%), 0 1px 3px rgb(31 35 41 / 12%); }
 .dim-avatarIMessage svg { display: block; }
 .dim-imessagePermissionPanel { padding: 20px; }
 .dim-imessagePermissionPanel p { color: var(--dsw-alias-label-secondary, #646a73); }

package/plugin-src/client/channels/slack/styles.js

@@ -2,7 +2,7 @@ export const SLACK_STYLE_ID = 'xmanrui-dsh-im-slack-settings';
 
 const CSS = String.raw`
 .dsl-page { --ddt-accent: #4a154b; --ddt-accent-deep: #321033; --ddt-accent-wash: #f7eef7; }
-.dsl-avatar { color: #fff; background: #4a154b; }
+.dsl-avatar { background: linear-gradient(145deg, #fff, #f8fafb); border: 1px solid #e5e6eb; }
 .dsl-avatar svg { display: block; }
 .dsl-setup { display: grid; gap: 18px; }
 .dsl-guide { display: grid; grid-template-columns: minmax(0, 1fr) auto; align-items: start; gap: 18px; padding: 16px; border: 1px solid color-mix(in srgb, #4a154b 18%, var(--dsw-alias-border-l2, #e5e6eb)); border-radius: 11px; background: color-mix(in srgb, #4a154b 4%, var(--dsw-alias-bg-layer-1, #fff)); }

package/plugin-src/client/channels/weixin/connection-error.js

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { h, localizeText } from '../../i18n.js';
 import { normalizeConnectionError } from './api.js';
+import { CONFIG_ISSUE_LABELS } from '../../../../src/channels/weixin/diagnostic-details.mjs';
 
 const STAGE_LABELS = {
   'startup.load': '加载微信配置', 'qr.begin': '申请二维码', 'qr.encode': '生成二维码图片', 'qr.poll': '查询扫码状态',
@@ -27,7 +28,7 @@ export function formatWeixinDiagnostic(value) {
   return [
     localizeText(error.message), details.hint ? localizeText(details.hint) : null,
     localizeText('错误码') + ': ' + error.code,
-    ...['operation', 'stage', 'reason', 'httpStatus', 'providerCode', 'resource', 'referenceId', 'occurredAt', 'rollback', 'pluginVersion']
+    ...['operation', 'stage', 'reason', 'httpStatus', 'providerCode', 'resource', 'file', 'field', 'issue', 'referenceId', 'occurredAt', 'rollback', 'pluginVersion']
       .filter(field => details[field] !== undefined)
       .map(field => `${field}: ${details[field]}`),
   ].filter(Boolean).join('\n');
@@ -48,6 +49,8 @@ export function WeixinConnectionError({ error: value, warning = false }) {
   const fields = [
     ['错误码', error.code], ['失败阶段', localizeText(STAGE_LABELS[details.stage] ?? details.stage ?? '')],
     ['底层原因', details.reason], ['HTTP 状态', details.httpStatus], ['微信返回码', details.providerCode],
+    ['配置文件', details.file], ['配置字段', details.field],
+    ['校验原因', details.issue ? localizeText(CONFIG_ISSUE_LABELS[details.issue]) : undefined],
     ['参考号', details.referenceId], ['发生时间', details.occurredAt], ['插件版本', details.pluginVersion],
   ].filter(([, text]) => text !== undefined && text !== '');
   return h('div', { className: 'dxw-summary dim-cardSummary', 'data-weixin-diagnostic': true, role: warning ? 'status' : undefined },

package/plugin-src/client/i18n.js

@@ -1020,6 +1020,14 @@ function channelName(value) {
 }
 
 function translateDynamic(text) {
+  const configMessage = /^微信配置格式错误：(config\.json|workspaces\.json)。请查看诊断详情，修复后重启 DSH。$/.exec(text);
+  if (configMessage) return EN['微信配置格式错误：{file}。请查看诊断详情，修复后重启 DSH。'].replace('{file}', configMessage[1]);
+  const configHint = /^(.*?)请检查微信渠道数据目录中的 (config\.json|workspaces\.json)，修复后重启 DSH；“重新读取”不会重新加载配置。\s*(字段位置中的序号从 0 开始，按文件中的条目顺序计数，不包含真实账号标识。)?$/.exec(text);
+  if (configHint) return [
+    localizeText(configHint[1].trim()),
+    EN['请检查微信渠道数据目录中的 {file}，修复后重启 DSH；“重新读取”不会重新加载配置。'].replace('{file}', configHint[2]),
+    configHint[3] ? localizeText(configHint[3]) : '',
+  ].filter(Boolean).join(' ');
   const guidanceLimit = /^增强提示词不得超过 (\d+) 个字符。$/.exec(text);
   if (guidanceLimit) return `Guidance must not exceed ${guidanceLimit[1]} characters.`;
   let match = /^(\d+) \/ (\d+) 在线$/.exec(text);

package/plugin-src/client/model-setting.js

@@ -141,6 +141,8 @@ export function ModelEditor({ model = null, disabled = false, onSave }) {
           'aria-label': '查看模型设置说明', 'aria-describedby': `${id}-help` },
         h('span', { 'aria-hidden': true }, '?')),
         h('span', { id: `${id}-help`, className: 'dim-presetTooltip', role: 'tooltip' },
+          effortHint && !effortUnavailable
+            ? h('span', { id: `${id}-hint` }, effortHint, ' ') : null,
           '只影响新建会话；若当前聊天已有会话，先发送 /new，再发送普通消息生效。'))),
     saving ? h('span', { className: 'dim-presetStatus', role: 'status' }, '保存中…') : null),
   row('model', '模型', entry?.name ?? (current ? modelSelectionId(current) : localizeText('跟随默认模型'))),
@@ -163,8 +165,8 @@ export function ModelEditor({ model = null, disabled = false, onSave }) {
     ...(reasoning?.efforts ?? []).map((level) => option(`effort:${level.id}`, level.name, level.description,
       effort === level.id, { ...current, reasoningEffort: level.id })),
   ]) : null,
-  effortHint ? h('p', { id: `${id}-hint`, className: 'dim-modelHint',
-    role: effortUnavailable ? 'status' : undefined }, effortHint) : null,
+  effortHint && effortUnavailable ? h('p', { id: `${id}-hint`, className: 'dim-modelHint',
+    role: 'status' }, effortHint) : null,
   error || !currentAvailable ? h('p', { className: 'dim-presetError', role: error ? 'alert' : 'status' },
     error ?? '当前模型已不可用，请选择其他模型或跟随默认模型。') : null);
 }

package/plugin-src/client/session-channel-logos.js

@@ -26,8 +26,7 @@ const SVG_NS = 'http://www.w3.org/2000/svg';
 const installations = new WeakMap();
 
 function hasClassPart(element, part) {
-  const match = new RegExp(`(?:^|[_-])${part}(?:$|[_-])`, 'u');
-  return [...element.classList].some((token) => match.test(token));
+  return [...element.classList].some((token) => token.split(/[_-]/u).includes(part));
 }
 
 function titleOf(row) {

package/plugin-src/client/styles.js

@@ -126,10 +126,11 @@ const CSS = String.raw`
 .dim-logoOffice svg { width: 23px; height: 23px; }
 .dim-logoDiscord { color: white; background: #5865f2; }
 .dim-logoDiscord svg { width: 21px; height: 21px; }
-.dim-logoSlack { color: white; background: #4a154b; }
+.dim-logoSlack { background: linear-gradient(145deg, #fff, #f8fafb); border: 1px solid #e5e6eb; }
 .dim-logoSlack svg { width: 21px; height: 21px; }
 .dim-logoWhatsapp { color: white; background: #25d366; }
-.dim-logoIMessage { color: white; background: #32a852; }
+.dim-logoIMessage { color: white; background: linear-gradient(180deg, #5bf675 0%, #28d944 50%, #0fbd2c 100%); box-shadow: inset 0 1px 1px rgb(255 255 255 / 45%), 0 1px 3px rgb(31 35 41 / 12%); }
+.dim-logoIMessage svg { width: 23px; height: 23px; }
 .dim-logoWhatsapp svg { width: 21px; height: 21px; }
 .dim-channelCopy { min-width: 0; display: grid; }
 .dim-channelCopy strong { overflow: hidden; color: inherit; font-size: 14px; line-height: 20px; font-weight: 680; text-overflow: ellipsis; white-space: nowrap; }

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

@@ -74,7 +74,7 @@ export async function createProductionController(ctx, config = {}, internals = {
   const stateFor = async (botId) => {
     let state = stateStores.get(botId);
     if (!state) {
-      state = await new StateStore(statePath(botId)).load();
+      state = await new StateStore(statePath(botId), { logger }).load();
       stateStores.set(botId, state);
     }
     return state;

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

@@ -9,6 +9,7 @@ import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from
 import { SET_ACCESS_POLICY_ENDPOINT, validAccessPolicyPayload } from '../shared/access-policy-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
+import { publicQqStateError } from '../../../../src/channels/qq/state-error.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
 import { SET_MODEL_ENDPOINT, validModelPayload } from '../shared/model-setting-rpc.mjs';
 
@@ -232,7 +233,7 @@ export function createQqRpcHandler(controller, { encodeQr = qrDataUrl } = {}) {
       const workspaceError = publicWorkspaceError(error);
       return signal?.aborted
         ? { ok: false, error: { code: 'cancelled', message: 'The request was cancelled.' } }
-        : { ok: false, error: workspaceError
+        : { ok: false, error: publicQqStateError(error) ?? workspaceError
           ?? { code: 'qq-operation-failed', message: 'QQ 操作失败，请稍后重试。' } };
     }
   };

package/plugin-src/host/modern-harness-api.mjs

@@ -474,13 +474,97 @@ class ModernHarnessApi {
   #requestQuestion(request, next) {
     const owner = this.#claimableAgent(request?.agent);
     if (!owner) return next();
-    if (request.signal?.aborted) {
+    const turnSignal = request.signal;
+    if (turnSignal?.aborted) {
       return Promise.reject(questionError(
         'ask_user_question was aborted before the user answered', 'ASK_ABORTED',
       ));
     }
-    return new Promise((resolve, reject) => {
-      const pending = {
+    // Give this question a lifetime of its own instead of lending it the enclosing
+    // turn's. `dsh-agent-loop` mints one abort controller per turn and every tool
+    // call in that turn shares the one signal, and under PTC two consumers of it
+    // react to the abort EVENT rather than to `signal.aborted`: `run_code` flips its
+    // own program controller from an abort listener (dsh-tools `onOuterAbort`) and
+    // the worker code runtime retires the worker the same way
+    // (dsh-code-runtime-worker-thread `onAbort`). Retiring the Web card by firing
+    // that event therefore also killed the program that was merely waiting for this
+    // answer — `code run failed (abort)`. A private controller keeps the retirement
+    // below local: real upstream cancellation is forwarded into it, and every
+    // listener on this waterfall — the Remote/Web forwarder that renders the card,
+    // and our own IM pending — sees a lifetime that ends with this question rather
+    // than with the turn.
+    //
+    // Handing it downstream means replacing `request.signal`, because the Cordis
+    // waterfall passes the same request object to every remaining listener and
+    // `next()` takes no replacement arguments. The object is a per-call copy made by
+    // `UserQuestionService.ask`, and the signal it carried stays reachable here as
+    // `turnSignal`, so the caller's own view of the request is untouched.
+    const question = new AbortController();
+    const forwardTurnAbort = () => question.abort(turnSignal?.reason);
+    turnSignal?.addEventListener('abort', forwardTurnAbort, { once: true });
+    request.signal = question.signal;
+    // Race the IM answer against the host's own answerers (Web/CLI). Claiming the
+    // request exclusively used to keep the question out of Web entirely, leaving
+    // whoever happened to be looking at that Session with a card they could not
+    // answer. Racing keeps both surfaces usable: the first answer wins.
+    const im = this.#askThroughIm(request, owner);
+    let answeredByIm = false;
+    const native = Promise.resolve()
+      .then(() => next())
+      .catch((error) => {
+        // A pure-IM session has no client connected, so the host rejects with
+        // NO_PROVIDER — an expected state rather than a failure — and ASK_ABORTED
+        // is this adapter's own retire signal below. Any other error is real, so
+        // log it instead of swallowing it silently; the question still stays open
+        // for IM rather than being failed outright.
+        if (error?.code !== 'NO_PROVIDER' && error?.code !== 'ASK_ABORTED') {
+          console.warn(
+            '[dsh-im] the host user-question answerer failed; waiting for the IM answer:',
+            error?.message ?? error,
+          );
+        }
+        return new Promise(() => {});
+      });
+    return Promise.race([
+      native,
+      im.promise.then((value) => {
+        answeredByIm = true;
+        return value;
+      }),
+    ]).finally(() => {
+      // Losing side cleanup. A host answer already settled this request, so drop
+      // the IM pending: leaving it registered would let a late press answer a
+      // question the model has moved past. Settling is idempotent.
+      im.dismiss(new Error('another client answered this question'));
+      turnSignal?.removeEventListener('abort', forwardTurnAbort);
+      if (answeredByIm) {
+        // The host's own answerer (DSH Web) keeps its question card until its own
+        // pending settles, and a host-side adapter has no other handle on it. A Web
+        // client holds that pending through the lifetime this question handed
+        // downstream, so ending that lifetime makes the client drop a card whose
+        // answer was already given on IM — otherwise it keeps offering choices for a
+        // question the model has moved past.
+        //
+        // Ending it is `abort`, not a dispatched `abort` event: a listener that
+        // reads `signal.aborted` must see the same thing one that listens for the
+        // event does. Either way it reaches only this question's controller, so the
+        // turn and every other tool call in it — a waiting `run_code` program above
+        // all — keep running. The reason carries `ASK_ABORTED` so the host answerer
+        // rejecting alongside us stays an expected retirement rather than a logged
+        // failure.
+        question.abort(questionError('the question was answered on IM', 'ASK_ABORTED'));
+      }
+    });
+  }
+
+  /**
+   * Present one question to IM clients. Returns the answer promise plus a
+   * `dismiss` used to retire the pending when the host answers first.
+   */
+  #askThroughIm(request, owner) {
+    let pending = null;
+    const promise = new Promise((resolve, reject) => {
+      pending = {
         rpcId: randomUUID(),
         sessionId: owner.sessionId,
         questions: request.questions,
@@ -505,6 +589,10 @@ class ModernHarnessApi {
       request.signal?.addEventListener('abort', onAbort, { once: true });
       this.#broadcast(this.#questionFrame(pending).payload, pending.rpcId);
     });
+    return {
+      promise,
+      dismiss: (reason) => pending?.settle('cancelled', reason),
+    };
   }
 
   #approvalFrame(pending) {

package/scripts/verify-model-setting.mjs

@@ -22,12 +22,15 @@ const built = await build({
   define: { 'process.env.NODE_ENV': '"development"' },
 });
 const htmlPath = join(output, 'preview.html');
+const scriptOpen = '<scr' + 'ipt>';
+const scriptClose = '</scr' + 'ipt>';
+const scriptBody = built.outputFiles[0].text.replace(/<\/script/giu, '<\\/script');
 await writeFile(htmlPath, `<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>DSH-IM Model Settings</title>
 <style>
 body{margin:0;padding:24px;background:#fff;color:#1f2329;font:14px/20px -apple-system,BlinkMacSystemFont,sans-serif}#app{max-width:760px;margin:auto}#result{max-width:760px;margin:18px auto;font:11px/17px monospace;white-space:pre-wrap;color:#687380}
 @media(max-width:600px){body{padding:12px}}
 @media(prefers-color-scheme:dark){:root{color-scheme:dark;--dsw-alias-bg-layer-1:#202125;--dsw-alias-bg-layer-3:#282a30;--dsw-specific-menu:#282a30;--dsw-alias-bg-module-platform:#25272c;--dsw-alias-label-primary:#e9ebef;--dsw-alias-label-secondary:#b1b5bf;--dsw-alias-label-tertiary:#9a9faa;--dsw-alias-border-l1:#34363c;--dsw-alias-border-l2:#41434c;--dsw-alias-border-l3:#7b9ff9;--dsw-alias-interactive-bg-hover:#353842}body{background:#202125;color:#e9ebef}}
-</style><body><div id="app"></div><pre id="result">Running browser checks…</pre><script>${built.outputFiles[0].text.replace(/<\/script/giu, '<\\/script')}</script></body></html>`);
+</style><body><div id="app"></div><pre id="result">Running browser checks…</pre>${scriptOpen}${scriptBody}${scriptClose}</body></html>`);
 for (const [name, size, extra, query] of [
   ['desktop', '1100,1100', [], ''],
   ['mobile', '390,1250', [], '?mobile'],

package/scripts/verify-package.mjs

@@ -238,7 +238,9 @@ if (/(?:from\s*|import\s*\(|require\s*\()\s*["'](?:@larksuiteoapi\/node-sdk|@whi
 if (!/(?:from\s*|import\s*\()\s*["']undici["']/.test(host)) {
   throw new Error('host bundle must retain undici as an external runtime dependency');
 }
-if ((executable.mode & 0o111) === 0) throw new Error('dsh-im CLI is not executable');
+if (process.platform !== 'win32' && (executable.mode & 0o111) === 0) {
+  throw new Error('dsh-im CLI is not executable');
+}
 if (/private-bot-token|must-be-rolled-back|DEEPSEEK_API_KEY=/.test(client + host)) {
   throw new Error('built artifacts contain a test or environment secret marker');
 }

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

@@ -1299,6 +1299,7 @@ export class DingtalkHarnessBridge {
         key,
         text,
         content,
+        titleText: batchSubmission?.title,
         contextEnhanced,
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },

package/src/channels/discord/discord-runtime.mjs

@@ -66,7 +66,10 @@ function gatewayCloseError(code) {
 
 function stripBotMention(text, botId) {
   if (typeof text !== 'string') return '';
-  return text.replace(new RegExp(`<@!?${botId}>`, 'g'), '').trim();
+  return text
+    .split(`<@${botId}>`).join('')
+    .split(`<@!${botId}>`).join('')
+    .trim();
 }
 
 function cleanThreadName(message, botId) {

package/src/channels/feishu/bridge.mjs

@@ -1037,12 +1037,16 @@ export class FeishuHarnessBridge {
         if (result.kind === 'submit') {
           const submissionEvent = {
             ...event,
-            batchSubmission: { token: result.token },
+            batchSubmission: { token: result.token, title: result.title },
             message: {
               ...event.message,
               message_type: 'text',
               content: JSON.stringify({ text: result.prompt }),
               mentions: [],
+              // The submission is exactly the collected text, so quoting the
+              // message that carried /send must not attach it to the batch.
+              parent_id: undefined,
+              root_id: undefined,
             },
           };
           return this.#enqueueMessage(
@@ -4959,6 +4963,7 @@ export class FeishuHarnessBridge {
       key,
       text,
       content,
+      titleText: event.batchSubmission?.title,
       contextEnhanced,
       createOptions: { signal: this.#signal },
       existsOptions: { signal: this.#signal },
@@ -5201,6 +5206,7 @@ export class FeishuHarnessBridge {
         key,
         text,
         content,
+        titleText: event.batchSubmission?.title,
         contextEnhanced,
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },
@@ -5280,6 +5286,7 @@ export class FeishuHarnessBridge {
             key,
             text,
             content,
+            titleText: event.batchSubmission?.title,
             contextEnhanced,
             createOptions: { signal: this.#signal },
             existsOptions: { signal: this.#signal },
@@ -5350,6 +5357,7 @@ export class FeishuHarnessBridge {
         key,
         text,
         content,
+        titleText: event.batchSubmission?.title,
         contextEnhanced,
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },

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

@@ -576,7 +576,7 @@ export class VerifiedFeishuChannel {
       assertApiSuccess('Feishu message delete', response);
       return true;
     } catch (error) {
-      console.warn(`[bridge] unable to recall ${label}:`, error.message);
+      console.warn('[bridge] unable to recall message:', label, error.message);
       return false;
     }
   }

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

@@ -570,7 +570,14 @@ export class QqHarnessBridge {
       if (result.handled) {
         if (result.kind === 'submit') {
           return this.#enqueueMessage(
-            { ...message, content: result.prompt, attachments: [] },
+            {
+              ...message,
+              content: result.prompt,
+              // The submission is exactly the collected text: the command
+              // message's own attachments and quoted message are not part of it.
+              attachments: [],
+              refMsgIdx: undefined,
+            },
             messageId,
             key,
             { batchSubmission: result },
@@ -1038,6 +1045,7 @@ export class QqHarnessBridge {
           key,
           text,
           content,
+          titleText: batchSubmission?.title,
           contextEnhanced,
           createOptions: { signal: this.#signal },
           existsOptions: { signal: this.#signal },

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

@@ -4,6 +4,7 @@ import { connectionTestMessage } from '../shared/connection-test.mjs';
 import { t } from '../shared/i18n.mjs';
 import { publicMessageFailure } from '../shared/message-failure.mjs';
 import { deriveQqBotIdentity, maskQqAppId } from './config-store.mjs';
+import { publicQqStateError } from './state-error.mjs';
 
 const ACTIVE_ATTEMPT_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting']);
 const TERMINAL_ATTEMPT_STATES = new Set(['connected', 'failed', 'cancelled']);
@@ -17,6 +18,10 @@ function safeError(code, message) {
   return Object.freeze({ code, message });
 }
 
+function connectionError(error, message) {
+  return publicQqStateError(error) ?? safeError('connection-failed', message);
+}
+
 function publicAttempt(record) {
   if (!record) return null;
   return {
@@ -86,7 +91,7 @@ export class QqController {
           await this.#startRuntime(config, appSecret);
           this.#errors.delete(config.botId);
         } catch (error) {
-          this.#errors.set(config.botId, safeError('connection-failed', t('QQ 连接未就绪，插件会自动重试。')));
+          this.#errors.set(config.botId, connectionError(error, t('QQ 连接未就绪，插件会自动重试。')));
           this.#logger.warn?.(`[dsh-im:qq] bot ${config.botId} failed to initialize:`, error);
         } finally {
           this.#touch();
@@ -209,7 +214,7 @@ export class QqController {
         await this.#startRuntime(config, normalizedSecret);
         this.#errors.delete(identity.botId);
       } catch (error) {
-        this.#errors.set(identity.botId, safeError('connection-failed', t('QQ 机器人已绑定，消息连接暂未就绪。')));
+        this.#errors.set(identity.botId, connectionError(error, t('QQ 机器人已绑定，消息连接暂未就绪。')));
         this.#logger.warn?.(`[dsh-im:qq] bot ${identity.botId} credential connection failed:`, error);
       }
       this.#touch();
@@ -242,7 +247,7 @@ export class QqController {
         await this.#startRuntime(config, secret);
         this.#errors.delete(botId);
       } catch (error) {
-        this.#errors.set(botId, safeError('connection-failed', t('QQ 连接仍未就绪，请稍后重试。')));
+        this.#errors.set(botId, connectionError(error, t('QQ 连接仍未就绪，请稍后重试。')));
         throw error;
       } finally {
         this.#touch();
@@ -326,7 +331,8 @@ export class QqController {
         health: {
           status: connected ? 'healthy' : state === 'error' ? 'error' : 'offline',
           summary: connected ? t('QQ WebSocket 长连接运行正常')
-            : state === 'error' ? t('QQ 连接未就绪，插件会自动重试') : t('QQ 连接当前离线'),
+            : this.#errors.get(config.botId)?.message
+              ?? (state === 'error' ? t('QQ 连接未就绪，插件会自动重试') : t('QQ 连接当前离线')),
           lastCheckedAt: runtimeStatus?.lastCheckedAt ?? null,
           lastConnectedAt: runtimeStatus?.lastConnectedAt ?? null,
         },
@@ -434,7 +440,7 @@ export class QqController {
           await this.#restoreCredential(identity.secretRef, previousSecret);
           throw error;
         }
-        this.#errors.set(identity.botId, safeError('connection-failed', t('QQ 机器人已绑定，消息连接暂未就绪。')));
+        this.#errors.set(identity.botId, connectionError(error, t('QQ 机器人已绑定，消息连接暂未就绪。')));
         this.#logger.warn?.(`[dsh-im:qq] bot ${identity.botId} activation connection failed:`, error);
       }
       this.#touch();

package/src/channels/qq/state-error.mjs

@@ -0,0 +1,17 @@
+import { t } from '../shared/i18n.mjs';
+
+const MESSAGES = Object.freeze({
+  'state-read-failed': '无法读取 QQ 本地状态，请检查数据目录及访问权限。',
+  'state-backup-failed': 'QQ 本地状态已损坏，但无法备份，原文件已保留。',
+  'state-write-failed': '无法保存 QQ 本地状态，请检查磁盘空间及目录写入权限。',
+});
+
+export function qqStateError(code, cause) {
+  return Object.assign(new Error('QQ state operation failed', { cause }), { code });
+}
+
+export function publicQqStateError(error) {
+  return Object.hasOwn(MESSAGES, error?.code ?? '')
+    ? { code: error.code, message: t(MESSAGES[error.code]) }
+    : null;
+}

package/src/channels/qq/state-store.mjs

@@ -1,6 +1,8 @@
 import { deferredStateAccess, normalizeDeferredState } from '../shared/deferred-state.mjs';
-import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs/promises';
 import { dirname } from 'node:path';
+import { qqStateError } from './state-error.mjs';
 
 const EMPTY_STATE = Object.freeze({ version: 1, sessions: {}, seenMessageIds: [] });
 
@@ -27,22 +29,46 @@ function normalizeState(value) {
 
 export class QqStateStore {
   #path;
+  #logger;
   #state = structuredClone(EMPTY_STATE);
   #writeQueue = Promise.resolve();
   #deferred = deferredStateAccess(() => this.#state, () => this.#persist());
 
-  constructor(path) {
+  constructor(path, { logger = console } = {}) {
     this.#path = path;
+    this.#logger = logger;
   }
 
   async load() {
+    let bytes;
     try {
-      this.#state = normalizeState(JSON.parse(await readFile(this.#path, 'utf8')));
+      bytes = await fs.readFile(this.#path);
     } catch (error) {
-      if (error?.code !== 'ENOENT') throw error;
+      if (error?.code !== 'ENOENT') throw qqStateError('state-read-failed', error);
+      this.#state = structuredClone(EMPTY_STATE);
+      await this.#persist();
+      return this;
+    }
+
+    let parsed;
+    try {
+      parsed = JSON.parse(bytes.toString('utf8'));
+    } catch (error) {
+      if (!(error instanceof SyntaxError)) throw error;
+      const backup = `${this.#path}.corrupt-${Date.now()}-${randomUUID()}`;
+      try {
+        // Copy the exact bytes before replacing anything. A failed rebuild
+        // leaves both the original and this exclusive backup available.
+        await fs.writeFile(backup, bytes, { flag: 'wx', mode: 0o600 });
+      } catch (cause) {
+        throw qqStateError('state-backup-failed', cause);
+      }
       this.#state = structuredClone(EMPTY_STATE);
       await this.#persist();
+      this.#logger.warn?.(`[dsh-im:qq] state-recovered: ${this.#path}; backup: ${backup}; conversation mappings, message deduplication and deferred deliveries have been reset.`);
+      return this;
     }
+    this.#state = normalizeState(parsed);
     return this;
   }
 
@@ -96,7 +122,7 @@ export class QqStateStore {
 
   async remove() {
     try {
-      await unlink(this.#path);
+      await fs.unlink(this.#path);
     } catch (error) {
       if (error?.code !== 'ENOENT') throw error;
     }
@@ -106,12 +132,12 @@ export class QqStateStore {
   async #persist() {
     const snapshot = `${JSON.stringify(this.#state, null, 2)}\n`;
     const operation = this.#writeQueue.then(async () => {
-      await mkdir(dirname(this.#path), { recursive: true, mode: 0o700 });
+      await fs.mkdir(dirname(this.#path), { recursive: true, mode: 0o700 });
       const temporary = `${this.#path}.tmp`;
-      await writeFile(temporary, snapshot, { encoding: 'utf8', mode: 0o600 });
-      await rename(temporary, this.#path);
+      await fs.writeFile(temporary, snapshot, { encoding: 'utf8', mode: 0o600 });
+      await fs.rename(temporary, this.#path);
     });
     this.#writeQueue = operation.then(() => undefined, () => undefined);
-    await operation;
+    await operation.catch(error => { throw qqStateError('state-write-failed', error); });
   }
 }