liangzimixin 0.3.69 → 0.3.70

package/dist/index.cjs

@@ -18488,12 +18488,25 @@ async function resolveAndUploadMedia(params) {
         timeoutMs
       });
     } catch (err) {
-      log5.warn("media:upload failed, \u964D\u7EA7\u5904\u7406", { error: err.message });
+      const errMsg = err.message;
+      log5.warn("media:upload failed, \u964D\u7EA7\u5904\u7406", { error: errMsg });
+      try {
+        const tipText = "\u26A0\uFE0F \u6587\u4EF6\u4E0A\u4F20\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
+        await messagePipe.sendMessage({
+          chatId,
+          senderId: chatId,
+          msgType: "text",
+          content: JSON.stringify({ content: tipText }),
+          skipEncrypt: true
+        });
+      } catch (tipErr) {
+        log5.warn("media:upload-failed tip send error", { error: tipErr.message });
+      }
       return {
         channel: CHANNEL_ID,
         messageId: "",
         chatId,
-        warning: `\u6587\u4EF6\u4E0A\u4F20\u5931\u8D25: ${err.message}`
+        warning: `\u6587\u4EF6\u4E0A\u4F20\u5931\u8D25: ${errMsg}`
       };
     }
     const msgType = fileType;
@@ -19121,19 +19134,27 @@ function createQuantumImDeliverFn(deps) {
     const hasMedia = mediaUrls.length > 0;
     if (!hasText && !hasMedia) return;
     if (hasText) {
-      await messagePipe.sendMessage({
-        chatId,
-        senderId,
-        msgType: resolveTextMsgType(payload.text),
-        content: JSON.stringify({ content: payload.text }),
-        replyToMessageId,
-        skipEncrypt: shouldSkipEncrypt
-      });
-      log14.info("\u{1F4E4} AI \u6587\u672C\u56DE\u590D\u5DF2\u53D1\u9001", {
-        chatId,
-        \u957F\u5EA6: payload.text.length,
-        \u56DE\u590D\u9884\u89C8: payload.text.slice(0, 200)
-      });
+      try {
+        await messagePipe.sendMessage({
+          chatId,
+          senderId,
+          msgType: resolveTextMsgType(payload.text),
+          content: JSON.stringify({ content: payload.text }),
+          replyToMessageId,
+          skipEncrypt: shouldSkipEncrypt
+        });
+        log14.info("\u{1F4E4} AI \u6587\u672C\u56DE\u590D\u5DF2\u53D1\u9001", {
+          chatId,
+          \u957F\u5EA6: payload.text.length,
+          \u56DE\u590D\u9884\u89C8: payload.text.slice(0, 200)
+        });
+      } catch (err) {
+        log14.error("\u{1F4E4} AI \u6587\u672C\u56DE\u590D\u53D1\u9001\u5931\u8D25", {
+          chatId,
+          error: err.message
+        });
+        if (!hasMedia) throw err;
+      }
     }
     if (hasMedia) {
       for (const mediaUrl of mediaUrls) {
@@ -19425,6 +19446,21 @@ var InboundPipeline = class {
         stack: err.stack,
         durationMs
       });
+      try {
+        const errorTip = "\u26A0\uFE0F \u6D88\u606F\u5904\u7406\u9047\u5230\u95EE\u9898\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002";
+        await this.deps.messagePipe.sendMessage({
+          chatId: msg.chatId,
+          senderId: msg.senderId,
+          msgType: resolveTextMsgType(errorTip),
+          content: JSON.stringify({ content: errorTip }),
+          skipEncrypt: true
+          // 系统提示消息不加密，避免加密失败导致的死循环
+        });
+      } catch (tipErr) {
+        log15.warn("\u26A0\uFE0F \u9519\u8BEF\u63D0\u793A\u6D88\u606F\u53D1\u9001\u5931\u8D25\uFF08\u907F\u514D\u6B7B\u5FAA\u73AF\uFF0C\u4E0D\u518D\u91CD\u8BD5\uFF09", {
+          error: tipErr.message
+        });
+      }
       clearInboundEncryptionStatus(msg.chatId, msg.messageId);
     } finally {
       semaphore.release();
@@ -21143,7 +21179,9 @@ var MessagePipe = class _MessagePipe {
       body.reply_msg_id = msg.replyToMessageId;
     }
     const result = await this.callMessageApi("/messages/v1/send", body, "outbound");
-    if (!result) return;
+    if (!result) {
+      throw new Error(`\u6D88\u606F\u53D1\u9001\u5931\u8D25: POST ${this.messageServiceBaseUrl}/messages/v1/send \u672A\u8FD4\u56DE\u6709\u6548\u54CD\u5E94`);
+    }
     log25.info("\u{1F4E4} outbound:sent \u2192 IM \u670D\u52A1\u5668", {
       chatId: msg.chatId,
       encrypted: Boolean(extra),
@@ -21167,7 +21205,10 @@ var MessagePipe = class _MessagePipe {
       conversation_type: ""
     };
     const result = await this.callMessageApi("/messages/v1/recall", body, "recall");
-    if (!result) return;
+    if (!result) {
+      log25.warn("recall:failed \u2014 callMessageApi returned null");
+      return;
+    }
     log25.info("recall:sent", {
       messageId: params.messageId,
       requestId: result.request_id
@@ -21182,6 +21223,43 @@ var MessagePipe = class _MessagePipe {
    * @param body - 请求体
    * @param logTag - 日志标签前缀 (如 'outbound' / 'recall')
    */
+  /** 单次 HTTP 请求封装 — callMessageApi 内部使用 */
+  async _callMessageApiOnce(url2, body, logTag) {
+    const apiStartMs = Date.now();
+    const token = await this.tokenFn();
+    const resp = await fetch(url2, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!resp.ok) {
+      log25.error(`${logTag}:http-error`, {
+        status: resp.status,
+        statusText: resp.statusText,
+        url: url2
+      });
+      return { code: -1, msg: `HTTP ${resp.status}`, _retryable: resp.status >= 500 };
+    }
+    const result = await resp.json();
+    if (result.code !== 0 && result.code !== 200) {
+      log25.error(`${logTag}:api-error`, {
+        code: result.code,
+        msg: result.msg,
+        requestId: result.request_id
+      });
+      return null;
+    }
+    metrics.increment("outbound.success");
+    metrics.recordLatency("outbound.latency", Date.now() - apiStartMs);
+    return result;
+  }
+  /**
+   * 消息服务 API 公共调用方法 — 含 1 次重试 (仅限 5xx / 网络错误)。
+   * 失败返回 null（不抛异常），错误通过 log 记录。
+   */
   async callMessageApi(path3, body, logTag) {
     const url2 = `${this.messageServiceBaseUrl}${path3}`;
     const rateLimitResult = await this.rateLimiter.acquire();
@@ -21194,44 +21272,42 @@ var MessagePipe = class _MessagePipe {
       return null;
     }
     try {
-      const apiStartMs = Date.now();
-      const token = await this.tokenFn();
-      const resp = await fetch(url2, {
-        method: "POST",
-        headers: {
-          "Authorization": `Bearer ${token}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(body)
-      });
-      if (!resp.ok) {
-        log25.error(`${logTag}:http-error`, {
-          status: resp.status,
-          statusText: resp.statusText,
-          url: url2
-        });
+      const result = await this._callMessageApiOnce(url2, body, logTag);
+      if (result && "_retryable" in result) {
+        if (result._retryable) {
+          log25.warn(`${logTag}:retrying after 5xx`, { url: url2 });
+          await new Promise((r) => setTimeout(r, 1e3));
+          try {
+            const retryResult = await this._callMessageApiOnce(url2, body, `${logTag}:retry`);
+            if (retryResult && !("_retryable" in retryResult)) {
+              return retryResult;
+            }
+          } catch (retryErr) {
+            log25.error(`${logTag}:retry-failed`, { error: retryErr.message });
+          }
+        }
         metrics.increment("outbound.failed");
         return null;
       }
-      const result = await resp.json();
-      if (result.code !== 0 && result.code !== 200) {
-        log25.error(`${logTag}:api-error`, {
-          code: result.code,
-          msg: result.msg,
-          requestId: result.request_id
+      return result;
+    } catch (err) {
+      log25.warn(`${logTag}:network-error, retrying`, { url: url2, error: err.message });
+      await new Promise((r) => setTimeout(r, 1e3));
+      try {
+        const retryResult = await this._callMessageApiOnce(url2, body, `${logTag}:retry`);
+        if (retryResult && !("_retryable" in retryResult)) {
+          return retryResult;
+        }
+        metrics.increment("outbound.failed");
+        return null;
+      } catch (retryErr) {
+        metrics.increment("outbound.failed");
+        log25.error(`${logTag}:retry-network-error`, {
+          url: url2,
+          error: retryErr.message
         });
         return null;
       }
-      metrics.increment("outbound.success");
-      metrics.recordLatency("outbound.latency", Date.now() - apiStartMs);
-      return result;
-    } catch (err) {
-      metrics.increment("outbound.failed");
-      log25.error(`${logTag}:network-error`, {
-        url: url2,
-        error: err.message
-      });
-      return null;
     }
   }
   /**
@@ -21340,6 +21416,10 @@ var MessagePipe = class _MessagePipe {
           msgUid: callbackData.msgUid,
           error: err.message
         });
+        await this.sendHintMessage(
+          callbackData,
+          "\u26A0\uFE0F \u6D88\u606F\u89E3\u5BC6\u5931\u8D25\uFF0C\u8BF7\u91CD\u65B0\u53D1\u9001\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002"
+        );
         return;
       }
     } else {
@@ -21361,6 +21441,10 @@ var MessagePipe = class _MessagePipe {
             msgUid: callbackData.msgUid,
             error: err.message
           });
+          await this.sendHintMessage(
+            callbackData,
+            "\u26A0\uFE0F \u6D88\u606F\u89E3\u5BC6\u5931\u8D25\uFF0C\u8BF7\u91CD\u65B0\u53D1\u9001\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002"
+          );
           return;
         }
       } else {

package/dist/index.d.cts

@@ -966,6 +966,12 @@ declare class MessagePipe {
      * @param body - 请求体
      * @param logTag - 日志标签前缀 (如 'outbound' / 'recall')
      */
+    /** 单次 HTTP 请求封装 — callMessageApi 内部使用 */
+    private _callMessageApiOnce;
+    /**
+     * 消息服务 API 公共调用方法 — 含 1 次重试 (仅限 5xx / 网络错误)。
+     * 失败返回 null（不抛异常），错误通过 log 记录。
+     */
     private callMessageApi;
     /**
      * 入站处理流水线 (7 步):

package/dist/setup-entry.cjs

@@ -4559,12 +4559,25 @@ async function resolveAndUploadMedia(params) {
         timeoutMs
       });
     } catch (err) {
-      log5.warn("media:upload failed, \u964D\u7EA7\u5904\u7406", { error: err.message });
+      const errMsg = err.message;
+      log5.warn("media:upload failed, \u964D\u7EA7\u5904\u7406", { error: errMsg });
+      try {
+        const tipText = "\u26A0\uFE0F \u6587\u4EF6\u4E0A\u4F20\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
+        await messagePipe.sendMessage({
+          chatId,
+          senderId: chatId,
+          msgType: "text",
+          content: JSON.stringify({ content: tipText }),
+          skipEncrypt: true
+        });
+      } catch (tipErr) {
+        log5.warn("media:upload-failed tip send error", { error: tipErr.message });
+      }
       return {
         channel: CHANNEL_ID,
         messageId: "",
         chatId,
-        warning: `\u6587\u4EF6\u4E0A\u4F20\u5931\u8D25: ${err.message}`
+        warning: `\u6587\u4EF6\u4E0A\u4F20\u5931\u8D25: ${errMsg}`
       };
     }
     const msgType = fileType;
@@ -20064,7 +20077,9 @@ var MessagePipe = class _MessagePipe {
       body.reply_msg_id = msg.replyToMessageId;
     }
     const result = await this.callMessageApi("/messages/v1/send", body, "outbound");
-    if (!result) return;
+    if (!result) {
+      throw new Error(`\u6D88\u606F\u53D1\u9001\u5931\u8D25: POST ${this.messageServiceBaseUrl}/messages/v1/send \u672A\u8FD4\u56DE\u6709\u6548\u54CD\u5E94`);
+    }
     log16.info("\u{1F4E4} outbound:sent \u2192 IM \u670D\u52A1\u5668", {
       chatId: msg.chatId,
       encrypted: Boolean(extra),
@@ -20088,7 +20103,10 @@ var MessagePipe = class _MessagePipe {
       conversation_type: ""
     };
     const result = await this.callMessageApi("/messages/v1/recall", body, "recall");
-    if (!result) return;
+    if (!result) {
+      log16.warn("recall:failed \u2014 callMessageApi returned null");
+      return;
+    }
     log16.info("recall:sent", {
       messageId: params.messageId,
       requestId: result.request_id
@@ -20103,6 +20121,43 @@ var MessagePipe = class _MessagePipe {
    * @param body - 请求体
    * @param logTag - 日志标签前缀 (如 'outbound' / 'recall')
    */
+  /** 单次 HTTP 请求封装 — callMessageApi 内部使用 */
+  async _callMessageApiOnce(url2, body, logTag) {
+    const apiStartMs = Date.now();
+    const token = await this.tokenFn();
+    const resp = await fetch(url2, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!resp.ok) {
+      log16.error(`${logTag}:http-error`, {
+        status: resp.status,
+        statusText: resp.statusText,
+        url: url2
+      });
+      return { code: -1, msg: `HTTP ${resp.status}`, _retryable: resp.status >= 500 };
+    }
+    const result = await resp.json();
+    if (result.code !== 0 && result.code !== 200) {
+      log16.error(`${logTag}:api-error`, {
+        code: result.code,
+        msg: result.msg,
+        requestId: result.request_id
+      });
+      return null;
+    }
+    metrics.increment("outbound.success");
+    metrics.recordLatency("outbound.latency", Date.now() - apiStartMs);
+    return result;
+  }
+  /**
+   * 消息服务 API 公共调用方法 — 含 1 次重试 (仅限 5xx / 网络错误)。
+   * 失败返回 null（不抛异常），错误通过 log 记录。
+   */
   async callMessageApi(path3, body, logTag) {
     const url2 = `${this.messageServiceBaseUrl}${path3}`;
     const rateLimitResult = await this.rateLimiter.acquire();
@@ -20115,44 +20170,42 @@ var MessagePipe = class _MessagePipe {
       return null;
     }
     try {
-      const apiStartMs = Date.now();
-      const token = await this.tokenFn();
-      const resp = await fetch(url2, {
-        method: "POST",
-        headers: {
-          "Authorization": `Bearer ${token}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(body)
-      });
-      if (!resp.ok) {
-        log16.error(`${logTag}:http-error`, {
-          status: resp.status,
-          statusText: resp.statusText,
-          url: url2
-        });
+      const result = await this._callMessageApiOnce(url2, body, logTag);
+      if (result && "_retryable" in result) {
+        if (result._retryable) {
+          log16.warn(`${logTag}:retrying after 5xx`, { url: url2 });
+          await new Promise((r) => setTimeout(r, 1e3));
+          try {
+            const retryResult = await this._callMessageApiOnce(url2, body, `${logTag}:retry`);
+            if (retryResult && !("_retryable" in retryResult)) {
+              return retryResult;
+            }
+          } catch (retryErr) {
+            log16.error(`${logTag}:retry-failed`, { error: retryErr.message });
+          }
+        }
         metrics.increment("outbound.failed");
         return null;
       }
-      const result = await resp.json();
-      if (result.code !== 0 && result.code !== 200) {
-        log16.error(`${logTag}:api-error`, {
-          code: result.code,
-          msg: result.msg,
-          requestId: result.request_id
+      return result;
+    } catch (err) {
+      log16.warn(`${logTag}:network-error, retrying`, { url: url2, error: err.message });
+      await new Promise((r) => setTimeout(r, 1e3));
+      try {
+        const retryResult = await this._callMessageApiOnce(url2, body, `${logTag}:retry`);
+        if (retryResult && !("_retryable" in retryResult)) {
+          return retryResult;
+        }
+        metrics.increment("outbound.failed");
+        return null;
+      } catch (retryErr) {
+        metrics.increment("outbound.failed");
+        log16.error(`${logTag}:retry-network-error`, {
+          url: url2,
+          error: retryErr.message
         });
         return null;
       }
-      metrics.increment("outbound.success");
-      metrics.recordLatency("outbound.latency", Date.now() - apiStartMs);
-      return result;
-    } catch (err) {
-      metrics.increment("outbound.failed");
-      log16.error(`${logTag}:network-error`, {
-        url: url2,
-        error: err.message
-      });
-      return null;
     }
   }
   /**
@@ -20261,6 +20314,10 @@ var MessagePipe = class _MessagePipe {
           msgUid: callbackData.msgUid,
           error: err.message
         });
+        await this.sendHintMessage(
+          callbackData,
+          "\u26A0\uFE0F \u6D88\u606F\u89E3\u5BC6\u5931\u8D25\uFF0C\u8BF7\u91CD\u65B0\u53D1\u9001\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002"
+        );
         return;
       }
     } else {
@@ -20282,6 +20339,10 @@ var MessagePipe = class _MessagePipe {
             msgUid: callbackData.msgUid,
             error: err.message
           });
+          await this.sendHintMessage(
+            callbackData,
+            "\u26A0\uFE0F \u6D88\u606F\u89E3\u5BC6\u5931\u8D25\uFF0C\u8BF7\u91CD\u65B0\u53D1\u9001\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002"
+          );
           return;
         }
       } else {
@@ -21459,19 +21520,27 @@ function createQuantumImDeliverFn(deps) {
     const hasMedia = mediaUrls.length > 0;
     if (!hasText && !hasMedia) return;
     if (hasText) {
-      await messagePipe.sendMessage({
-        chatId,
-        senderId,
-        msgType: resolveTextMsgType(payload.text),
-        content: JSON.stringify({ content: payload.text }),
-        replyToMessageId,
-        skipEncrypt: shouldSkipEncrypt
-      });
-      log27.info("\u{1F4E4} AI \u6587\u672C\u56DE\u590D\u5DF2\u53D1\u9001", {
-        chatId,
-        \u957F\u5EA6: payload.text.length,
-        \u56DE\u590D\u9884\u89C8: payload.text.slice(0, 200)
-      });
+      try {
+        await messagePipe.sendMessage({
+          chatId,
+          senderId,
+          msgType: resolveTextMsgType(payload.text),
+          content: JSON.stringify({ content: payload.text }),
+          replyToMessageId,
+          skipEncrypt: shouldSkipEncrypt
+        });
+        log27.info("\u{1F4E4} AI \u6587\u672C\u56DE\u590D\u5DF2\u53D1\u9001", {
+          chatId,
+          \u957F\u5EA6: payload.text.length,
+          \u56DE\u590D\u9884\u89C8: payload.text.slice(0, 200)
+        });
+      } catch (err) {
+        log27.error("\u{1F4E4} AI \u6587\u672C\u56DE\u590D\u53D1\u9001\u5931\u8D25", {
+          chatId,
+          error: err.message
+        });
+        if (!hasMedia) throw err;
+      }
     }
     if (hasMedia) {
       for (const mediaUrl of mediaUrls) {
@@ -21751,6 +21820,21 @@ var InboundPipeline = class {
         stack: err.stack,
         durationMs
       });
+      try {
+        const errorTip = "\u26A0\uFE0F \u6D88\u606F\u5904\u7406\u9047\u5230\u95EE\u9898\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002";
+        await this.deps.messagePipe.sendMessage({
+          chatId: msg.chatId,
+          senderId: msg.senderId,
+          msgType: resolveTextMsgType(errorTip),
+          content: JSON.stringify({ content: errorTip }),
+          skipEncrypt: true
+          // 系统提示消息不加密，避免加密失败导致的死循环
+        });
+      } catch (tipErr) {
+        log28.warn("\u26A0\uFE0F \u9519\u8BEF\u63D0\u793A\u6D88\u606F\u53D1\u9001\u5931\u8D25\uFF08\u907F\u514D\u6B7B\u5FAA\u73AF\uFF0C\u4E0D\u518D\u91CD\u8BD5\uFF09", {
+          error: tipErr.message
+        });
+      }
       clearInboundEncryptionStatus(msg.chatId, msg.messageId);
     } finally {
       semaphore.release();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "liangzimixin",
-  "version": "0.3.69",
+  "version": "0.3.70",
   "description": "Quantum-encrypted IM channel plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.cjs",

package/scripts/liangzimixin_install.bat

@@ -3,24 +3,26 @@ setlocal enabledelayedexpansion
 chcp 65001 >nul 2>&1
 
 REM ============================================================
-REM  liangzimixin — 一键部署脚本 (Windows)
-REM  用法: liangzimixin_install.bat <appId> <appSecret> <quantumAccount>
+REM  liangzimixin install script (Windows)
+REM  Usage: liangzimixin_install.bat <appId> <appSecret> [quantumAccount]
 REM ============================================================
 
-set "SCRIPT_VERSION=0.3.69"
+set "SCRIPT_VERSION=0.3.70"
 set "NPM_PACKAGE=liangzimixin"
-set "REMOTE_SCRIPT_URL=https://unpkg.com/%NPM_PACKAGE%@latest/scripts/liangzimixin_install.bat"
 
 set "SKIP_SELF_UPDATE=0"
+set "USE_BETA=0"
 set "APP_ID="
 set "APP_SECRET="
 set "QUANTUM_ACCOUNT="
 
-REM ── 参数解析 ────────────────────────────────────────────────
+REM -- Parse arguments -------------------------------------------------
 set "IDX=0"
 for %%a in (%*) do (
     if "%%a"=="--skip-self-update" (
         set "SKIP_SELF_UPDATE=1"
+    ) else if "%%a"=="--beta" (
+        set "USE_BETA=1"
     ) else (
         set /a IDX+=1
         if !IDX!==1 set "APP_ID=%%a"
@@ -29,68 +31,61 @@ for %%a in (%*) do (
     )
 )
 
+set "TAG=latest"
+if "%USE_BETA%"=="1" set "TAG=beta"
+set "REMOTE_SCRIPT_URL=https://unpkg.com/%NPM_PACKAGE%@%TAG%/scripts/liangzimixin_install.bat"
+
 if "%APP_ID%"=="" goto :usage
 if "%APP_SECRET%"=="" goto :usage
-if "%QUANTUM_ACCOUNT%"=="" goto :usage
 goto :main
 
 :usage
 echo.
-echo liangzimixin 一键部署脚本 v%SCRIPT_VERSION%
+echo liangzimixin install script v%SCRIPT_VERSION%
 echo.
-echo 用法: %~nx0 ^<appId^> ^<appSecret^> ^<quantumAccount^> [--skip-self-update]
+echo Usage: %~nx0 ^<appId^> ^<appSecret^> [quantumAccount] [--skip-self-update] [--beta]
 echo.
-echo 参数:
-echo   appId            平台应用 ID
-echo   appSecret        应用密钥
-echo   quantumAccount   量子账户标识
+echo Arguments:
+echo   appId            App ID (required)
+echo   appSecret        App Secret (required)
+echo   quantumAccount   Quantum Account ID (optional)
 echo.
-echo 选项:
-echo   --skip-self-update  跳过脚本自更新检查
+echo Options:
+echo   --skip-self-update  Skip script self-update check
+echo   --beta              Install beta version
 echo.
 exit /b 1
 
-REM ════════════════════════════════════════════════════════════
+REM ============================================================
 :main
 echo.
-echo ═══════════════════════════════════════════════════════
-echo   liangzimixin 一键部署  v%SCRIPT_VERSION%
-echo ═══════════════════════════════════════════════════════
+echo =======================================================
+echo   liangzimixin deploy  v%SCRIPT_VERSION%
+echo =======================================================
 echo.
 
-REM ════════════════════════════════════════════════════════════
-REM  Step 0: 脚本自更新检查
-REM ════════════════════════════════════════════════════════════
+REM ============================================================
+REM  Step 0: Script self-update check
+REM ============================================================
 if "%SKIP_SELF_UPDATE%"=="1" (
-    echo [INFO] 跳过脚本自更新检查 ^(--skip-self-update^)
+    echo [INFO] Skip self-update ^(--skip-self-update^)
     goto :step1
 )
 
-echo [INFO] Step 0/4 — 检查脚本更新...
+echo [INFO] Step 0/4 - Checking for script updates...
 
 set "REMOTE_VERSION="
-REM 从 npm registry 获取最新版本号
-curl -fsSL --connect-timeout 5 --max-time 10 "https://registry.npmjs.org/%NPM_PACKAGE%/latest" > "%TEMP%\lzmx_pkg.json" 2>nul
-if %errorlevel%==0 (
-    for /f "tokens=2 delims=:," %%a in ('findstr /c:"version" "%TEMP%\lzmx_pkg.json"') do (
-        set "REMOTE_VERSION=%%~a"
-        goto :got_version
-    )
-)
-:got_version
-REM 去除可能的前后空格和引号
-if defined REMOTE_VERSION (
-    set "REMOTE_VERSION=!REMOTE_VERSION: =!"
-    set "REMOTE_VERSION=!REMOTE_VERSION:"=!"
+REM Fetch latest version from npm registry (use PowerShell for JSON parsing)
+for /f "usebackq delims=" %%a in (`powershell -NoProfile -Command "try { (Invoke-RestMethod -Uri 'https://registry.npmjs.org/%NPM_PACKAGE%/%TAG%' -TimeoutSec 10).version } catch { }" 2^>nul`) do (
+    set "REMOTE_VERSION=%%a"
 )
-del /q "%TEMP%\lzmx_pkg.json" 2>nul
 
 if not defined REMOTE_VERSION (
-    echo [WARN] 无法检查远端版本，使用当前版本继续执行
+    echo [WARN] Cannot check remote version, continuing with current version
     goto :step1
 )
 
-REM 简单版本比较：解析语义化版本，防止 prerelease 版本被回滚到较旧的 latest 版
+REM Semver comparison: prevent prerelease from rolling back to older latest
 for /f "delims=- tokens=1" %%a in ("!REMOTE_VERSION!") do set "CLEAN_REMOTE=%%a"
 for /f "delims=- tokens=1" %%a in ("!SCRIPT_VERSION!") do set "CLEAN_LOCAL=%%a"
 
@@ -111,86 +106,105 @@ if !R1! EQU !L1! (
 )
 
 if "%REMOTE_VERSION%"=="%SCRIPT_VERSION%" (
-    echo [OK] 脚本已是最新版本 ^(v%SCRIPT_VERSION%^)
+    echo [OK] Script is up to date ^(v%SCRIPT_VERSION%^)
     goto :step1
 )
 
 if "!SHOULD_UPDATE!"=="0" (
-    echo [OK] 当前脚本 ^(v%SCRIPT_VERSION%^) 更新或等同于远端 ^(v%REMOTE_VERSION%^)
+    echo [OK] Current script ^(v%SCRIPT_VERSION%^) is newer or equal to remote ^(v%REMOTE_VERSION%^)
     goto :step1
 )
 
-echo [INFO] 发现新版本: %SCRIPT_VERSION% -^> %REMOTE_VERSION%，正在更新脚本...
+echo [INFO] New version found: %SCRIPT_VERSION% -^> %REMOTE_VERSION%, updating...
 set "TEMP_SCRIPT=%TEMP%\liangzimixin_install_new.bat"
 curl -fsSL --connect-timeout 10 --max-time 30 "!REMOTE_SCRIPT_URL!" -o "%TEMP_SCRIPT%" 2>nul
 if %errorlevel%==0 (
-    echo [OK] 脚本已更新到 v%REMOTE_VERSION%
-    call "%TEMP_SCRIPT%" --skip-self-update %APP_ID% %APP_SECRET% %QUANTUM_ACCOUNT%
+    echo [OK] Script updated to v%REMOTE_VERSION%
+    if "%USE_BETA%"=="1" (
+        call "%TEMP_SCRIPT%" --skip-self-update --beta %APP_ID% %APP_SECRET% %QUANTUM_ACCOUNT%
+    ) else (
+        call "%TEMP_SCRIPT%" --skip-self-update %APP_ID% %APP_SECRET% %QUANTUM_ACCOUNT%
+    )
     exit /b %errorlevel%
 ) else (
-    echo [WARN] 脚本下载失败，使用当前版本继续执行
+    echo [WARN] Script download failed, continuing with current version
     del /q "%TEMP_SCRIPT%" 2>nul
 )
 
 echo.
 
-REM ════════════════════════════════════════════════════════════
-REM  Step 1: 安装/更新插件
-REM ════════════════════════════════════════════════════════════
+REM ============================================================
+REM  Step 1: Install/update plugin
+REM ============================================================
 :step1
-echo [INFO] Step 1/4 — 安装/更新 liangzimixin 插件...
+echo [INFO] Step 1/4 - Install/update liangzimixin plugin (%TAG%)...
 
-openclaw plugins list 2>nul | findstr /i "liangzimixin" >nul
+call openclaw plugins list 2>nul | findstr /i "liangzimixin" >nul
 if %errorlevel%==0 (
-    echo [INFO] 插件已安装，正在更新到最新版本...
-    openclaw plugins update liangzimixin
+    echo [INFO] Plugin installed, updating...
+    if "%USE_BETA%"=="1" (
+        call openclaw plugins install liangzimixin@beta
+    ) else (
+        call openclaw plugins update liangzimixin
+    )
 ) else (
-    echo [INFO] 插件未安装，正在安装最新版本...
-    openclaw plugins install liangzimixin@latest
+    echo [INFO] Plugin not installed, installing...
+    call openclaw plugins install liangzimixin@%TAG%
 )
 
+REM Verify plugin is actually installed (don't rely on exit code, as
+REM "already at latest" may return non-zero)
+call openclaw plugins list 2>nul | findstr /i "liangzimixin" >nul
 if %errorlevel% neq 0 (
-    echo [ERROR] 插件安装/更新失败，请检查网络或权限
+    echo [ERROR] Plugin install/update failed, check network or permissions
     exit /b 1
 )
 
-echo [OK] 插件就绪
+echo [OK] Plugin ready
 echo.
 
-REM ════════════════════════════════════════════════════════════
-REM  Step 2: 写入配置
-REM ════════════════════════════════════════════════════════════
-echo [INFO] Step 2/4 — 写入配置...
+REM ============================================================
+REM  Step 2: Write configuration
+REM ============================================================
+echo [INFO] Step 2/4 - Writing configuration...
 
-openclaw channels add --channel liangzimixin --token %APP_ID% --password %APP_SECRET% --user-id %QUANTUM_ACCOUNT%
+if not "%QUANTUM_ACCOUNT%"=="" (
+    call openclaw channels add --channel liangzimixin --token %APP_ID% --password %APP_SECRET% --user-id %QUANTUM_ACCOUNT%
+) else (
+    call openclaw channels add --channel liangzimixin --token %APP_ID% --password %APP_SECRET%
+)
 
 if %errorlevel% neq 0 (
-    echo [ERROR] 配置写入失败，请检查参数是否正确
+    echo [ERROR] Configuration write failed, check parameters
     exit /b 1
 )
 
-echo [OK] 配置写入成功 ^(appId / appSecret / quantumAccount^)
+if not "%QUANTUM_ACCOUNT%"=="" (
+    echo [OK] Configuration saved (appId / appSecret / quantumAccount)
+) else (
+    echo [OK] Configuration saved (appId / appSecret)
+)
 echo.
 
-REM ════════════════════════════════════════════════════════════
-REM  Step 3: 重启网关
-REM ════════════════════════════════════════════════════════════
-echo [INFO] Step 3/4 — 重启 OpenClaw 网关...
+REM ============================================================
+REM  Step 3: Restart gateway
+REM ============================================================
+echo [INFO] Step 3/4 - Restarting OpenClaw gateway...
 
-openclaw gateway restart
+call openclaw gateway restart
 
 if %errorlevel% neq 0 (
-    echo [ERROR] 网关重启失败，请手动执行: openclaw gateway restart
-    exit /b 1
+    echo [WARN] Gateway restart command returned an error or timed out
+    echo [WARN] Continuing to health check anyway...
+) else (
+    echo [OK] Gateway restart command sent
 )
-
-echo [OK] 网关重启指令已发送
 echo.
 
-REM ════════════════════════════════════════════════════════════
-REM  Step 4: 健康检查
-REM ════════════════════════════════════════════════════════════
-echo [INFO] Step 4/4 — 健康检查...
+REM ============================================================
+REM  Step 4: Health check
+REM ============================================================
+echo [INFO] Step 4/4 - Health check...
 
 set "MAX_RETRIES=3"
 set "RETRY_INTERVAL=5"
@@ -198,21 +212,21 @@ set "HEALTH_OK=0"
 
 for /l %%i in (1,1,%MAX_RETRIES%) do (
     if !HEALTH_OK!==0 (
-        echo [INFO] 等待服务就绪 ^(%RETRY_INTERVAL%s^)...
+        echo [INFO] Waiting for service ^(%RETRY_INTERVAL%s^)...
         timeout /t %RETRY_INTERVAL% /nobreak >nul
 
-        echo [INFO] 第 %%i/%MAX_RETRIES% 次检查...
+        echo [INFO] Check %%i/%MAX_RETRIES%...
 
         set "GATEWAY_OK=0"
         set "CHANNEL_OK=0"
 
-        openclaw status > "%TEMP%\lzmx_status.txt" 2>&1
+        call openclaw status > "%TEMP%\lzmx_status.txt" 2>&1
 
-        REM 检查 gateway 状态 (reachable 在表格折行中)
+        REM Check gateway status
         findstr /i /c:"reachable" "%TEMP%\lzmx_status.txt" >nul 2>&1
         if !errorlevel!==0 set "GATEWAY_OK=1"
 
-        REM 检查 QuantumIM 渠道状态 (同一行: │ QuantumIM │ ON │ OK │)
+        REM Check QuantumIM channel status
         findstr /i /c:"QuantumIM" "%TEMP%\lzmx_status.txt" | findstr /i /c:"OK" >nul 2>&1
         if !errorlevel!==0 set "CHANNEL_OK=1"
 
@@ -222,9 +236,9 @@ for /l %%i in (1,1,%MAX_RETRIES%) do (
             set "HEALTH_OK=1"
         ) else (
             if !GATEWAY_OK!==1 (
-                echo [WARN] 网关已就绪，但渠道尚未连接...
+                echo [WARN] Gateway ready, but channel not connected...
             ) else (
-                echo [WARN] 服务尚未就绪...
+                echo [WARN] Service not ready...
             )
         )
     )
@@ -234,26 +248,26 @@ echo.
 echo ---------------------------------------------------
 
 if %HEALTH_OK%==1 (
-    echo [SUCCESS] 部署完成!
+    echo [SUCCESS] Deploy complete!
     echo.
     echo   Health:
     echo     gateway    = reachable
     echo     QuantumIM  = OK
     echo.
-    echo   查看详情: openclaw status
+    echo   Details: openclaw status
     echo.
 ) else (
-    echo [WARN] 部署已完成，但健康检查未通过
+    echo [WARN] Deploy finished, but health check failed
     echo.
-    echo   可能原因：
-    echo     - 服务启动较慢，请稍后手动检查
-    echo     - 网络连接问题
-    echo     - 凭据配置有误
+    echo   Possible causes:
+    echo     - Service is still starting, check later
+    echo     - Network connectivity issue
+    echo     - Invalid credentials
     echo.
-    echo   手动检查: openclaw status
-    echo   查看日志: openclaw gateway logs
+    echo   Manual check: openclaw status
+    echo   View logs: openclaw gateway logs
     echo.
     exit /b 1
 )
 
-endlocal
+endlocal

package/scripts/liangzimixin_install.sh

@@ -3,12 +3,11 @@ set -euo pipefail
 
 # ============================================================
 #  liangzimixin — 一键部署脚本
-#  用法: ./liangzimixin_install.sh <appId> <appSecret> <quantumAccount>
+#  用法: ./liangzimixin_install.sh <appId> <appSecret> [quantumAccount]
 # ============================================================
 
-SCRIPT_VERSION="0.3.69"
+SCRIPT_VERSION="0.3.70"
 NPM_PACKAGE="liangzimixin"
-REMOTE_SCRIPT_URL="https://unpkg.com/${NPM_PACKAGE}@latest/scripts/liangzimixin_install.sh"
 
 # ── 颜色 ──────────────────────────────────────────────────────
 RED='\033[0;31m'
@@ -24,11 +23,13 @@ fail()    { echo -e "${RED}✗${NC} $*"; exit 1; }
 
 # ── 参数解析 ──────────────────────────────────────────────────
 SKIP_SELF_UPDATE=false
+USE_BETA=false
 POSITIONAL_ARGS=()
 
 for arg in "$@"; do
   case $arg in
     --skip-self-update) SKIP_SELF_UPDATE=true ;;
+    --beta) USE_BETA=true ;;
     *) POSITIONAL_ARGS+=("$arg") ;;
   esac
 done
@@ -37,19 +38,27 @@ APP_ID="${POSITIONAL_ARGS[0]:-}"
 APP_SECRET="${POSITIONAL_ARGS[1]:-}"
 QUANTUM_ACCOUNT="${POSITIONAL_ARGS[2]:-}"
 
-if [ -z "$APP_ID" ] || [ -z "$APP_SECRET" ] || [ -z "$QUANTUM_ACCOUNT" ]; then
+TAG="latest"
+if [ "$USE_BETA" = true ]; then
+  TAG="beta"
+fi
+
+REMOTE_SCRIPT_URL="https://unpkg.com/${NPM_PACKAGE}@${TAG}/scripts/liangzimixin_install.sh"
+
+if [ -z "$APP_ID" ] || [ -z "$APP_SECRET" ]; then
   echo ""
   echo "liangzimixin 一键部署脚本 v${SCRIPT_VERSION}"
   echo ""
-  echo "用法: $0 <appId> <appSecret> <quantumAccount> [--skip-self-update]"
+  echo "用法: $0 <appId> <appSecret> [quantumAccount] [--skip-self-update] [--beta]"
   echo ""
   echo "参数:"
-  echo "  appId            平台应用 ID"
-  echo "  appSecret        应用密钥"
-  echo "  quantumAccount   量子账户标识"
+  echo "  appId            平台应用 ID (必填)"
+  echo "  appSecret        应用密钥 (必填)"
+  echo "  quantumAccount   量子账户标识 (可选)"
   echo ""
   echo "选项:"
   echo "  --skip-self-update  跳过脚本自更新检查"
+  echo "  --beta              安装 beta 测试版本"
   echo ""
   exit 1
 fi
@@ -101,7 +110,7 @@ if [ "$SKIP_SELF_UPDATE" = false ]; then
   if command -v curl &>/dev/null; then
     # 从 npm registry 获取最新版本号
     REMOTE_VERSION=$(curl -fsSL --connect-timeout 5 --max-time 10 \
-      "https://registry.npmjs.org/${NPM_PACKAGE}/latest" 2>/dev/null \
+      "https://registry.npmjs.org/${NPM_PACKAGE}/${TAG}" 2>/dev/null \
       | grep -o '"version":"[^"]*"' | head -1 | cut -d'"' -f4) || true
   fi
 
@@ -117,7 +126,15 @@ if [ "$SKIP_SELF_UPDATE" = false ]; then
       if curl -fsSL --connect-timeout 10 --max-time 30 "$REMOTE_SCRIPT_URL" -o "$TEMP_SCRIPT" 2>/dev/null; then
         chmod +x "$TEMP_SCRIPT"
         success "脚本已更新到 v${REMOTE_VERSION}"
-        exec "$TEMP_SCRIPT" --skip-self-update "$APP_ID" "$APP_SECRET" "$QUANTUM_ACCOUNT"
+        EXEC_ARGS=(--skip-self-update)
+        if [ "$USE_BETA" = true ]; then
+          EXEC_ARGS+=(--beta)
+        fi
+        EXEC_ARGS+=("$APP_ID" "$APP_SECRET")
+        if [ -n "$QUANTUM_ACCOUNT" ]; then
+          EXEC_ARGS+=("$QUANTUM_ACCOUNT")
+        fi
+        exec "$TEMP_SCRIPT" "${EXEC_ARGS[@]}"
       else
         warn "脚本下载失败，使用当前版本继续执行"
         rm -f "$TEMP_SCRIPT"
@@ -137,17 +154,17 @@ echo ""
 # ══════════════════════════════════════════════════════════════
 #  Step 1: 安装 / 更新插件
 # ══════════════════════════════════════════════════════════════
-info "Step 1/4 — 安装/更新 liangzimixin 插件..."
+info "Step 1/4 — 安装/更新 liangzimixin 插件 (${TAG})..."
 
 if openclaw plugins list 2>/dev/null | grep -q "liangzimixin"; then
-  info "插件已安装，正在更新到最新版本..."
+  info "插件已安装，正在更新..."
   if ! openclaw plugins update liangzimixin; then
     fail "插件更新失败，请检查网络或权限"
   fi
   success "插件更新完成"
 else
-  info "插件未安装，正在安装最新版本..."
-  if ! openclaw plugins install liangzimixin@latest; then
+  info "插件未安装，正在安装..."
+  if ! openclaw plugins install liangzimixin@${TAG}; then
     fail "插件安装失败，请检查网络或权限"
   fi
   success "插件安装完成"
@@ -160,15 +177,20 @@ echo ""
 # ══════════════════════════════════════════════════════════════
 info "Step 2/4 — 写入配置..."
 
-if ! openclaw channels add \
-  --channel liangzimixin \
-  --token "$APP_ID" \
-  --password "$APP_SECRET" \
-  --user-id "$QUANTUM_ACCOUNT"; then
+CHANNEL_ARGS=(--channel liangzimixin --token "$APP_ID" --password "$APP_SECRET")
+if [ -n "$QUANTUM_ACCOUNT" ]; then
+  CHANNEL_ARGS+=(--user-id "$QUANTUM_ACCOUNT")
+fi
+
+if ! openclaw channels add "${CHANNEL_ARGS[@]}"; then
   fail "配置写入失败，请检查参数是否正确"
 fi
 
-success "配置写入成功 (appId / appSecret / quantumAccount)"
+if [ -n "$QUANTUM_ACCOUNT" ]; then
+  success "配置写入成功 (appId / appSecret / quantumAccount)"
+else
+  success "配置写入成功 (appId / appSecret)"
+fi
 echo ""
 
 # ══════════════════════════════════════════════════════════════
@@ -177,10 +199,10 @@ echo ""
 info "Step 3/4 — 重启 OpenClaw 网关..."
 
 if ! openclaw gateway restart; then
-  fail "网关重启失败，请手动执行: openclaw gateway restart"
+  warn "网关重启指令返回错误或超时，将继续进行健康检查..."
+else
+  success "网关重启指令已发送"
 fi
-
-success "网关重启指令已发送"
 echo ""
 
 # ══════════════════════════════════════════════════════════════