@pippit-dev/cli 1.0.46 → 1.0.48

package/README.md

@@ -17,6 +17,22 @@ x-tt-env = ""
 
 `tests/` 中的验证脚本随源码仓库维护，不包含在 npm 发布包中，也不接入正式 CLI 二进制入口。
 
+## 上传素材
+
+通用 `upload-file` 支持本地文件或服务端 URL 导入，`--path` 与 `--url` 必须且只能提供一个：
+
+```bash
+pippit-tool-cli upload-file --path ./reference.png
+pippit-tool-cli upload-file --url 'https://example.com/reference?signature=...'
+pippit-tool-cli upload-file --url 'https://example.com/reference' --team-id 123456
+```
+
+URL 模式只向已有上传接口发送 `url`，CLI 不下载、读取或缓存源素材；类型和内部文件名由服务端识别，无需提供 `asset_type` 或 `file_name`。支持服务端可访问的 HTTPS 图片、视频或音频直链，包括有效的签名 URL；链接不必有文件后缀，服务端拒绝自动重定向。URL 模式依赖服务端部署对应能力，素材受服务端格式、大小（当前 200 MiB）和审核限制。
+
+成功输出保持 `{"team_id":"0","asset_id":"..."}`，其中 `asset_id` 是服务端返回的 `pippit_asset_id`，后续复用此 ID。`upload-file` 不额外等待查询素材；导入失败不会自动重试，也不会回退成本地下载再上传。未拿到资产 ID 的超时应先检查结果，避免重复导入。批量调用需控制并发，不代表支持几百上千路同时导入。
+
+`canvas upload` 同样支持 `--path` 或 `--url` 二选一，并保留素材可查询等待及 `state`、`locator`、`pippit_asset_id` 输出；其旧 `asset_id` 是来源 ID，不等同于 `upload-file.asset_id`。两种 URL 入口都需要服务端部署对应能力。`short-drama +upload-file` 保持原有本地文件用法。
+
 ## 技能列表
 
 本仓库在 `skills/` 目录下包含三个智能体技能：
@@ -24,12 +40,12 @@ x-tt-env = ""
 | 技能 | 说明 | 路径 |
 |-------|-------------|------|
 | `xyq-short-drama-skill` | 短剧工作流技能，支持提交创作任务、上传参考文件、查询进度、列出会话文件和下载产物。 | `skills/short-drama/` |
-| `xyq-skill` | 图片生成与参考图编辑、视频生成、视频超分与擦字幕、异步结果交付、个人或团队 Canvas 编辑、积分查询及登录授权。 | `skills/xyq-nest-skill/` |
+| `xyq-skill` | 素材上传与 URL 导入、图片生成与参考图编辑、视频生成、视频超分与擦字幕、异步结果交付、个人或团队 Canvas 编辑、积分查询及登录授权。 | `skills/xyq-nest-skill/` |
 | `xyq-marketing-skill` | 商品图文营销一键成片：剧情广告、品牌大片、达人带货，含素材上传、进度查询与媒体下载。 | `skills/xyq-marketing-skill/` |
 
 ### 技能路由
 
-- 图片生成与参考图编辑、视频生成（含首尾帧和参考素材）、视频超分、擦字幕、结果查询、个人或团队 Canvas 编辑、积分和授权由 `xyq-skill` 处理。
+- 素材上传与 URL 导入、图片生成与参考图编辑、视频生成（含首尾帧和参考素材）、视频超分、擦字幕、结果查询、个人或团队 Canvas 编辑、积分和授权由 `xyq-skill` 处理。
 - 短剧生成、续写、改写、人物设定、分集创作和短剧会话文件处理使用 `xyq-short-drama-skill`。
 - 商品图文营销成片、剧情广告、品牌大片和达人带货视频使用 `xyq-marketing-skill`；由公开营销 API 完成创作编排。
 
