@dai_ming/plugin-deliverables 1.0.15 → 1.0.17

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,10 @@
 "use strict";
 
+const FETCH_PATCH_KEY = "__plugin_deliverables_palz_fetch_patch__";
+const SUMMARY_CACHE_KEY = "__plugin_deliverables_summary_cache__";
+const SUMMARY_CACHE_LIMIT = 200;
+const SHORT_SUMMARY_THRESHOLD = 120;
+
 const RUNTIME_DELIVERABLES_GUIDANCE = [
   "## Deliverables Runtime Guard (HARD CONSTRAINT)",
   "",
@@ -7,9 +12,20 @@ const RUNTIME_DELIVERABLES_GUIDANCE = [
   "- When the user asks for a document, article, report, HTML page, Markdown file, PPT, image, archive, game, or any other file deliverable, you MUST create it under the current workspace `output/` directory and upload it with `deliverables__upload_deliverable`.",
   "- Do not use direct message attachments to deliver generated files. This includes the message tool attachment fields such as `media`, `path`, `filePath`, `buffer`, `attachment`, or similar file-carrying fields.",
   "- Do not emit `MEDIA:` file references for user-facing deliverables. Deliverable links must come from the deliverables upload tool instead.",
-  "- After a successful upload, reply with a short content-aware intro and then preserve the Markdown links returned by the deliverables tool.",
+  "- After a successful upload, reply with a substantive content summary before the links. For documents/articles/reports, prefer 1 short intro plus 3-6 concise bullets covering key sections, highlights, or findings, then preserve the Markdown links returned by the deliverables tool.",
 ].join("\n");
 
+function isString(value) {
+  return typeof value === "string";
+}
+
+function getSummaryCache() {
+  if (!globalThis[SUMMARY_CACHE_KEY] || !(globalThis[SUMMARY_CACHE_KEY] instanceof Map)) {
+    globalThis[SUMMARY_CACHE_KEY] = new Map();
+  }
+  return globalThis[SUMMARY_CACHE_KEY];
+}
+
 const ATTACHMENT_PARAM_KEYS = new Set([
   "attachment",
   "attachments",
@@ -103,17 +119,516 @@ 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 stripNumberedPrefix(line) {
+  return String(line || "").replace(/^\s*\d+[.)]\s+/, "");
+}
+
+function cleanInlineMarkdown(text) {
+  return String(text || "")
+    .replace(/!\[[^\]]*\]\([^)]+\)/g, "")
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+    .replace(/`([^`]*)`/g, "$1")
+    .replace(/\*\*([^*]+)\*\*/g, "$1")
+    .replace(/\*([^*]+)\*/g, "$1")
+    .replace(/__([^_]+)__/g, "$1")
+    .replace(/_([^_]+)_/g, "$1")
+    .replace(/^\s*>\s?/gm, "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function trimSummaryText(text, limit = 160) {
+  const normalized = cleanInlineMarkdown(text);
+  if (normalized.length <= limit) {
+    return normalized;
+  }
+  return normalized.slice(0, limit - 1).trimEnd() + "…";
+}
+
+function extractTitleFromContent(text, fallbackName) {
+  const normalized = String(text || "").replace(/\r\n/g, "\n");
+  const lines = normalized.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^\s*#\s+(.+?)\s*$/u);
+    if (match && match[1]) {
+      return trimSummaryText(match[1], 80);
+    }
+  }
+  return trimSummaryText(String(fallbackName || "").replace(/\.[^.]+$/, ""), 80);
+}
+
+function isBulletLine(line) {
+  return /^\s*[-*+]\s+/.test(String(line || ""));
+}
+
+function isNumberedLine(line) {
+  return /^\s*\d+[.)]\s+/.test(String(line || ""));
+}
+
+function summarizeSectionBody(lines) {
+  const bulletItems = [];
+  const paragraphLines = [];
+
+  for (const rawLine of lines) {
+    const line = String(rawLine || "").trim();
+    if (!line) {
+      continue;
+    }
+    if (isBulletLine(line)) {
+      bulletItems.push(trimSummaryText(stripBulletPrefix(line), 80));
+      continue;
+    }
+    if (isNumberedLine(line)) {
+      bulletItems.push(trimSummaryText(stripNumberedPrefix(line), 80));
+      continue;
+    }
+    if (/^\s*#{1,6}\s+/u.test(line)) {
+      continue;
+    }
+    paragraphLines.push(cleanInlineMarkdown(line));
+  }
+
+  if (bulletItems.length > 0) {
+    return bulletItems.slice(0, 2).join("；");
+  }
+
+  if (paragraphLines.length > 0) {
+    return trimSummaryText(paragraphLines.join(" "), 120);
+  }
+
+  return "";
+}
+
+function buildSummaryFromTextContent(text, fallbackName) {
+  const normalized = String(text || "").replace(/\r\n/g, "\n").trim();
+  if (!normalized) {
+    return "";
+  }
+
+  const title = extractTitleFromContent(normalized, fallbackName);
+  const lines = normalized.split("\n");
+  const sections = [];
+  let current = null;
+
+  for (const rawLine of lines) {
+    const line = String(rawLine || "");
+    const headingMatch = line.match(/^\s*#{2,3}\s+(.+?)\s*$/u);
+    if (headingMatch && headingMatch[1]) {
+      if (current) {
+        sections.push(current);
+      }
+      current = {
+        heading: trimSummaryText(headingMatch[1], 40),
+        lines: [],
+      };
+      continue;
+    }
+    if (current) {
+      current.lines.push(line);
+    }
+  }
+  if (current) {
+    sections.push(current);
+  }
+
+  const bulletLines = [];
+  for (const section of sections) {
+    const snippet = summarizeSectionBody(section.lines);
+    if (!snippet) {
+      continue;
+    }
+    bulletLines.push(`- ${section.heading}：${snippet}`);
+    if (bulletLines.length >= 4) {
+      break;
+    }
+  }
+
+  if (bulletLines.length === 0) {
+    const fallbackSnippet = summarizeSectionBody(lines);
+    if (!fallbackSnippet) {
+      return title ? `已为你生成《${title}》。` : "";
+    }
+    return title
+      ? `已为你生成《${title}》。\n\n内容摘要：\n- ${fallbackSnippet}`
+      : `内容摘要：\n- ${fallbackSnippet}`;
+  }
+
+  const intro = title ? `已为你生成《${title}》。` : "已为你生成交付物。";
+  return `${intro}\n\n内容摘要：\n${bulletLines.join("\n")}`;
+}
+
+function selectPrimaryTextFile(files) {
+  if (!Array.isArray(files) || files.length === 0) {
+    return null;
+  }
+
+  const textFiles = files.filter((file) => isString(file && file.content_text) && file.content_text.trim());
+  if (textFiles.length === 0) {
+    return null;
+  }
+
+  const scored = textFiles.map((file) => {
+    const name = String(file.name || "");
+    const content = String(file.content_text || "");
+    let score = content.length;
+    if (/\/?index\.html?$/i.test(name)) {
+      score += 2000;
+    }
+    if (/\.(md|markdown)$/i.test(name)) {
+      score += 1500;
+    }
+    if (/\.(txt|html?)$/i.test(name)) {
+      score += 800;
+    }
+    return { file, score };
+  });
+
+  scored.sort((a, b) => b.score - a.score);
+  return scored[0].file;
+}
+
+function buildSummaryFromUploadParams(params) {
+  if (!params || typeof params !== "object" || Array.isArray(params)) {
+    return "";
+  }
+
+  if (isString(params.content_text) && params.content_text.trim()) {
+    return buildSummaryFromTextContent(params.content_text, params.file_name);
+  }
+
+  const primaryFile = selectPrimaryTextFile(params.files);
+  if (primaryFile && isString(primaryFile.content_text) && primaryFile.content_text.trim()) {
+    return buildSummaryFromTextContent(primaryFile.content_text, primaryFile.name || params.file_name);
+  }
+
+  if (Array.isArray(params.files) && params.files.length > 0) {
+    const names = params.files
+      .map((file) => trimSummaryText(file && file.name ? String(file.name) : "", 40))
+      .filter(Boolean)
+      .slice(0, 4);
+    if (names.length > 0) {
+      return `已为你生成《${trimSummaryText(String(params.file_name || "交付物"), 60)}》。\n\n内容摘要：\n- 共包含 ${params.files.length} 个文件\n- 主要文件：${names.join("、")}`;
+    }
+  }
+
+  return "";
+}
+
+function cacheUploadSummary(params) {
+  const resourceId = isString(params && params.resource_id) ? params.resource_id.trim() : "";
+  if (!resourceId) {
+    return;
+  }
+  const summary = buildSummaryFromUploadParams(params);
+  if (!summary) {
+    return;
+  }
+  const cache = getSummaryCache();
+  cache.set(resourceId, {
+    summary,
+    createdAt: Date.now(),
+  });
+  while (cache.size > SUMMARY_CACHE_LIMIT) {
+    const firstKey = cache.keys().next();
+    if (firstKey.done) {
+      break;
+    }
+    cache.delete(firstKey.value);
+  }
+}
+
+function takeCachedSummary(resourceId) {
+  const key = isString(resourceId) ? resourceId.trim() : "";
+  if (!key) {
+    return "";
+  }
+  const cache = getSummaryCache();
+  const entry = cache.get(key);
+  cache.delete(key);
+  return entry && isString(entry.summary) ? entry.summary.trim() : "";
+}
+
+function isSummaryTooShort(summary) {
+  const text = cleanInlineMarkdown(summary);
+  if (!text) {
+    return true;
+  }
+  if (text.length < SHORT_SUMMARY_THRESHOLD) {
+    return true;
+  }
+  return !/\n\s*[-*+]\s+/u.test(String(summary || ""));
+}
+
+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 normalizedLine = stripBulletPrefix(line).trim();
+      if (normalizedLine) {
+        linkLines.push(normalizedLine);
+      }
+    }
+  }
+
+  const summary = summaryLines.join("\n").trim();
+  const links = linkLines.join("\n").trim();
+  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;
+  }
+  const split = splitDeliverableMessage(body.content);
+  if (!split) {
+    return null;
+  }
+
+  const cachedSummary = takeCachedSummary(body.resource_id);
+  if (cachedSummary && isSummaryTooShort(split.summary)) {
+    return {
+      summary: cachedSummary,
+      links: split.links,
+    };
+  }
+  return split;
+}
+
+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,
     }));
 
     api.on("before_tool_call", async (event) => {
       if (isDeliverablesUploadTool(event.toolName)) {
+        cacheUploadSummary(event.params);
         return;
       }
       if (!isOutboundMessageTool(event.toolName)) {

package/openclaw-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-deliverables",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "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.17",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",

package/package.json

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