@pippit-dev/cli 0.0.15 → 0.0.16

package/README.md

@@ -13,7 +13,7 @@ export XYQ_ACCESS_KEY="<access-key>"
 pippit-tool-cli --version
 pippit-tool-cli short-drama +submit-run --message "写一个赛博朋克短剧开头"
 pippit-tool-cli short-drama +upload-file --path ./reference.doc
-pippit-tool-cli short-drama +get-thread --thread-id thread_123 --run-id run_456 --after-seq 0
+pippit-tool-cli short-drama +get-thread --thread-id thread_123 --run-id run_456
 pippit-tool-cli short-drama +download-result --output-path ./thread_123/results/result.mp4 --url URL
 ```
 
@@ -27,14 +27,14 @@ export XYQ_ACCESS_KEY="<access-key>"
 go run . --version
 go run . short-drama +submit-run --message "写一个赛博朋克短剧开头"
 go run . short-drama +upload-file --path ./reference.doc
-go run . short-drama +get-thread --thread-id thread_123 --run-id run_456 --after-seq 0
+go run . short-drama +get-thread --thread-id thread_123 --run-id run_456
 go run . short-drama +download-result --output-path ./thread_123/results/result.mp4 --url URL
 ```
 
 `+submit-run` calls `/api/biz/v1/skill/submit_run` and prints `thread_id`,
 `run_id`, and `web_thread_link`; `--message` is required.
 `+get-thread` calls
-`/api/biz/v1/skill/get_thread` and prints extracted `messages`.
+`/api/biz/v1/skill/get_thread` with `version=v2` and prints `readable_text`.
 `+upload-file` calls `/api/biz/v1/skill/upload_file` with
 `multipart/form-data` and prints the returned `asset_id`.
 Only `.doc` and `.txt` file extensions are supported.

package/checksums.txt

@@ -1,6 +1,6 @@
-fa8c1c2792f7d35d5cc3d404d54f3739b27d293f752109a12b1eb472a42cb137  pippit-tool-cli-0.0.15-darwin-amd64.tar.gz
-b7fea091af69a21d3817af90781c89c45c2c3a7eebfbcaf9c7d1cc4ed5817661  pippit-tool-cli-0.0.15-darwin-arm64.tar.gz
-8efb9fbdf2bcb67444ace90f376b82f81b6e7d28c17f8a63cf3f659796ec4a9f  pippit-tool-cli-0.0.15-linux-amd64.tar.gz
-6e9b689ca808704d551967abdf9e3bf7bbb462e8f87978b9f5f8d09c49ae8e31  pippit-tool-cli-0.0.15-linux-arm64.tar.gz
-1dcb53bd959026ddcae51c2cf50174ab90c900875992c28b3d568cf88fcb5408  pippit-tool-cli-0.0.15-windows-amd64.zip
-4c1cdaea7521d9600ad33a2091e078104a5891d7950c527bc05176bd0cf2ffba  pippit-tool-cli-0.0.15-windows-arm64.zip
+a00ec8d732b4be5994aecb2863d9841cd1afd9008e83122667aad17df84dc0b3  pippit-tool-cli-0.0.16-darwin-amd64.tar.gz
+58ddfc2b146ae34aa5f003664c4f123708d100dd90f61b262201e9c80b011fc6  pippit-tool-cli-0.0.16-darwin-arm64.tar.gz
+ad35f1d3fe7e811e9775d8cd6b2e7a8de649f19c196958c77b54926ae502a288  pippit-tool-cli-0.0.16-linux-amd64.tar.gz
+fda684084fb7b1c2e74ac7c9ffa2a8dec2e35b3efd8326c59ab2599363caaa17  pippit-tool-cli-0.0.16-linux-arm64.tar.gz
+d38681622dcfdd8d318efef6dcb1becebdef355b962c417824b8ce0699565a8d  pippit-tool-cli-0.0.16-windows-amd64.zip
+6a62da1a7a6482040c929f1a4f886188a966ae44d645bad18d89eb49f77aa800  pippit-tool-cli-0.0.16-windows-arm64.zip

package/cmd/short_drama/short_drama.go

