优质课视频全套教学资源生成器
把一个优质课视频转化为可直接上课/参赛的全套教学资源。核心原则：先"看懂"视频再写文档——逐帧分析还原真实课堂流程，而不是凭课题空写。
交付物与技能分工表（总纲）
| 交付物 | 生成方式 | 调用的专家 / 技能 |
|---|---|---|
| ① 视频分析报告（时间轴+课堂环节还原） | 下载视频→抽帧→多模态识图 | 本 skill scripts/extract_frames.py + Agent 多模态读图 |
| ② 教案 | 依视频分析撰写（目标/重难点/环节/板书/分层作业） | teacher-lesson-plan 技能 |
| ③ 教学逐字稿 | 依教案逐句写口语化台词（含【操作】提示、学生预设回答、板书块） | teacher-lesson-plan 技能 |
| ④ 说课稿 | 七/八部分标准结构，每环节附"设计意图"，附答辩预案 | teacher-lesson-plan 技能 |
| ③′ 逐字稿 Word 版 | HTML 排版→DOCX 转换 | tencent-docs-routing → tencent-docx 技能 |
| ⑤ 说课 PPT | pages.json → PPTX | 本 skill scripts/build_pptx.py（详见 references/pages-json-schema.md） |
| ⑥ 互动教学课件 HTML | 单文件 HTML5，零依赖断网可用 | interactive-courseware-designer 技能（工具链缺失时按其规范手动构建，记录豁免） |
| ⑥′ 教学 PPT 版 | 互动课件 10 页 → pages.json → PPTX | fmg-html-ppt 流程；slidep 不稳时用本 skill scripts/build_pptx.py 兜底 |
推荐产出顺序：视频分析 → 教案 → 逐字稿（→Word）→ 说课稿 → 说课 PPT → 互动课件 HTML → 教学 PPT。每完成一个交付物暂停等用户确认再推进下一个（用户偏好分阶段交付）。
快速开始
- 拿到视频：向用户要 B 站 BV 号/链接或本地视频路径；无视频只有课题时，先与用户确认课题/学段/教材版本再凭教研经验补全课堂设计（在文档中注明"未基于视频，建议对照录像校准"）。
- 分析视频：按
references/video-analysis.md执行（B站 API 拿元信息 → 下载 → 抽帧拼图 → 逐张识图还原课堂时间轴）。 - 写三稿：加载
teacher-lesson-plan技能，依次产出教案、逐字稿、说课稿（每份为一个 HTML 文件，风格参照 references/pipeline.md 中的结构要求）。 - 做课件：互动课件按
interactive-courseware-designer规范产出单文件 HTML（大字号、游戏化、即时判分、教师锦囊、顶部工具栏：目录/朗读/全屏/倒计时）；然后按references/pages-json-schema.md抽出pages.json。 - 出 PPT：运行
python scripts/build_pptx.py pages.json 输出.pptx（python-pptx 兜底构建器，零外部服务依赖，已验证）。若用户环境 slidep 可用也可走fmg-html-ppt的 slidep 编译，但首选本脚本（slidep 守护进程在 agent 环境下易静默退出）。 - 交付：用 present_files 逐个打开预览；文件名建议
<课题>_教案.html、<课题>_教学逐字稿.html、<课题>_说课稿.html、<课题>_说课课件.pptx、<课题>_互动课件.html、<课题>_课件.pptx。
硬性质量要求
- 逐字稿：绿底台词块（可照读）+ 棕色【操作】提示 + 灰色斜体学生预设回答 + 黄底板书块；口诀类内容（如"密陡疏缓"）每次出现都要写"放慢带读"提示。
- 说课稿：开场白/结束语齐全；每环节末尾附"设计意图"绿色块；文末附答辩三问预案（实验超时/面向学困生/创新点）。
- 互动课件：单文件、无外部 CDN 依赖（断网可用）；JS 内字符串禁用 ASCII 引号（用中文引号，否则 node --check 报错）；交付前必须
node --check校验 + 浏览器 headless 截图冒烟（用 Edge/Chrome--headless=new --screenshot，对临时副本切换 active slide 逐页验证）。 - PPT：构建后必须用 python-pptx 校验页数与每页非空。
- 全程记录工作日志到 workspace memory。
详细参考（按需加载）
references/pipeline.md—— 六件套逐项的完整操作流程、文档结构模板与全部踩坑经验（必读）。references/video-analysis.md—— B站视频下载与抽帧分析全流程（API、直链 403 对策、ffmpeg 抽帧）。references/pages-json-schema.md—— pages.json 字段规范、8 种版式说明、PPT 设计系统。
已知环境坑（勿重蹈）
- Bash 工作目录会话间会重置，一律用绝对路径。
- 系统 ffmpeg 不存在时，用托管 Python venv 装
imageio-ffmpeg获取二进制。 - 不要在 slidep 同步进行中执行 stop；不要 kill WorkBuddy 的 editor_sdk.exe（端口 39099，会断开用户本地文档会话）。
- uv/Git Bash 会把
/c/...解析成D:\c\...，传参一律用C:/...形式。
