

video-scaffold · 功能说明
交付现在有三种形式。分镜路线把无声画面轨和旁白合成,按需压入背景音乐,再出封面、章节、可选字幕和交付清单;图文页直接出一份带原配音、逐字出现字幕的 1080p 可播放副本,多段还能装配成整片并自动生成章节;独立网页作品有回看包、后期合成、封面和本地展示目录。最后的检查读取真实媒体流和尺寸,不只看文件名。第四种是 docfilm 的一条命令出片(release):从多音字检查、只渲过期的段、合成整片,到出片前文字检查、成片画面和声音检查、实际成片的字幕逐字对稿、片尾、每镜三帧联系表、和上一版比差异、按镜头截配图,任何一步失败就停在待验目录,全部通过才成为终版。它自带的成片检查默认只看画面和声音,识字(OCR)和语音对稿(ASR)是另跑的检查。
当前情况:本期影片《电子雪貂饲养员》已于 10 月 11 日 12:43 通过本人审定;分段装配等新入口这次没有找到真实整片的装配回执,网页核对本身也没有出片或观看。docfilm 的一条命令出片 10 月 29 日才合进主线,这次只读了源码和说明,没有跑过,不能说已实测通过。
项目源码:私有仓库

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:\;要在显卡上渲,先设 $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/ 写,表里列本版全部镜头,可以写成一行:| 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 另要分段表、配音配置和这一版的改动单(第一版也要,表里列全部镜头)


分镜路线:出片后按需运行 merge、cover、chapters、subtitles,最后 verify 和 manifest(清单)。图文页:pages render 直接给可播放副本,多段用 python -m pipeline.pages assemble <拼接表.json> --plan 先看计划,去掉 --plan 实际拼片。独立网页作品用 webfilm 的 review、compose、cover、package。最后都要实际观看。
docfilm:在项目根目录运行,python 用登记的 E:\;要在显卡上渲,先设 $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/ 写,表里列本版全部镜头,可以写成一行:| 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 另要分段表、配音配置和这一版的改动单(第一版也要,表里列全部镜头)


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


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 日),也没有实际跑过


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)。

- 装配时检测每段片尾静音,非末段保留到念完后约 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生成本地静态展示目录,不部署网站。


- 装配时检测每段片尾静音,非末段保留到念完后约 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生成本地静态展示目录,不部署网站。





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

结构通过后才生成交付清单或装配回执;字幕按需导出,READY 后仍要真人观看。
解决什么
防止把无声画面轨、尺寸正确的空封面、或有文件没内容的交付包误认为本期完成。



结构通过后才生成交付清单或装配回执;字幕按需导出,READY 后仍要真人观看。
解决什么
防止把无声画面轨、尺寸正确的空封面、或有文件没内容的交付包误认为本期完成。

- 字幕、哈希清单和装配回执都已实现;上传和平台回执仍不属于这个工具。docfilm 出片 10 月 29 日合进主线,这次只读源码和说明,没有实际跑过;它默认不跑识字和语音对稿,影片“发布了几期”这次也没有取得平台回执,仍是未核对。整句、说话人字幕和硬切是 10 月 21 日新加的输出方式,只在自动测试里跑过,还没有用它们出过并核验过的真实成片,也没有新的投稿记录。
- 封面主图是可选设计输入,尺寸通过不代表主图或标题内容优质。
- 本期影片已审定,用的是图文页的输出形式,不必叫 final_output 才算作品;15:08 补了一份通用装配的拼接表,但它指定的整片并不存在,通用装配入口仍没有真实整片的装配回执,不能拿本期旧方式拼出的成片冒充新入口已实跑验收。
--changes--waive-text 问题ID=理由 放行,没有批量放行,也不沿用上轮放行。--no-endcard 和非空理由,记进清单;否则片尾那一步报错。
- 字幕、哈希清单和装配回执都已实现;上传和平台回执仍不属于这个工具。docfilm 出片 10 月 29 日合进主线,这次只读源码和说明,没有实际跑过;它默认不跑识字和语音对稿,影片“发布了几期”这次也没有取得平台回执,仍是未核对。整句、说话人字幕和硬切是 10 月 21 日新加的输出方式,只在自动测试里跑过,还没有用它们出过并核验过的真实成片,也没有新的投稿记录。
- 封面主图是可选设计输入,尺寸通过不代表主图或标题内容优质。
- 本期影片已审定,用的是图文页的输出形式,不必叫 final_output 才算作品;15:08 补了一份通用装配的拼接表,但它指定的整片并不存在,通用装配入口仍没有真实整片的装配回执,不能拿本期旧方式拼出的成片冒充新入口已实跑验收。
--changes--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。







