收齐成片、封面、章节和可选字幕,用清单带走已验收的版本
现在
偶尔用
这次只核对了说明和命令,没有出片、没有观看;一条命令出片还没有真片验收记录
截至 11 月 4 日 · 项目源码和说明文档

回到项目 → 本地视频制作 私有 复制 AI 续作说明

video-scaffold · 功能说明

交付现在有三种形式。分镜路线把无声画面轨和旁白合成,按需压入背景音乐,再出封面、章节、可选字幕和交付清单;图文页直接出一份带原配音、逐字出现字幕的 1080p 可播放副本,多段还能装配成整片并自动生成章节;独立网页作品有回看包、后期合成、封面和本地展示目录。最后的检查读取真实媒体流和尺寸,不只看文件名。第四种是 docfilm 的一条命令出片(release):从多音字检查、只渲过期的段、合成整片,到出片前文字检查、成片画面和声音检查、实际成片的字幕逐字对稿、片尾、每镜三帧联系表、和上一版比差异、按镜头截配图,任何一步失败就停在待验目录,全部通过才成为终版。它自带的成片检查默认只看画面和声音,识字(OCR)和语音对稿(ASR)是另跑的检查。

当前情况:本期影片《电子雪貂饲养员》已于 10 月 11 日 12:43 通过本人审定;分段装配等新入口这次没有找到真实整片的装配回执,网页核对本身也没有出片或观看。docfilm 的一条命令出片 10 月 29 日才合进主线,这次只读了源码和说明,没有跑过,不能说已实测通过。

项目源码:私有仓库

收齐成片、封面、章节和可选字幕,用清单带走已验收的版本
现在
偶尔用
这次只核对了说明和命令,没有出片、没有观看;一条命令出片还没有真片验收记录
截至 11 月 4 日 · 项目源码和说明文档

回到项目 → 本地视频制作 私有 复制 AI 续作说明

video-scaffold · 功能说明

交付现在有三种形式。分镜路线把无声画面轨和旁白合成,按需压入背景音乐,再出封面、章节、可选字幕和交付清单;图文页直接出一份带原配音、逐字出现字幕的 1080p 可播放副本,多段还能装配成整片并自动生成章节;独立网页作品有回看包、后期合成、封面和本地展示目录。最后的检查读取真实媒体流和尺寸,不只看文件名。第四种是 docfilm 的一条命令出片(release):从多音字检查、只渲过期的段、合成整片,到出片前文字检查、成片画面和声音检查、实际成片的字幕逐字对稿、片尾、每镜三帧联系表、和上一版比差异、按镜头截配图,任何一步失败就停在待验目录,全部通过才成为终版。它自带的成片检查默认只看画面和声音,识字(OCR)和语音对稿(ASR)是另跑的检查。

当前情况:本期影片《电子雪貂饲养员》已于 10 月 11 日 12:43 通过本人审定;分段装配等新入口这次没有找到真实整片的装配回执,网页核对本身也没有出片或观看。docfilm 的一条命令出片 10 月 29 日才合进主线,这次只读了源码和说明,没有跑过,不能说已实测通过。

项目源码:私有仓库

这项功能怎样使用

用途与实际影响

为什么需要它

无声画面轨或同名旧文件看似完整,却可能不是本期内容。交付层不仅收齐成片、封面与章节,还核对来源、真实帧数、总时长和音视频起点;分段装配要求总帧精确吻合、来源全程没变,防止带走半新半旧的一包文件。纪实类片子常要整句字幕、标出“对方 / 我”是谁在说,段与段之间直接切换,这些输出方式也要在交付这一层说清楚:它们改变的是看到的样子,不改变核对的标准。长片一轮轮返工时,最怕“说改了其实没生效”或新版混进旧段:docfilm 出片把每一步的结果写进一份清单,再和上一版逐镜比字、比画面、比声音,任何一步不过就不成为终版。

举个实际例子

我可以说:“这一期分了十段,按我给的章节表拼成整片,每章标题不超过六个字;拼之前先给我看计划。”系统先列出装配计划,确认后拼片,同时生成章节文本和一份记录每段来源与哈希的装配回执;目标文件已存在就拒绝覆盖。想要段与段之间不叠化,拼接表里写 fade_frames: 0 就直接接帧。

做 docfilm 时我可以说:“按这份改动单出 v3。”程序只重渲改到的段,跑完全部步骤;改动单里写了改、成片却没变化的镜头会被列成“改了没生效”;哪一步失败,待验视频留在检查目录,上一版终版不动。

最后我会得到什么

