csdn-im 0.1.4 → 0.1.6

package/dist/index.cjs

@@ -4078,10 +4078,12 @@ var NEVER = INVALID;
 
 // src/config.ts
 var CSDN_PLUGIN_ID = "csdn-im";
+var CSDN_LOG_TAG = "[csdn-im]";
 var FIXED_LONG_POLLING_TIMEOUT_SEC = 30;
 var FIXED_TAKE = 1;
 var FIXED_RETRY_INTERVAL_MS = 3e3;
 var FIXED_RETRY_BACKOFF_MAX_MS = 12e4;
+var MAX_POLL_INTERVAL_MS = 6e5;
 function getCsdnChannelObjectFromRoot(cfg) {
   return cfg?.channels?.[CSDN_PLUGIN_ID];
 }
@@ -4101,7 +4103,12 @@ var CsdnConfigSchema = external_exports.object({
   /**
    * 为 true 时打印完整消息体、HTTP 拉取/发送细节、路由与分发路径等调试日志。
    */
-  verbose: external_exports.boolean().default(false)
+  verbose: external_exports.boolean().default(false),
+  /**
+   * 两次成功拉取（poll end → 下一次 poll begin）之间的额外间隔（毫秒）。
+   * `0` 表示仅让出事件循环后立即下一轮（历史默认行为）；设为 `1000` 等可减轻对服务端的请求频率。
+   */
+  pollIntervalMs: external_exports.number().min(0).max(MAX_POLL_INTERVAL_MS).default(0)
 });
 function clampLongPollingSeconds(n) {
   if (!Number.isFinite(n) || n < 1) return 30;
@@ -4114,6 +4121,10 @@ function clampTake(n) {
 function normalizeApiBaseUrl(url) {
   return url.replace(/\/+$/, "");
 }
+function clampPollIntervalMs(n) {
+  if (!Number.isFinite(n) || n < 0) return 0;
+  return Math.min(MAX_POLL_INTERVAL_MS, Math.floor(n));
+}
 function isConfigured(config) {
   if (!config) return false;
   const parsed = CsdnConfigSchema.safeParse(config);
@@ -4204,6 +4215,9 @@ function joinBaseAndPath(base, path) {
 function isAbortError(e) {
   return e instanceof Error && e.name === "AbortError" || typeof DOMException !== "undefined" && e instanceof DOMException && e.name === "AbortError";
 }
+function pullErrorLog(baseUrl, detail) {
+  console.error(`${CSDN_LOG_TAG} pull GET ${PATH_UNREAD} base=${baseUrl} \u2014 ${detail}`);
+}
 var CsdnClient = class {
   constructor(config) {
     this.config = config;
@@ -4233,7 +4247,7 @@ var CsdnClient = class {
     try {
       if (this.config.verbose) {
         console.info(
-          `[csdn] pull GET ${PATH_UNREAD} base=${this.baseUrl} timeout=${sec}s take=${take}${cursor ? ` afterMessageId=${cursor}` : ""}`
+          `${CSDN_LOG_TAG} pull GET ${PATH_UNREAD} base=${this.baseUrl} timeout=${sec}s take=${take}${cursor ? ` afterMessageId=${cursor}` : ""}`
         );
       }
       const response = await fetch(unreadUrl.href, {
@@ -4251,31 +4265,42 @@ var CsdnClient = class {
       if (fromResult !== null) {
         if (this.config.verbose) {
           console.info(
-            `[csdn] pull response ok code=0 messages=${fromResult.length} httpStatus=${response.status}`
+            `${CSDN_LOG_TAG} pull response ok code=0 messages=${fromResult.length} httpStatus=${response.status}`
           );
         }
         return fromResult;
       }
+      if (response.status === 408 || response.status === 504) {
+        console.warn(
+          `${CSDN_LOG_TAG} pull GET ${PATH_UNREAD} base=${this.baseUrl} httpStatus=${response.status} (timeout/\u7F51\u5173\u8D85\u65F6\uFF0C\u672C\u8F6E\u6309\u7A7A\u7ED3\u679C\u5904\u7406)`
+        );
+        return [];
+      }
       const fail = getBotApiFailureInfo(body);
       if (fail) {
-        if (fail.code === "401") {
-          console.warn(`[csdn] getUnreadMessages: ${fail.message || "Token\u65E0\u6548\u6216\u5DF2\u8FC7\u671F"} (code=${fail.code})`);
-        } else {
-          console.warn(`[csdn] getUnreadMessages: ${fail.message} (code=${fail.code})`);
+        pullErrorLog(
+          this.baseUrl,
+          `business failure httpStatus=${response.status} code=${fail.code} message=${fail.message || "(empty)"}`
+        );
+        if (response.ok) {
+          return [];
         }
       }
       const legacy = tryLegacyUnreadMessages(body);
       if (legacy) {
         console.warn(
-          `[csdn] using legacy unread response format; prefer ClawBot Result with code "0" messages=${legacy.length}`
+          `${CSDN_LOG_TAG} using legacy unread response format; prefer ClawBot Result with code "0" messages=${legacy.length}`
         );
         return legacy;
       }
       if (body !== void 0 && body !== null) {
-        console.warn("[csdn] unexpected response format:", JSON.stringify(body).substring(0, 200));
+        pullErrorLog(this.baseUrl, `unexpected response format httpStatus=${response.status} body=${JSON.stringify(body).substring(0, 200)}`);
       }
-      if (response.status === 408 || response.status === 504) {
-        return [];
+      if (!response.ok) {
+        const hint = body !== void 0 && body !== null ? (typeof body === "string" ? body : JSON.stringify(body)).slice(0, 200) : "";
+        const detail = `HTTP ${response.status}${hint ? ` body=${hint}` : ""}`;
+        pullErrorLog(this.baseUrl, detail);
+        throw new Error(`${CSDN_LOG_TAG} GET ${PATH_UNREAD} failed: ${detail}`);
       }
       return [];
     } catch (error) {
@@ -4286,7 +4311,9 @@ var CsdnClient = class {
         return [];
       }
       const msg = error instanceof Error ? error.message : String(error);
-      console.error(`[csdn] getUnreadMessages failed: ${msg}`);
+      if (!(error instanceof Error && msg.startsWith(`${CSDN_LOG_TAG} GET`))) {
+        pullErrorLog(this.baseUrl, `request error: ${msg}`);
+      }
       throw error instanceof Error ? error : new Error(msg);
     }
   }
@@ -4299,7 +4326,7 @@ var CsdnClient = class {
     try {
       if (this.config.verbose) {
         console.info(
-          `[csdn] send POST ${PATH_SEND} to=${to} contentLength=${content.length}${opts?.type ? ` type=${opts.type}` : ""}`
+          `${CSDN_LOG_TAG} send POST ${PATH_SEND} to=${to} contentLength=${content.length}${opts?.type ? ` type=${opts.type}` : ""}`
         );
       }
       const response = await fetch(sendUrl, {
@@ -4318,19 +4345,22 @@ var CsdnClient = class {
       if (ok) {
         if (this.config.verbose) {
           console.info(
-            `[csdn] send response ok code=0 id=${ok.id} httpStatus=${response.status}${ok.timestamp != null ? ` timestamp=${ok.timestamp}` : ""}`
+            `${CSDN_LOG_TAG} send response ok code=0 id=${ok.id} httpStatus=${response.status}${ok.timestamp != null ? ` timestamp=${ok.timestamp}` : ""}`
           );
         }
         return ok;
       }
       const fail = getBotApiFailureInfo(body);
       const hint = fail ? `${fail.message} (code=${fail.code})` : `HTTP ${response.status}`;
-      throw new Error(`[csdn] sendMessage failed: ${hint}`);
+      console.error(
+        `${CSDN_LOG_TAG} send POST ${PATH_SEND} base=${this.baseUrl} httpStatus=${response.status} ${hint}`
+      );
+      throw new Error(`${CSDN_LOG_TAG} sendMessage failed: ${hint}`);
     } catch (error) {
-      if (error instanceof Error && error.message.startsWith("[csdn] sendMessage failed:")) {
+      if (error instanceof Error && error.message.startsWith(`${CSDN_LOG_TAG} sendMessage failed:`)) {
         throw error;
       }
-      console.error("[csdn] sendMessage failed:", error);
+      console.error(`${CSDN_LOG_TAG} send POST ${PATH_SEND} base=${this.baseUrl} request error:`, error);
       throw error;
     }
   }
@@ -4472,31 +4502,62 @@ function findRequireAnchorPackageJson() {
     dir = parent;
   }
   throw new Error(
-    "[csdn] loadOpenclawPluginSdk: no package.json found walking up from process.cwd(); cannot createRequire for openclaw fallback"
+    `${CSDN_LOG_TAG} loadOpenclawPluginSdk: no package.json found walking up from process.cwd(); cannot createRequire for openclaw fallback`
   );
 }
+var OPENCLAW_SEARCH_ROOTS = [
+  process.cwd(),
+  (0, import_node_path.join)(process.cwd(), ".."),
+  (0, import_node_path.join)(process.cwd(), "..", ".."),
+  (0, import_node_path.join)(process.cwd(), "packages", "csdn"),
+  (0, import_node_path.join)(process.cwd(), "..", "packages", "csdn")
+];
+async function importOpenclawPluginSdkFromDisk() {
+  const require2 = (0, import_node_module.createRequire)(findRequireAnchorPackageJson());
+  for (const root of OPENCLAW_SEARCH_ROOTS) {
+    try {
+      const mainEntry = require2.resolve("openclaw", { paths: [root] });
+      const pkgRoot = (0, import_node_path.join)((0, import_node_path.dirname)(mainEntry), "..");
+      const sdkEntry = (0, import_node_path.join)(pkgRoot, "dist", "plugin-sdk", "index.js");
+      return await import((0, import_node_url.pathToFileURL)(sdkEntry).href);
+    } catch {
+    }
+  }
+  throw new Error(`${CSDN_LOG_TAG} could not resolve openclaw from disk`);
+}
+async function importOpenclawReplyRuntimeFromDisk() {
+  const require2 = (0, import_node_module.createRequire)(findRequireAnchorPackageJson());
+  for (const root of OPENCLAW_SEARCH_ROOTS) {
+    try {
+      const mainEntry = require2.resolve("openclaw", { paths: [root] });
+      const pkgRoot = (0, import_node_path.join)((0, import_node_path.dirname)(mainEntry), "..");
+      const entry = (0, import_node_path.join)(pkgRoot, "dist", "plugin-sdk", "reply-runtime.js");
+      return await import((0, import_node_url.pathToFileURL)(entry).href);
+    } catch {
+    }
+  }
+  throw new Error(`${CSDN_LOG_TAG} could not resolve openclaw reply-runtime from disk`);
+}
+async function loadOpenclawReplyRuntime() {
+  try {
+    return await import("openclaw/plugin-sdk/reply-runtime");
+  } catch (first) {
+    try {
+      return await importOpenclawReplyRuntimeFromDisk();
+    } catch {
+      throw first;
+    }
+  }
+}
 async function loadOpenclawPluginSdk() {
   try {
     return await import("openclaw/plugin-sdk");
   } catch (first) {
-    const require2 = (0, import_node_module.createRequire)(findRequireAnchorPackageJson());
-    const searchRoots = [
-      process.cwd(),
-      (0, import_node_path.join)(process.cwd(), ".."),
-      (0, import_node_path.join)(process.cwd(), "..", ".."),
-      (0, import_node_path.join)(process.cwd(), "packages", "csdn"),
-      (0, import_node_path.join)(process.cwd(), "..", "packages", "csdn")
-    ];
-    for (const root of searchRoots) {
-      try {
-        const mainEntry = require2.resolve("openclaw", { paths: [root] });
-        const pkgRoot = (0, import_node_path.join)((0, import_node_path.dirname)(mainEntry), "..");
-        const sdkEntry = (0, import_node_path.join)(pkgRoot, "dist", "plugin-sdk", "index.js");
-        return await import((0, import_node_url.pathToFileURL)(sdkEntry).href);
-      } catch {
-      }
+    try {
+      return await importOpenclawPluginSdkFromDisk();
+    } catch {
+      throw first;
     }
-    throw first;
   }
 }
 
@@ -4507,12 +4568,12 @@ var csdnOutbound = {
     const csdnCfgRaw = getCsdnChannelObjectFromRoot(cfg);
     const parsed = CsdnConfigSchema.safeParse(csdnCfgRaw);
     if (!parsed.success) {
-      throw new Error("[csdn] invalid config for outbound");
+      throw new Error(`${CSDN_LOG_TAG} invalid config for outbound`);
     }
     const client = new CsdnClient(parsed.data);
     const result = await client.sendMessage(to, text);
     if (parsed.data.verbose) {
-      console.info(`[csdn] outbound sent messageId=${result.id} to=${to} textLength=${text.length}`);
+      console.info(`${CSDN_LOG_TAG} outbound sent messageId=${result.id} to=${to} textLength=${text.length}`);
     }
     return {
       channel: CSDN_PLUGIN_ID,
@@ -4576,14 +4637,14 @@ function logRoutingFallbackOnce(log) {
   if (routingFallbackLogged) return;
   routingFallbackLogged = true;
   log(
-    "[csdn] host runtime.channel.routing.resolveAgentRoute unavailable \u2192 embedded session key (normal for some gateways; once per process)"
+    "host runtime.channel.routing.resolveAgentRoute unavailable \u2192 embedded session key (normal for some gateways; once per process)"
   );
 }
 function logDispatchFallbackOnce(log) {
   if (dispatchFallbackLogged) return;
   dispatchFallbackLogged = true;
   log(
-    "[csdn] host runtime.channel.reply.dispatchReplyFromConfig unavailable \u2192 openclaw/plugin-sdk (normal for some gateways; once per process)"
+    "host runtime.channel.reply.dispatchReplyFromConfig unavailable \u2192 openclaw/plugin-sdk (normal for some gateways; once per process)"
   );
 }
 
@@ -4626,7 +4687,7 @@ async function handleCsdnMessage(params) {
   }
   if (usedEmbeddedRoute && verbose) {
     try {
-      logger.info(`[csdn] route.fallback sessionKey=${route.sessionKey} accountId=${route.accountId ?? accountId}`);
+      logger.info(`route.fallback sessionKey=${route.sessionKey} accountId=${route.accountId ?? accountId}`);
     } catch {
     }
   }
@@ -4651,7 +4712,7 @@ async function handleCsdnMessage(params) {
   };
   if (verbose) {
     try {
-      logger.info(`[csdn] inbound.content ${inboundCtx.Body}`);
+      logger.info(`inbound.content ${inboundCtx.Body}`);
     } catch {
     }
   }
@@ -4663,10 +4724,10 @@ async function handleCsdnMessage(params) {
       if (!text) return;
       try {
         if (verbose) {
-          logger.info(`[csdn] outbound text to=${msg.from} len=${text.length}`);
-          logger.info(`[csdn] outbound.content ${text}`);
+          logger.info(`outbound text to=${msg.from} len=${text.length}`);
+          logger.info(`outbound.content ${text}`);
         } else {
-          logger.info(`[csdn] reply to=${msg.from} len=${text.length}`);
+          logger.info(`reply to=${msg.from} len=${text.length}`);
         }
         await csdnOutbound.sendText({
           cfg: config,
@@ -4674,21 +4735,21 @@ async function handleCsdnMessage(params) {
           text
         });
         if (verbose) {
-          logger.info(`[csdn] outbound done to=${msg.from}`);
+          logger.info(`outbound done to=${msg.from}`);
         }
       } catch (err) {
-        logger.error(`[csdn] failed to send reply: ${String(err)}`);
+        logger.error(`failed to send reply: ${String(err)}`);
       }
     },
     onError: (err, info) => {
-      logger.error(`[csdn] reply dispatch kind=${info.kind} error: ${String(err)}`);
+      logger.error(`reply dispatch kind=${info.kind} error: ${String(err)}`);
     }
   });
   const dispatchFromRuntime = runtime?.channel?.reply?.dispatchReplyFromConfig;
   const runDispatch = async () => {
     if (typeof dispatchFromRuntime === "function") {
       if (verbose) {
-        logger.info(`[csdn] dispatching via runtime.channel.reply session=${route.sessionKey}`);
+        logger.info(`dispatching via runtime.channel.reply session=${route.sessionKey}`);
       }
       await dispatchFromRuntime({
         ctx: inboundCtx,
@@ -4699,12 +4760,35 @@ async function handleCsdnMessage(params) {
       return;
     }
     logDispatchFallbackOnce((m) => logger.info(m));
+    let replyRuntime;
+    try {
+      replyRuntime = await loadOpenclawReplyRuntime();
+    } catch {
+      replyRuntime = void 0;
+    }
+    if (replyRuntime && typeof replyRuntime.dispatchInboundMessage === "function") {
+      try {
+        if (verbose) {
+          logger.info(`dispatching via plugin-sdk/reply-runtime session=${route.sessionKey}`);
+        }
+        await replyRuntime.dispatchInboundMessage({
+          ctx: inboundCtx,
+          cfg: config,
+          dispatcher,
+          replyOptions: {}
+        });
+        return;
+      } catch (err) {
+        logger.error(`plugin-sdk/reply-runtime dispatch failed: ${String(err)}`);
+        throw err;
+      }
+    }
     try {
       const sdk = await loadOpenclawPluginSdk();
       const withSettled = sdk.dispatchReplyFromConfigWithSettledDispatcher;
       const plain = sdk.dispatchReplyFromConfig;
       if (verbose) {
-        logger.info(`[csdn] dispatching via plugin-sdk session=${route.sessionKey}`);
+        logger.info(`dispatching via plugin-sdk (legacy barrel) session=${route.sessionKey}`);
       }
       if (typeof withSettled === "function") {
         await withSettled({
@@ -4724,28 +4808,28 @@ async function handleCsdnMessage(params) {
         });
       } else {
         throw new Error(
-          "openclaw/plugin-sdk: neither dispatchReplyFromConfigWithSettledDispatcher nor dispatchReplyFromConfig is exported"
+          "openclaw: no channel dispatch API (need plugin-sdk/reply-runtime.dispatchInboundMessage or legacy dispatchReplyFromConfig on plugin-sdk barrel)"
         );
       }
     } catch (err) {
-      logger.error(`[csdn] plugin-sdk dispatch unavailable: ${String(err)}`);
+      logger.error(`plugin-sdk dispatch unavailable: ${String(err)}`);
       throw err;
     }
   };
   try {
     await runDispatch();
     if (verbose) {
-      logger.info(`[csdn] dispatch complete session=${route.sessionKey}`);
+      logger.info(`dispatch complete session=${route.sessionKey}`);
     }
   } catch (err) {
-    logger.error(`[csdn] dispatch error: ${String(err)}`);
+    logger.error(`dispatch error: ${String(err)}`);
     try {
       const echo = `\u5DF2\u6536\u5230\uFF1A${inboundCtx.Body}`;
       if (verbose) {
-        logger.info(`[csdn] outbound text(to=${msg.from}) via fallback len=${echo.length}`);
-        logger.info(`[csdn] outbound.content ${echo}`);
+        logger.info(`outbound text(to=${msg.from}) via fallback len=${echo.length}`);
+        logger.info(`outbound.content ${echo}`);
       } else {
-        logger.info(`[csdn] echo fallback to=${msg.from} len=${echo.length}`);
+        logger.info(`echo fallback to=${msg.from} len=${echo.length}`);
       }
       await csdnOutbound.sendText({
         cfg: config,
@@ -4753,10 +4837,10 @@ async function handleCsdnMessage(params) {
         text: echo
       });
       if (verbose) {
-        logger.info(`[csdn] outbound done to=${msg.from} (fallback)`);
+        logger.info(`outbound done to=${msg.from} (fallback)`);
       }
     } catch (sendErr) {
-      logger.error(`[csdn] fallback reply failed: ${String(sendErr)}`);
+      logger.error(`fallback reply failed: ${String(sendErr)}`);
     }
   }
 }
@@ -4769,6 +4853,26 @@ function maxMessageId(messages) {
   }
   return max;
 }
+function sleepBetweenPolls(ms, signal) {
+  if (ms <= 0) {
+    return new Promise((resolve) => setImmediate(resolve));
+  }
+  return new Promise((resolve) => {
+    if (signal?.aborted) {
+      resolve();
+      return;
+    }
+    const t = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(t);
+        resolve();
+      },
+      { once: true }
+    );
+  });
+}
 async function monitorCsdnProvider(opts) {
   const { config, runtime, accountId = "default", abortSignal } = opts;
   const baseLogger = runtime && (runtime.logger || runtime.log) || console;
@@ -4780,18 +4884,19 @@ async function monitorCsdnProvider(opts) {
   const csdnCfgRaw = getCsdnChannelObjectFromRoot(config);
   const parsed = CsdnConfigSchema.safeParse(csdnCfgRaw);
   if (!parsed.success) {
-    logger.error(`[csdn] invalid config for account ${accountId}: ${parsed.error}`);
+    logger.error(`invalid config for account ${accountId}: ${parsed.error}`);
     return;
   }
   const csdnCfg = parsed.data;
   if (!csdnCfg.token) {
-    logger.warn(`[csdn] token missing; skip start for account ${accountId}`);
+    logger.warn(`token missing; skip start for account ${accountId}`);
     return;
   }
   const client = new CsdnClient(csdnCfg);
+  const pollIntervalMs = clampPollIntervalMs(csdnCfg.pollIntervalMs);
   const v = csdnCfg.verbose;
   logger.info(
-    `[csdn] starting long-polling account=${accountId} apiUrl=${csdnCfg.apiUrl} timeout=${FIXED_LONG_POLLING_TIMEOUT_SEC}s take=${FIXED_TAKE}`
+    `starting long-polling account=${accountId} apiUrl=${csdnCfg.apiUrl} timeout=${FIXED_LONG_POLLING_TIMEOUT_SEC}s take=${FIXED_TAKE} pollIntervalMs=${pollIntervalMs}`
   );
   let backoffMs = FIXED_RETRY_INTERVAL_MS;
   const backoffCap = Math.max(FIXED_RETRY_INTERVAL_MS, FIXED_RETRY_BACKOFF_MAX_MS);
@@ -4801,9 +4906,6 @@ async function monitorCsdnProvider(opts) {
       try {
         const t0 = Date.now();
         if (v) {
-          logger.info(
-            `[csdn] poll begin account=${accountId} timeout=${FIXED_LONG_POLLING_TIMEOUT_SEC}s take=${FIXED_TAKE}${afterMessageId ? ` afterMessageId=${afterMessageId}` : ""}`
-          );
         }
         const messages = await client.getUnreadMessages(FIXED_LONG_POLLING_TIMEOUT_SEC, {
           afterMessageId,
@@ -4811,12 +4913,11 @@ async function monitorCsdnProvider(opts) {
         });
         backoffMs = FIXED_RETRY_INTERVAL_MS;
         const dur = Date.now() - t0;
-        logger.info(`[csdn] poll end account=${accountId} duration=${dur}ms count=${messages.length}`);
         for (const msg of messages) {
-          logger.info(`[csdn] inbound id=${msg.id} from=${msg.from} type=${msg.type} size=${msg.content?.length ?? 0}`);
+          logger.info(`inbound id=${msg.id} from=${msg.from} type=${msg.type} size=${msg.content?.length ?? 0}`);
           if (v) {
             try {
-              logger.info(`[csdn] inbound.full ${JSON.stringify(msg)}`);
+              logger.info(`inbound.full ${JSON.stringify(msg)}`);
             } catch {
             }
           }
@@ -4830,17 +4931,17 @@ async function monitorCsdnProvider(opts) {
         if (messages.length > 0) {
           afterMessageId = maxMessageId(messages);
         }
-        await new Promise((resolve) => setImmediate(resolve));
+        await sleepBetweenPolls(pollIntervalMs, abortSignal);
       } catch (err) {
-        logger.error(`[csdn] polling error: ${err}`);
+        logger.error(`polling error: ${err}`);
         logger.info(
-          `[csdn] waiting ${backoffMs}ms before retry (exponential backoff, cap=${backoffCap}ms)...`
+          `waiting ${backoffMs}ms before retry (exponential backoff, cap=${backoffCap}ms)...`
         );
         await new Promise((resolve) => setTimeout(resolve, backoffMs));
         backoffMs = Math.min(backoffCap, Math.max(FIXED_RETRY_INTERVAL_MS, backoffMs * 2));
       }
     }
-    logger.info(`[csdn] polling stopped for account ${accountId}`);
+    logger.info(`polling stopped for account ${accountId}`);
   };
   return pollLoop();
 }
@@ -4903,7 +5004,8 @@ var csdnPlugin = {
         token: { type: "string" },
         apiUrl: { type: "string" },
         fallbackAgentId: { type: "string" },
-        verbose: { type: "boolean" }
+        verbose: { type: "boolean" },
+        pollIntervalMs: { type: "number", minimum: 0, maximum: 6e5 }
       }
     }
   },

package/dist/index.js

@@ -4047,10 +4047,12 @@ var NEVER = INVALID;
 
 // src/config.ts
 var CSDN_PLUGIN_ID = "csdn-im";
+var CSDN_LOG_TAG = "[csdn-im]";
 var FIXED_LONG_POLLING_TIMEOUT_SEC = 30;
 var FIXED_TAKE = 1;
 var FIXED_RETRY_INTERVAL_MS = 3e3;
 var FIXED_RETRY_BACKOFF_MAX_MS = 12e4;
+var MAX_POLL_INTERVAL_MS = 6e5;
 function getCsdnChannelObjectFromRoot(cfg) {
   return cfg?.channels?.[CSDN_PLUGIN_ID];
 }
@@ -4070,7 +4072,12 @@ var CsdnConfigSchema = external_exports.object({
   /**
    * 为 true 时打印完整消息体、HTTP 拉取/发送细节、路由与分发路径等调试日志。
    */
-  verbose: external_exports.boolean().default(false)
+  verbose: external_exports.boolean().default(false),
+  /**
+   * 两次成功拉取（poll end → 下一次 poll begin）之间的额外间隔（毫秒）。
+   * `0` 表示仅让出事件循环后立即下一轮（历史默认行为）；设为 `1000` 等可减轻对服务端的请求频率。
+   */
+  pollIntervalMs: external_exports.number().min(0).max(MAX_POLL_INTERVAL_MS).default(0)
 });
 function clampLongPollingSeconds(n) {
   if (!Number.isFinite(n) || n < 1) return 30;
@@ -4083,6 +4090,10 @@ function clampTake(n) {
 function normalizeApiBaseUrl(url) {
   return url.replace(/\/+$/, "");
 }
+function clampPollIntervalMs(n) {
+  if (!Number.isFinite(n) || n < 0) return 0;
+  return Math.min(MAX_POLL_INTERVAL_MS, Math.floor(n));
+}
 function isConfigured(config) {
   if (!config) return false;
   const parsed = CsdnConfigSchema.safeParse(config);
@@ -4173,6 +4184,9 @@ function joinBaseAndPath(base, path) {
 function isAbortError(e) {
   return e instanceof Error && e.name === "AbortError" || typeof DOMException !== "undefined" && e instanceof DOMException && e.name === "AbortError";
 }
+function pullErrorLog(baseUrl, detail) {
+  console.error(`${CSDN_LOG_TAG} pull GET ${PATH_UNREAD} base=${baseUrl} \u2014 ${detail}`);
+}
 var CsdnClient = class {
   constructor(config) {
     this.config = config;
@@ -4202,7 +4216,7 @@ var CsdnClient = class {
     try {
       if (this.config.verbose) {
         console.info(
-          `[csdn] pull GET ${PATH_UNREAD} base=${this.baseUrl} timeout=${sec}s take=${take}${cursor ? ` afterMessageId=${cursor}` : ""}`
+          `${CSDN_LOG_TAG} pull GET ${PATH_UNREAD} base=${this.baseUrl} timeout=${sec}s take=${take}${cursor ? ` afterMessageId=${cursor}` : ""}`
         );
       }
       const response = await fetch(unreadUrl.href, {
@@ -4220,31 +4234,42 @@ var CsdnClient = class {
       if (fromResult !== null) {
         if (this.config.verbose) {
           console.info(
-            `[csdn] pull response ok code=0 messages=${fromResult.length} httpStatus=${response.status}`
+            `${CSDN_LOG_TAG} pull response ok code=0 messages=${fromResult.length} httpStatus=${response.status}`
           );
         }
         return fromResult;
       }
+      if (response.status === 408 || response.status === 504) {
+        console.warn(
+          `${CSDN_LOG_TAG} pull GET ${PATH_UNREAD} base=${this.baseUrl} httpStatus=${response.status} (timeout/\u7F51\u5173\u8D85\u65F6\uFF0C\u672C\u8F6E\u6309\u7A7A\u7ED3\u679C\u5904\u7406)`
+        );
+        return [];
+      }
       const fail = getBotApiFailureInfo(body);
       if (fail) {
-        if (fail.code === "401") {
-          console.warn(`[csdn] getUnreadMessages: ${fail.message || "Token\u65E0\u6548\u6216\u5DF2\u8FC7\u671F"} (code=${fail.code})`);
-        } else {
-          console.warn(`[csdn] getUnreadMessages: ${fail.message} (code=${fail.code})`);
+        pullErrorLog(
+          this.baseUrl,
+          `business failure httpStatus=${response.status} code=${fail.code} message=${fail.message || "(empty)"}`
+        );
+        if (response.ok) {
+          return [];
         }
       }
       const legacy = tryLegacyUnreadMessages(body);
       if (legacy) {
         console.warn(
-          `[csdn] using legacy unread response format; prefer ClawBot Result with code "0" messages=${legacy.length}`
+          `${CSDN_LOG_TAG} using legacy unread response format; prefer ClawBot Result with code "0" messages=${legacy.length}`
         );
         return legacy;
       }
       if (body !== void 0 && body !== null) {
-        console.warn("[csdn] unexpected response format:", JSON.stringify(body).substring(0, 200));
+        pullErrorLog(this.baseUrl, `unexpected response format httpStatus=${response.status} body=${JSON.stringify(body).substring(0, 200)}`);
       }
-      if (response.status === 408 || response.status === 504) {
-        return [];
+      if (!response.ok) {
+        const hint = body !== void 0 && body !== null ? (typeof body === "string" ? body : JSON.stringify(body)).slice(0, 200) : "";
+        const detail = `HTTP ${response.status}${hint ? ` body=${hint}` : ""}`;
+        pullErrorLog(this.baseUrl, detail);
+        throw new Error(`${CSDN_LOG_TAG} GET ${PATH_UNREAD} failed: ${detail}`);
       }
       return [];
     } catch (error) {
@@ -4255,7 +4280,9 @@ var CsdnClient = class {
         return [];
       }
       const msg = error instanceof Error ? error.message : String(error);
-      console.error(`[csdn] getUnreadMessages failed: ${msg}`);
+      if (!(error instanceof Error && msg.startsWith(`${CSDN_LOG_TAG} GET`))) {
+        pullErrorLog(this.baseUrl, `request error: ${msg}`);
+      }
       throw error instanceof Error ? error : new Error(msg);
     }
   }
@@ -4268,7 +4295,7 @@ var CsdnClient = class {
     try {
       if (this.config.verbose) {
         console.info(
-          `[csdn] send POST ${PATH_SEND} to=${to} contentLength=${content.length}${opts?.type ? ` type=${opts.type}` : ""}`
+          `${CSDN_LOG_TAG} send POST ${PATH_SEND} to=${to} contentLength=${content.length}${opts?.type ? ` type=${opts.type}` : ""}`
         );
       }
       const response = await fetch(sendUrl, {
@@ -4287,19 +4314,22 @@ var CsdnClient = class {
       if (ok) {
         if (this.config.verbose) {
           console.info(
-            `[csdn] send response ok code=0 id=${ok.id} httpStatus=${response.status}${ok.timestamp != null ? ` timestamp=${ok.timestamp}` : ""}`
+            `${CSDN_LOG_TAG} send response ok code=0 id=${ok.id} httpStatus=${response.status}${ok.timestamp != null ? ` timestamp=${ok.timestamp}` : ""}`
           );
         }
         return ok;
       }
       const fail = getBotApiFailureInfo(body);
       const hint = fail ? `${fail.message} (code=${fail.code})` : `HTTP ${response.status}`;
-      throw new Error(`[csdn] sendMessage failed: ${hint}`);
+      console.error(
+        `${CSDN_LOG_TAG} send POST ${PATH_SEND} base=${this.baseUrl} httpStatus=${response.status} ${hint}`
+      );
+      throw new Error(`${CSDN_LOG_TAG} sendMessage failed: ${hint}`);
     } catch (error) {
-      if (error instanceof Error && error.message.startsWith("[csdn] sendMessage failed:")) {
+      if (error instanceof Error && error.message.startsWith(`${CSDN_LOG_TAG} sendMessage failed:`)) {
         throw error;
       }
-      console.error("[csdn] sendMessage failed:", error);
+      console.error(`${CSDN_LOG_TAG} send POST ${PATH_SEND} base=${this.baseUrl} request error:`, error);
       throw error;
     }
   }
@@ -4441,31 +4471,62 @@ function findRequireAnchorPackageJson() {
     dir = parent;
   }
   throw new Error(
-    "[csdn] loadOpenclawPluginSdk: no package.json found walking up from process.cwd(); cannot createRequire for openclaw fallback"
+    `${CSDN_LOG_TAG} loadOpenclawPluginSdk: no package.json found walking up from process.cwd(); cannot createRequire for openclaw fallback`
   );
 }
+var OPENCLAW_SEARCH_ROOTS = [
+  process.cwd(),
+  join(process.cwd(), ".."),
+  join(process.cwd(), "..", ".."),
+  join(process.cwd(), "packages", "csdn"),
+  join(process.cwd(), "..", "packages", "csdn")
+];
+async function importOpenclawPluginSdkFromDisk() {
+  const require2 = createRequire(findRequireAnchorPackageJson());
+  for (const root of OPENCLAW_SEARCH_ROOTS) {
+    try {
+      const mainEntry = require2.resolve("openclaw", { paths: [root] });
+      const pkgRoot = join(dirname(mainEntry), "..");
+      const sdkEntry = join(pkgRoot, "dist", "plugin-sdk", "index.js");
+      return await import(pathToFileURL(sdkEntry).href);
+    } catch {
+    }
+  }
+  throw new Error(`${CSDN_LOG_TAG} could not resolve openclaw from disk`);
+}
+async function importOpenclawReplyRuntimeFromDisk() {
+  const require2 = createRequire(findRequireAnchorPackageJson());
+  for (const root of OPENCLAW_SEARCH_ROOTS) {
+    try {
+      const mainEntry = require2.resolve("openclaw", { paths: [root] });
+      const pkgRoot = join(dirname(mainEntry), "..");
+      const entry = join(pkgRoot, "dist", "plugin-sdk", "reply-runtime.js");
+      return await import(pathToFileURL(entry).href);
+    } catch {
+    }
+  }
+  throw new Error(`${CSDN_LOG_TAG} could not resolve openclaw reply-runtime from disk`);
+}
+async function loadOpenclawReplyRuntime() {
+  try {
+    return await import("openclaw/plugin-sdk/reply-runtime");
+  } catch (first) {
+    try {
+      return await importOpenclawReplyRuntimeFromDisk();
+    } catch {
+      throw first;
+    }
+  }
+}
 async function loadOpenclawPluginSdk() {
   try {
     return await import("openclaw/plugin-sdk");
   } catch (first) {
-    const require2 = createRequire(findRequireAnchorPackageJson());
-    const searchRoots = [
-      process.cwd(),
-      join(process.cwd(), ".."),
-      join(process.cwd(), "..", ".."),
-      join(process.cwd(), "packages", "csdn"),
-      join(process.cwd(), "..", "packages", "csdn")
-    ];
-    for (const root of searchRoots) {
-      try {
-        const mainEntry = require2.resolve("openclaw", { paths: [root] });
-        const pkgRoot = join(dirname(mainEntry), "..");
-        const sdkEntry = join(pkgRoot, "dist", "plugin-sdk", "index.js");
-        return await import(pathToFileURL(sdkEntry).href);
-      } catch {
-      }
+    try {
+      return await importOpenclawPluginSdkFromDisk();
+    } catch {
+      throw first;
     }
-    throw first;
   }
 }
 
@@ -4476,12 +4537,12 @@ var csdnOutbound = {
     const csdnCfgRaw = getCsdnChannelObjectFromRoot(cfg);
     const parsed = CsdnConfigSchema.safeParse(csdnCfgRaw);
     if (!parsed.success) {
-      throw new Error("[csdn] invalid config for outbound");
+      throw new Error(`${CSDN_LOG_TAG} invalid config for outbound`);
     }
     const client = new CsdnClient(parsed.data);
     const result = await client.sendMessage(to, text);
     if (parsed.data.verbose) {
-      console.info(`[csdn] outbound sent messageId=${result.id} to=${to} textLength=${text.length}`);
+      console.info(`${CSDN_LOG_TAG} outbound sent messageId=${result.id} to=${to} textLength=${text.length}`);
     }
     return {
       channel: CSDN_PLUGIN_ID,
@@ -4545,14 +4606,14 @@ function logRoutingFallbackOnce(log) {
   if (routingFallbackLogged) return;
   routingFallbackLogged = true;
   log(
-    "[csdn] host runtime.channel.routing.resolveAgentRoute unavailable \u2192 embedded session key (normal for some gateways; once per process)"
+    "host runtime.channel.routing.resolveAgentRoute unavailable \u2192 embedded session key (normal for some gateways; once per process)"
   );
 }
 function logDispatchFallbackOnce(log) {
   if (dispatchFallbackLogged) return;
   dispatchFallbackLogged = true;
   log(
-    "[csdn] host runtime.channel.reply.dispatchReplyFromConfig unavailable \u2192 openclaw/plugin-sdk (normal for some gateways; once per process)"
+    "host runtime.channel.reply.dispatchReplyFromConfig unavailable \u2192 openclaw/plugin-sdk (normal for some gateways; once per process)"
   );
 }
 
@@ -4595,7 +4656,7 @@ async function handleCsdnMessage(params) {
   }
   if (usedEmbeddedRoute && verbose) {
     try {
-      logger.info(`[csdn] route.fallback sessionKey=${route.sessionKey} accountId=${route.accountId ?? accountId}`);
+      logger.info(`route.fallback sessionKey=${route.sessionKey} accountId=${route.accountId ?? accountId}`);
     } catch {
     }
   }
@@ -4620,7 +4681,7 @@ async function handleCsdnMessage(params) {
   };
   if (verbose) {
     try {
-      logger.info(`[csdn] inbound.content ${inboundCtx.Body}`);
+      logger.info(`inbound.content ${inboundCtx.Body}`);
     } catch {
     }
   }
@@ -4632,10 +4693,10 @@ async function handleCsdnMessage(params) {
       if (!text) return;
       try {
         if (verbose) {
-          logger.info(`[csdn] outbound text to=${msg.from} len=${text.length}`);
-          logger.info(`[csdn] outbound.content ${text}`);
+          logger.info(`outbound text to=${msg.from} len=${text.length}`);
+          logger.info(`outbound.content ${text}`);
         } else {
-          logger.info(`[csdn] reply to=${msg.from} len=${text.length}`);
+          logger.info(`reply to=${msg.from} len=${text.length}`);
         }
         await csdnOutbound.sendText({
           cfg: config,
@@ -4643,21 +4704,21 @@ async function handleCsdnMessage(params) {
           text
         });
         if (verbose) {
-          logger.info(`[csdn] outbound done to=${msg.from}`);
+          logger.info(`outbound done to=${msg.from}`);
         }
       } catch (err) {
-        logger.error(`[csdn] failed to send reply: ${String(err)}`);
+        logger.error(`failed to send reply: ${String(err)}`);
       }
     },
     onError: (err, info) => {
-      logger.error(`[csdn] reply dispatch kind=${info.kind} error: ${String(err)}`);
+      logger.error(`reply dispatch kind=${info.kind} error: ${String(err)}`);
     }
   });
   const dispatchFromRuntime = runtime?.channel?.reply?.dispatchReplyFromConfig;
   const runDispatch = async () => {
     if (typeof dispatchFromRuntime === "function") {
       if (verbose) {
-        logger.info(`[csdn] dispatching via runtime.channel.reply session=${route.sessionKey}`);
+        logger.info(`dispatching via runtime.channel.reply session=${route.sessionKey}`);
       }
       await dispatchFromRuntime({
         ctx: inboundCtx,
@@ -4668,12 +4729,35 @@ async function handleCsdnMessage(params) {
       return;
     }
     logDispatchFallbackOnce((m) => logger.info(m));
+    let replyRuntime;
+    try {
+      replyRuntime = await loadOpenclawReplyRuntime();
+    } catch {
+      replyRuntime = void 0;
+    }
+    if (replyRuntime && typeof replyRuntime.dispatchInboundMessage === "function") {
+      try {
+        if (verbose) {
+          logger.info(`dispatching via plugin-sdk/reply-runtime session=${route.sessionKey}`);
+        }
+        await replyRuntime.dispatchInboundMessage({
+          ctx: inboundCtx,
+          cfg: config,
+          dispatcher,
+          replyOptions: {}
+        });
+        return;
+      } catch (err) {
+        logger.error(`plugin-sdk/reply-runtime dispatch failed: ${String(err)}`);
+        throw err;
+      }
+    }
     try {
       const sdk = await loadOpenclawPluginSdk();
       const withSettled = sdk.dispatchReplyFromConfigWithSettledDispatcher;
       const plain = sdk.dispatchReplyFromConfig;
       if (verbose) {
-        logger.info(`[csdn] dispatching via plugin-sdk session=${route.sessionKey}`);
+        logger.info(`dispatching via plugin-sdk (legacy barrel) session=${route.sessionKey}`);
       }
       if (typeof withSettled === "function") {
         await withSettled({
@@ -4693,28 +4777,28 @@ async function handleCsdnMessage(params) {
         });
       } else {
         throw new Error(
-          "openclaw/plugin-sdk: neither dispatchReplyFromConfigWithSettledDispatcher nor dispatchReplyFromConfig is exported"
+          "openclaw: no channel dispatch API (need plugin-sdk/reply-runtime.dispatchInboundMessage or legacy dispatchReplyFromConfig on plugin-sdk barrel)"
         );
       }
     } catch (err) {
-      logger.error(`[csdn] plugin-sdk dispatch unavailable: ${String(err)}`);
+      logger.error(`plugin-sdk dispatch unavailable: ${String(err)}`);
       throw err;
     }
   };
   try {
     await runDispatch();
     if (verbose) {
-      logger.info(`[csdn] dispatch complete session=${route.sessionKey}`);
+      logger.info(`dispatch complete session=${route.sessionKey}`);
     }
   } catch (err) {
-    logger.error(`[csdn] dispatch error: ${String(err)}`);
+    logger.error(`dispatch error: ${String(err)}`);
     try {
       const echo = `\u5DF2\u6536\u5230\uFF1A${inboundCtx.Body}`;
       if (verbose) {
-        logger.info(`[csdn] outbound text(to=${msg.from}) via fallback len=${echo.length}`);
-        logger.info(`[csdn] outbound.content ${echo}`);
+        logger.info(`outbound text(to=${msg.from}) via fallback len=${echo.length}`);
+        logger.info(`outbound.content ${echo}`);
       } else {
-        logger.info(`[csdn] echo fallback to=${msg.from} len=${echo.length}`);
+        logger.info(`echo fallback to=${msg.from} len=${echo.length}`);
       }
       await csdnOutbound.sendText({
         cfg: config,
@@ -4722,10 +4806,10 @@ async function handleCsdnMessage(params) {
         text: echo
       });
       if (verbose) {
-        logger.info(`[csdn] outbound done to=${msg.from} (fallback)`);
+        logger.info(`outbound done to=${msg.from} (fallback)`);
       }
     } catch (sendErr) {
-      logger.error(`[csdn] fallback reply failed: ${String(sendErr)}`);
+      logger.error(`fallback reply failed: ${String(sendErr)}`);
     }
   }
 }
@@ -4738,6 +4822,26 @@ function maxMessageId(messages) {
   }
   return max;
 }
+function sleepBetweenPolls(ms, signal) {
+  if (ms <= 0) {
+    return new Promise((resolve) => setImmediate(resolve));
+  }
+  return new Promise((resolve) => {
+    if (signal?.aborted) {
+      resolve();
+      return;
+    }
+    const t = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(t);
+        resolve();
+      },
+      { once: true }
+    );
+  });
+}
 async function monitorCsdnProvider(opts) {
   const { config, runtime, accountId = "default", abortSignal } = opts;
   const baseLogger = runtime && (runtime.logger || runtime.log) || console;
@@ -4749,18 +4853,19 @@ async function monitorCsdnProvider(opts) {
   const csdnCfgRaw = getCsdnChannelObjectFromRoot(config);
   const parsed = CsdnConfigSchema.safeParse(csdnCfgRaw);
   if (!parsed.success) {
-    logger.error(`[csdn] invalid config for account ${accountId}: ${parsed.error}`);
+    logger.error(`invalid config for account ${accountId}: ${parsed.error}`);
     return;
   }
   const csdnCfg = parsed.data;
   if (!csdnCfg.token) {
-    logger.warn(`[csdn] token missing; skip start for account ${accountId}`);
+    logger.warn(`token missing; skip start for account ${accountId}`);
     return;
   }
   const client = new CsdnClient(csdnCfg);
+  const pollIntervalMs = clampPollIntervalMs(csdnCfg.pollIntervalMs);
   const v = csdnCfg.verbose;
   logger.info(
-    `[csdn] starting long-polling account=${accountId} apiUrl=${csdnCfg.apiUrl} timeout=${FIXED_LONG_POLLING_TIMEOUT_SEC}s take=${FIXED_TAKE}`
+    `starting long-polling account=${accountId} apiUrl=${csdnCfg.apiUrl} timeout=${FIXED_LONG_POLLING_TIMEOUT_SEC}s take=${FIXED_TAKE} pollIntervalMs=${pollIntervalMs}`
   );
   let backoffMs = FIXED_RETRY_INTERVAL_MS;
   const backoffCap = Math.max(FIXED_RETRY_INTERVAL_MS, FIXED_RETRY_BACKOFF_MAX_MS);
@@ -4770,9 +4875,6 @@ async function monitorCsdnProvider(opts) {
       try {
         const t0 = Date.now();
         if (v) {
-          logger.info(
-            `[csdn] poll begin account=${accountId} timeout=${FIXED_LONG_POLLING_TIMEOUT_SEC}s take=${FIXED_TAKE}${afterMessageId ? ` afterMessageId=${afterMessageId}` : ""}`
-          );
         }
         const messages = await client.getUnreadMessages(FIXED_LONG_POLLING_TIMEOUT_SEC, {
           afterMessageId,
@@ -4780,12 +4882,11 @@ async function monitorCsdnProvider(opts) {
         });
         backoffMs = FIXED_RETRY_INTERVAL_MS;
         const dur = Date.now() - t0;
-        logger.info(`[csdn] poll end account=${accountId} duration=${dur}ms count=${messages.length}`);
         for (const msg of messages) {
-          logger.info(`[csdn] inbound id=${msg.id} from=${msg.from} type=${msg.type} size=${msg.content?.length ?? 0}`);
+          logger.info(`inbound id=${msg.id} from=${msg.from} type=${msg.type} size=${msg.content?.length ?? 0}`);
           if (v) {
             try {
-              logger.info(`[csdn] inbound.full ${JSON.stringify(msg)}`);
+              logger.info(`inbound.full ${JSON.stringify(msg)}`);
             } catch {
             }
           }
@@ -4799,17 +4900,17 @@ async function monitorCsdnProvider(opts) {
         if (messages.length > 0) {
           afterMessageId = maxMessageId(messages);
         }
-        await new Promise((resolve) => setImmediate(resolve));
+        await sleepBetweenPolls(pollIntervalMs, abortSignal);
       } catch (err) {
-        logger.error(`[csdn] polling error: ${err}`);
+        logger.error(`polling error: ${err}`);
         logger.info(
-          `[csdn] waiting ${backoffMs}ms before retry (exponential backoff, cap=${backoffCap}ms)...`
+          `waiting ${backoffMs}ms before retry (exponential backoff, cap=${backoffCap}ms)...`
         );
         await new Promise((resolve) => setTimeout(resolve, backoffMs));
         backoffMs = Math.min(backoffCap, Math.max(FIXED_RETRY_INTERVAL_MS, backoffMs * 2));
       }
     }
-    logger.info(`[csdn] polling stopped for account ${accountId}`);
+    logger.info(`polling stopped for account ${accountId}`);
   };
   return pollLoop();
 }
@@ -4872,7 +4973,8 @@ var csdnPlugin = {
         token: { type: "string" },
         apiUrl: { type: "string" },
         fallbackAgentId: { type: "string" },
-        verbose: { type: "boolean" }
+        verbose: { type: "boolean" },
+        pollIntervalMs: { type: "number", minimum: 0, maximum: 6e5 }
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "csdn-im",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "OpenClaw channel plugin for CSDN IM",
   "license": "MIT",