@pippit-dev/cli 1.0.48 → 1.0.50

package/README.md

@@ -265,16 +265,11 @@ pippit-tool-cli canvas command run create_biz_node \
 
 `guide [topic]` 提供无需登录的离线帮助。无主题时仅返回索引，可选 `storyboard`、`prompt-references`、`time`、`timeline`、`scene3d`；正文包含单位、ID 来源、前置条件和最小示例。指南不启用新能力，先用 `list` 确认本机运行时支持哪些命令。故事板指南说明原生 `<duration-ms>` 标签累加与引用格式；目前没有公开的故事板脚本编辑、镜头排序或指定镜头生成领域命令，通用视频生成与资产补丁不能替代其业务流程。
 
-3D 导演台和多轨道都通过外层画布节点定位，其编辑内容保存在节点引用的独立文档或草稿资产中。先查询取得内部对象、轨道、片段 ID 和版本，再执行编辑：
+当前 SDK 主干的 3D 导演文档已迁移到 V2，旧 CLI 的 `xyq.scene3d.apply/query` 入口已移除。本版本沿用主干能力；3D 节点仍可通过业务工厂创建，内部对象编辑使用 Web 3D 导演台，不通过通用资产补丁改写文档。
 
-```bash
-pippit-tool-cli canvas command describe xyq.scene3d.apply
-pippit-tool-cli canvas command run xyq.scene3d.query \
-  --canvas-id CANVAS_ID --input '{"nodeId":"DIRECTOR_NODE_ID"}'
-pippit-tool-cli canvas command run xyq.scene3d.apply \
-  --canvas-id CANVAS_ID \
-  --input '{"nodeId":"DIRECTOR_NODE_ID","operations":[{"command":"create_node","args":{"kind":"camera","id":"camera-2","name":"Close-up"}}]}'
+多轨道通过外层画布节点定位，先查询轨道、片段 ID 和版本，再执行编辑：
 
+```bash
 pippit-tool-cli canvas command describe xyq.timeline.apply
 pippit-tool-cli canvas command run xyq.timeline.query \
   --canvas-id CANVAS_ID --input '{"nodeId":"TIMELINE_NODE_ID"}'