得到本期成片或可播放副本、封面和从开头开始的章节;可播放副本里烧着字幕:默认逐字出现,可选整句出现,录音段整句出现并可带说话人和小标签。需要时另带字幕、文件清单或装配回执。docfilm 出片另得到一份出片清单(输入指纹、框架版本、每步结果和耗时、逐条放行的理由)、每镜三帧联系表、和上一版的差异报告和按镜头截的配图。自动检查通过只说明它描述过的那几层和文件来源能对应;没另跑识字和语音对稿,就不能说查过画面上的隐私文字或念白对稿,人仍要完整看一遍;上传平台是另一件事。

这项功能怎样使用

用途与实际影响

为什么需要它

无声画面轨或同名旧文件看似完整,却可能不是本期内容。交付层不仅收齐成片、封面与章节,还核对来源、真实帧数、总时长和音视频起点;分段装配要求总帧精确吻合、来源全程没变,防止带走半新半旧的一包文件。纪实类片子常要整句字幕、标出“对方 / 我”是谁在说,段与段之间直接切换,这些输出方式也要在交付这一层说清楚:它们改变的是看到的样子,不改变核对的标准。长片一轮轮返工时,最怕“说改了其实没生效”或新版混进旧段:docfilm 出片把每一步的结果写进一份清单,再和上一版逐镜比字、比画面、比声音,任何一步不过就不成为终版。

举个实际例子

我可以说:“这一期分了十段,按我给的章节表拼成整片,每章标题不超过六个字;拼之前先给我看计划。”系统先列出装配计划,确认后拼片,同时生成章节文本和一份记录每段来源与哈希的装配回执;目标文件已存在就拒绝覆盖。想要段与段之间不叠化,拼接表里写 fade_frames: 0 就直接接帧。

做 docfilm 时我可以说:“按这份改动单出 v3。”程序只重渲改到的段,跑完全部步骤;改动单里写了改、成片却没变化的镜头会被列成“改了没生效”;哪一步失败,待验视频留在检查目录,上一版终版不动。

最后我会得到什么

得到本期成片或可播放副本、封面和从开头开始的章节;可播放副本里烧着字幕:默认逐字出现,可选整句出现,录音段整句出现并可带说话人和小标签。需要时另带字幕、文件清单或装配回执。docfilm 出片另得到一份出片清单(输入指纹、框架版本、每步结果和耗时、逐条放行的理由)、每镜三帧联系表、和上一版的差异报告和按镜头截的配图。自动检查通过只说明它描述过的那几层和文件来源能对应;没另跑识字和语音对稿,就不能说查过画面上的隐私文字或念白对稿,人仍要完整看一遍;上传平台是另一件事。

结果怎么看
正常时

成片、封面与章节都属于当前来源,音视频和时长检查通过后生成交付清单或装配回执。docfilm 出片全部步骤通过,成片才从检查目录改成带版本号的正式文件名,清单写明每一步的结果。

发现问题时

音乐音量、封面内容和章节措辞仍由人看;文件结构、帧数或时长对不上就回到相应制作步骤。docfilm 出片停在哪一步,清单就写到哪一步,待验视频留在检查目录供查看;出片前文字检查报的错只能逐条写理由放行,没有整批关掉的办法。

入口不可用或证据不足时

缺画面、旁白、标题或章节时停止,不用静音片或占位标题冒充交付;章节起点取整到秒后重复也会报错。docfilm 缺文字层的画面只报“查不了”,不当成查过;没有片尾卡又没写明理由,出片在片尾那一步报错。

结果怎么看
正常时

成片、封面与章节都属于当前来源,音视频和时长检查通过后生成交付清单或装配回执。docfilm 出片全部步骤通过,成片才从检查目录改成带版本号的正式文件名,清单写明每一步的结果。

发现问题时

音乐音量、封面内容和章节措辞仍由人看;文件结构、帧数或时长对不上就回到相应制作步骤。docfilm 出片停在哪一步,清单就写到哪一步,待验视频留在检查目录供查看;出片前文字检查报的错只能逐条写理由放行,没有整批关掉的办法。

入口不可用或证据不足时

缺画面、旁白、标题或章节时停止,不用静音片或占位标题冒充交付;章节起点取整到秒后重复也会报错。docfilm 缺文字层的画面只报“查不了”,不当成查过;没有片尾卡又没写明理由,出片在片尾那一步报错。

从哪里开始

