--- name: science-video description: 一条龙制作科普短视频(Vibe知识大赏 同款流程):选题 → 事实核查 → 分镜文案 → 用代码绘制原创动画 → 渲染 → 混 BGM → 生成封面 → 写发布文案,可选在短视频平台填好发布表单、等用户确认后发布。当用户说“做一期 XX 的科普视频”“下一期做 XX”“把这期发出去”时使用。 --- # 科普短视频工作流(Vibe知识大赏 工具包) 用户只需要给一个选题(可附参考资料)。以下步骤按顺序执行,每一步都要实际完成,不要只描述打算怎么做。 这个 skill 来自 RongCraft 的科普短视频系列“Vibe知识大赏”,原版由 Claude Opus 5.5 制作。工具包说明见 README.md,来源:https://ai.rongcraft.com/tools/vibe-knowledge ## 第一次使用:先确认这几件事 如果工作目录里还没有 `发布记录.md`,先问用户,然后把答案写进 `发布记录.md` 的开头,以后不再重复问: - **系列名**:封面标签、话题和合集都用它(例如“Vibe知识大赏”)。 - **输出目录**:成片、封面和发布文案放在哪里(默认是项目脚本旁边的 `output/<标题>/`,也可以用环境变量 `VIDKIT_OUT` 指定)。 - **背景音乐**:`BGM` 文件夹里放一首用户**有使用权**的音乐(或用 `VIDKIT_BGM_DIR` / `VIDKIT_BGM` 指定)。没有就先做无 BGM 版本,绝不去网上下载音乐。 - **发布平台**:抖音、视频号、B 站……决定标题长度和话题写法。 `发布记录.md` 里用一张表记录每一期: | 期数 | 标题 | 成片 | 制作日期 | 平台 | 状态 | 发布标题 | |---|---|---|---|---|---|---| ## 内容方向 **借一个硬核的东西,最后落到人生道理上,让观众产生共鸣。** 硬核的东西可以是算法、物理/数学定律、统计规律、经济学模型、冷知识。范例:“80 岁活一生,40 岁是中点吗?”→ 韦伯—费希纳定律 → 对数感知模型下 18 岁就是主观中点 → 所以成年后的每一年都要主动制造新鲜感。 选题的三个硬标准(缺一个就换题): 1. 有一个**可以推导出来的反直觉结论**(最好是具体数字)。 2. 推导过程**3–5 步能讲完**,每一步能画成一张图。 3. 结论能**自然映射**到一个观众熟悉的人生处境,不是硬凑。 ### 片子结构(成片 90–150 秒) | 段 | 作用 | 要求 | |---|---|---| | 0 悬念开场(前 3 秒) | 让人停下来 | 第一帧**不淡入**,直接大字抛一个具体、反直觉、和观众自己有关的问题或断言。第一句字幕整句出现(引擎已默认),之后恢复打字机。 | | 1 常识答案 | 先让观众点头 | 给大家默认的答案,“从日历上看确实如此”。 | | 2 硬核推导 | 建立信任 | 3–5 步,一步一图:公式、曲线、算法步骤、数据。每步都要有“所以”,不要堆术语。 | | 3 反转结论 | 情绪高点 | 推导出的那个数字或结论,用最大字号 + 强调色 PINK 单独一屏。 | | 4 边界说明 | 诚实 | 一句话:这是模型/假设,不是铁律。标签用 PURPLE。不要拖沓。 | | 5 落到人生 | 共鸣 | 从结论推出一个具体可感的处境或建议,一两句,说人话,不说教。 | | 6 结尾互动 | 评论 | 抛一个二选一或填空的问题,明确说“评论区告诉我”。 | 写文案时先把“反转结论”和“人生落点”两句写出来,再倒推前面的内容。 ## 默认偏好(用户没有另外说明时照做) - **不要配音**:字幕烧进画面,edge-tts 只用来估算每句字幕停留多久。 - **字幕打字机效果**:逐字淡入,整句宽度的字幕框,最后整句淡出。vidkit 默认 `SUB_MODE='type'`;全片第一句例外,整句直接出现(`SUB_FIRST_INSTANT`)。 - **节奏 1.25 倍**:vidkit 默认 `SPEED=1.25`、`NARRATION=False`。 - **背景音乐**:只用用户放进 BGM 文件夹、确认有使用权的音乐。 - **视觉:深色主题**(vidkit 默认 `VIDKIT_THEME=dark`)。深色底,强调色高饱和。分工:`CYAN` 公式/曲线,`PINK` 反转结论,`ORANGE` 常识/参照值,`PURPLE` 假设/说明,`GREEN` 正面,`RED` 负面,`SUNC` 高亮。背景保持纯深色,不要大面积亮色块;卡片用 `CARD`,分割线用 `LIGHT`。另有暖米色主题 `VIDKIT_THEME=warm`。 - **角色必须原创**:用代码自己画,不能模仿任何已有的动漫、品牌或 IP 形象。模板里的小人只是占位;用户有自己的系列角色就用它,没有就和用户一起设计一个(发型、衣服、配色和一个小特征),之后每期沿用。引用原文只用很短的意译。 - **话题**:`#<系列名>` 永远放第一个,再加 `#科普` 和本期 2–3 个关键词。 - **合集**:`<系列名>`。 ## 环境 - 需要 Python 3.10+、`pip install pillow edge-tts`,以及在 PATH 里的 `ffmpeg` / `ffprobe`。 - 中文字体:vidkit 会在 Windows / macOS / Linux 的常见位置查找;找不到时请用户设置 `VIDKIT_FONT`(和 `VIDKIT_FONT_BOLD`)。很多中文字体**没有下标/上标数字字符**(₀ ₁ ² 等会变方框),公式里用普通数字或改写成文字。 - 输出目录如果在网盘同步文件夹里,同步客户端可能干扰渲染:先在本地临时目录里做,做完再把成品复制过去。 - 项目模板是 `template.py`。每期复制一份到工作目录,改名为 `<拼音>.py`;`vidkit.py` 放在同一目录、上一级的 `tools/` 目录,或用 `VIDKIT_HOME` 指定。 - edge-tts 调用的是微软 Edge 的在线朗读服务,需要联网;偶尔会返回 NoAudioReceived,vidkit 已经内置了重试;**不要传 rate 参数**。 ## 步骤 ### 1. 定期数 读取 `发布记录.md`,下一期 = 表里最大的 No. + 1。 ### 2. 研究与事实核查 - 列出要用到的事实:年份、人名、著作名、公式、数据,每条都要核实。 - **模型类结论必须标注前提**:“在这个模型下”“按这个假设”。不要把模型推论说成科学事实。 - 公式要自己算一遍,片子里出现的数字要能从公式推出来。 - 拿不准的事实,要么删掉,要么改成更保守的说法,并在最后的汇报里列出来。不要编造数字或比喻。 ### 3. 写分镜文案 - 按上面的 7 段结构写。每段 2–5 句,每句字幕 30 字以内;超过 22 字时要能在逗号或句号处自然断成两行。 - **控制总长**:`tts` 输出的“成片”时长最好在 90–150 秒;比 BGM 长时 BGM 会循环,要在汇报里说明。 - 默认不停下来等用户审文案;如果用户说过“先给我看文案”,就在这里暂停。 ### 4. 写项目脚本 - 复制 `template.py`,改写 SCENES、角色函数、各场景函数,以及 SERIES 和 COVER(期数、标题、英文名、问句)。 - 字幕区在 y ≥ 960,画面内容不要放进这个区域。章节标签放在左上角。 - 可用的工具函数:`text / rrect / ell / circ / poly / lines / arrow / card / tag / check / cross / dashed / speech / thought / layered / arc / pie`(layered 用来画真正的半透明叠加)。 - 开场场景(第一个 scene)第一帧就要是完整画面:不要用 `P(t, 0, .5)` 做淡入,直接画。 ### 5. 生成字幕定时并检查画面 ``` python <拼音>.py tts python <拼音>.py stills <每个章节挑 1–2 个成片秒数> ``` 把静帧拼成 2×2 的合图后查看:检查文字是否重叠、有没有被裁掉、元素是否压到字幕区、深色底上有没有看不清的深色文字。有问题就改脚本,重新出静帧,直到全部没问题。 ### 6. 渲染与合成 ``` python <拼音>.py render python <拼音>.py mux python <拼音>.py cover ``` 然后验证:用 `ffprobe` 确认视频和音频时长一致;用 ffmpeg 的 `volumedetect` 确认 mean 大约 −16 dB;查看两张封面,确认没有元素越界。 ### 7. 归档 - 成片和两张封面由脚本输出到输出目录的 `<标题>/` 里。 - 把项目脚本复制到同一个目录;如果改过 vidkit,同步回工具目录。 - 在同目录写 `发布文案.md`,内容包括: - 标题:30 字以内,用反转结论当钩子,例如“18 岁,就已经过完了半辈子?”; - 简介:100 字以内,结尾带一个引导评论的问题; - 话题:`#<系列名> #科普` + 本期 2–3 个关键词; - 合集:`<系列名>`; - 置顶评论:一句话,把结尾的问题再问一遍(用户发布后自己贴)。 - 在 `发布记录.md` 追加一行,状态写“待发布”。 ### 8. 发布(可选,必须由用户确认) 只有用户要求、并且你能操作用户自己已登录的浏览器时才做: 1. 打开平台的创作者上传页。如果没有登录,请用户自己登录,**绝不代填账号密码**。 2. 上传成片,填写标题、简介和话题;横、竖封面分别上传对应的图片;选好合集;可见范围保持公开。 3. 遇到授权、同意协议之类的弹窗,**不要自己点同意**,先问用户。 4. 表单填好后截图给用户,然后**停下来**。只有用户在对话里明确说“发布”,才可以点发布按钮,而且每一期都要单独确认。 5. 发布后,把 `发布记录.md` 里这一期的状态改成“已发布”,并写上日期。 ### 9. 汇报 告诉用户以下几件事,不要贴整段文案: - 成片的位置和时长、两张封面; - 这期的反转结论和人生落点各是什么(一句话); - 哪些事实做了保守处理或还存疑; - 如果片长超过 BGM,要说明 BGM 会循环; - 发布状态:已填好待确认、已发布,还是没有发布。 ## 数据复盘(每隔几期做一次) 用户会贴创作者中心的截图。重点看 **2 秒跳出率**(开场是否抓人)和 **完播率**(长度和节奏),其次看评论数(互动引导是否起效)。和前几期对比,每次只提一两条最值得改的地方。