@xmanrui/dsh-im 4.19.1 → 4.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.19.1",
+  "version": "4.20.0",
   "description": "把十一种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect eleven IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
@@ -52,6 +52,18 @@
     {
       "name": "geekyfoxlab",
       "url": "https://github.com/geekyfoxlab"
+    },
+    {
+      "name": "grloper",
+      "url": "https://github.com/grloper"
+    },
+    {
+      "name": "baijian",
+      "url": "https://github.com/baijian"
+    },
+    {
+      "name": "lyzhu86",
+      "url": "https://github.com/lyzhu86"
     }
   ],
   "license": "MIT",

package/plugin-src/client/channels/weixin/api.js

@@ -1,3 +1,4 @@
+import { normalizeWeixinDiagnosticDetails } from '../../../../src/channels/weixin/diagnostic-details.mjs';
 import { normalizeBotAlias } from '../../../../src/channels/shared/bot-alias.mjs';
 import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
 import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
@@ -57,13 +58,38 @@ function normalizeTestMessage(value) {
   return { sent: false, code };
 }
 
+export function normalizeConnectionError(value, fallbackCode = 'WEIXIN_ERROR', fallbackMessage = '微信操作失败，请稍后重试') {
+  const details = normalizeWeixinDiagnosticDetails(value?.details);
+  return {
+    code: string(value?.code, fallbackCode).slice(0, 100),
+    message: string(value?.message, fallbackMessage).slice(0, 500),
+    ...(Object.keys(details).length ? { details } : {}),
+  };
+}
+
+export function managementRequestError(cause, operation) {
+  if (cause?.name === 'AbortError') return cause;
+  const error = new Error('无法完成微信管理请求，请检查 DSH 连接后重新读取状态。');
+  error.code = 'weixin-management-unreachable';
+  error.details = normalizeWeixinDiagnosticDetails({ operation, stage: 'management.request', occurredAt: new Date().toISOString() });
+  return error;
+}
+
+function invalidResponse() {
+  const error = new Error('DSH 微信管理接口返回了无法识别的响应，请重新读取状态。');
+  error.code = 'weixin-management-invalid-response';
+  error.details = { stage: 'management.request', occurredAt: new Date().toISOString() };
+  return error;
+}
+
 export function unwrapRpcResult(result) {
   if (!isRecord(result) || typeof result.ok !== 'boolean') {
-    throw new Error('微信服务返回了无法识别的响应');
+    throw invalidResponse();
   }
   if (!result.ok) {
-    const error = new Error(string(result.error?.message, '微信操作失败'));
-    error.code = string(result.error?.code, 'WEIXIN_RPC_ERROR');
+    if (!isRecord(result.error)) throw invalidResponse();
+    const visible = normalizeConnectionError(result.error, 'WEIXIN_RPC_ERROR', '微信操作失败');
+    const error = Object.assign(new Error(visible.message), visible);
     throw error;
   }
   return result.value;
@@ -93,7 +119,7 @@ export function safeVerificationUrl(value) {
 
 export function normalizeProvisioning(value) {
   if (!isRecord(value) || !string(value.attemptId)) {
-    throw new Error('微信扫码服务没有返回有效的绑定任务');
+    throw invalidResponse();
   }
   const status = PROVISION_STATES.has(value.status) ? value.status : 'failed';
   const result = {
@@ -110,10 +136,7 @@ export function normalizeProvisioning(value) {
   if (string(value.botId)) result.botId = string(value.botId);
   if (value.alreadyConnected === true) result.alreadyConnected = true;
   if (isRecord(value.error)) {
-    result.error = {
-      code: string(value.error.code, 'WEIXIN_PROVISION_FAILED'),
-      message: string(value.error.message, '微信绑定没有完成'),
-    };
+    result.error = normalizeConnectionError(value.error, 'WEIXIN_PROVISION_FAILED', '微信绑定没有完成');
   }
   return result;
 }
@@ -150,17 +173,14 @@ function normalizeBot(value) {
     },
     lastMessageError: normalizeLastMessageError(value.lastMessageError),
     error: isRecord(value.error)
-      ? {
-          code: string(value.error.code, 'WEIXIN_ACCOUNT_ERROR'),
-          message: string(value.error.message, '微信连接未就绪'),
-        }
+      ? normalizeConnectionError(value.error, 'WEIXIN_ACCOUNT_ERROR', '微信连接未就绪')
       : null,
   };
 }
 
 export function normalizeSnapshot(value) {
   if (!isRecord(value) || !Array.isArray(value.bots)) {
-    throw new Error('微信服务没有返回有效的账号列表');
+    throw invalidResponse();
   }
   const bots = value.bots.map(normalizeBot).filter(Boolean);
   return {
@@ -174,16 +194,14 @@ export function normalizeSnapshot(value) {
     },
     provisioning: value.provisioning ? normalizeProvisioning(value.provisioning) : null,
     testMessage: normalizeTestMessage(value.testMessage),
+    warnings: Array.isArray(value.warnings) ? value.warnings.filter(isRecord).slice(0, 8).map(error => normalizeConnectionError(error)) : [],
     agentPresetCatalog: normalizeAgentPresetCatalog(value.agentPresetCatalog),
     modelCatalog: normalizeModelCatalog(value.modelCatalog),
   };
 }
 
 export function presentError(error) {
-  return {
-    code: string(error?.code, 'WEIXIN_ERROR'),
-    message: string(error?.message, '微信操作失败，请稍后重试'),
-  };
+  return normalizeConnectionError(error);
 }
 
 export function formatRemaining(milliseconds) {

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

@@ -0,0 +1,68 @@
+import * as React from 'react';
+import { h, localizeText } from '../../i18n.js';
+import { normalizeConnectionError } from './api.js';
+
+const STAGE_LABELS = {
+  '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': '检查 DSH 宿主', 'connection.start': '启动微信连接',
+  'connection.poll': '同步微信消息', 'connection.stop': '停止微信连接', 'status.read': '读取连接状态',
+  rollback: '恢复原账号状态', 'management.request': '访问 DSH 管理接口',
+};
+
+export function provisioningErrorTitle(error) {
+  const stage = error?.details?.stage;
+  if (stage === 'qr.begin' || stage === 'qr.encode') return '无法生成微信二维码';
+  if (stage === 'qr.poll') return '查询微信扫码状态失败';
+  if (stage === 'management.request') return '无法完成微信管理请求';
+  return '微信没有绑定完成';
+}
+
+export function formatWeixinDiagnostic(value) {
+  const error = normalizeConnectionError(value);
+  const details = error.details ?? {};
+  return [
+    localizeText(error.message), details.hint ? localizeText(details.hint) : null,
+    localizeText('错误码') + ': ' + error.code,
+    ...['operation', 'stage', 'reason', 'httpStatus', 'providerCode', 'resource', 'referenceId', 'occurredAt', 'rollback', 'pluginVersion']
+      .filter(field => details[field] !== undefined)
+      .map(field => `${field}: ${details[field]}`),
+  ].filter(Boolean).join('\n');
+}
+
+export function WeixinConnectionError({ error: value, warning = false }) {
+  const error = normalizeConnectionError(value);
+  const details = error.details ?? {};
+  const [copyState, setCopyState] = React.useState(null);
+  React.useEffect(() => setCopyState(null), [details.referenceId, error.code, error.message]);
+  const copy = async () => {
+    try {
+      if (typeof globalThis.navigator?.clipboard?.writeText !== 'function') throw new Error('clipboard unavailable');
+      await globalThis.navigator.clipboard.writeText(formatWeixinDiagnostic(error));
+      setCopyState('copied');
+    } catch { setCopyState('manual'); }
+  };
+  const fields = [
+    ['错误码', error.code], ['失败阶段', localizeText(STAGE_LABELS[details.stage] ?? details.stage ?? '')],
+    ['底层原因', details.reason], ['HTTP 状态', details.httpStatus], ['微信返回码', details.providerCode],
+    ['参考号', 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 },
+    h('p', null, error.message),
+    details.hint ? h('p', null, details.hint) : null,
+    h('details', { style: { marginTop: 8 } },
+      h('summary', { style: { cursor: 'pointer' } }, '诊断详情'),
+      h('dl', { style: { display: 'grid', gridTemplateColumns: 'auto minmax(0, 1fr)', gap: '4px 12px', margin: '10px 0' } },
+        ...fields.flatMap(([label, text]) => [h('dt', { key: `${label}-label` }, label),
+          React.createElement('dd', { key: label, style: { margin: 0, overflowWrap: 'anywhere' } }, String(text))])),
+      !details.referenceId ? h('p', null, '未取得 Host 诊断参考号。') : null,
+      h('div', { className: 'dim-viewActions' },
+        h('button', { type: 'button', className: 'dxw-button', onClick: copy }, copyState === 'copied' ? '诊断信息已复制' : '复制诊断信息')),
+      copyState === 'manual' ? h('div', null,
+        h('p', null, '无法访问剪贴板，请选择并复制以下诊断信息。'),
+        React.createElement('textarea', { readOnly: true, value: formatWeixinDiagnostic(error), rows: 7,
+          'aria-label': localizeText('诊断信息'), style: { width: '100%', boxSizing: 'border-box', marginTop: 8 } })) : null));
+}

package/plugin-src/client/channels/weixin/index.js

@@ -1,3 +1,4 @@
+import { WeixinConnectionError, provisioningErrorTitle } from './connection-error.js';
 import { BotName } from '../../bot-alias.js';
 import * as React from 'react';
 
@@ -7,6 +8,7 @@ import { CollapsibleAccountSection } from '../shared/collapsible-account.js';
 import { h } from '../../i18n.js';
 import {
   WEIXIN_ENDPOINTS,
+  managementRequestError,
   formatRemaining,
   normalizeProvisioning,
   normalizeSnapshot,
@@ -189,9 +191,8 @@ function ProvisionError({ provision, busy, onRetry, onClose }) {
   const error = provision.error ?? { code: 'WEIXIN_PROVISION_FAILED', message: '微信绑定没有完成' };
   return h('div', { className: 'dxw-card dim-surfaceCard' },
     h('div', { className: 'dxw-error dim-inlineError', role: 'alert' },
-      h('h3', null, provision.status === 'expired' ? '二维码已过期' : '微信没有绑定完成'),
-      h('p', null, error.message),
-      h('span', { className: 'dxw-errorCode' }, error.code),
+      h('h3', null, provision.status === 'expired' ? '二维码已过期' : provisioningErrorTitle(error)),
+      h(WeixinConnectionError, { error }),
       h('div', { className: 'dxw-actions dim-viewActions' },
         h(Button, { kind: 'primary', onClick: onRetry, disabled: busy }, '重新生成二维码'),
         h(Button, { onClick: onClose, disabled: busy }, '关闭'))));
@@ -283,7 +284,8 @@ export function AccountCard({
             h(Button, { className: 'dim-cardAction', onClick: onReconnect, disabled: Boolean(busy) },
               busy === 'reconnect' ? '检查中…' : account.connected ? '检查连接' : '重试连接'),
             h(Button, { className: 'dim-cardAction', kind: 'danger', onClick: onRequestRemove, disabled: Boolean(busy) }, '移除接入')),
-          summary ? h('div', { className: 'dxw-summary dim-cardSummary' }, summary) : null,
+          account.error ? h(WeixinConnectionError, { error: account.error })
+            : summary ? h('div', { className: 'dxw-summary dim-cardSummary' }, summary) : null,
           account.lastMessageError ? h(LastMessageErrorSummary, {
             className: 'dxw-summary',
             error: account.lastMessageError,
@@ -292,7 +294,7 @@ export function AccountCard({
             className: 'dxw-summary dim-cardFeedback',
             role: 'status',
             'aria-live': 'polite',
-          }, feedback) : null)),
+          }, typeof feedback === 'string' ? feedback : h(WeixinConnectionError, { error: feedback })) : null)),
       ),
     ),
     removing ? h('div', { className: 'dxw-confirm dim-confirm', role: 'alertdialog' },
@@ -358,6 +360,7 @@ export function WeixinSettingsTab({ rpcCall }) {
   const [feedbackByBot, setFeedbackByBot] = React.useState({});
   const [removeTarget, setRemoveTarget] = React.useState(null);
   const [notice, setNotice] = React.useState('');
+  const [operationWarnings, setOperationWarnings] = React.useState([]);
   const [now, setNow] = React.useState(() => Date.now());
   const addButtonRef = React.useRef(null);
   const mountedRef = React.useRef(true);
@@ -376,7 +379,13 @@ export function WeixinSettingsTab({ rpcCall }) {
     }, 'announcement');
   }, [scheduleAnimationFrame]);
   const invoke = React.useCallback(async (endpoint, payload = {}, signal) => {
-    return unwrapRpcResult(await rpcCall(endpoint, payload, signal));
+    let result;
+    try { result = await rpcCall(endpoint, payload, signal); }
+    catch (error) {
+      if (signal?.aborted) throw error;
+      throw managementRequestError(error, endpoint);
+    }
+    return unwrapRpcResult(result);
   }, [rpcCall]);
   const loadStatus = React.useCallback(async ({
     signal,
@@ -606,12 +615,12 @@ export function WeixinSettingsTab({ rpcCall }) {
         setFeedbackByBot((current) => ({ ...current, [account.botId]: feedback }));
       }
       announce(feedback);
-    } catch {
-      const feedback = '连接检查失败，请稍后重试。';
+    } catch (error) {
+      const feedback = presentError(error);
       if (mountedRef.current) {
         setFeedbackByBot((current) => ({ ...current, [account.botId]: feedback }));
       }
-      announce(feedback);
+      announce(feedback.message);
     } finally {
       const shouldRefresh = workspaceFence.endMutation();
       if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
@@ -622,6 +631,7 @@ export function WeixinSettingsTab({ rpcCall }) {
   const saveWorkspace = React.useCallback(async (account, workspace) => {
     const workspaceVersion = workspaceFence.beginMutation();
     setBotBusy(account.botId, 'workspace');
+    setFeedbackByBot(current => ({ ...current, [account.botId]: null }));
     try {
       const snapshot = normalizeSnapshot(await invoke(
         WEIXIN_ENDPOINTS.setWorkspace,
@@ -635,6 +645,9 @@ export function WeixinSettingsTab({ rpcCall }) {
           modelCatalog: snapshot.modelCatalog ?? EMPTY_MODEL_CATALOG,
         });
       }
+    } catch (error) {
+      if (mountedRef.current) setFeedbackByBot(current => ({ ...current, [account.botId]: presentError(error) }));
+      throw error;
     } finally {
       const shouldRefresh = workspaceFence.endMutation();
       if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
@@ -645,6 +658,7 @@ export function WeixinSettingsTab({ rpcCall }) {
   const saveBotSetting = React.useCallback(async (account, operation, endpoint, payload) => {
     const snapshotVersion = workspaceFence.beginMutation();
     setBotBusy(account.botId, operation);
+    setFeedbackByBot(current => ({ ...current, [account.botId]: null }));
     try {
       const snapshot = normalizeSnapshot(await invoke(
         endpoint,
@@ -658,6 +672,9 @@ export function WeixinSettingsTab({ rpcCall }) {
           modelCatalog: snapshot.modelCatalog ?? EMPTY_MODEL_CATALOG,
         });
       }
+    } catch (error) {
+      if (mountedRef.current) setFeedbackByBot(current => ({ ...current, [account.botId]: presentError(error) }));
+      throw error;
     } finally {
       const shouldRefresh = workspaceFence.endMutation();
       if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
@@ -668,6 +685,8 @@ export function WeixinSettingsTab({ rpcCall }) {
   const remove = React.useCallback(async (account) => {
     const snapshotVersion = workspaceFence.beginMutation();
     setBotBusy(account.botId, 'delete');
+    setOperationWarnings([]);
+    setFeedbackByBot(current => ({ ...current, [account.botId]: null }));
     try {
       const snapshot = normalizeSnapshot(await invoke(WEIXIN_ENDPOINTS.deleteBot, {
         botId: account.botId,
@@ -680,10 +699,13 @@ export function WeixinSettingsTab({ rpcCall }) {
           modelCatalog: snapshot.modelCatalog ?? current.modelCatalog,
         }));
       }
+      setOperationWarnings(snapshot.warnings);
       setRemoveTarget(null);
       announce('微信账号及本机凭据已移除。');
     } catch (error) {
-      announce(`移除失败：${presentError(error).message}`);
+      const failure = presentError(error);
+      if (mountedRef.current) setFeedbackByBot(current => ({ ...current, [account.botId]: failure }));
+      announce(failure.message);
     } finally {
       const shouldRefresh = workspaceFence.endMutation();
       if (shouldRefresh && mountedRef.current) void loadStatus({ silent: true });
@@ -731,8 +753,10 @@ export function WeixinSettingsTab({ rpcCall }) {
       addButtonRef,
     }),
     h('div', { className: 'dxw-visuallyHidden', role: 'status', 'aria-live': 'polite' }, notice),
+    ...operationWarnings.map((error, index) => h(WeixinConnectionError, { key: error.details?.referenceId ?? index, error, warning: true })),
     model.error && model.phase === 'ready'
-      ? h('div', { className: 'dxw-statusNotice dim-statusNotice' }, `状态刷新失败：${model.error.message}`)
+      ? h('div', { className: 'dxw-statusNotice dim-statusNotice' },
+          h('p', null, '状态读取失败，以下是上次读取的状态。'), h(WeixinConnectionError, { error: model.error }))
       : null,
     model.phase === 'loading'
       ? h(LoadingView)
@@ -740,7 +764,7 @@ export function WeixinSettingsTab({ rpcCall }) {
         ? h('div', { className: 'dxw-card dim-surfaceCard' },
             h('div', { className: 'dxw-error dim-inlineError' },
               h('h3', null, '无法读取微信状态'),
-              h('p', null, model.error?.message ?? '请稍后重试'),
+              h(WeixinConnectionError, { error: model.error }),
               h(Button, { onClick: () => void loadStatus() }, '重新读取')))
         : h(React.Fragment, null,
             provisionView,

package/plugin-src/client/i18n.js

@@ -1,8 +1,10 @@
+import weixinDiagnostics from '../../src/channels/weixin/connection-error.en.mjs';
 import * as React from 'react';
 
 export const IM_LOCALE_NAMESPACE = 'dsh-im';
 
 const EN = Object.freeze({
+  ...weixinDiagnostics,
   '$locale': 'en',
   '修改别名': 'Edit alias',
   '关闭修改别名': 'Close alias editor',

package/plugin-src/client/index.js

@@ -51,6 +51,10 @@ import { IMESSAGE_RPC_CHANNEL } from './channels/imessage/api.js';
 import { IMessageSettingsTab } from './channels/imessage/index.js';
 import { installIMessageStyles } from './channels/imessage/styles.js';
 import { en, h, IM_LOCALE_NAMESPACE, setImTranslator, zh } from './i18n.js';
+import {
+  HOST_LANGUAGE_RPC_CHANNEL,
+  installInterfaceLanguageMirror,
+} from './interface-language.js';
 import { BotSettingsContext } from './channel-card-meta.js';
 import {
   DELIVERY_RPC_CHANNEL,
@@ -398,6 +402,17 @@ export function apply(ctx) {
   const t = ctx.locale.bind(IM_LOCALE_NAMESPACE);
   setImTranslator(t);
 
+  // The settings page is the only place that knows the locale the interface is
+  // actually rendered in: DSH stores nothing when it came from the browser's
+  // language list. Report it so bot messages follow the same language.
+  ctx.effect(
+    () => installInterfaceLanguageMirror(ctx, {
+      rpcCall: (endpoint, payload, signal) =>
+        callManagementRpc(ctx.connection, HOST_LANGUAGE_RPC_CHANNEL, endpoint, payload, signal),
+    }),
+    'im-settings: mirror the DSH interface language',
+  );
+
   ctx.effect(() => installSessionChannelLogos(), 'im-settings: Session channel logos');
 
   ctx.effect(() => {

package/plugin-src/client/interface-language.js

@@ -0,0 +1,89 @@
+import { normalizeInterfaceLanguageTag } from '../../src/channels/shared/interface-language.mjs';
+import { createPollScheduler } from './lifecycle.js';
+
+/** Host route serving the interface-language mirror (plugin-src/host/host-language-rpc.mjs). */
+export const HOST_LANGUAGE_RPC_CHANNEL = '/dsh-im-language';
+export const HOST_LANGUAGE_ENDPOINTS = Object.freeze({
+  get: 'settings.language.get',
+  mirror: 'settings.language.mirror',
+});
+
+/** Widening retry delays for a report the Connection could not carry yet. */
+const RETRY_DELAYS_MS = Object.freeze([1_000, 4_000, 15_000]);
+
+/**
+ * Report the locale the settings UI is actually rendered in to the Host, so
+ * bot chat messages and command menus follow the DSH interface language.
+ *
+ * DSH stores a locale preference only when the reader picks one in the
+ * Language row: a locale derived from the browser's language list leaves the
+ * Host user-settings document empty. This mirror closes that gap, and the Host
+ * keeps an explicit selection ranked above it (see
+ * src/channels/shared/interface-language.mjs).
+ *
+ * The first report runs at plugin load, when the Connection may not be
+ * established yet, so a failed report is retried on a widening delay rather
+ * than waiting for a locale change that may never come. A failure is both a
+ * rejected promise and a resolved `{ ok: false }` envelope — the Host returns
+ * the latter when it could not persist the mirror, and that must retry too.
+ *
+ * @param ctx - client cordis context providing `locale` and the event bus.
+ * @param options.rpcCall - management RPC caller for HOST_LANGUAGE_RPC_CHANNEL.
+ * @returns an idempotent disposer that stops reporting and cancels any retry.
+ */
+export function installInterfaceLanguageMirror(ctx, {
+  rpcCall,
+  setTimeoutFn = (callback, delayMs) => globalThis.setTimeout(callback, delayMs),
+  clearTimeoutFn = (timer) => globalThis.clearTimeout(timer),
+  retryDelaysMs = RETRY_DELAYS_MS,
+} = {}) {
+  if (typeof rpcCall !== 'function' || typeof ctx?.locale?.getLocale !== 'function') {
+    return () => {};
+  }
+  const delays = retryDelaysMs.length > 0 ? retryDelaysMs : RETRY_DELAYS_MS;
+  const scheduler = createPollScheduler({ setTimeoutFn, clearTimeoutFn });
+  let mirrored = null;
+  let attempt = 0;
+
+  const retry = (active) => {
+    // Leave the tag unmirrored so the retry re-sends it. A Host that cannot
+    // persist the mirror still answers in its stored language; there is
+    // nothing for the reader to act on here.
+    if (mirrored === active) mirrored = null;
+    scheduler.schedule(report, delays[Math.min(attempt, delays.length - 1)]);
+    attempt += 1;
+  };
+
+  const report = () => {
+    if (scheduler.disposed) return;
+    const active = normalizeInterfaceLanguageTag(ctx.locale.getLocale()?.active);
+    if (active === null || active === mirrored) return;
+    mirrored = active;
+    Promise.resolve(rpcCall(HOST_LANGUAGE_ENDPOINTS.mirror, { locale: active })).then(
+      (result) => {
+        // Connection resolves failed business results normally; only a
+        // resolved ok envelope proves the Host actually persisted the mirror.
+        if (result?.ok === true) {
+          attempt = 0;
+          return;
+        }
+        retry(active);
+      },
+      () => retry(active),
+    );
+  };
+
+  report();
+  // A deliberate switch is worth reporting immediately, so it restarts the
+  // delay ladder instead of inheriting a previous failure's backoff.
+  const off = typeof ctx.on === 'function'
+    ? ctx.on('locale/change', () => {
+      attempt = 0;
+      report();
+    })
+    : null;
+  return () => {
+    scheduler.dispose();
+    if (typeof off === 'function') off();
+  };
+}

package/plugin-src/host/channels/shared/startup.mjs

@@ -1,10 +1,32 @@
 import { registerManagementRpc } from '../../../management-rpc.mjs';
+import { onImHostLanguageChange } from '../../../../src/channels/shared/i18n.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicChannelInitializing, publicChannelStartupError } from './startup-error.mjs';
 
+/**
+ * Keep a channel's platform-side command menu in the current host message
+ * language. Menus are registered with the platform when a bot connects, so a
+ * later language change has to re-send them; channels that publish no menu
+ * expose no refresh hook and are left alone.
+ */
+function followHostLanguage(ctx, channel, controller, logger) {
+  if (typeof controller?.refreshCommandMenus !== 'function') return;
+  const unsubscribe = onImHostLanguageChange(() => {
+    // Never run a slow or failing platform call inside the language switch:
+    // subscribers are synchronous and must not delay or break one another.
+    void Promise.resolve()
+      .then(() => controller.refreshCommandMenus())
+      .catch((error) => logger.warn?.(
+        `[dsh-im] failed to re-send the ${channel} command menu after a language change`,
+        error,
+      ));
+  });
+  ctx.effect(() => unsubscribe, `dsh-im: follow the host language for ${channel} command menus`);
+}
+
 /** Mount the native management RPC before any fallible production initialization. */
 export async function installProductionChannel(ctx, config, {
-  channel, rpcChannel, createProduction, createHandler,
+  channel, rpcChannel, createProduction, createHandler, reportStartupError,
 }) {
   let startupError = publicChannelInitializing(channel);
   let handler = async () => ({ ok: false, error: startupError });
@@ -31,14 +53,18 @@ export async function installProductionChannel(ctx, config, {
       ? config.deliveryService.registerAdapter(production.deliveryAdapter) : undefined;
     const readyHandler = createHandler(production.controller);
     ctx.effect(() => closeProduction, `dsh-im: close ${channel} connections`);
+    followHostLanguage(ctx, channel, production.controller, logger);
     handler = readyHandler;
   } catch (error) {
-    startupError = publicChannelStartupError(channel, error);
-    logger.error?.(`[dsh-im] failed to activate ${channel}; management RPC remains available`, error);
+    startupError = reportStartupError
+      ? reportStartupError(error, false)
+      : publicChannelStartupError(channel, error);
+    if (!reportStartupError) logger.error?.(`[dsh-im] failed to activate ${channel}; management RPC remains available`, error);
     try {
       await closeProduction();
     } catch (cleanupError) {
-      logger.error?.(`[dsh-im] failed to close partially initialized ${channel} resources`, cleanupError);
+      if (reportStartupError) reportStartupError(cleanupError, true);
+      else logger.error?.(`[dsh-im] failed to close partially initialized ${channel} resources`, cleanupError);
     }
   }
   return disposeRpc;

package/plugin-src/host/channels/weixin/connection-supervisor.mjs

@@ -1,3 +1,5 @@
+import { createWeixinDiagnostics } from '../../../../src/channels/weixin/connection-error.mjs';
+
 const DEFAULT_RETRY_DELAYS_MS = Object.freeze([250, 1_000, 3_000, 5_000, 10_000, 30_000]);
 
 function retryDelays(value) {
@@ -10,6 +12,7 @@ export class ConnectionSupervisor {
   #controller;
   #harness;
   #logger;
+  #diagnostics;
   #retryDelays;
   #healthyIntervalMs;
   #setTimeout;
@@ -26,6 +29,7 @@ export class ConnectionSupervisor {
     controller,
     harness,
     logger = console,
+    diagnostics,
     retryDelaysMs,
     healthyIntervalMs = 15_000,
     setTimeoutImpl = setTimeout,
@@ -40,6 +44,7 @@ export class ConnectionSupervisor {
     this.#controller = controller;
     this.#harness = harness;
     this.#logger = logger;
+    this.#diagnostics = diagnostics ?? createWeixinDiagnostics({ logger });
     this.#retryDelays = retryDelays(retryDelaysMs);
     this.#healthyIntervalMs = Number.isFinite(healthyIntervalMs) && healthyIntervalMs >= 0
       ? healthyIntervalMs
@@ -116,7 +121,14 @@ export class ConnectionSupervisor {
       if (this.#closed) return;
       const delayMs = this.#retryDelays[Math.min(this.#retryIndex, this.#retryDelays.length - 1)];
       this.#retryIndex += 1;
-      this.#logger.warn?.(`[dsh-weixin] connection reconciliation failed; retrying in ${delayMs}ms`, error);
+      if (typeof this.#controller.reportRestoreFailure === 'function') {
+        try { await this.#controller.reportRestoreFailure(error); }
+        catch {
+          this.#diagnostics.report(error, { operation: 'connection.restore', stage: 'harness.check', code: 'harness-check-unknown-failed', automatic: true });
+        }
+      } else {
+        this.#diagnostics.report(error, { operation: 'connection.restore', stage: 'harness.check', code: 'harness-check-unknown-failed', automatic: true });
+      }
       this.#schedule(delayMs);
     }
   }

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

@@ -1,20 +1,29 @@
 import { createProductionController } from './production.mjs';
 import { createWeixinRpcHandler, installWeixinRpc, WEIXIN_RPC_CHANNEL } from './rpc.mjs';
 import { installProductionChannel } from '../shared/startup.mjs';
+import { publicChannelStartupError } from '../shared/startup-error.mjs';
+import { createWeixinDiagnostics } from '../../../../src/channels/weixin/connection-error.mjs';
 
 export const name = 'dsh-weixin-host';
 export const inject = ['connection', 'credentials', 'typertGateway'];
 
 export async function apply(ctx, config = {}) {
+  const logger = typeof ctx.logger === 'function' ? ctx.logger('dsh-weixin') : (ctx.logger ?? console);
+  const diagnostics = createWeixinDiagnostics({ logger });
+  const rpcOptions = { ...config.rpcOptions, logger, diagnostics };
   if (config?.controller) {
-    return installWeixinRpc(ctx, config.controller, config.rpcOptions, config.rpcAuthority);
+    return installWeixinRpc(ctx, config.controller, rpcOptions, config.rpcAuthority);
   }
 
   return installProductionChannel(ctx, config, {
     channel: 'weixin',
     rpcChannel: WEIXIN_RPC_CHANNEL,
-    createProduction: () => createProductionController(ctx, config, config.internals),
-    createHandler: controller => createWeixinRpcHandler(controller, config.rpcOptions),
+    createProduction: () => createProductionController(ctx, config, { ...config.internals, diagnostics }),
+    createHandler: controller => createWeixinRpcHandler(controller, rpcOptions),
+    reportStartupError: (error, warning) => diagnostics.report(error, {
+      operation: 'startup', stage: warning ? 'connection.stop' : 'startup.load', warning,
+      code: publicChannelStartupError('weixin', error).code,
+    }).publicError,
   });
 }