Skip to content

eternityspring/reelbench-skills / skills/video-shots

video-shots

Verified

拉片:把一条成片拆成逐镜头的分析表——每个镜头的时长、景别、类别、运镜、画面。 分工刻在骨子里:**能量的都由代码量**(切点来自 ffmpeg 场景检测,时长是切点相减, 运动量是逐帧差分的中位数),模型只判断它真正该判断的那几件事(景别 / 类别 / 运镜 / 画面 / 节奏), 然后每一条判断都被代码当场对账——**声称推拉摇移却实测几乎不动,门直接拦**。 看片走联系表(每镜起手帧 + 收尾帧各拼一张大图,一屏二十几个镜头,a/b 对照就是运镜), 不是一张张翻。检测漏刀多刀用 recut 补刀并刀,自动重编号重算时长,手改边界过不了门。 产出 shots.json + Markdown 镜头表 + **单页交互式拉片报告**:内嵌播放器(播放时同步高亮镜头、 点镜头跳转)、镜头节奏带、可搜索可筛选可排序的镜头表(列表 / 卡片两种视图、首尾关键帧并排、 点图开大图)、景别类别运镜分布、出场人物、质量门、导出 JSON。单文件零依赖,离线双击能开。 15 道质量门全部由脚本确定性检查。 零依赖、零 API key,只要 node 和 ffmpeg。 Use when asked to 拉片、拆镜头、分析视频镜头、镜头时长、景别、运镜、镜头表、 video shot breakdown、shot list from video。

FileKindSize
README.en.mdmarkdown9.6 KB
README.mdmarkdown8.3 KB
SKILL.mdskill md13.5 KB
assets/report-mobile.pngbinary125.8 KB
assets/report.pngbinary384.5 KB
examples/demo-shots.jsonconfig30.9 KB
examples/demo-track.jsonconfig3.8 KB
references/analysis-pass.mdmarkdown5.5 KB
references/report-style.mdmarkdown5.4 KB
references/schema.mdmarkdown5.2 KB
references/taxonomy.mdmarkdown11.7 KB
scripts/report.cssother33.0 KB
scripts/report.jsscript20.5 KB
scripts/selftest.mjsscript35.2 KB
scripts/video-shots.mjsscript75.6 KB

references/report-style.md

View on GitHub
# shots-report.html 设计约定

改样式前先读这份,别凭感觉发挥。

## 三层结构:壳 + 资产 + 数据

报告不是一个大字符串,是三样东西拼起来的:

| 层 | 在哪 | 改它等于改什么 |
| --- | --- | --- |
| **壳** | `scripts/video-shots.mjs` 的 `renderHtml()` | 页面骨架:头、统计条、目录、播放器、四个区块、页脚 |
| **样式** | `scripts/report.css` | **报告的设计本身**。改这份文件就能改报告的长相,不用碰 JS,也不用碰生成器 |
| **交互** | `scripts/report.js` | 列表渲染、搜索筛选排序、时间轴、播放同步、大图、导出 |
| **数据** | 内联的 `DOC` 与 `CFG` | `DOC` 就是 shots.json 原样;`CFG` 是词表、色阶、筛选项、头像取哪一镜、关键帧有没有、界面文案 |

render 时两份资产被**整段内联**进 HTML,产物仍然是**单文件、零外部依赖、离线双击能开**。
`report.js` 是通用的:换一条片子、换一种语言,它一个字都不用改——**页面上的每个数字都从 `DOC` 算**,
没有一处是生成时写死的。

**三个文件必须一起拷走。** `scripts/` 少了 `report.css` 或 `report.js`,`render --html` 直接报错。

## CFG 契约

`renderHtml` 算好、`report.js` 消费,两边都不许假设对方的细节:

| 字段 | 内容 |
| --- | --- |
| `frameDir` / `frames` | 关键帧目录,以及每个镜头**实际有哪几张**(`'ab'` / `'a'` / `''`)——缺图摆占位,不摆会 404 的 `<img>` |
| `labels` | 景别 / 类别 / 运镜 / 转场四张词表的**全量**中英文名,跟着 `--lang` 走 |
| `colors` | 景别色阶,来自 `SHOT_SIZES` 的 `color` 字段,时间轴与图例共用 |
| `filters` | 筛选条:按镜头数排前四的类别 + 全部 + 其他 |
| `portraits` | 每个人物的头像取哪一镜:**同框人最少 → 景别最近 → 出场最早**,没帧就不给 |
| `words` | 界面文案。**`report.js` 引用的每个键都由自测对账**,写漏一个当场红 |

