先复制一个干净项目,再判断环境能不能开始
现在
偶尔用
内容按 10 月 11 日 15:09 的提交核对,没有重新出片
截至 10 月 11 日 · 项目源码和说明文档

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

video-scaffold · 功能说明

开始新视频时,我得到一个空白但能检查状态的起点,不会带上上一期的脚本和成片。讲解视频现在默认从“图文页影片目录”开工:建好目录就能接上本期已经定稿的配音、原文和词级时间;需要时还能先出一段约 6 秒的试片,确认整条路是通的。原来的逐场分镜工程和环境体检照旧保留,独立网页作品另有自己的入口。这段“默认从图文页开工”是 10 月 11 日到 29 日的做法:现在每一期先想这期画面和配音怎么做最好,再决定从哪套工具开工,可以混用。docfilm(实拍感纪实画面)没有建目录的命令:在本期目录里备好配音配置和定稿,写一份全片镜头单,从“多音字检查 → 合成配音 → 镜头单检查”开工。

当前情况:图文页开工、版式一览、分镜工程初始化和环境体检都在源码里;这次网页核对只读了源码,没有运行体检、没有出片。docfilm 的开工入口按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 的说明补读,同样没有运行。

项目源码:私有仓库

先复制一个干净项目,再判断环境能不能开始
现在
偶尔用
内容按 10 月 11 日 15:09 的提交核对,没有重新出片
截至 10 月 11 日 · 项目源码和说明文档

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

video-scaffold · 功能说明

开始新视频时,我得到一个空白但能检查状态的起点,不会带上上一期的脚本和成片。讲解视频现在默认从“图文页影片目录”开工:建好目录就能接上本期已经定稿的配音、原文和词级时间;需要时还能先出一段约 6 秒的试片,确认整条路是通的。原来的逐场分镜工程和环境体检照旧保留,独立网页作品另有自己的入口。这段“默认从图文页开工”是 10 月 11 日到 29 日的做法:现在每一期先想这期画面和配音怎么做最好,再决定从哪套工具开工,可以混用。docfilm(实拍感纪实画面)没有建目录的命令:在本期目录里备好配音配置和定稿,写一份全片镜头单,从“多音字检查 → 合成配音 → 镜头单检查”开工。

当前情况:图文页开工、版式一览、分镜工程初始化和环境体检都在源码里;这次网页核对只读了源码,没有运行体检、没有出片。docfilm 的开工入口按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 的说明补读,同样没有运行。

项目源码:私有仓库

这项功能怎样使用

用途与实际影响

为什么需要它

旧项目残留会把素材、标题和输出混进新一期;环境缺一环又可能在长时间出片时才暴露。开工命令只建通用目录和样例,体检只回答“这台电脑现在具备什么条件”,两者把“项目干净”和“环境能跑”分开验证。工具多了以后,开工前还多一步:先想清这期用哪套、混不混用,免得因为某套最近用得多就默认选它,做到一半才发现画面或配音不对路。

举个实际例子

我可以说:“给这一期建一个新影片目录,带个试片看看能不能出画面,别带上一期的东西。”系统建好目录,用合成的测试声音做出约 6 秒试片;目标目录里已有内容时直接停下,不为省事覆盖。

如果这期要实拍感纪实画面,我可以说:“这期用 docfilm,先查一遍旁白里的多音字,再出镜头单。”AI 在本期目录里备好配音配置和镜头单,先跑只读的多音字检查和镜头单检查,不复制上一期的镜头单、素材或成片。

最后我会得到什么

得到一个不带旧作品内容的影片目录,里面有放分镜表、图片、配音和素材的位置,以及一张开场样例表;加了试片选项还会有一段短视频。试片里的文字、图形和声音都是演示材料,不是本期内容。

这项功能怎样使用

用途与实际影响

为什么需要它

旧项目残留会把素材、标题和输出混进新一期;环境缺一环又可能在长时间出片时才暴露。开工命令只建通用目录和样例,体检只回答“这台电脑现在具备什么条件”,两者把“项目干净”和“环境能跑”分开验证。工具多了以后,开工前还多一步:先想清这期用哪套、混不混用,免得因为某套最近用得多就默认选它,做到一半才发现画面或配音不对路。

举个实际例子

我可以说:“给这一期建一个新影片目录,带个试片看看能不能出画面,别带上一期的东西。”系统建好目录,用合成的测试声音做出约 6 秒试片;目标目录里已有内容时直接停下,不为省事覆盖。

