@xmanrui/dsh-im 4.19.2 → 4.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.19.2",
+  "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",
@@ -56,6 +56,14 @@
     {
       "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/host/channels/shared/startup.mjs

@@ -26,7 +26,7 @@ function followHostLanguage(ctx, channel, controller, logger) {
 
 /** 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 });
@@ -56,12 +56,15 @@ export async function installProductionChannel(ctx, config, {
     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,
   });
 }
 

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

@@ -11,6 +11,7 @@ import {
 } from '../../../../src/channels/weixin/weixin-api.mjs';
 import { WeixinController } from '../../../../src/channels/weixin/weixin-controller.mjs';
 import { WeixinRuntime } from '../../../../src/channels/weixin/weixin-runtime.mjs';
+import { createWeixinDiagnostics, knownWeixinErrorCode, weixinStageError } from '../../../../src/channels/weixin/connection-error.mjs';
 import {
   BotWorkspaceStore,
   createBotWorkspaceScope,
@@ -44,6 +45,33 @@ function pluginPaths(config) {
   };
 }
 
+// Keep shared workspace lifecycle semantics; expose its fallible persistence only to Weixin.
+function diagnosticWorkspaces(store) {
+  const writes = new Set(['ensure', 'setWorkspace', 'setModel', 'setAgentPreset', 'setAlias', 'setContextEnhancement', 'setAccessPolicy', 'flushPendingRemoval']);
+  const removals = new Set(['retireAfterConfigCommit', 'finishRemoval']);
+  return new Proxy(store, {
+    get(target, property) {
+      const value = Reflect.get(target, property, target);
+      if (typeof value !== 'function') return value;
+      if (!writes.has(property) && !removals.has(property)) return value.bind(target);
+      return (...args) => {
+        const failure = error => {
+          throw knownWeixinErrorCode(error?.code) ? error
+            : weixinStageError(removals.has(property) ? 'workspace-cleanup-failed' : 'workspace-save-failed', error);
+        };
+        try {
+          const result = value.apply(target, args);
+          // flushPendingRemoval must remain synchronous when no cleanup is pending.
+          return result?.then ? result.then(value => {
+            if (removals.has(property) && value?.error) failure(value.error);
+            return value;
+          }, failure) : result;
+        } catch (error) { return failure(error); }
+      };
+    },
+  });
+}
+
 export async function createProductionController(ctx, config = {}, internals = {}) {
   if (!ctx?.credentials) throw new TypeError('dsh-weixin requires ctx.credentials');
   const connection = harnessConnection(ctx, config);
@@ -58,13 +86,14 @@ export async function createProductionController(ctx, config = {}, internals = {
   const logger = typeof ctx.logger === 'function'
     ? ctx.logger('dsh-weixin')
     : (ctx.logger ?? console);
+  const diagnostics = internals.diagnostics ?? createWeixinDiagnostics({ logger });
   const agentPresetCatalog = () => listAgentPresetCatalog(ctx);
   const paths = pluginPaths(config);
   const configStore = await new ConfigStore(paths.config).load();
   const defaultWorkspace = resolve(config.workspace ?? process.cwd());
   const WorkspaceStore = internals.WorkspaceStore ?? BotWorkspaceStore;
-  const workspaces = internals.workspaces
-    ?? await new WorkspaceStore(paths.workspaces, { defaultWorkspace }).load();
+  const workspaces = diagnosticWorkspaces(internals.workspaces
+    ?? await new WorkspaceStore(paths.workspaces, { defaultWorkspace }).load());
   const configuredBots = configStore.list();
   await workspaces.reconcile(configuredBots.map((bot) => bot.botId));
   await Promise.all(configuredBots.map((bot) => workspaces.ensure(bot.botId, {
@@ -115,6 +144,7 @@ export async function createProductionController(ctx, config = {}, internals = {
     credentials: ctx.credentials,
     configStore: observedConfigStore,
     logger,
+    diagnostics,
     createRuntime: async ({ botId, config: accountConfig, token }) => {
       const state = await stateFor(botId);
       await workspaces.ensure(botId, {
@@ -125,6 +155,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         botId, workspaces, state, agentPresetCatalog,
       });
       return new Runtime({
+        diagnostics,
         api,
         config: accountConfig,
         token,
@@ -158,16 +189,35 @@ export async function createProductionController(ctx, config = {}, internals = {
       }
     },
   });
-  const controller = createWorkspaceAwareController(coreController, {
+  const workspaceController = createWorkspaceAwareController(coreController, {
     workspaces,
     stateFor,
     agentPresetCatalog,
     modelCatalog,
   });
+  const controller = new Proxy(workspaceController, {
+    get(target, property) {
+      if (property === 'deleteBot') return async (...args) => {
+        const existed = Boolean(configStore.get(args[0]));
+        try { return await target.deleteBot(...args); }
+        catch (error) {
+          if (!existed || configStore.get(args[0])) throw error;
+          // The shared workspace wrapper can fail cleaning up after the account commit.
+          const warning = diagnostics.report(weixinStageError('workspace-cleanup-failed', error), {
+            operation: 'bot.delete', botId: args[0], warning: true,
+          }).publicError;
+          try { return { ...await target.status(), warnings: [warning] }; }
+          catch (readError) { throw weixinStageError('status-read-failed', readError, 'status.read'); }
+        }
+      };
+      return Reflect.get(target, property);
+    },
+  });
   const supervisor = createSupervisor({
     controller,
     harness,
     logger,
+    diagnostics,
     retryDelaysMs: config.retryDelaysMs,
     healthyIntervalMs: config.healthyIntervalMs,
   }).start();