@@ -90,6 +106,7 @@ node skills/xyq-marketing-skill/scripts/marketing.js query --thread-id THREAD_ID
 | 操作 | CLI | 文档 |
 | --- | --- | --- |
 | 登录授权 | `status` / `login` / `logout` | [授权](skills/xyq-nest-skill/commands/auth.md) |
+| 上传本地素材或导入 HTTPS URL 素材 | `upload-file` | [上传与导入](skills/xyq-nest-skill/commands/upload-file.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) |
@@ -149,6 +166,12 @@ pippit-tool-cli --version
 4. 验证通过后，在 GitHub Actions 的 `Promote canary to latest` workflow 中点击 `Run workflow`，填写已验证的 `X.Y.Z`。该 workflow 须先合入默认分支才会显示手动入口，并复用仓库已有的 `NPM_TOKEN`。
 5. 提升流程要求输入版本与当前 `canary` 一致，只移动 npm `latest` 指针并回读确认，不重新构建或发布 npm 包。如果 canary 已更新，需要验证新的候选版本后再提升。
 
+GitHub Release 已成功、npm 发布失败时的补发步骤：
+
+1. 在 GitHub Actions 选择 `Republish npm from Release`，点击 `Run workflow`，填写已有的 `vX.Y.Z` tag。该 workflow 须先合入默认分支，复用已有 `NPM_TOKEN`。
+2. 流程检出指定 tag，校验源码版本、已发布的六个平台产物及 `checksums.txt`，复用这些二进制，只准备并发布 npm canary，不运行 GoReleaser。
+3. 目标必须高于当前 latest 和 canary，且 npm 上尚无该版本；发布前查询异常会停止。npm 接收发布后可能暂时返回 404，流程会有上限地重试读取版本与渠道，确认 canary 指向目标版本、latest 保持原值。回读超时只表示结果尚未确认，先核实 npm 实际处理状态，不连续重复发布，也不删除已有 Release 或重打 tag。
+
 维护者回滚步骤：
 
 1. 在 [GitHub Actions](https://github.com/Pippit-dev/cli/actions) 选择 `Rollback CLI`，点击 `Run workflow`。该 workflow 须先合入默认分支；复用 `NPM_TOKEN` 修改 npm 标签，使用只读 `GITHUB_TOKEN` 检查 Release。
@@ -157,7 +180,7 @@ pippit-tool-cli --version
 4. 写入前再次核对当前渠道，随后只移动所选 npm 标签并回读确认。不会重新构建、发包、修改 Git tag 或改变另一渠道。Actions 日志和运行摘要会记录目标及确认结果；写入或回读失败时，先用 `npm view @pippit-dev/cli dist-tags --prefer-online` 核实实际状态，再决定是否重试。
 5. 已安装问题版本的用户需要主动执行 `pippit-tool-cli update --channel stable`（回滚 canary 时使用 `--channel canary`）并核对 `pippit-tool-cli --version`。旧 CLI 可执行默认 `update` 获取 `latest`，但须确保未设置 `PIPPIT_CLI_INSTALL_PACKAGE` 覆盖变量。已运行的进程及 Skill 独立缓存中的 CLI 不会被渠道回滚自动替换。
 
-发布、提升和回滚共用并发组，避免这些 workflow 同时修改渠道；不取消正在运行的任务。GitHub 默认只保留一个等待中的同组任务，连续触发时请检查是否有等待任务被替换。并发组不能锁住维护者在终端执行的 npm 写入，操作期间应避免其它渠道修改。此阶段不提供百分比放量或自动回滚，普通客户端也不会因指针变化而自动安装；显式指定问题版本的安装仍然可用。
+发布、补发、提升和回滚共用并发组，避免这些 workflow 同时修改渠道；不取消正在运行的任务。GitHub 默认只保留一个等待中的同组任务，连续触发时请检查是否有等待任务被替换。并发组不能锁住维护者在终端执行的 npm 写入，操作期间应避免其它渠道修改。此阶段不提供百分比放量或自动回滚，普通客户端也不会因指针变化而自动安装；显式指定问题版本的安装仍然可用。
 
 ## 短剧工作流技能
 
@@ -199,9 +222,12 @@ pippit-tool-cli canvas create --title "CLI Canvas" --wait
 pippit-tool-cli canvas allocate --count 3
 pippit-tool-cli canvas get --asset-id PIPPIT_ASSET_ID
 pippit-tool-cli canvas upload --path ./reference.png
+pippit-tool-cli canvas upload --url 'https://example.com/reference?signature=...' --team-id 123456
 pippit-tool-cli canvas apply --project-id PROJECT_ID --file ./patch.json
 ```
 
+`canvas upload` 的 `--path` 与 `--url` 必须且只能提供一个。URL 模式不在本机下载或缓存素材；`--timeout` 仍只控制上传返回后的素材查询等待，查询超时保留资产 ID 和 warning，不自动再次导入。上传成功不代表已插入画布。
+
 五个命令复用 `space use TEAM_ID` 保存的默认空间，也支持单次 `--team-id TEAM_ID`，个人空间使用 `0`。操作已有画布时显式使用其原 `--team-id`，CLI 不根据画布 ID 自动选择团队。`canvas get` 返回实际 `team_id`，本地账号可识别时还返回 `space_context`；`canvas command run` 据此固定后续子进程的空间与账号/API origin，期间切换默认空间不影响当前操作。本地恢复记录和检查点按账号、团队与画布隔离，原有个人记录保持可读。
 
 五个命令均输出单行 JSON，资源 ID 保持字符串。`allocate` 只预留 ID，实际资产仍由后续 `apply` transaction 创建。`create` 的 `request_id` 用于追踪，不是跨服务崩溃窗口的严格幂等键；写请求结果不明确时不要盲目重放，应先使用 `canvas get` 回读确认。`apply` 当前只接受一个 transaction，但该 transaction 可以包含多个 patches；CLI 会严格检查 transaction ACK 和每个目标资产的新版本。
@@ -281,7 +307,7 @@ pippit-tool-cli canvas command run xyq.generation.update_prompt \
   --input '{"nodeId":"TARGET_IMAGE_NODE_ID","prompt":"参考 <pippit-asset-id label=\"参考图\">PIPPIT_ASSET_ID_IN_DRAFT</pippit-asset-id> 的人物"}'
 ```
 
-当前版本只解析已有画布候选与目标草稿中的引用；找不到的普通标签返回 `UNRESOLVED_PROMPT_REFERENCE`，不写入文档。仅拿到 `canvas upload` 返回的 ID，还不会自动查询并加入草稿。新独立素材 ID 的自动解析属于后续能力。已有独立素材草稿可由前端上传或素材库流程产生，视频生成可使用其中的图片、视频和音频。同一媒体 ID 若同时匹配到画布源节点，则遵循前端现有的节点优先规则建立关联。`canvas get --asset-id PIPPIT_ASSET_ID` 可查询外部素材，但查询本身不添加引用。
+当前版本只解析已有画布候选与目标草稿中的引用；找不到的普通标签返回 `UNRESOLVED_PROMPT_REFERENCE`，不写入文档。仅拿到 `upload-file` 或 `canvas upload` 返回的素材 ID，还不会自动查询并加入草稿。需要画布参考节点时，按 [URL 导入与资产复用](skills/xyq-nest-skill/commands/canvas-assets.md#url-import) 先关联素材创建节点，再通过真实节点引用。新独立素材 ID 的自动解析属于后续能力。已有独立素材草稿可由前端上传或素材库流程产生，视频生成可使用其中的图片、视频和音频。同一媒体 ID 若同时匹配到画布源节点，则遵循前端现有的节点优先规则建立关联。`canvas get --asset-id PIPPIT_ASSET_ID` 可查询外部素材，但查询本身不添加引用。
 
 该命令先在隔离文档上按前端原有顺序执行 SDK commands，再把实际补丁一次性提交，保留模型参数、已有引用及 caption/title/name 等展示字段。`dryRun:true` 只执行隔离预演，原文档和撤销历史不变；清空 prompt 不移除引用。节点引用由现有生成流程转换成 `node_asset_refs`，独立图片进入 `pippit_asset_ids`，视频生成的独立素材按类型进入 `images`、`videos`、`audios`。本命令不触发生成、上传或远端素材查询。不要用浅合并的 `update_asset.contentPatch.generation` 更新提示词，否则可能覆盖其他生成参数。
 

package/checksums.txt

@@ -1,6 +1,6 @@
-a22b8aaebe337a2617f238dfcdd425a4133a9c63bebf812f15b834955881233b  pippit-tool-cli-1.0.46-darwin-amd64.tar.gz
-a28e74b130adb63620bd3bb5d382d621e7dfc8a826c7e4663b1fba7f4a623449  pippit-tool-cli-1.0.46-darwin-arm64.tar.gz
-6c7e1a7998e48de298bb1c0263ff26e06a9acd55c8469edc6a7731914109aa3d  pippit-tool-cli-1.0.46-linux-amd64.tar.gz
-1641f4cc8161e4b1f012211c690db07a3fd100ff18845130f77f603e06298cd4  pippit-tool-cli-1.0.46-linux-arm64.tar.gz
-938743186947edac0e27627891066c946d99d8facc80f27b6395eaab88fda0f9  pippit-tool-cli-1.0.46-windows-amd64.zip
-1f8903e4c94214e21c5e86556243a8e95175e076f41261da6210fb51fdca72c2  pippit-tool-cli-1.0.46-windows-arm64.zip
+718067da81039c982cdcb9579f50a06a83bbc7c7dd599ab447b50e8b8e2b13ac  pippit-tool-cli-1.0.48-darwin-amd64.tar.gz
+d0aa4e2272c8369fb615b82bbb390a3e575e3b3df39dffbb5d38c6fc8e7d67c3  pippit-tool-cli-1.0.48-darwin-arm64.tar.gz
+838f221cef34481f042a2fec32da0f015d5c61151f43eeb3460ceb94c05601fd  pippit-tool-cli-1.0.48-linux-amd64.tar.gz
+1ff3d84ffe6a04bc6c5ed92d9e784308d8dc16fffc88037faa21665d9a74106c  pippit-tool-cli-1.0.48-linux-arm64.tar.gz
+04400b90e115ba0d9d8e0d6917e8b69cfe980fa5601bd5c9bdb2625135036d5e  pippit-tool-cli-1.0.48-windows-amd64.zip
+e6a2f024b93abcc546007fe1c5e2fcaebed11ab64123943c30dda9f47f8c4b63  pippit-tool-cli-1.0.48-windows-arm64.zip

package/cmd/canvas/canvas.go

@@ -162,12 +162,16 @@ func newUploadCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Co
 	var opts canvascore.UploadOptions
 	cmd := &cobra.Command{
 		Use:   "upload",
-		Short: "Upload a file to the selected space and wait until it is queryable",
+		Short: "Upload a local file or import an HTTPS URL and wait until the asset is queryable",
 		Args:  cobra.NoArgs,
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			result, err := canvascore.Upload(cmd.Context(), opts, runner)
 			if err != nil {
-				logCanvasError("canvas upload", err, map[string]string{"file_name": filepath.Base(strings.TrimSpace(opts.Path))})
+				fields := map[string]string{}
+				if path := strings.TrimSpace(opts.Path); path != "" {
+					fields["file_name"] = filepath.Base(path)
+				}
+				logCanvasError("canvas upload", err, fields)
 				return err
 			}
 			return common.WriteJSON(stdout, result)
@@ -176,7 +180,8 @@ func newUploadCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Co
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
 	flags := cmd.Flags()
-	flags.StringVar(&opts.Path, "path", "", "local file path to upload")
+	flags.StringVar(&opts.Path, "path", "", "local file path to upload (choose exactly one of --path or --url)")
+	flags.StringVar(&opts.URL, "url", "", "HTTPS media URL to import on the server (choose exactly one of --path or --url)")
 	flags.DurationVar(&opts.PollInterval, "poll-interval", time.Second, "asset visibility polling interval")
 	flags.DurationVar(&opts.WaitTimeout, "timeout", 2*time.Minute, "maximum asset visibility wait time")
 	return cmd

package/cmd/canvas_upload_test.go

@@ -0,0 +1,128 @@
+package cmd
+
+import (
+	"bytes"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+
+	canvascore "github.com/Pippit-dev/pippit-cli/internal/canvas"
+)
+
+func TestCanvasUploadURLContract(t *testing.T) {
+	const sourceURL = "https://assets.example.invalid/no-extension?signature=keep%2Fexact&x=1"
+	for _, teamID := range []string{"0", "12", "34"} {
+		t.Run(teamID, func(t *testing.T) {
+			uploads, queries := 0, 0
+			server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+				wantTeamHeader := teamID
+				if teamID == "0" {
+					wantTeamHeader = ""
+				}
+				if r.Method != http.MethodPost || r.Header.Get("Content-Type") != "application/json" ||
+					r.Header.Get("Authorization") != "Bearer test-token" || r.Header.Get("X-Team-Id") != wantTeamHeader {
+					t.Error("upload and query must retain JSON transport, authentication and the selected space")
+				}
+				switch r.URL.Path {
+				case canvascore.UploadPath:
+					uploads++
+					var body map[string]string
+					if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
+						t.Error(err)
+					}
+					if len(body) != 1 || body["url"] != sourceURL {
+						t.Errorf("upload body = %#v, want only the unchanged URL", body)
+					}
+					_, _ = w.Write([]byte(`{"ret":"0","log_id":"upload-log","data":{"asset_id":"source-id","pippit_asset_id":"asset-url"}}`))
+				case canvascore.QueryPath:
+					queries++
+					var body struct {
+						IDs []string `json:"pippit_asset_ids"`
+					}
+					if err := json.NewDecoder(r.Body).Decode(&body); err != nil || len(body.IDs) != 1 || body.IDs[0] != "asset-url" {
+						t.Errorf("query body = %#v, err = %v", body, err)
+					}
+					_, _ = w.Write([]byte(`{"ret":"0","log_id":"query-log","data":{"Assets":[{"PippitAssetID":"asset-url","SourceID":"source-id","AssetType":1,"Image":{"asset_id":"media-id"}}]}}`))
+				default:
+					t.Errorf("unexpected request: %s", r.URL.Path)
+					http.Error(w, "unexpected request", http.StatusBadRequest)
+				}
+			}))
+			defer server.Close()
+			var stdout, stderr bytes.Buffer
+			root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+			// An unreachable origin ensures only the API receives the source URL.
+			root.SetArgs([]string{"canvas", "upload", "--url", " " + sourceURL + " ", "--team-id", teamID})
+			if err := root.Execute(); err != nil {
+				t.Fatal(err)
+			}
+			var result canvascore.UploadResult
+			if err := json.Unmarshal(stdout.Bytes(), &result); err != nil {
+				t.Fatal(err)
+			}
+			if uploads != 1 || queries != 1 || result.State != canvascore.StateReady || result.PollAttempts != 1 ||
+				result.AssetID != "source-id" || result.SourceID != "source-id" || result.PippitAssetID != "asset-url" ||
+				result.MediaAssetID != "media-id" || result.Locator.PippitAssetID != "asset-url" || result.Locator.MediaAssetID != "media-id" ||
+				result.LogID != "upload-log" || result.QueryLogID != "query-log" {
+				t.Fatalf("uploads=%d queries=%d result=%+v", uploads, queries, result)
+			}
+			if strings.Contains(stdout.String()+stderr.String(), "keep%2Fexact") {
+				t.Error("output exposed the source signature")
+			}
+		})
+	}
+}
+
+func TestCanvasUploadRejectsInvalidSourcesBeforeRequest(t *testing.T) {
+	clearDailyErrorLog(t)
+	calls := 0
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		calls++
+		http.Error(w, "unexpected request", http.StatusBadRequest)
+	}))
+	defer server.Close()
+	for _, tc := range []struct {
+		args []string
+		want string
+	}{
+		{nil, "必须且只能提供一个"},
+		{[]string{"--url", " "}, "必须且只能提供一个"},
+		{[]string{"--path", "missing.png", "--url", "https://example.com/media?signature=secret"}, "必须且只能提供一个"},
+		{[]string{"--url", "http://example.com/media"}, "HTTPS"},
+		{[]string{"--url", "file:///tmp/media.png"}, "HTTPS"},
+		{[]string{"--url", "https://user:secret@example.com/media"}, "HTTPS"},
+		{[]string{"--url", "https://example.com/media#secret"}, "HTTPS"},
+		{[]string{"--url", "https://example.com/%zz?signature=secret"}, "HTTPS"},
+	} {
+		var stdout, stderr bytes.Buffer
+		root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+		root.SetArgs(append([]string{"canvas", "upload"}, tc.args...))
+		err := root.Execute()
+		if err == nil || !strings.Contains(err.Error(), tc.want) {
+			t.Fatalf("error=%v, want %s", err, tc.want)
+		}
+		if strings.Contains(err.Error()+stderr.String(), "secret") || stdout.Len() != 0 || calls != 0 {
+			t.Fatal("invalid input exposed the URL or produced output/requests")
+		}
+	}
+	logs, err := json.Marshal(readDailyErrorLog(t))
+	if err != nil || bytes.Contains(logs, []byte("secret")) {
+		t.Fatalf("validation log exposed the source URL, marshal error=%v", err)
+	}
+}
+
+func TestCanvasUploadHelpExposesBothSources(t *testing.T) {
+	var stdout, stderr bytes.Buffer
+	root := newRootCommand(&stdout, &stderr, nil)
+	root.SetArgs([]string{"canvas", "upload", "--help"})
+	if err := root.Execute(); err != nil {
+		t.Fatal(err)
+	}
+	for _, flag := range []string{"--path", "--url", "--poll-interval", "--timeout"} {
+		if !strings.Contains(stdout.String(), flag) {
+			t.Errorf("help missing %s", flag)
+		}
+	}
+}

