小云雀短剧创作

通过 pippit-tool-cli short-drama 命令提交短剧创作任务、上传参考文件，并行查询任务进展和会话产物文件，及时把重要资产下载到用户本地。

短剧场景面向剧情、人物、分集与画面化叙事创作，用户的原始需求通过 --message 发送给后端 Agent。后端 Agent 负责理解任务、编排流程和生成内容；用户侧 Agent 负责提交任务、并行查询进展与产物、主动下载重要资产并展示结果。

功能

1. 提交短剧 Run 任务 - 创建新会话或向已有会话发送短剧创作需求。
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 写入用户本地目标文件路径。

重要资产包括但不限于：剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物。只要 list-thread-file 返回了这些资产的 download_url，就要及时调用下载工具落盘，不要只展示文件元信息。

短剧主流程顺序

短剧创作按以下主流程推进。用户侧 Agent 在展示后端 Agent 的表单、问卷、选项或确认问题时，必须先参考这个顺序判断当前阶段和合理下一步。