分镜路线:出片后按需运行 merge、cover、chapters、subtitles,最后 verify 和 manifest(清单)。图文页:pages render 直接给可播放副本,多段用 python -m pipeline.pages assemble <拼接表.json> --plan 先看计划,去掉 --plan 实际拼片。独立网页作品用 webfilm 的 review、compose、cover、package。最后都要实际观看。

docfilm:在项目根目录运行,python 用登记的 E:\PythonEnvs\video-scaffold-gpu-cu12\Scripts\python.exe;要在显卡上渲,先设 $env:DOCFILM_DEVICE = "resident",不设就是 CPU。

第二版起:python -m docfilm.release <分段表.json> --tag v2 --changes <改动单.md> --narration-config <配音配置.json> --out-dir <出片目录>

第一版也要给改动单,另外加 --initial:python -m docfilm.release <分段表.json> --tag v1 --initial --changes <首版改动单.md> --narration-config <配音配置.json> --out-dir <出片目录>

首版改动单照 templates/docfilm/改动单.md 写,表里列本版全部镜头,可以写成一行:| 1 | A1、A2、B1 | 首版全部镜头 | 首版 | 本人内容改动 |,不写“全局”那一行;列得和实际镜头不一样,会报“改动单不符”。--initial 只在出片目录里还没有上一版成功清单时才有用,不能代替 --changes。片子确实没有片尾卡,再加 --no-endcard <理由>。

要查画面上的隐私文字和念白对稿,另跑 python -m docfilm.filmcheck film <成片.mp4> --terms <核对词表.txt> --out <独立检查目录> --only ocr,asr --script <旁白定稿.md> --timeline <timeline.json>;词表是 UTF-8 文本,每行写 严重程度|类别|词(例如 必须改|姓名|待查姓名),只放本机。

需要准备什么
  • 要交付的成片或各段视频
  • 封面标题或可选主图
  • 是否需要背景音乐、章节或字幕
  • docfilm 另要分段表、配音配置和这一版的改动单(第一版也要,表里列全部镜头)
从开始到拿到结果
1收齐交付物
合成画面、旁白、封面和从开头开始的章节;图文页多段先装配成整片,需要时再做字幕与背景音乐。
2机器核对本期来源
检查画面、声音、时长和文件是否属于当前作品,生成交付清单、装配回执或 docfilm 的出片清单。
3本人完整观看
看画面、听声音并确认内容;上传平台是后续独立决定。
从哪里开始

分镜路线:出片后按需运行 merge、cover、chapters、subtitles,最后 verify 和 manifest(清单)。图文页:pages render 直接给可播放副本,多段用 python -m pipeline.pages assemble <拼接表.json> --plan 先看计划,去掉 --plan 实际拼片。独立网页作品用 webfilm 的 review、compose、cover、package。最后都要实际观看。

docfilm:在项目根目录运行,python 用登记的 E:\PythonEnvs\video-scaffold-gpu-cu12\Scripts\python.exe;要在显卡上渲,先设 $env:DOCFILM_DEVICE = "resident",不设就是 CPU。

第二版起:python -m docfilm.release <分段表.json> --tag v2 --changes <改动单.md> --narration-config <配音配置.json> --out-dir <出片目录>

第一版也要给改动单,另外加 --initial:python -m docfilm.release <分段表.json> --tag v1 --initial --changes <首版改动单.md> --narration-config <配音配置.json> --out-dir <出片目录>

首版改动单照 templates/docfilm/改动单.md 写,表里列本版全部镜头,可以写成一行:| 1 | A1、A2、B1 | 首版全部镜头 | 首版 | 本人内容改动 |,不写“全局”那一行;列得和实际镜头不一样,会报“改动单不符”。--initial 只在出片目录里还没有上一版成功清单时才有用,不能代替 --changes。片子确实没有片尾卡,再加 --no-endcard <理由>。

要查画面上的隐私文字和念白对稿,另跑 python -m docfilm.filmcheck film <成片.mp4> --terms <核对词表.txt> --out <独立检查目录> --only ocr,asr --script <旁白定稿.md> --timeline <timeline.json>;词表是 UTF-8 文本,每行写 严重程度|类别|词(例如 必须改|姓名|待查姓名),只放本机。

需要准备什么
  • 要交付的成片或各段视频
  • 封面标题或可选主图
  • 是否需要背景音乐、章节或字幕
  • docfilm 另要分段表、配音配置和这一版的改动单(第一版也要,表里列全部镜头)
从开始到拿到结果
1收齐交付物
合成画面、旁白、封面和从开头开始的章节;图文页多段先装配成整片,需要时再做字幕与背景音乐。
2机器核对本期来源
检查画面、声音、时长和文件是否属于当前作品,生成交付清单、装配回执或 docfilm 的出片清单。
3本人完整观看
看画面、听声音并确认内容;上传平台是后续独立决定。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

