优质课视频全套教学资源生成器

把一个优质课视频转化为可直接上课/参赛的全套教学资源。核心原则：先"看懂"视频再写文档——逐帧分析还原真实课堂流程，而不是凭课题空写。

交付物与技能分工表（总纲）

| 交付物 | 生成方式 | 调用的专家 / 技能 | |---|---|---| | ① 视频分析报告（时间轴+课堂环节还原） | 下载视频→抽帧→多模态识图 | 本 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:/... 形式。