@lingjingai/scriptctl 0.66.22 → 0.67.0

package/README.md

@@ -102,6 +102,27 @@ Gemini 接收左侧带时间戳、行锚点的亚洲格式剧本正文，以及
 
 `.review/comic/episode-N.json` 保存逐话 findings、用量和原页加载记录，`global.json` 保存最后的全剧收敛结果。`viewed_pages` 仅表示整页图片已加载，不代表内容正确或小字已看清；未加载完全部页时报告未解决项。图片证据保存在剧本旁的 `review-pages/`。漫画不执行 ASR、校时或视频媒体预算；`--max-steps` 和 `--episode-timeout-ms` 限制审核运行。逐话结果在剧本与报告落盘后才发出，未提供 `-s` 仍是纯剧本审核。
 
+## 审核失败单元的类型
+
+`review` 的进程退出码 0 只表示正常跑完；每个 `episode` / `global` 事件的 `state` 才是该单元结果。`state = "failed"` 时带 `failure_kind` 和 `retry`：
+
+| `failure_kind` | `retry` | 含义 |
+|---|---|---|
+| `dialogue_cross_language` | `ours` | 剧本台词与原声语言不同（拉片把译文字幕当成了台词） |
+| `dialogue_mismatch` | `caller` | 台词与原声差异超过 50%，多为视频与集对应错误 |
+| `asr_config` | `caller` | 缺少 `SD_AUDIO_APIKEY` |
+| `video_missing` | `caller` | 该集没有传视频 |
+| `credentials` | `caller` | 模型渠道拒绝凭据（401/403） |
+| `asr_failed` | `retry` | ASR 或比对模型暂时不可用 |
+| `timeout` | `retry` | 单元超时 |
+| `model_unavailable` | `retry` | 所有模型渠道都失败 |
+| `timeline_unresolved` | `retry_once` | 审核后时间轴仍有冲突 |
+| `converge_incomplete` | `retry_once` | 全剧收敛单元未正常收口 |
+| `source_unread` | `retry_once` | 文本或漫画审核未读完本集原稿 |
+| `unknown` | `ours` | 其他 |
+
+重试时用同一条命令加 `--resume-log <之前的日志>`，已完成的单元会跳过。
+
 ## 退出码
 
 | 码 | 含义 |

package/changes/0.66.23.md

@@ -0,0 +1,13 @@
+# 0.66.23
+
+## Added
+- `scriptctl review` 的 `episode` / `global` 失败单元带结构化字段 `failure_kind`（失败类型）和 `retry`（`caller` 接入方处理、`retry` 可自动重试、`retry_once` 重试一次、`ours` 交给 scriptctl 维护方）；完成的单元不带这两个字段。
+
+## Changed
+- None.
+
+## Fixed
+- None.
+
+## Breaking
+- None.

package/changes/0.67.0.md

@@ -0,0 +1,13 @@
+# 0.67.0
+
+## Added
+- None.
+
+## Changed
+- 版本号升级，代码与 0.66.23 相同。标记视频审核这一轮改造：渠道路由与台词门禁调整、并行工具调用、全剧收敛改为规则与单次调用、资产问题升级、失败单元的 `failure_kind` / `retry` 字段，详见 0.66.22、0.66.23。
+
+## Fixed
+- None.
+
+## Breaking
+- None.