@pippit-dev/cli 1.0.51 → 1.0.53

package/skills/xyq-nest-skill/commands/query-result.md

@@ -20,6 +20,7 @@ stdout 是 JSON；命令可能将错误编码进 JSON 并以退出码 0 返回
 
 | 字段 | 含义 |
 | --- | --- |
+| `status` | 目标 Run 状态：`running`、`succeeded`、`failed`、`canceled`、`input_required`、`interrupted`、`unknown`；不直接由查询接口 `ret` 决定 |
 | `completed` | 是否结束；失败时也可能为 `true`，不等于成功 |
 | `error_message` | 非空即错误，不能因为 `completed=false` 而忽略 |
 | `thread_id` / `run_id` | 对应的查询任务 |
@@ -31,6 +32,7 @@ stdout 是 JSON；命令可能将错误编码进 JSON 并以退出码 0 返回
 
 ```json
 {
+  "status": "succeeded",
   "completed": true,
   "thread_id": "THREAD_ID",
   "run_id": "RUN_ID",
@@ -40,7 +42,15 @@ stdout 是 JSON；命令可能将错误编码进 JSON 并以退出码 0 返回
 }
 ```
 
-任务尚未完成时通常返回 `completed=false`、空错误、空媒体数组。命令不提供完整会话消息、用户反问或可区分的所有状态；不能仅凭这个响应断言具体进度、取消状态或等待用户输入。轮询停止条件见 [共用流程](../workflows/async-delivery.md)。
+`status` 和 `completed` 优先按返回的目标 Run 判定，适用于任意 `ret`。失败原因优先读取 Run 的 `fail_reason.message/code`，再读取兼容错误字段和接口错误；非零接口返回仍保留本地诊断日志。
+
+没有目标 Run 时，只有已核实的接口返回可确定终态：`ret=5` 且 `errmsg` 为 `创作失败` 或以 `创作失败：` 开头时返回 `failed`、`completed=true`；`ret=5` 且 `errmsg` 为 `创作已取消` 时返回 `canceled`、`completed=true`。不要泛匹配“失败”或“不合规”。其余查询错误保持 `unknown`、`completed=false`，通过 `error_message` 报告原因及可用的 LogID。`ret=2` 是参数错误，不代表安审失败；`ret=5` 也可能只是查询会话失败。未指定或未知 Run 状态保持 `unknown`。
+
+`input_required` 表示等待补充输入，`completed=false`；`interrupted` 表示人工交互中断结束，`completed=true`。两者均停止自动轮询并报告交互需求或中断状态。`canceled` 也直接停止，不因空产物误报下载失败。程序中断／等待工具回调仍为 `running`。
+
+Run 已成功但产物缺失或下载失败时，保留 `succeeded`、`completed=true`，错误写入 `error_message`。此前已成功下载的文件仍保留在媒体数组中。核对这些文件后可交付已完成部分，但不能宣称全部下载或交付成功。
+
+只有 `running` 且无错误时继续轮询；未知状态不能自动当作运行中。命令不提供完整会话消息或用户反问，不编造具体进度。轮询停止条件见 [共用流程](../workflows/async-delivery.md)。
 
 ## 样片结果
 
@@ -54,4 +64,4 @@ stdout 是 JSON；命令可能将错误编码进 JSON 并以退出码 0 返回
 
 文件名由 CLI 根据产物信息生成，以 `output_path` 为准，不自行拼接编号或推测扩展名。同目录已有同名文件可能被复用；复用不证明内容相同，也不代表本次新下载。发现同名文件属于其他产物时，选择用户认可范围内的未冲突目录再查询，不删除已有文件。
 
-找不到产物、链接缺失或下载失败时会返回错误。当前任一文件下载失败可能使整次查询只返回错误，无法据此认定其他文件都没下载或已完整交付。复查本次结果，不把输出目录里的任意旧文件当作本次产物。
+找不到产物、链接缺失或下载失败时会返回错误。下载中途失败时，媒体数组保留此前已成功下载或复用的文件；逐项核对 `output_path` 后可交付可用部分，并说明未完成项。不把输出目录里的任意旧文件当作本次产物，也不宣称已完整交付。

package/skills/xyq-nest-skill/commands/watermark.md

@@ -0,0 +1,15 @@
+# 账号 AIGC 水印设置
+
+先用 `pippit-tool-cli watermark --help` 检查命令。缺失时按[安装说明](../scripts/install.md)通过宿主升级，独立 CLI 可执行 `update`；改用升级后的绝对路径重查。
+
+```bash
+pippit-tool-cli watermark       # 查询
+pippit-tool-cli watermark off   # 关闭
+pippit-tool-cli watermark on    # 保留
+```
+
+返回 `{"enabled":true}` 或 `{"enabled":false}`，`true` 表示保留。设置后返回服务端回读状态。
+
+设置与 Web 同步，按当前账号持续生效，与团队选择无关。用户明确要求修改账号设置时才执行 `on/off`；只要求本次视频无水印时，先确认是否接受修改账号默认值。
+
+此开关控制 AIGC 水印，品牌水印与最终下载权益由服务端决定。修改报错或结果未知时先查询确认。

package/skills/xyq-nest-skill/workflows/async-delivery.md

@@ -7,15 +7,15 @@
 1. 提交成功后保存 `thread_id`、`run_id` 和 `web_thread_link`，立即向用户展示任务链接。已有任务直接使用其标识进入查询，不再次生成。
 2. 使用同一 `cli_path` 和同一对任务 ID 调用查询命令，明确 `--download-dir`。每隔 10 秒查询一次，不在轮询中重新安装 CLI。
 3. 先检查命令是否可执行、输出是否为有效 JSON，再读取非空 `error_message`；有错误就进入下面的失败处理。
-4. 无错误且 `completed=false` 时继续轮询，只说明尚未取得最终结果，不编造创作消息或完成百分比。
-5. 无错误且 `completed=true` 时，要求媒体数组中有待交付产物，逐项核对 `output_path` 后进入交付。空结果或缺少必要字段时报告异常，不空轮询。
+4. `status=input_required` 时停止自动轮询，提示需要补充输入；`status=interrupted` 或 `canceled` 时停止并报告对应终态。只有无错误且 `status=running` 时继续轮询，不编造创作消息或完成百分比。`unknown` 不等于运行中，报告无法确定任务状态。
+5. 无错误且 `status=succeeded`、`completed=true` 时，要求媒体数组中有待交付产物，逐项核对 `output_path` 后进入交付。空结果或缺少必要字段时报告异常，不空轮询。
 
 ## 停止与恢复
 
 - 明确的任务失败、鉴权失败、参数错误或产物缺失：停止并报告错误及可用的任务 ID、链接、LogID，不重新提交生成。
 - 可识别的暂时网络错误或下载错误：间隔 10 秒后仅重试同一次查询一次；仍失败则报告阻塞。无法判别错误类别时停止，避免盲目重试。
 - 用户要求停止时停止本地轮询；这不等于已取消服务端任务。持续未完成时遵守用户或宿主的等待时限，最迟在连续 48 小时后停止等待，保留 ID 供后续恢复查询。宿主无法持续执行时如实说明，不承诺后台监控。
-- 当前查询输出无法区分所有非成功状态；若长时间未完成或任务页面显示需要交互，报告当前查询能力的限制，不代答或新建任务。
+- 等待输入或人工交互中断时，查询输出不含完整反问内容；引导查看任务页面，不代答或新建任务。
 - 恢复时继续查询原任务，复用该任务已确定的输出目录，对已交付产物去重。
 
 ## 媒体交付完成标准