repo-film 用于把任意 git 仓库的一段时间做成一条能直接发布的短片。它的目标场景是:一行命令、不改场景代码即可出片。
用途与产出 从真实提交生成 15–25 秒短片:主线与各分支按真实分叉、合并同时生长成流程图,越长越快,再拉远看全景。仓库若有 you-are-here 项目地图,整张网会收拢成地图里的阻塞链,再沿地图讲卡点、当前位置和一句话总结,最后接可改的结尾卡片。成片位于 <out>/out/<仓库名>-film.mp4,1920×1080、30fps,响度约 -14 LUFS;无地图约 13 秒,有地图约 24 秒。
使用方式
基本命令:
node <本 skill 目录>/scripts/make.mjs
--repo <仓库路径> --since "2026-11-01 20:00" --until "2026-11-02 06:00"
[--branch main] [--map auto|none|<地图 html>] [--config film.json] [--out <目录>] [--sheet-only]
建议先加 --sheet-only 只出关键帧拼图 out/beats.png 自行检查,再出片。--out 默认是 ~/Videos/repo-film/<目录名>-<开始日期>,其中是完整工程,可直接改 scene.html 或 <out>/assets/film.js,再用 motion-stack 的 render.mjs 重渲。
依赖 需要 motion-stack skill(放在本 skill 旁,或在 ~/.claude/skills、~/.codex/skills、~/.agents/skills 中,也可用 MOTION_KIT 指向其 kit/;首次需在 kit/ 里执行 PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm install)、python3、ffmpeg。Tone.js 优先复用 motion-stack 示例的 node_modules,没有才 npm install。
流水线 scripts/lanes.py 只读 git(--all,本地分支也算):--branch 的 first-parent 链为第 0 道主线,其余提交按 first-parent 串成分支段;每段从分叉点到合并点占一个区间,区间重叠的段分到不同道(上下交替)。分支名从 Merge branch 'x' into y 读取,读不到不标。超过 --max(默认 400)只留最新。scripts/capture.mjs 在有地图时把地图临时排成单栏、截 2 倍图,并记录区块位置和各阻塞链连线路径(只改截图样式,不改地图文件)。make.mjs 按数据生成字幕与结尾卡片写入 <out>/assets/film.js,可用 --config 覆盖。渲染流程为关键帧拼图 → 纯度检查(正放倒放一致)→ MP4;响度由 motion-stack 渲染器自动调到 -14 LUFS,数值记录在成片旁的 .manifest.json。
配置 film.json(全部可选) 可配置 captions(四组中英字幕,分别位于 0.6 秒、3 秒、7.6 秒全景和 8.65 秒仅在有地图时出现)、sub、startLabel、end(title、tagline、taglineEn、lines、meta)。end.lines 中以 / 或 $ 开头的部分会着色,适合放安装命令。
适用场景与限制 适合把一段开发活动做成一页式短片或宣传素材。注意事项:提交说明会原样上屏(截到 40 个字),公开前需用 git log 检查敏感项目名、人名、内部链接;地图优先用 .project-map/index.public.html,脚本发现 /Users/ 等路径会警告,右上角仓库名标签和 GitHub 链接会带用户名;字体用本机 SF 字体渲染,只复制进工程目录,不要连同工程公开。未验证项包括竖版 9:16(地图镜头与卡片在竖屏太小,需另做排版)、很长时间段(仅验到 51 个提交、14 条分支,卡片可能过密,或需只显示圆点)、阻塞链为空的地图(代码会退回落在总结行,未实际跑过)、连续播放观感与音效(仅看关键帧,需用户看片验收)。技能自身设有放弃条件:到 2026-12-15 除 Keepline 和 Spellbook 两次验收外未再使用,或连续两个新仓库都需改 template/scene.html 才能出片,满足任一即停用并把分支布局脚本并入 motion-stack 示例。