libtv-video-production

name libtv-video-production description Use when an agent needs to create or maintain LibTV CLI video shorts from storyboards, scripts, or reference images. 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 审计同步认证、模型名与受控多参考槽位；详见 能力快照 。