@dai_ming/plugin-deliverables 1.0.21 → 1.0.22

package/INSTALL.md

@@ -1,6 +1,6 @@
 # plugin-deliverables 安装文档
 
-本文档描述 `@dai_ming/plugin-deliverables@1.0.21` 的安装、升级与验证方式。
+本文档描述 `@dai_ming/plugin-deliverables@1.0.22` 的安装、升级与验证方式。
 
 ## 1. 目标
 
@@ -22,7 +22,7 @@
 适用于已经支持 `openclaw plugins install` 的运行环境。
 
 ```bash
-openclaw plugins install @dai_ming/plugin-deliverables@1.0.21 --pin
+openclaw plugins install @dai_ming/plugin-deliverables@1.0.22 --pin
 openclaw plugins enable plugin-deliverables
 ```
 
@@ -47,7 +47,7 @@ openclaw plugins list
 
 ```yaml
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.21"
+  - "@dai_ming/plugin-deliverables@1.0.22"
 ```
 
 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.21 --registry https://registry.npmjs.org
-tar xzf dai_ming-plugin-deliverables-1.0.21.tgz \
+npm pack @dai_ming/plugin-deliverables@1.0.22 --registry https://registry.npmjs.org
+tar xzf dai_ming-plugin-deliverables-1.0.22.tgz \
   -C /home/node/.openclaw/extensions-extra/plugin-deliverables \
   --strip-components=1
 ```
@@ -212,5 +212,5 @@ cat /home/node/.openclaw/extensions-extra/plugin-deliverables/package.json
 必须是：
 
 ```json
-{ "version": "1.0.21" }
+{ "version": "1.0.22" }
 ```

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.21 --pin
+openclaw plugins install @dai_ming/plugin-deliverables@1.0.22 --pin
 openclaw plugins enable plugin-deliverables
 ```
 
@@ -44,11 +44,11 @@ openclaw plugins enable plugin-deliverables
 ```yaml
 # values.yaml（或 claw-gateway 管理界面的 Helm 参数）
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.21"
+  - "@dai_ming/plugin-deliverables@1.0.22"
 ```
 
 initContainer 执行顺序：
