@pippit-dev/cli 1.0.0 → 1.0.2

package/cmd/generate_video_test.go

@@ -0,0 +1,468 @@
+package cmd
+
+import (
+	"bytes"
+	"io"
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/bytedance/sonic"
+)
+
+func TestGenerateVideo(t *testing.T) {
+	assetIDs := []string{"image_asset_1", "image_asset_2", "video_asset_1", "video_asset_2"}
+	uploadIndex := 0
+
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Header.Get("Authorization") != "Bearer test-token" {
+			t.Fatalf("Authorization = %q, want test bearer token", r.Header.Get("Authorization"))
+		}
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/upload_file":
+			if r.Method != http.MethodPost {
+				t.Fatalf("upload method = %s, want POST", r.Method)
+			}
+			if uploadIndex >= len(assetIDs) {
+				t.Fatalf("unexpected upload %d", uploadIndex)
+			}
+			if err := r.ParseMultipartForm(1 << 20); err != nil {
+				t.Fatalf("ParseMultipartForm(): %v", err)
+			}
+			files := r.MultipartForm.File["file"]
+			if len(files) != 1 {
+				t.Fatalf("file parts = %d, want 1", len(files))
+			}
+			uploadIndex++
+			_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"pippit_asset_id":"` + assetIDs[uploadIndex-1] + `"}}`))
+		case "/api/biz/v1/skill/submit_run":
+			if uploadIndex != len(assetIDs) {
+				t.Fatalf("submit called after %d uploads, want %d", uploadIndex, len(assetIDs))
+			}
+			data, err := io.ReadAll(r.Body)
+			if err != nil {
+				t.Fatalf("read body: %v", err)
+			}
+			var body map[string]any
+			if err := sonic.Unmarshal(data, &body); err != nil {
+				t.Fatalf("decode body: %v", err)
+			}
+			if body["agent_name"] != "pippit_video_part_agent" {
+				t.Fatalf("agent_name = %v, want video part agent", body["agent_name"])
+			}
+			if body["message"] != "做个小猫视频" {
+				t.Fatalf("message = %v, want submitted prompt", body["message"])
+			}
+			param, ok := body["video_part_tool_param"].(map[string]any)
+			if !ok {
+				t.Fatalf("video_part_tool_param = %#v, want object", body["video_part_tool_param"])
+			}
+			if param["prompt"] != "做个小猫视频" {
+				t.Fatalf("prompt = %v, want submitted prompt", param["prompt"])
+			}
+			if param["duration_sec"] != float64(5) {
+				t.Fatalf("duration_sec = %v, want 5", param["duration_sec"])
+			}
+			if param["ratio"] != "9:16" || param["model"] != "seedance2.0_vision" || param["resolution"] != "720p" {
+				t.Fatalf("param = %#v, want ratio/model/resolution", param)
+			}
+			assertAssetRefs(t, param["images"], []string{"image_asset_1", "image_asset_2"})
+			assertAssetRefs(t, param["videos"], []string{"video_asset_1", "video_asset_2"})
+			_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"run":{"thread_id":"thread_123","run_id":"run_456"},"web_thread_link":"https://xyq.example/thread_123"}}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	cwd := chdirTemp(t)
+	image1 := filepath.Join(cwd, "cat1.jpg")
+	image2 := filepath.Join(cwd, "cat2.jpg")
+	video1 := filepath.Join(cwd, "video1.mp4")
+	video2 := filepath.Join(cwd, "video2.mp4")
+	for _, path := range []string{image1, image2, video1, video2} {
+		if err := os.WriteFile(path, []byte("media-data"), 0o644); err != nil {
+			t.Fatalf("WriteFile(%s): %v", path, err)
+		}
+	}
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"generate-video",
+		"--prompt", "做个小猫视频",
+		"--image", image1,
+		"--image", image2,
+		"--video", video1,
+		"--video", video2,
+		"--duration", "5",
+		"--ratio", "9:16",
+		"--model", "seedance2.0_vision",
+		"--resolution", "720p",
+	})
+
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
+	}
+
+	got := decodeJSON(t, stdout.Bytes())
+	if got["thread_id"] != "thread_123" || got["run_id"] != "run_456" {
+		t.Fatalf("output = %#v, want thread and run IDs", got)
+	}
+}
+
+func TestGenerateVideoSkipsSemanticValidation(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/submit_run":
+			_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"run":{"thread_id":"thread_123","run_id":"run_456"}}}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"generate-video",
+		"--prompt", "x",
+		"--duration", "1",
+		"--ratio", "1:1",
+		"--model", "bad_model",
+		"--resolution", "bad_resolution",
+	})
+
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
+	}
+}
+
+func TestGenerateVideoRequiresPrompt(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		t.Fatal("server should not receive request without prompt")
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"generate-video",
+		"--duration", "1",
+	})
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want prompt validation")
+	}
+	if !strings.Contains(err.Error(), "缺少必填参数 --prompt") {
+		t.Fatalf("error = %q, want prompt validation", err)
+	}
+}
+
+func TestGenerateVideoRejectsTooManyImages(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		t.Fatal("server should not receive request when image count is invalid")
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	args := []string{"generate-video", "--prompt", "x"}
+	for _, path := range mediaPaths("image", ".jpg", 10) {
+		args = append(args, "--image", path)
+	}
+	root.SetArgs(args)
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want image count validation")
+	}
+	if !strings.Contains(err.Error(), "参考图片最多支持 9 个，当前传入 10 个") {
+		t.Fatalf("error = %q, want image count validation", err)
+	}
+}
+
+func TestGenerateVideoRejectsTooManyVideos(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		t.Fatal("server should not receive request when video count is invalid")
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	args := []string{"generate-video", "--prompt", "x"}
+	for _, path := range mediaPaths("video", ".mp4", 4) {
+		args = append(args, "--video", path)
+	}
+	root.SetArgs(args)
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want video count validation")
+	}
+	if !strings.Contains(err.Error(), "参考视频最多支持 3 个，当前传入 4 个") {
+		t.Fatalf("error = %q, want video count validation", err)
+	}
+}
+
+func TestGenerateVideoSubmitRunErrorIncludesLogID(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/submit_run":
+			_, _ = w.Write([]byte(`{"ret":"16008","errmsg":"提交Run任务失败","log_id":"log_123"}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"generate-video",
+		"--prompt", "x",
+	})
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want submit_run error")
+	}
+	if !strings.Contains(err.Error(), "log_id=log_123") {
+		t.Fatalf("error = %q, want log_id", err)
+	}
+}
+
+func TestGenerateVideoErrorLogIncludesLogID(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/submit_run":
+			_, _ = w.Write([]byte(`{"ret":"16008","errmsg":"提交Run任务失败","log_id":"log_123"}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	clearDailyErrorLog(t)
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"generate-video",
+		"--prompt", "x",
+	})
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want submit_run error")
+	}
+	entries := readDailyErrorLog(t)
+	if len(entries) != 1 {
+		t.Fatalf("log entries = %d, want 1: %#v", len(entries), entries)
+	}
+	fields, ok := entries[0]["fields"].(map[string]any)
+	if !ok {
+		t.Fatalf("fields = %#v, want object", entries[0]["fields"])
+	}
+	if fields["log_id"] != "log_123" {
+		t.Fatalf("log_id = %v, want log_123", fields["log_id"])
+	}
+}
+
+func TestQueryResultDownloadsCompletedVideo(t *testing.T) {
+	var requestedDownload bool
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Header.Get("Authorization") != "Bearer test-token" {
+			t.Fatalf("Authorization = %q, want test bearer token", r.Header.Get("Authorization"))
+		}
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/get_thread":
+			if r.Method != http.MethodPost {
+				t.Fatalf("get_thread method = %s, want POST", r.Method)
+			}
+			data, err := io.ReadAll(r.Body)
+			if err != nil {
+				t.Fatalf("read body: %v", err)
+			}
+			var body map[string]any
+			if err := sonic.Unmarshal(data, &body); err != nil {
+				t.Fatalf("decode body: %v", err)
+			}
+			if body["thread_id"] != "thread_123" {
+				t.Fatalf("thread_id = %v, want thread_123", body["thread_id"])
+			}
+			if body["run_id"] != "run_456" {
+				t.Fatalf("run_id = %v, want run_456", body["run_id"])
+			}
+			if _, ok := body["version"]; ok {
+				t.Fatalf("version = %v, want omitted", body["version"])
+			}
+			_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"thread":{"thread_id":"thread_123","run_list":[{"run_id":"run_456","state":3,"entry_list":[{"artifact":{"content":[{"sub_type":"biz/x_data_prompt_text","data":"做个小猫视频"},{"sub_type":"biz/x_data_video","data":"{\"video\":{\"download_url\":\"` + serverURL(r) + `/video.mp4\",\"title\":\"cat_video\",\"vid\":\"cat_vid\"}}"}]}}]}]}}}`))
+		case "/video.mp4":
+			requestedDownload = true
+			if r.Method != http.MethodGet {
+				t.Fatalf("download method = %s, want GET", r.Method)
+			}
+			_, _ = w.Write([]byte("video-data"))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	downloadDir := filepath.Join(t.TempDir(), "downloads")
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"query-result",
+		"--thread-id", "thread_123",
+		"--run-id", "run_456",
+		"--download-dir", downloadDir,
+	})
+
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
+	}
+
+	outputPath := filepath.Join(downloadDir, "cat_vid.mp4")
+	downloadURL := server.URL + "/video.mp4"
+	if !requestedDownload {
+		t.Fatal("download endpoint was not requested")
+	}
+	if got := stdout.String(); !strings.Contains(got, "Run 已完成，产物已下载：") ||
+		!strings.Contains(got, outputPath) ||
+		!strings.Contains(got, "download_url: "+downloadURL) {
+		t.Fatalf("stdout = %q, want download path and download url", got)
+	}
+	assertFileContent(t, outputPath, "video-data")
+}
+
+func TestQueryResultIgnoresVideoDataWithoutVideoSubType(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/get_thread":
+			_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"thread":{"thread_id":"thread_123","run_list":[{"run_id":"run_456","state":3,"entry_list":[{"artifact":{"content":[{"data":"{\"video\":{\"download_url\":\"` + serverURL(r) + `/video.mp4\",\"title\":\"cat_video\"}}"}]}}]}]}}}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"query-result",
+		"--thread-id", "thread_123",
+		"--run-id", "run_456",
+		"--download-dir", t.TempDir(),
+	})
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want no downloadable video error")
+	}
+	if !strings.Contains(err.Error(), "下载失败：未找到可下载的视频产物") {
+		t.Fatalf("error = %q, want no downloadable video error", err)
+	}
+	if stdout.Len() != 0 {
+		t.Fatalf("stdout = %q, want empty", stdout.String())
+	}
+}
+
+func TestQueryResultErrorLogIncludesLogID(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/get_thread":
+			_, _ = w.Write([]byte(`{"ret":"5","errmsg":"创作失败","log_id":"log_456"}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	clearDailyErrorLog(t)
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"query-result",
+		"--thread-id", "thread_123",
+		"--run-id", "run_456",
+		"--download-dir", t.TempDir(),
+	})
+
+	err := root.Execute()
+	if err == nil {
+		t.Fatal("Execute() error = nil, want get_thread error")
+	}
+	entries := readDailyErrorLog(t)
+	if len(entries) != 1 {
+		t.Fatalf("log entries = %d, want 1: %#v", len(entries), entries)
+	}
+	fields, ok := entries[0]["fields"].(map[string]any)
+	if !ok {
+		t.Fatalf("fields = %#v, want object", entries[0]["fields"])
+	}
+	if fields["log_id"] != "log_456" {
+		t.Fatalf("log_id = %v, want log_456", fields["log_id"])
+	}
+	if fields["thread_id"] != "thread_123" || fields["run_id"] != "run_456" {
+		t.Fatalf("fields = %#v, want thread/run ids", fields)
+	}
+}
+
+func TestQueryResultPendingDoesNotDownload(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/get_thread":
+			_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"thread":{"thread_id":"thread_123","run_list":[{"run_id":"run_456","state":1}]}}}`))
+		default:
+			t.Fatalf("unexpected path %s", r.URL.Path)
+		}
+	}))
+	defer server.Close()
+
+	var stdout, stderr bytes.Buffer
+	root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+	root.SetArgs([]string{
+		"query-result",
+		"--thread-id", "thread_123",
+		"--run-id", "run_456",
+		"--download-dir", t.TempDir(),
+	})
+
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
+	}
+	if got := stdout.String(); !strings.Contains(got, "Run 尚未完成，当前状态：1") {
+		t.Fatalf("stdout = %q, want pending state", got)
+	}
+}
+
+func serverURL(r *http.Request) string {
+	return "http://" + r.Host
+}
+
+func assertAssetRefs(t *testing.T, got any, want []string) {
+	t.Helper()
+	items, ok := got.([]any)
+	if !ok || len(items) != len(want) {
+		t.Fatalf("asset refs = %#v, want %v", got, want)
+	}
+	for i, item := range items {
+		ref, ok := item.(map[string]any)
+		if !ok || ref["pippit_asset_id"] != want[i] {
+			t.Fatalf("asset refs[%d] = %#v, want %s", i, item, want[i])
+		}
+	}
+}
+
+func mediaPaths(prefix string, ext string, count int) []string {
+	paths := make([]string, 0, count)
+	for i := 0; i < count; i++ {
+		paths = append(paths, prefix+string(rune('a'+i))+ext)
+	}
+	return paths
+}

