@pippit-dev/cli 0.0.15 → 0.0.17

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,17 +27,17 @@ 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.
+Only `.doc`, `.docx`, and `.txt` file extensions are supported.
 `+download-result` downloads the result URL to
 the `--output-path` file path.
 

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
+dc08d1d25fe9fb2d2ed4dc5c2dec42b999ffe9f42f7dfac723d50f85d9107099  pippit-tool-cli-0.0.17-darwin-amd64.tar.gz
+f696c2aec0901638716b5037231fd47916c557b6157c1dcff559c894d7992c5a  pippit-tool-cli-0.0.17-darwin-arm64.tar.gz
+ee4386da9ba02e5dfd93786b319e42af2a41c1fa01c20151232b87ebc81ef343  pippit-tool-cli-0.0.17-linux-amd64.tar.gz
+795c624e273acb9edb0f4851d767d4f58b947e8dc056a7246a64bbb30b085bc1  pippit-tool-cli-0.0.17-linux-arm64.tar.gz
+0e3eb11d38fd04686317df1185195e12180265b9bd7bbb1de2b68a145d72f339  pippit-tool-cli-0.0.17-windows-amd64.zip
+acccf51f98a58f3d887a6e2c9131b8acbbc246b6c518ebe8c26b28ad20ed0a54  pippit-tool-cli-0.0.17-windows-arm64.zip

package/cmd/short_drama/short_drama.go

@@ -138,14 +138,14 @@ func newShortDramaGetThreadCommand(stdout, stderr io.Writer, runner *common.Runn
 			if err != nil {
 				return err
 			}
-			return writeJSON(stdout, result)
+			_, err = fmt.Fprintln(stdout, result.ReadableText)
+			return err
 		},
 	}
 	cmd.SetOut(stdout)
 	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

