阿拉丁AI短剧成片质检工坊

解决什么问题

把 edit_timeline.json 交给上架环节之前，成片往往缺少一次可复算的交付质检：黑屏跳帧、配音轨溢出、全片缺字幕或开场慢热，通常是在平台驳回或用户划走之后才暴露。这个技能只做一件事：在剪辑之后、发布之前，把剪辑时间线的各轨声明读一遍，产出确定性的质检结果和一份能直接回灌给上游环节的修改清单。

它不重新创作内容，也不接管剪辑、配音、字幕生成或排期。目标是把「这版交不交得出去」从主观感受变成规则可解释的分数与门禁。

如何工作

• qc_ingest.py 读取 edit_timeline.json，兼容 clips[] 与 timeline[] 两种键；逐 clip 建模起止、时长、源、配音轨、人声、BGM、字幕、转场和间隙，并累计 computed_total 与声明的 total_duration 比对。可选 --subs 会解析 SRT，用于字幕覆盖和越界的精确核对。
• qc_check.py 运行 Q0 到 Q10 共 11 条规则，覆盖时间线断裂或重叠、静音空档、无字幕或缺字幕、配音轨溢出、无 BGM、单集时长、画幅比、分辨率、开场黄金 3 秒、转场拖沓和字幕越界。
• 评分采用 100 分制：P0 扣 25 分、P1 扣 8 分、P2 扣 3 分，映射到 A/B/C/D 等级。门禁逻辑直接绑定阻断项：P0 > 0 判 BLOCK，P1 > 0 判 REVIEW，否则 READY。
• qc_report.py 输出自包含 HTML 审片看板、Markdown 审片单和 UTF-8-SIG 编码的 CSV 问题清单。HTML 内嵌四轨时间轴 SVG、评分环、门禁徽章和问题列表，不依赖外链。
• _qc.json 中同时写入 to_edit_fix、to_subtitle_fix、to_bgm_fix、to_publish_ready 和 blocking_codes，让上游剪辑、字幕、配乐和发布环节拿到明确逆改指令。

适用边界

• 质检只读时间线和字幕声明，不做真实音视频解码，也没有逐帧像素级审查。
• 评分是与平台规格和行业经验对齐的规则估算，不是各平台官方审核结果；正式过审仍需以目标平台规范为准。
• Q10 的字幕越界和覆盖需要 SRT 输入；没有 SRT 时只判断字幕轨存在性和有台词缺字幕，不会精确计算越界。
• 一次质检针对单个单集或单条时间线，多集批量需要逐集执行后汇总。
• 平台差异通过 --platform 覆盖，可选红果、抖音、快手、微信、番茄和通用规格。