- name
- huo15-comic-orchestrator
- displayName
- 火15 AI 漫剧编排器
- description
- 一键生成 3-5 分钟国风 AI 漫剧。主题→分幕剧本→角色卡→分镜关键帧→图生视频→TTS 配音→对口型→BGM→字幕→拼接成片。自带三级成本熔断（硬限/预警/降级建议），支持失败续跑。触发词：AI 漫剧、生成漫剧、国风漫剧、仙侠短剧、comic drama、做漫剧。
- version
- 0.1.0
- aliases
火15 AI 漫剧编排器
主入口 skill，串起家族其他 8 个子 skill 完成 3-5 分钟国风漫剧生成。
⚠️ 硬规则
- 成本熔断优先：开工前估算超
cost_cap立即阻止，不得强行继续 - 用户确认闸门：估算出来后必须等用户"确认"/"开始"再执行
- 国风为默认：不强制改风格时默认
三渲二国风+仙侠 - Checkpoint 续跑：任何失败都从
.checkpoint.json恢复，不重做已完成步骤
一、家族依赖
| 子 skill | Step | 本 skill 如何调用 |
|---|---|---|
| huo15-comic-script | 1 | python ../huo15-comic-script/scripts/script_gen.py |
| huo15-comic-character | 2 | python ../huo15-comic-character/scripts/character.py |
| huo15-comic-storyboard | 3 | python ../huo15-comic-storyboard/scripts/storyboard.py |
| huo15-comic-video | 4 | python ../huo15-comic-video/scripts/video.py |
| huo15-comic-dub | 5 | python ../huo15-comic-dub/scripts/dub.py |
| huo15-comic-lipsync | 6 | python ../huo15-comic-lipsync/scripts/lipsync.py |
| huo15-comic-bgm | 7 | python ../huo15-comic-bgm/scripts/bgm.py |
| huo15-comic-edit | 8 | python ../huo15-comic-edit/scripts/edit.py |
二、Agent 工作流
Step 0：收集输入
必填：theme（主题一句话）、duration_total（秒数，180/240/300） 可选：style、genre、character_hints、cost_cap、enable_lipsync
Step 1：预估成本（硬熔断点）
from _shared.cost_guard import estimate_total, CostGuard, BudgetExceeded
n_scenes = duration_total // 5
est = estimate_total(
n_scenes=n_scenes, n_characters=3, total_chars=800,
resolution=resolution, # 720p 默认 / 1080p 贵 2.3×
fast=fast_mode, # seedance-fast 打 5 折
enable_lipsync=enable_lipsync,
enable_bgm=enable_bgm,
)
guard = CostGuard(cap=cost_cap or 600.0, project_dir=project_dir)
try:
guard.preflight(est["total"])
except BudgetExceeded as e:
# 立即报给用户降级建议，等用户选择
report_to_user(str(e))
returnStep 2：向用户确认
收到！将生成 {duration_total}s 国风漫剧（{n_scenes} 镜头）
主题：{theme}
风格：{style} / 类型：{genre}
预估成本：
· 剧本 ¥0.00（本地）
· 角色 ¥{image}
· 视频 ¥{video}
· TTS ¥{tts}
· 口型 ¥{lipsync}
· BGM ¥{bgm}
· 合计 ¥{total}（熔断上限 ¥{cap}）
确认开始吗？Step 3-10：按顺序调用子 skill
每步前 checkpoint 查重（if cp.is_done(step): skip），每步后 guard.charge(step, item, cost)，触发预警即告知用户，触发熔断即停并给降级方案。
Step 11：交付
输出 output/{project_slug}/final.mp4 路径、实际成本、耗时。
三、主入口脚本
scripts/run.py：
python scripts/run.py \
--theme "少年剑仙三年归来" \
--duration 240 \
--style 三渲二国风 \
--genre 仙侠 \
--cap 600详见 scripts/run.py。
四、熔断降级策略
_shared/cost_guard.py 的 BudgetExceeded 抛出时，默认提供 5 选 1：
- 缩短总时长
- 减少镜头数
- 关闭对口型（省 ~10%，Kling 2.6 便宜后此项影响小）
- 启用
--fast（seedance-fast 打 5 折，视频占大头，省 ~40%） - 降 resolution：1080p → 720p 省 ~60% 视频费；720p → 480p 再省 ~50%
- 提升 cost_cap
Agent 必须让用户二次确认任何降级，不得自动降级。
成本主导因素（720p 基线）
视频占比最高（~85%）→ 优先调视频参数：
fast=True→ 视频减半resolution=480p→ 视频再减半scene_duration=4→ 视频线性减 20%
Lipsync 成本从 2026-04 起大幅下降（Kling 2.6: ¥0.72/5s），不再是大头。
五、Agent 直写剧本模式（推荐）
不建议让 scripts/script_gen.py 调 Anthropic SDK 生成剧本，因为：
- Claude（即本 Agent）就是 LLM 本体，再开 SDK 调自己是冗余
script_gen.py走 SDK 要消耗 token，Agent 直写不花钱
推荐流程：Agent 按 huo15-comic-script/SKILL.md 的 JSON schema 直接写 script.json 到 output/{slug}/，然后：
# 跳过 LLM 调用，只校验
python huo15-comic-script/scripts/script_gen.py \
--theme "..." --duration 240 \
--input-json output/{slug}/script.json \
--out output/{slug}/script.jsonrun.py 支持 SCRIPT_PREWRITTEN=1 环境变量跳过 SDK 调用路径。
Demo 见 examples/demo-xianxia-180s.json。
六、Checkpoint 续跑
output/{project}/.checkpoint.json 记录每步与镜头级状态：
{
"script": "done",
"characters": "done",
"storyboard": "done",
"videos": "running",
"videos.S01": "done",
"videos.S02": "done",
"videos.S03": "running",
...
}重启时扫描，从 next_pending() 续跑，已完成镜头不重做。