每帧按时间算出来,中断后也不能把新旧画面混在一起
现在
偶尔用
内容按 10 月 11 日 13:57 的提交核对,没有出片、没有测速度
截至 10 月 11 日 · 项目源码和说明文档

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

video-scaffold · 功能说明

每一帧都按视频时间算出来,机器快慢不改动画节奏;中断可从可靠片段接着做,换过的素材不会沿用旧画面。现在有三种出片方式:分镜路线默认 4K60 AV1;图文页默认出 1080p 的 H.264 可播放副本,全机自动排队;独立网页作品能直接按时间求画面,整屏画布还能走显卡快路。第四种是 10 月 22 日加的 docfilm:按全片镜头单分段,默认在显卡上常驻合成、几条线同时渲,段视频用显卡 NVENC 编码;显卡出错就从那段第一帧改用 CPU 重渲;整片终编仍默认用 CPU 的 x264,不是全部改成显卡编码。

当前情况:三种出片方式、片段续作、少帧拒绝和全机排队都在源码里;这次网页核对没有出片,不公布速度、显存或稳定时长。docfilm 的显卡常驻渲染有一次历史整片验收(10 月 23 日,在一部 docfilm 整片上和 CPU 逐帧对照全部过线),只覆盖那部片子用到的镜头、套件和转场。

项目源码:私有仓库

每帧按时间算出来,中断后也不能把新旧画面混在一起
现在
偶尔用
内容按 10 月 11 日 13:57 的提交核对,没有出片、没有测速度
截至 10 月 11 日 · 项目源码和说明文档

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

video-scaffold · 功能说明

每一帧都按视频时间算出来,机器快慢不改动画节奏;中断可从可靠片段接着做,换过的素材不会沿用旧画面。现在有三种出片方式:分镜路线默认 4K60 AV1;图文页默认出 1080p 的 H.264 可播放副本,全机自动排队;独立网页作品能直接按时间求画面,整屏画布还能走显卡快路。第四种是 10 月 22 日加的 docfilm:按全片镜头单分段,默认在显卡上常驻合成、几条线同时渲,段视频用显卡 NVENC 编码;显卡出错就从那段第一帧改用 CPU 重渲;整片终编仍默认用 CPU 的 x264,不是全部改成显卡编码。

当前情况:三种出片方式、片段续作、少帧拒绝和全机排队都在源码里;这次网页核对没有出片,不公布速度、显存或稳定时长。docfilm 的显卡常驻渲染有一次历史整片验收(10 月 23 日,在一部 docfilm 整片上和 CPU 逐帧对照全部过线),只覆盖那部片子用到的镜头、套件和转场。

项目源码:私有仓库

这项功能怎样使用

用途与实际影响

为什么需要它

出片可能中断,也可能遇到编码器正常退出却少帧。只看文件在不在或帧数够不够,认不出同样长度的旧内容;现在既核对片段的来源和输出字节,也数帧,局部更新不必让无关的正确片段全部作废。几个出片任务同时开时,全机排队避免把内存挤爆。长片用 CPU 渲要一两个小时,docfilm 改在显卡上渲快得多;但换了计算设备,就得证明画面和 CPU 渲的一样,所以新套件、新转场第一次用都先和 CPU 逐帧比,显卡出错时自动退回 CPU,不让一次失败毁掉整段。

举个实际例子

我可以说:“昨晚完成了前 20 段,今天继续;但我换了一张图,用过旧图的段必须重做。另一个视频也在出,别两边一起抢内存。”系统识别素材变化,不把新旧画面拼进同一成片;第二个任务按顺序等名额。

做 docfilm 时也可以说:“这期四条线在显卡上渲,显卡出错就退回 CPU 补。”程序在同一张显卡租约下开四个常驻进程,先渲上次最慢的段;某段显卡出错,就从那段第一帧改用 CPU 重渲,并在渲染统计里记下这次退回。

最后我会得到什么

得到核对过长度与来源的画面轨或可播放副本。每个可继续使用的片段保留到我明确清理;有缺帧或来源不明就不拼成成片。

这项功能怎样使用

用途与实际影响

为什么需要它

