技能介绍

要解决什么问题

教程站、文档页往往很长，手工做「幻灯片 + 口播 + 成片」要反复切内容、调 PPT、录旁白、对齐时长。这个技能把 URL 或主题 当成输入，按固定流水线自动跑完，只在范围含糊（例如「全部章节」指哪几章）时才向你确认。

流水线怎么跑

触发后默认 逐步执行，不逐步征求同意：

Step 0 范围：「前 N 章」会先抓教程目录再逐章处理；单 URL 只处理该页；输出目录形如 {NN}_{ChapterName}（可指定根路径）。
Step 1 抓取：用 WebFetch 取正文（标题、段落、代码、要点、表格），忽略侧栏、导航与广告。
Step 2 PPT：python-pptx 生成 16:9 深色科技风幻灯片（5–8 页/章）；Python 字符串里勿用中文弯引号，改用「」避免 SyntaxError。
Step 3 逐字稿：口播要讲解幻灯片，不要照读；TTS 文本里把 C# 写成 C Sharp。
Step 4–6：PPT 导出 PNG → edge-tts（zh-CN-YunxiNeural，+5% 语速；超长文本按约 160 字切分再合并 MP3）→ scripts/assemble_video.py 合成 1920×1080 MP4（需 PYTHONIOENCODING=utf-8）。
Step 7 交付：MP4、PPTX、逐字稿.md；临时目录可清理，一般保留 slides/ 便于排查。

边界与注意点

依赖 Python（python-pptx、edge-tts、Pillow）、ffmpeg，Windows 上 PPT 转图优先 PowerPoint COM，失败可试 LibreOffice 或 ImageMagick。成片脚本针对 Windows 上 FFmpeg 的并行过载、-loop 1 时长异常、中文路径 concat 等问题做了顺序编码与 fallback；非 Windows 环境需自行验证 COM 与路径行为。