@dai_ming/plugin-deliverables 1.0.10 → 1.0.14

package/README.md

@@ -4,20 +4,19 @@ OpenClaw 交付物插件。安装后会把交付物 MCP、skill、AGENTS 规则
 
 当前版本增强点：
 
-- 上传成功后优先走“两条回复”体验：
-  - 第一条是内容摘要
-  - 第二条是纯 Markdown 链接
+- 上传成功后返回标准 Markdown 链接块；同时通过运行时补丁把 palz-connector 中的“简介 + 链接”交付物回复拆成两条独立消息
 - 单文件交付物会尽量保留原始文件后缀；如果模型漏掉后缀，插件会按内容类型自动补齐（如 `.md` / `.html`）
 
 ## 包内文件
 
 | 文件 | 作用 |
 |------|------|
-| `install.js` | 安装器：负责复制插件、注册 MCP、安装 skill、注入 AGENTS 规则、补齐 `plugins.allow`、清 session |
+| `install.js` | 安装器：负责复制插件、注册 MCP、安装 skill、注入 AGENTS 规则、补齐 `plugins.allow`、清 session，并刷新旧的 deliverables MCP 进程 |
 | `mcp-servers/deliverables.js` | MCP Server，暴露 `upload_deliverable` |
 | `skills/deliverables/SKILL.md` | 约束模型优先走交付物上传，并统一写到 `output/` |
 | `agents-rules/deliverables.md` | 注入到 `AGENTS.md` 的强约束规则 |
-| `openclaw-plugin.json` | 插件清单，声明 MCP、skill、rules 和运行时配置 |
+| `openclaw-plugin.json` | 兼容当前安装脚本的清单，声明 MCP、skill、rules 和运行时配置 |
+| `openclaw.plugin.json` | OpenClaw 运行时插件清单，用于真正加载 `index.js` 扩展 |
 
 ## 推荐安装方式
 
@@ -27,7 +26,7 @@ OpenClaw 交付物插件。安装后会把交付物 MCP、skill、AGENTS 规则
 
 ```yaml
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.10"
+  - "@dai_ming/plugin-deliverables@1.0.14"
 ```
 
 现有 chart 会在 init 阶段完成安装。
@@ -38,7 +37,7 @@ installPlugins:
 
 ```bash
 npm config set registry https://registry.npmmirror.com
-npm install @dai_ming/plugin-deliverables@1.0.10
+npm install @dai_ming/plugin-deliverables@1.0.14
 node node_modules/@dai_ming/plugin-deliverables/install.js
 ```
 
@@ -64,9 +63,16 @@ node node_modules/@dai_ming/plugin-deliverables/install.js \
    - 注册 `mcp.servers.deliverables`
    - 启用 `skills.entries.deliverables`
    - 启用 `plugins.entries.plugin-deliverables`
+   - 把 `~/.openclaw/extensions-extra/plugin-deliverables` 写入 `plugins.load.paths`
    - 把 `plugin-deliverables` 加入 `plugins.allow`
 7. 清理 session，让下一条消息重新读取 prompt / skill / tool 配置
 8. 如果 agent 或全局存在 `tools.allow` 白名单，自动补上 `deliverables__upload_deliverable`
+9. 如果当前 pod 里已经跑着旧版 `deliverables.js` MCP 进程，会自动结束旧进程，让它按新文件重新拉起，避免“磁盘已更新但 toolResult 还是旧格式”
+
+补充说明：
+
+- 当前 OpenClaw 运行时默认只扫描 `~/.openclaw/extensions`；`extensions-extra` 里的 JS 插件只有进入 `plugins.load.paths` 才会被当成可执行 `openclaw` 插件加载
+- 安装脚本会先把插件源码暂存到系统临时目录再复制，避免在 `extensions-extra` 原地执行安装时把源目录自己删掉
 
 ## 是否需要重启 Pod
 
@@ -74,7 +80,7 @@ node node_modules/@dai_ming/plugin-deliverables/install.js \
 
 原因：
 - 安装脚本会直接改 `~/.openclaw/openclaw.json`
-- `plugins.allow` 变化会触发 OpenClaw 的 watcher，进程级重载大约 15 秒
+- `plugins.allow` / `plugins.load.paths` 变化会触发 OpenClaw 的 watcher，进程级重载大约 15 秒
 - session 也会被清掉，所以下一条消息会重新读取最新的 `AGENTS.md` / skill
 
 建议做法：
