@dai_ming/plugin-deliverables 1.0.15 → 1.0.16

package/INSTALL.md

@@ -1,6 +1,6 @@
 # plugin-deliverables 安装文档
 
-本文档描述 `@dai_ming/plugin-deliverables@1.0.15` 的安装、升级与验证方式。
+本文档描述 `@dai_ming/plugin-deliverables@1.0.16` 的安装、升级与验证方式。
 
 ## 1. 目标
 
@@ -22,7 +22,7 @@
 适用于已经支持 `openclaw plugins install` 的运行环境。
 
 ```bash
-openclaw plugins install @dai_ming/plugin-deliverables@1.0.15 --pin
+openclaw plugins install @dai_ming/plugin-deliverables@1.0.16 --pin
 openclaw plugins enable plugin-deliverables
 ```
 
@@ -47,7 +47,7 @@ openclaw plugins list
 
 ```yaml
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.15"
+  - "@dai_ming/plugin-deliverables@1.0.16"
 ```
 
 Helm 初始化时会自动完成：
@@ -66,8 +66,8 @@ Helm 初始化时会自动完成：
 ```bash
 mkdir -p /home/node/.openclaw/extensions-extra/plugin-deliverables
 cd /tmp
-npm pack @dai_ming/plugin-deliverables@1.0.15 --registry https://registry.npmjs.org
-tar xzf dai_ming-plugin-deliverables-1.0.15.tgz \
+npm pack @dai_ming/plugin-deliverables@1.0.16 --registry https://registry.npmjs.org
+tar xzf dai_ming-plugin-deliverables-1.0.16.tgz \
   -C /home/node/.openclaw/extensions-extra/plugin-deliverables \
   --strip-components=1
 ```
@@ -174,6 +174,7 @@ ls -la /home/node/.openclaw/workspace/skills/deliverables
 1. 第一条回复：模型自己的简短内容介绍
 2. 第二条回复：纯一个 https 链接
 3. 不再出现 `message + file_url/media` 的旁路发送
+4. pod stdout 中会多出 `palz summary request/response` 与 `palz links request/response` 四条插件日志
 
 ## 5. 常见问题
 
@@ -211,5 +212,5 @@ cat /home/node/.openclaw/extensions-extra/plugin-deliverables/package.json
 必须是：
 
 ```json
-{ "version": "1.0.15" }
+{ "version": "1.0.16" }
 ```

package/README.md

@@ -24,7 +24,7 @@ OpenClaw 交付物插件 — 让 AI Agent 将生成的文件（文章、HTML 页
 现在这个包同时支持 OpenClaw 原生插件加载。也就是说，除了网关侧用 `openclaw-plugin.json` 注入 MCP/skill/AGENTS 规则外，OpenClaw 还会读取 `openclaw.plugin.json` + `index.js`，把运行时 hook 也一并启用。
 
 ```bash
-openclaw plugins install @dai_ming/plugin-deliverables@1.0.15 --pin
+openclaw plugins install @dai_ming/plugin-deliverables@1.0.16 --pin
 openclaw plugins enable plugin-deliverables
 ```
 
@@ -43,11 +43,11 @@ openclaw plugins enable plugin-deliverables
 ```yaml
 # values.yaml（或 claw-gateway 管理界面的 Helm 参数）
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.15"
+  - "@dai_ming/plugin-deliverables@1.0.16"
 ```
 
 initContainer 执行顺序：
-1. **Phase 3**：`npm pack @dai_ming/plugin-deliverables@1.0.15` 下载 tarball → 解压到 `/data/extensions-extra/plugin-deliverables/`
+1. **Phase 3**：`npm pack @dai_ming/plugin-deliverables@1.0.16` 下载 tarball → 解压到 `/data/extensions-extra/plugin-deliverables/`
 2. **Phase 3b**：在插件目录执行 `npm install --omit=dev`（本插件无运行时依赖，此步骤跳过）
 3. **Phase 3e**：读取 `openclaw-plugin.json` 清单，自动：
    - 复制 `mcp-servers/deliverables.js` → `/data/mcp-servers/deliverables.js`
@@ -201,6 +201,8 @@ fi
 
 这三层一起工作的目标是：即使 prompt 漂移，也尽量把“message + file/media”这条旁路堵住，统一收敛到 `deliverables__upload_deliverable`。
 
+另外，Palz 渠道下如果交付物回复会被拆成“内容简介 + 最终链接”两条消息，runtime plugin 还会分别打印这两次真实 HTTP 发送的 request/response 日志，便于直接从 pod stdout 排查。
+
 ---
 
 ## 版本与发布
@@ -221,7 +223,7 @@ npm publish --registry https://registry.npmjs.org --access public
 
 | claw-gateway 版本 | plugin 版本 |
 |-------------------|-------------|
-| 当前              | 1.0.15      |
+| 当前              | 1.0.16      |
 
 ---
 

package/index.js

@@ -1,5 +1,7 @@
 "use strict";
 