如果这期要实拍感纪实画面,我可以说:“这期用 docfilm,先查一遍旁白里的多音字,再出镜头单。”AI 在本期目录里备好配音配置和镜头单,先跑只读的多音字检查和镜头单检查,不复制上一期的镜头单、素材或成片。

最后我会得到什么

得到一个不带旧作品内容的影片目录,里面有放分镜表、图片、配音和素材的位置,以及一张开场样例表;加了试片选项还会有一段短视频。试片里的文字、图形和声音都是演示材料,不是本期内容。

结果怎么看
正常时

目录结构完整,样例表能读;选了试片就得到一段约 6 秒的可播放视频。正式制作时把样例换成本期真实的原文、音频和词级时间。

发现问题时

显卡正被其他重活占用时,只有明确选择的出片或本地探针会报告忙碌;普通的建目录和状态检查不抢资源。

入口不可用或证据不足时

目标目录不空或必要工具缺失时停止并点名问题,不覆盖旧文件,也不自动调用收费的配音服务。

结果怎么看
正常时

目录结构完整,样例表能读;选了试片就得到一段约 6 秒的可播放视频。正式制作时把样例换成本期真实的原文、音频和词级时间。

发现问题时

显卡正被其他重活占用时,只有明确选择的出片或本地探针会报告忙碌;普通的建目录和状态检查不抢资源。

入口不可用或证据不足时

目标目录不空或必要工具缺失时停止并点名问题,不覆盖旧文件,也不自动调用收费的配音服务。

从哪里开始

讲解视频用 python -m pipeline.pages init <空影片目录> 开工,加 --render 会顺带做一段试片;想先看全部版式,用 python -m pipeline.pages atlas <空目录> --render。原来的逐场分镜工程仍从 run.ps1 init 建,再运行 run.ps1 doctor 体检;独立网页作品从 webfilm/run.ps1 进入。用哪套先按这期画面和配音判断,不按片子类型定默认。docfilm 不用 init:在本期目录放配音配置和全片镜头单,先跑 python -X utf8 docfilm/narrate.py --check-polyphones <配音配置.json>(只读,不取密钥、不调配音),再合成配音,然后跑 python -X utf8 docfilm/shotlist.py check <镜头单.json>。

需要准备什么
  • 新影片的空目录
  • 本期已定稿的配音、原文和词级时间(开工后再放进去也可以)
  • 用 docfilm 时:本期配音配置(字幕原文和可选的合成念法)、定稿文案、底板和截图素材;要在显卡上渲,另备带 CuPy 的 Python 环境
从开始到拿到结果
1建影片目录
开工命令只建通用目录、开场样例表和说明,不代写标题、旁白或镜头。开工前先定这期用哪套工具;用 docfilm 时这一步换成在本期目录放配音配置和镜头单。
2按需出试片
加 --render 用合成测试声音做约 6 秒试片,确认出片链路能走通;不加就只建目录,不出片。
3换上本期材料
把样例换成本期真实的配音、原文和词级时间,再进入分镜表制作;分镜工程路线另跑 doctor 看依赖缺口。
从哪里开始

讲解视频用 python -m pipeline.pages init <空影片目录> 开工,加 --render 会顺带做一段试片;想先看全部版式,用 python -m pipeline.pages atlas <空目录> --render。原来的逐场分镜工程仍从 run.ps1 init 建,再运行 run.ps1 doctor 体检;独立网页作品从 webfilm/run.ps1 进入。用哪套先按这期画面和配音判断,不按片子类型定默认。docfilm 不用 init:在本期目录放配音配置和全片镜头单,先跑 python -X utf8 docfilm/narrate.py --check-polyphones <配音配置.json>(只读,不取密钥、不调配音),再合成配音,然后跑 python -X utf8 docfilm/shotlist.py check <镜头单.json>。

需要准备什么
  • 新影片的空目录
  • 本期已定稿的配音、原文和词级时间(开工后再放进去也可以)
  • 用 docfilm 时:本期配音配置(字幕原文和可选的合成念法)、定稿文案、底板和截图素材;要在显卡上渲,另备带 CuPy 的 Python 环境
