@dai_ming/plugin-deliverables 1.0.9 → 1.0.14

package/README.md

@@ -2,15 +2,21 @@
 
 OpenClaw 交付物插件。安装后会把交付物 MCP、skill、AGENTS 规则和 `openclaw.json` 配置一次性落到运行目录里，让 Agent 默认把生成文件上传成可访问的交付物链接。
 
+当前版本增强点：
+
+- 上传成功后返回标准 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` 扩展 |
 
 ## 推荐安装方式
 
@@ -20,7 +26,7 @@ OpenClaw 交付物插件。安装后会把交付物 MCP、skill、AGENTS 规则
 
 ```yaml
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.9"
+  - "@dai_ming/plugin-deliverables@1.0.14"
 ```
 
 现有 chart 会在 init 阶段完成安装。
@@ -31,7 +37,7 @@ installPlugins:
 
 ```bash
 npm config set registry https://registry.npmmirror.com
-npm install @dai_ming/plugin-deliverables@1.0.9
+npm install @dai_ming/plugin-deliverables@1.0.14
 node node_modules/@dai_ming/plugin-deliverables/install.js
 ```
 
@@ -57,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
 
@@ -67,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
 
 建议做法：
@@ -136,4 +149,4 @@ curl -H "X-API-Key: $CLAW_GATEWAY_API_KEY" "$CLAW_GATEWAY_URL/healthz"
 
 ### 返回的是 `/preview/:uuid` 或内部地址
 
-`1.0.9` 起，插件会在 `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,7 +1,7 @@
 <!-- DELIVERABLE_LINK_RULES_START -->
 ## Deliverables -- URL Echo Rule (HARD CONSTRAINT)
 
-When you call the deliverables upload tool, your final assistant message MUST include clickable URLs in Markdown link format (short label + full URL target).
+When you call the deliverables upload tool, the user-facing output MUST make the deliverable easy to open and easy to understand.
 
 Tool name note:
 
@@ -20,28 +20,20 @@ Tool name note:
    - 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 lines. Do not rewrite the links inside it.
-6. If tool result has `preview_url`, include one line:
-   `预览链接：[点击预览](<full_url>)`
-7. If tool result has `download_url`, include one line:
-   `下载链接：[点击下载](<full_url>)`
-8. 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.
-9. Keep URL target value exactly from tool result (no shortening, no masking, no redirect rewrite).
-10. Use short link labels (`点击预览` / `点击下载` / `查看目录`) to avoid exposing long raw URLs.
-11. Do not say "已上传/已完成" without links.
-12. Do not output naked long URLs outside Markdown link syntax.
-13. Keep the intro concise but substantive; do not paste the full file content, saved-path text, or a huge essay after the Markdown links.
+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
 - 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 -->
 
@@ -61,8 +53,12 @@ Tool name note:
 1. Create content under current agent workspace `output/` directory first (for example `output/report.md`), then call the deliverables upload tool exposed in this session.
 2. If you need to use the `write` tool, the target path MUST be inside `output/`. Never write deliverable files to the workspace root.
 3. If you already wrote the file to the wrong place, move/copy it into `output/` before finalizing the task and before describing the saved path to the user.
-4. If format is HTML, prefer `type=article` and file name ends with `.html`.
-5. If format is markdown/text, use `type=article` and `.md`/`.txt`.
+4. The deliverable file name MUST preserve the intended extension exactly. Examples:
+   - Markdown article: `刘德华介绍.md`
+   - Markdown note: `周杰伦.md`
+   - HTML page: `996专题.html`
+   - Text file: `旅行清单.txt`
+5. Never drop the suffix from the final deliverable file name. If the user asked for Markdown, keep `.md`; if HTML, keep `.html`.
 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.
@@ -73,15 +69,11 @@ Tool name note:
    - `### 内容概览`
    - 3-6 bullet points summarizing the actual content sections, highlights, or key features
 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 lines.
-14. Otherwise final reply MUST include 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.
+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

