Scene Scripts Templates

何时使用

在编辑或生成 scene-scripts.json时，用于了解如何正确使用模板，响应用户的验证、修改模板的请求

scene-scripts 结构要点

• 顶层常见字段：topic、fps、scenes。
• fps 常与工程一致（当前配置为 30）。
• 每个 scene 含 sceneId、items。
• 每个 item 至少含：order、template、param、content。
• content 为数组；元素多为 {"text": "..."}。口播以 content[].text 为准。
• 未知或非法 template 时，管线可能回退到默认模板（当前配置为 CENTER_FOCUS）。
• param 内不应长期存放 content 或 totalDurationFrames（校验会剔除）；时长与分句权威在 item 上。
• TEXT_FOCUS 使用 param.coreSentence（非空 string[]，每元素一行）与 param.coreSentenceAnchors（非普通 anchors）；锚点短语须为各段按顺序直接拼接后的子串。
• PUNCH_CAPTION 使用 param.punches（必填；每项 text（居中大字）+ showFrom（content 下标） 必填，可选 enterEffect / tone）；大屏文案以 punches[].text 为准，口播/底字幕仍走 content[]；anchors 的 text 宜为对应 punches[].text 的子串。
• 带 anchors 的模板：showFrom 为 content 数组的 0-based 下标，不是时间轴帧号。

图片类字段

• 工程 config.yaml 中的 image_style（供 image_prompt 类字段参考）：

  Bold comic-style illustration with thick black outlines on pure white background, heavy stroke weight, cartoon line art, flat vector icon, high contrast, no thin hairline, no pencil sketch, no shading, no glow, no dark or black background, isolated subject

修改范围

当用户目的是修改scene-scripts.json时，只操作这一个被指定的文件，不要额外修改scene等文件。

可用模板

为避免上下文过长，每个模板的 templateMeta 已拆分为独立 Skill。需要查看某个模板的详情时，请打开对应子 Skill。

• BEAT_SEQUENCE: references/BEAT_SEQUENCE.md
• CASE_BREAKDOWN: references/CASE_BREAKDOWN.md
• CAUSE_CHAIN: references/CAUSE_CHAIN.md
• CENTER_FOCUS: references/CENTER_FOCUS.md
• CHAT_BUBBLE: references/CHAT_BUBBLE.md
• CHECKLIST_REVEAL: references/CHECKLIST_REVEAL.md
• COGNITIVE_SHIFT: references/COGNITIVE_SHIFT.md
• CONCEPT_CARD: references/CONCEPT_CARD.md
• DATA_TABLE: references/DATA_TABLE.md
• DOS_AND_DONTS: references/DOS_AND_DONTS.md
• KPI_HERO: references/KPI_HERO.md
• MAGNIFYING_GLASS: references/MAGNIFYING_GLASS.md
• METHOD_STACK: references/METHOD_STACK.md
• PANEL_GRID: references/PANEL_GRID.md
• PEER_INDUCT: references/PEER_INDUCT.md
• PROGRESS_RING: references/PROGRESS_RING.md
• PUNCH_CAPTION: references/PUNCH_CAPTION.md
• QA_REVEAL: references/QA_REVEAL.md
• QUOTE_CITATION: references/QUOTE_CITATION.md
• SOURCE_CITATION: references/SOURCE_CITATION.md
• SPLIT_COMPARE: references/SPLIT_COMPARE.md
• STAT_COMPARE: references/STAT_COMPARE.md
• STEP_LIST: references/STEP_LIST.md
• TEXT_FOCUS: references/TEXT_FOCUS.md
• TIMELINE: references/TIMELINE.md
• TREE_DIAGRAM: references/TREE_DIAGRAM.md

维护方式

• 修改 src/components/templates/*.tsx 后，重新运行 export_template_meta_skill.py 以更新主 Skill 与所有子 Skill。