@dai_ming/plugin-deliverables 1.0.7 → 1.0.10

package/README.md

@@ -2,6 +2,13 @@
 
 OpenClaw 交付物插件。安装后会把交付物 MCP、skill、AGENTS 规则和 `openclaw.json` 配置一次性落到运行目录里，让 Agent 默认把生成文件上传成可访问的交付物链接。
 
+当前版本增强点：
+
+- 上传成功后优先走“两条回复”体验：
+  - 第一条是内容摘要
+  - 第二条是纯 Markdown 链接
+- 单文件交付物会尽量保留原始文件后缀；如果模型漏掉后缀，插件会按内容类型自动补齐（如 `.md` / `.html`）
+
 ## 包内文件
 
 | 文件 | 作用 |
@@ -20,7 +27,7 @@ OpenClaw 交付物插件。安装后会把交付物 MCP、skill、AGENTS 规则
 
 ```yaml
 installPlugins:
-  - "@dai_ming/plugin-deliverables@1.0.7"
+  - "@dai_ming/plugin-deliverables@1.0.10"
 ```
 
 现有 chart 会在 init 阶段完成安装。
@@ -31,7 +38,7 @@ installPlugins:
 
 ```bash
 npm config set registry https://registry.npmmirror.com
-npm install @dai_ming/plugin-deliverables@1.0.7
+npm install @dai_ming/plugin-deliverables@1.0.10
 node node_modules/@dai_ming/plugin-deliverables/install.js
 ```
 
@@ -133,3 +140,7 @@ env | grep -E 'CLAW_GATEWAY|OPENCLAW_GATEWAY|botID'
 ```bash
 curl -H "X-API-Key: $CLAW_GATEWAY_API_KEY" "$CLAW_GATEWAY_URL/healthz"
 ```
+
+### 返回的是 `/preview/:uuid` 或内部地址
+
+`1.0.10` 起，插件会在 `output` 交付物场景下自动把相对/内部 preview 地址修正为最终的外部 `output` 直链，不再依赖 gateway 当前环境里是否显式配置了 `deliverable.gatewayPublicUrl`；同时会尽量保留原始文件后缀，并把成功后的用户回复拆成“摘要 + 纯链接”两段式。

package/agents-rules/deliverables.md

@@ -1,7 +1,7 @@
 <!-- DELIVERABLE_LINK_RULES_START -->
-## Deliverables -- URL Echo Rule (HARD CONSTRAINT)
+## Deliverables -- Two Reply Link 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:
 
@@ -12,32 +12,36 @@ Tool name note:
 
 ### Required output behavior
 
