@lingjingai/scriptctl 0.64.0 → 0.64.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/scriptctl",
-  "version": "0.64.0",
+  "version": "0.64.3",
   "description": "剧本阶段统一 CLI：素材转 Script v4，并兼容 Script v3 的本地写作、精修、校验和发布。",
   "type": "module",
   "bin": {

package/skills/scriptctl/SKILL.md

@@ -2,8 +2,8 @@
 name: scriptctl
 description: "剧本 script.json 的本地阅读、定位、原子修改、整场整集回写、素材 ingest 与 revision publish CLI。处理 Script v3/v4、剧本资产与 state、Action、场景引用或视频证据核对时使用。"
 metadata:
-  version: "0.31.6"
-  scriptctl_version: "0.63.9"
+  version: "0.32.0"
+  scriptctl_version: "0.64.3"
   author: "official"
 ---
 
@@ -228,6 +228,7 @@ scriptctl checkout / status / publish         # 远端工作副本
 
 有原视频的 `review` 按集执行「豆包 Flash ASR → Gemini 对比 → 校时落盘 → Mastra 审核 → 落盘」，`--concurrency` 控制整集流程并发，默认 5。需要 `SD_AUDIO_APIKEY`、ffmpeg 和按集对应的视频。Gemini 阅读带时间戳、行锚点的亚洲格式正文及 ASR 句/词时间，选择整条台词开头对应的 ASR 起点；程序校时并落盘，保留原台词和其他字段。缺漏按集记录原话、时间与理由，随后交给本集 Agent 逐项 `watch` 核对原片再修复，并按窗口数增加看片预算；不确定项保留原样并记录待核对线索。单集服务或响应失败会记录为失败集，其他集继续执行。
 
+
 逐集审核同时明确动作叙述的人物指代：依据资产、上下文与原片证据，将可确认的称呼、别名和代词写成资产正式名；普通词义、台词和画面文字原文保留，歧义记 unresolved。全剧收敛核对人物合并、更名后的叙述名称一致性。具体边界见 [references/video-transcript-repair.md](references/video-transcript-repair.md)。
 
 `.review/asr/episode-N/` 保存成功 ASR 缓存及每次对比的正文、原始响应、前后时间与缺漏报告。源视频经 ffprobe 确认无音轨时，发出 `asr-skipped`（`reason=source_no_audio`），保留台词与时间并继续画面审核；分集结果保留“ASR 校时未执行”的未解决项，说明无法核验实际发声时间、漏词或无字幕画外音。探测、解码及服务错误仍作为失败集处理。`asr-compared` 仅表示对比完成，带 `episode_number` 的 `asr-applied` 表示本集校时已落盘，不等于 Agent 审核完成。`--episodes` 只重跑指定集的 ASR 和审核，`--converge-only` 只做全剧收敛。纯剧本和原文对照审核不执行 ASR；`--check` 不发模型请求。
@@ -243,7 +244,7 @@ agent 是否就绪。**Agent 不要自己调 `review` 去审自己正在改的
 agent 并直接改文件。
 抽帧工具的时间参数始终是 JSON 数组，单帧也一样；参数调用错误回传给审核 agent 修正，不作为图片结果处理，也不据此把整集标记完成。
 
-漫画 review 的 `-s` 支持漫画 ingest 工作区，或原 PDF 文件/目录（剧本旁需有 ingest `manifest.json`）。通过 `document_id` 和 PDF SHA-256 核实来源，保留 Script v4 的页码/区域扩展字段。默认 `review-comic` profile 走 NNYYAI，需要 `NNYYAI_API_KEY`；自定义 LLM 配置需定义该 profile 或用 `--model` 显式指定。`--episodes` 只要求所选话的 PDF，`--converge-only` 仅处理全局身份与资产一致性。
+漫画 review 的 `-s` 支持漫画 ingest 工作区，或原 PDF 文件/目录（剧本旁需有 ingest `manifest.json`）。通过 `document_id` 和 PDF SHA-256 核实来源，保留 Script v4 的页码/区域扩展字段。默认 `review-comic` profile 走 NNYYAI，需要 `NNYYAI_API_KEY`；自定义 LLM 配置需定义该 profile 或用 `--model` 显式指定。`--episodes` 指定逐话审核范围；全剧收敛保留全部原稿，`--no-converge` 时只要求所选话的 PDF。`--converge-only` 仅处理全局身份与资产一致性。
 
 漫画 Agent 使用原页及局部图片逐页检查遗漏，再对照 action 核对正文、说话人、心声类别、顺序和来源。需要 `pdftoppm`；图片在 `review-pages/`，结果在 `.review/comic/episode-N.json` 和 `global.json`。新增 action 同时写来源，跨页引用保留全部页与区域。`viewed_pages` 只记录图片已加载；未看完整页集会留下 unresolved，不能据此宣称整话通过。漫画不生成时间戳，不执行 ASR；运行由 `--max-steps` 和 `--episode-timeout-ms` 限制。视频保留原有 ASR、校时和媒体预算流程。
 
@@ -253,6 +254,8 @@ agent 并直接改文件。
 
 文本 Agent 先用 `text_range` 顺序读本集原文检查遗漏，再以 `source` / `search_source` 反查 action。来源是完整规范化原文的 1-based 闭区间，保存于 `extend.scriptctl.source.ranges`（`start_line` / `end_line`）。ingest 提供 chunk 级候选窗口，需读原文确认；台词保持原语言，动作允许忠实的简体中文转述。插入遗漏内容必须同时绑定原文。`.review/text/episode-N.json` 和 `global.json` 保存结论与已读/未读行窗口，加载不代表正确，未读完整保留 unresolved。
 
+审核逐场检查制作字段，日夜和内外景缺失时主动查证原稿及连续场景；有依据才补，无法确认则逐项记录待确认原因。全剧收敛补齐人物、场景、道具及状态描述，完整审核后由客户端调用 `synopsis generate --apply` 补全梗概，再保存内容绑定的 AI 审核记录。未读完原文或漫画页的分集记为未完成并保留已有修复。
+
 ## 版本边界
 
 读取 `script.json.version`：`4` 是新建与 ingest 的默认方言，`3` 是线上既有项目的
@@ -279,3 +282,7 @@ agent 并直接改文件。
 [references/video-transcript-repair.md](references/video-transcript-repair.md)；
 state 引用修复见
 [references/state-reference-repair.md](references/state-reference-repair.md)。
+
+逐集 `review` 根据审核后正文补齐分集梗概；全剧收敛补齐全剧梗概、人物/场景/道具及每个状态的描述。所有说明依据已确认的正文与原片证据，已有完整准确的资料保留。
+
+制作字段检查：`validate` 与 `scan` 列出日夜晨昏、内外景和场景地点的缺项及路径。审核任务自动带入缺项清单；依据当前模式的原稿证据，用 `edit --time / --space` 和 `ref` 补齐，完成后复扫。证据不足时保留未知并记录场地址与原因。客户端全剧审核保留未补齐项和已完成进度，补齐后自动保存已审核状态。