GitHub Trending 口播解说视频生成器
用途
把「GitHub 单日星标排行 / 技术榜单 / 每日 AI 热点」等内容，做成约 2 分钟、1280×720、
深色主题、中文真人配音、字幕烧入的 MP4。完整链路：
采集 Trending → 调研项目 → 深度报告(MD+HTML) → 口播脚本(script.json) → build_video.py → MP4
build_video.py 负责最后一步（渲染+配音+封装），前四步产出 script.json。
本技能把已踩过的全部坑（torch 沙箱崩溃、MiMo sr 无效、AAC 静音、锁文件、响度天花板）
固化进脚本与文档，做到每日换 script.json 即出新片。
何时使用
- 用户要「今天的 GitHub 趋势 / 单日星标 TOP10 / 每日 AI 报告」视频
- 用户要定期（每日/每周）生成榜单类口播短视频
- 任何需要「结构化数据 → 深色主题讲解视频 + 中文配音」的场景（改 draw 模板与配色可泛化）
实践用法
- 产出 script.json：复制
assets/script.template.json，按references/workflow.md
步骤 4 填title/date/author/voice/scenes。draw选 8 种画面模板之一，highlights
标字幕高亮词，data颜色用名字字符串（ACCENT/GREEN/ORANGE/RED/PURPLE）。 - 运行生成器（详细依赖与命令见
references/workflow.md步骤 5）：
bash PY="C:/Users/TANKO/.workbuddy/binaries/python/envs/default/Scripts/python.exe" $PY scripts/build_video.py /path/to/script.json # 输出 <date>_<author>.mp4 到 script.json 同目录 # 切女声：VIDEO_VOICE=冰糖 $PY scripts/build_video.py script.json - 前四步（采集/调研/报告） 见
references/workflow.md，按需半自动完成。
资源
- scripts/build_video.py — 通用视频生成器（读 script.json → PIL 渲染 + MiMo 配音 +
44100Hz 立体声 AAC + 两遍 EBU R128 响度归一化 volume=2.0 + 限幅）。直接执行。 - assets/script.template.json — 完整可运行的数据模板（真实 12 场景示例 +
_comment字段说明）。 - references/workflow.md — 端到端制作流程与每日执行清单。
- references/troubleshooting.md — 全部环境坑与修复（torch 崩溃 / MiMo sr / AAC 静音 / 锁文件 / 响度）。
- references/mimo_tts.md — MiMo 云端 TTS 配置、音色、凭据与调用要点。
关键坑速查（详见 troubleshooting.md）
- 不要装 torch/ChatTTS：本沙箱
import torch必崩（Segmentation fault），改用 MiMo 云端 TTS。 - MiMo
tts()返回的 sr 是无效标量（≈2.17）：丢弃，固定sf.write(wav, data, 24000)。 - 音轨必须 44100Hz 立体声：TTS 原始 24000Hz 单声道会被播放器静音（已固化）。
- 响度：仅靠 loudnorm 降目标推不响（被真峰限制），必须
volume=2.0 + alimiter（已固化）。 - 覆盖原文件锁：用唯一时间戳文件名生成，再
-c copy流拷贝覆盖。 - 临时文件清理：沙箱 safe-delete 拦截删除命令，需用户手动清
_audio/、_silent.mp4、调试 mp4。
默认约定
- 署名：tanko每日AI报告；文件名：
<日期>_tanko每日AI报告.mp4 - 画面：1280×720 / 25fps / H.264 / 深色主题（GitHub Dark）
- 配音：MiMo 默认
白桦（男），冰糖（女）备选