-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 lines. Do not rewrite the links inside it.
-6. If tool result has `preview_url`, include one line:
+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>)`
-7. If tool result has `download_url`, include one line:
+5. 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
+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.
-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.
+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.
 
 ### 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
+- Putting links into the first summary reply
+- Putting extra narrative text into the second pure-links reply
 - 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
@@ -61,20 +65,26 @@ 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.
-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:
+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:
    - 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 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):
+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:

package/mcp-servers/deliverables.js

@@ -14,13 +14,15 @@
 
 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 GATEWAY_PUBLIC = (process.env.CLAW_GATEWAY_PUBLIC_URL || GATEWAY_URL).replace(/\/$/, "");
+var RAW_GATEWAY_PUBLIC = (process.env.CLAW_GATEWAY_PUBLIC_URL || GATEWAY_URL).replace(/\/$/, "");
 // Some existing pods were created without CLAW_GATEWAY_API_KEY injected.
 // Keep env-driven behavior first, but provide a dev-compatible fallback to avoid
 // breaking deliverable uploads during rolling migration.
 var API_KEY        = process.env.CLAW_GATEWAY_API_KEY || process.env.OPENCLAW_GATEWAY_API_KEY || "api-key-1";
+var GATEWAY_PUBLIC = resolveGatewayPublicBase();
 
 var TOOL_DEFS = [
   {
@@ -54,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",
@@ -93,6 +95,269 @@ function parseURL(rawURL) {
   }
 }
 
+function isPrivateIPv4(hostname) {
+  if (!hostname) return false;
+  if (/^10\./.test(hostname)) return true;
+  if (/^127\./.test(hostname)) return true;
+  if (/^192\.168\./.test(hostname)) return true;
+  var m = hostname.match(/^172\.(\d+)\./);
+  if (m) {
+    var second = parseInt(m[1], 10);
+    return second >= 16 && second <= 31;
+  }
+  return false;
+}
+
+function isInternalHostname(hostname) {
+  var host = String(hostname || "").toLowerCase();
+  if (!host) return false;
+  if (host === "localhost" || host === "claw-gateway") return true;
+  if (host.indexOf(".svc") >= 0 || host.indexOf(".cluster.local") >= 0) return true;
+  if (host.indexOf("claw-gateway:") === 0) return true;
+  if (isPrivateIPv4(host)) return true;
+  if (host.indexOf(".") < 0) return true;
+  return false;
+}
+
+function isProbablyInternalURL(rawURL) {
+  var parsed = parseURL(rawURL);
+  if (!parsed) return false;
+  return isInternalHostname(parsed.hostname);
+}
+
+function envGatewayPublicFallback() {
+  var helmEnv = String(process.env.HELM_ENV || process.env.ENV || "").toLowerCase();
+  if (helmEnv === "prod" || helmEnv === "production" || helmEnv === "online") {
+    return "https://claw-gateway.csagentai.com";
+  }
+  if (helmEnv === "dev" || helmEnv === "development" || helmEnv === "staging" || helmEnv === "stage") {
+    return "https://claw-dev.csaiagent.com";
+  }
+  return "";
+}
+
+function resolveGatewayPublicBase() {
+  var candidate = RAW_GATEWAY_PUBLIC;
+  if (candidate && !isProbablyInternalURL(candidate)) {
+    return candidate;
+  }
+  var fallback = envGatewayPublicFallback();
+  if (fallback) {
+    return fallback.replace(/\/$/, "");
+  }
+  return candidate;
+}
+
+function absolutizePublicURL(rawURL) {
+  var val = String(rawURL || "").trim();
+  if (!val) return "";
+  if (/^https?:\/\//i.test(val)) {
+    if (isProbablyInternalURL(val) && GATEWAY_PUBLIC && !isProbablyInternalURL(GATEWAY_PUBLIC)) {
+      var parsed = parseURL(val);
+      if (parsed) {
+        return GATEWAY_PUBLIC + parsed.pathname + (parsed.search || "") + (parsed.hash || "");
+      }
+    }
+    return val;
+  }
+  if (val.charAt(0) !== "/") {
+    val = "/" + val;
+  }
+  return (GATEWAY_PUBLIC || RAW_GATEWAY_PUBLIC || "").replace(/\/$/, "") + val;
+}
+
+function outputPublicBase() {
+  return absolutizePublicURL("/openclaw-gateway/output");
+}
+
+function encodePathSegments(parts) {
+  return parts.map(function(part) {
+    return encodeURIComponent(String(part || ""));
+  }).join("/");
+}
+
+function sanitizePathSegment(v) {
+  var s = String(v || "").trim();
+  if (!s) return "unknown";
+  s = s.replace(/\//g, "_");
+  s = s.replace(/\\/g, "_");
+  s = s.replace(/\.\./g, "_");
+  return s;
+}
+
+function sanitizeFileName(v) {
+  var name = String(v || "").trim();
+  if (!name) return "file";
+  name = name.replace(/^.*[\/\\]/, "");
+  name = name.replace(/\//g, "_");
+  name = name.replace(/\\/g, "_");
+  name = name.replace(/\.\./g, "_");
+  if (!name || name === ".") return "file";
+  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_";
+  if (!trimmed || trimmed.indexOf(prefix) !== 0) {
+    return "";
+  }
+  var rest = trimmed.slice(prefix.length);
+  var end = rest.indexOf("_");
+  if (end <= 0) {
+    return "";
+  }
+  return rest.slice(0, end);
+}
+
+function deriveRelease(release, resourceID, userID) {
+  var rel = sanitizePathSegment(release);
+  if (rel && rel !== "unknown") {
+    return rel;
+  }
+  var uid = String(userID || "").trim();
+  if (!uid) {
+    uid = extractUserIDFromResource(resourceID);
+  }
+  if (uid) {
+    return "user-" + uid;
+  }
+  return "unknown";
+}
+
+function looksLikePreviewRoute(rawURL) {
+  var val = String(rawURL || "").trim();
+  return /\/openclaw-gateway\/preview\/[^/?#]+(?:[?#].*)?$/i.test(val);
+}
+
+function needsOutputURLRepair(data) {
+  if (!data) return false;
+  if (String(data.backend || "").toLowerCase() !== "output") {
+    return false;
+  }
+  var previewURL = String(data.previewUrl || "").trim();
+  var downloadURL = String(data.downloadUrl || "").trim();
+  if (!previewURL || !downloadURL) {
+    return true;
+  }
+  if (previewURL.charAt(0) === "/" || downloadURL.charAt(0) === "/") {
+    return true;
+  }
+  if (isProbablyInternalURL(previewURL) || isProbablyInternalURL(downloadURL)) {
+    return true;
+  }
+  if (looksLikePreviewRoute(previewURL) || looksLikePreviewRoute(downloadURL)) {
+    return true;
+  }
+  return false;
+}
+
+function fetchDeliverableMeta(uuid) {
+  if (!uuid) return Promise.resolve(null);
+  return httpRequest("GET", "/openclaw-gateway/be/deliverables/" + encodeURIComponent(uuid)).then(function(resp) {
+    return resp.body.data || resp.body || null;
+  });
+}
+
+function buildOutputURLs(meta, args, body, data) {
+  var base = outputPublicBase();
+  if (!base) {
+    return null;
+  }
+  var resourceID = sanitizePathSegment((meta && meta.resourceId) || body.resourceId || args.resource_id);
+  var userID = (meta && meta.userId) || body.userId || args.user_id;
+  var release = deriveRelease((meta && meta.release) || body.release, resourceID, userID);
+  var uuid = String((meta && meta.uuid) || (data && data.uuid) || "").trim();
+  if (!resourceID || !uuid) {
+    return null;
+  }
+  var isDirectory = !!(args.files && args.files.length > 0) || String((meta && meta.mime) || "").trim() === "application/x-directory";
+  if (isDirectory) {
+    var dirURL = base.replace(/\/$/, "") + "/" + encodePathSegments([release, resourceID, uuid]);
+    return {
+      previewURL: dirURL,
+      downloadURL: dirURL + "?list=1",
+      isDirectory: true
+    };
+  }
+  var fileName = sanitizeFileName((meta && meta.fileName) || body.fileName || args.file_name);
+  var fileURL = base.replace(/\/$/, "") + "/" + encodePathSegments([release, resourceID, uuid, fileName]);
+  return {
+    previewURL: fileURL,
+    downloadURL: fileURL,
+    isDirectory: false
+  };
+}
+
 function httpRequest(method, path, body) {
   return new Promise(function(resolve, reject) {
     var parsed = parseURL(GATEWAY_URL + path);
@@ -167,15 +432,27 @@ function buildReplyMarkdown(opts) {
   return lines.join("\n");
 }
 
+function resolveReplyURLs(data, args, body) {
+  if (!needsOutputURLRepair(data)) {
+    return Promise.resolve(null);
+  }
+  return fetchDeliverableMeta(data.uuid).catch(function() {
+    return null;
+  }).then(function(meta) {
+    return buildOutputURLs(meta, args, body, data);
+  });
+}
+
 // ─── 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
   };
 
@@ -205,29 +482,34 @@ function uploadDeliverable(args) {
 
   return httpRequest("POST", "/openclaw-gateway/be/deliverables", body).then(function(resp) {
     var d = resp.body.data || resp.body;
-    // Prefer backend-aware previewUrl returned by gateway (OSS/output/link).
-    // Fallback to legacy gateway preview endpoint for compatibility.
-    var previewURL = d.previewUrl || (GATEWAY_PUBLIC + "/openclaw-gateway/preview/" + d.uuid);
-    var isDirectory = !!(args.files && args.files.length > 0);
-    if (!isDirectory && d.downloadUrl && previewURL && d.downloadUrl !== previewURL && /(?:\?|&)list=1(?:&|$)/.test(d.downloadUrl)) {
-      isDirectory = true;
-    }
-    var replyMarkdown = buildReplyMarkdown({
-      previewURL: previewURL,
-      downloadURL: d.downloadUrl,
-      type: args.type,
-      isDirectory: isDirectory
+    return resolveReplyURLs(d, args, body).then(function(repaired) {
+      // Prefer backend-aware previewUrl returned by gateway (OSS/output/link).
+      // Fallback to legacy gateway preview endpoint for compatibility.
+      var previewURL = absolutizePublicURL((repaired && repaired.previewURL) || d.previewUrl || ("/openclaw-gateway/preview/" + d.uuid));
+      var downloadURL = absolutizePublicURL((repaired && repaired.downloadURL) || d.downloadUrl);
+      var isDirectory = !!(repaired && repaired.isDirectory) || !!(args.files && args.files.length > 0);
+      if (!isDirectory && downloadURL && previewURL && downloadURL !== previewURL && /(?:\?|&)list=1(?:&|$)/.test(downloadURL)) {
+        isDirectory = true;
+      }
+      var replyMarkdown = buildReplyMarkdown({
+        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,
+        expire_at:    d.expireAt,
+        is_directory: isDirectory,
+        reply_markdown: replyMarkdown,
+        trace_id:     resp.traceID || "",
+        message: replyMarkdown
+      };
     });
-    return {
-      uuid:         d.uuid,
-      backend:      d.backend || "",
-      download_url: d.downloadUrl,
-      preview_url:  previewURL,
-      expire_at:    d.expireAt,
-      reply_markdown: replyMarkdown,
-      trace_id:     resp.traceID || "",
-      message: replyMarkdown
-    };
   });
 }
 
@@ -252,7 +534,7 @@ function handleMessage(msg) {
       send({ jsonrpc: "2.0", id: id, result: {
         protocolVersion: "2024-11-05",
         capabilities: { tools: {} },
-        serverInfo: { name: "deliverables", version: "1.0.2" }
+        serverInfo: { name: "deliverables", version: "1.0.10" }
       }});
       return Promise.resolve();
 

package/openclaw-plugin.json

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

package/package.json

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

package/skills/deliverables/SKILL.md

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