libtv-video-production

Imported from airen3339/libtv-video-agent (SKILL.md). Install upstream with npx skills add airen3339/libtv-video-agent. Copyright stays with the author.

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）为准；多参考 image2video 的唯一槽位契约在 AGENTS.md。

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

心智模型（一句话）

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

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

SOP（每镜标准流程）

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

单镜命令骨架：

$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 条，违反多半返工）

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

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

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

Windows / 环境要点（一次性）

$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 本仓库后的本地绝对路径：

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

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

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

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

版本

• 2026-08 · v2：根据 CLI 1.0.2 审计同步认证、模型名与受控多参考槽位；详见能力快照。