@pippit-dev/cli 1.0.0 → 1.0.2

package/README.md

@@ -197,21 +197,53 @@ export XYQ_ACCESS_KEY="<access-key>"
 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 --updated-at 1779716734
+pippit-tool-cli get-thread --thread-id thread_123 --run-id run_456
+pippit-tool-cli list-thread-file --thread-id thread_123 --page-num 1 --page-size 200
+pippit-tool-cli 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`。
+`get-thread`: 请求中带 `version=v2`，并输出 `readable_text`。
+`list-thread-file`: 输出会话文件列表、分页提示和可直接传给下载命令的 `file_path`。
 `+upload-file`: 输出返回的 `asset_id`。 当前仅支持 `.doc`、`.docx` 和 `.txt` 文件。
-`+download-result`: 会把结果 URL 下载到 `--output-path` 指定的文件路径；传入 `--updated-at` 后，如果本地文件早于该时间戳会覆盖更新，否则跳过。
+`download-result`: 会把结果 URL 下载到 `--output-path` 指定的文件路径；传入 `--updated-at` 后，如果本地文件早于该时间戳会覆盖更新，否则跳过。
 
 短剧命令的错误日志会追加写入本地每日日志文件：`~/.pippit_tool_cli/logs/yyyy-mm-dd.log`。日志路径会基于当前用户主目录和系统路径分隔符生成，因此可在 macOS、Linux 和 Windows 上使用。
 
+## 生视频 CLI
+
+`generate-video` 会上传本地参考图片和视频，然后向视频片段 Agent 提交生视频请求：
+
+```bash
+pippit-tool-cli generate-video \
+  --prompt "做个小猫视频" \
+  --image "~/images/cat1.jpg" \
+  --image "~/images/cat2.jpg" \
+  --video "~/images/video1.mp4" \
+  --video "~/images/video2.mp4" \
+  --duration 5 \
+  --ratio "9:16" \
+  --model "seedance2.0_direct" \
+  --resolution "720p"
+```
+
+命令输出 `thread_id`、`run_id` 和 `web_thread_link`。提交生视频 HTTP 请求时，参考图和参考视频会使用上传接口返回的 `pippit_asset_id`。图片最多 9 张，支持 `.jpg`、`.jpeg`、`.png`、`.gif`、`.bmp`、`.webp`、`.svg`；视频最多 3 个，支持 `.mp4`、`.avi`、`.mov`、`.wmv`、`.flv`、`.webm`、`.mkv`、`.m4v`。普通用户支持模型 `seedance2.0_direct` 和 `seedance2.0_fast_direct`；VIP 用户额外支持 `seedance2.0_vision` 和 `seedance2.0_fast_vision`。模型、比例、分辨率、素材数量等参数的语义校验当前预留在后续实现。
+
+查询并下载生视频结果：
+
+```bash
+pippit-tool-cli query-result \
+  --thread-id "skill_xxx" \
+  --run-id "skill_xxx" \
+  --download-dir "./output"
+```
+
+`query-result` 会查询指定 Run；Run 完成后下载视频产物并输出本地结果路径，未完成时输出当前状态和重试提示。
+
 ## HTTP 客户端
 
 命令模块通过 `common.Runner` 发起服务调用。运行时配置，例如基础地址、HTTP 超时时间和接口路径，由 `internal/config` 加载，并在运行器中与 `common.Client` 组合使用。
 
 ## 鉴权
 
-`short-drama +submit-run`、`short-drama +get-thread`、`short-drama +upload-file` 以及 `xyq-skill` Python 脚本都使用 `Authorization: Bearer <XYQ_ACCESS_KEY>` 鉴权。OAuth 命令代码仍保留在仓库中，但短剧运行时请求不使用 OAuth。
+`short-drama +submit-run`、`get-thread`、`list-thread-file`、`short-drama +upload-file` 以及 `xyq-skill` Python 脚本都使用 `Authorization: Bearer <XYQ_ACCESS_KEY>` 鉴权。OAuth 命令代码仍保留在仓库中，但短剧运行时请求不使用 OAuth。

package/checksums.txt

@@ -1,6 +1,6 @@
-91020e43a8e12d7e491b43200a4c1df4dd88a41683e5fe531b3fe038f6573e1a  pippit-tool-cli-1.0.0-darwin-amd64.tar.gz
-a0eea79da53e4f6877aa27c731503c7434d5cb72ab0aa62cd602ac5da0e779f0  pippit-tool-cli-1.0.0-darwin-arm64.tar.gz
-babc1965565d1f2a458990b7bfa8f4b6b93c27ce74afc85d0099e82a14a332e0  pippit-tool-cli-1.0.0-linux-amd64.tar.gz
-0c202f681c1c85c1b4ddd0e5980eb6ef35fa36bc3d6bd4bc840406e5c2661fa8  pippit-tool-cli-1.0.0-linux-arm64.tar.gz
-3d6dae6812bd6fc95a2b6e54b8ef8bc24630d20cfc37417f3f84e787d81de11f  pippit-tool-cli-1.0.0-windows-amd64.zip
-1efdeaacda1dc09008ff0ed0582740ba989fdb766c26edec1ee667202bd565e0  pippit-tool-cli-1.0.0-windows-arm64.zip
+2674fbc4cf095e321dcba42a0e7ed44ecb50c14236a07c97dbc522227c8819e1  pippit-tool-cli-1.0.2-darwin-amd64.tar.gz
+f58a8babc317bef904699938b69574bb26d28cf191fff5123be305be77e27c3b  pippit-tool-cli-1.0.2-darwin-arm64.tar.gz
+3b33fbf6bc66f77b54e1436c5e231f355fe10787d41fe1310b6575b36e7c7cee  pippit-tool-cli-1.0.2-linux-amd64.tar.gz
+f5e73a43c79d5d4a35872a05ad9d14c1260753042a004ef358c475e7e7c4e764  pippit-tool-cli-1.0.2-linux-arm64.tar.gz
+36f48c0db0f6524d43fd49d2e2cea014166c9dad85834f1cd498c2e8ebfeafd4  pippit-tool-cli-1.0.2-windows-amd64.zip
+b45999f5e9412a2d7728e538b9cedbb715f4ffc397c667e610bcb964311db8f0  pippit-tool-cli-1.0.2-windows-arm64.zip

package/cmd/download_result.go

@@ -0,0 +1,57 @@
+package cmd
+
+import (
+	"fmt"
+	"io"
+	"strconv"
+	"strings"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	"github.com/spf13/cobra"
+)
+
+func newDownloadResultCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	var opts common.DownloadResultOptions
+
+	cmd := &cobra.Command{
+		Use:   "download-result",
+		Short: "Download a generated result URL",
+		Args:  cobra.NoArgs,
+		RunE: withErrorLog("download-result", func() 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 == "" {
+				return fmt.Errorf("--output-path is required")
+			}
+			opts.URL = strings.TrimSpace(opts.URL)
+			if opts.URL == "" {
+				return fmt.Errorf("--url is required")
+			}
+			if opts.Workers <= 0 {
+				return fmt.Errorf("--workers must be greater than 0")
+			}
+
+			result, err := common.DownloadResult(cmd.Context(), opts, runner)
+			if err != nil {
+				return err
+			}
+			return common.WriteJSON(stdout, result)
+		}),
+	}
+	cmd.SetOut(stdout)
+	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/generate_video/generate_video.go

@@ -0,0 +1,48 @@
+package generate_video
+
+import (
+	"io"
+	"strconv"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	internalgen "github.com/Pippit-dev/pippit-cli/internal/generate_video"
+	"github.com/spf13/cobra"
+)
+
+// NewCommand builds the generate-video command.
+func NewCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	opts := &internalgen.Options{}
+	var durationSec int
+
+	cmd := &cobra.Command{
+		Use:   "generate-video",
+		Short: "Generate a video with the video part agent",
+		Args:  cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			if cmd.Flags().Changed("duration") {
+				opts.DurationSec = &durationSec
+			}
+
+			result, err := internalgen.Run(cmd.Context(), opts, runner)
+			if err != nil {
+				_ = common.AppendDailyErrorLog("generate-video", err, map[string]string{
+					"image_count": strconv.Itoa(len(opts.ImagePaths)),
+					"video_count": strconv.Itoa(len(opts.VideoPaths)),
+				})
+				return err
+			}
+			return common.WriteJSON(stdout, result)
+		},
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	flags := cmd.Flags()
+	flags.StringVar(&opts.Prompt, "prompt", "", "video generation prompt")
+	flags.StringArrayVar(&opts.ImagePaths, "image", nil, "local reference image path; repeat for multiple images, up to 9")
+	flags.StringArrayVar(&opts.VideoPaths, "video", nil, "local reference video path; repeat for multiple videos, up to 3")
+	flags.IntVar(&durationSec, "duration", 0, "video duration in seconds")
+	flags.StringVar(&opts.Ratio, "ratio", "", "video ratio, such as 9:16, 16:9, 3:4, 4:3")
+	flags.StringVar(&opts.Model, "model", "", "video model; normal users: seedance2.0_direct, seedance2.0_fast_direct; VIP users: seedance2.0_direct, seedance2.0_fast_direct, seedance2.0_vision, seedance2.0_fast_vision")
+	flags.StringVar(&opts.Resolution, "resolution", "", "video resolution, such as 720p, 1080p")
+	return cmd
+}

package/cmd/generate_video/query_result.go

@@ -0,0 +1,58 @@
+package generate_video
+
+import (
+	"fmt"
+	"io"
+	"strings"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	internalgen "github.com/Pippit-dev/pippit-cli/internal/generate_video"
+	"github.com/spf13/cobra"
+)
+
+// NewQueryResultCommand builds the query-result command.
+func NewQueryResultCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	opts := &internalgen.QueryResultOptions{}
+
+	cmd := &cobra.Command{
+		Use:   "query-result",
+		Short: "Query a generate-video run result and download completed videos",
+		Args:  cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			result, err := internalgen.QueryResult(cmd.Context(), opts, runner)
+			if err != nil {
+				_ = common.AppendDailyErrorLog("query-result", err, map[string]string{
+					"thread_id":    strings.TrimSpace(opts.ThreadID),
+					"run_id":       strings.TrimSpace(opts.RunID),
+					"download_dir": strings.TrimSpace(opts.DownloadDir),
+				})
+				return err
+			}
+			if !result.Completed {
+				_, err = fmt.Fprintf(stdout, "Run 尚未完成，当前状态：%d\n请稍后重试 query-result。\n", result.State)
+				return err
+			}
+			_, err = fmt.Fprintln(stdout, "Run 已完成，产物已下载：")
+			if err != nil {
+				return err
+			}
+			for i, path := range result.OutputPaths {
+				if _, err := fmt.Fprintln(stdout, path); err != nil {
+					return err
+				}
+				if i < len(result.DownloadURLs) && strings.TrimSpace(result.DownloadURLs[i]) != "" {
+					if _, err := fmt.Fprintf(stdout, "download_url: %s\n", result.DownloadURLs[i]); err != nil {
+						return err
+					}
+				}
+			}
+			return nil
+		},
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	cmd.Flags().StringVar(&opts.ThreadID, "thread-id", "", "thread_id from generate-video output")
+	cmd.Flags().StringVar(&opts.RunID, "run-id", "", "run_id from generate-video output")
+	cmd.Flags().StringVar(&opts.DownloadDir, "download-dir", "", "directory to download completed videos into")
+	return cmd
+}