@@ -455,7 +450,7 @@ pippit-tool-cli query-result \
   --download-dir "./output"
 ```
 
-`query-result` 会查询指定 Run 并输出 JSON。Run 成功完成后下载视频和图片产物，`completed=true`，`videos` 和 `images` 中各包含 `download_url` 和 `output_path`；图片扩展名取自产物 `metadata.format`，缺省时兜底 `.png`。Run 失败也视为终态，`completed=true` 且填充 `error_message`；Run 未到终态时 `completed=false`。
+`query-result` 会查询指定 Run 并输出 JSON。Run 成功完成后下载视频和图片产物，`completed=true`、`status="succeeded"`，`videos` 和 `images` 中各包含 `download_url` 和 `output_path`；图片扩展名取自产物 `metadata.format`，缺省时兜底 `.png`。`status` 是机读状态，共 5 种取值：`running`（运行中，对应服务端已提交、处理中、生成中、程序中断等继续轮询的状态）、`succeeded`（成功）、`failed`（失败并填充 `error_message`）、`canceled`（已取消）、`unknown`（未指定、等待补充输入、人工交互中断等无法自动判定的状态）。`completed` 只表示是否到终态（成功、失败、已取消时为 true），判断成功失败请使用 `status`；查询或下载本身失败时 `status="unknown"`、`completed=false`，具体原因见 `error_message`。
 
 ## Adapter 接入边界
 

package/checksums.txt

@@ -1,6 +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
+a458435d1197a30b707df6a462f8226a7e0712a68321e80122f94c2adc1de6b5  pippit-tool-cli-1.0.50-darwin-amd64.tar.gz
+f2d521422ef4e4ac1f4a8ce1111f8bffd2b29a70e83cbaf5b931354085894152  pippit-tool-cli-1.0.50-darwin-arm64.tar.gz
+5655d75170e4e6616e12ba2f6c05849381b5eca14b70b4e5273357c457c90d85  pippit-tool-cli-1.0.50-linux-amd64.tar.gz
+c38ae24da3a18c9ce295a67523a3608da4c8fa10a1e125c03b07d635372f1894  pippit-tool-cli-1.0.50-linux-arm64.tar.gz
+a02ee4dfd051201fbbf84188d7969ec3be3ffa8a0ef70e0ac7fd94a307fce6af  pippit-tool-cli-1.0.50-windows-amd64.zip
+72f17b0945d8619ff5a80da26d474e8d4e30f56b4c70d0c01f838ae3fd8080b9  pippit-tool-cli-1.0.50-windows-arm64.zip

package/cmd/generate_video/query_result.go

@@ -26,7 +26,7 @@ func NewQueryResultCommand(stdout, stderr io.Writer, runner *common.Runner) *cob
 					"run_id":       strings.TrimSpace(opts.RunID),
 					"download_dir": strings.TrimSpace(opts.DownloadDir),
 				})
-				result = queryResultFromError(err, opts)
+				result = internalgen.NewQueryResultError(err, opts)
 			}
 			encoder := json.NewEncoder(stdout)
 			encoder.SetIndent("", "  ")
@@ -40,16 +40,3 @@ func NewQueryResultCommand(stdout, stderr io.Writer, runner *common.Runner) *cob
 	cmd.Flags().StringVar(&opts.DownloadDir, "download-dir", "", "directory to download completed videos or images into")
 	return cmd
 }
-
-func queryResultFromError(err error, opts *internalgen.QueryResultOptions) *internalgen.QueryResultResult {
-	result := &internalgen.QueryResultResult{
-		ErrorMessage: err.Error(),
-		Videos:       []internalgen.QueryResultVideo{},
-		Images:       []internalgen.QueryResultImage{},
-	}
-	if opts != nil {
-		result.ThreadID = strings.TrimSpace(opts.ThreadID)
-		result.RunID = strings.TrimSpace(opts.RunID)
-	}
-	return result
-}

package/cmd/generate_video_test.go

@@ -2,6 +2,7 @@ package cmd
 
 import (
 	"bytes"
+	"fmt"
 	"io"
 	"net/http"
 	"net/http/httptest"
@@ -496,6 +497,9 @@ func TestQueryResultDownloadsCompletedVideo(t *testing.T) {
 	if got["completed"] != true {
 		t.Fatalf("completed = %v, want true", got["completed"])
 	}
+	if got["status"] != "succeeded" {
+		t.Fatalf("status = %v, want succeeded", got["status"])
+	}
 	if got["thread_id"] != "thread_123" || got["run_id"] != "run_456" {
 		t.Fatalf("ids = (%v, %v), want thread/run ids", got["thread_id"], got["run_id"])
 	}
@@ -600,6 +604,9 @@ func TestQueryResultIgnoresVideoDataWithoutVideoSubType(t *testing.T) {
 	if got["completed"] != false {
 		t.Fatalf("completed = %v, want false", got["completed"])
 	}
+	if got["status"] != "unknown" {
+		t.Fatalf("status = %v, want unknown", got["status"])
+	}
 	if got["thread_id"] != "thread_123" || got["run_id"] != "run_456" {
 		t.Fatalf("ids = (%v, %v), want thread/run ids", got["thread_id"], got["run_id"])
 	}
@@ -628,6 +635,9 @@ func TestQueryResultValidationErrorReturnsJSON(t *testing.T) {
 	if got["completed"] != false {
 		t.Fatalf("completed = %v, want false", got["completed"])
 	}
+	if got["status"] != "unknown" {
+		t.Fatalf("status = %v, want unknown", got["status"])
+	}
 	if got["thread_id"] != "" || got["run_id"] != "run_456" {
 		t.Fatalf("ids = (%v, %v), want empty thread_id and run_id", got["thread_id"], got["run_id"])
 	}
@@ -664,12 +674,15 @@ func TestQueryResultGetThreadBusinessErrorReturnsErrorMessage(t *testing.T) {
 		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
 	}
 	got := decodeJSON(t, stdout.Bytes())
-	if got["completed"] != true {
-		t.Fatalf("completed = %v, want true", got["completed"])
+	if got["completed"] != false {
+		t.Fatalf("completed = %v, want false", got["completed"])
 	}
 	if got["thread_id"] != "thread_123" || got["run_id"] != "run_456" {
 		t.Fatalf("ids = (%v, %v), want thread/run ids", got["thread_id"], got["run_id"])
 	}
+	if got["status"] != "unknown" {
+		t.Fatalf("status = %v, want unknown", got["status"])
+	}
 	if got["error_message"] != "创作失败：暂时无法生成 log_id=log_456" {
 		t.Fatalf("error_message = %v, want get_thread business error", got["error_message"])
 	}
@@ -706,6 +719,9 @@ func TestQueryResultFailedReturnsErrorMessage(t *testing.T) {
 	if got["completed"] != true {
 		t.Fatalf("completed = %v, want true", got["completed"])
 	}
+	if got["status"] != "failed" {
+		t.Fatalf("status = %v, want failed", got["status"])
+	}
 	if _, ok := got["state"]; ok {
 		t.Fatalf("state should not be returned: %#v", got)
 	}
@@ -745,6 +761,9 @@ func TestQueryResultPendingDoesNotDownload(t *testing.T) {
 	if got["completed"] != false {
 		t.Fatalf("completed = %v, want false", got["completed"])
 	}
+	if got["status"] != "running" {
+		t.Fatalf("status = %v, want running", got["status"])
+	}
 	if _, ok := got["state"]; ok {
 		t.Fatalf("state should not be returned: %#v", got)
 	}
@@ -757,6 +776,58 @@ func TestQueryResultPendingDoesNotDownload(t *testing.T) {
 	}
 }
 
+func TestQueryResultRunStateMapping(t *testing.T) {
+	// state=3 needs artifacts and is covered by the dedicated success tests;
+	// every other state must map deterministically, including unknown values.
+	tests := []struct {
+		state         int
+		wantStatus    string
+		wantCompleted bool
+	}{
+		{0, "unknown", false},
+		{1, "running", false},
+		{2, "running", false},
+		{4, "failed", true},
+		{5, "canceled", true},
+		{6, "unknown", false},
+		{7, "running", false},
+		{8, "running", false},
+		{9, "unknown", false},
+		{99, "unknown", false},
+	}
+	for _, tt := range tests {
+		t.Run(fmt.Sprintf("state=%d", tt.state), func(t *testing.T) {
+			server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+				if r.URL.Path != "/api/biz/v1/skill/get_thread" {
+					t.Fatalf("unexpected path %s", r.URL.Path)
+				}
+				payload := fmt.Sprintf(`{"ret":"0","data":{"thread":{"thread_id":"thread_123","run_list":[{"run_id":"run_456","state":%d}]}}}`, tt.state)
+				_, _ = w.Write([]byte(payload))
+			}))
+			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())
+			}
+			got := decodeJSON(t, stdout.Bytes())
+			if got["status"] != tt.wantStatus {
+				t.Fatalf("status = %v, want %s", got["status"], tt.wantStatus)
+			}
+			if got["completed"] != tt.wantCompleted {
+				t.Fatalf("completed = %v, want %v", got["completed"], tt.wantCompleted)
+			}
+		})
+	}
+}
+
 func serverURL(r *http.Request) string {
 	return "http://" + r.Host
 }

package/dist/checksums.txt

@@ -1,6 +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
+a458435d1197a30b707df6a462f8226a7e0712a68321e80122f94c2adc1de6b5  pippit-tool-cli-1.0.50-darwin-amd64.tar.gz
+f2d521422ef4e4ac1f4a8ce1111f8bffd2b29a70e83cbaf5b931354085894152  pippit-tool-cli-1.0.50-darwin-arm64.tar.gz
+5655d75170e4e6616e12ba2f6c05849381b5eca14b70b4e5273357c457c90d85  pippit-tool-cli-1.0.50-linux-amd64.tar.gz
+c38ae24da3a18c9ce295a67523a3608da4c8fa10a1e125c03b07d635372f1894  pippit-tool-cli-1.0.50-linux-arm64.tar.gz
+a02ee4dfd051201fbbf84188d7969ec3be3ffa8a0ef70e0ac7fd94a307fce6af  pippit-tool-cli-1.0.50-windows-amd64.zip
+72f17b0945d8619ff5a80da26d474e8d4e30f56b4c70d0c01f838ae3fd8080b9  pippit-tool-cli-1.0.50-windows-arm64.zip