口播短视频复刻工具
先读 GUIDE.md。工具包独立于原剪辑仓库；无远程服务、API凭据或原片路径依赖。
选择入口
- 复刻现有 A/B 两条内容：用
scripts/prepare.py --preset A或--preset B建立包外工程，传入同一原片；沿用包内已确认逐字稿、原片切点、关键词、固定ASS及标题图。运行doctor.py、render.py、verify.py，交付视频与完整时间线稿。 - 制作新内容：用
--preset new建工程；按 references/editorial-workflow.md 选择完整观点，依据 references/timeline-format.md 编排。可选transcribe_local.py生成离线转写初稿；逐段回听后进入渲染。 - 只调整已有工程：按用户指定范围改工程数据；保留确认过的原声与其他设计。固定ASS与项目不一致时删除工程的
subtitle_ass字段以重新生成；不要让稿件与实际视频使用不同版本。
已确认风格
详细参数和书法生图提示词见 references/style-recipe.md。
- 1080×1920、30fps；横屏人物完整居中，不裁切、不推近。
- 人物画面内：左上32px小标题、左侧60px深紫关键词、下沿48px白色字幕，字幕最多两行。
- 左侧每次一个重点，随实际口播切换；不遮脸，不提前放结论。
- 钩子 → 全屏总结标题卡 → 完整正文/结果闭环 → 结尾总结卡；保留两处黑底白字书法卡。
- 沿用底部阶段面板；人物偏暖。默认口播1.14倍且保留音调；BGM轻入、平滑推进，先听清口播。
内容完整性
- 字幕和口播稿依据原声，不删字、添字或凭空拼出新结论；选短视频不等于截断观点。
- 钩子在后文完整表达中回收。结果保留“做了什么、形成什么资产、达到什么效果”。
- A稿已有SOP听写待核对说明；保留该说明，不声称已人工逐字核准。
- 自动质检检查解码、时间戳、字幕数据和闪黑候选；不能替代听写校对、挡脸检查或主观配乐审听。
交付和隐私
交付MP4、完整时间线稿、字幕SRT、项目JSON、预览与质检报告；保留旧版不覆盖。
安装包只收录流程、脚本、配置、已授权分享的稿件和图片。不要打包密钥、API配置、Cookie、环境文件、日志、缓存、原片、配乐、个人账号文件或用户的绝对路径。
资源：examples/A（企业资产沉淀，45.1秒）、examples/B（三类人做OPC，74.6秒）；templates（空白工程）；scripts/smoke_test.py（合成素材自测）。
