简介 animated-character-explainer 是一个用于制作分层动画解说视频的技能，产出约45–90秒、16:9、带旁白的解说短片。角色由 gpt-image-2 在透明背景上生成，并保持统一角色形象。
用途与示例 每个场景都是分层的“舞台”：背景、道具、角色和图标。旁白驱动节奏。技能内含两个示例： examples/prismor-enterprise/ 是一支62.8秒的影片，由四个角色（Maya、Leo、一个 agent bot、一名 auditor）组成，共14个姿势，见 cast_sheet.png。 examples/starter/ 是同样的11节拍结构，但每句台词都是 [placeholder]，并使用替身角色阵容。
工作流
- 初始化：运行 python3 scripts/main.py init my-film，会复制 starter 模板。
- 脚本（vo.txt）：按“痛点问题 → 安抚 → ‘Here comes [Product]’ → 工作原理 → 配置 → 触达 → 收益 → 信任 → 行动号召”的叙事弧来写；将脚本过一遍 no-ai-slop 技能，并且所有主张都取自产品自身文档。
- 角色设定（cast.json）：包含一个共享样式块（角色、道具和背景前缀）以及一套配色。每个角色有 desc 和命名姿势；同时列出道具和空背景。
- 运行 python3 scripts/main.py cast --brief my-film/brief.json。该命令先在透明背景上生成基础形象，再以基础图作参考，通过 gpt-image-2 编辑生成每个姿势，使面部、发型和服装保持一致。已存在的文件会保留；cast <name> 可重新生成单个角色。
- 将真实 logo 放到 assets/logo.png。
- 配音：运行 python3 scripts/main.py voice（TTS 加 Whisper 词级时间戳）。此步骤之前，先检查并用预估时间做静帧预览。
- 节拍（brief.json）：每个节拍从脚本中的提示短语（at）开始；图层和姿势切换也可以有自己的提示点。
- 检查（溢出、未填充占位符、句末句号）→ 静帧预览 → 渲染。旁白会自动混入。
舞台图层 每个节拍都有 "type": "stage"，以及 bg 背景、cam: [z0, z1, fx0, fx1]（视差漂移，每层按深度 z 移动）、可选的 veil（left 或 right，用于保证文字可读）和 caption。 图层键：
- sprite：img、x、y（底部锚点，占画面比例）、h（占画面高度比例）、anchor: bottom|center、enter: left|right|up|pop|fade、at（提示点）或 t、idle: breathe|bob|float、flip、swap: [{at, img}]（按提示点切换姿势）、exit_at。
- icon tile：icon: lucide:<name>|brand:<thesvg slug>、size、color、label、x、y、enter: pop、at。
- label：label、size、font、color、anchor。
- flow：flow: [{icon, label, at}]、box: [x0, y0, x1, y1]（图标之间用箭头连接，例如在白板道具上绘制）。
- list：list: [{icon, color, text, at}]、x、y、gap（图标项目符号列表）。
- lines：lines: [[x, y], …]、from: [x, y]（从中心点出发的连接线，例如从云到笔记本电脑）。
- pins：pins: [city keys]（在世界地图背景上放置城市图钉）。
其他节拍类型：logo（环形枢纽加真实 logo，最好配 "tr": "whoosh"）、scene、bullets、split、map、cards 和 cta。转场默认是交叉淡入淡出，也可以设为 "tr": "whoosh"。
技巧
- 角色和道具应要求全身、透明背景、无地面、无阴影；背景应描述为带开阔地面的空房间。
- 在样式块中保持一套配色，正是它让分别生成的图像看起来像同一套。
- 姿势提示只描述变化，身份由参考图承载。
- flip 会镜像 sprite；请检查指向性姿势是否仍指向对应目标。
规则
- 字幕是细线之间的朴素小型大写字母，不使用方框、胶囊或斜体。屏幕文字不留句末句号。只使用真实 logo。绝不编造客户评价。AI 语音应予以披露。
收费、价格和平台支持情况：暂未提供。