@lingjingai/scriptctl 0.73.8 → 0.74.0

package/package.json

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

package/skills/scriptctl/SKILL.md

@@ -230,24 +230,22 @@ GrsAI 使用 `GRSAI_API_KEY` 和 base64 视频，每个型号最多尝试 3 次
 豆包后备路由先使用火山 Seed 2.1 Lite（`https://ark.cn-beijing.volces.com/api/v3`），读取 `ARK_API_KEY`；`DOUBAO_LITE_MODEL` 可指定端点，默认 `ep-20261029164743-gt8dh`。Lite 失败后使用 BytePlus Seed 2.1 Turbo，读取 `DOUBAO_TURBO_API_KEY`；`DOUBAO_TURBO_MODEL` 可指定端点，默认 `ep-20261028172514-tlxzc`。缺少对应密钥时跳过该路。
 已完成集和跨集 context 保留，同 source、同 workspace 重跑会从失败集续接。
 
-有原视频的 `review --review-strategy batch` 启用可选联合审核：豆包 Flash ASR → Gemini 对比 → Mastra 联合核对校时与内容 → 落盘。`--concurrency` 控制整集流程并发，默认 5；需要 `SD_AUDIO_APIKEY`、ffmpeg 和按集对应的视频。Agent 一次收到本集完整正文、相关人物状态卡、相邻集梗概与尚未写入的 ASR 建议，用 `read_many` 集中补读，`apply_changes` 一起修正关联字段并返回最终回读和校验，`record_findings` 记录实质结论。已核实的词级时间保留原精度；出现原音与整集 ASR 的具体冲突时，`asr_window` 对至多 15 秒的声音重识别并返回本集绝对句/词时间，共用媒体核验预算。画面约数用于判断内容和先后，证据矛盾保留原文并记录 unresolved。单集失败保留已执行修改，其他集继续。默认 `legacy` 使用先写入 ASR 时间、再逐项审核的流程。批量方式的成本随上下文、缓存与取证次数变化；证据冲突和重要分段边界需人工复核后验收。
+有原视频的 `review --review-strategy batch` 启用可选联合审核：Mastra 一次核对内容与时间 → 落盘。`--concurrency` 控制整集流程并发，默认 5；需要 ffmpeg 和按集对应的视频。Agent 一次收到本集完整正文、相关人物状态卡与相邻集梗概，用 `read_many` 集中补读，`apply_changes` 一起修正关联字段并返回最终回读和校验，`record_findings` 记录实质结论。画面约数用于判断内容和先后，证据矛盾保留原文并记录 unresolved。单集失败保留已执行修改，其他集继续。默认 `legacy` 使用逐项审核的流程。批量方式的成本随上下文、缓存与取证次数变化；证据冲突和重要分段边界需人工复核后验收。
 
-ASR 对比同时读取台词前后的画面 Action。音轨起音可到毫秒，画面记录按其原片证据保留整秒或小数。模拟采纳 ASR 建议产生的本集时间轴错误、相邻原文和短看片窗口交给 Agent，并按窗口补充媒体预算；修复依据原片声画先后。结束时仍有 Script 时间轴校验错误的集标为未完成，保留已成功修改并从同一项目续审。批量流程在单集落盘后发出 `asr-applied`，只统计最终实际采纳的 ASR 建议；结论中的实质内容修正单独记录。
+审核不做语音识别，也不自动校时，时间戳保留 ingest 的精度。本集时间轴错误、相邻原文和短看片窗口交给 Agent，并按窗口补充媒体预算；修复依据原片声画先后。结束时仍有 Script 时间轴校验错误的集标为未完成，保留已成功修改并从同一项目续审。
 
 逐集审核同时明确动作叙述的人物指代：依据资产、上下文与原片证据，将可确认的称呼、别名和代词写成资产正式名；普通词义、台词和画面文字原文保留，歧义记 unresolved。全剧收敛核对人物合并、更名后的叙述名称一致性。具体边界见 [references/video-transcript-repair.md](references/video-transcript-repair.md)。
 