出片可能中断,也可能遇到编码器正常退出却少帧。只看文件在不在或帧数够不够,认不出同样长度的旧内容;现在既核对片段的来源和输出字节,也数帧,局部更新不必让无关的正确片段全部作废。几个出片任务同时开时,全机排队避免把内存挤爆。长片用 CPU 渲要一两个小时,docfilm 改在显卡上渲快得多;但换了计算设备,就得证明画面和 CPU 渲的一样,所以新套件、新转场第一次用都先和 CPU 逐帧比,显卡出错时自动退回 CPU,不让一次失败毁掉整段。

举个实际例子

我可以说:“昨晚完成了前 20 段,今天继续;但我换了一张图,用过旧图的段必须重做。另一个视频也在出,别两边一起抢内存。”系统识别素材变化,不把新旧画面拼进同一成片;第二个任务按顺序等名额。

做 docfilm 时也可以说:“这期四条线在显卡上渲,显卡出错就退回 CPU 补。”程序在同一张显卡租约下开四个常驻进程,先渲上次最慢的段;某段显卡出错,就从那段第一帧改用 CPU 重渲,并在渲染统计里记下这次退回。

最后我会得到什么

得到核对过长度与来源的画面轨或可播放副本。每个可继续使用的片段保留到我明确清理;有缺帧或来源不明就不拼成成片。

结果怎么看
正常时

全部片段属于当前脚本与素材,帧数完整,再拼成画面轨或可播放副本。

发现问题时

一段失败可重试;某页或某场变化只重做受影响的片段,公共背景或模板变化会影响更多片段。

入口不可用或证据不足时

素材、背景、浏览器或编码器不可用,旧的错误片段没法确认已移进回收站,或颜色信息不明时停止,不拼不可信的画面。

结果怎么看
正常时

全部片段属于当前脚本与素材,帧数完整,再拼成画面轨或可播放副本。

发现问题时

一段失败可重试;某页或某场变化只重做受影响的片段,公共背景或模板变化会影响更多片段。

入口不可用或证据不足时

素材、背景、浏览器或编码器不可用,旧的错误片段没法确认已移进回收站,或颜色信息不明时停止,不拼不可信的画面。

从哪里开始

分镜路线:预览确认后在视频工程运行 run.ps1 render。图文页:python -m pipeline.pages <表.json> render,会自动排队。独立网页作品:webfilm/run.ps1 render <作品目录>,默认 4K60、20 秒。

docfilm:先设 $env:DOCFILM_DEVICE = "resident",再跑 python -X utf8 -m docfilm.assemble render-stale <分段表.json> --lanes 4(只渲没有视频或指纹失效的段;加 --cpu-fallback 时,显卡没渲成的段最后用 CPU 补)。不设这个开关就是原来的 CPU 多进程渲染。正式出片一般直接用一条命令 release,它内部调用同一套渲染。

需要准备什么
  • 已确认可出片的工程、分镜表或网页作品
  • 输出目标
  • docfilm 另要镜头单生成的分段表,以及带 CuPy 的 Python 环境(只用 CPU 时不需要)
从开始到拿到结果
1锁定本次输入
按画面、素材和时长计算身份、帧数与分段。
2逐段生成和复用
只复用身份和输出字节都匹配的片段;中断后重做缺失或受影响的片段。
3核对整轨
拼接后比对总帧与来源;没有完整跑过本片时,不声称成片已通过。
从哪里开始

分镜路线:预览确认后在视频工程运行 run.ps1 render。图文页:python -m pipeline.pages <表.json> render,会自动排队。独立网页作品:webfilm/run.ps1 render <作品目录>,默认 4K60、20 秒。

docfilm:先设 $env:DOCFILM_DEVICE = "resident",再跑 python -X utf8 -m docfilm.assemble render-stale <分段表.json> --lanes 4(只渲没有视频或指纹失效的段;加 --cpu-fallback 时,显卡没渲成的段最后用 CPU 补)。不设这个开关就是原来的 CPU 多进程渲染。正式出片一般直接用一条命令 release,它内部调用同一套渲染。

需要准备什么
  • 已确认可出片的工程、分镜表或网页作品
  • 输出目标
  • docfilm 另要镜头单生成的分段表,以及带 CuPy 的 Python 环境(只用 CPU 时不需要)