@@ -14,6 +14,7 @@
 
 var http  = require("http");
 var https = require("https");
+var path  = require("path");
 
 var GATEWAY_URL    = (process.env.CLAW_GATEWAY_URL        || "http://claw-gateway:8080").replace(/\/$/, "");
 var RAW_GATEWAY_PUBLIC = (process.env.CLAW_GATEWAY_PUBLIC_URL || GATEWAY_URL).replace(/\/$/, "");
@@ -27,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；需要单独启动端口/后端服务的项目不属于交付物预览范围，应走部署流程。",
@@ -55,7 +56,7 @@ var TOOL_DEFS = [
         },
         file_name: {
           type: "string",
-          description: "用户可见的文件名，例如 adventure-game 或 report.md。多文件交付时这里应是目录名/项目名，不要写成 .zip，除非用户明确要求压缩包。"
+          description: "用户可见的文件名，必须尽量保留原始扩展名，例如 刘德华介绍.md、report.html。多文件交付时这里应是目录名/项目名，不要写成 .zip，除非用户明确要求压缩包。"
         },
         content_text: {
           type: "string",
@@ -195,6 +196,75 @@ function sanitizeFileName(v) {
   return name;
 }
 
+function fileExtension(name) {
+  return path.extname(String(name || ""));
+}
+
+function hasFileExtension(name) {
+  return !!fileExtension(name);
+}
+
+function looksLikeHTML(text) {
+  var s = String(text || "").trim().toLowerCase();
+  if (!s) return false;
+  return s.indexOf("<!doctype html") === 0 ||
+    s.indexOf("<html") === 0 ||
+    s.indexOf("<head") === 0 ||
+    s.indexOf("<body") === 0;
+}
+
+function looksLikeMarkdown(text) {
+  var s = String(text || "").trim();
+  if (!s) return false;
+  return /^#{1,6}\s+\S/m.test(s) ||
+    /^\s*[-*+]\s+\S/m.test(s) ||
+    /^\s*\d+\.\s+\S/m.test(s) ||
+    /\[[^\]]+\]\([^)]+\)/.test(s) ||
+    /```/.test(s);
+}
+
+function defaultExtensionForDeliverable(type, contentText, files) {
+  var kind = String(type || "").trim().toLowerCase();
+  if (files && files.length > 0) return "";
+  switch (kind) {
+    case "article":
+      if (looksLikeHTML(contentText)) return ".html";
+      return ".md";
+    case "game":
+      return ".html";
+    case "image":
+      return ".png";
+    case "video":
+      return ".mp4";
+    case "zip":
+      return ".zip";
+    case "ppt":
+      return ".pptx";
+    case "link":
+      return "";
+    default:
+      if (looksLikeHTML(contentText)) return ".html";
+      if (looksLikeMarkdown(contentText)) return ".md";
+      return "";
+  }
+}
+
+function normalizeDeliverableFileName(fileName, type, contentText, files) {
+  if (String(type || "").trim().toLowerCase() === "link") {
+    return String(fileName || "").trim();
+  }
+  var normalized = sanitizeFileName(fileName);
+  if (files && files.length > 0) {
+    return normalized || "deliverable";
+  }
+  if (hasFileExtension(normalized)) {
+    return normalized;
+  }
+  var ext = defaultExtensionForDeliverable(type, contentText, files);
+  if (!normalized) normalized = "deliverable";
+  return normalized + ext;
+}
+
 function extractUserIDFromResource(resourceID) {
   var trimmed = String(resourceID || "").trim();
   var prefix = "user_";
@@ -340,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) {
@@ -376,12 +438,13 @@ function resolveReplyURLs(data, args, body) {
 // ─── Tool implementations ─────────────────────────────────────────────────────
 
 function uploadDeliverable(args) {
+  var finalFileName = normalizeDeliverableFileName(args.file_name, args.type, args.content_text, args.files);
   var body = {
     resourceId: args.resource_id,
     groupId:    args.group_id,
     userId:     args.user_id,
     type:       args.type,
-    fileName:   args.file_name,
+    fileName:   finalFileName,
     release:    ""  // overwritten below after release name derivation
   };
 
@@ -426,12 +489,21 @@ 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,
         trace_id:     resp.traceID || "",
         message: replyMarkdown
@@ -461,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.9" }
+        serverInfo: { name: "deliverables", version: "1.0.14" }
       }});
       return Promise.resolve();
 

package/openclaw-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-deliverables",
-  "version": "1.0.9",
+  "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.9",
-  "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生成的文件到交付物系统，返回一个可直接分享的访问链接
 ---
 
 # 文件交付规则（强制）
@@ -21,6 +21,8 @@ description: 上传AI生成的文件到交付物系统，返回可分享的预
 - 多文件内容（游戏/网站）写到 `output/<目录名>/...`，保持目录结构。
 - 如果你使用 `write` 工具创建交付物文件，目标路径必须在 `output/` 下。
 - 如果你已经误写到工作区根目录，必须先移动或复制到 `output/`，再继续上传交付物并向用户汇报。
+- 交付物文件名必须保留原始扩展名，不要丢后缀。示例：`刘德华介绍.md`、`周杰伦.md`、`996专题.html`。
+- 如果用户要求 Markdown，就保留 `.md`；如果用户要求 HTML，就保留 `.html`；如果是纯文本，就保留 `.txt`。
 
 ## 调用前必须准备的参数（全部必填）
 
@@ -32,7 +34,7 @@ description: 上传AI生成的文件到交付物系统，返回可分享的预
 | `group_id` | 消息元数据中的 `group_id` 或 `conversation_id` | `group_abc123` |
 | `user_id` | 消息元数据中的 `sender_id` 或 `owner_id` | `cbb0fab9...` |
 | `type` | 根据内容选择：`article`/`game`/`image`/`video`/`ppt`/`zip`/`link` | `article` |
-| `file_name` | 有意义的文件名，含扩展名 | `report-2026.html` |
+| `file_name` | 有意义的文件名，必须含正确扩展名 | `report-2026.html` |
 | `content_text` | 文件的完整文本内容（HTML/Markdown等） | `<html>...</html>` |
 
 > **直接对话（direct chat）时**：`group_id` 填 `conversation_id`，`user_id` 填 `owner_id`。
@@ -65,11 +67,11 @@ files: [
 - 这段介绍必须基于实际产物内容，不要使用固定模板，例如：`交付物已上传成功，可直接在线预览或下载。`
 - 对于常见文章、介绍、报告类交付物，链接前的介绍通常应达到约 80-200 个中文字符，明显长于一句话确认。
 - bullet 必须写具体内容，例如“基本信息、代表作品、奖项与影响力”，不要只写“内容完整、结构清晰”这类空话。
-- 如果工具结果里有 `reply_markdown`，先输出 `### 访问链接`，再把它原样放在后面，不要改写其中的链接。
-
-否则只发给用户：
-- 预览链接（`preview_url`，必须用 Markdown 链接格式）
-- 下载链接（`download_url`，必须用 Markdown 链接格式）
-- 多文件/游戏目录场景下，第二行也可以是 `文件列表：[查看目录](...)`，不要改成裸 URL 或 zip 描述。
-
-不要在消息里输出文件的完整内容、工作区保存路径或裸链接，也不要只输出“一句简介 + 两个链接”这种过短格式。
+- 如果工具结果里有 `reply_markdown`，先输出 `### 访问链接`，再把它原样放在后面，不要改写其中的 URL。
+- 否则只输出一个最终链接：
+  - 优先 `primary_url`
+  - 没有就退回 `preview_url`
+  - 再没有才用 `download_url`
+- 不要同时输出“预览链接 + 下载链接”两条。
+
+不要在消息里输出文件的完整内容、工作区保存路径，也不要只输出“一句简介 + 两个链接”这种过短格式。