@pippit-dev/cli 1.0.25 → 1.0.27

package/README.md

@@ -27,6 +27,7 @@
 | 登录授权 | `status` / `login` / `logout` | [授权](skills/xyq-nest-skill/commands/auth.md) |
 | 个人 Canvas 画布与节点编辑 | `canvas` | [画布](skills/xyq-nest-skill/commands/canvas.md) |
 | 生图、参考图编辑 | `generate-image` | [图片](skills/xyq-nest-skill/commands/generate-image.md) |
+| 查看可用视频模型、参数配置 | `model list` / `model describe` | [模型发现](skills/xyq-nest-skill/commands/model.md) |
 | 生视频、首尾帧 | `generate-video` | [视频](skills/xyq-nest-skill/commands/generate-video.md) |
 | 视频超分 | `video-super-resolution` | [超分](skills/xyq-nest-skill/commands/video-super-resolution.md) |
 | 擦字幕 | `erase-video-subtitle` | [擦字幕](skills/xyq-nest-skill/commands/erase-video-subtitle.md) |
@@ -209,6 +210,17 @@ pippit-tool-cli generate-image \
 
 图片支持 `.jpg`、`.jpeg`、`.png`、`.gif`、`.bmp`、`.webp`、`.svg`。CLI 会在提交前校验 prompt、model 必填、ratio 整数格式、generate-image-count 非负和文件后缀。
 
+## 视频模型发现
+
+```bash
+pippit-tool-cli model list
+pippit-tool-cli model search MiniMax
+pippit-tool-cli model describe MiniMax-H3
+pippit-tool-cli model list --refresh
+```
+
+使用当前登录凭证查询服务端；成功结果按账号和环境隔离缓存 5 分钟，`--refresh` 强制刷新。失败时提示重试，不回退静态列表或过期缓存。`describe` 将比例枚举转换为可直接传给 `--ratio` 的字符串，并整理分辨率、时长和素材限制；不展示内部 `config_key`，未知比例枚举跳过。生成仍由服务端校验。详见 [模型发现](skills/xyq-nest-skill/commands/model.md)。
+
 ## 生视频 CLI
 
 `generate-video` 会上传本地参考图片、视频和音频，然后向视频片段 Agent 提交生视频请求：