package/cmd/upload_file.go

@@ -18,13 +18,19 @@ func newUploadFileCommand(stdout, stderr io.Writer, runner *common.Runner) *cobr
 	var opts common.UploadFileOptions
 	cmd := &cobra.Command{
 		Use:   "upload-file",
-		Short: "Upload an image, video, or MP3/WAV audio file",
+		Short: "Upload a local media file or import media from an HTTPS URL",
 		Args:  cobra.NoArgs,
 		RunE: withErrorLog("upload-file", nil, func(cmd *cobra.Command, _ []string) error {
 			opts.Path = strings.TrimSpace(opts.Path)
-			if err := validateMediaUpload(opts.Path); err != nil {
+			opts.URL = strings.TrimSpace(opts.URL)
+			if err := opts.ValidateSource(); err != nil {
 				return err
 			}
+			if opts.Path != "" {
+				if err := validateMediaUpload(opts.Path); err != nil {
+					return err
+				}
+			}
 			result, err := common.UploadFile(cmd.Context(), opts, runner)
 			if err != nil {
 				return err
@@ -34,7 +40,8 @@ func newUploadFileCommand(stdout, stderr io.Writer, runner *common.Runner) *cobr
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
-	cmd.Flags().StringVar(&opts.Path, "path", "", "local media file to upload (required, less than 500 MB)")
+	cmd.Flags().StringVar(&opts.Path, "path", "", "local media file to upload (less than 500 MB; choose exactly one of --path or --url)")
+	cmd.Flags().StringVar(&opts.URL, "url", "", "HTTPS media URL to import on the server (choose exactly one of --path or --url)")
 	return cmd
 }
 

package/cmd/upload_file_test.go

@@ -86,6 +86,90 @@ func TestUploadFileMediaContract(t *testing.T) {
 	}
 }
 
+func TestUploadFileURLContract(t *testing.T) {
+	const sourceURL = "https://assets.example.invalid/no-extension?X-Amz-Signature=keep%2Fexact&x=1"
+	for _, teamID := range []string{"0", "12", "34"} {
+		t.Run(teamID, func(t *testing.T) {
+			calls := 0
+			server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+				calls++
+				if r.Method != http.MethodPost || r.URL.Path != config.UploadFilePath {
+					t.Errorf("unexpected request: %s %s", r.Method, r.URL.Path)
+				}
+				wantTeamHeader := teamID
+				if teamID == "0" {
+					wantTeamHeader = ""
+				}
+				if r.Header.Get("X-Team-Id") != wantTeamHeader || r.Header.Get("Authorization") != "Bearer test-token" {
+					t.Error("URL upload lost selected space or authentication")
+				}
+				if r.Header.Get("Content-Type") != "application/json" {
+					t.Errorf("unexpected Content-Type: %s", r.Header.Get("Content-Type"))
+				}
+				var body map[string]string
+				if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
+					t.Error(err)
+				}
+				if len(body) != 1 || body["url"] != sourceURL {
+					t.Errorf("request must contain only the unchanged URL: %#v", body)
+				}
+				_, _ = w.Write([]byte(`{"ret":"0","data":{"asset_id":"source-id","pippit_asset_id":"asset-url"}}`))
+			}))
+			defer server.Close()
+			var stdout, stderr bytes.Buffer
+			root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+			// The origin is deliberately unreachable: only the API may fetch it.
+			root.SetArgs([]string{"upload-file", "--url", " " + sourceURL + " ", "--team-id", teamID})
+			if err := root.Execute(); err != nil {
+				t.Fatal(err)
+			}
+			var output map[string]string
+			if err := json.Unmarshal(stdout.Bytes(), &output); err != nil || len(output) != 2 || output["asset_id"] != "asset-url" || output["team_id"] != teamID || calls != 1 {
+				t.Fatalf("stdout = %q, requests = %d, err = %v", stdout.String(), calls, err)
+			}
+			if strings.Contains(stdout.String()+stderr.String(), "keep%2Fexact") {
+				t.Error("command output exposed the source signature")
+			}
+		})
+	}
+}
+
+func TestUploadFileRejectsInvalidSourcesBeforeRequest(t *testing.T) {
+	calls := 0
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		calls++
+		http.Error(w, "unexpected request", http.StatusInternalServerError)
+	}))
+	defer server.Close()
+	for _, tc := range []struct {
+		args []string
+		want string
+	}{
+		{nil, "必须且只能提供一个"},
+		{[]string{"--url", " "}, "必须且只能提供一个"},
+		{[]string{"--path", "missing.png", "--url", "https://example.com/media"}, "必须且只能提供一个"},
+		{[]string{"--url", "http://example.com/media"}, "HTTPS"},
+		{[]string{"--url", "file:///tmp/media.png"}, "HTTPS"},
+		{[]string{"--url", "https://user:secret@example.com/media"}, "HTTPS"},
+		{[]string{"--url", "https://example.com/media#secret"}, "HTTPS"},
+		{[]string{"--url", "https://example.com/%zz?signature=secret"}, "HTTPS"},
+	} {
+		var stdout, stderr bytes.Buffer
+		root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+		root.SetArgs(append([]string{"upload-file"}, tc.args...))
+		err := root.Execute()
+		if err == nil || !strings.Contains(err.Error(), tc.want) {
+			t.Errorf("args=%v: error=%v, want %s", tc.args, err, tc.want)
+		}
+		if err != nil && strings.Contains(err.Error(), "secret") {
+			t.Error("validation error exposed URL credentials")
+		}
+		if stdout.Len() != 0 || calls != 0 {
+			t.Fatalf("invalid sources produced output or a request: stdout=%s requests=%d", stdout.String(), calls)
+		}
+	}
+}
+
 func TestValidateMediaUpload(t *testing.T) {
 	dir := t.TempDir()
 	for _, tc := range []struct {
@@ -123,7 +207,7 @@ func TestUploadFileCommandHelpAndArguments(t *testing.T) {
 	var stdout, stderr bytes.Buffer
 	root := newRootCommand(&stdout, &stderr, nil)
 	root.SetArgs([]string{"upload-file", "--help"})
-	if err := root.Execute(); err != nil || !strings.Contains(stdout.String(), "--path") {
+	if err := root.Execute(); err != nil || !strings.Contains(stdout.String(), "--path") || !strings.Contains(stdout.String(), "--url") {
 		t.Fatalf("help must work without credentials: %v, %s", err, stdout.String())
 	}
 	for _, args := range [][]string{{"upload-file"}, {"upload-file", "--path", " "}, {"upload-file", "unexpected"}} {
@@ -140,18 +224,20 @@ func TestUploadFileRejectsInvalidResponse(t *testing.T) {
 	if err := os.WriteFile(path, []byte("media"), 0o600); err != nil {
 		t.Fatal(err)
 	}
-	for _, response := range []string{`{"ret":"1","errmsg":"rejected"}`, `{"ret":"0","data":{"asset_id":"wrong_field"}}`} {
+	for _, response := range []string{`{"ret":"1","errmsg":"rejected","log_id":"upload-log"}`, `{"ret":"0","data":{"asset_id":"wrong_field"},"log_id":"upload-log"}`} {
 		server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 			_, _ = io.Copy(io.Discard, r.Body)
 			_, _ = w.Write([]byte(response))
 		}))
-		var stdout, stderr bytes.Buffer
-		root := newTestRootCommand(t, &stdout, &stderr, server.URL)
-		root.SetArgs([]string{"upload-file", "--path", path})
-		err := root.Execute()
-		server.Close()
-		if err == nil || stdout.Len() != 0 {
-			t.Errorf("response %s: error = %v, stdout = %s", response, err, stdout.String())
+		for _, source := range [][]string{{"--path", path}, {"--url", "https://example.com/media"}} {
+			var stdout, stderr bytes.Buffer
+			root := newTestRootCommand(t, &stdout, &stderr, server.URL)
+			root.SetArgs(append([]string{"upload-file"}, source...))
+			err := root.Execute()
+			if err == nil || !strings.Contains(err.Error(), "upload-log") || stdout.Len() != 0 {
+				t.Errorf("response %s: error = %v, stdout = %s", response, err, stdout.String())
+			}
 		}
+		server.Close()
 	}
 }

package/dist/checksums.txt

@@ -0,0 +1,6 @@
+718067da81039c982cdcb9579f50a06a83bbc7c7dd599ab447b50e8b8e2b13ac  pippit-tool-cli-1.0.48-darwin-amd64.tar.gz
+d0aa4e2272c8369fb615b82bbb390a3e575e3b3df39dffbb5d38c6fc8e7d67c3  pippit-tool-cli-1.0.48-darwin-arm64.tar.gz
+838f221cef34481f042a2fec32da0f015d5c61151f43eeb3460ceb94c05601fd  pippit-tool-cli-1.0.48-linux-amd64.tar.gz
+1ff3d84ffe6a04bc6c5ed92d9e784308d8dc16fffc88037faa21665d9a74106c  pippit-tool-cli-1.0.48-linux-arm64.tar.gz
+04400b90e115ba0d9d8e0d6917e8b69cfe980fa5601bd5c9bdb2625135036d5e  pippit-tool-cli-1.0.48-windows-amd64.zip
+e6a2f024b93abcc546007fe1c5e2fcaebed11ab64123943c30dda9f47f8c4b63  pippit-tool-cli-1.0.48-windows-arm64.zip