分镜交付检查、图文页可播放副本(逐字、整句和说话人字幕)、分段装配(含可配置硬切)与网页作品后期已在源码中;本次没有实际成片验收(内容按北京时间 2026-10-22 01:25 最后一次提交 626774f 核对,10 月 22 日 06:47 读);docfilm 一条命令出片按北京时间 10 月 31 日 14:19 最后一次提交 3c1c117 的源码、说明和 --help 核对(11 月 4 日),也没有实际跑过

关键规则与设计选择
1
背景音乐是可选输入,旁白不是;没有旁白拒绝最终交付。
2
verify 和装配验收检查的是结构和有限时间差,不判断文案事实、音色表现或平台审核。
3
项目没有上传动作,也不取得平台回执;网页作品的投稿模板只生成可编辑的文字格式,旧的自动投稿文案包仍是退役状态。
4
docfilm 出片默认的成片检查只做画面和声音两项;识字和语音对稿是另跑的独立检查,出片全部步骤跑完不等于做过它们。自动通过只覆盖已描述的层和已运行的检查,不替代主持观看和本人审定。
当前怎样实现
  • merge.concat_audio 按规范编号拼接 MP3;有背景音乐时先统一立体声,用侧链压缩在旁白出现时压低音乐,混合后限制峰值并做 1.2 秒尾淡出。
  • cover.py 用 Playwright 渲染 cover_base.html,标题不能仍是 Untitled Video;chapters.py 把累计时长换成时间码,第一章补到 00:00,并对数量、标题长度和过近章节发警告。
  • cleanup.verify 检查当前来源、总帧与总时长、音视频流时长与起点、画布/帧率/编码、PNG 封面与章节;subtitles 生成全片 SRT/WebVTT,manifest 只在验证通过后纳入文件并写 delivery.json。
  • 图文页 pages render 接现成配音,按读到逐字显字、强调当前词,交 1080p H.264 High@4.2、yuv420p、BT.709、AAC、faststart 的可播放副本;karaoke_ass(..., reveal=True) 和 playable_copy(...) 生成这份副本,reveal=False 保留传统整句字幕。分镜表顶层 subtitles.mode: "sentence" 时改用 sentence_cues 整句出字幕:按句号、问号、叹号、分号和换行切句,超过约 22 字在逗号处再切,无逗号不硬断,到下一句替换;录音段总是整句,speakers: true 时显示“对方 / 我”前缀(前缀不送入对齐),可配 subtitles.color、subtitles.label。纪实主题下字幕为白字压半透明黑底条。最后一句字幕不压到加长的片尾停留上。副本不改 final_output.mp4 和 delivery.json。
  • 装配入口读 parts:[{id,path}]、out、chapters:[{title,from:段id}] 和可选 max_title_chars;各段同一画幅、都要有音视频,章起点可把多段并成一章,第一章从第一段开始。实际拼片同时输出同名的 .chapters.txt 和 .assembly.json。拼接表可写 fade_frames:非负整数叠化帧数(60fps,默认 12),0 为直接拼接视频帧;页内换页的硬切由分镜表 transition: 0 决定。
  • docfilm release 依次跑:多音字只读检查(不调配音)、镜头单检查和分段、只渲指纹失效的段并合成整片、文字时间表关卡、filmcheck 画面与声音、从实际成片帧取字幕逐字对稿、片尾、每镜三帧联系表、和上一版的文字 / 画面 / 音轨差异、按镜头截配图。输出、合并中间文件和新渲的段都写进本次检查目录,不改本期原件;文件名是原成片名加版本号和六位输入摘要,已有终版或仍在出片就拒绝覆盖。--tag 和 --changes 始终必填,少了停在参数解析;--initial 只放行“找不到上一版清单”,不代替改动单:首版把全部镜头算作变化,再和改动单的镜头列严格比对(release.py 的 differences、verify_changes)。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

分镜交付检查、图文页可播放副本(逐字、整句和说话人字幕)、分段装配(含可配置硬切)与网页作品后期已在源码中;本次没有实际成片验收(内容按北京时间 2026-10-22 01:25 最后一次提交 626774f 核对,10 月 22 日 06:47 读);docfilm 一条命令出片按北京时间 10 月 31 日 14:19 最后一次提交 3c1c117 的源码、说明和 --help 核对(11 月 4 日),也没有实际跑过