@@ -227,7 +239,7 @@ pippit-tool-cli generate-video \
   --resolution "720p"
 ```
 
-命令输出 `thread_id`、`run_id` 和 `web_thread_link`。提交生视频 HTTP 请求时，参考图、参考视频和参考音频会使用上传接口返回的 `pippit_asset_id`，并分别写入 `video_part_tool_param.images`、`video_part_tool_param.videos` 和 `video_part_tool_param.audios`。图片最多 9 张，支持 `.jpg`、`.jpeg`、`.png`、`.gif`、`.bmp`、`.webp`、`.svg`；视频最多 3 个，支持 `.mp4`、`.avi`、`.mov`、`.wmv`、`.flv`、`.webm`、`.mkv`、`.m4v`；音频最多 3 个，仅支持 `.mp3`、`.wav`。普通用户支持模型 `Seedance_2.0_mini_lite`；`seedance2.0_vision`、`seedance2.0_fast_vision`、`Seedance_2.0_mini` 和 `Seedance_2.5` 为 VIP 专属模型。CLI 会在提交前校验 prompt、素材数量和文件后缀；模型、比例、分辨率等语义校验由服务端处理。
+命令输出 `thread_id`、`run_id` 和 `web_thread_link`。提交生视频 HTTP 请求时，参考图、参考视频和参考音频会使用上传接口返回的 `pippit_asset_id`，并分别写入 `video_part_tool_param.images`、`video_part_tool_param.videos` 和 `video_part_tool_param.audios`。图片支持 `.jpg`、`.jpeg`、`.png`、`.gif`、`.bmp`、`.webp`、`.svg`；视频支持 `.mp4`、`.avi`、`.mov`、`.wmv`、`.flv`、`.webm`、`.mkv`、`.m4v`；音频仅支持 `.mp3`、`.wav`。当前可用模型通过 `model list` 查询，参数详情通过 `model describe MODEL_KEY` 查询。CLI 会在提交前校验 prompt 和文件后缀；模型、比例、分辨率等语义校验由服务端处理。
 
 首尾帧生视频时，按首帧、尾帧的顺序传入两次 `--image`，并设置 `--generate-type 1`：
 
@@ -292,3 +304,13 @@ pippit-tool-cli query-result \
 原生 CLI 命令通过 `pippit-tool-cli login` 打开小云雀网页授权，并把本机设备专属凭证保存到系统安全凭证库；Access Key 不会显示在终端。可用 `pippit-tool-cli status` 查看状态、`pippit-tool-cli logout` 清除本机登录。
 
 CI 或 Agent 可继续显式设置 `XYQ_ACCESS_KEY`，它会覆盖本机网页登录凭证；配置错误时不会静默回退到个人登录。会话提交和查询共享上述凭据。
+
+### 宿主来源统计
+
+调用 Skill 提交接口的命令均支持可选 `--source`：`submit-run`、`generate-image`、`generate-video`、`video-super-resolution`、`erase-video-subtitle`、`short-drama +submit-run`。
+
+由宿主 Agent 根据实际环境静默填写稳定标识，例如豆包办公 `doubao_office`、WorkBuddy `workbuddy`、Codex `codex`。其它来源可使用其真实产品标识；来源未知时省略，不询问用户，也不从 prompt 猜测。该值去掉首尾空白后写入请求顶层 `platform`，仅供统计，不参与创作、模型选择或鉴权；未提供/空值时不发送该字段。不会自动读取环境变量、持久化来源或影响查询、上传、下载、Canvas 命令。
+
+```bash
+pippit-tool-cli generate-video --prompt "小猫在花园散步" --model Seedance_2.0_mini --source workbuddy
+```

package/checksums.txt

@@ -1,6 +1,6 @@
-4a4f33dcfad8ca038e4e17f30a4eb766a593189879570c42c90c67727663b3e3  pippit-tool-cli-1.0.25-darwin-amd64.tar.gz
-239e645a66c08d55b053a27a736afddf6233010166a0f9646420d01eb1104073  pippit-tool-cli-1.0.25-darwin-arm64.tar.gz
-1491e33040ca68be4fafa39505320ee68120742d931fc37f2f3d0774efd143de  pippit-tool-cli-1.0.25-linux-amd64.tar.gz
-057c80108de3e61d54be312601577ca2ec40cea32f4f4e6d4d53d3fa5d090439  pippit-tool-cli-1.0.25-linux-arm64.tar.gz
-3eedc462a21392575c6f677cd7d9cceb6028c8b05a39b251e007e5ae09bb74b6  pippit-tool-cli-1.0.25-windows-amd64.zip
-7641c4814e127153e0979a3e4cd69c9bb38870d81940dfa198b2cff7401f3663  pippit-tool-cli-1.0.25-windows-arm64.zip
+730f01e4c20d9848690579384fb3c635f74d5b0c4938c53a470159eb0798ad56  pippit-tool-cli-1.0.27-darwin-amd64.tar.gz
+03520884774e9082f5ef070044fa87ff70f18c52fe8d1a4bf4d665509c3af023  pippit-tool-cli-1.0.27-darwin-arm64.tar.gz
+70348ce883d4223cf6ee0789bd0a72635bfef857d832c54586290eb956a1eb1e  pippit-tool-cli-1.0.27-linux-amd64.tar.gz
+d548d7ff144ee723c6420e1d3977c8defbbb92cc19ee86cdb7f021a3812d881c  pippit-tool-cli-1.0.27-linux-arm64.tar.gz
+ced13bd604d19987d3d71cb3a8d5518afee64420496dea1b646c19e34efdd23c  pippit-tool-cli-1.0.27-windows-amd64.zip
+aeee3a5159843c0b64e453c19a3a7c3dd805f4f0eeafdb08a0e36c604829602f  pippit-tool-cli-1.0.27-windows-arm64.zip

package/cmd/generate_image/generate_image.go

@@ -44,6 +44,7 @@ func NewCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
 	flags := cmd.Flags()
+	flags.StringVar(&opts.Source, "source", "", "optional host agent/platform identifier for statistics only; filled silently by the host agent (e.g. doubao_office, workbuddy, codex)")
 	flags.StringVar(&opts.Prompt, "prompt", "", "image generation prompt")
 	flags.StringArrayVar(&opts.ImagePaths, "image", nil, "local reference image path; repeat for multiple images")
 	flags.StringVar(&opts.Model, "model", "", "image model; supported: seedream_5.0_pro, seedream_5.0, seedream_4.3, nova2, seedream_4.5, seedream_4.1, seedream_4")

package/cmd/generate_video/generate_video.go

@@ -42,14 +42,15 @@ func NewCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
 	flags := cmd.Flags()
+	flags.StringVar(&opts.Source, "source", "", "optional host agent/platform identifier for statistics only; filled silently by the host agent (e.g. doubao_office, workbuddy, codex)")
 	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.StringArrayVar(&opts.AudioPaths, "audio", nil, "local reference audio path; repeat for multiple audios, up to 3")
+	flags.StringArrayVar(&opts.ImagePaths, "image", nil, "local reference image path; repeat for multiple images")
+	flags.StringArrayVar(&opts.VideoPaths, "video", nil, "local reference video path; repeat for multiple videos")
+	flags.StringArrayVar(&opts.AudioPaths, "audio", nil, "local reference audio path; repeat for multiple audios")
 	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: Seedance_2.0_mini_lite; VIP-only: seedance2.0_vision, seedance2.0_fast_vision, Seedance_2.0_mini, Seedance_2.5")
-	flags.StringVar(&opts.Resolution, "resolution", "", "video resolution, such as 720p, 1080p")
-	flags.Int64Var(&generateType, "generate-type", 0, "generation type passed to the service; set 1 for first-and-last-frame generation and provide two --image values in first-frame, last-frame order")
+	flags.StringVar(&opts.Model, "model", "", "video model key; use 'model list' to discover available models")
+	flags.StringVar(&opts.Resolution, "resolution", "", "video resolution; optional for Seedance_2.0_mini and Seedance_2.0_mini_lite (server defaults to 720p); use 'model describe <key>' for current configuration")
+	flags.Int64Var(&generateType, "generate-type", 0, "generation type passed to the service; set 1 for first-and-last-frame generation and provide --image values in first-frame, last-frame order; MiniMax and Wan also accept a single first-frame image in this mode")
 	return cmd
 }

package/cmd/generate_video_test.go

@@ -189,72 +189,74 @@ func TestGenerateVideoRequiresPrompt(t *testing.T) {
 	}
 }
 
-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)
+func TestGenerateVideoAcceptsReferencesBeyondFormerLimits(t *testing.T) {
+	cwd := chdirTemp(t)
 	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)
+	var assetIDs []string
+	for _, media := range []struct {
+		flag  string
+		ext   string
+		count int
+	}{
+		{"image", ".jpg", 10},
+		{"video", ".mp4", 4},
+		{"audio", ".mp3", 4},
+	} {
+		for _, name := range mediaPaths(media.flag, media.ext, media.count) {
+			path := filepath.Join(cwd, name)
+			if err := os.WriteFile(path, []byte("media-data"), 0o644); err != nil {
+				t.Fatalf("WriteFile(%s): %v", path, err)
+			}
+			args = append(args, "--"+media.flag, path)
+			assetIDs = append(assetIDs, name)
+		}
 	}
-}
 
-func TestGenerateVideoRejectsTooManyAudios(t *testing.T) {
+	uploadIndex := 0
+	submitted := false
 	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		t.Fatal("server should not receive request when audio count is invalid")
+		switch r.URL.Path {
+		case "/api/biz/v1/skill/upload_file":
+			if uploadIndex >= len(assetIDs) {
+				t.Fatalf("unexpected upload %d", uploadIndex)
+			}
+			_, _ = w.Write([]byte(`{"ret":"0","data":{"pippit_asset_id":"` + assetIDs[uploadIndex] + `"}}`))
+			uploadIndex++
+		case "/api/biz/v1/skill/submit_run":
+			if uploadIndex != len(assetIDs) {
+				t.Fatalf("uploaded %d references, 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)
+			}
+			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"])
+			}
+			assertAssetRefs(t, param["images"], assetIDs[:10])
+			assertAssetRefs(t, param["videos"], assetIDs[10:14])
+			assertAssetRefs(t, param["audios"], assetIDs[14:])
+			submitted = true
+			_, _ = w.Write([]byte(`{"ret":"0","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)
-	args := []string{"generate-video", "--prompt", "x"}
-	for _, path := range mediaPaths("audio", ".mp3", 4) {
-		args = append(args, "--audio", path)
-	}
 	root.SetArgs(args)
-
-	err := root.Execute()
-	if err == nil {
-		t.Fatal("Execute() error = nil, want audio count validation")
+	if err := root.Execute(); err != nil {
+		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
 	}
-	if !strings.Contains(err.Error(), "参考音频最多支持 3 个，当前传入 4 个") {
-		t.Fatalf("error = %q, want audio count validation", err)
+	if !submitted {
+		t.Fatal("generate-video did not submit references")
 	}
 }
 

package/cmd/model.go

@@ -0,0 +1,74 @@
+package cmd
+
+import (
+	"fmt"
+	"io"
+	"strings"
+	"time"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	"github.com/Pippit-dev/pippit-cli/internal/models"
+	"github.com/spf13/cobra"
+)
+
+func newModelCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	var refresh bool
+	var modelType string
+	service := models.NewService(runner)
+	query := func(cmd *cobra.Command, args []string, describe bool) error {
+		if modelType != "video" {
+			return fmt.Errorf("当前仅支持 --type video")
+		}
+		result, err := service.Get(cmd.Context(), refresh)
+		if err != nil {
+			return err
+		}
+		if result.Warning != "" {
+			fmt.Fprintln(stderr, result.Warning)
+		}
+		output := map[string]any{
+			"scene":  result.Catalog.Scene,
+			"cached": result.Cached, "fetched_at": result.FetchedAt,
+			"expires_at": result.FetchedAt.Add(models.CacheTTL).Format(time.RFC3339Nano),
+		}
+		if describe {
+			model, err := result.Catalog.Describe(strings.Join(args, " "))
+			if err != nil {
+				return err
+			}
+			output["model"] = model
+		} else {
+			output["models"] = result.Catalog.Search(strings.Join(args, " "))
+		}
+		return common.WriteJSON(stdout, output)
+	}
+	cmd := &cobra.Command{
+		Use:   "model [key]",
+		Short: "Discover available video models and their server configuration",
+		Long:  "Query available video models using your current credentials. Successful queries are cached locally for 5 minutes. Use --refresh to bypass the cache; retry if a query fails.",
+		Args:  cobra.MaximumNArgs(1),
+		RunE: withErrorLog("model", nil, func(cmd *cobra.Command, args []string) error {
+			return query(cmd, args, len(args) > 0)
+		}),
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	cmd.PersistentFlags().BoolVar(&refresh, "refresh", false, "refresh the 5-minute local model cache")
+	cmd.PersistentFlags().StringVarP(&modelType, "type", "t", "video", "model type (currently video only)")
+	cmd.AddCommand(&cobra.Command{
+		Use: "list [query]", Aliases: []string{"search"},
+		Short: "List video models, optionally filtered by key or name",
+		Args:  cobra.MaximumNArgs(1),
+		RunE: withErrorLog("model list", nil, func(cmd *cobra.Command, args []string) error {
+			return query(cmd, args, false)
+		}),
+	})
+	cmd.AddCommand(&cobra.Command{
+		Use: "describe <key>", Short: "Show model parameters with CLI-ready ratios, defaults, and limits",
+		Args: cobra.ExactArgs(1),
+		RunE: withErrorLog("model describe", nil, func(cmd *cobra.Command, args []string) error {
+			return query(cmd, args, true)
+		}),
+	})
+	return cmd
+}

package/cmd/model_test.go

@@ -0,0 +1,81 @@
+package cmd
+
+import (
+	"bytes"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+
+	"github.com/Pippit-dev/pippit-cli/internal/config"
+)
+
+func TestModelCommands(t *testing.T) {
+	t.Setenv("HOME", t.TempDir())
+	t.Setenv("XDG_CACHE_HOME", t.TempDir())
+	t.Setenv("LocalAppData", t.TempDir())
+	requests := 0
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		requests++
+		if r.URL.Path != config.GetAvailableModelListPath {
+			t.Errorf("path=%s", r.URL.Path)
+		}
+		_, _ = w.Write([]byte(`{"ret":"0","data":{"scene":"web_turbo_video_generator","config_key":"key","config":{"models":[{"key":"MiniMax-H3","name":"MiniMax","kind":"video","supported_ratio_list":[0,2,3],"default_ratio":3,"audio_total_limit":0}]}}}`))
+	}))
+	defer server.Close()
+	for i, args := range [][]string{
+		{"model", "list"},
+		{"model", "search", "MiniMax", "--type", "video"},
+		{"model", "describe", "MiniMax-H3"},
+		{"model", "MiniMax-H3"},
+		{"model", "list", "--refresh"},
+	} {
+		var stdout, stderr bytes.Buffer
+		cfg := config.Load()
+		cfg.BaseURL, cfg.AccessKey = server.URL, "model-command-test-key"
+		root := newRootCommand(&stdout, &stderr, newRootRunner(cfg))
+		root.SetArgs(args)
+		if err := root.Execute(); err != nil {
+			t.Fatalf("%v: %v", args, err)
+		}
+		var output map[string]json.RawMessage
+		if err := json.Unmarshal(stdout.Bytes(), &output); err != nil {
+			t.Fatal(err)
+		}
+		if _, exists := output["config_key"]; exists {
+			t.Fatal("internal config key must not be exposed")
+		}
+		if i == 2 || i == 3 {
+			if bytes.Contains(output["model"], []byte("supported_ratio_list")) || !bytes.Contains(output["model"], []byte(`"default":"9:16"`)) {
+				t.Fatalf("ratio must use CLI strings: %s", stdout.String())
+			}
+			if !bytes.Contains(output["model"], []byte(`"audio_total_limit":0`)) {
+				t.Fatalf("missing config: %s", stdout.String())
+			}
+		} else if !bytes.Contains(output["models"], []byte("MiniMax-H3")) {
+			t.Fatalf("missing model: %s", stdout.String())
+		}
+		want := 1
+		if i == 4 {
+			want = 2
+		}
+		if requests != want {
+			t.Fatalf("requests=%d want=%d", requests, want)
+		}
+	}
+}
+
+func TestModelHelpDoesNotRequireLoginOrRequest(t *testing.T) {
+	for _, args := range [][]string{{"model", "--help"}, {"generate-video", "--help"}} {
+		var stdout, stderr bytes.Buffer
+		root := NewRootCommand(&stdout, &stderr)
+		root.SetArgs(args)
+		if err := root.Execute(); err != nil {
+			t.Fatal(err)
+		}
+		if !strings.Contains(stdout.String(), "list") {
+			t.Fatalf("help must show discovery: %s", stdout.String())
+		}
+	}
+}