从开始到拿到结果
1锁定本次输入
按画面、素材和时长计算身份、帧数与分段。
2逐段生成和复用
只复用身份和输出字节都匹配的片段;中断后重做缺失或受影响的片段。
3核对整轨
拼接后比对总帧与来源;没有完整跑过本片时,不声称成片已通过。
技术实现与依据(一)

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

三种出片方式、片段来源与输出哈希、少帧保护和全机排队已在源码中;本次未做任何编码(内容截止北京时间 2026-10-11 14:00,提交 cc41e514);docfilm 渲染按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 的源码和说明补读,这次也没有渲染

关键规则与设计选择
1
分镜路线的 video_track.mp4 设计上无声,声音在合成后的 final_output.mp4;图文页的可播放副本直接带原配音和字幕。分镜路线的 4K60 AV1 设置不套用到图文页和网页作品。
2
静态 doctor 不证明编码可用;单次短片也不证明所有长时间出片稳定。
3
片段身份保护同一项目续作,不是跨项目缓存或通用媒体数据库;全机排队管同时出片的人数和内存,显卡租约管显卡编码,两者不是一回事,也不会暂停或终止别人的任务。
4
docfilm 的段视频默认用显卡常驻合成和高质量 NVENC(固定 QP1,文件明显变大);整片终编默认仍是 CPU 的 x264:一条命令出片默认质量值 CRF14,直接合成默认 slow、CRF16。能选显卡终编,但 10 月 29 日恢复默认前,一部约 8 分半的片子实测,显卡整片终编 689 / 758 秒,x264 675 秒,文件还大 1.46 倍,没有提速,所以默认没换。
当前怎样实现
  • build_timeline 按时长累加全局起止时间,seekTime 接收当前场景内的相对秒数。
  • 分镜路线:3840×2160、60fps,av1_nvenc(p6/hq/constqp、CQ22、lookahead 32、yuv420p10le);每段最多 300 帧,每路最多缓存 6 个页面,失败最多重试 2 次(共 3 次尝试)。背景循环并按起点裁切,前景叠加后可加暗角和颗粒。
  • 图文页:坐标仍按 3840×2160,捕获高度只支持 1080 或 2160,浏览器整体缩放不改构图;旧表未填时默认 2160,新开场模板已填 1080。默认用 CPU 的 libx264(medium、质量值 12、yuv420p),关闭胶片效果,最后给 H.264/AAC 的 1080p 可播放副本。
  • 图文页出片路数自动选 1—4 路:参考可用内存、留 14 GiB 余量、全机 2 个名额、每路估 3 GiB;VIDEO_RENDER_WORKERS 可手动指定。这是资源估计,不保证别的程序不占内存。
  • 全机排队:图文页 render 和 stills 内置先来先出队列,旧的 python -m pipeline.render_queue -- <命令> 仍兼容,嵌套调用借用同一名额。默认最多 2 个出片任务同时跑;已有任务在跑时,新任务需要至少 14 GiB 可用内存,没人在跑时先放行一个。队列目录固定在本机,用系统锁判断谁还活着,进程退出名额就作废;票号、到达、放行、等待、内存和路数都写日志。
  • docfilm:一个专用 spawn 进程持有全部 CUDA 对象(CuPy),机位取样、视差、运动模糊、缩图、字幕衬底与叠放都在显存里以 float32 算,最后的 RGB24 经两份锁页缓冲异步拷回,交独立编码线程喂给 h264_nvenc(yuv420p、BT.709);父进程只协调、收统计,不传逐帧图像。
技术实现与依据(一)

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

三种出片方式、片段来源与输出哈希、少帧保护和全机排队已在源码中;本次未做任何编码(内容截止北京时间 2026-10-11 14:00,提交 cc41e514);docfilm 渲染按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 的源码和说明补读,这次也没有渲染

