ylib-openclaw-weixin 2.1.7-beta.9 → 2.1.8

package/README.md

@@ -310,3 +310,21 @@ Ensure `plugins.entries.openclaw-weixin.enabled` is `true` in `~/.openclaw/openc
 openclaw config set plugins.entries.openclaw-weixin.enabled true
 openclaw gateway restart
 ```
+
+## Long Markdown Regression (One-Click)
+
+Use this to run an end-to-end send with a real long markdown payload (links/images/code blocks included):
+
+```bash
+npm run regression:long-markdown -- \
+  --base-url https://weixin-gateway.example.com \
+  --to o9cq809SI88YrRxbFQXu39Lf3Xu8@im.wechat \
+  --context-token <context_token> \
+  --token <token> \
+  --repeat 120 \
+  --timeout-ms 45000
+```
+
+Notes:
+- This command builds first, then runs `scripts/regression-long-markdown.mjs`.
+- It validates chunked sending behavior in real traffic.

package/README.zh_CN.md

@@ -309,3 +309,21 @@ openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
 openclaw config set plugins.entries.openclaw-weixin.enabled true
 openclaw gateway restart
 ```
+
+## 超长 Markdown 一键回归
+
+用于在真实链路下发送“超长 markdown 样例”（含链接/图片/代码块）：
+
+```bash
+npm run regression:long-markdown -- \
+  --base-url https://weixin-gateway.example.com \
+  --to o9cq809SI88YrRxbFQXu39Lf3Xu8@im.wechat \
+  --context-token <context_token> \
+  --token <token> \
+  --repeat 120 \
+  --timeout-ms 45000
+```
+
+说明：
+- 命令会先构建，再执行 `scripts/regression-long-markdown.mjs`。
+- 可用于验证分片发送在真实流量中的行为。

package/index.ts

@@ -4,6 +4,8 @@ import { buildChannelConfigSchema } from "ylib-openclaw/plugin-sdk";
 import { weixinPlugin } from "./src/channel.js";
 export { weixinPlugin } from "./src/channel.js";
 import { resolveWeixinAccount } from "./src/auth/accounts.js";
+import { getConfig, sendTyping } from "./src/api/api.js";
+import { TypingStatus } from "./src/api/types.js";
 import { assertHostCompatibility } from "./src/compat.js";
 import { WeixinConfigSchema } from "./src/config/config-schema.js";
 import {
@@ -45,7 +47,7 @@ export default {
       };
       const normalizeMockScope = (
         params: any,
-      ): { scopeType: "my_workspace" | "project"; projectId: string } => {
+      ): { scopeType: "workspace" | "my_workspace" | "project"; workspaceId: string; projectId: string } => {
         const rawScopeType = String(
           params?.scope_kind ||
             params?.scopeKind ||
@@ -55,16 +57,10 @@ export default {
         )
           .trim()
           .toLowerCase();
-        const rawProjectId = String(
-          params?.project_id || params?.projectId || "",
+        const workspaceId = String(
+          params?.workspace_id || params?.workspaceId || params?.project_id || params?.projectId || "",
         ).trim();
-        if (
-          (rawScopeType === "project" || (!rawScopeType && rawProjectId)) &&
-          rawProjectId
-        ) {
-          return { scopeType: "project", projectId: rawProjectId };
-        }
-        return { scopeType: "my_workspace", projectId: "" };
+        return { scopeType: "workspace", workspaceId, projectId: workspaceId };
       };
       const resolveMockTargetId = (params: any): string => {
         return String(
@@ -75,6 +71,7 @@ export default {
             "",
         ).trim();
       };
+      const TRIGGER_TYPING_KEEPALIVE_INTERVAL_MS = 5000;
 
       api.registerGatewayMethod(
         "weixin.loginWithQrStart",
@@ -359,39 +356,107 @@ export default {
 
             const senderId =
               String(params?.senderId || targetId).trim() || targetId;
-            void dispatchWeixinViaEndpoint({
-              cfg,
-              accountId: account.accountId,
-              ctx: {
-                Body: content,
-                From: senderId,
-                To: targetId,
-                AccountId: account.accountId,
-                OriginatingChannel: "openclaw-weixin",
-                OriginatingTo: targetId,
-                MessageSid: `mock_${Date.now()}_${Math.random().toString(36).slice(2)}`,
-                Timestamp: Date.now(),
-                Provider: "openclaw-weixin",
-                ChatType: "direct",
-              },
-              endpointConfig,
-              routeAgentId: resolvedAgentId,
-              baseUrl: account.baseUrl,
-              token: account.token,
-              cdnBaseUrl: account.cdnBaseUrl,
-            }).catch((err: unknown) => {
-              const errText = err instanceof Error ? err.message : String(err);
-              if (api.logger?.error) {
-                api.logger.error(
-                  `[Weixin][MockTrigger] async dispatch failed: ${errText}`,
-                );
-              } else {
-                // eslint-disable-next-line no-console -- fallback when runtime logger is unavailable
-                console.error(
-                  `[Weixin][MockTrigger] async dispatch failed: ${errText}`,
-                );
+            void (async () => {
+              let triggerTypingTicket = "";
+              let typingKeepaliveTimer: ReturnType<typeof setInterval> | null =
+                null;
+              let typingKeepaliveInFlight = false;
+              const sendTriggerTyping = async (status: number): Promise<void> => {
+                if (!triggerTypingTicket) return;
+                await sendTyping({
+                  baseUrl: account.baseUrl,
+                  token: account.token,
+                  body: {
+                    ilink_user_id: targetId,
+                    typing_ticket: triggerTypingTicket,
+                    status,
+                  },
+                });
+              };
+              try {
+                try {
+                  const cfgResp = await getConfig({
+                    baseUrl: account.baseUrl,
+                    token: account.token,
+                    ilinkUserId: targetId,
+                  });
+                  triggerTypingTicket = String(cfgResp?.typing_ticket || "").trim();
+                  if (triggerTypingTicket) {
+                    await sendTriggerTyping(TypingStatus.TYPING);
+                    typingKeepaliveTimer = setInterval(() => {
+                      if (typingKeepaliveInFlight) return;
+                      typingKeepaliveInFlight = true;
+                      void sendTriggerTyping(TypingStatus.TYPING)
+                        .catch((err) => {
+                          const errText =
+                            err instanceof Error ? err.message : String(err);
+                          api.logger?.warn?.(
+                            `[Weixin][MockTrigger] typing keepalive failed: ${errText}`,
+                          );
+                        })
+                        .finally(() => {
+                          typingKeepaliveInFlight = false;
+                        });
+                    }, TRIGGER_TYPING_KEEPALIVE_INTERVAL_MS);
+                  }
+                } catch (err) {
+                  const errText = err instanceof Error ? err.message : String(err);
+                  api.logger?.warn?.(
+                    `[Weixin][MockTrigger] typing start skipped: ${errText}`,
+                  );
+                }
+
+                await dispatchWeixinViaEndpoint({
+                  cfg,
+                  accountId: account.accountId,
+                  ctx: {
+                    Body: content,
+                    From: senderId,
+                    To: targetId,
+                    AccountId: account.accountId,
+                    OriginatingChannel: "openclaw-weixin",
+                    OriginatingTo: targetId,
+                    MessageSid: `mock_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+                    Timestamp: Date.now(),
+                    Provider: "openclaw-weixin",
+                    ChatType: "direct",
+                  },
+                  endpointConfig,
+                  routeAgentId: resolvedAgentId,
+                  baseUrl: account.baseUrl,
+                  token: account.token,
+                  cdnBaseUrl: account.cdnBaseUrl,
+                });
+              } catch (err: unknown) {
+                const errText = err instanceof Error ? err.message : String(err);
+                if (api.logger?.error) {
+                  api.logger.error(
+                    `[Weixin][MockTrigger] async dispatch failed: ${errText}`,
+                  );
+                } else {
+                  // eslint-disable-next-line no-console -- fallback when runtime logger is unavailable
+                  console.error(
+                    `[Weixin][MockTrigger] async dispatch failed: ${errText}`,
+                  );
+                }
+              } finally {
+                if (typingKeepaliveTimer) {
+                  clearInterval(typingKeepaliveTimer);
+                  typingKeepaliveTimer = null;
+                }
+                if (triggerTypingTicket) {
+                  try {
+                    await sendTriggerTyping(TypingStatus.CANCEL);
+                  } catch (err) {
+                    const errText =
+                      err instanceof Error ? err.message : String(err);
+                    api.logger?.warn?.(
+                      `[Weixin][MockTrigger] typing cancel failed: ${errText}`,
+                    );
+                  }
+                }
               }
