@xmanrui/dsh-im 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

package/plugin-src/client/i18n.js

@@ -9,6 +9,7 @@ const EN = Object.freeze({
   'IM 渠道': 'IM channels',
   '让 DeepSeek Harness 触手可及': 'DeepSeek Harness, always within reach',
   'AI Office': 'AI Office',
+  '（实验功能）': '(Experimental)',
   'AI Office 设置': 'AI Office settings',
   'AI Office 设置页缺少 RPC 连接': 'AI Office settings are missing an RPC connection',
   '正在读取 AI Office Connector…': 'Loading AI Office Connector…',
@@ -230,6 +231,13 @@ const EN = Object.freeze({
   '这是微信附加的安全确认步骤。配对码只用于本次扫码轮询，不会写入配置或日志。': 'This is an additional WeChat confirmation step. The pairing code is used only for this connection and is never stored.',
   '正在保存凭据并验证 Harness 与微信长轮询。': 'Saving credentials and verifying the WeChat connection.',
   '微信已确认，正在启动消息连接': 'Confirmed in WeChat. Starting the message connection',
+  '微信已授权，但无法读取现有登录凭据。请检查 DSH 凭据存储。': 'WeChat was authorized, but the existing login credential could not be read. Check the DSH credential store.',
+  '微信已授权，但登录凭据无法写入 DSH 凭据存储。请检查凭据存储是否可写。': 'WeChat was authorized, but the login credential could not be written to the DSH credential store. Check that the store is writable.',
+  '微信已授权，但账号配置无法写入本机。请检查 DSH_HOME 目录权限。': 'WeChat was authorized, but the account configuration could not be saved locally. Check the DSH_HOME directory permissions.',
+  '微信已授权，但无法初始化账号状态或工作区。请检查 DSH_HOME 和工作区目录。': 'WeChat was authorized, but the account state or workspace could not be initialized. Check DSH_HOME and the workspace directory.',
+  '微信已授权，但插件无法连接本机 Harness。请确认 dsh web 已正常启动。': 'WeChat was authorized, but the plugin could not reach the local Harness. Confirm that dsh web is running normally.',
+  '微信已授权，但消息连接初始化失败。请查看 dsh web 日志后重试。': 'WeChat was authorized, but the message connection could not be initialized. Check the dsh web logs and try again.',
+  '微信已授权，但激活过程中发生未知错误。请查看 dsh web 日志。': 'WeChat was authorized, but an unknown error occurred during activation. Check the dsh web logs.',
   '微信已绑定，可以开始向已绑定的机器人发消息。': 'WeChat is connected and ready for messages.',
   '这个微信账号已经绑定并保持在线。': 'This WeChat account is connected and online.',
   '微信账号及本机凭据已移除。': 'The WeChat account and local credentials were removed.',

package/plugin-src/client/index.js

@@ -58,7 +58,7 @@ const CHANNELS = Object.freeze([
   { id: 'telegram', label: 'Telegram' },
   { id: 'discord', label: 'Discord' },
   { id: 'whatsapp', label: 'WhatsApp' },
-  { id: 'office', label: 'AI Office' },
+  { id: 'office', label: 'AI Office', note: '（实验功能）' },
 ]);
 
 function WeixinLogo() {
@@ -176,6 +176,7 @@ export function IMSettingsTab({
         h(ChannelLogo, { channel: channel.id }),
         h('span', { className: 'dim-channelCopy' },
           h('strong', null, channel.label),
+          channel.note ? h('small', { className: 'dim-channelNote' }, channel.note) : null,
         )))),
       h('div', { className: 'dim-divider', 'aria-hidden': 'true' }),
       h('main', {

package/plugin-src/client/styles.js

@@ -52,8 +52,9 @@ const CSS = String.raw`
 .dim-logoSlack svg { width: 21px; height: 21px; }
 .dim-logoWhatsapp { color: white; background: #25d366; }
 .dim-logoWhatsapp svg { width: 21px; height: 21px; }
-.dim-channelCopy { min-width: 0; display: block; }
+.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; }
+.dim-channelNote { overflow: hidden; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 10px; line-height: 13px; font-weight: 500; text-overflow: ellipsis; white-space: nowrap; }
 .dim-divider { width: 1px; min-height: 520px; background: var(--dsw-alias-border-l1, #eef0f3); }
 .dim-panel { min-width: 0; container-type: inline-size; }
 .dim-panel .bxf-page, .dim-panel .dxw-page, .dim-panel .ddt-page, .dim-panel .dqq-page, .dim-panel .dwecom-page, .dim-panel .dsl-page, .dim-panel .dwa-page { width: 100%; max-width: none; padding: 0 0 24px; }

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

@@ -108,7 +108,7 @@ export class DiscordApi {
         headers: {
           authorization: `Bot ${this.#token}`,
           'content-type': 'application/json',
-          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 0.14.0)',
+          'user-agent': 'DeepSeek-Harness-dsh-im (https://github.com/xmanrui/dsh-im, 0.15.0)',
         },
         ...(body === undefined ? {} : { body: JSON.stringify(body) }),
         signal: requestSignal(signal, timeoutMs),

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

@@ -184,7 +184,7 @@ function authenticatedHeaders(token) {
 function baseInfo() {
   return {
     channel_version: WEIXIN_PROTOCOL_VERSION,
-    bot_agent: 'DeepSeekHarness/0.14.0',
+    bot_agent: 'DeepSeekHarness/0.15.0',
   };
 }
 

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

@@ -20,6 +20,14 @@ const ACTIVE_ATTEMPT_STATES = new Set([
 ]);
 const TERMINAL_ATTEMPT_STATES = new Set(['connected', 'expired', 'failed', 'cancelled']);
 const QR_TTL_MS = 5 * 60_000;
+const ACTIVATION_ERROR_MESSAGES = Object.freeze({
+  'credential-read-failed': '微信已授权，但无法读取现有登录凭据。请检查 DSH 凭据存储。',
+  'credential-save-failed': '微信已授权，但登录凭据无法写入 DSH 凭据存储。请检查凭据存储是否可写。',
+  'account-config-save-failed': '微信已授权，但账号配置无法写入本机。请检查 DSH_HOME 目录权限。',
+  'runtime-prepare-failed': '微信已授权，但无法初始化账号状态或工作区。请检查 DSH_HOME 和工作区目录。',
+  'harness-unreachable': '微信已授权，但插件无法连接本机 Harness。请确认 dsh web 已正常启动。',
+  'connection-start-failed': '微信已授权，但消息连接初始化失败。请查看 dsh web 日志后重试。',
+});
 
 function cleanString(value) {
   return typeof value === 'string' && value.trim() ? value.trim() : null;
@@ -54,6 +62,26 @@ function safeAccountError(code, message) {
   return Object.freeze({ code, message });
 }
 
+function activationStageError(code, cause) {
+  const error = new Error(`Weixin activation failed during ${code}`, { cause });
+  error.name = 'WeixinActivationStageError';
+  error.code = code;
+  return error;
+}
+
+function publicProvisioningError(error) {
+  if (error instanceof WeixinApiError) return safeAccountError(error.code, error.message);
+  const message = ACTIVATION_ERROR_MESSAGES[error?.code];
+  return message
+    ? safeAccountError(error.code, message)
+    : safeAccountError('activation-unknown-failed', '微信已授权，但激活过程中发生未知错误。请查看 dsh web 日志。');
+}
+
+function preserveActivationError(error, fallbackCode) {
+  if (error instanceof WeixinApiError || ACTIVATION_ERROR_MESSAGES[error?.code]) return error;
+  return activationStageError(fallbackCode, error);
+}
+
 export class WeixinController {
   #api;
   #credentials;
@@ -439,12 +467,7 @@ export class WeixinController {
         record.error = safeAccountError('cancelled', '扫码绑定已取消。');
       } else {
         record.state = 'failed';
-        record.error = safeAccountError(
-          error instanceof WeixinApiError ? error.code : 'activation-failed',
-          error instanceof WeixinApiError
-            ? error.message
-            : '微信已授权，但无法保存凭据或启动消息连接。',
-        );
+        record.error = publicProvisioningError(error);
         this.#logger.error?.('[dsh-weixin] provisioning failed:', error);
       }
     } finally {
@@ -469,13 +492,26 @@ export class WeixinController {
       createdAt: previousConfig?.createdAt ?? new Date().toISOString(),
       connectedAt: new Date().toISOString(),
     };
-    const previousToken = await this.#credentials.resolve(identity.tokenRef).catch(() => undefined);
+    let previousToken;
+    try {
+      previousToken = await this.#credentials.resolve(identity.tokenRef);
+    } catch (error) {
+      throw activationStageError('credential-read-failed', error);
+    }
 
     return this.#withBotTransition(identity.botId, async () => {
-      await this.#credentials.set(identity.tokenRef, token);
       try {
+        try {
+          await this.#credentials.set(identity.tokenRef, token);
+        } catch (error) {
+          throw activationStageError('credential-save-failed', error);
+        }
         this.#assertAttemptActive(record);
-        await this.#configStore.save(config);
+        try {
+          await this.#configStore.save(config);
+        } catch (error) {
+          throw activationStageError('account-config-save-failed', error);
+        }
         this.#assertAttemptActive(record);
         await this.#startRuntime(config, token);
         this.#assertAttemptActive(record);
@@ -504,16 +540,24 @@ export class WeixinController {
 
   async #startRuntime(config, token) {
     await this.#stopRuntime(config.botId);
-    const runtime = await this.#createRuntime({ botId: config.botId, config, token });
+    let runtime;
+    try {
+      runtime = await this.#createRuntime({ botId: config.botId, config, token });
+    } catch (error) {
+      throw preserveActivationError(error, 'runtime-prepare-failed');
+    }
     if (!runtime || typeof runtime.start !== 'function' || typeof runtime.stop !== 'function') {
-      throw new TypeError('createRuntime returned an invalid Weixin runtime');
+      throw activationStageError(
+        'runtime-prepare-failed',
+        new TypeError('createRuntime returned an invalid Weixin runtime'),
+      );
     }
     try {
       await runtime.start();
       this.#runtimes.set(config.botId, runtime);
     } catch (error) {
       await runtime.stop().catch(() => undefined);
-      throw error;
+      throw preserveActivationError(error, 'connection-start-failed');
     }
   }
 

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

@@ -25,6 +25,13 @@ function retryableStartError(error) {
     && (error.status === 408 || error.status === 425 || error.status === 429 || error.status >= 500);
 }
 
+function runtimeStartError(code, cause) {
+  const error = new Error(`Weixin runtime failed during ${code}`, { cause });
+  error.name = 'WeixinRuntimeStartError';
+  error.code = code;
+  return error;
+}
+
 function delay(ms, signal) {
   return new Promise((resolve, reject) => {
     if (signal?.aborted) {
@@ -117,7 +124,11 @@ export class WeixinRuntime {
     this.#status.weixinConnectionState = 'connecting';
     this.#status.lastError = null;
     try {
-      await this.#harness.ensureRunning();
+      try {
+        await this.#harness.ensureRunning();
+      } catch (error) {
+        throw runtimeStartError('harness-unreachable', error);
+      }
       this.#status.harnessReachable = true;
       await this.#notifyStart();
       this.#abortController = new AbortController();