

video-scaffold · 功能说明
开始新视频时,我得到一个空白但能检查状态的起点,不会带上上一期的脚本和成片。讲解视频现在默认从“图文页影片目录”开工:建好目录就能接上本期已经定稿的配音、原文和词级时间;需要时还能先出一段约 6 秒的试片,确认整条路是通的。原来的逐场分镜工程和环境体检照旧保留,独立网页作品另有自己的入口。这段“默认从图文页开工”是 10 月 11 日到 29 日的做法:现在每一期先想这期画面和配音怎么做最好,再决定从哪套工具开工,可以混用。docfilm(实拍感纪实画面)没有建目录的命令:在本期目录里备好配音配置和定稿,写一份全片镜头单,从“多音字检查 → 合成配音 → 镜头单检查”开工。
当前情况:图文页开工、版式一览、分镜工程初始化和环境体检都在源码里;这次网页核对只读了源码,没有运行体检、没有出片。docfilm 的开工入口按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 的说明补读,同样没有运行。
项目源码:私有仓库

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/ 进入。用哪套先按这期画面和配音判断,不按片子类型定默认。docfilm 不用 init:在本期目录放配音配置和全片镜头单,先跑 python -X utf8 docfilm/(只读,不取密钥、不调配音),再合成配音,然后跑 python -X utf8 docfilm/。
- 新影片的空目录
- 本期已定稿的配音、原文和词级时间(开工后再放进去也可以)
- 用 docfilm 时:本期配音配置(字幕原文和可选的合成念法)、定稿文案、底板和截图素材;要在显卡上渲,另备带 CuPy 的 Python 环境

--render 用合成测试声音做约 6 秒试片,确认出片链路能走通;不加就只建目录,不出片。
讲解视频用 python -m pipeline.pages init <空影片目录> 开工,加 --render 会顺带做一段试片;想先看全部版式,用 python -m pipeline.pages atlas <空目录> --render。原来的逐场分镜工程仍从 run.ps1 init 建,再运行 run.ps1 doctor 体检;独立网页作品从 webfilm/ 进入。用哪套先按这期画面和配音判断,不按片子类型定默认。docfilm 不用 init:在本期目录放配音配置和全片镜头单,先跑 python -X utf8 docfilm/(只读,不取密钥、不调配音),再合成配音,然后跑 python -X utf8 docfilm/。
- 新影片的空目录
- 本期已定稿的配音、原文和词级时间(开工后再放进去也可以)
- 用 docfilm 时:本期配音配置(字幕原文和可选的合成念法)、定稿文案、底板和截图素材;要在显卡上渲,另备带 CuPy 的 Python 环境

--render 用合成测试声音做约 6 秒试片,确认出片链路能走通;不加就只建目录,不出片。
这里保留实现、关键条件、精确入口、历史记录和验证结果。
图文页开工、69 页版式一览、分镜工程初始化与静态体检已在源码中;本次未运行(内容截止北京时间 2026-10-11 14:00,提交 cc41e514);“每期先选工具”和 docfilm 开工入口按 北京时间 10 月 30 日 01:43 最后一次提交 2dbab62 补读,也没有运行

run.ps1 init 建的是独立的分镜工具工作区,两者复制范围不同,都不复制上一期脚本、音频、成片或本机适配文件。docfilm 没有初始化命令,本期的配音配置、镜头单和素材都放在本期目录,不进通用源码;本期的战略稿也不随 init 复制。
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 补读,也没有运行

run.ps1 init 建的是独立的分镜工具工作区,两者复制范围不同,都不复制上一期脚本、音频、成片或本机适配文件。docfilm 没有初始化命令,本期的配音配置、镜头单和素材都放在本期目录,不进通用源码;本期的战略稿也不随 init 复制。
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 管。

--render 出试片;分镜工程用 run.ps1 init 复制通用源。- 独立网页作品从
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 保留,不清理用户旧工程。


--render 出试片;分镜工程用 run.ps1 init 复制通用源。- 独立网页作品从
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(资源正忙) | 编码器存在,但显卡当时没有足够资源;释放已有工作后可重试,不能当缺依赖。 |

新影片不夹带上一期内容;先用试片确认链路,再换本期真实材料。
解决什么
防止复制旧视频污染新项目,也防止因为一个命令返回绿色、或试片能播,就把尚未制作的内容称为完成。



新影片不夹带上一期内容;先用试片确认链路,再换本期真实材料。
解决什么
防止复制旧视频污染新项目,也防止因为一个命令返回绿色、或试片能播,就把尚未制作的内容称为完成。

- 开工不替人确定标题、脚本、素材或场景;样例只是演示。
- 这次网页核对没有运行 doctor、doctor-live 或试片,不声称云端配音当前可用。
- 截至 16:34 只读看到登记的 Python 3.11.9 带 Playwright 1.60.0、requests 2.34.2、Pillow 11.3.0,源码要求 Pillow 12.3 以上;实际出片用哪个解释器没有核对,不据此断定出片会失败。
- 付费、账号和重型下载不是浏览页面时自动执行的动作。

- 开工不替人确定标题、脚本、素材或场景;样例只是演示。
- 这次网页核对没有运行 doctor、doctor-live 或试片,不声称云端配音当前可用。
- 截至 16:34 只读看到登记的 Python 3.11.9 带 Playwright 1.60.0、requests 2.34.2、Pillow 11.3.0,源码要求 Pillow 12.3 以上;实际出片用哪个解释器没有核对,不据此断定出片会失败。
- 付费、账号和重型下载不是浏览页面时自动执行的动作。

- 通用文件复制、空目录和拒绝覆盖
- 统一 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。







