@lark-apaas/miaoda-cli 0.1.0-alpha.cab2450 → 0.1.0-alpha.d98ea14

package/dist/api/file/api.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTimeFilterMs = parseTimeFilterMs;
 exports.listFiles = listFiles;
 exports.resolveInputs = resolveInputs;
 exports.statFile = statFile;
@@ -82,15 +83,56 @@ function buildFilterExpr(opts) {
     }
     if (opts.uploadedSince) {
         // 后端期望毫秒 timestamp（strconv.ParseInt → time.UnixMilli）
-        const ms = Date.parse(opts.uploadedSince);
-        if (!Number.isNaN(ms)) {
-            conds.push({ field: "createdAt", operator: "gte", value: String(ms) });
-        }
+        const ms = parseTimeFilterMs(opts.uploadedSince, "--uploaded-since");
+        conds.push({ field: "createdAt", operator: "gte", value: String(ms) });
+    }
+    if (opts.uploadedUntil) {
+        const ms = parseTimeFilterMs(opts.uploadedUntil, "--uploaded-until");
+        conds.push({ field: "createdAt", operator: "lte", value: String(ms) });
     }
     if (conds.length === 0)
         return undefined;
     return { logic: "and", groups: [{ conditions: conds }] };
 }
+/**
+ * 解析时间过滤参数（--uploaded-since / --uploaded-until）的三种输入格式
+ * （→ ms timestamp）：
+ *   1. 相对时间："30s" / "10m" / "1h" / "2d" / "1w"  → 当前时间往前推 N 单位
+ *   2. 日期：    "2026-04-01"                       → 按当日 00:00:00 UTC
+ *   3. ISO 8601："2026-04-01T10:00:00Z"             → 严格解析（推荐用 Z 结尾标识 UTC）
+ *
+ * 三种格式都不命中时抛 AppError("ARGS_INVALID")，避免之前 Date.parse=NaN
+ * 时静默跳过过滤、用户却以为筛选生效的悄然失败问题。
+ *
+ * flagName 用于错误信息，调用方传 "--uploaded-since" 或 "--uploaded-until"。
+ */
+function parseTimeFilterMs(input, flagName) {
+    // 相对时间：<positive int><unit>，单位 s/m/h/d/w
+    const RELATIVE = /^(\d+)([smhdw])$/;
+    const rel = RELATIVE.exec(input);
+    if (rel) {
+        const n = parseInt(rel[1], 10);
+        if (n <= 0) {
+            throw new error_1.AppError("ARGS_INVALID", `${flagName} "${input}" 必须是正整数 + 单位（s / m / h / d / w）`);
+        }
+        const UNIT_MS = {
+            s: 1_000,
+            m: 60_000,
+            h: 3_600_000,
+            d: 86_400_000,
+            w: 604_800_000,
+        };
+        return Date.now() - n * UNIT_MS[rel[2]];
+    }
+    // 绝对时间：date / ISO 8601。Date.parse 对 "YYYY-MM-DD" 按 UTC 00:00:00 解析，
+    // 对带 Z 的 ISO 8601 也直接出 UTC ms。
+    const ms = Date.parse(input);
+    if (Number.isNaN(ms)) {
+        throw new error_1.AppError("ARGS_INVALID", `${flagName} "${input}" 格式无法识别。支持：` +
+            `相对时间（如 1h / 2d / 1w）、日期（YYYY-MM-DD）、ISO 8601（如 2026-04-01T10:00:00Z）`);
+    }
+    return ms;
+}
 /**
  * 列出文件：所有过滤下推到后端 FilterExpression，纯精确匹配，无 glob。
  *

package/dist/api/file/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
+exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "listFiles", { enumerable: true, get: function () { return api_1.listFiles; } });
 Object.defineProperty(exports, "statFile", { enumerable: true, get: function () { return api_1.statFile; } });
@@ -9,6 +9,7 @@ Object.defineProperty(exports, "signDownload", { enumerable: true, get: function
 Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function () { return api_1.downloadFile; } });
 Object.defineProperty(exports, "deleteFiles", { enumerable: true, get: function () { return api_1.deleteFiles; } });
 Object.defineProperty(exports, "resolveInputs", { enumerable: true, get: function () { return api_1.resolveInputs; } });
+Object.defineProperty(exports, "parseTimeFilterMs", { enumerable: true, get: function () { return api_1.parseTimeFilterMs; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "getDefaultBucketId", { enumerable: true, get: function () { return client_1.getDefaultBucketId; } });
 Object.defineProperty(exports, "resetBucketCache", { enumerable: true, get: function () { return client_1.resetBucketCache; } });

package/dist/cli/commands/file/index.js

@@ -43,7 +43,8 @@ Examples:
         .option("--type <mime>", "按 MIME 类型筛选（如 image/png）")
         .option("--size-gt <size>", "文件大小下限（支持 B / KB / MB / GB）")
         .option("--size-lt <size>", "文件大小上限（支持 B / KB / MB / GB）")
-        .option("--uploaded-since <time>", "上传时间下限（ISO 8601 格式）")
+        .option("--uploaded-since <time>", "上传时间下限（晚于该时间），支持：相对时间 1h / 2d / 1w；日期 YYYY-MM-DD；ISO 8601 如 2026-04-01T10:00:00Z")
+        .option("--uploaded-until <time>", "上传时间上限（早于该时间），支持：相对时间 1h / 2d / 1w；日期 YYYY-MM-DD；ISO 8601 如 2026-04-01T10:00:00Z")
         .option("--limit <n>", "单次返回上限（正整数,默认 50）", parsePositiveInt, 50)
         .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
         .option("--all", "自动翻页返回全部结果")
@@ -63,7 +64,8 @@ Examples:
 
   $ miaoda file ls report.pdf
   $ miaoda file ls --type image/png --size-gt 1MB
-  $ miaoda file ls --uploaded-since 2026-04-01
+  $ miaoda file ls --uploaded-since 1d           # 24 小时内上传
+  $ miaoda file ls --uploaded-since 2026-04-01 --uploaded-until 2026-04-30   # 4 月内上传
 `);
     fileCmd
         .command("stat")

package/dist/cli/handlers/file/ls.js

@@ -82,6 +82,7 @@ async function handleFileLs(opts) {
         sizeGt,
         sizeLt,
         uploadedSince: opts.uploadedSince,
+        uploadedUntil: opts.uploadedUntil,
     });
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emitPaged)(result.items, result.next_cursor, result.has_more);

package/package.json

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