@pippit-dev/cli 0.0.20 → 0.0.22

package/README.md

@@ -198,13 +198,13 @@ pippit-tool-cli --version
 pippit-tool-cli short-drama +submit-run --message "写一个赛博朋克短剧开头"
 pippit-tool-cli short-drama +upload-file --path ./reference.doc
 pippit-tool-cli short-drama +get-thread --thread-id thread_123 --run-id run_456
-pippit-tool-cli short-drama +download-result --output-path ./thread_123/results/result.mp4 --url URL
+pippit-tool-cli short-drama +download-result --output-path ./thread_123/results/result.mp4 --url URL --updated-at 1779716734
 ```
 
 `+submit-run`: 输出 `thread_id`、`run_id` 和 `web_thread_link`；其中 `--message` 为必填参数。
 `+get-thread`: 请求中带 `version=v2`，并输出 `readable_text`。
 `+upload-file`: 输出返回的 `asset_id`。 当前仅支持 `.doc`、`.docx` 和 `.txt` 文件。
-`+download-result`: 会把结果 URL 下载到 `--output-path` 指定的文件路径。
+`+download-result`: 会把结果 URL 下载到 `--output-path` 指定的文件路径；传入 `--updated-at` 后，如果本地文件早于该时间戳会覆盖更新，否则跳过。
 
 短剧命令的错误日志会追加写入本地每日日志文件：`~/.pippit_tool_cli/logs/yyyy-mm-dd.log`。日志路径会基于当前用户主目录和系统路径分隔符生成，因此可在 macOS、Linux 和 Windows 上使用。
 

package/checksums.txt

@@ -1,6 +1,6 @@
-200e40ca3a4ef54a76860bcbe807233fc548d5686eea8b4bb5069f4d393e6fd2  pippit-tool-cli-0.0.20-darwin-amd64.tar.gz
-2371e7b72c39b8b590604afe1abdba34e583b69ad787a78913b306de0145401b  pippit-tool-cli-0.0.20-darwin-arm64.tar.gz
-1df765184d0f7061c15e2829c7792f7982eeb711da534f3883488efc34b02b5d  pippit-tool-cli-0.0.20-linux-amd64.tar.gz
-d5e0d1fcd774cc7d05ab3c749fff79e7f3507e8f92c0c5abaed4ef884ff46f20  pippit-tool-cli-0.0.20-linux-arm64.tar.gz
-0ccfa68f9fd289b680756ba664a82d68af6636c1337368946c53fc58d74f1f2a  pippit-tool-cli-0.0.20-windows-amd64.zip
-2fac1102a7e0fbd75fae736636a3c2e9a2559b7a1a297530f18fa66adc5e11c7  pippit-tool-cli-0.0.20-windows-arm64.zip
+2de4679cc459fe3c4d674fb25f00c8df8fa84e98f80a2fd01f5357d07c663c3e  pippit-tool-cli-0.0.22-darwin-amd64.tar.gz
+9a63d12f5f0534994c01f57caba16ec0d31a141afbe342cf8f42f7e954270633  pippit-tool-cli-0.0.22-darwin-arm64.tar.gz
+61d20c1df72d556b0bd7157c77cdfe3e4c91bc0d85d8924efb0d49c4d6b36ef2  pippit-tool-cli-0.0.22-linux-amd64.tar.gz
+76407ca98a7f885e06cab745eb09a8e5225bbeaae2226ad4c63c3c403bbdec5d  pippit-tool-cli-0.0.22-linux-arm64.tar.gz
+3db90d5c2b5a6a0ba964dd51424ffbc0eaf6dffb3497b5be226d16534504e8e6  pippit-tool-cli-0.0.22-windows-amd64.zip
+b3a69cb5e43a21c037e30e5f6af53c1806de5f24e0724ddbbcbd005255cd20ce  pippit-tool-cli-0.0.22-windows-arm64.zip

package/cmd/short_drama/short_drama.go

@@ -104,11 +104,15 @@ func newShortDramaDownloadResultCommand(stdout, stderr io.Writer, runner *common
 		Short: "Download a generated result URL",
 		Args:  cobra.NoArgs,
 		RunE: withErrorLog("short-drama +download-result", func() map[string]string {
-			return map[string]string{
+			fields := map[string]string{
 				"output_path": opts.OutputPath,
 				"has_url":     strconv.FormatBool(strings.TrimSpace(opts.URL) != ""),
 				"workers":     strconv.Itoa(opts.Workers),
 			}
+			if opts.UpdatedAt > 0 {
+				fields["updated_at"] = strconv.FormatInt(opts.UpdatedAt, 10)
+			}
+			return fields
 		}, func(cmd *cobra.Command, _ []string) error {
 			opts.OutputPath = strings.TrimSpace(opts.OutputPath)
 			if opts.OutputPath == "" {
@@ -133,6 +137,7 @@ func newShortDramaDownloadResultCommand(stdout, stderr io.Writer, runner *common
 	cmd.SetErr(stderr)
 	cmd.Flags().StringVar(&opts.URL, "url", "", "URL to download")
 	cmd.Flags().StringVar(&opts.OutputPath, "output-path", "", "local output file path")
+	cmd.Flags().Int64Var(&opts.UpdatedAt, "updated-at", 0, "remote file update time as a Unix timestamp")
 	cmd.Flags().IntVar(&opts.Workers, "workers", 5, "parallel download workers")
 	return cmd
 }

package/cmd/short_drama_test.go

@@ -408,6 +408,111 @@ func TestShortDramaDownloadResultSkipsExistingFile(t *testing.T) {
 	assertFileContent(t, outputPath, "existing-data")
 }
 
+func TestShortDramaDownloadResultSkipsExistingFileWhenLocalIsFresh(t *testing.T) {
+	serverCalled := false
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		serverCalled = true
+		t.Fatal("server should not receive request when target file is fresh")
+	}))
+	defer server.Close()
+
+	chdirTemp(t)
+	outputPath := filepath.Join("results", "cover.jpeg")
+	if err := os.MkdirAll(filepath.Dir(outputPath), 0o755); err != nil {
+		t.Fatalf("MkdirAll(): %v", err)
+	}
+	if err := os.WriteFile(outputPath, []byte("existing-data"), 0o644); err != nil {
+		t.Fatalf("WriteFile(): %v", err)
+	}
+	remoteUpdatedAt := int64(1779716734)
+	localUpdatedAt := time.Unix(remoteUpdatedAt+10, 0)
+	if err := os.Chtimes(outputPath, localUpdatedAt, localUpdatedAt); err != nil {
+		t.Fatalf("Chtimes(): %v", err)
+	}
+
+	var stdout, stderr bytes.Buffer
+	root := NewRootCommand(&stdout, &stderr)
+	root.SetArgs([]string{
+		"short-drama", "+download-result",
+		"--output-path", outputPath,
+		"--updated-at", "1779716734",
+		"--url", server.URL + "/image",
+	})
+
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
+	}
+	if serverCalled {
+		t.Fatal("server was called, want fresh existing file to skip download")
+	}
+
+	got := decodeJSON(t, stdout.Bytes())
+	alreadyExist, ok := got["already_exist"].([]any)
+	if !ok || len(alreadyExist) != 1 || alreadyExist[0] != outputPath {
+		t.Fatalf("already_exist = %#v, want existing output path", got["already_exist"])
+	}
+	assertFileContent(t, outputPath, "existing-data")
+}
+
+func TestShortDramaDownloadResultOverwritesStaleExistingFile(t *testing.T) {
+	serverCalled := false
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		serverCalled = true
+		if r.URL.Path != "/image" {
+			t.Fatalf("path = %s, want /image", r.URL.Path)
+		}
+		_, _ = w.Write([]byte("new-data"))
+	}))
+	defer server.Close()
+
+	chdirTemp(t)
+	outputPath := filepath.Join("results", "cover.jpeg")
+	if err := os.MkdirAll(filepath.Dir(outputPath), 0o755); err != nil {
+		t.Fatalf("MkdirAll(): %v", err)
+	}
+	if err := os.WriteFile(outputPath, []byte("existing-data"), 0o644); err != nil {
+		t.Fatalf("WriteFile(): %v", err)
+	}
+	remoteUpdatedAt := int64(1779716734)
+	staleUpdatedAt := time.Unix(remoteUpdatedAt-10, 0)
+	if err := os.Chtimes(outputPath, staleUpdatedAt, staleUpdatedAt); err != nil {
+		t.Fatalf("Chtimes(): %v", err)
+	}
+
+	var stdout, stderr bytes.Buffer
+	root := NewRootCommand(&stdout, &stderr)
+	root.SetArgs([]string{
+		"short-drama", "+download-result",
+		"--output-path", outputPath,
+		"--updated-at", "1779716734",
+		"--url", server.URL + "/image",
+	})
+
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
+	}
+	if !serverCalled {
+		t.Fatal("server was not called, want stale existing file to be downloaded")
+	}
+
+	got := decodeJSON(t, stdout.Bytes())
+	downloaded, ok := got["downloaded"].([]any)
+	if !ok || len(downloaded) != 1 || downloaded[0] != outputPath {
+		t.Fatalf("downloaded = %#v, want output path", got["downloaded"])
+	}
+	if _, ok := got["overwritten"]; ok {
+		t.Fatalf("overwritten should not be returned: %#v", got)
+	}
+	assertFileContent(t, outputPath, "new-data")
+	info, err := os.Stat(outputPath)
+	if err != nil {
+		t.Fatalf("Stat(%s): %v", outputPath, err)
+	}
+	if info.ModTime().Unix() != remoteUpdatedAt {
+		t.Fatalf("mtime = %d, want %d", info.ModTime().Unix(), remoteUpdatedAt)
+	}
+}
+
 func TestShortDramaDownloadResultDownloadsMetaJSON(t *testing.T) {
 	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		if r.URL.Path != "/meta.json" {
@@ -513,6 +618,7 @@ func TestShortDramaDownloadResultAllFailed(t *testing.T) {
 	defer server.Close()
 
 	chdirTemp(t)
+	clearDailyErrorLog(t)
 	var stdout, stderr bytes.Buffer
 	root := NewRootCommand(&stdout, &stderr)
 	root.SetArgs([]string{
@@ -528,6 +634,17 @@ func TestShortDramaDownloadResultAllFailed(t *testing.T) {
 	if !strings.Contains(err.Error(), "all 1 download(s) failed") {
 		t.Fatalf("error = %q, want all-failed message", err)
 	}
+	logs := readDailyErrorLog(t)
+	if len(logs) != 1 {
+		t.Fatalf("logs = %#v, want one error log", logs)
+	}
+	fields, ok := logs[0]["fields"].(map[string]any)
+	if !ok {
+		t.Fatalf("fields = %#v, want object", logs[0]["fields"])
+	}
+	if _, ok := fields["updated_at"]; ok {
+		t.Fatalf("updated_at should be omitted when --updated-at is not provided: %#v", fields)
+	}
 }
 
 func TestShortDramaDownloadResultOutputPath(t *testing.T) {
@@ -684,7 +801,7 @@ func TestShortDramaListThreadFile(t *testing.T) {
 		if body["page_size"] != float64(10) {
 			t.Fatalf("page_size = %v, want 10", body["page_size"])
 		}
-		_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"total":1,"files":[{"file_name":"ignored.png","file_path":"results/images/cover.png","download_url":"https://example.com/cover.png"}]}}`))
+		_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"total":1,"files":[{"file_name":"ignored.png","file_path":"results/images/cover.png","download_url":"https://example.com/cover.png","updated_at":1779716734}]}}`))
 	}))
 	defer server.Close()
 
@@ -727,6 +844,9 @@ func TestShortDramaListThreadFile(t *testing.T) {
 	if file["download_url"] != "https://example.com/cover.png" {
 		t.Fatalf("download_url = %v, want returned url", file["download_url"])
 	}
+	if file["updated_at"] != float64(1779716734) {
+		t.Fatalf("updated_at = %v, want 1779716734", file["updated_at"])
+	}
 }
 
 func TestShortDramaListThreadFileMessageWhenPageFull(t *testing.T) {

package/internal/common/download_results.go

@@ -23,6 +23,7 @@ import (
 type DownloadResultOptions struct {
 	URL        string `json:"url"`
 	OutputPath string `json:"output_path"`
+	UpdatedAt  int64  `json:"updated_at,omitempty"`
 	Workers    int    `json:"workers"`
 }
 
@@ -45,8 +46,9 @@ const (
 )
 
 type downloadTask struct {
-	url      string
-	filepath string
+	url       string
+	filepath  string
+	updatedAt int64
 }
 
 type downloadTaskResult struct {
@@ -67,15 +69,16 @@ func DownloadResult(ctx context.Context, opts DownloadResultOptions, runner *Run
 	if outputPath == "" {
 		return nil, fmt.Errorf("output_path is required")
 	}
-	// check if the output path exists and is a file
 	if info, err := os.Stat(outputPath); err == nil {
 		if info.IsDir() {
 			return nil, fmt.Errorf("output path %q is a directory", outputPath)
 		}
-		return &DownloadResultResponse{
-			OutputPath:   outputPath,
-			AlreadyExist: []string{outputPath},
-		}, nil
+		if shouldSkipExistingFile(info, opts.UpdatedAt) {
+			return &DownloadResultResponse{
+				OutputPath:   outputPath,
+				AlreadyExist: []string{outputPath},
+			}, nil
+		}
 	} else if !os.IsNotExist(err) {
 		return nil, fmt.Errorf("stat output path: %w", err)
 	}
@@ -93,8 +96,9 @@ func DownloadResult(ctx context.Context, opts DownloadResultOptions, runner *Run
 	}
 	tasks := []downloadTask{
 		{
-			url:      rawURL,
-			filepath: outputPath,
+			url:       rawURL,
+			filepath:  outputPath,
+			updatedAt: opts.UpdatedAt,
 		},
 	}
 
@@ -117,7 +121,7 @@ func DownloadResult(ctx context.Context, opts DownloadResultOptions, runner *Run
 			for task := range taskCh {
 				resultCh <- downloadTaskResult{
 					filepath: task.filepath,
-					err:      downloadFileWithRetry(ctx, runner.Client, task.url, task.filepath),
+					err:      downloadFileWithRetry(ctx, runner.Client, task.url, task.filepath, task.updatedAt),
 				}
 			}
 		}()
@@ -167,7 +171,14 @@ func DownloadResult(ctx context.Context, opts DownloadResultOptions, runner *Run
 	return result, nil
 }
 
-func downloadFileWithRetry(ctx context.Context, client Client, rawURL string, targetPath string) error {
+func shouldSkipExistingFile(info os.FileInfo, updatedAt int64) bool {
+	if updatedAt <= 0 {
+		return true
+	}
+	return info.ModTime().Unix() >= updatedAt
+}
+
+func downloadFileWithRetry(ctx context.Context, client Client, rawURL string, targetPath string, updatedAt int64) error {
 	var lastErr error
 	for attempt := 0; attempt <= maxDownloadRetries; attempt++ {
 		if attempt > 0 {
@@ -180,7 +191,7 @@ func downloadFileWithRetry(ctx context.Context, client Client, rawURL string, ta
 			case <-timer.C:
 			}
 		}
-		err := downloadFile(ctx, client, rawURL, targetPath)
+		err := downloadFile(ctx, client, rawURL, targetPath, updatedAt)
 		if err == nil {
 			return nil
 		}
@@ -203,7 +214,7 @@ func isRetryableError(err error) bool {
 	return false
 }
 
-func downloadFile(ctx context.Context, client Client, rawURL string, targetPath string) error {
+func downloadFile(ctx context.Context, client Client, rawURL string, targetPath string, updatedAt int64) error {
 	var resp *http.Response
 	if err := client.SendRequest(ctx, rawURL, nil, &resp); err != nil {
 		return err
@@ -211,6 +222,12 @@ func downloadFile(ctx context.Context, client Client, rawURL string, targetPath
 	defer resp.Body.Close()
 
 	tmpPath := targetPath + ".tmp"
+	tempActive := true
+	defer func() {
+		if tempActive {
+			_ = os.Remove(tmpPath)
+		}
+	}()
 	out, err := os.Create(tmpPath)
 	if err != nil {
 		return fmt.Errorf("create temp file: %w", err)
@@ -218,16 +235,18 @@ func downloadFile(ctx context.Context, client Client, rawURL string, targetPath
 	_, copyErr := io.Copy(out, resp.Body)
 	closeErr := out.Close()
 	if copyErr != nil {
-		_ = os.Remove(tmpPath)
 		return fmt.Errorf("write temp file: %w", copyErr)
 	}
 	if closeErr != nil {
-		_ = os.Remove(tmpPath)
 		return fmt.Errorf("close temp file: %w", closeErr)
 	}
 	if err := os.Rename(tmpPath, targetPath); err != nil {
-		_ = os.Remove(tmpPath)
 		return fmt.Errorf("replace target file: %w", err)
 	}
+	tempActive = false
+	if updatedAt > 0 {
+		modTime := time.Unix(updatedAt, 0)
+		_ = os.Chtimes(targetPath, time.Now(), modTime)
+	}
 	return nil
 }

package/internal/common/list_thread_file.go

@@ -22,6 +22,7 @@ type ListThreadFileOptions struct {
 type ThreadFile struct {
 	FilePath    string `json:"file_path"`
 	DownloadURL string `json:"download_url"`
+	UpdatedAt   *int64 `json:"updated_at,omitempty"`
 }
 
 // ListThreadFileResult is the JSON envelope printed by `pippit-tool-cli short-drama +list-thread-file`.
@@ -45,6 +46,7 @@ type listThreadFileResponse struct {
 type threadFileResponse struct {
 	FilePath    string `json:"file_path"`
 	DownloadURL string `json:"download_url"`
+	UpdatedAt   *int64 `json:"updated_at,omitempty"`
 }
 
 func ListThreadFile(ctx context.Context, opts *ListThreadFileOptions, runner *Runner) (*ListThreadFileResult, error) {
@@ -81,6 +83,7 @@ func ListThreadFile(ctx context.Context, opts *ListThreadFileOptions, runner *Ru
 		files = append(files, &ThreadFile{
 			FilePath:    threadFilePath(opts.ThreadID, file.FilePath),
 			DownloadURL: file.DownloadURL,
+			UpdatedAt:   file.UpdatedAt,
 		})
 	}
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@pippit-dev/cli",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "Pippit CLI",
   "bin": {
     "pippit-tool-cli": "scripts/run.js"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",
-    "test": "go test ./... && go vet ./..."
+    "test": "node scripts/version-check.test.js && go test ./... && go vet ./..."
   },
   "os": [
     "darwin",

package/scripts/version-check.js

@@ -7,7 +7,7 @@ const { DEFAULT_PKG } = require("./skills");
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 
 function defaultCacheFile() {
-  return path.join(os.homedir(), ".pippit-cli", "version-check.json");
+  return path.join(os.homedir(), ".pippit_tool_cli", "version-check.json");
 }
 
 function currentVersion() {
@@ -91,6 +91,7 @@ function maybeWarnNewVersion(args = [], opts = {}) {
 module.exports = {
   CHECK_INTERVAL_MS,
   compareSemver,
+  defaultCacheFile,
   maybeWarnNewVersion,
   parseSemver,
 };

package/skills/short-drama/SKILL.md

@@ -121,7 +121,8 @@ pippit-tool-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1
 ```json
 {
   "file_path": "./{thread-id}/路径/文件名", // 文件完整路径，包含文件名
-  "download_url": "https://..." // URL
+  "download_url": "https://...", // URL
+  "updated_at": 1779716734 // 文件更新时间，Unix 秒级时间戳
 }
 ```
 
@@ -131,10 +132,10 @@ pippit-tool-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1
 
 ```bash
 # 下载文件资源到指定文件路径
-pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH
+pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH --updated-at UPDATED_AT
 ```
 
-`FILE_PATH` 必须直接使用 `+list-thread-file` 返回的完整 `file_path`，包含文件名，不要取父目录。`+download-result` 负责把会话产生的文件通过 URL 下载到该目标文件路径；如果目标文件已存在，跳过下载。
+`FILE_PATH` 必须直接使用 `+list-thread-file` 返回的完整 `file_path`，包含文件名，不要取父目录。`UPDATED_AT` 使用同一文件对象返回的 `updated_at`；如果没有 `updated_at`，可省略 `--updated-at`。`+download-result` 负责把会话产生的文件通过 URL 下载到该目标文件路径；如果目标文件已存在且本地修改时间不早于 `updated_at`，跳过下载；如果本地文件早于 `updated_at`，覆盖更新。
 
 ## 典型工作流
 
@@ -151,7 +152,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
    - 如果任务仍在进行中：展示可读进展，继续查询
    - 如果后端 Agent 提出问题：从 readable_text 中提取问题并展示，等待用户回复
 5. 检查 `list-thread-file` 返回的 files：
-   - 对每个文件取 file_path、download_url
+   - 对每个文件取 file_path、download_url、updated_at
    - 将 file_path 作为本地目标文件路径，包含文件名
    - 有 download_url 的重要资产：加入本轮下载队列
    - 不判断 file_path 在本地是否已存在，是否跳过由 +download-result 内部处理
@@ -159,6 +160,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 6. 对重要资产，立即调用 +download-result 并行下载资源：
    - 使用第 5 步获取的 download_url 作为 --url
    - 使用第 5 步获取的完整 file_path 作为 --output-path
+   - 如果第 5 步返回 updated_at，作为 --updated-at 传入
    - 剧本设计、场景设计、场景图、人物角色设计、人物图、最终视频产物都属于重要资产
 7. 查询或下载失败时，不要直接放弃；记录失败项，并在后续轮询中主动重试
 8. 只有会话进展已处理，且已发现的重要资产均已下载或明确重试失败后，才向用户汇总最终结果
@@ -249,7 +251,8 @@ Thread: thread_...
   "files": [
     {
       "file_path": "./{thread-id}/{file_path}/{file_name}",
-      "download_url": "https://..."
+      "download_url": "https://...",
+      "updated_at": 1779716734
     }
   ],
   "total": 1,
@@ -274,12 +277,12 @@ Thread: thread_...
 
 ### 获取会话文件
 
-从 `+list-thread-file` 的 `files` 中逐个读取文件元信息：`file_path`、`file_name`、`download_url`。重点识别剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物等重要资产。
+从 `+list-thread-file` 的 `files` 中逐个读取文件元信息：`file_path`、`file_name`、`download_url`、`updated_at`。重点识别剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物等重要资产。
 
 ```
 1. 有download_url的重要资产
