# Libtv Video Production

> Use when an agent needs to create or maintain LibTV CLI video shorts from storyboards, scripts, or reference images.

- Skill: `pomelor611/libtv-video-production` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add pomelor611/libtv-video-production`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pomelor611/libtv-video-production/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector WARNING)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: pomelor611 (https://skillmd.com/u/pomelor611)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pomelor611/libtv-video-production

---


# LibTV 短片制作（分镜 → 成片）

把"一组分镜"用 **LibTV CLI** 做成一支短片的通用方法论。美术基调可换（2D 绘本 / 写实 / 任意风格），方法论不变。本 SKILL.md 只给**精简操作指引 + 速查**；完整细节看同目录 `AGENTS.md` 与 `references/*.md`（见末尾索引）。

> ⚠️ 旧 `sk-libtv-*` OpenAPI 已废弃，**只用 CLI**（`libtv login web` 登录）。旧 API 建的项目不进 web dashboard。

> **v2 当前审计**：认证、schema、模型标识符与受控多参考结论以[能力快照（2026-08-05）](references/capability-snapshot-2026-08-05.md)为准；多参考 `image2video` 的唯一槽位契约在 [AGENTS.md](AGENTS.md#32-参考图槽位契约唯一准则)。

> **证据边界**：仅认证、schema、modelName、受控多参考 `image2video` 槽位与 `--run` 超时后的既有节点查询属于当前审计观察；其余模型行为与生产启发式均为【历史经验，未重测】。

---

## 心智模型（一句话）

```
定调(质感词) + 建定版资产(角色/场景/道具) + 画故事板九宫格
  → 每镜 image2video(挂 故事板+定版图) 720p 试错
  → 全部齐 → ffmpeg 本地剪辑(转场+配乐+旁白) → 1080p 定稿
```

- **CLI 三层结构**：项目 → [分组] → 节点。节点参数 `-s` 写 `data.params`（走 schema），`-u` 写节点顶层属性。
- **故事板 = 唯一拍摄脚本**：九宫格只决定"怎么拍/表达什么"（构图/景别/运镜/表演），风格色彩由设定图 + 质感词承担。
- **剪辑在本地做**，不靠云端 `video-clip` 节点——ffmpeg 对转场/配乐/字幕可控得多。

---

## SOP（每镜标准流程）

1. **看故事板九宫格实际画面**，决定本镜挂哪些定版参考图（不按旧剧本文字加戏）。
2. **挑参考图**：按 [AGENTS.md 槽位契约](AGENTS.md#32-参考图槽位契约唯一准则)安排受控多参考 `image2video`：clean 故事板（拍摄脚本）→角色定版（唯一外观依据）→场景定版（布局）→按需道具。
3. **写 prompt**：质感词 + 按需套铁律模板（角色/比例/零文字/场景锁定/装备）。
4. **生成视频前先把方案报给用户，得到"OK"才 `--run`**（图片生成可直接做）。
5. 【历史经验，未重测】可先用 720p 试错，再视需求以 1080p 定稿；价格以平台提交前的可见估算为准。
6. 段尾留**转场钩子**（光/门/手等出口动作），方便后期融合。
7. 全部镜头齐 → ffmpeg 统一剪辑成片。

单镜命令骨架：

```powershell
$libtv = "$env:USERPROFILE\.libtv\libtv.exe"
& $libtv account info
& $libtv model star-video2  # 查询 schema 的 modelKey
& $libtv node create "shot07_video" -t video `
  --prompt "{{Image 1}} 是 clean 九宫格，唯一拍摄脚本；{{Image 2}} 是角色定版，唯一外观依据；{{Image 3}} 是场景定版，只确定布局。<本镜画面描述> + <质感词> + <按需铁律>" `
  --left "sb_07_clean" --left "wife_fixed" --left "scene_classroom" `
  -s model="StarVideo 2.0" -s modeType=image2video `
  -s ratio=16:9 -s resolution=720p -s duration=8 -s enableSound=off --run
```

---

## 关键铁律（5–8 条，违反多半返工）

| # | 铁律 | 要点 |
|---|---|---|
| 1 | **质感词锁死、每镜必带** | 开工先定一句固定质感词（如 2D 绘本：`2D柔和动画绘本插画风格…gentle 2D storybook；绝不要3D/写实`），所有图/视频原样复用，保证全片同风格。 |
| 2 | **定版图作锚、按角色槽位锁外观** | 凡涉及已定版的角色/场景/道具，必须挂定版图，**绝不只靠文字还原**。角色锚定说“角色定版图”，不把槽位编号外推到未测模式；九宫格重绘用 4K 是【历史经验，未重测】。 |
| 3 | **【角色铁律】+【人物比例铁律】** | 严格按角色定版图，9 格同脸同发型同服装；写明年龄+成年约 6.5 头身，禁幼态/大头娃娃/裁头/变形。【历史经验，未重测】 |
| 4 | **【零文字零数字铁律】** | 格内不写任何字（单据画横线、屏幕画亮屏）；prompt 注明"格号/箭头是标注不是画面内容"，否则视频会照抄穿帮。 |
| 5 | **负面词不点名（反召唤）** | Seedance 负面指令弱：要排除某元素就**通篇不提它的名字**，改用【画面元素铁律】正面穷举"画面里有且只有：…"（"别想大象"效应）。 |
| 6 | **【场景锁定铁律】+ 控时长** | 长镜头后半会漂移：写"全程同一房间、家具按图不变"；时长压到 ≤12s 降漂移。 |
| 7 | **【镜头铁律】以人为主体** | 挂场景图易变成环境展示片：写"九宫格是唯一脚本、镜头紧跟人物、禁长段空镜/环境运镜，场景只是背景"。 |
| 8 | **真实记忆镜头先问用户** | 含真实仪式/道具/构图的镜头别凭脚本猜，先拿照片或口述参照再设计。 |

铁律完整模板（可直接复制）见 `references/prompt-recipes.md`。

---

## 高频坑速查（最常踩的 3–4 个）

| 坑（案例） | 根因 | 解法 |
|---|---|---|
| **角色漂移/换脸**（案例 06 长发漂移、13–16 幼态裁头） | 编辑九宫格没挂锚点 / 分辨率低 | 【历史经验，未重测】重绘时以角色定版图作外观锚点 + 原九宫格只取构图 + 角色/比例铁律 |
| **格号/文字被照抄进画面**（案例 19/22/27 气球上"②"、20 账单文字） | 九宫格里有格号、箭头、文字 | 零文字铁律；仍穿帮就 nebula image2image 做 `sb_XX_clean`（去格号/箭头）喂片版，**clean 版也要逐格 QC**（重绘可能加戏） |
| **多出实体**（案例：第 3 只狗、水下凭空冒出狗） | 参考图本身含该元素 / 负面词点名召唤 | 先查所有参考图有没有那元素，再改 prompt；用干净参考 + 正面穷举画面元素，排除项不点名 |
| **审核"未通过安全审核"三连拒**（案例 30） | 某参考图或某格触发审核（如人脸贴宠物特写） | 【历史经验，未重测】短时探针 + 参考图二分排查定位真凶后替换；退款/积分以平台可见确认为准 |

全量 33+ 坑（CLI 操作 / 一致性 / 长镜头 / 道具 / 剪辑 / 审核 / Windows 中文路径）见 `references/pitfalls.md`。

---

## Windows / 环境要点（一次性）

```powershell
$libtv = "$env:USERPROFILE\.libtv\libtv.exe"   # CLI 路径
& $libtv login web                              # 浏览器登录，凭据落 ~/.libtv/credentials.json
# cd 到项目目录后：libtv project use <PROJECT_ID> 绑定 cwd（不假定 ID 是 UUID）
```

- **中文 prompt 用内联 PowerShell**，不写 `.ps1`（GBK 读乱码）。
- cv2 等读中文路径用 `imdecode(np.fromfile(...))` / `imencode+tofile`。
- 【2026-08-05 实测】`--run` 前台超时后先查询同名既有节点，再决定是否重试；只消费已验证 MP4 结果。
- 音乐节点 create 报"场景不一致"→ 加 `-s scene=Music`。

详见 `references/content-safety-and-env.md`。

---

## 安装方式

把本仓库目录（含 `SKILL.md` + `AGENTS.md` + `references/`）**复制或软链**到 Claude Code 技能目录即可被自动发现。`<REPO_DIR>` 替换为你 clone 本仓库后的本地绝对路径：

```powershell
# Windows（软链推荐，改一处两处同步）
New-Item -ItemType SymbolicLink `
  -Path "$env:USERPROFILE\.claude\skills\libtv-video-production" `
  -Target "<REPO_DIR>"
```

```bash
# macOS/Linux 等价
ln -s "<REPO_DIR>" ~/.claude/skills/libtv-video-production
```

目录结构须保持 `SKILL.md` 在技能根、`references/` 为同级子目录，否则下方索引的相对路径会失效。其他工具（Codex / CodeBuddy 等）的接入见仓库根 `README.md`。

---

## 完整细节索引（读这些拿全文）

| 想做什么 | 看这个文件 |
|---|---|
| **完整方法论**（前期定调→建资产→生成→剪辑全流程深讲） | `AGENTS.md` |
| CLI 全命令矩阵 / 节点类型 / `-s` vs `-u` / NDJSON 管道 / 能力边界 | `references/cli-reference.md` |
| 端到端制作工作流（三阶段每步怎么落地） | `references/production-workflow.md` |
| Prompt 铁律模板全文（角色/比例/零文字/场景锁定/装备/in-scene 锚定…可复制） | `references/prompt-recipes.md` |
| ffmpeg 本地剪辑流水线（转场 xfade / 音轨 acrossfade / 字幕 / 拼装核对） | `references/editing-pipeline.md` |
| 内容审核排查 + 真人合规 + Windows/PowerShell 怪癖 | `references/content-safety-and-env.md` |
| 全量踩坑速查表（按主题分类，跨项目通用） | `references/pitfalls.md` |

## 版本

- **2026-08 · v2**：根据 CLI 1.0.2 审计同步认证、模型名与受控多参考槽位；详见[能力快照](references/capability-snapshot-2026-08-05.md)。