-1. **Phase 3**：`npm pack @dai_ming/plugin-deliverables@1.0.21` 下载 tarball → 解压到 `/data/extensions-extra/plugin-deliverables/`
+1. **Phase 3**：`npm pack @dai_ming/plugin-deliverables@1.0.22` 下载 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`
@@ -226,7 +226,7 @@ npm publish --registry https://registry.npmjs.org --access public
 
 | claw-gateway 版本 | plugin 版本 |
 |-------------------|-------------|
-| 当前              | 1.0.21      |
+| 当前              | 1.0.22      |
 
 ---
 

package/index.js

@@ -1222,6 +1222,7 @@ function splitDeliverableMessage(text) {
 
   const linkLines = [];
   const linkUrls = [];
+  const linkItems = [];
   for (let i = firstLinkIndex; i < lines.length; i += 1) {
     const line = lines[i];
     if (isLinksHeading(line)) {
@@ -1234,6 +1235,7 @@ function splitDeliverableMessage(text) {
         const url = extractDeliverableURL(normalizedLine);
         if (url) {
           linkUrls.push(url);
+          linkItems.push({ line: normalizedLine, url });
         }
       }
     }
@@ -1249,10 +1251,53 @@ function splitDeliverableMessage(text) {
     summary,
     links,
     linkUrls,
+    linkItems,
     primaryLinkUrl: linkUrls.length > 0 ? linkUrls[0] : "",
+    fileLinkUrl: selectPalzFileURL(linkItems),
   };
 }
 
+function extractDeliverableIdentity(rawURL) {
+  if (!isString(rawURL) || !rawURL.trim()) {
+    return "";
+  }
+  let parsed;
+  try {
+    parsed = new URL(rawURL.trim());
+  } catch (_err) {
+    return "";
+  }
+  if (!DELIVERABLE_GATEWAY_PATH_RE.test(parsed.pathname)) {
+    return "";
+  }
+  const parts = parsed.pathname.split("/").filter(Boolean);
+  const uuidRe = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+  for (const part of parts) {
+    if (uuidRe.test(part)) {
+      return part.toLowerCase();
+    }
+  }
+  return parsed.href;
+}
+
+function selectPalzFileURL(linkItems) {
+  if (!Array.isArray(linkItems) || linkItems.length === 0) {
+    return "";
+  }
+  const identities = new Set();
+  for (const item of linkItems) {
+    const identity = extractDeliverableIdentity(item && item.url);
+    if (identity) {
+      identities.add(identity);
+    }
+  }
+  if (identities.size !== 1) {
+    return "";
+  }
+  const download = linkItems.find((item) => /下载链接/u.test(String((item && item.line) || "")));
+  return (download && download.url) || linkItems[0].url || "";
+}
+
 function cloneBody(body, content, suffix) {
   const next = {};
   Object.keys(body).forEach((key) => {
@@ -1308,6 +1353,7 @@ function shouldSplitPalzPayload(body) {
       summary: cachedSummary,
       links: split.links,
       primaryLinkUrl: split.primaryLinkUrl,
+      fileLinkUrl: split.fileLinkUrl,
     };
   }
   return split;
@@ -1403,14 +1449,15 @@ function installPalzFetchPatch(api) {
     }
 
     const summaryBody = cloneBody(parsed, split.summary, "__summary");
-    const linksBody = split.primaryLinkUrl && (!Array.isArray(split.linkUrls) || split.linkUrls.length === 1)
-      ? cloneBodyAsFileLink(parsed, split.primaryLinkUrl, "__links")
+    const fileLinkUrl = split.fileLinkUrl || "";
+    const linksBody = fileLinkUrl
+      ? cloneBodyAsFileLink(parsed, fileLinkUrl, "__links")
       : cloneBody(parsed, split.links, "__links");
     const summaryBodyStr = JSON.stringify(summaryBody);
     const linksBodyStr = JSON.stringify(linksBody);
 
     api.logger.info?.(
-      `[plugin-deliverables] split deliverable reply injected by plugin-deliverables target=${String(parsed.conversation_id || "")} summaryMsgId=${String(summaryBody.msg_id || "")} linksMsgId=${String(linksBody.msg_id || "")} linksMode=${split.primaryLinkUrl ? "file_url" : "text"}`,
+      `[plugin-deliverables] split deliverable reply injected by plugin-deliverables target=${String(parsed.conversation_id || "")} summaryMsgId=${String(summaryBody.msg_id || "")} linksMsgId=${String(linksBody.msg_id || "")} linksMode=${fileLinkUrl ? "file_url" : "text"}`,
     );
     api.logger.info?.(
       `[plugin-deliverables] palz summary request body_length=${summaryBodyStr.length}\n  request_body=${summaryBodyStr}`,
@@ -1508,6 +1555,7 @@ plugin.__test = {
   isDeliverableLinkLine,
   isOSSLikeURL,
   isTrustedDeliverableURL,
+  selectPalzFileURL,
   splitDeliverableMessage,
 };
 

package/mcp-servers/deliverables.js

@@ -274,12 +274,70 @@ function normalizeBase64Content(value, label) {
   return Buffer.from(padded, "base64").toString("base64");
 }
 
+function candidateWorkspaceRoots() {
+  var roots = [];
+  [
+    process.env.OPENCLAW_WORKSPACE_PATH,
+    process.env.WORKSPACE_PATH,
+    "/home/node/.openclaw/workspace-main",
+    "/home/node/.openclaw/workspace",
+    "/data/workspace",
+    "/data/workspace-main"
+  ].forEach(function(root) {
+    root = trimString(root);
+    if (root && roots.indexOf(root) < 0) {
+      roots.push(root);
+    }
+  });
+  try {
+    fs.readdirSync("/data").forEach(function(entry) {
+      if (entry && entry.indexOf("workspace-") === 0) {
+        var root = path.join("/data", entry);
+        if (roots.indexOf(root) < 0) {
+          roots.push(root);
+        }
+      }
+    });
+  } catch (_err) {}
+  return roots;
+}
+
+function resolveReadableFilePath(filePath) {
+  var rawPath = trimString(filePath);
+  if (!rawPath) {
+    return "";
+  }
+  var candidates = [];
+  function add(candidate) {
+    if (candidate && candidates.indexOf(candidate) < 0) {
+      candidates.push(candidate);
+    }
+  }
+  if (path.isAbsolute(rawPath)) {
+    add(rawPath);
+  } else {
+    add(path.resolve(process.cwd(), rawPath));
+    candidateWorkspaceRoots().forEach(function(root) {
+      add(path.join(root, rawPath));
+    });
+  }
+  for (var i = 0; i < candidates.length; i += 1) {
+    try {
+      var stat = fs.statSync(candidates[i]);
+      if (stat.isFile()) {
+        return candidates[i];
+      }
+    } catch (_err) {}
+  }
+  return candidates[0] || rawPath;
+}
+
 function readFileAsBase64(filePath, label) {
   var rawPath = trimString(filePath);
   if (!rawPath) {
     return "";
   }
-  var resolvedPath = path.resolve(process.cwd(), rawPath);
+  var resolvedPath = resolveReadableFilePath(rawPath);
   var stat;
   try {
     stat = fs.statSync(resolvedPath);
@@ -448,7 +506,8 @@ function startMCPServer() {
 module.exports.__test = {
   buildContentPayload: buildContentPayload,
   buildUploadRequestBody: buildUploadRequestBody,
-  normalizeBase64Content: normalizeBase64Content
+  normalizeBase64Content: normalizeBase64Content,
+  resolveReadableFilePath: resolveReadableFilePath
 };
 
 if (require.main === module) {

package/openclaw-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-deliverables",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "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

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

package/package.json

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

package/test/index.test.js

@@ -11,6 +11,7 @@ const {
   findUntrustedOSSDeliverableURL,
   isDeliverableLinkLine,
   isTrustedDeliverableURL,
+  selectPalzFileURL,
   splitDeliverableMessage,
 } = plugin.__test;
 
@@ -40,6 +41,19 @@ const split = splitDeliverableMessage(
 );
 assert.ok(split);
 assert.strictEqual(split.primaryLinkUrl, gatewayURL);
+assert.strictEqual(split.fileLinkUrl, gatewayURL);
+
+const outputURL =
+  "https://claw-gateway.csagentai.com/openclaw-gateway/output/user/res/uuid/7a9e27b7-08ca-4453-81e8-fe6a630d4566/report.md";
+const previewURL =
+  "https://claw-gateway.csagentai.com/openclaw-gateway/preview/7a9e27b7-08ca-4453-81e8-fe6a630d4566";
+assert.strictEqual(
+  selectPalzFileURL([
+    { line: `预览链接：[点击预览](${previewURL})`, url: previewURL },
+    { line: `下载链接：[点击下载](${outputURL})`, url: outputURL },
+  ]),
+  outputURL,
+);
 
 assert.strictEqual(
   splitDeliverableMessage(

package/test/mcp-server.test.js

@@ -8,6 +8,7 @@ const path = require("path");
 const {
   buildUploadRequestBody,
   normalizeBase64Content,
+  resolveReadableFilePath,
 } = require("../mcp-servers/deliverables.js").__test;
 
 assert.strictEqual(
@@ -24,6 +25,7 @@ assert.throws(
 );
 
 const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "deliverables-mcp-"));
+process.env.OPENCLAW_WORKSPACE_PATH = tmpDir;
 const pdfPath = path.join(tmpDir, "sample.pdf");
 const pdfBytes = Buffer.from("%PDF-1.3\nsample\n", "utf8");
 fs.writeFileSync(pdfPath, pdfBytes);
@@ -42,3 +44,17 @@ assert.strictEqual(body.resourceId, "res-1");
 assert.strictEqual(body.fileName, "sample.pdf");
 assert.strictEqual(body.contentText, "");
 assert.strictEqual(body.contentBase64, pdfBytes.toString("base64"));
+
+const outputDir = path.join(tmpDir, "output");
+fs.mkdirSync(outputDir, { recursive: true });
+const relativeDoc = path.join(outputDir, "relative.md");
+fs.writeFileSync(relativeDoc, "# Relative\n", "utf8");
+assert.strictEqual(resolveReadableFilePath("output/relative.md"), relativeDoc);
+
+const relativeBody = buildUploadRequestBody({
+  resource_id: "res-1",
+  type: "article",
+  file_name: "relative.md",
+  file_path: "output/relative.md",
+});
+assert.strictEqual(relativeBody.contentBase64, Buffer.from("# Relative\n").toString("base64"));