@lark-apaas/miaoda-cli 0.1.1-alpha.d20f110 → 0.1.1-alpha.ddba836

package/dist/api/file/api.js

@@ -299,18 +299,28 @@ async function preUpload(appId, req) {
 }
 /**
  * 调用 upload callback 拿到对象元数据。
- * 后端把对象 VO 序列化成 JSON 字符串放在 data.metadata 字段里，这里解析出实际
- * filePath / file_name / download_url 给 uploadFile 调用方使用，避免 CLI 自己拼路径。
+ *
+ * 网关 IDL 在 metadata 字段加了 api.response.converter = "decode"，正常路径下
+ * HTTP 响应里的 metadata 已经被网关从字符串解码成对象；这里两种形态都兼容：
+ *   - object → 直接当 CallbackObjectVO 用（网关解码场景）
+ *   - string → JSON.parse 出来用（后端原始形态 / 网关行为变化兜底）
+ *
+ * 解析失败 / metadata 缺失时返回空对象，由 uploadFile 用本地兜底字段填充。
  */
 async function uploadCallback(appId, req) {
     const url = `/v1/storage/app/${encodeURIComponent(appId)}/object/callback`;
     const body = await (0, client_1.doPost)(url, req, { errorContext: "upload callback" });
     const data = extractEnvelope(body);
-    if (!data.metadata) {
+    const metadata = data.metadata;
+    if (!metadata) {
         return {};
     }
+    if (typeof metadata === "object") {
+        return metadata;
+    }
+    // string 形态兜底
     try {
-        return JSON.parse(data.metadata);
+        return JSON.parse(metadata);
     }
     catch (err) {
         (0, logger_1.debug)(`upload callback metadata json parse failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -341,11 +351,15 @@ async function uploadFile(opts) {
         // 这里复制到独立 ArrayBuffer 以满足 lib.dom.d.ts 的 BodyInit 约束
         const ab = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
         const uploadStart = Date.now();
+        // Content-Disposition 用 attachment + filename 编码原始文件名。TOS 会把这个
+        // header 作为对象 metadata 存住，服务端 callback 阶段 HeadObject 读回并解析
+        // filename 写入 DB。我们要不传 header，服务端走兜底会把 storage key 当文件名。
         const res = await fetch(pre.uploadURL, {
             method: "PUT",
             headers: {
                 "Content-Type": opts.contentType,
                 "Content-Length": String(opts.fileSize),
+                "Content-Disposition": `attachment; filename="${sanitizeFileName(opts.fileName)}"`,
             },
             body: ab,
         });
@@ -378,6 +392,8 @@ async function uploadFile(opts) {
         ? (metadata.filePath.startsWith("/") ? metadata.filePath : "/" + metadata.filePath)
         : (opts.remotePath ?? "/" + opts.fileName);
     const result = {
+        // 优先取服务端 ObjectVO.name（来自 PUT 时带的 Content-Disposition），
+        // 与后续 file ls / file stat 返回的展示名保持一致；缺失时降级用本地 fileName。
         file_name: metadata.name ?? opts.fileName,
         path,
         size: metadata.metadata?.contentLength ?? opts.fileSize,
@@ -388,6 +404,17 @@ async function uploadFile(opts) {
     }
     return result;
 }
+/**
+ * 把文件名清理成可安全放进 Content-Disposition `filename="..."` 的形态。
+ * 与 fullstack-plugin 的 sanitizeFileName 行为一致：
+ *   1. 去掉对 TOS / 文件系统不友好的字符 [: " \ / * ? < > | , ;]
+ *   2. encodeURIComponent 把非 ASCII（中文等）做百分号编码，保证 header 合法
+ *   3. 处理后为空时退回 "download_file" 兜底
+ */
+function sanitizeFileName(fileName) {
+    const illegalChars = /[:"\\/*?<>|,;]/g;
+    return encodeURIComponent(fileName.replace(illegalChars, "")) || "download_file";
+}
 // ── 预签下载 URL ──
 /**
  * 获取预签下载 URL。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.1-alpha.d20f110",
+  "version": "0.1.1-alpha.ddba836",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {