pomelor611 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（每镜标准流程）
- 看故事板九宫格实际画面，决定本镜挂哪些定版参考图（不按旧剧本文字加戏）。
- 挑参考图：按 AGENTS.md 槽位契约安排受控多参考
image2video：clean 故事板（拍摄脚本）→角色定版（唯一外观依据）→场景定版（布局）→按需道具。 - 写 prompt：质感词 + 按需套铁律模板（角色/比例/零文字/场景锁定/装备）。
- 生成视频前先把方案报给用户，得到"OK"才
--run（图片生成可直接做）。 - 【历史经验，未重测】可先用 720p 试错，再视需求以 1080p 定稿；价格以平台提交前的可见估算为准。
- 段尾留转场钩子（光/门/手等出口动作），方便后期融合。
- 全部镜头齐 → 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 条，违反多半返工）
| # | 铁律 | 要点 |
|---|---|---|
| 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 / 环境要点（一次性）
$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。
完整细节索引（读这些拿全文）
| 想做什么 | 看这个文件 |
|---|---|
| 完整方法论（前期定调→建资产→生成→剪辑全流程深讲） | 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 审计同步认证、模型名与受控多参考槽位；详见能力快照。