关键规则与设计选择
1
背景音乐是可选输入,旁白不是;没有旁白拒绝最终交付。
2
verify 和装配验收检查的是结构和有限时间差,不判断文案事实、音色表现或平台审核。
3
项目没有上传动作,也不取得平台回执;网页作品的投稿模板只生成可编辑的文字格式,旧的自动投稿文案包仍是退役状态。
4
docfilm 出片默认的成片检查只做画面和声音两项;识字和语音对稿是另跑的独立检查,出片全部步骤跑完不等于做过它们。自动通过只覆盖已描述的层和已运行的检查,不替代主持观看和本人审定。
当前怎样实现
  • merge.concat_audio 按规范编号拼接 MP3;有背景音乐时先统一立体声,用侧链压缩在旁白出现时压低音乐,混合后限制峰值并做 1.2 秒尾淡出。
  • cover.py 用 Playwright 渲染 cover_base.html,标题不能仍是 Untitled Video;chapters.py 把累计时长换成时间码,第一章补到 00:00,并对数量、标题长度和过近章节发警告。
  • cleanup.verify 检查当前来源、总帧与总时长、音视频流时长与起点、画布/帧率/编码、PNG 封面与章节;subtitles 生成全片 SRT/WebVTT,manifest 只在验证通过后纳入文件并写 delivery.json。
  • 图文页 pages render 接现成配音,按读到逐字显字、强调当前词,交 1080p H.264 High@4.2、yuv420p、BT.709、AAC、faststart 的可播放副本;karaoke_ass(..., reveal=True) 和 playable_copy(...) 生成这份副本,reveal=False 保留传统整句字幕。分镜表顶层 subtitles.mode: "sentence" 时改用 sentence_cues 整句出字幕:按句号、问号、叹号、分号和换行切句,超过约 22 字在逗号处再切,无逗号不硬断,到下一句替换;录音段总是整句,speakers: true 时显示“对方 / 我”前缀(前缀不送入对齐),可配 subtitles.color、subtitles.label。纪实主题下字幕为白字压半透明黑底条。最后一句字幕不压到加长的片尾停留上。副本不改 final_output.mp4 和 delivery.json。
  • 装配入口读 parts:[{id,path}]、out、chapters:[{title,from:段id}] 和可选 max_title_chars;各段同一画幅、都要有音视频,章起点可把多段并成一章,第一章从第一段开始。实际拼片同时输出同名的 .chapters.txt 和 .assembly.json。拼接表可写 fade_frames:非负整数叠化帧数(60fps,默认 12),0 为直接拼接视频帧;页内换页的硬切由分镜表 transition: 0 决定。
  • docfilm release 依次跑:多音字只读检查(不调配音)、镜头单检查和分段、只渲指纹失效的段并合成整片、文字时间表关卡、filmcheck 画面与声音、从实际成片帧取字幕逐字对稿、片尾、每镜三帧联系表、和上一版的文字 / 画面 / 音轨差异、按镜头截配图。输出、合并中间文件和新渲的段都写进本次检查目录,不改本期原件;文件名是原成片名加版本号和六位输入摘要,已有终版或仍在出片就拒绝覆盖。--tag 和 --changes 始终必填,少了停在参数解析;--initial 只放行“找不到上一版清单”,不代替改动单:首版把全部镜头算作变化,再和改动单的镜头列严格比对(release.py 的 differences、verify_changes)。
技术实现与依据(二)
1
确认画面轨(或各段视频)与全部旁白存在。
  • 装配时检测每段片尾静音,非末段保留到念完后约 0.45 秒,段间 0.2 秒(12 帧)画面叠化;音频顺序串接,时间量化到整帧。成片必须是 H.264/AAC、yuv420p、60fps、计划画幅,总帧完全吻合,音频、视频、容器时长误差都要小于 1 帧。
  • 章节必须唯一递增、从 00:00 开始,取整到秒后也必须互不相同。每章数量和标题长度按本期给定;本期 6 章、每章不超过 6 字是这一期的选择,不是所有影片的默认。
  • 装配回执记录每段源路径、字节数与 SHA、裁剪/帧数/段起点/章节、ffmpeg 命令、最终 ffprobe、验证结果及输出字节与哈希;结束前重验来源没变。成片、章节、回执任一目标已存在都拒绝覆盖,先同目录暂存;并发占用目标会失败。
  • docfilm 出片失败可用同一条命令重试:上次的失败清单归进原检查目录,有效的段先硬链接、跨盘才复制,写之前先断开链接,不改到旧文件。新版通过后清掉上一版缓存,只留最近一版,保留帧日志、报告、联系表和比帧证据;这一步直接删除、不走回收站,删不掉写进 warnings 和 cleanup.errors,不把已成功的出片改成失败;失败的尝试留着供续作。比帧每 0.1 秒取一张 960×540 灰度图,整图 PSNR 低于 40 dB 或任一 16×16 小块平均差超过 4 级就判这里变了;音轨也按 0.1 秒比。这只用来定位改动,不代替人看。
  • 网页作品:review 给完整回看视频、12 帧拼图、波形和音频/来源报告;compose 可拼片、并排、加旁白与字幕、两遍响度处理(目标 −14 LUFS、真峰值 −1.5 dBTP、48kHz 双声道 AAC,编码后记录实际值);cover 出 16:9 和 4:3;package 生成本地静态展示目录,不部署网站。