关键规则与设计选择
1
分镜路线的 video_track.mp4 设计上无声,声音在合成后的 final_output.mp4;图文页的可播放副本直接带原配音和字幕。分镜路线的 4K60 AV1 设置不套用到图文页和网页作品。
2
静态 doctor 不证明编码可用;单次短片也不证明所有长时间出片稳定。
3
片段身份保护同一项目续作,不是跨项目缓存或通用媒体数据库;全机排队管同时出片的人数和内存,显卡租约管显卡编码,两者不是一回事,也不会暂停或终止别人的任务。
4
docfilm 的段视频默认用显卡常驻合成和高质量 NVENC(固定 QP1,文件明显变大);整片终编默认仍是 CPU 的 x264:一条命令出片默认质量值 CRF14,直接合成默认 slow、CRF16。能选显卡终编,但 10 月 29 日恢复默认前,一部约 8 分半的片子实测,显卡整片终编 689 / 758 秒,x264 675 秒,文件还大 1.46 倍,没有提速,所以默认没换。
当前怎样实现
  • build_timeline 按时长累加全局起止时间,seekTime 接收当前场景内的相对秒数。
  • 分镜路线:3840×2160、60fps,av1_nvenc(p6/hq/constqp、CQ22、lookahead 32、yuv420p10le);每段最多 300 帧,每路最多缓存 6 个页面,失败最多重试 2 次(共 3 次尝试)。背景循环并按起点裁切,前景叠加后可加暗角和颗粒。
  • 图文页:坐标仍按 3840×2160,捕获高度只支持 1080 或 2160,浏览器整体缩放不改构图;旧表未填时默认 2160,新开场模板已填 1080。默认用 CPU 的 libx264(medium、质量值 12、yuv420p),关闭胶片效果,最后给 H.264/AAC 的 1080p 可播放副本。
  • 图文页出片路数自动选 1—4 路:参考可用内存、留 14 GiB 余量、全机 2 个名额、每路估 3 GiB;VIDEO_RENDER_WORKERS 可手动指定。这是资源估计,不保证别的程序不占内存。
  • 全机排队:图文页 render 和 stills 内置先来先出队列,旧的 python -m pipeline.render_queue -- <命令> 仍兼容,嵌套调用借用同一名额。默认最多 2 个出片任务同时跑;已有任务在跑时,新任务需要至少 14 GiB 可用内存,没人在跑时先放行一个。队列目录固定在本机,用系统锁判断谁还活着,进程退出名额就作废;票号、到达、放行、等待、内存和路数都写日志。
  • docfilm:一个专用 spawn 进程持有全部 CUDA 对象(CuPy),机位取样、视差、运动模糊、缩图、字幕衬底与叠放都在显存里以 float32 算,最后的 RGB24 经两份锁页缓冲异步拷回,交独立编码线程喂给 h264_nvenc(yuv420p、BT.709);父进程只协调、收统计,不传逐帧图像。
技术实现与依据(二)
1
读取画面、时长与背景;图文页先领出片名额。
  • 显卡协调保留:登记在本机 127.0.0.1:32100,租约 120 秒,约 40 秒续一次。docfilm 的显卡渲染也走这张租约:正常或失败都等显卡进程和编码进程退出后才还,显存和锁页内存由操作系统回收。
  • _render_identity.json 绑定场景 HTML、其中素材、时长、背景 SHA、画布、转场、成片效果、编码参数与实际分段边界;复用前逐段回验来源和输出哈希,再用 ffprobe 数帧。
  • 陈旧的受管片段、身份记录和拼接列表改为移进回收站,失败或有残留就不更新身份、不继续拼接,不降级成永久删除;编码先暂存,验证完整后才接受,成功片段保留到明确清理。
  • docfilm 显卡出错或 NVENC 失败时,重新载入镜头模块,从那段首帧用单进程 CPU / x264 重渲;统计分开记 fallback、实际显卡帧数和显卡进程是否已退出,显卡帧数等于请求帧数才算完整显卡渲染。排查时设 DOCFILM_RESIDENT_STRICT=1,出错直接停、报原错误,不让回退掩盖故障。
  • docfilm 多线:--lanes N 在一张租约下开 N 个常驻进程,每条线约占 6—7 GB 显存,渲完一段取下一段,按上次实际用时从长到短开渲;某段镜头代码报错只记那一段,显卡本身出错或租约丢了就不再开新段。CPU 渲染开第一个、再加进程、收缩和暂停都按本机内存守护的登记线算,内存紧就少开进程,快满才暂停,不绕开守护。
  • 网页作品:render(t) 在 Canvas、SVG、WebGL 或网页元素上按绝对时间求帧,声音用 audio(ctx) 从 0 秒排好全部音符;默认 4K60、20 秒、上限 120 秒,可明示 1080p 或更高上限;输出名已存在就拒绝覆盖。普通网页抓取是附加路线,不承诺任意网页都能做到确定性。
  • 网页作品显卡快路:完整全屏的 Canvas2D/WebGL 请求浏览器硬件编码(质量优先、120Mbps),最终用 h264_nvenc(p7/hq、QP10、High 5.2、无 B 帧、yuv420p);可见的网页元素、交互光标或无法确认完整画面时继续 PNG 截图,--renderer png 用 x264 fast CRF18,显式 --renderer webcodecs 不满足条件就失败。快路先读颜色信息,按实际范围转成 BT.709 有限范围,颜色不明就拒绝;.webfilm-cache 存完整成功的段,每段最长 2 秒,按声明的场景边界切;默认只抽首、中、末帧核对,--verify-frames 才全部核对。
