@pippit-dev/cli 0.0.18 → 0.0.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/checksums.txt +6 -6
- package/package.json +1 -1
- package/skills/short-drama/SKILL.md +33 -4
package/checksums.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
1
|
+
35669c5443abd32d8318c30a48a4c8f2985c97b9719bdae2cb141cb0d08c8e73 pippit-tool-cli-0.0.19-darwin-amd64.tar.gz
|
|
2
|
+
168316fdf953f4a22b76281512368d04ab299577b2ee53cf4ce65f254474dd8e pippit-tool-cli-0.0.19-darwin-arm64.tar.gz
|
|
3
|
+
016af69efae30199ecc117a4e227e47c9c96c2a8ef24b86ac9e7d61108ef73cb pippit-tool-cli-0.0.19-linux-amd64.tar.gz
|
|
4
|
+
38e096dc71c3509c47943dd1f37076fbc525d2d8874f299fa000885ab34c574a pippit-tool-cli-0.0.19-linux-arm64.tar.gz
|
|
5
|
+
cc3ded92e540d36af090679a95b8fc5ddc81a9d47c6ff56456ed0c89b5518674 pippit-tool-cli-0.0.19-windows-amd64.zip
|
|
6
|
+
7db4bb48c1fcbd16ca1940dcaa06d7998ddf814a95e377bdbfa80c4075b07ed4 pippit-tool-cli-0.0.19-windows-arm64.zip
|
package/package.json
CHANGED
|
@@ -31,6 +31,34 @@ metadata:
|
|
|
31
31
|
|
|
32
32
|
重要资产包括但不限于：剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物。只要 `+list-thread-file` 返回了这些资产的 `download_url`，就要及时调用下载工具落盘，不要只展示文件元信息。
|
|
33
33
|
|
|
34
|
+
## 短剧主流程顺序
|
|
35
|
+
|
|
36
|
+
短剧创作按以下主流程推进。用户侧 Agent 在展示后端 Agent 的表单、问卷、选项或确认问题时，必须先参考这个顺序判断当前阶段和合理下一步。
|
|
37
|
+
|
|
38
|
+
1. 剧本上传 / AI 剧本生成 / AI 剧本编辑
|
|
39
|
+
2. 剧本合并与完整剧本确认
|
|
40
|
+
3. 剧本分析
|
|
41
|
+
4. 短剧风格推荐确认
|
|
42
|
+
5. 剧本标准化（可选）
|
|
43
|
+
6. 场景分析
|
|
44
|
+
7. 所有必要场景图生成
|
|
45
|
+
8. 角色分析
|
|
46
|
+
9. 所有必要角色图生成
|
|
47
|
+
10. 分镜设计
|
|
48
|
+
11. 分镜视频生成
|
|
49
|
+
12. 完整视频合成
|
|
50
|
+
|
|
51
|
+
## 表单与问卷选项处理原则
|
|
52
|
+
|
|
53
|
+
后端 Agent 通过 `readable_text` 发出表单、问卷、选项、按钮或询问用户时，用户侧 Agent 不要机械原样转述所有选项。先结合短剧主流程顺序清洗选项，再把合理、必要、当前可执行的流程项呈现给用户。
|
|
54
|
+
|
|
55
|
+
- 保留当前阶段的确认项，以及不会跳过必要阶段的下一步流程项。
|
|
56
|
+
- 剔除跳过必要阶段的选项。例如未完成“剧本合并与完整剧本确认”前，不应让用户直接进入“剧本分析”；未完成“所有必要场景图生成”前，不应让用户直接进入“角色分析”。
|
|
57
|
+
- 剔除倒退到无关阶段的选项。只有用户明确要求返工、修改或重新生成时，才展示回退选项。
|
|
58
|
+
- `剧本标准化` 是可选阶段，只能出现在“短剧风格推荐确认”之后、“场景分析”之前。不要把它包装成任意阶段都可以跳过或补做的通用选项。
|
|
59
|
+
- 不替用户决定创意内容，例如风格、剧情方向、角色设定、镜头方案。只能清洗流程选项，不能代替用户选择创作偏好。
|
|
60
|
+
- 如果服务端问题混入跨度过大的多个流程选项，重新组织成当前阶段可回答的问题，并说明已按主流程剔除不合理或跳跃选项。
|
|
61
|
+
|
|
34
62
|
## 前置要求
|
|
35
63
|
|
|
36
64
|
需要已安装 `pippit-tool-cli`：
|
|
@@ -167,7 +195,7 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
|
|
|
167
195
|
- **重要资产识别**：每轮都检查 `+list-thread-file` 返回的文件。剧本设计、场景设计、场景图、人物角色设计、人物图、分集草稿、故事板、最终视频产物都是重要资产。
|
|
168
196
|
- **文件下载**：解析 `+list-thread-file` 的结果后，对带 `download_url` 的重要资产立即调用 `+download-result` 下载资源；不要在 `list-thread-file` 阶段检查文件是否已存在，存在性检查由下载工具内部处理。
|
|
169
197
|
- **下载完成标准**：不要把文件元信息展示当成下载完成；必须拿到本地 `file_path`，或明确记录该文件在重试后仍下载失败。
|
|
170
|
-
-
|
|
198
|
+
- **用户确认**：如果消息中出现需要用户确认、补充设定或回答问题的内容，先判断是否包含表单、问卷、选项或按钮；包含时按“短剧主流程顺序”和“表单与问卷选项处理原则”清洗选项，再展示给用户并等待回复。
|
|
171
199
|
- **超时**：如果长时间无结果，告知用户任务仍在生成中，可稍后通过 `web_thread_link` 查看。
|
|
172
200
|
- **错误处理**：`+get-thread`、`+list-thread-file` 或 `+download-result` 任一调用失败时，记录失败原因和参数，在后续轮询中主动重试；重试期间继续处理其他成功返回的消息和文件。连续多轮失败后再向用户说明仍未完成的查询或下载项。
|
|
173
201
|
|
|
@@ -178,7 +206,8 @@ pippit-tool-cli short-drama +download-result --url DOWNLOAD_URL --output-path FI
|
|
|
178
206
|
1. 已处理 `+get-thread` 返回的最新 `readable_text`、用户确认问题和最终消息。
|
|
179
207
|
2. 已用 `--page-size 200` 调用 `+list-thread-file` 获取会话文件列表；如果本轮 `total` 达到 200，已在后续轮询中递增 `page-num` 查询新一页。
|
|
180
208
|
3. 对所有带 `download_url` 的重要资产，已调用 `+download-result` 下载到本地 `file_path`。
|
|
181
|
-
4.
|
|
209
|
+
4. 已按短剧主流程顺序检查服务端表单、问卷和选项，没有把跳过必要阶段的选项直接呈现给用户；如果跳过 `剧本标准化`，已明确这是可选阶段。
|
|
210
|
+
5. 对查询失败或下载失败的资产，已在后续轮询中主动重试，并在最终回复中列出仍失败的文件或命令。
|
|
182
211
|
|
|
183
212
|
## 输出格式
|
|
184
213
|
|
|
@@ -271,7 +300,7 @@ Thread: thread_...
|
|
|
271
300
|
|
|
272
301
|
- 任务提交后：立即展示 `web_thread_link`。
|
|
273
302
|
- 任务进行中：展示后端 Agent 返回的过程消息。
|
|
274
|
-
-
|
|
303
|
+
- 需要用户补充信息时：如果是普通问题，展示后端 Agent 的问题并等待用户回复；如果包含表单、问卷、选项或按钮，先按短剧主流程清洗不合理或跳跃的流程选项，再展示给用户。
|
|
275
304
|
- 任务完成后：展示短剧内容、分集草稿、设定说明或其他结果信息，同时检查是否有未下载的重要资产。
|
|
276
305
|
- 获取会话文件后：展示或记录文件元信息，不把它当成已下载结果。
|
|
277
306
|
- 文件资源下载后：展示已落盘的本地文件路径；已存在而跳过下载的文件也要标明。
|
|
@@ -285,7 +314,7 @@ Thread: thread_...
|
|
|
285
314
|
|
|
286
315
|
1. **上传**：如果用户给了本地 `.doc` / `.docx` / `.txt` 参考文件，先调用 `+upload-file`。
|
|
287
316
|
2. **提交任务**：首次创作时把用户原始短剧需求和唯一剧本 `asset_id` 通过 `+submit-run --asset-ids` 发给后端；同一 `thread_id` 后续续写或修改不再追加新的剧本文件。
|
|
288
|
-
3. **传话、取文件、下载资源**：根据 `+get-thread` 返回的 `readable_text`
|
|
317
|
+
3. **传话、取文件、下载资源**：根据 `+get-thread` 返回的 `readable_text` 展示进展、问题和结果；遇到表单、问卷、选项或按钮时，只做流程合理性清洗，不替用户决定创作内容；根据 `+list-thread-file` 获取文件列表；再根据 `download_url` 调用 `+download-result` 把缺失资源下载到用户本地。
|
|
289
318
|
|
|
290
319
|
**不要做的事：**
|
|
291
320
|
|