执行流程
技术实现与依据(二)
1
确认画面轨(或各段视频)与全部旁白存在。
  • 装配时检测每段片尾静音,非末段保留到念完后约 0.45 秒,段间 0.2 秒(12 帧)画面叠化;音频顺序串接,时间量化到整帧。成片必须是 H.264/AAC、yuv420p、60fps、计划画幅,总帧完全吻合,音频、视频、容器时长误差都要小于 1 帧。
  • 章节必须唯一递增、从 00:00 开始,取整到秒后也必须互不相同。每章数量和标题长度按本期给定;本期 6 章、每章不超过 6 字是这一期的选择,不是所有影片的默认。
  • 装配回执记录每段源路径、字节数与 SHA、裁剪/帧数/段起点/章节、ffmpeg 命令、最终 ffprobe、验证结果及输出字节与哈希;结束前重验来源没变。成片、章节、回执任一目标已存在都拒绝覆盖,先同目录暂存;并发占用目标会失败。
  • docfilm 出片失败可用同一条命令重试:上次的失败清单归进原检查目录,有效的段先硬链接、跨盘才复制,写之前先断开链接,不改到旧文件。新版通过后清掉上一版缓存,只留最近一版,保留帧日志、报告、联系表和比帧证据;这一步直接删除、不走回收站,删不掉写进 warnings 和 cleanup.errors,不把已成功的出片改成失败;失败的尝试留着供续作。比帧每 0.1 秒取一张 960×540 灰度图,整图 PSNR 低于 40 dB 或任一 16×16 小块平均差超过 4 级就判这里变了;音轨也按 0.1 秒比。这只用来定位改动,不代替人看。
  • 网页作品:review 给完整回看视频、12 帧拼图、波形和音频/来源报告;compose 可拼片、并排、加旁白与字幕、两遍响度处理(目标 −14 LUFS、真峰值 −1.5 dBTP、48kHz 双声道 AAC,编码后记录实际值);cover 出 16:9 和 4:3;package 生成本地静态展示目录,不部署网站。
执行流程
技术实现与依据(三)
2
分镜路线拼接旁白并合成,可选加入背景音乐;图文页多段先看装配计划再拼片。
3
按当前标题和可选主图生成封面。
4
生成章节,按需要导出并验证全片字幕。
5
运行 verify 逐项阅读并生成交付清单,或读装配回执。
6
实际观看最终视频,再决定投稿。
技术实现与依据(三)
2
分镜路线拼接旁白并合成,可选加入背景音乐;图文页多段先看装配计划再拼片。
3
按当前标题和可选主图生成封面。
4
生成章节,按需要导出并验证全片字幕。
5
运行 verify 逐项阅读并生成交付清单,或读装配回执。
6
实际观看最终视频,再决定投稿。
名词和入口
本模块用到的名词
名词意思
mux(音视频封装)把已经编码的视频轨和声音流放进同一个 MP4,不等于重新设计画面。
sidechain ducking(侧链压低)旁白出现时自动降低背景音乐音量,让人声保持清楚。
READY(交付结构就绪)所有机器可查的交付合同通过;不是人已经看完,也不是平台已经接收。
可播放副本图文页给的观看/上传用视频,带原配音和逐字字幕;和分镜路线的 final_output、delivery.json 是两回事。
专业定义

结构通过后才生成交付清单或装配回执;字幕按需导出,READY 后仍要真人观看。

解决什么

防止把无声画面轨、尺寸正确的空封面、或有文件没内容的交付包误认为本期完成。

