幼儿园公开视频教案还原

Overview

把一个真实发生的幼儿园集体教学视频，转化为可供教师个人研究、园本教研使用的成套资料：完整转写稿、按时间轴的活动过程分析、还原版活动教案、教师说课稿、案例专业分析。资料存放在统一的案例文件夹中，严格区分「视频中可确认的事实」与「AI 推断或专业补充」。

何时使用

• 用户提供哔哩哔哩等平台的公开免费教学视频链接，希望还原教案。
• 用户提供本地 MP4 / MOV 教学视频文件，希望转写并还原教案。
• 用户要做园本教研、公开课复盘、新教师培训素材整理。

不使用本技能的情形：需要绕过登录 / 会员 / 付费 / DRM / 平台访问权限才能获取的内容。此类情况一律提示用户上传本人有权使用的视频文件，不得尝试破解限制。

重要原则（贯穿全部步骤）

1. 事实优先于推断。不得为了让教案「看起来完整」而虚构视频中不存在的内容。
2. 不润色、不替教师说话。转写稿尽量保留教师与幼儿原话；分析中对画面 / 音频无法判断处，明确写「视频中无法确认」。
3. 严格区分两类内容：
   - A 类：视频中可直接确认（原话、动作、材料、环节）。
   - B 类：根据视频推断或专业补充。凡是视频未明确出现的信息，不得描述成原教师的真实设计，须用「根据视频活动过程推断」标注。
4. 说课稿不虚构教学理念。原教师未表达过的理念不替其总结；推断处用「从视频呈现来看……」「根据活动过程推测……」等表达。
5. 专业语境表达。避免「课堂」「上课」等词，优先使用「集体活动」「集体教学活动」「活动过程」「师幼互动」「学习过程」。
6. 合法获取优先。能正常下载保存的公开视频才下载；任何限制一律不绕过。

工作流程

第 0 步：环境与工具检查

依次确认以下工具可用（脚本会自动尝试安装 Python 依赖；系统级工具需用户侧安装）：

• ffmpeg / ffprobe：用于提取音频与关键帧。缺失时提示：winget install ffmpeg（Windows）、brew install ffmpeg（macOS）、sudo apt install ffmpeg（Linux）。
• yt-dlp：用于下载公开视频，脚本自动 pip install yt-dlp。
• faster-whisper：用于语音转写，脚本自动 pip install faster-whisper。
• python-docx：用于生成 .docx，脚本自动 pip install python-docx。

若视频已为本地文件，跳过下载，直接进入分析。

第 1 步：识别素材

收到链接后，先用 scripts/download_source.py --url <URL> --case <案例文件夹> 拉取元信息；或收到本地文件时登记文件信息。从中提取并展示：

• 视频标题
• 推断的活动名称（结合标题、简介、画面）
• 年龄段（托班 / 小班 / 中班 / 大班）
• 活动领域（健康、语言、社会、科学、艺术，参照《3-6 岁儿童学习与发展指南》）
• 可正常读取的视频描述、公开字幕等

若用户提供本地视频，直接进入第 3 步的视频分析（标题等信息按文件名 / 用户说明登记，缺失则标注「视频中无法确认」）。

第 2 步：建立案例文件夹

在当前 WorkBuddy 工作空间创建文件夹，命名格式：

<年龄段>_<领域>_<活动名称>/
例：中班_语言_章鱼先生要比赛/

所有生成内容都必须保存在该文件夹内。案例文件夹路径记为 <case>。

第 3 步：保存与处理视频