@@ -143,4 +149,4 @@ curl -H "X-API-Key: $CLAW_GATEWAY_API_KEY" "$CLAW_GATEWAY_URL/healthz"
 
 ### 返回的是 `/preview/:uuid` 或内部地址
 
-`1.0.10` 起，插件会在 `output` 交付物场景下自动把相对/内部 preview 地址修正为最终的外部 `output` 直链，不再依赖 gateway 当前环境里是否显式配置了 `deliverable.gatewayPublicUrl`；同时会尽量保留原始文件后缀，并把成功后的用户回复拆成“摘要 + 纯链接”两段式。
+`1.0.14` 起，安装脚本会在落盘新的 `deliverables.js` 后自动刷新正在运行的旧 MCP 进程，避免出现“插件目录和 `extensions-extra` 都是新代码，但 `~/.openclaw/mcp-servers/deliverables.js` 对应的常驻进程仍返回旧 `reply_markdown`”的问题。此前 `1.0.13` 已经完成 `output` 直链修正、后缀保留，以及 palz-connector 中“内容简介 + 链接”自动拆成两条消息，第二条只保留一个最终 HTTPS 链接。

package/agents-rules/deliverables.md

@@ -1,5 +1,5 @@
 <!-- DELIVERABLE_LINK_RULES_START -->
-## Deliverables -- Two Reply Link Rule (HARD CONSTRAINT)
+## Deliverables -- URL Echo Rule (HARD CONSTRAINT)
 
 When you call the deliverables upload tool, the user-facing output MUST make the deliverable easy to open and easy to understand.
 
@@ -12,40 +12,28 @@ Tool name note:
 
 ### Required output behavior
 
-0. If the current session exposes a tool literally named `message`, you MUST send **two visible replies** after a successful upload:
-   - first reply: use the `message` tool to send a pure content summary only
-   - second reply: use the normal final assistant reply to send pure links only
-1. The first reply (via `message` tool) MUST:
-   - be based on the actual content/request, not a fixed boilerplate
-   - contain no links, no raw URL, no workspace path
-   - use Markdown structure, preferably:
-     - a short title or summary line
-     - `### 内容概览`
-     - 3-6 bullet points describing the real sections, highlights, features, or focus
-   - be noticeably more informative than one sentence; for normal articles/reports/introductions, aim for roughly 80-220 Chinese characters total
-2. The second reply (final assistant reply) MUST contain links only, with no extra intro, no trailing explanation, no workspace path, and no naked long URL.
-3. If tool result contains `reply_markdown`, the second reply MUST be exactly that link block verbatim. Do not rewrite the links inside it.
-4. If tool result has `preview_url`, include one line:
-   `预览链接：[点击预览](<full_url>)`
-5. If tool result has `download_url`, include one line:
-   `下载链接：[点击下载](<full_url>)`
-6. For multi-file/game deliverables, if tool result already formats the second line as
-   `文件列表：[查看目录](<full_url>)`
-   then keep that exact label and URL. Do not rewrite it back to a raw long link.
-7. Keep URL target value exactly from tool result (no shortening, no masking, no redirect rewrite).
-8. Use short link labels (`点击预览` / `点击下载` / `查看目录`) to avoid exposing long raw URLs.
-9. Do not stop after the first `message` call; you still owe the second visible links reply.
-10. If the current session does **not** expose a `message` tool, fall back to one Markdown final reply: content summary first, then the link block.
+0. Your final assistant message MUST start with a richer Markdown intro section, not a single short confirmation sentence.
+1. The intro must be based on the actual content/request, not a fixed boilerplate like `交付物已上传成功，可直接在线预览或下载。`
+2. The intro SHOULD use Markdown structure, preferably:
+   - a short title or summary line
+   - a `### 内容概览` section
+   - 3-6 bullet points describing the actual sections, highlights, features, or focus of the deliverable
+3. The intro should be noticeably more informative than one sentence. For normal articles/reports/introductions, aim for roughly 80-200 Chinese characters total before the links.
+4. The bullet points must describe the real deliverable content. Do not use empty filler like "内容丰富" / "结构清晰" / "值得阅读" unless paired with concrete details.
+5. If tool result contains `reply_markdown`, append a `### 访问链接` heading and then append that field verbatim on the following line. Do not rewrite the URL inside it.
+6. Otherwise, if tool result has `primary_url`, output only that one full URL on its own line after `### 访问链接`.
+7. If `primary_url` is missing, fall back to exactly one link: prefer `preview_url`, otherwise `download_url`.
+8. Keep URL target value exactly from tool result (no shortening, no masking, no redirect rewrite).
+9. Only output one final deliverable URL. Do not output both preview and download.
+10. Keep the intro concise but substantive; do not paste the full file content, saved-path text, or a huge essay after the URL.
 
 ### Forbidden output behavior
 
 - "可点击预览链接查看" but no actual URL