执行流程
技术实现与依据(二)
1
读取画面、时长与背景;图文页先领出片名额。
  • 显卡协调保留:登记在本机 127.0.0.1:32100,租约 120 秒,约 40 秒续一次。docfilm 的显卡渲染也走这张租约:正常或失败都等显卡进程和编码进程退出后才还,显存和锁页内存由操作系统回收。
  • _render_identity.json 绑定场景 HTML、其中素材、时长、背景 SHA、画布、转场、成片效果、编码参数与实际分段边界;复用前逐段回验来源和输出哈希,再用 ffprobe 数帧。
  • 陈旧的受管片段、身份记录和拼接列表改为移进回收站,失败或有残留就不更新身份、不继续拼接,不降级成永久删除;编码先暂存,验证完整后才接受,成功片段保留到明确清理。
  • docfilm 显卡出错或 NVENC 失败时,重新载入镜头模块,从那段首帧用单进程 CPU / x264 重渲;统计分开记 fallback、实际显卡帧数和显卡进程是否已退出,显卡帧数等于请求帧数才算完整显卡渲染。排查时设 DOCFILM_RESIDENT_STRICT=1,出错直接停、报原错误,不让回退掩盖故障。
  • docfilm 多线:--lanes N 在一张租约下开 N 个常驻进程,每条线约占 6—7 GB 显存,渲完一段取下一段,按上次实际用时从长到短开渲;某段镜头代码报错只记那一段,显卡本身出错或租约丢了就不再开新段。CPU 渲染开第一个、再加进程、收缩和暂停都按本机内存守护的登记线算,内存紧就少开进程,快满才暂停,不绕开守护。
  • 网页作品:render(t) 在 Canvas、SVG、WebGL 或网页元素上按绝对时间求帧,声音用 audio(ctx) 从 0 秒排好全部音符;默认 4K60、20 秒、上限 120 秒,可明示 1080p 或更高上限;输出名已存在就拒绝覆盖。普通网页抓取是附加路线,不承诺任意网页都能做到确定性。
  • 网页作品显卡快路:完整全屏的 Canvas2D/WebGL 请求浏览器硬件编码(质量优先、120Mbps),最终用 h264_nvenc(p7/hq、QP10、High 5.2、无 B 帧、yuv420p);可见的网页元素、交互光标或无法确认完整画面时继续 PNG 截图,--renderer png 用 x264 fast CRF18,显式 --renderer webcodecs 不满足条件就失败。快路先读颜色信息,按实际范围转成 BT.709 有限范围,颜色不明就拒绝;.webfilm-cache 存完整成功的段,每段最长 2 秒,按声明的场景边界切;默认只抽首、中、末帧核对,--verify-frames 才全部核对。
