@pippit-dev/cli 1.0.26 → 1.0.28

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`。图片支持 `.jpg`、`.jpeg`、`.png`、`.gif`、`.bmp`、`.webp`、`.svg`；视频支持 `.mp4`、`.avi`、`.mov`、`.wmv`、`.flv`、`.webm`、`.mkv`、`.m4v`；音频仅支持 `.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 @@
-485d9e51092beaf675a872f890fd744460e7afe45b27ec500ab6b5c90ebb6d0c  pippit-tool-cli-1.0.26-darwin-amd64.tar.gz
-978cca38261d539ea8ce2bcfd15deb24b4b317f38c084fdde92a5b9ca51f0739  pippit-tool-cli-1.0.26-darwin-arm64.tar.gz
-d772c3fcef2c7b7ff0e6e52d6f10b2ee4cff1cd5fbdff9f08e0bd252ac378e79  pippit-tool-cli-1.0.26-linux-amd64.tar.gz
-b16e7f2e7d9bbfe122eb0895ae6769a00d230ca250717aebb3f9b8eea0c04eae  pippit-tool-cli-1.0.26-linux-arm64.tar.gz
-fd05b98a6001602efad98731a4777cb035eea2bea2acbccb2c1d02af0223176e  pippit-tool-cli-1.0.26-windows-amd64.zip
-a0c873456cf254b0e452c6e376efec5a425ef044b3a1a671d063fa5a613242d0  pippit-tool-cli-1.0.26-windows-arm64.zip
+4b34accaf9d10cd786f1ac962434106363633e7353852a82df20166e761c7a4e  pippit-tool-cli-1.0.28-darwin-amd64.tar.gz
+9250230123f5db4d78b91644b5f7346cb6be002a42144df3870d631f16183ea4  pippit-tool-cli-1.0.28-darwin-arm64.tar.gz
+1ebcb2642dd56802556180ab2cea5a963df6a064fead3e06056755249a86810b  pippit-tool-cli-1.0.28-linux-amd64.tar.gz
+c80e22e65df2a8f1aa90c6dbf9c47b3ca2c4e58367a373e9a28a4133f2d12cb5  pippit-tool-cli-1.0.28-linux-arm64.tar.gz
+03fc5d241e002860e05eaf39be5c3cd18c741539fec5bb3ea37c25941c83119f  pippit-tool-cli-1.0.28-windows-amd64.zip
+0c5adce56ee08df04082c8f121be968145e3db41c3b53e03e23b5593fd77f315  pippit-tool-cli-1.0.28-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")
 	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/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", "--foreground-scripts", 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 @@
-485d9e51092beaf675a872f890fd744460e7afe45b27ec500ab6b5c90ebb6d0c  pippit-tool-cli-1.0.26-darwin-amd64.tar.gz
-978cca38261d539ea8ce2bcfd15deb24b4b317f38c084fdde92a5b9ca51f0739  pippit-tool-cli-1.0.26-darwin-arm64.tar.gz
-d772c3fcef2c7b7ff0e6e52d6f10b2ee4cff1cd5fbdff9f08e0bd252ac378e79  pippit-tool-cli-1.0.26-linux-amd64.tar.gz
-b16e7f2e7d9bbfe122eb0895ae6769a00d230ca250717aebb3f9b8eea0c04eae  pippit-tool-cli-1.0.26-linux-arm64.tar.gz
-fd05b98a6001602efad98731a4777cb035eea2bea2acbccb2c1d02af0223176e  pippit-tool-cli-1.0.26-windows-amd64.zip
-a0c873456cf254b0e452c6e376efec5a425ef044b3a1a671d063fa5a613242d0  pippit-tool-cli-1.0.26-windows-arm64.zip
+4b34accaf9d10cd786f1ac962434106363633e7353852a82df20166e761c7a4e  pippit-tool-cli-1.0.28-darwin-amd64.tar.gz
+9250230123f5db4d78b91644b5f7346cb6be002a42144df3870d631f16183ea4  pippit-tool-cli-1.0.28-darwin-arm64.tar.gz
+1ebcb2642dd56802556180ab2cea5a963df6a064fead3e06056755249a86810b  pippit-tool-cli-1.0.28-linux-amd64.tar.gz
+c80e22e65df2a8f1aa90c6dbf9c47b3ca2c4e58367a373e9a28a4133f2d12cb5  pippit-tool-cli-1.0.28-linux-arm64.tar.gz
+03fc5d241e002860e05eaf39be5c3cd18c741539fec5bb3ea37c25941c83119f  pippit-tool-cli-1.0.28-windows-amd64.zip
+0c5adce56ee08df04082c8f121be968145e3db41c3b53e03e23b5593fd77f315  pippit-tool-cli-1.0.28-windows-arm64.zip

package/internal/common/submit_run.go

@@ -2,7 +2,10 @@ package common
 
 import (
 	"context"
+	"encoding/json"
 	"fmt"
+	"net/url"
+	"strings"
 
 	"github.com/Pippit-dev/pippit-cli/internal/config"
 )
