🎬 TechScript Video Pipeline

把技术文章变成科普视频的开源工作流
An open-source pipeline to turn technical content into explainer videos

📖 文档 · 🚀 快速开始 · 🎞️ 示例 · 🗺️ 路线图

---

项目简介

TechScript Video Pipeline 是一套本地优先、可复刻的技术讲解视频生成工作流。
它把「写一篇技术文章」这件事，标准化地转化成「一段有动画、有配音、有字幕的科普短视频」。

项目当前以 Micro LED 作为第一批验证题材，但目标不是只服务 Micro LED。它面向更广泛的半导体科普内容，例如 3D 封装、混合键合、先进封装设备材料、光互连、CPO、Micro LED 光互连、半导体制造流程和产业链分析。

核心能力

能力	工具	说明
动画渲染（产业/数据类）	HyperFrames (GSAP + HTML)	浏览器动画 → CDP 截帧 → MP4
动画渲染（技术/算法类）	Manim	数学几何、制造流程、原理动画
多 backend 配音	Edge-TTS / CosyVoice3 / ElevenLabs	可插拔 TTS 抽象层
声音克隆	CosyVoice3 zero-shot	本地离线，15s 样本即可
音画对齐	ffprobe + auto_schedule.mjs	自动测段长、生成 schedule
视频合成	FFmpeg	画面 + 多轨配音 → 最终 MP4

内容类型 × 工具选择

技术原理/工艺流程  ──▶  Manim        (数学推导、几何原理、制造动作)
产业链/设备材料    ──▶  HyperFrames  (流程图、价值链、公司/设备对比)
数据/市场/路线图   ──▶  HyperFrames  (柱状图、趋势线、节点时间轴)

Remotion 目前没有集成。它和 HyperFrames 同属浏览器画面转视频路线，未来可作为 HyperFrames 的工程化升级候选；Manim 是独立的 Python 科学动画路线，不依赖 Remotion。

---

快速开始

环境要求

• macOS（Apple Silicon 优化，M1/M2/M3 均可）
• Python 3.9+
• Node.js 20+
• Google Chrome（用于 CDP 渲染）
• FFmpeg

1. 克隆项目

git clone https://github.com/Kevin-Kaiyo/techscript-video-pipeline.git
cd techscript-video-pipeline

2. 安装 Python 依赖

python3 -m venv .venv-tts
source .venv-tts/bin/activate
pip install edge-tts requests tabulate

3. 安装 Node 依赖（仅渲染器需要）

npm install

4. （可选）安装 CosyVoice（本地 TTS）

# 参考 docs/SETUP_COSYVOICE.md

5. 配置 API Keys（可选）

cp .env.example .env
# 编辑 .env，填入需要的 key（edge-tts 不需要 key）

6. 生成一集视频

# 查看示例集数
ls episodes/

# 生成配音
python pipeline/tts_cli.py --provider edge --voice zh-CN-YunjianNeural --ep demo-industry

# 自动对齐 schedule
node pipeline/auto_schedule.mjs episodes/demo-industry

# 构建前检查
node pipeline/preflight.mjs demo-industry

# 启动 HTTP 渲染服务（新终端；build_episode.sh 也会自动启动）
cd episodes/demo-industry/animations/hyperframes && python3 -m http.server 18234

# 渲染帧
node pipeline/render_cdp_resumable.mjs 24 40 /tmp/demo-industry_frames demo-industry \
  "http://localhost:18234/index.html" 400

# 合成最终视频
bash pipeline/build_episode.sh demo-industry

也可以使用 Makefile：

make tts EP=demo-industry
make schedule EP=demo-industry
make preflight EP=demo-industry
make build EP=demo-industry

创建新半导体科普集数骨架：

npm run scaffold -- demo-hybrid-bonding-principle principle
npm run scaffold -- demo-hybrid-bonding-supply-chain equipment

---

示例

本项目内置示例集数，覆盖当前两条主线：

集数	类型	主题	时长
demo-tech	技术/工艺	Micro LED 巨量转移	~45s
demo-industry	产业链	Micro LED 上中下游全景	~40s
demo-data	数据图表	全球显示市场增长	~36s
demo-manim	技术/工艺	Micro LED 巨量转移 Manim 动画	~30s

后续真实选题可以沿用同一结构，不需要绑定 Micro LED：

• 3D 封装：硅通孔、interposer、chiplet 堆叠、热/良率挑战。
• Hybrid bonding：CMP、表面活化、对准、低温键合、缺陷检测。
• 先进封装设备材料：键合机、临时键合/解键合、underfill、载板、RDL。
• 光互连/CPO：电互连瓶颈、光引擎、封装集成、良率和供应链。
• Micro LED 光互连：显示、传感、通信与微纳光学结构结合。

---

文档

• 🏗️ 架构设计 — 系统组件与数据流
• 🧭 内容体系 — 半导体科普选题分类与渲染器选择
• 🔄 工作流详解 — 从文章到视频的完整步骤
• ⚙️ 环境搭建 — 安装、配置、常见问题
• 🔊 TTS 配置 — 各 backend 对比与使用方法
• 🤝 贡献指南

---

路线图

• HyperFrames 渲染管线（CDP 断点续传）
• 多 backend TTS 抽象层（Edge / CosyVoice3 / ElevenLabs / MiniMax / Google）
• 音画自动对齐（ffprobe → auto_schedule）
• 声音克隆（CosyVoice3 zero-shot，本地离线）
• Fresh-clone preflight and root Node dependency manifest
• Manim 技术类动画模板（demo-manim）
• 通用半导体科普内容分类与双渲染路线说明
• 通用 episode scaffold 命令（按内容类型创建新集数）
• 字幕自动生成（Whisper）
• 一键生成脚本（LLM → script.md）
• GitHub Actions 自动化构建

---

许可证

代码部分：MIT License

注意：本项目使用 GSAP 进行动画渲染。
GSAP 在非商业用途下免费使用。如需商业部署，请购买 GSAP 商业授权。

详见 NOTICE。

---

Made with ❤️ by Kaiyo Nan · Blog