从开始到拿到结果
1建影片目录
开工命令只建通用目录、开场样例表和说明,不代写标题、旁白或镜头。开工前先定这期用哪套工具;用 docfilm 时这一步换成在本期目录放配音配置和镜头单。
2按需出试片
加 --render 用合成测试声音做约 6 秒试片,确认出片链路能走通;不加就只建目录,不出片。
3换上本期材料
把样例换成本期真实的配音、原文和词级时间,再进入分镜表制作;分镜工程路线另跑 doctor 看依赖缺口。
技术实现与依据(一)

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

图文页开工、69 页版式一览、分镜工程初始化与静态体检已在源码中;本次未运行(内容截止北京时间 2026-10-11 14:00,提交 cc41e514);“每期先选工具”和 docfilm 开工入口按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 补读,也没有运行

关键规则与设计选择
1
图文页开工建的是影片内容目录;run.ps1 init 建的是独立的分镜工具工作区,两者复制范围不同,都不复制上一期脚本、音频、成片或本机适配文件。docfilm 没有初始化命令,本期的配音配置、镜头单和素材都放在本期目录,不进通用源码;本期的战略稿也不随 init 复制。
2
试片的声音和词级时间是合成测试材料,只证明链路能走通,不能当本期内容或已审定作品。
3
doctor 只看静态环境,doctor-live 才实际请求云端配音;环境就绪不能替代脚本、画面、成片和人工观看。docfilm 的多音字检查同样只读:不取密钥、不调配音、不建输出目录,退出码 0 表示没有待看项、2 表示有、1 表示配置或依赖出错。
4
四套工具(docfilm、图文页、网页成片、分镜配音)不分主次,也没有“哪类视频走哪条路”;每期先判断画面和配音怎么做最好,可单用、混用或为这期现写。图文页主题默认白底绿,但这期用不用图文页照这一条判断。
当前怎样实现
  • pipeline.pages init 拒绝非空目标,建立 pages、art、narration、assets、_samples/checkpoint、README 和一张 intro 分镜表;--render 用约 6 秒的合成测试音实际出片。新 intro 模板默认按 1080 高度捕获。
  • pipeline.pages atlas 生成含 69 页的版式一览分镜表和测试音,实际出片时另产每秒联系表。69 是模板页数,不是 69 种互相独立的动画,也不是这次已产出的截图数。
  • init_project.py 仍先暂存完整通用模板再交到新目录,拒绝非空目录,不复制已生成音频、成片、密钥或本机适配文件。
  • run.ps1 按 VIDEO_PYTHON、项目 .venv、机器适配、py -3.11、系统 python 的顺序找解释器,再统一进入 pipeline.workflow。
  • doctor 只检查 Python 包、FFmpeg/ffprobe、背景/模板文件、已登记的显卡协调和 ChineseASR 适配;不启浏览器和显卡,不读私钥、不发网络请求。依赖清单是 Playwright、requests、Pillow,非 Windows 再加 Send2Trash;FFmpeg/ffprobe 和浏览器另装,本地语音模型只由 ChineseASR 管。
技术实现与依据(一)

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

图文页开工、69 页版式一览、分镜工程初始化与静态体检已在源码中;本次未运行(内容截止北京时间 2026-10-11 14:00,提交 cc41e514);“每期先选工具”和 docfilm 开工入口按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 补读,也没有运行

关键规则与设计选择
1
图文页开工建的是影片内容目录;run.ps1 init 建的是独立的分镜工具工作区,两者复制范围不同,都不复制上一期脚本、音频、成片或本机适配文件。docfilm 没有初始化命令,本期的配音配置、镜头单和素材都放在本期目录,不进通用源码;本期的战略稿也不随 init 复制。
2
试片的声音和词级时间是合成测试材料,只证明链路能走通,不能当本期内容或已审定作品。
3
doctor 只看静态环境,doctor-live 才实际请求云端配音;环境就绪不能替代脚本、画面、成片和人工观看。docfilm 的多音字检查同样只读:不取密钥、不调配音、不建输出目录,退出码 0 表示没有待看项、2 表示有、1 表示配置或依赖出错。
4
四套工具(docfilm、图文页、网页成片、分镜配音)不分主次,也没有“哪类视频走哪条路”;每期先判断画面和配音怎么做最好,可单用、混用或为这期现写。图文页主题默认白底绿,但这期用不用图文页照这一条判断。
当前怎样实现
  • pipeline.pages init 拒绝非空目标,建立 pages、art、narration、assets、_samples/checkpoint、README 和一张 intro 分镜表;--render 用约 6 秒的合成测试音实际出片。新 intro 模板默认按 1080 高度捕获。
  • pipeline.pages atlas 生成含 69 页的版式一览分镜表和测试音,实际出片时另产每秒联系表。69 是模板页数,不是 69 种互相独立的动画,也不是这次已产出的截图数。
  • init_project.py 仍先暂存完整通用模板再交到新目录,拒绝非空目录,不复制已生成音频、成片、密钥或本机适配文件。
  • run.ps1 按 VIDEO_PYTHON、项目 .venv、机器适配、py -3.11、系统 python 的顺序找解释器,再统一进入 pipeline.workflow。
  • doctor 只检查 Python 包、FFmpeg/ffprobe、背景/模板文件、已登记的显卡协调和 ChineseASR 适配;不启浏览器和显卡,不读私钥、不发网络请求。依赖清单是 Playwright、requests、Pillow,非 Windows 再加 Send2Trash;FFmpeg/ffprobe 和浏览器另装,本地语音模型只由 ChineseASR 管。