package/cmd/get_thread.go

@@ -0,0 +1,59 @@
+package cmd
+
+import (
+	"fmt"
+	"io"
+	"strings"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	"github.com/spf13/cobra"
+)
+
+func newGetThreadCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	var opts common.GetThreadOptions
+
+	cmd := &cobra.Command{
+		Use:   "get-thread",
+		Short: "Get a thread detail",
+		Args:  cobra.NoArgs,
+		RunE: withErrorLog("get-thread", func() map[string]string {
+			return map[string]string{
+				"thread_id": opts.ThreadID,
+				"run_id":    opts.RunID,
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
+			opts.ThreadID = strings.TrimSpace(opts.ThreadID)
+			if opts.ThreadID == "" {
+				return fmt.Errorf("--thread-id is required")
+			}
+			opts.RunID = strings.TrimSpace(opts.RunID)
+			opts.Version = common.GetThreadVersionV2
+
+			result, err := common.GetThread(cmd.Context(), &opts, runner)
+			if err != nil {
+				return err
+			}
+			_, err = fmt.Fprintln(stdout, result.ReadableText)
+			return err
+		}),
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	cmd.Flags().StringVar(&opts.ThreadID, "thread-id", "", "thread ID to fetch")
+	cmd.Flags().StringVar(&opts.RunID, "run-id", "", "run ID to fetch")
+	return cmd
+}
+
+func withErrorLog(command string, fields func() map[string]string, run func(*cobra.Command, []string) error) func(*cobra.Command, []string) error {
+	return func(cmd *cobra.Command, args []string) error {
+		err := run(cmd, args)
+		if err != nil {
+			logFields := map[string]string(nil)
+			if fields != nil {
+				logFields = fields()
+			}
+			_ = common.AppendDailyErrorLog(command, err, logFields)
+		}
+		return err
+	}
+}

package/cmd/list_thread_file.go

@@ -0,0 +1,51 @@
+package cmd
+
+import (
+	"fmt"
+	"io"
+	"strconv"
+	"strings"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	"github.com/spf13/cobra"
+)
+
+func newListThreadFileCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	var opts common.ListThreadFileOptions
+
+	cmd := &cobra.Command{
+		Use:   "list-thread-file",
+		Short: "List files in a thread",
+		Args:  cobra.NoArgs,
+		RunE: withErrorLog("list-thread-file", func() map[string]string {
+			return map[string]string{
+				"thread_id": opts.ThreadID,
+				"page_num":  strconv.Itoa(opts.PageNum),
+				"page_size": strconv.Itoa(opts.PageSize),
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
+			opts.ThreadID = strings.TrimSpace(opts.ThreadID)
+			if opts.ThreadID == "" {
+				return fmt.Errorf("--thread-id is required")
+			}
+			if opts.PageSize <= 0 || opts.PageSize > common.MaxListThreadFilePageSize {
+				return fmt.Errorf("--page-size must be between 1 and %d", common.MaxListThreadFilePageSize)
+			}
+			if opts.PageNum <= 0 {
+				return fmt.Errorf("--page-num must be greater than 0")
+			}
+
+			result, err := common.ListThreadFile(cmd.Context(), &opts, runner)
+			if err != nil {
+				return err
+			}
+			return common.WriteJSON(stdout, result)
+		}),
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	cmd.Flags().StringVar(&opts.ThreadID, "thread-id", "", "thread ID to list files for")
+	cmd.Flags().IntVar(&opts.PageNum, "page-num", 1, "page number (1-based)")
+	cmd.Flags().IntVar(&opts.PageSize, "page-size", common.MaxListThreadFilePageSize, fmt.Sprintf("number of files per page (between 1 and %d)", common.MaxListThreadFilePageSize))
+	return cmd
+}

package/cmd/root.go

@@ -1,10 +1,13 @@
 package cmd
 
 import (
+	"fmt"
 	"io"
 	"os"
+	"strings"
 
 	// authcmd "github.com/Pippit-dev/pippit-cli/cmd/auth"
+	"github.com/Pippit-dev/pippit-cli/cmd/generate_video"
 	"github.com/Pippit-dev/pippit-cli/cmd/short_drama"
 	updatecmd "github.com/Pippit-dev/pippit-cli/cmd/update"
 	"github.com/Pippit-dev/pippit-cli/internal/common"
@@ -29,7 +32,7 @@ func newRootCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Comm
 	root := &cobra.Command{
 		Use:           "pippit-tool-cli",
 		Short:         "Pippit CLI",
-		Long:          "Pippit CLI submits short-drama workflows, downloads generated assets, and updates the installed CLI package.",
+		Long:          "Pippit CLI generates videos, submits short-drama workflows, downloads generated assets, and updates the installed CLI package.",
 		Version:       version.Current(),
 		SilenceUsage:  true,
 		SilenceErrors: true,
@@ -39,7 +42,33 @@ func newRootCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Comm
 	root.SetOut(stdout)
 	root.SetErr(stderr)
 	// root.AddCommand(authcmd.NewCommand(stdout, stderr, runner)) // temporarily disabled; auth is via access key injection
+	root.AddCommand(newDownloadResultCommand(stdout, stderr, runner))
+	root.AddCommand(newGetThreadCommand(stdout, stderr, runner))
+	root.AddCommand(newListThreadFileCommand(stdout, stderr, runner))
+	root.AddCommand(generate_video.NewCommand(stdout, stderr, runner))
+	root.AddCommand(generate_video.NewQueryResultCommand(stdout, stderr, runner))
 	root.AddCommand(short_drama.NewCommand(stdout, stderr, runner))
 	root.AddCommand(updatecmd.NewCommand(stdout, stderr))
+	localizeFlagErrors(root)
 	return root
 }
+
+func localizeFlagErrors(cmd *cobra.Command) {
+	cmd.SetFlagErrorFunc(func(_ *cobra.Command, err error) error {
+		return localizeFlagError(err)
+	})
+	for _, child := range cmd.Commands() {
+		localizeFlagErrors(child)
+	}
+}
+
+func localizeFlagError(err error) error {
+	msg := err.Error()
+	if flag, ok := strings.CutPrefix(msg, "unknown flag: "); ok {
+		return fmt.Errorf("未知参数: %s", flag)
+	}
+	if flag, ok := strings.CutPrefix(msg, "flag needs an argument: "); ok {
+		return fmt.Errorf("参数 %s 缺少取值", flag)
+	}
+	return fmt.Errorf("参数解析失败: %s", msg)
+}