执行流程
技术实现与依据(三)
2
计算总帧、分段边界和完整输入身份。
3
逐段核对输入、输出哈希和帧数,不因同名或同长度就复用。
4
多路只处理缺失或错误的片段;docfilm 显卡出错的段从首帧改用 CPU 重渲。
5
全部正确后无损拼接并核对整轨总帧。
6
保留已验证的片段和画面轨,直到明确清理;不是成功后立即丢掉全部可复用成果。
技术实现与依据(三)
2
计算总帧、分段边界和完整输入身份。
3
逐段核对输入、输出哈希和帧数,不因同名或同长度就复用。
4
多路只处理缺失或错误的片段;docfilm 显卡出错的段从首帧改用 CPU 重渲。
5
全部正确后无损拼接并核对整轨总帧。
6
保留已验证的片段和画面轨,直到明确清理;不是成功后立即丢掉全部可复用成果。
名词和入口
本模块用到的名词
名词意思
chunk(渲染分片)一段固定帧范围的临时视频;它覆盖的输入、输出字节与帧数都匹配才可复用。
deterministic(确定性)同一画面在同一 t 秒按同一规则求状态,不依赖当时浏览器跑了多久。
AV1(视频编码格式)分镜路线的硬件编码格式;图文页和网页作品快路用的是 H.264,不能都叫 AV1。4K60 单帧可用不等于整条长视频已验收。
专业定义

出片速度不改动画时间;只重做受影响的画面,但每段都必须证明来源正确。

解决什么

防止出片速度影响动画时间、显卡少帧造成持续音画漂移、中断恢复把旧内容混进新版本,以及几个任务同时出片把内存挤爆。

名词和入口
本模块用到的名词
名词意思
chunk(渲染分片)
意思:
一段固定帧范围的临时视频;它覆盖的输入、输出字节与帧数都匹配才可复用。
deterministic(确定性)
意思:
同一画面在同一 t 秒按同一规则求状态,不依赖当时浏览器跑了多久。
AV1(视频编码格式)
意思:
分镜路线的硬件编码格式;图文页和网页作品快路用的是 H.264,不能都叫 AV1。4K60 单帧可用不等于整条长视频已验收。
专业定义

出片速度不改动画时间;只重做受影响的画面,但每段都必须证明来源正确。

解决什么

防止出片速度影响动画时间、显卡少帧造成持续音画漂移、中断恢复把旧内容混进新版本,以及几个任务同时出片把内存挤爆。

出问题时
边界
  • 这次网页核对没有出片,不公布整片速度、显存峰值或稳定时长;本期影片已审定、网页作品 2026-10-04 彩排里 20 秒/1200 帧两次一致,都不能证明新快路、长视频或所有编码分支已验收。docfilm 显卡常驻 10 月 23 日的整片对照只覆盖那部片子用到的镜头、套件和转场;新套件、新转场第一次用仍要先抽帧和 CPU 对照(线是 PSNR 45 dB、SSIM 0.995)。
  • 背景可以循环覆盖任意时长,但接缝是否看不出仍需实际看。
  • 同一路径素材的字节受身份保护;网页作品漏报跨场景的文件依赖时,程序无法证明局部复用正确。
失败与恢复
情况
怎么处理
片段少帧或 FFmpeg 非零退出
把该段移进回收站并有限次重试;仍失败就停止整轨拼接。
输入身份变化
只作废受该输入影响的片段,公共背景或编码变更可能影响全部;不把陈旧内容拼进新成片。
陈旧片段没能确认移进回收站,或素材缺失
直接失败并列出问题文件,不先写新身份掩盖旧文件。
docfilm 显卡出错或 NVENC 失败
等显卡进程退出、还租约,从那段首帧改用单进程 CPU / x264 重渲;统计里 fallback 不为空就要查原因。
docfilm 多线时显存不够或租约丢了
不再开新段,在渲的渲完;带 --cpu-fallback 时没渲成的段最后用 CPU 一段段补。
渲染时可用内存变紧
CPU 渲染关掉最新的进程、把它手上的帧重发,只剩一个进程且快满时才暂停;连续 10 分钟一个进程都开不起来才报错。
出问题时
边界
  • 这次网页核对没有出片,不公布整片速度、显存峰值或稳定时长;本期影片已审定、网页作品 2026-10-04 彩排里 20 秒/1200 帧两次一致,都不能证明新快路、长视频或所有编码分支已验收。docfilm 显卡常驻 10 月 23 日的整片对照只覆盖那部片子用到的镜头、套件和转场;新套件、新转场第一次用仍要先抽帧和 CPU 对照(线是 PSNR 45 dB、SSIM 0.995)。
  • 背景可以循环覆盖任意时长,但接缝是否看不出仍需实际看。
  • 同一路径素材的字节受身份保护;网页作品漏报跨场景的文件依赖时,程序无法证明局部复用正确。