package/cmd/root.go

@@ -72,6 +72,7 @@ func newRootCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Comm
 	root.AddCommand(canvascmd.NewCommand(stdout, stderr, runner))
 	root.AddCommand(newDownloadResultCommand(stdout, stderr, runner))
 	root.AddCommand(newGetCreditBalanceCommand(stdout, stderr, runner))
+	root.AddCommand(newModelCommand(stdout, stderr, runner))
 	root.AddCommand(newGetThreadCommand(stdout, stderr, runner))
 	root.AddCommand(newSubmitRunCommand(stdout, stderr, runner))
 	root.AddCommand(newUploadFileCommand(stdout, stderr, runner))

package/cmd/short_drama/short_drama.go

@@ -55,6 +55,7 @@ func newShortDramaSubmitRunCommand(stdout, stderr io.Writer, runner *common.Runn
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
+	cmd.Flags().StringVar(&opts.Source, "source", "", "optional host agent/platform identifier for statistics only; filled silently by the host agent (e.g. doubao_office, workbuddy, codex)")
 	cmd.Flags().StringVar(&opts.Message, "message", "", "message to send to the short drama agent")
 	cmd.Flags().StringVar(&opts.ThreadID, "thread-id", "", "existing thread ID; omit to create a new thread")
 	cmd.Flags().StringArrayVar(&opts.AssetIDs, "asset-ids", nil, "asset ID to attach; repeat for multiple assets")

package/cmd/source_test.go

@@ -0,0 +1,179 @@
+package cmd
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"path/filepath"
+	"reflect"
+	"strings"
+	"testing"
+
+	"github.com/Pippit-dev/pippit-cli/internal/config"
+)
+
+func TestSkillSubmitSourcePreservesCreativeRequest(t *testing.T) {
+	for _, name := range []string{"submit-run", "generate-image", "generate-video", "video-super-resolution", "erase-video-subtitle", "short-drama"} {
+		t.Run(name, func(t *testing.T) {
+			video := filepath.Join(t.TempDir(), "input.mp4")
+			if err := os.WriteFile(video, []byte("test-video"), 0600); err != nil {
+				t.Fatal(err)
+			}
+			args := map[string][]string{
+				"submit-run":             {"submit-run", "--message", "  保留原文\nworkbuddy 只是内容  ", "--thread-id", "skill_existing", "--asset-ids", "asset_1"},
+				"generate-image":         {"generate-image", "--prompt", "cat", "--model", "seedream_5.0_pro", "--ratio", "6", "--resolution", "4K"},
+				"generate-video":         {"generate-video", "--prompt", "cat", "--model", "Seedance_2.0_mini", "--duration", "4", "--ratio", "16:9"},
+				"video-super-resolution": {"video-super-resolution", "--video", video, "--output-resolution", "1080p"},
+				"erase-video-subtitle":   {"erase-video-subtitle", "--video", video},
+				"short-drama":            {"short-drama", "+submit-run", "--message", "剧本", "--thread-id", "skill_existing", "--asset-ids", "asset_1"},
+			}[name]
+			var received map[string]any
+			var query string
+			response := `{"ret":"0","data":{"run":{"thread_id":"thread_1","run_id":"run_1"},"web_thread_link":"https://xyq.example/thread_1"}}`
+			submitCount := 0
+			uploadFailure := false
+			server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+				switch r.URL.Path {
+				case config.SubmitRunPath:
+					submitCount++
+					if r.Method != http.MethodPost || r.Header.Get("Authorization") != "Bearer test-token" {
+						t.Error("method or authorization changed")
+					}
+					if err := json.NewDecoder(r.Body).Decode(&received); err != nil {
+						t.Error(err)
+					}
+					query = r.URL.RawQuery
+					_, _ = w.Write([]byte(response))
+				case "/api/biz/v1/skill/upload_file":
+					if err := r.ParseMultipartForm(1 << 20); err != nil {
+						t.Error(err)
+					}
+					if r.FormValue("platform") != "" || r.FormValue("source") != "" || r.URL.Query().Has("source") || r.URL.Query().Has("platform") {
+						t.Error("host attribution leaked into upload")
+					}
+					if uploadFailure {
+						_, _ = w.Write([]byte(`{"ret":"1","errmsg":"upload rejected"}`))
+						return
+					}
+					_, _ = w.Write([]byte(`{"ret":"0","data":{"pippit_asset_id":"video_1"}}`))
+				default:
+					t.Errorf("unexpected request path: %s", r.URL.Path)
+				}
+			}))
+			defer server.Close()
+			execute := func(sourceFlags ...string) string {
+				t.Helper()
+				received = nil
+				var stdout, stderr bytes.Buffer
+				root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+				commandArgs := append([]string(nil), args...)
+				commandArgs = append(commandArgs, sourceFlags...)
+				root.SetArgs(commandArgs)
+				if err := root.Execute(); err != nil {
+					t.Fatal(err)
+				}
+				if received == nil {
+					t.Fatal("no skill submission received")
+				}
+				return stdout.String()
+			}
+			wantOutput := execute()
+			if _, exists := received["platform"]; exists {
+				t.Fatal("missing source must omit platform")
+			}
+			wantBody, wantQuery := received, query
+			for i, tc := range []struct {
+				flags []string
+				want  string
+			}{
+				{[]string{"--source", "workbuddy"}, "workbuddy"},
+				{[]string{"--source", " doubao_office "}, "doubao_office"},
+				{[]string{"--source", "codex"}, "codex"},
+				{[]string{"--source", "新的宿主"}, "新的宿主"},
+				{[]string{"--source", ""}, ""},
+				{[]string{"--source", " \t "}, ""},
+				{[]string{"--source=workbuddy"}, "workbuddy"},
+				{[]string{"--source="}, ""},
+				{[]string{"--source=codex", "--source=workbuddy"}, "workbuddy"},
+				{[]string{"--source=codex", "--source="}, ""},
+				{[]string{"--source", "\u3000codex\u00a0"}, "codex"},
+				{[]string{"--source", "host\"&=?/\\测试\nnext"}, "host\"&=?/\\测试\nnext"},
+			} {
+				t.Run(fmt.Sprintf("source_%02d", i), func(t *testing.T) {
+					if got := execute(tc.flags...); got != wantOutput {
+						t.Errorf("source changed output: %s", got)
+					}
+					value, exists := received["platform"]
+					if (tc.want == "" && exists) || (tc.want != "" && value != tc.want) {
+						t.Errorf("platform = %#v (present=%v), want=%q", value, exists, tc.want)
+					}
+					delete(received, "platform")
+					if !reflect.DeepEqual(received, wantBody) || query != wantQuery {
+						t.Errorf("source changed creative request or ROI query: %#v / %s", received, query)
+					}
+				})
+			}
+			// A fresh invocation without source must not reuse previous attribution.
+			execute()
+			if _, exists := received["platform"]; exists {
+				t.Error("source leaked into next invocation")
+			}
+			for _, failure := range []struct{ name, body string }{
+				{"business_error", `{"ret":"1","errmsg":"rejected"}`},
+				{"invalid_json", `invalid-json`},
+			} {
+				t.Run(failure.name, func(t *testing.T) {
+					response = failure.body
+					submitCount = 0
+					var stdout, stderr bytes.Buffer
+					root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+					root.SetArgs(append(append([]string(nil), args...), "--source=codex"))
+					if err := root.Execute(); err == nil {
+						t.Fatal("source swallowed submit error")
+					}
+					if submitCount != 1 {
+						t.Errorf("submission count = %d, want 1", submitCount)
+					}
+					if received["platform"] != "codex" {
+						t.Error("failed submission lost source")
+					}
+				})
+			}
+			if name == "video-super-resolution" || name == "erase-video-subtitle" {
+				t.Run("upload_failure", func(t *testing.T) {
+					uploadFailure = true
+					submitCount = 0
+					var stdout, stderr bytes.Buffer
+					root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+					root.SetArgs(append(append([]string(nil), args...), "--source=workbuddy"))
+					if err := root.Execute(); err == nil {
+						t.Fatal("source swallowed upload error")
+					}
+					if submitCount != 0 {
+						t.Errorf("submitted %d times after failed upload", submitCount)
+					}
+				})
+			}
+		})
+	}
+}
+
+func TestSourceHelpWithoutCredentials(t *testing.T) {
+	for _, args := range [][]string{
+		{"submit-run"}, {"generate-image"}, {"generate-video"},
+		{"video-super-resolution"}, {"erase-video-subtitle"}, {"short-drama", "+submit-run"},
+	} {
+		var stdout, stderr bytes.Buffer
+		root := newRootCommand(&stdout, &stderr, nil)
+		root.SetArgs(append(args, "--help"))
+		if err := root.Execute(); err != nil {
+			t.Fatal(err)
+		}
+		if !strings.Contains(stdout.String(), "--source") {
+			t.Errorf("help for %v missing --source", args)
+		}
+	}
+}