-   → 记录该file_path和URL
-   → 使用 +download-result 将URL资源下载到该file_path
+   → 记录该file_path、URL和updated_at
+   → 使用 +download-result 将URL资源下载到该file_path；有updated_at时传入--updated-at
 2. 本轮total达到200
    → 下一轮page-num加1，继续查询新一页结果
 3. 本轮total未达到200
@@ -293,7 +296,7 @@ Thread: thread_...
 
 对带 `download_url` 的重要资产调用下载工具，可并行。重要资产必须主动下载，不要等用户再次要求，也不要在调用下载工具前先检查本地文件是否存在。
 
-1. 调用 `pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH`。
+1. 调用 `pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FILE_PATH --updated-at UPDATED_AT`；如果文件对象没有 `updated_at`，省略 `--updated-at`。
 2. 下载完成后，向用户展示本地文件路径；如果某个文件下载失败，记录失败项并在后续轮询中重试，不阻塞已成功落盘的文件展示。
 
 ## 向用户展示内容
@@ -335,4 +338,4 @@ Thread: thread_...
 - 单次创作会话中（相同 `thread_id`），`+submit-run` 只支持绑定一个剧本文件。不要在同一 `thread_id` 下重复上传并追加第二个剧本 `asset_id`；用户给多个剧本时，先让用户选择一个，或分别开启新的创作会话。
 - `+list-thread-file` 只需要 `thread_id`；分页参数使用 `--page-num 1 --page-size 200` 起步，`total` 达到 200 时下一轮递增 `page-num`。
 - `+list-thread-file` 和 `+download-result` 是两个不同的 CLI 指令：前者获取会话文件元信息，后者下载 URL 资源并写入到本地目标文件路径。
-- `+download-result` 接收 `--url`、`--output-path`、`--workers`；`--output-path` 必须是包含文件名的目标文件路径。
+- `+download-result` 接收 `--url`、`--output-path`、`--updated-at`、`--workers`；`--output-path` 必须是包含文件名的目标文件路径。