@@ -196,11 +196,11 @@ func TestShortDramaUploadFile(t *testing.T) {
 		if len(files) != 1 {
 			t.Fatalf("file parts = %d, want 1", len(files))
 		}
-		if files[0].Filename != "story.txt" {
-			t.Fatalf("filename = %q, want story.txt", files[0].Filename)
+		if files[0].Filename != "story.docx" {
+			t.Fatalf("filename = %q, want story.docx", files[0].Filename)
 		}
-		if got := files[0].Header.Get("Content-Type"); got != "text/plain; charset=utf-8" {
-			t.Fatalf("Content-Type = %q, want text/plain; charset=utf-8", got)
+		if got := files[0].Header.Get("Content-Type"); got != "application/vnd.openxmlformats-officedocument.wordprocessingml.document" {
+			t.Fatalf("Content-Type = %q, want docx content type", got)
 		}
 		file, err := files[0].Open()
 		if err != nil {
@@ -211,16 +211,16 @@ func TestShortDramaUploadFile(t *testing.T) {
 		if err != nil {
 			t.Fatalf("ReadAll multipart file: %v", err)
 		}
-		if string(data) != "txt-data" {
-			t.Fatalf("file content = %q, want txt-data", string(data))
+		if string(data) != "docx-data" {
+			t.Fatalf("file content = %q, want docx-data", string(data))
 		}
 		_, _ = w.Write([]byte(`{"ret":"0","errmsg":"","data":{"pippit_asset_id":"asset_123"}}`))
 	}))
 	defer server.Close()
 
 	cwd := chdirTemp(t)
-	path := filepath.Join(cwd, "story.txt")
-	if err := os.WriteFile(path, []byte("txt-data"), 0o644); err != nil {
+	path := filepath.Join(cwd, "story.docx")
+	if err := os.WriteFile(path, []byte("docx-data"), 0o644); err != nil {
 		t.Fatalf("WriteFile(): %v", err)
 	}
 
@@ -292,7 +292,7 @@ func TestShortDramaUploadFileRejectsUnsupportedFileType(t *testing.T) {
 	if err == nil {
 		t.Fatal("Execute() error = nil, want file type validation error")
 	}
-	if !strings.Contains(err.Error(), "only .doc and .txt uploads are supported") {
+	if !strings.Contains(err.Error(), "only .doc, .docx, and .txt uploads are supported") {
 		t.Fatalf("error = %q, want unsupported type validation", err)
 	}
 }
@@ -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,28 +585,14 @@ 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 {
 		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
 	}
 
-	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 := stdout.String(); got != "Thread: thread_123\n       [assistant] hello\n" {
+		t.Fatalf("stdout = %#v, want API readable text", got)
 	}
 }
 

package/internal/common/upload_file.go

@@ -36,8 +36,9 @@ type uploadFileResponse struct {
 const uploadFileFieldName = "file"
 
 var allowedUploadExtensions = map[string]bool{
-	".doc": true,
-	".txt": true,
+	".doc":  true,
+	".docx": true,
+	".txt":  true,
 }
 
 func UploadFile(ctx context.Context, opts UploadFileOptions, runner *Runner) (*UploadFileResult, error) {
@@ -62,7 +63,7 @@ func UploadFile(ctx context.Context, opts UploadFileOptions, runner *Runner) (*U
 
 	ext := strings.ToLower(filepath.Ext(path))
 	if !allowedUploadExtensions[ext] {
-		return nil, fmt.Errorf("unsupported file extension %q; only .doc and .txt uploads are supported", ext)
+		return nil, fmt.Errorf("unsupported file extension %q; only .doc, .docx, and .txt uploads are supported", ext)
 	}
 	fileName := filepath.Base(path)
 	contentType := mime.TypeByExtension(ext)

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`.
+// GetThreadResult is the parsed get_thread response used 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.17",
   "description": "Pippit CLI",
   "bin": {
     "pippit-tool-cli": "scripts/run.js"

package/skills/short-drama/SKILL.md

@@ -24,8 +24,8 @@ metadata:
 ## 功能
 
 1. **提交短剧 Run 任务** - 创建新会话或向已有会话发送短剧创作需求。
-2. **查询会话进展** - 根据 `thread_id`、`run_id`、`after_seq` 拉取短剧任务消息列表。
-3. **上传文件** - 上传本地 `.doc` / `.txt` 参考文件，得到 `asset_id`，供后续任务引用。
+2. **查询会话进展** - 根据 `thread_id` 和可选 `run_id` 拉取服务端 v2 `readable_text`，用于展示短剧任务进展、问题和结果。
+3. **上传文件** - 上传本地 `.doc` / `.docx` / `.txt` 参考文件，得到 `asset_id`，供后续任务引用。
 4. **获取会话文件** - 根据 `thread_id` 拉取会话文件列表，得到 `file_path`、`download_url`。这和查询会话进展同等重要。
 5. **下载重要资产** - 使用文件列表中的 `download_url` 下载资源，并按 `file_path` 写入用户本地目标文件路径。
 
@@ -57,15 +57,15 @@ 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. 上传文件
 
-当用户提供短剧大纲、人物设定、世界观设定、已有分集或剧本等本地参考文件时，可先上传文件。`+upload-file` 当前只接收本地文件路径，并且只支持 `.doc` 和 `.txt` 后缀；不要把 `.md`、`.pdf`、图片、视频或 URL 传给该命令。
+当用户提供短剧大纲、人物设定、世界观设定、已有分集或剧本等本地参考文件时，可先上传文件。`+upload-file` 当前只接收本地文件路径，并且只支持 `.doc`、`.docx` 和 `.txt` 后缀；不要把 `.md`、`.pdf`、图片、视频或 URL 传给该命令。
 
 ```bash
 pippit-tool-cli short-drama +upload-file --path /path/to/outline.txt
@@ -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 作为本地目标文件路径，包含文件名
@@ -140,7 +140,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 ### 场景 2：用户提供参考文件要求创作
 
 ```
-1. 检查用户提供的是一个本地 `.doc` 或 `.txt` 剧本文件路径；如果不是，告知当前上传命令只支持这两类文件，不要擅自转换或改写文件。
+1. 检查用户提供的是一个本地 `.doc`、`.docx` 或 `.txt` 剧本文件路径；如果不是，告知当前上传命令只支持这三类文件，不要擅自转换或改写文件。
 2. pippit-tool-cli short-drama +upload-file --path /path/to/file.txt
    → 拿到 asset_id
 3. pippit-tool-cli short-drama +submit-run --message "用户的原始短剧需求" --asset-ids asset_id
@@ -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. 对查询失败或下载失败的资产，已在后续轮询中主动重试，并在最终回复中列出仍失败的文件或命令。
@@ -194,21 +194,13 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 **+get-thread** 返回：
 
-```json
-{
-  "messages": [
-    {
-      "id": "message_...",
-      "role": "assistant",
-      "content": [
-        {
-          "type": "text",
-          "data": {}
-        }
-      ]
-    }
-  ]
-}
+```text
+Thread: thread_...
+     标题: ...
+     状态: ...
+
+     -- Run #1 --
+       [assistant] ...
 ```
 
 **+upload-file** 返回：
@@ -219,7 +211,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 }
 ```
 
-`+upload-file` 通过 `multipart/form-data` 上传文件，表单文件字段名为 `file`。本地文件必须存在、不能是目录，后缀必须是 `.doc` 或 `.txt`；不支持的后缀会直接报错。返回的 `asset_id` 来自服务端 `pippit_asset_id`，如果没有该字段才回退到 `asset_id`。
+`+upload-file` 通过 `multipart/form-data` 上传文件，表单文件字段名为 `file`。本地文件必须存在、不能是目录，后缀必须是 `.doc`、`.docx` 或 `.txt`；不支持的后缀会直接报错。返回的 `asset_id` 来自服务端 `pippit_asset_id`，如果没有该字段才回退到 `asset_id`。
 
 **+list-thread-file** 返回：
 
@@ -253,7 +245,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的重要资产
@@ -291,9 +283,9 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 你要做的只有三件事：
 
-1. **上传**：如果用户给了本地 `.doc` / `.txt` 参考文件，先调用 `+upload-file`。
+1. **上传**：如果用户给了本地 `.doc` / `.docx` / `.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,9 +299,9 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 ## 注意事项
 
 - `--message` 是用户的原始短剧需求，不能为空。
-- 查询进展时优先使用 `+submit-run` 返回的 `thread_id` 和 `run_id`。
-- `--after-seq` 用于增量拉取消息，首次查询可设置为 `0`。
-- `+upload-file` 当前用于短剧场景文件上传链路，只支持本地 `.doc` / `.txt` 文件；`--path` 不能为空，路径必须指向真实文件，不能是目录。
+- 查询进展时优先使用 `+submit-run` 返回的 `thread_id` 和 `run_id`；如果需要查看整个会话，可以省略 `--run-id`。
+- `+get-thread` 当前固定走服务端 v2 响应，输出字段是 `readable_text`；不要解析旧版 `messages` 数组。
+- `+upload-file` 当前用于短剧场景文件上传链路，只支持本地 `.doc` / `.docx` / `.txt` 文件；`--path` 不能为空，路径必须指向真实文件，不能是目录。
 - `+upload-file` 上传成功后只返回 `asset_id`；把该值原样作为 `+submit-run --asset-ids` 的参数。
 - 单次创作会话中（相同 `thread_id`），`+submit-run` 只支持绑定一个剧本文件。不要在同一 `thread_id` 下重复上传并追加第二个剧本 `asset_id`；用户给多个剧本时，先让用户选择一个，或分别开启新的创作会话。
 - `+list-thread-file` 只需要 `thread_id`；分页参数使用 `--page-num 1 --page-size 200` 起步，`total` 达到 200 时下一轮递增 `page-num`。

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]
-}