电影学院 是做什么的?
一种像编写代码一样构建、度量和修正电影的方法。你把电影写成一个网页,渲染器将其拍摄成影片,混音器在节拍上叠加声音,门控拒绝比上一版更慢或更死板的剪辑,并且客户对影片的每一句评价都被逐字记录,必须在剪辑通过前得到回应。
所有命令从此技能文件夹运行(python film.py ...)。需要 ffmpeg、Python 3.9+,并执行 pip install playwright && playwright install chromium。python film.py check 会显示缺少什么。OCR(tesseract)是可选的。
开始:描述产品,运行两个命令
当客户描述一个产品并希望制作影片时:
- 仅收集你不能编造的信息:产品名称、一个承诺(一句话)、2-4个真实的事实(证明行)、一个真实数字(如果有)、一个请求(URL),以及产品是网页还是原生/手机应用(如果是后者,需要求提供屏幕录制,见下文)。绝不编造主张或数字:影片只展示提供的内容。一次性提问;如果对方未给出时长,6-15秒是社交媒体剪辑,30-60秒是宣传片。
python film.py new "<名称>" --promise "<承诺>" --points "标签=值|标签=值" [--number "40%" --number-label "..."] [--slam "无需铺垫。"] [--action "一键操作"] --url <url> [--music track.mp3 --drop-bar N] [--recording rec.mov]写入films/<slug>/film.json和页面文件。python film.py make films/<slug>:渲染、混音、门控;每次 make 都是一个带编号的构建(v1、v2……),并与前一个构建进行门控比较。使用--master生成 1920x1080、60 fps 的版本。- 查看它(
python film.py sheet <film.mp4> films/<slug>/sheet.jpg,然后读取图像;你无法播放视频)并告诉客户 mp4 文件的位置。 - 品味是客户的。 第一轮是合格且通用的。请客户观看并指出问题;在同一轮中逐字存储每条评价(
film.py note "<他们的原话>" --source "谁,日期" --store films/<slug>/film-notes.json),修改film.json或film.html,将每条评价与新的构建对应标记(film.py tick N1 --film <mp4> --where 0:04 --store ...),再次执行make。门控会拒绝含有未标记评价的构建,以及比上一版更慢或更静态的构建。 - 清晰告知客户:门控会捕获死板或劣化的剪辑,但无法判断品味;并且工作会消耗他们的 Claude tokens(首部影片数万 token,每轮修改 10-30k;自定义场景成本更高),因此每轮同时修正多个问题,并读取一张联系表而不是多张静态帧。
原生或手机应用(非网页):要求提供一个简短的屏幕录制(5-10秒,单一任务,关闭通知,屏幕上无个人敏感信息),然后运行 python film.py import-recording rec.mov films/<slug> --start 2 --seconds 6。它将变成页面窗口中的帧,替代手绘卡片。
在修改 film.json 之外的页面之前,先阅读 playbook.md(首先阅读结构和剪辑部分,在选择音乐前阅读声音部分)。音乐:生成的占位符是默认的;切勿在仓库中附带音轨,客户提供的音轨需要拥有允许他们发布该影片的许可证。
手动流水线(make 的逐步实现)
循环
- 一次性简报。 类型(宣传片、解释视频、社交媒体剪辑)、影片的唯一承诺(一句话)、时长、播放平台以及允许展示的内容(仅限客户有权发布的素材;不得使用不能明确说明使用权的数据)。如果客户未给出时长,宣传片为 30-60 秒,社交媒体视频为 15 秒。不要询问影片应如何制作;那是你的职责。
- 参考先于像素。 获取至少 2 个同类型影片(观看它们,仅下载可以保留用于私人研究的资源)并运行
python film.py measure ref1.mp4 ref2.mp4。它们的平均镜头长度、静态比例和每卡字数将成为你的基准。阅读playbook.md:在写作前阅读结构和剪辑章节,在混音前阅读声音章节。切勿复制参考;而是借鉴它们的数值和技巧。 - 将影片写成一个 HTML 页面(从
academy/template.html开始,film.py new会将其复制到项目中;该模板还定义了window.timeline()和window.cards(),以便门控了解真实的剪辑点和卡片文本)。约定:window.seek(t)将页面绘制为时间t的纯函数(无定时器、无自动播放的 CSS 动画),window.duration()返回秒数,window.cues()返回[{t, sfx, db}]表示属于某一帧的音效,window.ready是字体和图像的 Promise,window.MISSING列出加载失败的资源(任何条目都会导致渲染失败)。将场景起始点放在音乐的小节网格上(bar = beats_per_bar * 60 / bpm)。以高光时刻开场(第 0 帧是一幅画面),展示唯一承诺,后期的一个关键时刻,早期展示品牌,并在结尾卡再次展示。 - 先观察再渲染。 模型无法播放视频:运行
python film.py stills film.html out/stills 0,2.5,5并读取生成的 PNG;渲染后运行python film.py sheet film.mp4 sheet.jpg会在一张图片上展示每秒一帧。修正你所看到的。 - 渲染。
python film.py render film.html out/film.mp4 --fps 30 --size 1280x720 --workers 2(使用--fps 60 --size 1920x1080制作母版)。多个 Chromium 工作进程各自渲染一段;任一工作进程崩溃或资源缺失都会导致整个渲染失败,绝不会生成缩短的影片。页面的提示(cues)会写入out/film.cues.json。 - 混音。
python film.py mix out/film.mp4 out/final.mp4 --plan plan.json --music track.mp3 --sfx sfx_dir --cues out/film.cues.json。计划(plan)按小节列出音乐片段(track_bar->film_bar,bars),使每次跳转都落在强拍上;最后一个和弦在结尾卡下延音。响度调整至 -14 LUFS,真实峰值 -1 dBTP(两次 loudnorm 处理),并在之后测量。音乐:自带拥有许可的音轨,允许你发布影片(切勿在仓库中附带音轨);音效文件为<名称>.wav。默认无配音;平淡的合成配音比没有更差。 - 长影片分部分处理。 为每部分单独创建页面并渲染,以便多个人或代理可以并行工作,然后运行
python film.py join p1.mp4 p2.mp4 p3.mp4 --out film.mp4 --dissolve 0.5(每部分的.cues.json会映射到整部影片的时间线上),并在整部影片上只进行一次混音。 - 门控。
python film.py gate --film out/final.mp4 --against previous.mp4 --refs ref1.mp4 ref2.mp4 --timeline times.json --bpm 120。当剪辑比上一版更慢、更静态,或出现大量微短镜头/每个节拍都有剪辑时,门控会终止(退出码 5);它还会对每卡字数或响度提出警告。ffmpeg 的场景评分难以识别缓动过渡,因此在times.json中提供真实的剪辑时间({"final": [2.0, 4.0, ...]},键值为文件主名)。修正影片,再次渲染,再次门控。从未超越上一版剪辑的影片不算完成。 - 笔记绑定每次剪辑。 每当客户对影片提出任何意见,在同一轮中逐字存储:
python film.py note "<他们的原话>" --source "谁,日期" [--means "你的理解"]。在门控前,将每条笔记与具体文件及对应位置进行标记:python film.py tick N1 --film out/final.mp4 --where 0:04(一个时间戳或shot 7)。film.py gate在任何笔记对于当前文件哈希缺少标记时会拒绝(退出码 6);重新渲染或更换音乐会产生新文件,需要新的标记。python film.py notes --film out/final.mp4列出未处理的笔记。客户的原话永不编辑;你的理解放在--means中。 - 交付完成的影片。 客户看到最终剪辑(全分辨率母版,用于海报的静态帧),而不是动画分镜、故事板或半成品版本;如果他们要求观看草稿,那是他们的决定,而非默认流程。
持续有效的规则
- 客户的品味高于任何评分:门控捕获退化和死板剪辑,但不评选更好的影片。当客户指出影片的好坏时,将其添加到 playbook 中以备下次使用。
- 切勿在度量已覆盖的流水线部分重复劳作:先度量(
film.py measure),然后修改。 - 修正存入此文件夹(playbook、页面模板、计划),而非存入会话结束后丢失的提示中。
- 无参考影片、片段或许可音轨进入仓库:仅保存数值。
文件
| 文件 | 说明 |
|---|---|
film.py | 命令行工具:new, make, import-recording, check, render, stills, join, mix, measure, gate, sheet, note, tick, notes |
academy/project.py, academy/template.html | new/make:影片项目,配置驱动的页面 |
academy/render.py | 逐帧 Chromium 渲染器(并行切片,ffmpeg) |
academy/mix.py | 小节线音乐剪辑、命中提示、两次 loudnorm 至 -14 LUFS |
academy/join.py | 带溶解的片段拼接,提示合并 |
academy/gate.py | 度量和检查 |
academy/notes.py | 逐字笔记,绑定文件哈希的标记 |
playbook.md | 43 种有来源的技巧和门控的数值 |
data/ | 参考数值(18 部已发布影片)和剪辑工艺限制(205 部影片),仅含数值 |
example/ | 一部 10 秒原创影片(bash example/build.sh):对一个虚构产品执行 new 然后 make |