• 可正常下载的公开视频：运行 scripts/download_source.py --url <URL> --case <case>，保存为 <case>/01_原视频.mp4，并尽量抓取公开字幕到 <case>/字幕_raw/。
• 无法正常获取：不绕过限制，停止下载，提示用户上传本地视频文件；收到本地文件后运行 scripts/download_source.py --file <本地路径> --case <case>。
• 已有公开字幕：优先读取原字幕，整理为 <case>/02_视频完整转写稿.md（保留原话，注明来源语言）。
• 无字幕：先提取音频与关键帧，再转写：
  1. scripts/extract_media.py --video <case>/01_原视频.mp4 --case <case> --interval 20
  → 生成 <case>/音频_原始.wav 与 <case>/关键帧/frame_XXXX.png（每 20 秒一帧，供多模态查看画面）。
  2. scripts/transcribe.py --audio <case>/音频_原始.wav --out <case>/02_视频完整转写稿.md --model base
  → 生成带时间戳的完整转写稿，尽量保留原话，不做润色；听不清处标「音频不清晰」。

第 4 步：视频过程分析（不能只靠文字）

必须结合视频画面与转写稿共同判断，而非仅凭文字总结。可读取 <case>/关键帧/ 中的帧图辅助理解画面。按时间轴拆解整个视频，写入 <case>/03_活动过程逐段分析.md。

逐段格式（覆盖整段视频，不遗漏）：

【00:00-02:30】
活动阶段：
教师行为：
教师原话或关键提问：
幼儿行为：
幼儿回应：
使用材料：
活动目的判断：
备注：

判断依据尽量来自：教师语言、幼儿语言、教师动作、幼儿行为、教学材料、PPT/图片/教具、活动空间、师幼互动。画面 / 音频无法判断的，在对应项写「视频中无法确认」。

第 5 步：还原活动教案

根据视频实际发生的内容还原，不做重新设计。先撰写 Markdown，再用脚本生成 .docx：

1. 按 references/教案与说课稿模板.md 的「还原版活动教案」结构写 <case>/04_还原版活动教案.md。
2. 运行 scripts/build_docx.py --md <case>/04_还原版活动教案.md --out <case>/04_还原版活动教案.docx。

教案须含：活动基本信息、设计背景、活动目标、重点难点、活动准备、活动过程（每环节含环节名称 / 教师行为 / 教师关键提问 / 幼儿实际表现或可能回应 / 教师支持策略 / 设计意图）、观察与评价要点、活动延伸、视频还原说明。

必须严格区分 A（视频可直接确认）与 B（推断 / 专业补充）。视频未明确出现的信息不得写成原教师真实设计，须标注「根据视频活动过程推断」。

第 6 步：生成教师说课稿

采用教师可直接用于教研分享的自然语言。流程同第 5 步：

1. 按 references/教案与说课稿模板.md 的「教师说课稿」结构写 <case>/05_教师说课稿.md。
2. 运行 scripts/build_docx.py --md <case>/05_教师说课稿.md --out <case>/05_教师说课稿.docx。

说课稿含 12 个部分（活动来源与设计背景、幼儿经验分析、活动目标、重点难点、活动准备、活动设计思路、各环节设计逻辑、关键提问设计、师幼互动与支持策略、观察与评价、活动特色、活动反思）。不虚构原教师未表达的理念；推断处用「从视频呈现来看……」「根据活动过程推测……」。

第 7 步：案例专业分析

以幼儿园教研员视角，写入 <case>/06_案例分析与借鉴建议.md，覆盖：活动亮点、高质量师幼互动、有价值的教师提问、幼儿学习方式、教师支持策略、材料使用、活动节奏、值得借鉴的做法、可进一步优化之处。重点关注幼儿的主动学习，而非只评价教师教得如何。

输出文件清单（案例文件夹内）

完成汇报格式

任务结束后，向用户汇报：

• 视频是否成功处理（成功 / 仅本地分析 / 未获取需补传）
• 活动基本信息（名称、年龄段、领域）
• 共生成哪些文件
• 本地保存位置（案例文件夹绝对路径）
• 哪些部分属于视频事实（A 类）
• 哪些部分包含 AI 推断（B 类）

脚本说明

参考资源

• references/教案与说课稿模板.md：04 / 05 的完整章节结构与标注规范。
• references/分析原则与专业表达.md：事实 / 推断区分规则、专业语境词汇、推断用语范例。