-            });
+            })();
 
             return respond(true, {
               ok: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ylib-openclaw-weixin",
-  "version": "2.1.7-beta.9",
+  "version": "2.1.8",
   "description": "OpenClaw Weixin channel",
   "license": "MIT",
   "author": "Tencent",
@@ -10,6 +10,8 @@
     "!src/**/*.test.ts",
     "!src/**/node_modules/",
     "index.ts",
+    "schema.json",
+    "scripts/generate-schema.mjs",
     "openclaw.plugin.json",
     "README.md",
     "README.zh_CN.md",
@@ -19,12 +21,16 @@
   "scripts": {
     "test": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "build": "tsc"
+    "build": "tsc",
+    "regression:long-markdown": "npm run build && node ./scripts/regression-long-markdown.mjs",
+    "schema:generate": "node ./scripts/generate-schema.mjs",
+    "prepublishOnly": "npm run schema:generate"
   },
   "engines": {
     "node": ">=22"
   },
   "dependencies": {
+    "marked": "^15.0.12",
     "qrcode-terminal": "0.12.0",
     "zod": "4.3.6",
     "ylib-openclaw": "2026.3.9-beta.5"

package/schema.json

@@ -0,0 +1,205 @@
+{
+  "pluginId": "openclaw-weixin",
+  "channel": "weixin",
+  "rawSchema": {
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "type": "object",
+    "properties": {
+      "name": {
+        "type": "string"
+      },
+      "enabled": {
+        "type": "boolean"
+      },
+      "baseUrl": {
+        "default": "https://ilinkai.weixin.qq.com",
+        "type": "string"
+      },
+      "cdnBaseUrl": {
+        "default": "https://novac2c.cdn.weixin.qq.com/c2c",
+        "type": "string"
+      },
+      "routeTag": {
+        "type": "number"
+      },
+      "botToken": {
+        "type": "string"
+      },
+      "botId": {
+        "type": "string"
+      },
+      "modelName": {
+        "default": "main",
+        "type": "string"
+      },
+      "agentId": {
+        "default": "main",
+        "type": "string"
+      },
+      "gatewayBaseUrl": {
+        "type": "string"
+      },
+      "gatewayToken": {
+        "type": "string"
+      },
+      "uploadHost": {
+        "type": "string"
+      },
+      "showFinalAnswerOnly": {
+        "default": false,
+        "type": "boolean"
+      },
+      "scopeType": {
+        "default": "workspace",
+        "readOnly": true,
+        "type": "string"
+      },
+      "workspaceId": {
+        "default": "",
+        "readOnly": true,
+        "type": "string"
+      },
+      "projectId": {
+        "default": "",
+        "readOnly": true,
+        "type": "string"
+      },
+      "scope_kind": {
+        "readOnly": true,
+        "type": "string"
+      },
+      "scopeKind": {
+        "readOnly": true,
+        "type": "string"
+      },
+      "scope_type": {
+        "readOnly": true,
+        "type": "string"
+      },
+      "workspace_id": {
+        "readOnly": true,
+        "type": "string"
+      },
+      "project_id": {
+        "readOnly": true,
+        "type": "string"
+      },
+      "accounts": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string"
+        },
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "enabled": {
+              "type": "boolean"
+            },
+            "baseUrl": {
+              "default": "https://ilinkai.weixin.qq.com",
+              "type": "string"
+            },
+            "cdnBaseUrl": {
+              "default": "https://novac2c.cdn.weixin.qq.com/c2c",
+              "type": "string"
+            },
+            "routeTag": {
+              "type": "number"
+            },
+            "botToken": {
+              "type": "string"
+            },
+            "botId": {
+              "type": "string"
+            },
+            "modelName": {
+              "default": "main",
+              "type": "string"
+            },
+            "agentId": {
+              "default": "main",
+              "type": "string"
+            },
+            "gatewayBaseUrl": {
+              "type": "string"
+            },
+            "gatewayToken": {
+              "type": "string"
+            },
+            "uploadHost": {
+              "type": "string"
+            },
+            "showFinalAnswerOnly": {
+              "default": false,
+              "type": "boolean"
+            },
+            "scopeType": {
+              "default": "workspace",
+              "readOnly": true,
+              "type": "string"
+            },
+            "workspaceId": {
+              "default": "",
+              "readOnly": true,
+              "type": "string"
+            },
+            "projectId": {
+              "default": "",
+              "readOnly": true,
+              "type": "string"
+            },
+            "scope_kind": {
+              "readOnly": true,
+              "type": "string"
+            },
+            "scopeKind": {
+              "readOnly": true,
+              "type": "string"
+            },
+            "scope_type": {
+              "readOnly": true,
+              "type": "string"
+            },
+            "workspace_id": {
+              "readOnly": true,
+              "type": "string"
+            },
+            "project_id": {
+              "readOnly": true,
+              "type": "string"
+            }
+          },
+          "required": [
+            "baseUrl",
+            "cdnBaseUrl",
+            "modelName",
+            "agentId",
+            "showFinalAnswerOnly",
+            "scopeType",
+            "workspaceId",
+            "projectId"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "channelConfigUpdatedAt": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "baseUrl",
+      "cdnBaseUrl",
+      "modelName",
+      "agentId",
+      "showFinalAnswerOnly",
+      "scopeType",
+      "workspaceId",
+      "projectId"
+    ],
+    "additionalProperties": false
+  },
+  "schemaVersion": 1
+}

package/scripts/generate-schema.mjs

@@ -0,0 +1,30 @@
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const entryPath = path.join(root, "dist", "index.js");
+const outputPath = path.join(root, "schema.json");
+
+if (!fs.existsSync(entryPath)) {
+  throw new Error("dist/index.js not found, run build first");
+}
+
+const mod = await import(pathToFileURL(entryPath).href);
+const plugin = mod.default;
+const rawSchema = plugin?.configSchema?.schema;
+if (!rawSchema || typeof rawSchema !== "object" || Array.isArray(rawSchema)) {
+  throw new Error("failed to resolve weixin plugin raw schema from dist/index.js");
+}
+
+const payload = {
+  pluginId: "openclaw-weixin",
+  channel: "weixin",
+  rawSchema,
+  schemaVersion: 1,
+  // generatedAt: new Date().toISOString(),
+};
+
+fs.writeFileSync(outputPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+console.log(`[schema] generated ${outputPath}`);

package/src/api/api.ts

@@ -134,7 +134,6 @@ function buildHeaders(opts: {
   const headers: Record<string, string> = {
     "Content-Type": "application/json",
     AuthorizationType: "ilink_bot_token",
-    "Content-Length": String(Buffer.byteLength(opts.body, "utf-8")),
     "X-WECHAT-UIN": randomWechatUin(),
     ...buildCommonHeaders(),
   };
@@ -274,6 +273,7 @@ async function apiPostFetch(params: {
     }
     return rawText;
   } catch (err) {
+    console.error(`Error in ${params.label}:`, err);
     clearTimeout(t);
     if (params.abortSignal) {
       params.abortSignal.removeEventListener("abort", onExternalAbort);

package/src/cdn/upload.ts

@@ -11,6 +11,8 @@ import { getExtensionFromContentTypeOrUrl } from "../media/mime.js";
 import { tempFileName } from "../util/random.js";
 import { UploadMediaType } from "../api/types.js";
 
+const DOWNLOAD_TEMP_WRITE_MAX_RETRIES = 8;
+
 export type UploadedFileInfo = {
   filekey: string;
   /** 由 upload_param 上传后 CDN 返回的下载加密参数; fill into ImageItem.media.encrypt_query_param */
@@ -23,15 +25,21 @@ export type UploadedFileInfo = {
   fileSizeCiphertext: number;
 };
 
+export type DownloadedRemoteTempFile = {
+  filePath: string;
+  contentDisposition?: string;
+  contentType?: string;
+};
+
 /**
  * Download a remote media URL (image, video, file) to a local temp file in destDir.
  * Returns the local file path; extension is inferred from Content-Type / URL.
  */
-export async function downloadRemoteImageToTemp(
+export async function downloadRemoteImageToTempWithMeta(
   url: string,
   destDir: string,
   opts?: { gatewayToken?: string },
-): Promise<string> {
+): Promise<DownloadedRemoteTempFile> {
   logger.debug(`downloadRemoteImageToTemp: fetching url=${url}`);
   const gatewayToken = opts?.gatewayToken?.trim();
   const fetchInit: RequestInit | undefined = gatewayToken
@@ -47,11 +55,45 @@ export async function downloadRemoteImageToTemp(
   logger.debug(`downloadRemoteImageToTemp: downloaded ${buf.length} bytes`);
   await fs.mkdir(destDir, { recursive: true });
   const ext = getExtensionFromContentTypeOrUrl(res.headers.get("content-type"), url);
-  const name = tempFileName("weixin-remote", ext);
-  const filePath = path.join(destDir, name);
-  await fs.writeFile(filePath, buf);
-  logger.debug(`downloadRemoteImageToTemp: saved to ${filePath} ext=${ext}`);
-  return filePath;
+  let lastErr: unknown;
+  for (let i = 0; i < DOWNLOAD_TEMP_WRITE_MAX_RETRIES; i += 1) {
+    const name = tempFileName("weixin-remote", ext);
+    const filePath = path.join(destDir, name);
+    try {
+      const fd = await fs.open(filePath, "wx");
+      try {
+        await fd.writeFile(buf);
+      } finally {
+        await fd.close();
+      }
+      logger.debug(`downloadRemoteImageToTemp: saved to ${filePath} ext=${ext}`);
+      return {
+        filePath,
+        contentDisposition: res.headers.get("content-disposition") ?? undefined,
+        contentType: res.headers.get("content-type") ?? undefined,
+      };
+    } catch (err) {
+      lastErr = err;
+      const code = (err as NodeJS.ErrnoException)?.code;
+      if (code !== "EEXIST") {
+        throw err;
+      }
+      logger.warn(
+        `downloadRemoteImageToTemp: temp file name conflict, retry=${i + 1}/${DOWNLOAD_TEMP_WRITE_MAX_RETRIES} url=${url}`,
+      );
+    }
+  }
+  throw new Error(
+    `downloadRemoteImageToTemp: failed to persist temp file after ${DOWNLOAD_TEMP_WRITE_MAX_RETRIES} retries url=${url} err=${String(lastErr)}`,
+  );
+}
+
+export async function downloadRemoteImageToTemp(
+  url: string,
+  destDir: string,
+  opts?: { gatewayToken?: string },
+): Promise<string> {
+  return (await downloadRemoteImageToTempWithMeta(url, destDir, opts)).filePath;
 }
 
 /**

package/src/config/config-schema.ts

@@ -22,16 +22,23 @@ const weixinAccountSchema = z.object({
   gatewayBaseUrl: z.string().optional(),
   gatewayToken: z.string().optional(),
   uploadHost: z.string().optional(),
+  /**
+   * 默认关闭以保持历史输出；开启后普通 content、sub-agent 过程文本和资源过程产物不展示，
+   * 但 error 与主流程确认兜底仍会展示，避免失败信息丢失或确认流程卡住。
+   */
+  showFinalAnswerOnly: z.boolean().optional().default(false),
   /** Runtime readonly scope fields injected by backend. */
   scopeType: z
     .string()
     .optional()
-    .default("my_workspace")
+    .default("workspace")
     .meta({ readOnly: true }),
+  workspaceId: z.string().optional().default("").meta({ readOnly: true }),
   projectId: z.string().optional().default("").meta({ readOnly: true }),
   scope_kind: z.string().optional().meta({ readOnly: true }),
   scopeKind: z.string().optional().meta({ readOnly: true }),
   scope_type: z.string().optional().meta({ readOnly: true }),
+  workspace_id: z.string().optional().meta({ readOnly: true }),
   project_id: z.string().optional().meta({ readOnly: true }),
 });
 

package/src/media/media-download.ts

@@ -39,7 +39,14 @@ export async function downloadMediaFromItem(
 
   if (item.type === MessageItemType.IMAGE) {
     const img = item.image_item;
-    if (!img?.media?.encrypt_query_param && !img?.media?.full_url) return result;
+    if (!img?.media?.encrypt_query_param && !img?.media?.full_url) {
+      logger.warn(
+        `${label} image skipped: missing media.encrypt_query_param/full_url hasImageItem=${Boolean(
+          img,
+        )} hasMedia=${Boolean(img?.media)} hasUrlOnly=${Boolean(img?.url)}`,
+      );
+      return result;
+    }
     const aesKeyBase64 = img.aeskey
       ? Buffer.from(img.aeskey, "hex").toString("base64")
       : img.media.aes_key;
@@ -119,6 +126,7 @@ export async function downloadMediaFromItem(
       );
       result.decryptedFilePath = saved.path;
       result.fileMediaType = mime;
+      result.fileName = fileItem.file_name ?? undefined;
       logger.debug(`${label} file: saved to ${saved.path} mime=${mime}`);
     } catch (err) {
       logger.error(`${label} file download failed: ${String(err)}`);