package/cmd/submit_run.go

@@ -11,6 +11,7 @@ import (
 
 func newSubmitRunCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
 	var body struct {
+		Platform string   `json:"platform,omitempty"`
 		Message  string   `json:"message"`
 		ThreadID string   `json:"thread_id,omitempty"`
 		AssetIDs []string `json:"asset_ids,omitempty"`
@@ -23,6 +24,7 @@ func newSubmitRunCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra
 			if strings.TrimSpace(body.Message) == "" {
 				return fmt.Errorf("缺少必填参数 --message")
 			}
+			body.Platform = strings.TrimSpace(body.Platform)
 			// Preserve the original message and identifiers; the backend owns routing.
 			result, err := common.SubmitRun(cmd.Context(), "submit-run", body, runner)
 			if err != nil {
@@ -33,6 +35,7 @@ func newSubmitRunCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
+	cmd.Flags().StringVar(&body.Platform, "source", "", "optional host agent/platform identifier for statistics only; filled silently by the host agent (e.g. doubao_office, workbuddy, codex)")
 	cmd.Flags().StringVar(&body.Message, "message", "", "original message to send (required)")
 	cmd.Flags().StringVar(&body.ThreadID, "thread-id", "", "existing thread ID; omit to create a new thread")
 	cmd.Flags().StringArrayVar(&body.AssetIDs, "asset-ids", nil, "asset ID to attach; repeat for multiple assets")

package/cmd/update/update.go

@@ -63,7 +63,7 @@ func runUpdate(stdout, stderr io.Writer) error {
 	if err != nil {
 		return fmt.Errorf("准备替换当前可执行文件失败: %w", err)
 	}
-	if err := runInheritEnv(stderr, []string{"PIPPIT_CLI_SKIP_SKILLS=1"}, "npm", "install", "-g", pkg); err != nil {
+	if err := runInheritEnv(stderr, []string{"PIPPIT_CLI_SKIP_SKILLS=1"}, "npm", "install", "-g", "--prefer-online", pkg); err != nil {
 		restore()
 		return fmt.Errorf("更新 pippit-tool-cli 失败: %w", err)
 	}

package/cmd/video_tool/video_tool.go

@@ -31,6 +31,7 @@ func NewSuperResolutionCommand(stdout, stderr io.Writer, runner *common.Runner)
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
 	flags := cmd.Flags()
+	flags.StringVar(&opts.Source, "source", "", "optional host agent/platform identifier for statistics only; filled silently by the host agent (e.g. doubao_office, workbuddy, codex)")
 	flags.StringVar(&opts.VideoPath, "video", "", "local input video path")
 	flags.StringVar(&opts.OutputResolution, "output-resolution", "", "output resolution passed to the service: 720p, 1080p, 2k, or 4k")
 	flags.StringVar(&opts.ToolVersion, "tool-version", "", "optional tool version passed to the service: standard, professional_v1, or professional_v2")
@@ -58,6 +59,7 @@ func NewEraseSubtitleCommand(stdout, stderr io.Writer, runner *common.Runner) *c
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
 	flags := cmd.Flags()
+	flags.StringVar(&opts.Source, "source", "", "optional host agent/platform identifier for statistics only; filled silently by the host agent (e.g. doubao_office, workbuddy, codex)")
 	flags.StringVar(&opts.VideoPath, "video", "", "local input video path")
 	return cmd
 }

package/dist/checksums.txt

@@ -1,6 +1,6 @@
-4a4f33dcfad8ca038e4e17f30a4eb766a593189879570c42c90c67727663b3e3  pippit-tool-cli-1.0.25-darwin-amd64.tar.gz
-239e645a66c08d55b053a27a736afddf6233010166a0f9646420d01eb1104073  pippit-tool-cli-1.0.25-darwin-arm64.tar.gz
-1491e33040ca68be4fafa39505320ee68120742d931fc37f2f3d0774efd143de  pippit-tool-cli-1.0.25-linux-amd64.tar.gz
-057c80108de3e61d54be312601577ca2ec40cea32f4f4e6d4d53d3fa5d090439  pippit-tool-cli-1.0.25-linux-arm64.tar.gz
-3eedc462a21392575c6f677cd7d9cceb6028c8b05a39b251e007e5ae09bb74b6  pippit-tool-cli-1.0.25-windows-amd64.zip
-7641c4814e127153e0979a3e4cd69c9bb38870d81940dfa198b2cff7401f3663  pippit-tool-cli-1.0.25-windows-arm64.zip
+730f01e4c20d9848690579384fb3c635f74d5b0c4938c53a470159eb0798ad56  pippit-tool-cli-1.0.27-darwin-amd64.tar.gz
+03520884774e9082f5ef070044fa87ff70f18c52fe8d1a4bf4d665509c3af023  pippit-tool-cli-1.0.27-darwin-arm64.tar.gz
+70348ce883d4223cf6ee0789bd0a72635bfef857d832c54586290eb956a1eb1e  pippit-tool-cli-1.0.27-linux-amd64.tar.gz
+d548d7ff144ee723c6420e1d3977c8defbbb92cc19ee86cdb7f021a3812d881c  pippit-tool-cli-1.0.27-linux-arm64.tar.gz
+ced13bd604d19987d3d71cb3a8d5518afee64420496dea1b646c19e34efdd23c  pippit-tool-cli-1.0.27-windows-amd64.zip
+aeee3a5159843c0b64e453c19a3a7c3dd805f4f0eeafdb08a0e36c604829602f  pippit-tool-cli-1.0.27-windows-arm64.zip