@@ -37,11 +40,36 @@ type SubmitRunResponseRun struct {
 
 // SubmitRun sends a submit_run request and validates its shared response envelope.
 func SubmitRun(ctx context.Context, command string, body any, runner *Runner) (*SubmitRunResult, error) {
+	return submitRun(ctx, command, SubmitRunPath(runner), body, runner)
+}
+
+// SubmitRunWithBabiParam carries client attribution in the same query field as Web.
+func SubmitRunWithBabiParam(ctx context.Context, command string, body any, runner *Runner, babiParam map[string]string) (*SubmitRunResult, error) {
+	path, err := url.Parse(SubmitRunPath(runner))
+	if err != nil {
+		return nil, fmt.Errorf("解析 submit_run 路径失败: %w", err)
+	}
+	query, err := url.ParseQuery(path.RawQuery)
+	if err != nil {
+		return nil, fmt.Errorf("解析 submit_run 查询参数失败: %w", err)
+	}
+	raw, err := json.Marshal(babiParam)
+	if err != nil {
+		return nil, fmt.Errorf("序列化 babi_param 失败: %w", err)
+	}
+	if !query.Has("babi_param") {
+		query.Set("babi_param", string(raw))
+	}
+	path.RawQuery = query.Encode()
+	return submitRun(ctx, command, path.String(), body, runner)
+}
+
+func submitRun(ctx context.Context, command, path string, body any, runner *Runner) (*SubmitRunResult, error) {
 	if runner == nil || runner.Client == nil {
 		return nil, fmt.Errorf("%s 运行器客户端缺失", command)
 	}
 	var resp SubmitRunResponse
-	if err := runner.Client.SendRequest(ctx, SubmitRunPath(runner), body, &resp); err != nil {
+	if err := runner.Client.SendRequest(ctx, path, body, &resp); err != nil {
 		return nil, fmt.Errorf("提交 %s 请求失败: %w", command, err)
 	}
 	if resp.Ret != "0" {
@@ -71,3 +99,12 @@ func SubmitRunPath(runner *Runner) string {
 	}
 	return config.SubmitRunPath
 }
+
+// WithSubmitRunSource adds optional host attribution to a newly constructed skill request.
+// The API consumes this metadata as platform; it is not part of the creative input.
+func WithSubmitRunSource(body map[string]any, source string) map[string]any {
+	if source = strings.TrimSpace(source); source != "" {
+		body["platform"] = source
+	}
+	return body
+}

package/internal/config/config.go

@@ -13,6 +13,7 @@ const (
 	DefaultAuthStoreServiceName = "pippit-cli"
 	SubmitRunPath               = "/api/biz/v1/skill/submit_run"
 	GetCreditBalancePath        = "/api/biz/v1/skill/get_credit_balance"
+	GetAvailableModelListPath   = "/api/biz/v1/skill/get_available_model_list"
 	GetThreadPath               = "/api/biz/v1/skill/get_thread"
 	UploadFilePath              = "/api/biz/v1/skill/upload_file"
 	ListThreadFilePath          = "/api/biz/v1/skill/list_thread_file"
@@ -30,11 +31,12 @@ type Config struct {
 }
 
 type Paths struct {
-	SubmitRun        string
-	GetCreditBalance string
-	GetThread        string
-	UploadFile       string
-	ListThreadFile   string
+	SubmitRun             string
+	GetCreditBalance      string
+	GetAvailableModelList string
+	GetThread             string
+	UploadFile            string
+	ListThreadFile        string
 }
 
 // Load resolves the built-in runtime config.
@@ -45,11 +47,12 @@ func Load() *Config {
 		AuthTTL:     DefaultAuthTTL,
 		AccessKey:   strings.TrimSpace(os.Getenv(EnvXYQAccessKey)),
 		Paths: &Paths{
-			SubmitRun:        SubmitRunPath,
-			GetCreditBalance: GetCreditBalancePath,
-			GetThread:        GetThreadPath,
-			UploadFile:       UploadFilePath,
-			ListThreadFile:   ListThreadFilePath,
+			SubmitRun:             SubmitRunPath,
+			GetCreditBalance:      GetCreditBalancePath,
+			GetAvailableModelList: GetAvailableModelListPath,
+			GetThread:             GetThreadPath,
+			UploadFile:            UploadFilePath,
+			ListThreadFile:        ListThreadFilePath,
 		},
 	}
 }

package/internal/config/config_test.go

@@ -23,6 +23,9 @@ func TestLoadUsesDefaultConfig(t *testing.T) {
 	if cfg.Paths.GetCreditBalance != GetCreditBalancePath {
 		t.Fatalf("GetCreditBalance path = %q, want %q", cfg.Paths.GetCreditBalance, GetCreditBalancePath)
 	}
+	if cfg.Paths.GetAvailableModelList != GetAvailableModelListPath {
+		t.Fatalf("GetAvailableModelList path = %q, want %q", cfg.Paths.GetAvailableModelList, GetAvailableModelListPath)
+	}
 }
 
 func TestLoadReadsAccessKey(t *testing.T) {

package/internal/generate_image/generate_image.go

@@ -23,6 +23,7 @@ const ratioUsage = "enum values: 0=原始比例/自动, 2=16:9(横屏), 13=21:9(
 
 // Options is the stable command-facing request shape for generate-image.
 type Options struct {
+	Source             string
 	Prompt             string
 	ImagePaths         []string
 	Model              string
@@ -151,7 +152,7 @@ func buildSubmitRunBody(opts *Options, imageAssetIDs []string) map[string]any {
 	if len(imageAssetIDs) > 0 {
 		body["asset_ids"] = imageAssetIDs
 	}
-	return body
+	return common.WithSubmitRunSource(body, opts.Source)
 }
 
 func parseRatio(raw string) (*int, error) {