名词和入口
本模块用到的名词
名词意思
mux(音视频封装)
意思:
把已经编码的视频轨和声音流放进同一个 MP4,不等于重新设计画面。
sidechain ducking(侧链压低)
意思:
旁白出现时自动降低背景音乐音量,让人声保持清楚。
READY(交付结构就绪)
意思:
所有机器可查的交付合同通过;不是人已经看完,也不是平台已经接收。
可播放副本
意思:
图文页给的观看/上传用视频,带原配音和逐字字幕;和分镜路线的 final_output、delivery.json 是两回事。
专业定义

结构通过后才生成交付清单或装配回执;字幕按需导出,READY 后仍要真人观看。

解决什么

防止把无声画面轨、尺寸正确的空封面、或有文件没内容的交付包误认为本期完成。

出问题时
边界
  • 字幕、哈希清单和装配回执都已实现;上传和平台回执仍不属于这个工具。docfilm 出片 10 月 29 日合进主线,这次只读源码和说明,没有实际跑过;它默认不跑识字和语音对稿,影片“发布了几期”这次也没有取得平台回执,仍是未核对。整句、说话人字幕和硬切是 10 月 21 日新加的输出方式,只在自动测试里跑过,还没有用它们出过并核验过的真实成片,也没有新的投稿记录。
  • 封面主图是可选设计输入,尺寸通过不代表主图或标题内容优质。
  • 本期影片已审定,用的是图文页的输出形式,不必叫 final_output 才算作品;15:08 补了一份通用装配的拼接表,但它指定的整片并不存在,通用装配入口仍没有真实整片的装配回执,不能拿本期旧方式拼出的成片冒充新入口已实跑验收。
失败与恢复
情况
怎么处理
没有旁白音频
merge 直接失败,不生成静音的 final_output。
标题仍是占位值
cover 与 verify 拒绝,补清本期标题后再生成。
媒体流、帧数或时长不符
保留 ffprobe 事实并回到出片、合成或装配,不靠改文件名通过。
拼接表 fade_frames 不是非负整数,或某段比叠化帧数还短
装配直接拒绝,改拼接表后重跑。
docfilm 出片命令少了 --changes
停在参数解析,报缺必填参数,什么都不做;第一版也要给改动单。
docfilm 出片某一步失败
停在那一步,清单写明停止阶段,待验视频留在检查目录;改好后用同一条命令重试,有效的段直接复用。
出片前文字检查报错
改镜头单后重出;确实要保留的,逐条写 --waive-text 问题ID=理由 放行,没有批量放行,也不沿用上轮放行。
没有片尾卡
显式写 --no-endcard 和非空理由,记进清单;否则片尾那一步报错。
出问题时
边界
  • 字幕、哈希清单和装配回执都已实现;上传和平台回执仍不属于这个工具。docfilm 出片 10 月 29 日合进主线,这次只读源码和说明,没有实际跑过;它默认不跑识字和语音对稿,影片“发布了几期”这次也没有取得平台回执,仍是未核对。整句、说话人字幕和硬切是 10 月 21 日新加的输出方式,只在自动测试里跑过,还没有用它们出过并核验过的真实成片,也没有新的投稿记录。
  • 封面主图是可选设计输入,尺寸通过不代表主图或标题内容优质。
  • 本期影片已审定,用的是图文页的输出形式,不必叫 final_output 才算作品;15:08 补了一份通用装配的拼接表,但它指定的整片并不存在,通用装配入口仍没有真实整片的装配回执,不能拿本期旧方式拼出的成片冒充新入口已实跑验收。
失败与恢复
情况
怎么处理
没有旁白音频
merge 直接失败,不生成静音的 final_output。
标题仍是占位值
cover 与 verify 拒绝,补清本期标题后再生成。
媒体流、帧数或时长不符
保留 ffprobe 事实并回到出片、合成或装配,不靠改文件名通过。
拼接表 fade_frames 不是非负整数,或某段比叠化帧数还短
装配直接拒绝,改拼接表后重跑。
docfilm 出片命令少了 --changes
停在参数解析,报缺必填参数,什么都不做;第一版也要给改动单。
docfilm 出片某一步失败
停在那一步,清单写明停止阶段,待验视频留在检查目录;改好后用同一条命令重试,有效的段直接复用。
出片前文字检查报错
改镜头单后重出;确实要保留的,逐条写 --waive-text 问题ID=理由 放行,没有批量放行,也不沿用上轮放行。
没有片尾卡
显式写 --no-endcard 和非空理由,记进清单;否则片尾那一步报错。
依据与来源
真实入口
  • 旁白、BGM 与最终 MP4
  • 4K 封面
  • 章节目录
  • 最终交付检查