失败与恢复
情况
怎么处理
片段少帧或 FFmpeg 非零退出
把该段移进回收站并有限次重试;仍失败就停止整轨拼接。
输入身份变化
只作废受该输入影响的片段,公共背景或编码变更可能影响全部;不把陈旧内容拼进新成片。
陈旧片段没能确认移进回收站,或素材缺失
直接失败并列出问题文件,不先写新身份掩盖旧文件。
docfilm 显卡出错或 NVENC 失败
等显卡进程退出、还租约,从那段首帧改用单进程 CPU / x264 重渲;统计里 fallback 不为空就要查原因。
docfilm 多线时显存不够或租约丢了
不再开新段,在渲的渲完;带 --cpu-fallback 时没渲成的段最后用 CPU 一段段补。
渲染时可用内存变紧
CPU 渲染关掉最新的进程、把它手上的帧重发,只剩一个进程且快满时才暂停;连续 10 分钟一个进程都开不起来才报错。
依据与来源
真实入口
  • 时间线、逐帧抓取、分片、身份、重试与帧数验证
  • seekTime(t) 画面状态
  • 当前 4K60 AV1 背景资产
如何验证
  • 2026-09-03 历史回归验证旧身份保护,之后未重新运行;cc41e514 源码共有 216 个测试定义,这次没有运行,也没有做整轨制作。
  • 2026-10-23 docfilm 显卡常驻整片验收(历史结果,这次没有重跑):一部 docfilm 片子 26233 帧(含接缝把手)逐段用显卡常驻和 NVENC 渲完、严格模式下没有退回 CPU;其中片头到正文第 9 段显卡用 1561 秒(片尾另用 58 秒),同样这些段当初 CPU 16 进程合计约 5280 秒;抽 6051 帧和 CPU 原实现逐帧比,最低 PSNR 47.92 dB、SSIM 0.99580,全部过线;拼成整片后 9 处连续接缝最低 49.97 dB。验收中修了两处显卡和 CPU 不一致的地方。
  • 2026-09-18 的静态 doctor 只确认协调登记,不调用 NVENC;2026-09-03 单帧编码结果保留历史日期,不升级为现在通过。
  • 网页作品 2026-10-04 彩排的 20 秒/1200 帧重复渲染一致回执只覆盖那台机器那段样片;这次只重读回执,没有重播或重核哈希。
与其他模块的关系

本模块产出画面轨或可播放副本;交付模块负责把旁白、音乐、封面和章节合入并做结构验收,图文页的分段整片也在那里装配。

依据与来源
真实入口
  • 时间线、逐帧抓取、分片、身份、重试与帧数验证
  • seekTime(t) 画面状态
  • 当前 4K60 AV1 背景资产
如何验证
  • 2026-09-03 历史回归验证旧身份保护,之后未重新运行;cc41e514 源码共有 216 个测试定义,这次没有运行,也没有做整轨制作。
  • 2026-10-23 docfilm 显卡常驻整片验收(历史结果,这次没有重跑):一部 docfilm 片子 26233 帧(含接缝把手)逐段用显卡常驻和 NVENC 渲完、严格模式下没有退回 CPU;其中片头到正文第 9 段显卡用 1561 秒(片尾另用 58 秒),同样这些段当初 CPU 16 进程合计约 5280 秒;抽 6051 帧和 CPU 原实现逐帧比,最低 PSNR 47.92 dB、SSIM 0.99580,全部过线;拼成整片后 9 处连续接缝最低 49.97 dB。验收中修了两处显卡和 CPU 不一致的地方。
  • 2026-09-18 的静态 doctor 只确认协调登记,不调用 NVENC;2026-09-03 单帧编码结果保留历史日期,不升级为现在通过。
  • 网页作品 2026-10-04 彩排的 20 秒/1200 帧重复渲染一致回执只覆盖那台机器那段样片;这次只重读回执,没有重播或重核哈希。
与其他模块的关系

本模块产出画面轨或可播放副本;交付模块负责把旁白、音乐、封面和章节合入并做结构验收,图文页的分段整片也在那里装配。

复制 AI 续作说明

项目:每帧按时间算出来,中断后也不能把新旧画面混在一起;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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