技术实现与依据(二)
1
先判断这期画面和配音怎么做最好,定用哪套工具;再选择一个空目标目录(docfilm 用本期目录)。
2
讲解视频用 pages init 建影片目录,按需加 --render 出试片;分镜工程用 run.ps1 init 复制通用源。
3
维护代码时运行 test;开始普通制作不强制重跑整套回归。
4
分镜工程运行 doctor,读取本机环境结果。
5
只有需要真实云端配音证据时,再单独运行 doctor-live。
  • 独立网页作品从 webfilm/run.ps1 或 python -m webfilm 进入,不调用分镜流程,也不要求先有脚本、配音或词轴;它的 doctor 只确认 Chrome、FFmpeg、FFprobe 和 Python 库入口,不代替实际捕获。
  • docfilm 从本期目录的配音配置和镜头单进入:narrate.py --check-polyphones 只读检查多音字,narrate.py 合成全片配音和 timeline.json,shotlist.py check 检查锚点、素材、打码框和镜头多样性;画面依赖 numpy、Pillow、scipy、psutil 和 FFmpeg,多音字检查另装 pypinyin、jieba,显卡渲染另要 CuPy,都不在 doctor 的检查范围里。
  • 旧 build_v2.py 与定制封面已退出活动源码,一键全流程、reset/archive 和投稿文案包也没有恢复;通用 scene_base.html、cover_base.html 保留,不清理用户旧工程。
执行流程
技术实现与依据(二)
1
先判断这期画面和配音怎么做最好,定用哪套工具;再选择一个空目标目录(docfilm 用本期目录)。
2
讲解视频用 pages init 建影片目录,按需加 --render 出试片;分镜工程用 run.ps1 init 复制通用源。
3
维护代码时运行 test;开始普通制作不强制重跑整套回归。
4
分镜工程运行 doctor,读取本机环境结果。
5
只有需要真实云端配音证据时,再单独运行 doctor-live。
  • 独立网页作品从 webfilm/run.ps1 或 python -m webfilm 进入,不调用分镜流程,也不要求先有脚本、配音或词轴;它的 doctor 只确认 Chrome、FFmpeg、FFprobe 和 Python 库入口,不代替实际捕获。
  • docfilm 从本期目录的配音配置和镜头单进入:narrate.py --check-polyphones 只读检查多音字,narrate.py 合成全片配音和 timeline.json,shotlist.py check 检查锚点、素材、打码框和镜头多样性;画面依赖 numpy、Pillow、scipy、psutil 和 FFmpeg,多音字检查另装 pypinyin、jieba,显卡渲染另要 CuPy,都不在 doctor 的检查范围里。
  • 旧 build_v2.py 与定制封面已退出活动源码,一键全流程、reset/archive 和投稿文案包也没有恢复;通用 scene_base.html、cover_base.html 保留,不清理用户旧工程。
执行流程
名词和入口
本模块用到的名词
名词意思
bootstrap(项目初始化)建一份新的独立工作区或影片目录,不含上一期的业务内容。
doctor(环境体检)只检查当前环境能力,不生产视频,也不证明内容完成。
BUSY(资源正忙)编码器存在,但显卡当时没有足够资源;释放已有工作后可重试,不能当缺依赖。
专业定义

新影片不夹带上一期内容;先用试片确认链路,再换本期真实材料。

解决什么

防止复制旧视频污染新项目,也防止因为一个命令返回绿色、或试片能播,就把尚未制作的内容称为完成。