+const FETCH_PATCH_KEY = "__plugin_deliverables_palz_fetch_patch__";
+
 const RUNTIME_DELIVERABLES_GUIDANCE = [
   "## Deliverables Runtime Guard (HARD CONSTRAINT)",
   "",
@@ -10,6 +12,10 @@ const RUNTIME_DELIVERABLES_GUIDANCE = [
   "- After a successful upload, reply with a short content-aware intro and then preserve the Markdown links returned by the deliverables tool.",
 ].join("\n");
 
+function isString(value) {
+  return typeof value === "string";
+}
+
 const ATTACHMENT_PARAM_KEYS = new Set([
   "attachment",
   "attachments",
@@ -103,11 +109,257 @@ function extractMediaUrls(metadata) {
   return urls;
 }
 
+function trimTrailingBlankLines(lines) {
+  const out = lines.slice();
+  while (out.length > 0 && /^\s*$/.test(out[out.length - 1])) {
+    out.pop();
+  }
+  return out;
+}
+
+function stripBulletPrefix(line) {
+  return String(line || "").replace(/^\s*[-*+]\s+/, "");
+}
+
+function isLinksHeading(line) {
+  return /^\s*#{1,6}\s*访问链接\s*$/u.test(String(line || ""));
+}
+
+function extractDeliverableURL(line) {
+  const text = String(line || "").trim();
+  if (!text) {
+    return "";
+  }
+  const markdownLink = text.match(/\((https?:\/\/[^)\s]+)\)\s*$/iu);
+  if (markdownLink && markdownLink[1]) {
+    return markdownLink[1].trim();
+  }
+  const rawLink = text.match(/https?:\/\/\S+/iu);
+  if (rawLink && rawLink[0]) {
+    return rawLink[0].trim();
+  }
+  return "";
+}
+
+function isDeliverableLinkLine(line) {
+  const text = String(line || "");
+  if (
+    /^\s*(?:[-*+]\s+)?(?:预览链接|下载链接|文件列表|项目入口|在线预览|在线体验|目录链接)\s*[:：]\s*\[[^\]]+\]\([^)]+\)\s*$/u.test(
+      text,
+    )
+  ) {
+    return true;
+  }
+  return !!extractDeliverableURL(text);
+}
+
+function splitDeliverableMessage(text) {
+  const normalized = String(text || "").replace(/\r\n/g, "\n").trim();
+  if (!normalized) {
+    return null;
+  }
+
+  const lines = normalized.split("\n");
+  let firstLinkIndex = -1;
+  for (let i = 0; i < lines.length; i += 1) {
+    if (isDeliverableLinkLine(lines[i])) {
+      firstLinkIndex = i;
+      break;
+    }
+  }
+  if (firstLinkIndex < 0) {
+    return null;
+  }
+
+  let summaryLines = trimTrailingBlankLines(lines.slice(0, firstLinkIndex));
+  if (summaryLines.length > 0 && isLinksHeading(summaryLines[summaryLines.length - 1])) {
+    summaryLines.pop();
+  }
+  summaryLines = trimTrailingBlankLines(summaryLines);
+
+  const linkLines = [];
+  for (let i = firstLinkIndex; i < lines.length; i += 1) {
+    const line = lines[i];
+    if (isLinksHeading(line)) {
+      continue;
+    }
+    if (isDeliverableLinkLine(line)) {
+      const url = extractDeliverableURL(stripBulletPrefix(line));
+      if (url) {
+        linkLines.push(url);
+      }
+    }
+  }
+
+  const summary = summaryLines.join("\n").trim();
+  const links = linkLines.length > 0 ? linkLines[0] : "";
+  if (!summary || !links) {
+    return null;
+  }
+
+  return { summary, links };
+}
+
+function cloneBody(body, content, suffix) {
+  const next = {};
+  Object.keys(body).forEach((key) => {
+    next[key] = body[key];
+  });
+  next.content = content;
+  if (isString(body.msg_id) && body.msg_id.trim()) {
+    next.msg_id = body.msg_id + suffix;
+  }
+  return next;
+}
+
+function shouldSplitPalzPayload(body) {
+  if (!body || typeof body !== "object" || Array.isArray(body)) {
+    return null;
+  }
+  if (!isString(body.content)) {
+    return null;
+  }
+  if (
+    body.stream_id ||
+    body.seq !== undefined ||
+    body.delta !== undefined ||
+    body.is_final !== undefined
+  ) {
+    return null;
+  }
+  if (body.palz_msg_type || body.tool_content) {
+    return null;
+  }
+  return splitDeliverableMessage(body.content);
+}
+
+function resolveFetchURL(input) {
+  if (isString(input)) {
+    return input;
+  }
+  if (input && isString(input.url)) {
+    return input.url;
+  }
+  return "";
+}
+
+function resolveFetchMethod(input, init) {
+  if (init && isString(init.method) && init.method.trim()) {
+    return init.method.trim().toUpperCase();
+  }
+  if (input && !isString(input) && isString(input.method) && input.method.trim()) {
+    return input.method.trim().toUpperCase();
+  }
+  return "GET";
+}
+
+function previewText(text, limit = 1000) {
+  const normalized = String(text || "");
+  if (normalized.length <= limit) {
+    return normalized;
+  }
+  return `${normalized.slice(0, limit)}...<truncated>`;
+}
+
+async function readResponseText(response) {
+  if (!response || typeof response.clone !== "function") {
+    return "";
+  }
+  try {
+    return await response.clone().text();
+  } catch (_err) {
+    return "";
+  }
+}
+
+function installPalzFetchPatch(api) {
+  if (globalThis[FETCH_PATCH_KEY] && globalThis[FETCH_PATCH_KEY].installed) {
+    return;
+  }
+  const originalFetch = globalThis.fetch;
+  if (typeof originalFetch !== "function") {
+    api.logger.warn?.("[plugin-deliverables] global fetch is unavailable; split patch skipped");
+    return;
+  }
+
+  const patchedFetch = async function(input, init) {
+    const url = resolveFetchURL(input);
+    const method = resolveFetchMethod(input, init);
+    if (method !== "POST" || !/\/bot\/send(?:\?|$)/.test(url)) {
+      return originalFetch(input, init);
+    }
+
+    const requestBody = init && init.body;
+    if (!isString(requestBody)) {
+      return originalFetch(input, init);
+    }
+
+    let parsed;
+    try {
+      parsed = JSON.parse(requestBody);
+    } catch (_err) {
+      return originalFetch(input, init);
+    }
+
+    const split = shouldSplitPalzPayload(parsed);
+    if (!split) {
+      return originalFetch(input, init);
+    }
+
+    const summaryBody = cloneBody(parsed, split.summary, "__summary");
+    const linksBody = cloneBody(parsed, split.links, "__links");
+    const summaryBodyStr = JSON.stringify(summaryBody);
+    const linksBodyStr = JSON.stringify(linksBody);
+
+    api.logger.info?.(
+      `[plugin-deliverables] split deliverable reply for palz target=${String(parsed.conversation_id || "")} summaryMsgId=${String(summaryBody.msg_id || "")} linksMsgId=${String(linksBody.msg_id || "")}`,
+    );
+    api.logger.info?.(
+      `[plugin-deliverables] palz summary request body_length=${summaryBodyStr.length}\n  request_body=${summaryBodyStr}`,
+    );
+
+    const baseInit = Object.assign({}, init);
+    const summaryInit = Object.assign({}, baseInit, {
+      body: summaryBodyStr,
+    });
+    const linksInit = Object.assign({}, baseInit, {
+      body: linksBodyStr,
+    });
+
+    const firstResponse = await originalFetch(input, summaryInit);
+    const firstResponseText = await readResponseText(firstResponse);
+    api.logger.info?.(
+      `[plugin-deliverables] palz summary response status=${firstResponse ? firstResponse.status : "unknown"} ok=${Boolean(firstResponse && firstResponse.ok)}\n  response_body=${previewText(firstResponseText)}`,
+    );
+    if (!firstResponse || !firstResponse.ok) {
+      return firstResponse;
+    }
+
+    api.logger.info?.(
+      `[plugin-deliverables] palz links request body_length=${linksBodyStr.length}\n  request_body=${linksBodyStr}`,
+    );
+    const secondResponse = await originalFetch(input, linksInit);
+    const secondResponseText = await readResponseText(secondResponse);
+    api.logger.info?.(
+      `[plugin-deliverables] palz links response status=${secondResponse ? secondResponse.status : "unknown"} ok=${Boolean(secondResponse && secondResponse.ok)}\n  response_body=${previewText(secondResponseText)}`,
+    );
+    return secondResponse;
+  };
+
+  globalThis.fetch = patchedFetch;
+  globalThis[FETCH_PATCH_KEY] = {
+    installed: true,
+    originalFetch,
+  };
+}
+
 const plugin = {
   id: "plugin-deliverables",
   name: "Deliverables",
   description: "Upload-first runtime guard for generated file deliverables.",
   register(api) {
+    installPalzFetchPatch(api);
+
     api.on("before_prompt_build", async () => ({
       prependSystemContext: RUNTIME_DELIVERABLES_GUIDANCE,
     }));

package/openclaw-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-deliverables",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "npm_package": "@dai_ming/plugin-deliverables",
   "description": "Deliverables plugin: MCP server + skill + AGENTS rules for AI-generated file uploads",
   "mcp_servers": {

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "plugin-deliverables",
   "name": "Deliverables",
-  "description": "Deliverables runtime guard for upload-first file delivery.",
-  "version": "1.0.15",
+  "description": "Deliverables runtime guard for upload-first file delivery with Palz split-send diagnostics.",
+  "version": "1.0.16",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dai_ming/plugin-deliverables",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "OpenClaw deliverables plugin — upload AI-generated files to OSS and return shareable preview/download links",
   "keywords": [
     "openclaw",