-- Putting links into the first summary reply
-- Putting extra narrative text into the second pure-links reply
+- A single short sentence plus links when the deliverable is an article/report/introduction and concrete highlights are available
 - Replacing URL target with a non-original URL
-- Omitting both links when tool already returned links
-- Outputting only naked long URL without Markdown link label
-- Replacing `文件列表：[查看目录](...)` with a naked URL or a zip description
+- Omitting the final URL when the tool already returned one
+- Outputting both preview and download when one shareable URL is enough
 - Using a generic boilerplate intro that does not mention the actual deliverable content
 <!-- DELIVERABLE_LINK_RULES_END -->
 
@@ -74,24 +62,18 @@ Tool name note:
 6. For multi-file deliverables (game/site), you MUST prefer `type=game` with `files[]`, keep files as a folder structure, and do NOT zip before upload unless the user explicitly asks for a zip package.
 7. Static multi-file game/site deliverables SHOULD include a root `index.html` so the preview link can open the homepage directly.
 8. If a generated project requires starting a separate backend service, custom port, database, or long-running process to work, do NOT pretend the deliverables preview can run it. Tell the user that deliverables preview only supports static output, and that runtime projects need deployment/ingress instead.
-9. After successful upload, if `message` tool is available, you MUST:
-   - first send a richer Markdown content summary through `message`
-   - then send a second pure-links final reply
-10. The summary must be based on the actual deliverable content/request, not a fixed sentence like `交付物已上传成功，可直接在线预览或下载。`
-11. Prefer this Markdown structure for the first summary reply:
+9. After successful upload, the final assistant message MUST start with a richer Markdown intro section, not just one short sentence.
+10. The intro must be based on the actual deliverable content/request, not a fixed sentence like `交付物已上传成功，可直接在线预览或下载。`
+11. Prefer this Markdown structure:
    - a short title or summary line
    - `### 内容概览`
    - 3-6 bullet points summarizing the actual content sections, highlights, or key features
-12. For ordinary articles/reports/introductions, the summary should normally reach roughly 80-220 Chinese characters total.
-13. If tool result contains `reply_markdown`, the second reply MUST output that field verbatim and nothing else.
-14. Otherwise the second reply MUST include only Markdown links (short label + full URL target):
-   `预览链接：[点击预览](<full_url>)`
-   `下载链接：[点击下载](<full_url>)`
-15. For multi-file/game deliverables, if the tool gives directory-style output, the second line may be:
-   `文件列表：[查看目录](<full_url>)`
-   Keep that format instead of forcing a zip link.
+12. For ordinary articles/reports/introductions, the intro before the links should normally reach roughly 80-200 Chinese characters total.
+13. If tool result contains `reply_markdown`, add `### 访问链接` and append that field verbatim on the following line.
+14. Otherwise final reply MUST include exactly one full URL after `### 访问链接`: prefer `primary_url`, otherwise `preview_url`, otherwise `download_url`.
+15. Do NOT output preview/download two条链接，也不要把目录链接再包装成 zip 说明。
 16. Do NOT only say "已保存到工作空间".
-17. Do NOT append workspace path or a raw URL block after the Markdown links.
+17. Do NOT append workspace path or extra raw URL blocks after the final URL.
 
 ### Exception
 