-ASR 返回有效语句后，程序将整集对白与心声按顺序拼接，与 ASR 整句文本做字符编辑距离比较。NFKC 规范化、统一大小写并去除标点空白后，以两边较长文本的字符数为分母；差异率严格超过 10% 时，本集失败，不调用模型校时或审核，本轮全剧收敛也停止。其他集可继续完成。两份原始文本、字符数、编辑距离及比例保存到 `.review/asr/episode-N/dialogue-check-*/report.json`；应检查原视频绑定与 ingest 内容后再续跑。无音轨或 ASR 无有效语句仍按相应证据不足流程处理。
-
-`.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` 不发模型请求。
+`--episodes` 只重跑指定集的审核，`--converge-only` 只做全剧收敛。`--check` 不发模型请求。
 
 视频和纯剧本审核使用 `review-agent`，文本和漫画使用 `review-text`、`review-comic`；主 Agent 每次请求按 MSUICODE Vertex → GCP → T3 → 兔子 → 豆包 Seed 2.1 Lite → Turbo 的顺序调用，Gemini 渠道均为 `gemini-3.8-flash`。MSUICODE 地址为 `http://15.204.107.123:3000`，分别读取 `MSUICODE_VERTEX_API_KEY`、`MSUICODE_GCP_API_KEY`、`MSUICODE_T3_API_KEY`；兔子读取 `TUZI_API_KEY`，Lite 读取 `ARK_API_KEY`，Turbo 读取 `DOUBAO_TURBO_API_KEY`。主渠道密钥必需，额外渠道仅在配置对应密钥时参与。普通服务错误按顺序切换；Gemini 明确内容拦截时，当前这一步跳过剩余 Gemini 渠道交给豆包，下一步重新从首选渠道开始。各模型沿用 provider 的 `maxAttempts`，内置最多三次。切换保留成功的工具操作，用量记录实际渠道和模型，Gemini 思考签名只在生成它的渠道内复用。逐集与全剧审核都要求成功调用 `validate` 后才结束。自定义 profile 使用声明的 `fallbacks` 顺序。`--no-fallback` 或 `SCRIPTCTL_REVIEW_SINGLE_MODEL=1` 仅使用选定模型。
 
-独立的 ASR JSON 比对和原片视频核验使用 `review-media`：NNYYAI Gemini 3.8 → 3.7 → 3.6 Flash → 豆包 Seed 2.1 Lite → Turbo，凭据分别为 `NNYYAI_API_KEY`、`ARK_API_KEY`、`DOUBAO_TURBO_API_KEY`；`DOUBAO_LITE_MODEL`、`DOUBAO_TURBO_MODEL` 可覆盖对应豆包端点。显式 `--model` 或自定义配置仍决定媒体主渠道。豆包 Flash ASR 继续读取 `SD_AUDIO_APIKEY`。
+原片视频核验使用 `review-media`：NNYYAI Gemini 3.8 → 3.7 → 3.6 Flash → 豆包 Seed 2.1 Lite → Turbo，凭据分别为 `NNYYAI_API_KEY`、`ARK_API_KEY`、`DOUBAO_TURBO_API_KEY`；`DOUBAO_LITE_MODEL`、`DOUBAO_TURBO_MODEL` 可覆盖对应豆包端点。显式 `--model` 或自定义配置仍决定媒体主渠道。
 
 全剧收敛审核必须成功执行 `validate` 才能正常结束；未完成时在同一会话内继续，保留已有工具操作，并共用原步数和总时间预算。整集默认 15 分钟总时限，耗尽后结束本轮审核。
 
 `review` 一个进程审完整本剧：剧本只解析一次进内存，按集扇出，再做全剧收敛。视频审核先处理身份和重复登记，再按 `--concurrency` 并行核对各资产。每项资产用资产卡、绑定场次和状态代表帧做一次结构化核对；描述有疑点时由本资产 agent 查证，需要变更身份、正文或引用的事项在资产池结束后集中处理。视频人物专项审核按相关集覆盖来源，逐帧独立观察后组合自身阶段与主体衣服造型，同步场景、说话引用、正文和梗概。同衣服下实际不同的脸形体态分别建人物 state；独立操作物件的完整外观归 prop，持有、穿戴、数量和位置关系归 Action。snapshot 支持帧与 unassignedFrames 共同保留盲帧事实和未知，供人物与物件修订使用。`--media-model` 可单独选择取证 profile；固定形象组合在 profile 未指定 thinking 时使用 high，其余调用沿用各自配置。
