CS 暗夜知识片
把一个抽象概念讲成一部安静、克制、有电影感的知识短片。本 skill 的暗夜星空视觉是用户选择这一风格时使用的实现，不是所有知识视频的默认视觉。先找到选题的核心问题与可见的动作，再决定使用现有场景、扩展场景，或为该题材另做画面。
交付
- 一个项目目录：
spec.json（唯一需要手写的文件）、audio/、timeline.json、subtitles.srt、preview.jpg、video.mp4。 - 视频默认 1920×1080、30fps、H.264 + AAC；可选中文配音（edge-tts）+
score.py生成的配乐与音效（参照原片：A 小调低音长音、温暖和弦铺底、玻璃钟琴、与画面事件逐一对齐的打字/转轮/呼啸/撞击声，-16 LUFS）；画面内置中英双语字幕，同时导出subtitles.srt。 - 不上传、不发布。BGM 只用用户提供的文件（
spec.bgm）。
风格速查（细节见 references/style.md）
- 底色近黑带一点藏蓝，慢速闪烁的星空，暗角 + 轻微颗粒。
- 字体：中文宋体/衬线（Noto Serif SC），英文 Lora 斜体；不用黑体。
- 颜色只有三种语义：金＝重点/惊奇/答案，冰蓝＝结构/线条/已知，绯红＝噪声/错误/被排除。
- 左上角章节标签
01 猜 THE GUESS；底部中文字幕 + 英文斜体小字。 - 动效慢：淡入 0.6–1s、缓出曲线；光点有辉光和呼吸感；不要弹跳、不要转场特效。
工作流
1. 先定三件事
缺了才问，能自己判断就不问：
- 主题与一句话结论（这支片子最后让观众记住哪一句）
- 时长（默认 2–3 分钟；每分钟约 220–250 字口播）
- 是否需要英文字幕（默认要，和参考片一致）
2. 写口播稿（见 references/script.md）
先提炼一句话结论、主要误解和适合这个题目的画面隐喻，再设计钩子与章节。可参考“体验式钩子 → 标题 → 3–5 章 → 回到开头收束”，但故事结构由内容决定，不必重复参考片的章节或结尾。
每句 8–25 字，一句一个意思，适合被逐句打在字幕上。数字和史实要核对，不编造。
3. 拆场景写 spec.json（见 references/spec.md）
把 assets/example-spec.json 当作格式示例，不复制其中的场景顺序或视觉隐喻。先列出每章要让观众看见的变化，再选现有场景类型；现有类型表达不了时，按 references/spec.md 的扩展说明新增场景。
| 概念形态 | 场景类型 |
|---|---|
| 预期 / 猜下一个字 / 填空 | typewriter |
| 候选词概率、采样、温度 | probs |
| 片名 | title |
| 二分、度量、量化 | numberline |
| 罕见事件、时间、希望、灯火 | landscape（烽火、时间条、弧线、灯） |
| 日常 vs 罕见新闻 | city（夜景、下雪、头条） |
| 公式、定义 | formula |
| 语言、冗余、噪声、压缩 | textplay |
| 传输、编码、信道 | signal / probe |
| 同样数据不同意义 | compare |
| 信息茧房、同质化 | cards |
| 名人原话 | quote |
| 真实图片（星图、照片） | image |
| 停顿、提问 | orb / blank |
事件时间用 "L2"（本场第 2 句开始）、"L2e"（第 2 句结束）、"L2+0.5" 锚定到口播，配音变长变短都不会错位。
4. 配音 → 时间轴 → 预览 → 渲染
把 scripts/ 下 4 个文件放在任意位置，项目目录里只放 spec.json：
bashpython scripts/tts.py <项目目录> # 逐句配音 audio/line_XXX.mp3（需联网，免费） node scripts/timeline.mjs <项目目录> # 按真实音频长度排时间轴，拼 narration.wav + subtitles.srt python scripts/score.py <项目目录> # 按场景和事件生成配乐 + 音效 score.wav（改了 spec 就重跑） node scripts/render.mjs <项目目录> --preview # 每场 2 帧拼成 preview.jpg —— 必须先看 node scripts/render.mjs <项目目录> --still 42 # 单帧排查 node scripts/render.mjs <项目目录> # 全量渲染 video.mp4 node scripts/render.mjs <项目目录> --remux # 只换声音：复用已渲染画面重新混音
依赖：Node 18+、playwright（含 Chromium）、ffmpeg、Python 3；配音需安装 edge-tts，程序配乐需安装 numpy scipy。已有 Chrome 的环境可用 CHROME_EXECUTABLE 指向其可执行文件，PLAYWRIGHT_MODULE 可指向现有的 Playwright 模块目录。在目标环境中显式安装依赖，脚本不会自动修改 Python 环境。没有配音时 timeline 按字数估算，可以先出无声版确认画面；修改文案或音色后重跑 tts.py，它会只更新变化的句子。
5. 验收（见 references/qa.md）
必须实际看 preview.jpg，再抽查关键事件帧（数字揭晓、灯亮、遮罩出现）。常见问题：字幕压住画面元素、事件早于对应口播、文字超出画面、辉光过曝成灰屏。
边界
- 本 skill 负责“讲清一个知识点”的解说片；真人口播、直播切片、产品演示不在范围。
- 不把别人的原片文案照搬进新片；参考的是结构和视觉语言，文案自己写。
- 图片素材只用用户提供或可合法使用的（公共领域 / CC），在 spec 里记录来源。