@@ -145,7 +145,6 @@ func newShortDramaGetThreadCommand(stdout, stderr io.Writer, runner *common.Runn
 	cmd.SetErr(stderr)
 	cmd.Flags().StringVar(&opts.ThreadID, "thread-id", "", "thread ID to fetch")
 	cmd.Flags().StringVar(&opts.RunID, "run-id", "", "run ID to fetch")
-	cmd.Flags().IntVar(&opts.AfterSeq, "after-seq", 0, "return messages whose sequence is greater than or equal to this value")
 	return cmd
 }
 

package/cmd/short_drama_test.go

@@ -569,10 +569,13 @@ func TestShortDramaGetThread(t *testing.T) {
 		if body["run_id"] != "run_456" {
 			t.Fatalf("run_id = %v, want run_456", body["run_id"])
 		}
-		if body["after_seq"] != float64(7) {
-			t.Fatalf("after_seq = %v, want 7", body["after_seq"])
+		if _, ok := body["after_seq"]; ok {
+			t.Fatalf("after_seq = %v, want omitted", body["after_seq"])
 		}
-		_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"thread":{"run_list":[{"state":3,"entry_list":[{"message":{"message_id":"msg_1","role":"assistant","content":[{"text":"hello"}],"client_tool_calls":[{"name":"tool_call"}]}},{"artifact":{"artifact_id":"artifact_1","role":"assistant","content":[{"type":"image"}]}}]}]}}}`))
+		if body["version"] != "v2" {
+			t.Fatalf("version = %v, want v2", body["version"])
+		}
+		_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"readable_text":"Thread: thread_123\n       [assistant] hello"}}`))
 	}))
 	defer server.Close()
 
