@pippit-dev/cli 0.0.16 → 0.0.18

package/README.md

@@ -37,10 +37,15 @@ go run . short-drama +download-result --output-path ./thread_123/results/result.
 `/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.
 
+Short drama command errors are appended to a daily local log file under
+`~/.pippit_tool_cli/logs/yyyy-mm-dd.log`. The path is built with the current
+user home directory and the platform path separator, so it works on macOS,
+Linux, and Windows.
+
 ## HTTP Client
 
 Command modules should receive `common.Runner` for service calls. Runtime

package/checksums.txt

@@ -1,6 +1,6 @@
-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
+2cd3bb5e214d85004196806643c3b7d0a8ceb141ef3df58d1bbfc7aa9642f6ab  pippit-tool-cli-0.0.18-darwin-amd64.tar.gz
+8fb57bef9d7e81b8bcc3421f2179879b656134c23387104e01a1090022f6e7c9  pippit-tool-cli-0.0.18-darwin-arm64.tar.gz
+bdde278cbee36f2b90602b1b58f7be05790a186b3adbc90b8dd8fd970b48b20c  pippit-tool-cli-0.0.18-linux-amd64.tar.gz
+878c6b0cd41a2cafdd62f99be98968eee05f0d16de0c6b173f84bb0328c1bef6  pippit-tool-cli-0.0.18-linux-arm64.tar.gz
+e4423154ba1a52625f255e11060459844a4c5bcf3aab21af682f3e1adcce82cd  pippit-tool-cli-0.0.18-windows-amd64.zip
+cca47eab19bdc7200aabcea2d59a535c63267fe293f993b1013aa049a4be16b4  pippit-tool-cli-0.0.18-windows-arm64.zip

package/cmd/short_drama/short_drama.go

@@ -3,6 +3,8 @@ package short_drama
 import (
 	"fmt"
 	"io"
+	"path/filepath"
+	"strconv"
 	"strings"
 
 	"github.com/Pippit-dev/pippit-cli/internal/common"
@@ -35,7 +37,12 @@ func newShortDramaSubmitRunCommand(stdout, stderr io.Writer, runner *common.Runn
 		Use:   "+submit-run",
 		Short: "Submit a Run task for the short drama scene",
 		Args:  cobra.NoArgs,
-		RunE: func(cmd *cobra.Command, _ []string) error {
+		RunE: withErrorLog("short-drama +submit-run", func() map[string]string {
+			return map[string]string{
+				"thread_id":   opts.ThreadID,
+				"asset_count": strconv.Itoa(len(opts.AssetIDs)),
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
 			opts.Message = strings.TrimSpace(opts.Message)
 			opts.ThreadID = strings.TrimSpace(opts.ThreadID)
 
@@ -48,7 +55,7 @@ func newShortDramaSubmitRunCommand(stdout, stderr io.Writer, runner *common.Runn
 				return err
 			}
 			return writeJSON(stdout, result)
-		},
+		}),
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
@@ -65,7 +72,11 @@ func newShortDramaUploadFileCommand(stdout, stderr io.Writer, runner *common.Run
 		Use:   "+upload-file",
 		Short: "Upload a file for the short drama scene",
 		Args:  cobra.NoArgs,
-		RunE: func(cmd *cobra.Command, _ []string) error {
+		RunE: withErrorLog("short-drama +upload-file", func() map[string]string {
+			return map[string]string{
+				"file_name": fileNameForLog(opts.Path),
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
 			opts.Path = strings.TrimSpace(opts.Path)
 
 			if opts.Path == "" {
@@ -77,7 +88,7 @@ func newShortDramaUploadFileCommand(stdout, stderr io.Writer, runner *common.Run
 				return err
 			}
 			return writeJSON(stdout, result)
-		},
+		}),
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
@@ -92,7 +103,13 @@ func newShortDramaDownloadResultCommand(stdout, stderr io.Writer, runner *common
 		Use:   "+download-result",
 		Short: "Download a generated result URL",
 		Args:  cobra.NoArgs,
-		RunE: func(cmd *cobra.Command, _ []string) error {
+		RunE: withErrorLog("short-drama +download-result", func() map[string]string {
+			return map[string]string{
+				"output_path": opts.OutputPath,
+				"has_url":     strconv.FormatBool(strings.TrimSpace(opts.URL) != ""),
+				"workers":     strconv.Itoa(opts.Workers),
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
 			opts.OutputPath = strings.TrimSpace(opts.OutputPath)
 			if opts.OutputPath == "" {
 				return fmt.Errorf("--output-path is required")
@@ -110,7 +127,7 @@ func newShortDramaDownloadResultCommand(stdout, stderr io.Writer, runner *common
 				return err
 			}
 			return writeJSON(stdout, result)
-		},
+		}),
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
@@ -127,7 +144,12 @@ func newShortDramaGetThreadCommand(stdout, stderr io.Writer, runner *common.Runn
 		Use:   "+get-thread",
 		Short: "Get a short drama thread detail",
 		Args:  cobra.NoArgs,
-		RunE: func(cmd *cobra.Command, _ []string) error {
+		RunE: withErrorLog("short-drama +get-thread", func() map[string]string {
+			return map[string]string{
+				"thread_id": opts.ThreadID,
+				"run_id":    opts.RunID,
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
 			opts.ThreadID = strings.TrimSpace(opts.ThreadID)
 			if opts.ThreadID == "" {
 				return fmt.Errorf("--thread-id is required")
@@ -138,8 +160,9 @@ 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)
@@ -155,7 +178,13 @@ func newShortDramaListThreadFileCommand(stdout, stderr io.Writer, runner *common
 		Use:   "+list-thread-file",
 		Short: "List files in a short drama thread",
 		Args:  cobra.NoArgs,
-		RunE: func(cmd *cobra.Command, _ []string) error {
+		RunE: withErrorLog("short-drama +list-thread-file", func() map[string]string {
+			return map[string]string{
+				"thread_id": opts.ThreadID,
+				"page_num":  strconv.Itoa(opts.PageNum),
+				"page_size": strconv.Itoa(opts.PageSize),
+			}
+		}, func(cmd *cobra.Command, _ []string) error {
 			opts.ThreadID = strings.TrimSpace(opts.ThreadID)
 			if opts.ThreadID == "" {
 				return fmt.Errorf("--thread-id is required")
@@ -172,7 +201,7 @@ func newShortDramaListThreadFileCommand(stdout, stderr io.Writer, runner *common
 				return err
 			}
 			return writeJSON(stdout, result)
-		},
+		}),
 	}
 	cmd.SetOut(stdout)
 	cmd.SetErr(stderr)
@@ -182,6 +211,28 @@ func newShortDramaListThreadFileCommand(stdout, stderr io.Writer, runner *common
 	return cmd
 }
 
+func withErrorLog(command string, fields func() map[string]string, run func(*cobra.Command, []string) error) func(*cobra.Command, []string) error {
+	return func(cmd *cobra.Command, args []string) error {
+		err := run(cmd, args)
+		if err != nil {
+			logFields := map[string]string(nil)
+			if fields != nil {
+				logFields = fields()
+			}
+			_ = common.AppendDailyErrorLog(command, err, logFields)
+		}
+		return err
+	}
+}
+
+func fileNameForLog(path string) string {
+	path = strings.TrimSpace(path)
+	if path == "" {
+		return ""
+	}
+	return filepath.Base(path)
+}
+
 func writeJSON(w io.Writer, v any) error {
 	data, err := sonic.Marshal(v)
 	if err != nil {

package/cmd/short_drama_test.go

@@ -9,6 +9,7 @@ import (
 	"path/filepath"
 	"strings"
 	"testing"
+	"time"
 
 	"github.com/Pippit-dev/pippit-cli/internal/common"
 	"github.com/Pippit-dev/pippit-cli/internal/config"
@@ -17,6 +18,19 @@ import (
 	"github.com/spf13/cobra"
 )
 
+func TestMain(m *testing.M) {
+	home, err := os.MkdirTemp("", "pippit-cli-test-home")
+	if err != nil {
+		panic(err)
+	}
+	_ = os.Setenv("HOME", home)
+	_ = os.Setenv("USERPROFILE", home)
+
+	code := m.Run()
+	_ = os.RemoveAll(home)
+	os.Exit(code)
+}
+
 func TestShortDramaSubmitRun(t *testing.T) {
 	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		if r.Method != http.MethodPost {
@@ -196,11 +210,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 +225,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 +306,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)
 	}
 }
@@ -591,13 +605,14 @@ func TestShortDramaGetThread(t *testing.T) {
 		t.Fatalf("Execute() error = %v, stderr = %s", err, stderr.String())
 	}
 
-	got := decodeJSON(t, stdout.Bytes())
-	if got["readable_text"] != "Thread: thread_123\n       [assistant] hello" {
-		t.Fatalf("readable_text = %#v, want API readable text", got["readable_text"])
+	if got := stdout.String(); got != "Thread: thread_123\n       [assistant] hello\n" {
+		t.Fatalf("stdout = %#v, want API readable text", got)
 	}
 }
 
 func TestShortDramaGetThreadRequiresThreadID(t *testing.T) {
+	clearDailyErrorLog(t)
+
 	var stdout, stderr bytes.Buffer
 	root := NewRootCommand(&stdout, &stderr)
 	root.SetArgs([]string{"short-drama", "+get-thread"})
@@ -609,6 +624,17 @@ func TestShortDramaGetThreadRequiresThreadID(t *testing.T) {
 	if !strings.Contains(err.Error(), "--thread-id is required") {
 		t.Fatalf("error = %q, want thread-id validation", err)
 	}
+
+	entries := readDailyErrorLog(t)
+	if len(entries) != 1 {
+		t.Fatalf("log entries = %d, want 1: %#v", len(entries), entries)
+	}
+	if entries[0]["command"] != "short-drama +get-thread" {
+		t.Fatalf("command = %v, want get-thread", entries[0]["command"])
+	}
+	if entries[0]["error"] != "--thread-id is required" {
+		t.Fatalf("error = %v, want thread-id validation", entries[0]["error"])
+	}
 }
 
 func TestShortDramaGetThreadRequiresAccessKey(t *testing.T) {
@@ -788,6 +814,41 @@ func decodeJSON(t *testing.T, data []byte) map[string]any {
 	return got
 }
 
+func clearDailyErrorLog(t *testing.T) {
+	t.Helper()
+	if err := os.RemoveAll(filepath.Join(testHomeDir(t), ".pippit_tool_cli", "logs")); err != nil {
+		t.Fatalf("RemoveAll logs: %v", err)
+	}
+}
+
+func readDailyErrorLog(t *testing.T) []map[string]any {
+	t.Helper()
+	path := filepath.Join(testHomeDir(t), ".pippit_tool_cli", "logs", time.Now().Format("2006-01-02")+".log")
+	data, err := os.ReadFile(path)
+	if err != nil {
+		t.Fatalf("ReadFile(%s): %v", path, err)
+	}
+	lines := strings.Split(strings.TrimSpace(string(data)), "\n")
+	entries := make([]map[string]any, 0, len(lines))
+	for _, line := range lines {
+		var entry map[string]any
+		if err := sonic.Unmarshal([]byte(line), &entry); err != nil {
+			t.Fatalf("decode log line: %v\n%s", err, line)
+		}
+		entries = append(entries, entry)
+	}
+	return entries
+}
+
+func testHomeDir(t *testing.T) string {
+	t.Helper()
+	home, err := os.UserHomeDir()
+	if err != nil {
+		t.Fatalf("UserHomeDir(): %v", err)
+	}
+	return home
+}
+
 func chdirTemp(t *testing.T) string {
 	t.Helper()
 	cwd := t.TempDir()

package/internal/common/error_log.go

@@ -0,0 +1,91 @@
+package common
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"time"
+
+	"github.com/bytedance/sonic"
+)
+
+const (
+	errorLogDirName = ".pippit_tool_cli"
+	errorLogSubdir  = "logs"
+)
+
+type errorLogEntry struct {
+	Time    string            `json:"time"`
+	Command string            `json:"command"`
+	Fields  map[string]string `json:"fields,omitempty"`
+	Error   string            `json:"error"`
+}
+
+// AppendDailyErrorLog appends one CLI error record to ~/.pippit_tool_cli/logs/yyyy-mm-dd.log.
+func AppendDailyErrorLog(command string, err error, fields map[string]string) error {
+	if err == nil {
+		return nil
+	}
+	now := time.Now()
+	path, pathErr := dailyErrorLogPath(now)
+	if pathErr != nil {
+		return pathErr
+	}
+	if mkErr := os.MkdirAll(filepath.Dir(path), 0o700); mkErr != nil {
+		return mkErr
+	}
+
+	entry := errorLogEntry{
+		Time:    now.Format(time.RFC3339),
+		Command: strings.TrimSpace(command),
+		Fields:  cleanErrorLogFields(fields),
+		Error:   err.Error(),
+	}
+	data, marshalErr := sonic.Marshal(entry)
+	if marshalErr != nil {
+		return marshalErr
+	}
+	data = append(data, '\n')
+	file, openErr := os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0o600)
+	if openErr != nil {
+		return openErr
+	}
+	defer file.Close()
+	_, writeErr := file.Write(data)
+	return writeErr
+}
+
+func dailyErrorLogPath(now time.Time) (string, error) {
+	home, err := os.UserHomeDir()
+	if err != nil {
+		return "", err
+	}
+	return filepath.Join(home, errorLogDirName, errorLogSubdir, now.Format("2006-01-02")+".log"), nil
+}
+
+func cleanErrorLogFields(fields map[string]string) map[string]string {
+	if len(fields) == 0 {
+		return nil
+	}
+	cleaned := make(map[string]string, len(fields))
+	for k, v := range fields {
+		key := strings.TrimSpace(k)
+		value := strings.TrimSpace(v)
+		if key == "" || value == "" || isSensitiveLogField(key) {
+			continue
+		}
+		cleaned[key] = value
+	}
+	if len(cleaned) == 0 {
+		return nil
+	}
+	return cleaned
+}
+
+func isSensitiveLogField(key string) bool {
+	key = strings.ToLower(key)
+	return strings.Contains(key, "access") ||
+		strings.Contains(key, "authorization") ||
+		strings.Contains(key, "secret") ||
+		strings.Contains(key, "token")
+}

package/internal/common/error_log_test.go

@@ -0,0 +1,61 @@
+package common
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/bytedance/sonic"
+)
+
+func TestAppendDailyErrorLog(t *testing.T) {
+	home := t.TempDir()
+	t.Setenv("HOME", home)
+	t.Setenv("USERPROFILE", home)
+
+	err := AppendDailyErrorLog("short-drama +get-thread", fmt.Errorf("request failed"), map[string]string{
+		"thread_id":  "thread_123",
+		"access_key": "secret",
+		"empty":      "",
+	})
+	if err != nil {
+		t.Fatalf("AppendDailyErrorLog(): %v", err)
+	}
+	if err := AppendDailyErrorLog("short-drama +get-thread", fmt.Errorf("second failure"), nil); err != nil {
+		t.Fatalf("AppendDailyErrorLog() second call: %v", err)
+	}
+
+	path := filepath.Join(home, ".pippit_tool_cli", "logs", time.Now().Format("2006-01-02")+".log")
+	data, err := os.ReadFile(path)
+	if err != nil {
+		t.Fatalf("ReadFile(%s): %v", path, err)
+	}
+	lines := strings.Split(strings.TrimSpace(string(data)), "\n")
+	if len(lines) != 2 {
+		t.Fatalf("log lines = %d, want 2\n%s", len(lines), string(data))
+	}
+
+	var first map[string]any
+	if err := sonic.Unmarshal([]byte(lines[0]), &first); err != nil {
+		t.Fatalf("decode first log line: %v\n%s", err, lines[0])
+	}
+	if first["command"] != "short-drama +get-thread" {
+		t.Fatalf("command = %v, want get-thread command", first["command"])
+	}
+	if first["error"] != "request failed" {
+		t.Fatalf("error = %v, want request failed", first["error"])
+	}
+	fields, ok := first["fields"].(map[string]any)
+	if !ok {
+		t.Fatalf("fields = %#v, want object", first["fields"])
+	}
+	if fields["thread_id"] != "thread_123" {
+		t.Fatalf("thread_id = %v, want thread_123", fields["thread_id"])
+	}
+	if _, ok := fields["access_key"]; ok {
+		t.Fatalf("access_key should be omitted from log fields: %#v", fields)
+	}
+}

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

@@ -16,7 +16,7 @@ type GetThreadOptions struct {
 	RunID    string `json:"run_id,omitempty"`
 }
 
-// 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 {
 	ReadableText string `json:"readable_text"`
 }

package/package.json

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

package/skills/short-drama/SKILL.md

@@ -25,7 +25,7 @@ metadata:
 
 1. **提交短剧 Run 任务** - 创建新会话或向已有会话发送短剧创作需求。
 2. **查询会话进展** - 根据 `thread_id` 和可选 `run_id` 拉取服务端 v2 `readable_text`，用于展示短剧任务进展、问题和结果。
-3. **上传文件** - 上传本地 `.doc` / `.txt` 参考文件，得到 `asset_id`，供后续任务引用。
+3. **上传文件** - 上传本地 `.doc` / `.docx` / `.txt` 参考文件，得到 `asset_id`，供后续任务引用。
 4. **获取会话文件** - 根据 `thread_id` 拉取会话文件列表，得到 `file_path`、`download_url`。这和查询会话进展同等重要。
 5. **下载重要资产** - 使用文件列表中的 `download_url` 下载资源，并按 `file_path` 写入用户本地目标文件路径。
 
@@ -65,7 +65,7 @@ pippit-tool-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID
 
 ### 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
@@ -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
@@ -194,10 +194,13 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 
 **+get-thread** 返回：
 
-```json
-{
-  "readable_text": "Thread: thread_...\n     标题: ...\n     状态: ...\n\n     -- Run #1 --\n       [assistant] ..."
-}
+```text
+Thread: thread_...
+     标题: ...
+     状态: ...
+
+     -- Run #1 --
+       [assistant] ...
 ```
 
 **+upload-file** 返回：
@@ -208,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** 返回：
 
@@ -280,7 +283,7 @@ 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` 返回的 `readable_text` 展示进展、问题和结果；根据 `+list-thread-file` 获取文件列表；再根据 `download_url` 调用 `+download-result` 把缺失资源下载到用户本地。
 
@@ -298,7 +301,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
 - `--message` 是用户的原始短剧需求，不能为空。
 - 查询进展时优先使用 `+submit-run` 返回的 `thread_id` 和 `run_id`；如果需要查看整个会话，可以省略 `--run-id`。
 - `+get-thread` 当前固定走服务端 v2 响应，输出字段是 `readable_text`；不要解析旧版 `messages` 数组。
-- `+upload-file` 当前用于短剧场景文件上传链路，只支持本地 `.doc` / `.txt` 文件；`--path` 不能为空，路径必须指向真实文件，不能是目录。
+- `+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`。