## 基调

- 纸白 `#f7f8f4` + 深绿 `#285444` + 嫩绿 `#dceba7`;正文 13px,数字一律 `tabular-nums`
- 内容区 `.content` 控制留白与上限宽度;手机宽度(~400px)不许横向滚动
- 模型产出的每一个字都过 `esc()`——生成时一遍,`report.js` 里再一遍;内嵌 JSON 的 `<`
  转成 `<` 防 `</script` 截断

## 区块顺序

头(片名 · 参数 · 门的结论 · 导出)→ 目录 → 统计条 → **镜头明细**(播放器 + 节奏带 + 镜头表)
→ 统计分布 → 出场人物 → 质量检查 → 页脚。

后三块是 `<details>`,默认收起——**拉片的主战场是镜头表**,其余的按需展开。

## 播放器:报告能当片子看

`<video>` 挂原片(`--video` 指路径,默认用 `source`;也能现场选本地文件)。播放时三处跟着走:
当前镜头信息、镜头行高亮、时间轴上的进度填充。

- 找镜头用**二分**(`shotAtTime`),不是线性扫——53 镜和 5300 镜一样快
- 用 `requestVideoFrameCallback` 跟帧,没有就退回 `requestAnimationFrame`
- **播放过程中只改 class 和进度值,绝不重建行**——重建会把滚动位置和焦点抖掉
- 视频加载不了、或时长和报告对不上,页面**明说**,不装作没事

## 节奏带

一镜一片,**片宽 = 时长占比,颜色深浅 = 景别远近**(色阶见 `CFG.colors`)。点一片跳到那一镜;
播放时当前那片按播放进度填充。刻度取**整的步长**走五格再补片长——`01:21` 这种刻度没人看得下去。

## 镜头表:列表与卡片两种视图

列表视图是默认:一行一镜,**首尾两张关键帧并排**(对照着看就是运镜)+ 时间/时长 +
景别/类别/运镜 + 画面描述 + 文字·声音。卡片视图适合快速翻画面。

- 搜索框查镜号、画面、台词、人物名;筛选条按类别;排序可按时长
- 点一行 = 跳到那一镜(播放器同步);点关键帧 = 开大图(← → 切首尾帧,ESC 关)
- 每个镜头的 `id` 是锚点,`#S07` 直接深链到那一镜

## 质量门与提示

- 门分三态:通过 / 未通过 / **跳过**。跳过不是通过,**把原因印在卡片上**
- 提示(不拦)单独成块:运镜实测偏高这类**需要人判断**的东西放这里,不混进门。
  提示里点名的镜号做成按钮,点一下跳到那一镜
- 页头一行给结论:`14 项通过 · 1 条提示`

## 界面语言

`--lang zh|en` **只切界面标签**(优先级 `--lang` > JSON 顶层 `lang` 字段 > 默认中文)。

- 切的是标签:统计条、区块标题、按钮、播放器状态、词表的景别 / 类别 / 运镜 / 转场名
- **不切的是内容**:画面描述、台词、画面文字、人物名、备注——那是模型写的正文,原样不动
- 文案全部走 `CFG.words`,`report.js` 里没有一句硬编码的中文。**引用的每个键在中英两张表里
  都必须有**,自测逐个对账(写漏一个,页面上就是 `undefined`,所以这条门是硬的)

## 自测盯着的是契约不是像素

`selftest.mjs` 不比对 HTML 长什么样(那种断言改一次样式就红一次),它查的是:
资产有没有被内联、壳里有没有漏替换的模板占位、`DOC` 的 `<` 有没有转义、门有没有逐条列出、
`CFG` 的词表是不是全量、头像挑得对不对、缺帧有没有如实声明、
**`report.js` 引用的文案键在中英两张表里是不是都有**。
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall