pixel-previs
/pixel-previs
Generuje wideo podglądowe (previs) w stylu pikselowym z opisu lub filmu referencyjnego, z promptami do ujęć dla generatorów AI.
- Autor
- AsakawaTX ↗
- Repozytorium
- pixel-previs ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 15
- Skrypty
- 5
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: analyze.js, lib/engine.js, lib/raster.js, lib/sprites.js, render.js
Co robi i kiedy
Generuje wideo podglądowe (previs) w stylu pikselowym z opisu lub filmu referencyjnego, z promptami do ujęć dla generatorów AI.
Oryginalny opis (EN)
像素风镜头预演(previs)生成器。用户用文字描述想要的分镜、运镜或一段镜头序列时,或者丢来一段视频想拉片复刻它的分镜运镜时使用。输出统一风格的像素预演视频(MP4/GIF)和每个镜头的中英文提示词,可直接作为 AI 视频生成的运镜参考。
Jak działa
- 文件
- 常用命令
- 模式一:文字描述 → 预演视频
- 模式二:视频 → 拉片复刻
- 参数说明
- 示例
- 风格规则(不要破坏)
- 限制
Podgląd SKILL.md
---
name: pixel-previs
description: 像素风镜头预演(previs)生成器。用户用文字描述想要的分镜、运镜或一段镜头序列时,或者丢来一段视频想拉片复刻它的分镜运镜时使用。输出统一风格的像素预演视频(MP4/GIF)和每个镜头的中英文提示词,可直接作为 AI 视频生成的运镜参考。
---
# 像素预演(pixel-previs)
把"想要什么镜头"变成一段统一风格的像素预演视频:浅米色地面、稀疏地面网格、灰色方块和柱子、蓝衣深裤的像素小人。画面里的东西是固定的像素图,只有镜头在动,所以看预演就能看清镜头本身怎么运动。
两种模式:
- **模式一 文字 → 预演**:用户描述镜头,你写镜头参数并渲染。
- **模式二 视频 → 复刻**:用户给一段视频,你先分析它的分镜和运镜,再用同样的风格渲染出来。
环境要求:Node.js 18+、ffmpeg。没有其它依赖。下文命令都在本 skill 目录下运行。
## 文件
| 文件 | 作用 |
|---|---|
| `render.js` | 渲染:镜头参数(JSON)→ 视频,可顺带出一张 8 格预览图 |
| `analyze.js` | 模式二:切镜头、测运镜、拼关键帧图 |
| `presets.json` | 49 个现成镜头(分镜 F01–F21,运镜 Y01–Y28),含中英文名称、说明、提示词和参数 |
| `lib/engine.js` | 引擎:参数 → 每一帧画什么 |
| `lib/sprites.js` | 全部像素小图:人物各种姿势、道具、手持物 |
| `lib/raster.js` | 软件绘制像素画面 |
| `examples/` | 自定义镜头示例 |
## 常用命令
```bash
node render.js --list # 看全部预设
node render.js --show Y15 # 看某个预设的参数和提示词
node render.js --preset Y15 -o out.mp4 # 直接渲染一个预设
node render.js job.json -o out.mp4 --sheet sheet.png # 渲染自定义参数,并输出预览图
node render.js job.json -o out.gif # 输出 GIF(640 宽,15 帧/秒)
node analyze.js input.mp4 --out ana/ # 模式二:分析视频
```
可选:`--w 1920 --h 1080 --fps 30`(默认就是这些;只是检查时可以用 `--w 960 --h 540` 更快)。也可以 `--json '{...}'` 直接传参数。
---
## 模式一:文字描述 → 预演视频
1. **拆镜头**。把用户的描述拆成一个个镜头,每个镜头只做一件主要的事(一个景别或一个主要运镜)。描述里写了"然后""接着""切到",通常就是新镜头。时长没说就用:静态分镜 3 秒,运镜 5–6 秒。
2. **每个镜头先找预设**。`node render.js --list` 里有现成的就用 `{"preset":"Y04"}`,需要改的地方直接写在后面覆盖(比如换人物位置、改时长、改焦距)。
3. **预设里没有,就自己写参数**(见下面"参数说明")。可以用任意相机关键帧、任意人数、任意走位,风格自动和预设一致。
4. **渲染并检查**:`node render.js job.json -o out.mp4 --sheet sheet.png`,然后打开 `sheet.png` 看 8 格预览:人物有没有被挡住、有没有出画、运镜方向对不对、景别对不对。不对就改参数重渲。
5. **交付**:视频文件 + 每个镜头一段中英文提示词。用了预设就用预设里的 `zhp`/`enp`;自己写的镜头,按同样格式写:景别/角度 + 主体在做什么 + 镜头怎么动(方向、速度、起止画面)。
## 模式二:视频 → 拉片复刻
1. 运行 `node analyze.js 视频.mp4 --out ana/`。得到:
- `ana/analysis.json`:每个镜头的起止时间、时长、运动测量值和一句中文提示(hint),以及每 0.5 秒的运动曲线(curve)。
- `ana/keyframes.png`:每行一个镜头,A 开头、B 中间、C 结尾三帧。
2. **一定要打开 keyframes.png 看**,判断每个镜头的:景别(大远景/全景/中景/近景/特写)、机位高度和角度(平视/仰拍/俯拍/顶视/过肩/主观)、几个人、人物在画面哪里、朝哪边、有没有走动。如果同一行 A/B/C 明显不是同一个镜头,说明有一处切点没切出来,就把它当两个镜头处理。
3. **读运动测量值**(camera 字段):
- `pan`:横摇角度,正数=向右。→ 相机关键帧的 `yaw` 变化量(度)。
- `tilt`:纵摇角度,正数=向上。→ `pitch` 变化量(度)。
- `zoom`:画面放大倍数,>1 是推近或变焦推。→ 变焦:`mm` 乘以这个倍数;推镜头:让相机和主体的距离除以这个倍数。
- `roll`:画面旋转角度,正数=画面顺时针转。→ 相机 `roll` 直接用同样的数值(引擎里 roll 正数就是画面顺时针转)。
- `parallax`:大于 0.1 说明机位在移动(横移、跟拍、推拉、升降),小于 0.1 多半是原地转或变焦。
- `depth`:大于 1.6 说明中间的主体比背景放大得快,是推拉镜头不是变焦。
- `shake`:大于 0.5 说明有手持晃动或震动 → `fx: "hand"` 或 `"shake"`。
- 测量是近似值:角度可能偏小 10–30%,快速甩镜和剧烈旋转会测少。推镜头和变焦有时分不清,要结合关键帧看背景透视有没有变。
- `curve` 告诉你运动发生在哪段时间、先快后慢还是匀速,用它定相机关键帧的 `t`。
4. **写参数**:每个镜头一条,`dur` 等于原镜头时长,景别和角度按关键帧、运动按测量值。原视频里的人物换成本风格的小人,动作挑最接近的 `act`;物体挑最接近的道具,没有就用方块;只保留位置关系和数量。
5. 渲染、看预览图、和 keyframes.png 对比,景别和运动方向一致就交付;同样附上每个镜头的中英文提示词。
---
## 参数说明
### 结构
```json
{
"w": 1920, "h": 1080, "fps": 30,
"shots": [
{ "preset": "F02", "dur": 2 },
{ "dur": 5, "c": [ {"z": 0}, {"z": 6} ] }
]
}
```
`shots` 里的镜头按顺序硬切拼接。只有一个镜头时,也可以直接写这个镜头对象本身。
### 世界和单位
- 距离单位米,角度单位度,焦距用 35mm 等效的 `mm`(默认 24)。
- x 向右,y 向上,z 向前。默认相机在 (0, 1.5, 0) 朝 +z 看。
- 默认人物站在 (0, 9),身高 1.75 米:脚 y=0,眼睛约 y=1.45,头顶 1.75,头部 1.2–1.75,腰约 0.95。
- 默认场景:远处散布的灰方块和几根高柱,地面每 2 米一条网格。挡在相机和人物之间、或挡住相机路线的方块会被自动移走。
### 镜头字段
| 字段 | 含义 |
|---|---|
| `dur` | 镜头时长(秒),默认 6 |
| `c` | 相机。一个对象=固定机位;数组=关键帧。字段 `x y z yaw pitch roll mm`,还可写 `at:[x,y,z]`(看向某点,写了就不用 yaw/pitch)、`t`(这一帧在第几秒)、`e`(到这一帧的缓动)。没写的字段沿用上一帧。关键帧都不写 `t` 时,平均分布在 `t` 时间段里 |
| `t` | 运动时间段 `[开始秒, 结束秒]`,默认 `[dur/12, dur*0.75]`(前面停一下、后面停一会,方便看起止画面) |
| `e` | 缓动:`io` 缓入缓出(默认)、`lin` 匀速、`out` 快起慢停、`in` 慢起快停 |
| `at` | 相机始终看向的点 `[x,y,z]`,或 `[[起点],[终点]]` 随运动变化 |
| `o` | 环绕 `[起始半径, 结束半径, 起始角, 结束角]`,绕第一个人转;角度 0=相机在人物的 -z 一侧(默认人物的正面),90=相机在人物的 -x 一侧,180=在 +z 一侧(人物背后) |
| `follow` | 跟随第一个人(或 `who` 指定):`{"off":[dx,dy,dz], "look":[0,1.2,0]}`;`off` 也可写 `[[起点],[终点]]`。相机 y 直接取 `off[1]` |
| `p` | 人物列表,见下 |
| `add` | 道具列表,见下面"道具" |
| `w` | `0` 表示不要默认场景(只画 `add` 里的东西) |
| `grid` | `0` 表示不画地面网格 |
| `top` | `1` 用顶视画法(相机垂直向下时自动开启) |
| `focus` | 移焦 `[起始对焦距离, 结束对焦距离]`(米),焦外自动虚化 |
| `fx` | `"hand"` 手持晃动(`hand` 字段调幅度,默认 1)、`"shake"` 冲击震动(`shakeAt` 第几秒、`shakeAmp` 幅度)、`"pov"` 主观视角(画面下方出现双手),可写数组同时用 |
| `mb` | `1` 快速运动时加动态模糊(甩镜、急推用) |
| `cuts` | 一个镜头内部平均分成几段硬切,每段写自己的覆盖字段(正反打、跳切用) |
| `path` | `"fpv"` 内置穿越机飞行路线 |
| `preset` | 以某个预设为底,其它字段覆盖它 |
### 人物字段(`p` 数组里每一项)
| 字段 | 含义 |
|---|---|
| `x`, `z` | 站位,默认 (0, 9) |
| `h` | 朝向(度):0=面向 -z(默认相机方向),180=背对默认相机,90=面朝 +x(画面右),-90=面朝画面左 |
| `to` | 走到 `[x,z]`;`path` 多个点 `[[x,z],...]` 依次走过。走动时自动朝着前进方向、播放走路动作 |
| `t` | 这个人走动的时间段,默认跟镜头的 `t` 一样;`e` 默认匀速 |
| `run` | `true` 跑步(腿部动作更快);速度由距离和时间决定,走路约 1.4 米/秒,跑步 4–6 米/秒 |
| `v` | 衣服配色:1 蓝衣(默认主角)、2 棕衣、3 绿衣、4 紫衣 |
| `color`, `pants` | 自定义上衣、裤子颜色(如 `"#3e6db5"`),只在需要区分更多人时用,保持低饱和 |
| `height` | 身高(米),默认 1.75 |
| `act` | 动作,见下面"人物动作"。写一个名字=整个镜头都在做;写数组 `[{"a":"sit","t":[1,3]}]`=按时间段做 |
| `hold` | 手里拿的东西:`phone` 手机、`cup` 杯子、`book` 书、`sword` 剑、`stick` 棍子、`umbrella` 伞、`flag` 旗子 |
人物会根据和相机的相对角度,自动显示正面、侧面或背面。
### 人物动作(`act`)
动作都是预先画好的固定姿势,按时间切换,不做逐帧动画。复杂动作用最接近的姿势表示,细节写进提示词。
| 动作 | 样子 | 适合表示 |
|---|---|---|
| `stand` | 站立(默认) | 站着、说话、等待 |
| `walk` / `run` | 走 / 跑(有 `to`/`path` 时自动) | 移动 |
| `wave` | 一只手上下挥 | 打招呼、告别、呼喊 |
| `raise` | 举起一只手 | 举手、拿东西举高、示意 |
| `cheer` | 双手举起 | 欢呼、投降、伸懒腰 |
| `point` | 手臂向前(侧面)或向旁边(正面)平伸 | 指向、递东西、开门、拿手机看 |
| `punch` | 手臂快速前后伸缩 | 打斗、敲门、推搡 |
| `sit` | 坐(配合 `chair` 或 `bench` 道具放在人身后 0.2 米) | 坐着、开车(配合车) |
| `crouch` | 蹲 | 蹲下、躲藏、捡东西 |
| `jump` | 跳起落下(只写名字时每秒跳一次;写时间段时跳一次) | 跳、受惊 |
| `fall` | 向后倒在地上(0.6 秒),之后保持躺着 | 倒地、被击倒、晕倒 |
| `lie` | 躺在地上 | 躺着、睡觉、昏迷 |
例:`{"x":0,"z":9,"act":[{"a":"wave","t":[0,2]},{"a":"sit","t":[2,6]}],"hold":"cup"}`
### 道具(`add`)
每个道具:`{"s":"名称","x":..,"z":..}`,可选 `h` 高度(米,不写用默认)、`wd` 宽度(米,用于拉长墙)、`y` 离地高度(放在桌上等)、`dir` 朝向(度,只对车有用:0=车头朝镜头,90=车头朝画面右)。
| 名称 | 默认高度 | 说明 |
|---|---|---|
| `box` | 0.9 | 方块(也可当箱子、柜子、台子) |
| `pillar` | 5 | 柱子 |
| `table` | 0.75 | 桌子 |
| `chair` | 0.9 | 椅子 |
| `bench` | 0.5 | 长凳 |
| `screen` | 0.55 | 显示器 / 电视,放桌上用 `"y":0.75` |
| `bag` | 0.45 | 包 / 行李 |
| `rock` | 0.6 | 石头 |
| `tree` | 4 | 树 |
| `lamp` | 3.5 | 路灯 |
| `door` | 2.4 | 门(放在墙前一点点) |
| `wall` | 2.5 | 墙,用 `wd` 定宽度 |
| `car` | 1.5 | 汽车,自动按朝向显示正面或侧面 |
| `mark` | 0.06 | 地面小标记 |
清单里没有的道具,用最接近的道具或方块代替(比如 柜台=拉宽的 `box`,屏风=`wall`,箱子=`box`),在提示词里写清楚它是什么。不要为了一个道具去画新的像素图,除非用户要求扩充道具库(扩充时在 `lib/sprites.js` 的 `PROPS` 里加一项,保持同样的描边和低饱和配色)。
道具都是立着的像素图,总是正对镜头,所以顶视和大角度俯拍时会变成简单的方块。
### 景别速查(人物在 z=9,相机正对)
可见画面高度 ≈ 距离 × 20.25 ÷ mm。
| 景别 | 相机 | 看向 at |
|---|---|---|
| 大远景 | `{"y":2.5,"z":-14}` | 不写,`pitch` 约 -3 |
| 全景 | `{"y":1.0,"z":6.1}` | `[0,0.9,9]` |
| 中景(腰以上) | `{"y":1.3,"z":6.0,"mm":36}` | `[0,1.22,9]` |
| 近景(胸以上) | `{"y":1.42,"z":6.9,"mm":36}` | `[0,1.38,9]` |
| 特写(脸) | `{"y":1.48,"z":7.6,"mm":43}` | `[0,1.45,9]` |
| 大特写(眼睛) | `{"y":1.45,"z":8.33,"mm":54}` | `[0,1.45,9]` |
| 低角度仰拍 | `{"y":0.2,"z":6.5}` | `[0,1.3,9]` |
| 高角度俯拍 | `{"y":3.4,"z":5.2}` | `[0,0.9,9]` |
| 顶视 | `{"y":4.5,"z":9,"pitch":-90}` | 不写 |
人物不在 z=9 时,按相同的相对距离平移相机。
### 写参数的小技巧
- 相机路线不要穿过人物。人物朝向要和镜头意图一致:要看脸就让人物朝向相机(h 让人物面对相机所在方向)。
- 正面跟拍、背后跟随、侧面跟拍,用 `follow` 最省事;`off` 是相机相对人物的位置。
- 复合运镜(先推后摇、边升边环绕)用多个相机关键帧,每帧写 `t`。
- 多人对话:用两个人,过肩镜头时让前景人物离相机 1.2–1.5 米,偏到画面一侧,不要挡住说话的人。
- 渲染完一定看 `--sheet` 预览图再交付。
## 示例
**先推近再右摇到第二个人**(`examples/push-then-pan.json`)
```json
{ "dur": 6,
"c": [ {"t":0.4,"y":1.4,"z":0}, {"t":3.0,"z":5}, {"t":3.4,"yaw":0}, {"t":5.2,"yaw":35} ],
"p": [ {"x":0,"z":9}, {"x":5.5,"z":12,"v":2} ] }
```
**低机位跟拍一个迎面跑来的人**(`examples/low-angle-run.json`)
```json
{ "dur": 5, "e": "lin", "t": [0,5],
"p": [ {"x":0,"z":30,"to":[0,6],"run":true} ],
"follow": { "off": [[1.2,0.3,-3.5],[0.6,0.3,-2.2]], "look": [0,1.3,0] } }
```
**对话段落:双人 → 正反打 → 特写 → 拉远**(`examples/dialogue-scene.json`)
```json
{ "shots": [
{"preset":"F14","dur":2.5}, {"preset":"F19","dur":4},
{"preset":"F05","dur":2,"p":[{"x":0,"z":9,"v":2}]}, {"preset":"Y05","dur":4} ] }
```
**三个人站成一排,镜头绕到他们背后**(`examples/three-people-orbit.json`)
```json
{ "dur": 8, "e": "lin", "t": [0,8], "o": [6,6,20,200], "c": {"y":2.2,"mm":28}, "at": [0,1.0,9],
"p": [ {"x":0,"z":9}, {"x":-1.6,"z":9.6,"h":30,"v":2}, {"x":1.6,"z":9.6,"h":-30,"v":3} ] }
```
## 风格规则(不要破坏)
- 只有镜头在动;画面元素是固定像素图,不要逐帧重新像素化。
- 不加特效:没有光晕、星星、霓虹、抖动滤镜、溶解转场,画面上不放文字、取景框、参数。镜头之间一律硬切。
- 配色保持低饱和米灰;人物用预设配色,主角蓝衣深裤。
- 人物动作只用上面列出的固定姿势;更细的动作(表情、手势细节、打斗招式)在提示词里用文字描述。
## 限制
- 场景是一片开阔地面,没有完整的建筑和室内;室内用墙、门、桌椅摆出大致空间关系。
- 模式二的运动是从画面整体位移估算的近似值,适合复刻镜头语言,不追求逐帧精确。
Pliki w paczce (15)
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 1 KB
- SKILL.md 15 KB
- analyze.js 11 KB
- presets.json 34 KB
- render.js 3 KB
- examples/dialogue-scene.json 1 KB
- examples/low-angle-run.json 1 KB
- examples/props-and-actions.json 2 KB
- examples/push-then-pan.json 1 KB
- examples/three-people-orbit.json 1 KB
- lib/engine.js 14 KB
- lib/raster.js 5 KB
- lib/sprites.js 9 KB
Wersje
W bazie nie ma innych skilli o nazwie pixel-previs.
Migawka bazy z 13.11.2026 · wersja paczki e2b4b5060c04 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100flova-action-previs-video
Zamienia pomysły na sceny walki, istniejące plansze previs, trójwidoki postaci i referencje scen w ciągłe wideo akcji, kontrolując rytm, łączenie ujęć i spójność postaci. - 100video-motion-previs
Instaluje i obsługuje Motion Previs Studio przez CLI: zamienia wideo referencyjne w pakiety pozy, głębi i ruchu kamery. - 100previs-rerender
Zamienia surowy klip previs, biały model 3D lub animatic w gotowe opracowanie wizualne, zachowując kolejność ujęć, rytm cięć, kadrowanie i kierunki ruchu, z użyciem OFOX_API_KEY i wideo referencyjnego. - 100previs-control-passes
Blokuje ujęcie w 3D i eksportuje deterministyczne przebiegi kontrolne (szkielety, głębię, alfę, macierze kamery) z ComfyUI do generowania wideo. - 90previs-anchor-keyframes
Tworzy fotorealistyczne klatki kotwiczące z wizualizacji CG dla modeli wideo, takich jak Seedance, z zachowaniem pozy referencyjnej. - 90storyboard-cheatcode
Zamienia jedno zdanie o pomyśle w storyboard z kadrami i opcjonalnie w podgląd wideo, pytając przed każdym renderem.