repo-film

repo-film：仓库的一段时间 → 一条短片

要支撑的决定：任何仓库的任何一段时间，能不能一行命令、不改场景代码就出一条能发的片子。 放弃条件：到 2026-12-15 为止，除 Keepline 和 Spellbook 两次验收外没有再用过；或者连续两个新仓库都得改 template/scene.html 才能出片。满足任一条就停用，把分支布局脚本并进 motion-stack 的示例。每做完一部，在下方“做过的片子”表里记一行。

用法

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>/out/<仓库名>-film.mp4，1920×1080、30fps，响度约 -14 LUFS。没有地图约 13 秒，有地图约 24 秒。
• --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。

流水线

1. scripts/lanes.py：只读 git（--all，所以本地分支也算）。--branch 的 first-parent 链是主线（第 0 道），其余提交按 first-parent 串成分支段；每段从分叉点到合并点占一个区间，区间重叠的段分到不同的道（上下交替）。分支名从 Merge branch 'x' into y 里读，读不到就不标。超过 --max（默认 400）只留最新的。
2. scripts/capture.mjs：有地图时，把地图临时排成单栏（阻塞链不再横向滚动，能完整显示），截 2 倍图，并记下各区块位置和阻塞链每条连线的路径。只改截图时的样式，不改地图文件。
3. make.mjs 按数据生成字幕和结尾卡片，写进 <out>/assets/film.js，再用 --config 覆盖。
4. 渲染：关键帧拼图 → 纯度检查（正放和倒放必须一致）→ MP4。响度由 motion-stack 渲染器自动调到 -14 LUFS，数值在成片旁的 .manifest.json 里。

film.json（全部可选）

{
  "captions": [["你离开了。", "You step away."], ["agent 们接着干。", "The agents keep going."],
               ["一夜，51 个提交，8 条分支。", "One night. 51 commits. 8 branches."], ["回来，打开一页。", "Come back. Open one page."]],
  "sub": "KEEPLINE · 11-01 20:01 → 11-02 04:34",
  "startLabel": "20:00 开工",
  "end": { "title": "you-are-here", "tagline": "…", "taglineEn": "…",
           "lines": ["/plugin marketplace add majiayu000/you-are-here"], "meta": "github.com/…" }
}

字幕四个位置分别是 0.6 秒、3 秒、7.6 秒（全景）和 8.65 秒（只在有地图时出现，引出地图）。end.lines 以 / 或 $ 开头的部分会着色，适合放安装命令。