名词和入口
本模块用到的名词
名词意思
bootstrap(项目初始化)
意思:
建一份新的独立工作区或影片目录,不含上一期的业务内容。
doctor(环境体检)
意思:
只检查当前环境能力,不生产视频,也不证明内容完成。
BUSY(资源正忙)
意思:
编码器存在,但显卡当时没有足够资源;释放已有工作后可重试,不能当缺依赖。
专业定义

新影片不夹带上一期内容;先用试片确认链路,再换本期真实材料。

解决什么

防止复制旧视频污染新项目,也防止因为一个命令返回绿色、或试片能播,就把尚未制作的内容称为完成。

出问题时
边界
  • 开工不替人确定标题、脚本、素材或场景;样例只是演示。
  • 这次网页核对没有运行 doctor、doctor-live 或试片,不声称云端配音当前可用。
  • 截至 16:34 只读看到登记的 Python 3.11.9 带 Playwright 1.60.0、requests 2.34.2、Pillow 11.3.0,源码要求 Pillow 12.3 以上;实际出片用哪个解释器没有核对,不据此断定出片会失败。
  • 付费、账号和重型下载不是浏览页面时自动执行的动作。
失败与恢复
情况
怎么处理
目标目录已有内容
拒绝覆盖,要求换空目录或先由人处理现有内容。
NVENC 显存压力
返回 BUSY 和显存信息,不把它改写成永久不支持。
明确配音时云端配置缺失
配音或明确的配置探针失败,不打印密钥、不换声线或服务;静态 doctor 不读密钥,也不假报账户可用。
出问题时
边界
  • 开工不替人确定标题、脚本、素材或场景;样例只是演示。
  • 这次网页核对没有运行 doctor、doctor-live 或试片,不声称云端配音当前可用。
  • 截至 16:34 只读看到登记的 Python 3.11.9 带 Playwright 1.60.0、requests 2.34.2、Pillow 11.3.0,源码要求 Pillow 12.3 以上;实际出片用哪个解释器没有核对,不据此断定出片会失败。
  • 付费、账号和重型下载不是浏览页面时自动执行的动作。
失败与恢复
情况
怎么处理
目标目录已有内容
拒绝覆盖,要求换空目录或先由人处理现有内容。
NVENC 显存压力
返回 BUSY 和显存信息,不把它改写成永久不支持。
明确配音时云端配置缺失
配音或明确的配置探针失败,不打印密钥、不换声线或服务;静态 doctor 不读密钥,也不假报账户可用。
依据与来源
真实入口
  • 通用文件复制、空目录和拒绝覆盖
  • 统一 Python 与阶段入口
  • 本机与可选网络体检
  • 初始化与 doctor 回归
如何验证
  • 2026-09-03 历史源仓库 33/33、新初始化工程 33/33,之后未重新运行。
  • 2026-10-11 23:56 重新运行静态 doctor:10 项通过、1 项未验证(与 9 月 18 日相同);没有运行 doctor-local 或 doctor-live。
  • 最近一次 GitHub 自动测试是 2026-10-11 15:15—15:17 针对当前提交 c4eec887 的运行:Ubuntu 单测有 6 处因找不到 FFmpeg 出错,Windows 单测取消,Linux 整链短片成功;整体结果是失败,不能说全部通过。
与其他模块的关系

本模块只决定项目和环境能否开始;旁白模块负责配音和词级时间,后续模块才形成画面与交付。

依据与来源
真实入口
  • 通用文件复制、空目录和拒绝覆盖
  • 统一 Python 与阶段入口
  • 本机与可选网络体检
  • 初始化与 doctor 回归
如何验证
  • 2026-09-03 历史源仓库 33/33、新初始化工程 33/33,之后未重新运行。
  • 2026-10-11 23:56 重新运行静态 doctor:10 项通过、1 项未验证(与 9 月 18 日相同);没有运行 doctor-local 或 doctor-live。
  • 最近一次 GitHub 自动测试是 2026-10-11 15:15—15:17 针对当前提交 c4eec887 的运行:Ubuntu 单测有 6 处因找不到 FFmpeg 出错,Windows 单测取消,Linux 整链短片成功;整体结果是失败,不能说全部通过。
与其他模块的关系

本模块只决定项目和环境能否开始;旁白模块负责配音和词级时间,后续模块才形成画面与交付。

复制 AI 续作说明

项目:先复制一个干净项目,再判断环境能不能开始;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

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