package/index.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+"use strict";
+
+var FETCH_PATCH_KEY = "__plugin_deliverables_palz_fetch_patch__";
+
+function isString(value) {
+  return typeof value === "string";
+}
+
+function trimTrailingBlankLines(lines) {
+  var 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) {
+  var text = String(line || "").trim();
+  if (!text) {
+    return "";
+  }
+  var markdownLink = text.match(/\((https?:\/\/[^)\s]+)\)\s*$/iu);
+  if (markdownLink && markdownLink[1]) {
+    return markdownLink[1].trim();
+  }
+  var rawLink = text.match(/https?:\/\/\S+/iu);
+  if (rawLink && rawLink[0]) {
+    return rawLink[0].trim();
+  }
+  return "";
+}
+
+function isDeliverableLinkLine(line) {
+  var text = String(line || "");
+  if (/^\s*(?:[-*+]\s+)?(?:预览链接|下载链接|文件列表|项目入口|在线预览|在线体验|目录链接)\s*[:：]\s*\[[^\]]+\]\([^)]+\)\s*$/u.test(text)) {
+    return true;
+  }
+  return !!extractDeliverableURL(text);
+}
+
+function splitDeliverableMessage(text) {
+  var normalized = String(text || "").replace(/\r\n/g, "\n").trim();
+  if (!normalized) {
+    return null;
+  }
+
+  var lines = normalized.split("\n");
+  var firstLinkIndex = -1;
+  var i;
+  for (i = 0; i < lines.length; i += 1) {
+    if (isDeliverableLinkLine(lines[i])) {
+      firstLinkIndex = i;
+      break;
+    }
+  }
+  if (firstLinkIndex < 0) {
+    return null;
+  }
+
+  var summaryLines = trimTrailingBlankLines(lines.slice(0, firstLinkIndex));
+  if (summaryLines.length > 0 && isLinksHeading(summaryLines[summaryLines.length - 1])) {
+    summaryLines.pop();
+  }
+  summaryLines = trimTrailingBlankLines(summaryLines);
+
+  var linkLines = [];
+  for (i = firstLinkIndex; i < lines.length; i += 1) {
+    var line = lines[i];
+    if (isLinksHeading(line)) {
+      continue;
+    }
+    if (isDeliverableLinkLine(line)) {
+      var url = extractDeliverableURL(stripBulletPrefix(line));
+      if (url) {
+        linkLines.push(url);
+      }
+    }
+  }
+
+  var summary = summaryLines.join("\n").trim();
+  var links = linkLines.length > 0 ? linkLines[0] : "";
+  if (!summary || !links) {
+    return null;
+  }
+
+  return {
+    summary: summary,
+    links: links,
+  };
+}
+
+function cloneBody(body, content, suffix) {
+  var next = {};
+  Object.keys(body).forEach(function(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 installPalzFetchPatch(api) {
+  if (globalThis[FETCH_PATCH_KEY] && globalThis[FETCH_PATCH_KEY].installed) {
+    return;
+  }
+  var originalFetch = globalThis.fetch;
+  if (typeof originalFetch !== "function") {
+    api.logger.warn && api.logger.warn("[plugin-deliverables] global fetch is unavailable; split patch skipped");
+    return;
+  }
+
+  var patchedFetch = async function(input, init) {
+    var url = resolveFetchURL(input);
+    var method = resolveFetchMethod(input, init);
+    if (method !== "POST" || !/\/bot\/send(?:\?|$)/.test(url)) {
+      return originalFetch(input, init);
+    }
+
+    var requestBody = init && init.body;
+    if (!isString(requestBody)) {
+      return originalFetch(input, init);
+    }
+
+    var parsed;
+    try {
+      parsed = JSON.parse(requestBody);
+    } catch (err) {
+      return originalFetch(input, init);
+    }
+
+    var split = shouldSplitPalzPayload(parsed);
+    if (!split) {
+      return originalFetch(input, init);
+    }
+
+    api.logger.info &&
+      api.logger.info(
+        "[plugin-deliverables] split deliverable reply for palz target=" +
+          String(parsed.conversation_id || ""),
+      );
+
+    var baseInit = Object.assign({}, init);
+    var summaryInit = Object.assign({}, baseInit, {
+      body: JSON.stringify(cloneBody(parsed, split.summary, "__summary")),
+    });
+    var linksInit = Object.assign({}, baseInit, {
+      body: JSON.stringify(cloneBody(parsed, split.links, "__links")),
+    });
+
+    var firstResponse = await originalFetch(input, summaryInit);
+    if (!firstResponse || !firstResponse.ok) {
+      return firstResponse;
+    }
+    return originalFetch(input, linksInit);
+  };
+
+  globalThis.fetch = patchedFetch;
+  globalThis[FETCH_PATCH_KEY] = {
+    installed: true,
+    originalFetch: originalFetch,
+  };
+}
+
+function register(api) {
+  installPalzFetchPatch(api);
+}
+
+module.exports = register;
+module.exports.default = register;
+module.exports.id = "plugin-deliverables";

package/install.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 
+var childProcess = require("child_process");
 var fs = require("fs");
 var os = require("os");
 var path = require("path");
@@ -134,6 +135,10 @@ function samePath(a, b) {
 
 function copyRecursive(src, dst, dryRun) {
   var stat = fs.lstatSync(src);
+  var baseName = path.basename(src);
+  if (baseName.indexOf("._") === 0 || /\.tgz$/i.test(baseName)) {
+    return;
+  }
   if (stat.isSymbolicLink()) {
     var target = fs.realpathSync(src);
     copyRecursive(target, dst, dryRun);
@@ -142,7 +147,7 @@ function copyRecursive(src, dst, dryRun) {
   if (stat.isDirectory()) {
     ensureDir(dst, dryRun);
     fs.readdirSync(src).forEach(function(entry) {
-      if (entry === "node_modules" || entry === ".git") return;
+      if (entry === "node_modules" || entry === ".git" || entry.indexOf("._") === 0 || /\.tgz$/i.test(entry)) return;
       copyRecursive(path.join(src, entry), path.join(dst, entry), dryRun);
     });
     return;
@@ -163,6 +168,25 @@ function replaceDirectory(src, dst, dryRun) {
   return true;
 }
 
+function stagePluginRoot(pluginRoot, dryRun) {
+  if (dryRun) {
+    return {
+      path: pluginRoot,
+      cleanup: function() {}
+    };
+  }
+  var stageDir = fs.mkdtempSync(path.join(os.tmpdir(), "plugin-deliverables-"));
+  copyRecursive(pluginRoot, stageDir, false);
+  return {
+    path: stageDir,
+    cleanup: function() {
+      try {
+        fs.rmSync(stageDir, { recursive: true, force: true });
+      } catch (err) {}
+    }
+  };
+}
+
 function normalizePluginEntryMap(entriesCfg, pluginId) {
   if (!isPlainObject(entriesCfg)) return {};
   var merged = {};
@@ -317,11 +341,25 @@ function applyPluginConfig(cfg, manifest, home) {
   if (!isPlainObject(cfg)) cfg = {};
   var pluginId = normalizeRuntimeName(manifest.name || "plugin-deliverables");
   var mcpRoot = path.join(home, "mcp-servers");
+  var extensionsExtraDir = path.join(home, "extensions-extra", pluginId);
 
   cfg.plugins = isPlainObject(cfg.plugins) ? cfg.plugins : {};
   cfg.plugins.allow = Array.isArray(cfg.plugins.allow) ? cfg.plugins.allow.slice() : [];
   if (cfg.plugins.allow.indexOf(pluginId) === -1) cfg.plugins.allow.push(pluginId);
   cfg.plugins.entries = isPlainObject(cfg.plugins.entries) ? cfg.plugins.entries : {};
+  cfg.plugins.load = isPlainObject(cfg.plugins.load) ? cfg.plugins.load : {};
+  var existingLoadPaths = Array.isArray(cfg.plugins.load.paths) ? cfg.plugins.load.paths.slice() : [];
+  var nextLoadPaths = [];
+  var seenLoadPaths = {};
+  [extensionsExtraDir].concat(existingLoadPaths).forEach(function(rawPath) {
+    var item = String(rawPath || "").trim();
+    if (!item) return;
+    var key = path.resolve(item);
+    if (seenLoadPaths[key]) return;
+    seenLoadPaths[key] = true;
+    nextLoadPaths.push(item);
+  });
+  cfg.plugins.load.paths = nextLoadPaths;
 
   var manifestPluginCfg = isPlainObject(manifest.openclaw_config) ? resolveEnvDeep(manifest.openclaw_config) : {};
   var desiredEntries = {};
@@ -392,6 +430,53 @@ function installMcpServers(pluginRoot, manifest, home, dryRun) {
   return copied;
 }
 
+function restartMcpServers(manifest, home, dryRun) {
+  var targets = [];
+  if (!isPlainObject(manifest.mcp_servers)) return targets;
+
+  Object.keys(manifest.mcp_servers).forEach(function(serverName) {
+    var server = manifest.mcp_servers[serverName];
+    if (!isPlainObject(server) || typeof server.script !== "string" || !server.script.trim()) return;
+    targets.push(path.join(home, "mcp-servers", path.basename(server.script)));
+  });
+
+  if (dryRun || targets.length === 0) return [];
+
+  var raw = "";
+  try {
+    raw = childProcess.execFileSync("ps", ["-eo", "pid=,args="], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+  } catch (err) {
+    return [];
+  }
+
+  var restarted = [];
+  raw.split(/\r?\n/).forEach(function(line) {
+    var match = line.match(/^\s*(\d+)\s+(.*)$/);
+    if (!match) return;
+    var pid = parseInt(match[1], 10);
+    var args = match[2] || "";
+    if (!pid || pid === process.pid) return;
+    var matchedTarget = "";
+    targets.some(function(target) {
+      if (args.indexOf(target) >= 0) {
+        matchedTarget = target;
+        return true;
+      }
+      return false;
+    });
+    if (!matchedTarget) return;
+    try {
+      process.kill(pid, "SIGTERM");
+      restarted.push({ pid: pid, script: matchedTarget });
+    } catch (err) {}
+  });
+
+  return restarted;
+}
+
 function clearSessions(home, dryRun) {
   var cleared = [];
   var agentsRoot = path.join(home, "agents");
@@ -416,7 +501,10 @@ function main() {
   var home = path.resolve(args.home);
   var manifestPath = path.join(pluginRoot, "openclaw-plugin.json");
   if (!fs.existsSync(manifestPath)) {
-    throw new Error("missing openclaw-plugin.json at " + manifestPath);
+    manifestPath = path.join(pluginRoot, "openclaw.plugin.json");
+  }
+  if (!fs.existsSync(manifestPath)) {
+    throw new Error("missing plugin manifest at " + path.join(pluginRoot, "openclaw-plugin.json"));
   }
   var manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
   var pluginName = normalizeRuntimeName(manifest.name || "plugin-deliverables");
@@ -426,32 +514,40 @@ function main() {
   var agentIDs = collectAgentIDs(home, currentConfig);
   var extensionsDir = path.join(home, "extensions", pluginName);
   var extensionsExtraDir = path.join(home, "extensions-extra", pluginName);
+  var staged = stagePluginRoot(pluginRoot, args.dryRun);
 
-  ensureDir(home, args.dryRun);
-  replaceDirectory(pluginRoot, extensionsDir, args.dryRun);
-  replaceDirectory(pluginRoot, extensionsExtraDir, args.dryRun);
-  var mcpFiles = installMcpServers(pluginRoot, manifest, home, args.dryRun);
-  var skillFiles = installSkills(pluginRoot, manifest, home, workspaceRoots, agentIDs, args.dryRun);
-  var agentFiles = injectRules(pluginRoot, manifest, workspaceRoots, args.dryRun);
-  var nextConfig = applyPluginConfig(currentConfig, manifest, home);
-  writeJSON(openclawPath, nextConfig, args.dryRun);
-  var clearedSessions = args.clearSessions ? clearSessions(home, args.dryRun) : [];
-
-  var summary = {
-    plugin: pluginName,
-    version: manifest.version || "",
-    openclaw_home: home,
-    dry_run: args.dryRun,
-    copied_extensions: [extensionsDir, extensionsExtraDir],
-    mcp_servers: mcpFiles,
-    skill_files: skillFiles.length,
-    agents_files: agentFiles,
-    cleared_sessions: clearedSessions.length,
-    openclaw_json: openclawPath
-  };
-  console.log(JSON.stringify(summary, null, 2));
-  if (!args.dryRun) {
-    console.log("Install complete. Wait about 15s for OpenClaw to reload plugins.allow, then send a new message to verify.");
+  try {
+    ensureDir(home, args.dryRun);
+    replaceDirectory(staged.path, extensionsDir, args.dryRun);
+    replaceDirectory(staged.path, extensionsExtraDir, args.dryRun);
+    var mcpFiles = installMcpServers(staged.path, manifest, home, args.dryRun);
+    var restartedMcpServers = restartMcpServers(manifest, home, args.dryRun);
+    var skillFiles = installSkills(staged.path, manifest, home, workspaceRoots, agentIDs, args.dryRun);
+    var agentFiles = injectRules(staged.path, manifest, workspaceRoots, args.dryRun);
+    var nextConfig = applyPluginConfig(currentConfig, manifest, home);
+    writeJSON(openclawPath, nextConfig, args.dryRun);
+    var clearedSessions = args.clearSessions ? clearSessions(home, args.dryRun) : [];
+
+    var summary = {
+      plugin: pluginName,
+      version: manifest.version || "",
+      openclaw_home: home,
+      dry_run: args.dryRun,
+      copied_extensions: [extensionsDir, extensionsExtraDir],
+      mcp_servers: mcpFiles,
+      restarted_mcp_servers: restartedMcpServers,
+      skill_files: skillFiles.length,
+      agents_files: agentFiles,
+      cleared_sessions: clearedSessions.length,
+      openclaw_json: openclawPath,
+      load_paths: nextConfig.plugins && nextConfig.plugins.load ? nextConfig.plugins.load.paths : []
+    };
+    console.log(JSON.stringify(summary, null, 2));
+    if (!args.dryRun) {
+      console.log("Install complete. Wait about 15s for OpenClaw to reload plugins.allow/plugins.load.paths, then send a new message to verify.");
+    }
+  } finally {
+    staged.cleanup();
   }
 }
 

package/mcp-servers/deliverables.js

@@ -28,7 +28,7 @@ var TOOL_DEFS = [
   {
     name: "upload_deliverable",
     description: [
-      "将 AI 生成的内容（文章、游戏、图片等）上传为交付物，返回可分享的下载/预览链接。",
+      "将 AI 生成的内容（文章、游戏、图片等）上传为交付物，返回一个可直接分享的访问链接。",
       "单文件交付物：提供 content_text 或 content_base64。",
       "多文件交付物（网页游戏/静态站点等）：必须优先提供 files 列表，每项包含 name（相对路径）和 content_text 或 content_base64，不要先打 zip。",
       "静态多文件预览建议在根目录提供 index.html；需要单独启动端口/后端服务的项目不属于交付物预览范围，应走部署流程。",
@@ -410,26 +410,18 @@ function formatGatewayError(statusCode, message, traceID) {
   return msg;
 }
 
-function buildReplyMarkdown(opts) {
+function resolvePrimaryURL(opts) {
   var previewURL = opts.previewURL || "";
   var downloadURL = opts.downloadURL || "";
-  var deliverableType = opts.type || "";
-  var isDirectory = !!opts.isDirectory;
-  var lines = [];
-  if (previewURL) {
-    lines.push("预览链接：[点击预览](" + previewURL + ")");
-  }
-  if (downloadURL) {
-    if (isDirectory || deliverableType === "game") {
-      lines.push("文件列表：[查看目录](" + downloadURL + ")");
-    } else {
-      lines.push("下载链接：[点击下载](" + downloadURL + ")");
-    }
-  }
-  if (lines.length === 0 && !previewURL && !downloadURL) {
+  return previewURL || downloadURL || "";
+}
+
+function buildReplyMarkdown(opts) {
+  var primaryURL = resolvePrimaryURL(opts);
+  if (!primaryURL) {
     return "交付物已上传成功。";
   }
-  return lines.join("\n");
+  return primaryURL;
 }
 
 function resolveReplyURLs(data, args, body) {
@@ -497,12 +489,19 @@ function uploadDeliverable(args) {
         type: args.type,
         isDirectory: isDirectory
       });
+      var primaryURL = resolvePrimaryURL({
+        previewURL: previewURL,
+        downloadURL: downloadURL,
+        type: args.type,
+        isDirectory: isDirectory
+      });
       return {
         uuid:         d.uuid,
         file_name:    finalFileName,
         backend:      d.backend || "",
         download_url: downloadURL,
         preview_url:  previewURL,
+        primary_url:  primaryURL,
         expire_at:    d.expireAt,
         is_directory: isDirectory,
         reply_markdown: replyMarkdown,
@@ -534,7 +533,7 @@ function handleMessage(msg) {
       send({ jsonrpc: "2.0", id: id, result: {
         protocolVersion: "2024-11-05",
         capabilities: { tools: {} },
-        serverInfo: { name: "deliverables", version: "1.0.10" }
+        serverInfo: { name: "deliverables", version: "1.0.14" }
       }});
       return Promise.resolve();
 

package/openclaw-plugin.json

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

@@ -0,0 +1,11 @@
+{
+  "id": "plugin-deliverables",
+  "name": "Deliverables Plugin",
+  "version": "1.0.14",
+  "description": "Split deliverable replies into summary and link messages for Palz outbound sends.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,16 +1,24 @@
 {
   "name": "@dai_ming/plugin-deliverables",
-  "version": "1.0.10",
-  "description": "OpenClaw deliverables plugin — upload AI-generated files to OSS and return shareable preview/download links",
+  "version": "1.0.14",
+  "description": "OpenClaw deliverables plugin — upload AI-generated files to OSS and return a shareable access link",
   "keywords": [
     "openclaw",
     "plugin",
     "deliverables",
     "mcp"
   ],
+  "main": "index.js",
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ]
+  },
   "license": "MIT",
   "files": [
+    "index.js",
     "install.js",
+    "openclaw.plugin.json",
     "openclaw-plugin.json",
     "mcp-servers/",
     "skills/",

package/skills/deliverables/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: deliverables
-description: 上传AI生成的文件到交付物系统，返回可分享的预览链接
+description: 上传AI生成的文件到交付物系统，返回一个可直接分享的访问链接
 ---
 
 # 文件交付规则（强制）
@@ -59,25 +59,19 @@ files: [
 ## 上传成功后
 
 优先规则：
-- 如果当前会话里存在一个名字就叫 `message` 的工具，上传成功后必须发两条可见回复：
-  - 第一条：通过 `message` 工具发送，只写内容介绍，不放链接
-  - 第二条：正常最终回复里只放链接，不加额外介绍
-- 第一条内容介绍建议结构是：
+- 最终消息必须先给出一段更完整的 Markdown 介绍，不要只写一句短确认。
+- 建议结构是：
   - 一行简短标题或总结
   - `### 内容概览`
   - 3-6 个 bullet，概括这份产物实际包含的章节、重点、亮点或功能
 - 这段介绍必须基于实际产物内容，不要使用固定模板，例如：`交付物已上传成功，可直接在线预览或下载。`
-- 对于常见文章、介绍、报告类交付物，第一条介绍通常应达到约 80-220 个中文字符，明显长于一句话确认。
+- 对于常见文章、介绍、报告类交付物，链接前的介绍通常应达到约 80-200 个中文字符，明显长于一句话确认。
 - bullet 必须写具体内容，例如“基本信息、代表作品、奖项与影响力”，不要只写“内容完整、结构清晰”这类空话。
-- 第一条介绍里不要放工作区路径、裸链接、Markdown 链接或下载提示。
-- 第二条链接回复里，如果工具结果有 `reply_markdown`，直接原样输出它，不要改写，不要再加标题或说明。
-- 第二条链接回复只允许包含：
-  - `预览链接：[点击预览](...)`
-  - `下载链接：[点击下载](...)`
-  - 或目录场景下的 `文件列表：[查看目录](...)`
-- 不要把第一条和第二条混在一起，也不要在第二条链接消息里再补“已完成”“请查看”等多余文字。
-
-回退规则：
-- 如果当前会话没有 `message` 工具，再退回成一条最终 Markdown 回复：先介绍，再附链接。
-
-不要在消息里输出文件的完整内容、工作区保存路径或裸链接，也不要只输出“一句简介 + 两个链接”这种过短格式。
+- 如果工具结果里有 `reply_markdown`，先输出 `### 访问链接`，再把它原样放在后面，不要改写其中的 URL。
+- 否则只输出一个最终链接：
+  - 优先 `primary_url`
+  - 没有就退回 `preview_url`
+  - 再没有才用 `download_url`
+- 不要同时输出“预览链接 + 下载链接”两条。
+
+不要在消息里输出文件的完整内容、工作区保存路径，也不要只输出“一句简介 + 两个链接”这种过短格式。