@@ -582,7 +585,6 @@ func TestShortDramaGetThread(t *testing.T) {
 		"short-drama", "+get-thread",
 		"--thread-id", "thread_123",
 		"--run-id", "run_456",
-		"--after-seq", "7",
 	})
 
 	if err := root.Execute(); err != nil {
@@ -590,20 +592,8 @@ func TestShortDramaGetThread(t *testing.T) {
 	}
 
 	got := decodeJSON(t, stdout.Bytes())
-	messages, ok := got["messages"].([]any)
-	if !ok || len(messages) != 2 {
-		t.Fatalf("messages = %#v, want two entries", got["messages"])
-	}
-	first, ok := messages[0].(map[string]any)
-	if !ok {
-		t.Fatalf("first message = %#v, want object", messages[0])
-	}
-	if first["id"] != "msg_1" {
-		t.Fatalf("first id = %v, want msg_1", first["id"])
-	}
-	content, ok := first["content"].([]any)
-	if !ok || len(content) != 2 {
-		t.Fatalf("first content = %#v, want message content plus tool call", first["content"])
+	if got["readable_text"] != "Thread: thread_123\n       [assistant] hello" {
+		t.Fatalf("readable_text = %#v, want API readable text", got["readable_text"])
 	}
 }
 

package/internal/short_drama/get_thread.go

@@ -8,59 +8,27 @@ import (
 	"github.com/Pippit-dev/pippit-cli/internal/config"
 )
 
+const getThreadVersionV2 = "v2"
+
 // GetThreadOptions is the stable command-facing request shape for thread lookup.
 type GetThreadOptions struct {
 	ThreadID string `json:"thread_id"`
 	RunID    string `json:"run_id,omitempty"`
-	AfterSeq int    `json:"after_seq"`
-}
-
-// ThreadEntry is a compact message or artifact entry inside a thread run.
-type ThreadEntry struct {
-	ID      string `json:"id"`
-	Role    string `json:"role"`
-	Content []any  `json:"content"`
 }
 
 // GetThreadResult is the JSON envelope printed by `pippit-tool-cli short-drama +get-thread`.
 type GetThreadResult struct {
-	Messages []*ThreadEntry `json:"messages"`
+	ReadableText string `json:"readable_text"`
 }
 
 type getThreadResponse struct {
 	Ret    string `json:"ret"`
 	Errmsg string `json:"errmsg"`
 	Data   struct {
-		Thread struct {
-			RunList []getThreadRun `json:"run_list"`
-		} `json:"thread"`
+		ReadableText string `json:"readable_text"`
 	} `json:"data"`
 }
 
-type getThreadRun struct {
-	State      int              `json:"state"`
-	FailReason string           `json:"fail_reason"`
-	EntryList  []getThreadEntry `json:"entry_list"`
-}
-
-type getThreadEntry struct {
-	Message  *getThreadMessage  `json:"message"`
-	Artifact *getThreadArtifact `json:"artifact"`
-}
-
-type getThreadMessage struct {
-	MessageID       string `json:"message_id"`
-	Role            string `json:"role"`
-	Content         []any  `json:"content"`
-	ClientToolCalls []any  `json:"client_tool_calls"`
-}
-
-type getThreadArtifact struct {
-	ArtifactID string `json:"artifact_id"`
-	Role       string `json:"role"`
-	Content    []any  `json:"content"`
-}
-
 func GetThread(ctx context.Context, opts *GetThreadOptions, runner *common.Runner) (*GetThreadResult, error) {
 	if runner == nil || runner.Client == nil {
 		return nil, fmt.Errorf("get_thread runner client is required")
@@ -68,7 +36,7 @@ func GetThread(ctx context.Context, opts *GetThreadOptions, runner *common.Runne
 
 	body := map[string]any{
 		"thread_id": opts.ThreadID,
-		"after_seq": opts.AfterSeq,
+		"version":   getThreadVersionV2,
 	}
 	if opts.RunID != "" {
 		body["run_id"] = opts.RunID
@@ -84,51 +52,15 @@ func GetThread(ctx context.Context, opts *GetThreadOptions, runner *common.Runne
 		}
 		return nil, fmt.Errorf("get_thread failed: ret=%s errmsg=%s", resp.Ret, resp.Errmsg)
 	}
-	if len(resp.Data.Thread.RunList) == 0 {
-		return nil, fmt.Errorf("get_thread response missing data.thread.run_list")
-	}
-
-	run := resp.Data.Thread.RunList[0]
-	// 4: failed
-	// 5: canceled
-	if run.State == 4 {
-		if run.FailReason == "" {
-			run.FailReason = "unknown failure"
-		}
-		return nil, fmt.Errorf("get_thread run failed: %s", run.FailReason)
-	}
-	if run.State == 5 {
-		return nil, fmt.Errorf("get_thread run canceled")
+	if resp.Data.ReadableText == "" {
+		return nil, fmt.Errorf("get_thread response missing data.readable_text")
 	}
 
 	return &GetThreadResult{
-		Messages: extractThreadEntries(run),
+		ReadableText: resp.Data.ReadableText,
 	}, nil
 }
 
-func extractThreadEntries(run getThreadRun) []*ThreadEntry {
-	entries := make([]*ThreadEntry, 0, len(run.EntryList))
-	for _, entry := range run.EntryList {
-		if entry.Message != nil {
-			content := append([]any(nil), entry.Message.Content...)
-			content = append(content, entry.Message.ClientToolCalls...)
-			entries = append(entries, &ThreadEntry{
-				ID:      entry.Message.MessageID,
-				Role:    entry.Message.Role,
-				Content: content,
-			})
-		}
-		if entry.Artifact != nil {
-			entries = append(entries, &ThreadEntry{
-				ID:      entry.Artifact.ArtifactID,
-				Role:    entry.Artifact.Role,
-				Content: entry.Artifact.Content,
-			})
-		}
-	}
-	return entries
-}
-
 func getThreadPath(runner *common.Runner) string {
 	if runner != nil && runner.Config != nil && runner.Config.Paths != nil && runner.Config.Paths.GetThread != "" {
 		return runner.Config.Paths.GetThread

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pippit-dev/cli",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "Pippit CLI",
   "bin": {
     "pippit-tool-cli": "scripts/run.js"

package/skills/short-drama/SKILL.md

@@ -24,7 +24,7 @@ metadata:
 ## 功能
 
 1. **提交短剧 Run 任务** - 创建新会话或向已有会话发送短剧创作需求。
-2. **查询会话进展** - 根据 `thread_id`、`run_id`、`after_seq` 拉取短剧任务消息列表。
+2. **查询会话进展** - 根据 `thread_id` 和可选 `run_id` 拉取服务端 v2 `readable_text`，用于展示短剧任务进展、问题和结果。
 3. **上传文件** - 上传本地 `.doc` / `.txt` 参考文件，得到 `asset_id`，供后续任务引用。
 4. **获取会话文件** - 根据 `thread_id` 拉取会话文件列表，得到 `file_path`、`download_url`。这和查询会话进展同等重要。
 5. **下载重要资产** - 使用文件列表中的 `download_url` 下载资源，并按 `file_path` 写入用户本地目标文件路径。
@@ -57,11 +57,11 @@ pippit-tool-cli short-drama +submit-run --message "参考这个大纲写第一
 ### 2. 查询短剧任务进展
 
 ```bash
-# 查询会话消息列表
-pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq 0
+# 查询会话可读进展
+pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID
 ```
 
-> `thread_id` 和 `run_id` 由 `+submit-run` 返回。`after-seq` 用于增量拉取消息，首次查询可使用 `0`。
+> `thread_id` 和 `run_id` 由 `+submit-run` 返回。`run_id` 可省略，省略时返回当前 `thread_id` 下的所有 Run；传入时只看指定 Run。
 
 ### 3. 上传文件
 
@@ -117,11 +117,11 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
    → 拿到 thread_id、run_id 和 web_thread_link
 2. 立即将 web_thread_link 展示给用户
 3. 并行发起，二者同等重要：
-   a. pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq SEQUENCE
+   a. pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID
    b. pippit-tool-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num PAGE_NUM --page-size 200
-4. 检查 `get-thread` 返回的 messages：
-   - 如果任务仍在进行中：展示过程消息，继续查询
-   - 如果后端 Agent 提出问题：展示问题，等待用户回复
+4. 检查 `get-thread` 返回的 readable_text：
+   - 如果任务仍在进行中：展示可读进展，继续查询
+   - 如果后端 Agent 提出问题：从 readable_text 中提取问题并展示，等待用户回复
 5. 检查 `list-thread-file` 返回的 files：
    - 对每个文件取 file_path、download_url
    - 将 file_path 作为本地目标文件路径，包含文件名
@@ -161,7 +161,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 ## 轮询策略
 
 - **间隔**：每 10 秒查询一次。
-- **增量拉取**：首次使用 `--after-seq 0`，后续根据已读消息进度调整 `after-seq`。
+- **进展查询**：每轮调用 `+get-thread` 查看 `readable_text`。优先带上本轮 `run_id` 聚焦当前任务；需要查看整个会话时可省略 `--run-id`。
 - **并行查询**：每次 `+submit-run` 返回 `thread_id` 后，同时发起 `+get-thread` 和 `+list-thread-file`；二者同等重要，不能只查询会话进展而忽略会话文件。
 - **文件分页**：`+list-thread-file` 使用 `--page-size 200`。如果本轮返回的 `total` 达到 200，下一轮使用 `--page-num` 加 1 查询新一页结果；如果未达到 200，保持当前页继续轮询新增产物。
 - **重要资产识别**：每轮都检查 `+list-thread-file` 返回的文件。剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物都是重要资产。
@@ -173,9 +173,9 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 ## 完成标准
 
-一次短剧任务不能只以 `+get-thread` 返回完成消息作为结束条件。完成前必须同时检查：
+一次短剧任务不能只以 `+get-thread` 返回的 `readable_text` 作为结束条件。完成前必须同时检查：
 
-1. 已处理 `+get-thread` 返回的最新会话进展、用户确认问题和最终消息。
+1. 已处理 `+get-thread` 返回的最新 `readable_text`、用户确认问题和最终消息。
 2. 已用 `--page-size 200` 调用 `+list-thread-file` 获取会话文件列表；如果本轮 `total` 达到 200，已在后续轮询中递增 `page-num` 查询新一页。
 3. 对所有带 `download_url` 的重要资产，已调用 `+download-result` 下载到本地 `file_path`。
 4. 对查询失败或下载失败的资产，已在后续轮询中主动重试，并在最终回复中列出仍失败的文件或命令。
@@ -196,18 +196,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 ```json
 {
-  "messages": [
-    {
-      "id": "message_...",
-      "role": "assistant",
-      "content": [
-        {
-          "type": "text",
-          "data": {}
-        }
-      ]
-    }
-  ]
+  "readable_text": "Thread: thread_...\n     标题: ...\n     状态: ...\n\n     -- Run #1 --\n       [assistant] ..."
 }
 ```
 
@@ -253,7 +242,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 ### 获取会话文件
 
-从 `+list-thread-file` 的 `files` 中逐个读取文件元信息：`file_path`、`download_url`。重点识别剧本大纲、故事线设计、场景设计说明、场景图、人物角色设计说明、人物图、分集草稿、分镜片段视频、故事板、最终视频产物等重要资产。
+从 `+list-thread-file` 的 `files` 中逐个读取文件元信息：`file_path`、`file_name`、`download_url`。重点识别剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物等重要资产。
 
 ```
 1. 有download_url的重要资产
@@ -293,7 +282,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 1. **上传**：如果用户给了本地 `.doc` / `.txt` 参考文件，先调用 `+upload-file`。
 2. **提交任务**：首次创作时把用户原始短剧需求和唯一剧本 `asset_id` 通过 `+submit-run --asset-ids` 发给后端；同一 `thread_id` 后续续写或修改不再追加新的剧本文件。
-3. **传话、取文件、下载资源**：根据 `+get-thread` 返回的消息展示进展、问题和结果；根据 `+list-thread-file` 获取文件列表；再根据 `download_url` 调用 `+download-result` 把缺失资源下载到用户本地。
+3. **传话、取文件、下载资源**：根据 `+get-thread` 返回的 `readable_text` 展示进展、问题和结果；根据 `+list-thread-file` 获取文件列表；再根据 `download_url` 调用 `+download-result` 把缺失资源下载到用户本地。
 
 **不要做的事：**
 
@@ -307,8 +296,8 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 ## 注意事项
 
 - `--message` 是用户的原始短剧需求，不能为空。
-- 查询进展时优先使用 `+submit-run` 返回的 `thread_id` 和 `run_id`。
-- `--after-seq` 用于增量拉取消息，首次查询可设置为 `0`。
+- 查询进展时优先使用 `+submit-run` 返回的 `thread_id` 和 `run_id`；如果需要查看整个会话，可以省略 `--run-id`。
+- `+get-thread` 当前固定走服务端 v2 响应，输出字段是 `readable_text`；不要解析旧版 `messages` 数组。
 - `+upload-file` 当前用于短剧场景文件上传链路，只支持本地 `.doc` / `.txt` 文件；`--path` 不能为空，路径必须指向真实文件，不能是目录。
 - `+upload-file` 上传成功后只返回 `asset_id`；把该值原样作为 `+submit-run --asset-ids` 的参数。
 - 单次创作会话中（相同 `thread_id`），`+submit-run` 只支持绑定一个剧本文件。不要在同一 `thread_id` 下重复上传并追加第二个剧本 `asset_id`；用户给多个剧本时，先让用户选择一个，或分别开启新的创作会话。

package/internal/short_drama/mock.go

@@ -1,47 +0,0 @@
-package short_drama
-
-import (
-	"context"
-	"crypto/sha1"
-	"encoding/hex"
-)
-
-// MockClient returns deterministic IDs so the demo chain is easy to test.
-type MockClient struct{}
-
-func (MockClient) SubmitRun(ctx context.Context, opts SubmitRunOptions) (*SubmitRunResult, error) {
-	if err := ctx.Err(); err != nil {
-		return nil, err
-	}
-	key := opts.ThreadID + "\x00" + opts.Message
-	id := stableIDMock(key, 12)
-	return &SubmitRunResult{
-		ThreadID:      "thread_mock_" + id[:6],
-		RunID:         "run_mock_" + id[6:],
-		WebThreadLink: "https://xyq.jianying.com/mock/thread_mock_" + id[:6],
-	}, nil
-}
-
-func (MockClient) GetThread(ctx context.Context, opts GetThreadOptions) (*GetThreadResult, error) {
-	if err := ctx.Err(); err != nil {
-		return nil, err
-	}
-	return &GetThreadResult{
-		Messages: []*ThreadEntry{
-			{
-				ID:      "message_mock_" + stableIDMock(opts.ThreadID, 8),
-				Role:    "assistant",
-				Content: []any{"mock thread message"},
-			},
-		},
-	}, nil
-}
-
-func stableIDMock(key string, n int) string {
-	sum := sha1.Sum([]byte(key))
-	id := hex.EncodeToString(sum[:])
-	if n > len(id) {
-		return id
-	}
-	return id[:n]
-}