外研版初中英语教案生成器（waiyan-lesson-plan）
概述
备课主技能：一篇课文 → 语篇研读（What/Why/How）→ 完整教案（Word）。研读不再是独立交付物，而是教案的第一板块，直接驱动教学目标（←What/Why）、重难点（←How）、课堂活动与分层作业（←生词+语法点）。专为外研版（2024）初中英语设计，服务初中学段（当前用户带初一，学生中等偏下）。
两种模式：
| 模式 | 触发词 | 产物 |
|---|---|---|
| 只研读（快速） | "研读课文/分析语篇/文本分析"（不提教案） | 研读报告_{册}{单元}_{语篇标题}_YYYYMMDD.docx |
| 教案（默认主链） | "教案/备课/写教案/教学设计" | 教案_{册}{单元}_{语篇标题}_YYYYMMDD.docx（默认精简版；"完整/示范课/赛课/公开课"出完整版，命名加 _完整版） |
输入方式（三选一）
- 直接粘贴课文文本
- 指定教材位置（如"七上 Starter Unit 1"）——从用户 ima 知识库（"Nada.的知识库"）检索教材原文
- 给出本地文件路径（txt/docx/pdf 均可读取）
工作流程
第 1 步：取文本
- 粘贴直接用；指定教材位置时用 ima 知识库搜索（关键词：教材名+单元+板块名），确认原文后继续
- 记录：单元、板块（Starting out / Understanding ideas / Developing ideas / Presenting ideas）、语篇类型、词数
第 2 步：生词扫描（自动调用离线词典）
# python：本机可用的 Python 3（WorkBuddy 托管运行时即可）
# 词典自动探测：技能自带 scripts/dict/（xiaoxue.txt/zhongkao.txt，开箱即用）
# → ~/.workbuddy/binaries/dictionary/（完整安装时含 gptwords.json 增强拓展词义）
python scripts/vocab_scan.py --text "课文全文" --grade 7
python scripts/vocab_scan.py --file 课文.txt --json vocab_xxx.json # 生词 JSON 出口（下游用）
分级准确性三道防线（沿用原语篇研读技能）：
1. 规则修复沉淀在 vocab_scan.py（缩略词、称谓后大写、变形还原优先级）
2. scripts/corrections.json 人工修正表：扫描自动套用；发现新的人工修正必须写入此文件
3. 写教案前逐条过"复核提示"，可疑释义按课文语境人工定夺——不可省
第 3 步：三维度研读（教案第一板块）
参照 templates/plan-simplified.md（默认）/ templates/plan-full.md（完整版）中的"语篇研读"节；只研读模式参照 templates/study-only-simplified.md / study-only-full.md。
分析要点：
- What：先写一句主题（必填，按 2022 课标归入"人与自我/人与社会/人与自然"主题语境及主题群，参照 ima 知识库课标原文），再两三句概要
- Why：一段合并：选编意图 + 前后衔接（含"以读促写"链条）+ 素养落点
- How：结构+核心句型、语法点、读写结合点；完整版加信息结构梳理与写作技巧深化
第 4 步：逐板块生成与对话式确认（先审后渲）
自动生成不需确认：语篇研读（展示给用户可要求改写）、重难点（←How 自动提取）
需用户确认（教案模式下）：
| 板块 | 确认方式 |
|---|---|
| 教学目标（四维） | 精简版四维各一句一轮确认；完整版四维细化确认 |
| 课堂活动 | 按环节逐条过（表格形式展示），每环节标分层（全部/A/B/C） |
| 板书 | 结构图节点树（样式参照 ima「板书设计」文件夹杨丹老师三型，见 references/board-style-notes.md） |
| 分层作业 | 两层/三层按场景（见 references/levels-rubric.md），C 层只听写单词表、A-B 层加认读卡 |
| 教学反思 | 引导式四问模板（目标达成/分层执行/学生反应/下次调整）+ 留白，无需逐条确认 |
课堂活动详实度硬规则（用户 2026-09-05 反馈"活动内容太少"后确立）：
- 每课时 5-8 个环节，各环节时间之和 = 课时长度（45 分钟）
- 链条完整：导入 → 输入（听/读）→ 语言聚焦/操练 → 输出（说/写）→ 小结
- 教师活动必须写具体指令语与示例提问（如 T: Who are they? What are they doing?），禁止只写"组织学生讨论"这类空话
- 学生活动必须写具体操作步骤：做什么、几人一组、多长时间、产出是什么
- 每环节的生词/句型落到具体词句；模板中的环节行只是骨架，具体内容必须结合课文充实并与用户商讨
精简版合并为两轮：研读+目标一轮，活动+作业一轮；完整版四轮。用户说"改"则局部重生该轮，不重跑全部。
第 5 步：渲染 Word（make_plan.js）
# node：本机可用的 node（无需 NODE_PATH，脚本自带依赖自愈）
node scripts/make_plan.js --json lesson_plan.json --out 教案_七上Unit1_标题_YYYYMMDD
- 中间数据
lesson_plan.json（结构见下），渲染出教案 docx；只研读模式同样走 make_plan.js（mode=study-only 时只渲研读板块） - 板块顺序固定（无基本信息板块，用户 2026-09-05 确认去掉）：研读 →（学情分析，完整版）→ 目标 → 重难点 →（评价设计，完整版）→ 活动 → 板书 → 作业 → 反思；编号由渲染器动态生成
- 板书：
board→ render_board.js 生成 SVG → sharp 栅格化 PNG → ImageRun 嵌入 docx；按语篇类型选三型布局（见下方），layout字段切换 - 依赖自愈：docx/sharp 缺失时脚本自动安装到
~/.workbuddy/binaries/node/workspace（首次 1-3 分钟），无需手动配置 - TextRun 换行用 split('\n') + break:1；JSON 中文文本内避免英文双引号
- 自检：zip 良构 + 无"学生卷/学生版"类泄漏词
lesson_plan.json 结构
{
"mode": "lesson-plan", // "study-only" | "lesson-plan"
"version": "simplified", // "simplified" | "full"
"meta": {"title":"…","unit":"七上Unit1","section":"Understanding ideas","type":"对话","words":120,"date":"YYYYMMDD","class":"七年级","level":"中等偏下","period":"第1课时"},
"study": {"what":"…","why":"…","how":{"structure":"…","sentences":["…"],"grammar":"…","read_write":"…"},"vocab_overview":"核心N·拓展M·专有K","unit_analysis":"…","info_structure":"…","learning_analysis":"…","evaluation":"…"},
"objectives": {"language":"…","culture":"…","thinking":"…","learning":"…"},
"key_points": {"focus":"…","difficulty":"…","strategy":"…"},
"activities": [{"stage":"Step 1 Warm-up & Lead-in","minutes":3,"teacher":"含指令语与示例提问","students":"含具体操作步骤","purpose":"…","level":"全部"}],
"board": {"layout":"mindmap","title":"…","nodes":[{"label":"…","children":["…"]}],"golden":"灵魂金句","side":"生词区+随写区"},
"homework": {"scene":"new-lesson","levels":[{"name":"基础巩固","items":["…"],"note":"C层必做"},{"name":"能力提升","items":["…"]}]},
"reflection": {}, // 引导式四问，固定模板，留白
"vocab_json_path": "vocab_xxx.json"
}
精简版 study 只填 what/why/how；完整版补 unit_analysis/info_structure/learning_analysis/evaluation。
与其他技能的衔接
- 上游无（本技能是备课链起点，取代原 waiyan-text-study）
- 下游：
- 定稿
lesson_plan.json→waiyan-ppt（课件技能） - 生词 JSON（--json 输出）→
vocab-card（认读卡，字段不变） - 语法点定位（study.how.grammar）→
waiyan-grammar（分层练习） - 语篇原文 →
waiyan-listening（课文朗读/听力训练 mp3） - 单元复习 →
waiyan-exam（命题组卷） - Presenting ideas 板块的教学设计走
pbl-designer（PBL 呈现）
课标参考
分析时对照用户 ima 知识库中的《义务教育英语课程标准（2022年版）》：
- 主题语境三级分类（人与自我/社会/自然 + 主题群 + 子主题）
- 核心素养四维度（教学目标框架：语言能力/文化意识/思维品质/学习能力）
- 三级学业质量描述对应初一学段要求
注意事项
- 忠于课文：分析基于课文原文，不脑补教材没有的内容
- 外研版（2024）新教材结构：Starting out → Understanding ideas → Developing ideas → Presenting ideas，勿沿用旧版模块名
- 生词分级是预估，拿不准的词标"建议人工复核"
- 教学目标必须四维全覆盖（用户已确认），精简版每维一句、完整版每维可测化
- 无基本信息板块（用户 2026-09-05 确认）；单元/课时/学情信息只出现在标题下的副标题行
- 课堂活动必须详实（见第 4 步硬规则）；模板环节是骨架，内容要与用户商讨充实
- 分层始终体现"中等偏下"学情：C 层保底是设计底线
- 板书样式：三型布局已在 render_board.js 实现（default 样式：白底 + 深蓝 #1565C0 主色 + 金句橙色虚线框 + 底部副板书生词栏，打印清晰）——mindmap 思维导图放射式（探究/话题类语篇）/ timeline 时间线式（叙事类语篇，At first→Then→Now）/ table 对比表格式（说理/对比类语篇）；样式参数在脚本顶部
STYLE对象，风格依据 ima「板书设计」文件夹杨丹老师照片（2026-09-05 上传，笔记见 references/board-style-notes.md），可按老师反馈微调颜色/圆角/线条