-全局结束后，本次选集范围内的交接事项及依据已变化的已完成集自动补审一次，复用同次 ASR。逐集审核可依据已核形象为本集引用资产创建缺失状态，再迁移对应引用；已有共享状态内容保留。`--converge-only` 保留逐集待办，供下次正常审核续接。视频专项 `--converge-only --assets <ID列表>` 可配合 `--episodes` 限定人物取证范围；其中明确的 category=asset 未决事项定向进入现有资产升级，按正文与有效来源登记物件并绑定相关场景，不扩展为全剧扫描。普通全局审核保留一次既有资产升级。
+全局结束后，本次选集范围内的交接事项及依据已变化的已完成集自动补审一次。逐集审核可依据已核形象为本集引用资产创建缺失状态，再迁移对应引用；已有共享状态内容保留。`--converge-only` 保留逐集待办，供下次正常审核续接。视频专项 `--converge-only --assets <ID列表>` 可配合 `--episodes` 限定人物取证范围；其中明确的 category=asset 未决事项定向进入现有资产升级，按正文与有效来源登记物件并绑定相关场景，不扩展为全剧扫描。普通全局审核保留一次既有资产升级。
 给 `-s` 按来源选择文本、漫画或视频核对，不给就检查剧本内部一致性，
 媒体工具不注册。每集**先落盘再输出**一行 NDJSON 到 stdout（`{"type":"episode",…}`，末行
 `{"type":"done",…}`）——收到一行就代表那一集的修改已经在文件里，中途挂掉只丢没报告的集。
@@ -258,7 +256,7 @@ agent 并直接改文件。
 
 漫画 review 的 `-s` 支持漫画 ingest 工作区，或原 PDF 文件/目录（剧本旁需有 ingest `manifest.json`）。通过 `document_id` 和 PDF SHA-256 核实来源，保留 Script v4 的页码/区域扩展字段。默认 `review-comic` profile 采用上述主 Agent 渠道链，需要 `MSUICODE_VERTEX_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、校时和媒体预算流程。
+漫画 Agent 使用原页及局部图片逐页检查遗漏，再对照 action 核对正文、说话人、心声类别、顺序和来源。需要 `pdftoppm`；图片在 `review-pages/`，结果在 `.review/comic/episode-N.json` 和 `global.json`。新增 action 同时写来源，跨页引用保留全部页与区域。`viewed_pages` 只记录图片已加载；未看完整页集会留下 unresolved，不能据此宣称整话通过。漫画不生成时间戳；运行由 `--max-steps` 和 `--episode-timeout-ms` 限制。视频保留原有媒体预算流程。
 
 换壳仿写使用 `reskin`，命令通过 NDJSON 报告进度并保留已完成单元。流程为 `reskin analyze` 拆解、`reskin direction` 选择新壳、`reskin plan` 逐层设计（最后两层是全剧故事时间线和按时间线设计的人物造型）、`reskin write --review-model <profile>` 逐集写作与审核（场景时段和造型按时间线绑定）、`reskin review --converge-only` 全剧收尾。写作在每个阶段内按集序执行，阶段之间并行；每集审核完成后，将累积事实账本交给下一集。全剧收尾检查阶段接缝，并由独立上下文通读实际成稿；发现方案层问题时回改方案、复查受影响正文，再读取修复结果。各命令通过 `--model` 选择 profile，写作通过 `--review-model` 指定审核 profile。原剧、拆解、方案和新剧路径分别显式传入 `-p`、`--source`、`--analysis`、`--plan` 等对应参数；用各子命令的 `--help` 查看完整调用。`reskin batch` 按清单逐部运行并保存进度和成本报告。