如何验证
  • 回归用受控 ffprobe 响应验证完整交付通过,并验证无音频、占位标题和未解析触发词必须失败;整句与说话人字幕、硬切另有 test_sentence_subtitles.py、test_pages_documentary_audio.py、test_pages_assemble.py;当时提交 626774f 源码共 267 个测试定义(全项目),11 月 4 日按最后一次提交 3c1c117 静态数是 690 个;这次都没有自己运行。
  • 上次网页核对看到的 GitHub 自动测试是 2026-10-11 15:15—15:17 针对当时提交 c4eec887 的运行:Ubuntu 单测有 6 处因找不到 FFmpeg 出错,Windows 单测取消,Linux 整链短片成功;整体结果是失败,不能说全部通过。之后是 2026-10-21T17:25Z(北京时间 10 月 22 日 01:25)针对 626774f 的运行 39643661819:Ubuntu 单测 Ran 267、errors=20、skipped=7,20 处都是缺 ffmpeg / ffprobe;isolated-media 在 playwright install --with-deps chromium 失败(runner 为 ubuntu26.04,Playwright 不支持),整链短片没跑;Windows 单测取消;整体失败。到这一轮为止,10 月 20—22 日 8 次推送全部失败,最近一次成功是 2026-10-10T10:30Z 的 0c25892。最新可查的一轮是北京时间 10 月 22 日 23:11 针对 35a597a 的运行 39802408000,整体失败:isolated-media 卡在 python -m playwright install --with-deps chromium,Ubuntu 单测失败,Windows 单测步骤也失败、任务结论 cancelled;这一轮只读了任务和步骤结论,没取单测失败明细,不能把上一轮的原因搬过来。当前主分支 3c1c117 没有通过记录。以上 11 月 4 日 09:10 用 gh 只读查看,未重跑。
  • 本期影片已于 10 月 11 日 12:43 通过本人审定;现存整片约 18 分钟、1080p 60 帧,但文件存在不等于又审定一次;通用装配入口的真实整片回执、完整视频端到端验证仍是未核对项。
与其他模块的关系

出片模块交出画面轨或可播放副本;本模块负责最终可带走的文件和结构检查,复用模块说明哪些中间结果能继续用。

依据与来源
真实入口
  • 旁白、BGM 与最终 MP4
  • 4K 封面
  • 章节目录
  • 最终交付检查
如何验证
  • 回归用受控 ffprobe 响应验证完整交付通过,并验证无音频、占位标题和未解析触发词必须失败;整句与说话人字幕、硬切另有 test_sentence_subtitles.py、test_pages_documentary_audio.py、test_pages_assemble.py;当时提交 626774f 源码共 267 个测试定义(全项目),11 月 4 日按最后一次提交 3c1c117 静态数是 690 个;这次都没有自己运行。
  • 上次网页核对看到的 GitHub 自动测试是 2026-10-11 15:15—15:17 针对当时提交 c4eec887 的运行:Ubuntu 单测有 6 处因找不到 FFmpeg 出错,Windows 单测取消,Linux 整链短片成功;整体结果是失败,不能说全部通过。之后是 2026-10-21T17:25Z(北京时间 10 月 22 日 01:25)针对 626774f 的运行 39643661819:Ubuntu 单测 Ran 267、errors=20、skipped=7,20 处都是缺 ffmpeg / ffprobe;isolated-media 在 playwright install --with-deps chromium 失败(runner 为 ubuntu26.04,Playwright 不支持),整链短片没跑;Windows 单测取消;整体失败。到这一轮为止,10 月 20—22 日 8 次推送全部失败,最近一次成功是 2026-10-10T10:30Z 的 0c25892。最新可查的一轮是北京时间 10 月 22 日 23:11 针对 35a597a 的运行 39802408000,整体失败:isolated-media 卡在 python -m playwright install --with-deps chromium,Ubuntu 单测失败,Windows 单测步骤也失败、任务结论 cancelled;这一轮只读了任务和步骤结论,没取单测失败明细,不能把上一轮的原因搬过来。当前主分支 3c1c117 没有通过记录。以上 11 月 4 日 09:10 用 gh 只读查看,未重跑。
  • 本期影片已于 10 月 11 日 12:43 通过本人审定;现存整片约 18 分钟、1080p 60 帧,但文件存在不等于又审定一次;通用装配入口的真实整片回执、完整视频端到端验证仍是未核对项。
与其他模块的关系

出片模块交出画面轨或可播放副本;本模块负责最终可带走的文件和结构检查,复用模块说明哪些中间结果能继续用。

复制 AI 续作说明

项目:收齐成片、封面、章节和可选字幕,用清单带走已验收的版本;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。