基于"三境界"的初中物理教材分析
Overview
本技能把一套已验证的教材分析方法沉淀为可复用 SOP：先以"五理论 + 六原则 + 五策略 + 物理八法"立标尺，再用入格 → 定格 → 出格三境界对某一节教材做逐层分析，最终产出结构统一、客观可追溯、含"认知陡台阶诊断"与"出格边界审查"的 Markdown 分析文档。
> 核心经验（来自 4 次真实实操）：必须先锚定真实原文再做"入格"，缺原文用"通行版替代"会导致入格失真（详见 references/examples.md 教训一）。
何时使用
- 用户给出一节教材（PDF 原文或节名），要求"做教材分析""用三境界分析""分析这一节"。
- 用户要求"把若干教材分析整理成《教材分析研修手册》"。
- 用户要求"反思/总结分析经验、建认知陡台阶清单"。
输入参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| 目标节名/关键词 | str |
是 | — | 如"快与慢""密度""光的反射" |
| 主分析版本 | enum |
是 | — | 沪科 / 人教 / 科教 / 北师郭玉英 |
| 主版本年级 | enum[8/9] |
是 | — | 八或九年级 |
| 跨版本范围 | list[enum] |
否 | 仅主版本 | 加厚版时可扩为沪科+人教+科教+北师郭玉英 |
| 深度档位 | enum[加厚版/标准版] |
否 | 标准版 | 加厚版覆盖全部加强要素 |
| 教材PDF(可选) | Path |
否 | — | 用户可提供PDF替代自动抽取 |
| 输出目录 | Path |
否 | 当前工作目录 | md和html均落此目录 |
输出产物
| 产物 | 格式 | 说明 |
|---|---|---|
《节名》_教材分析.md |
Markdown | 〇标尺→一入格→二定格→三出格→四反思，全结构 |
《节名》_教材分析.html |
自包含HTML | 科技感版式：渐变封面/双栏目录/徽章/圆角阴影表格/深色代码块/打印样式 |
| 临时提取文件 | 文本 | locate_section.py 或 extract_pdf.py 产物，第5步后清理 |
资源导航
| 资源 | 作用 | 何时读 |
|---|---|---|
references/framework.md |
完整方法论（五理论/六原则/五策略/八法/三境界/红线） | 每次分析前必读，建立标尺 |
references/examples.md |
4 次实操案例 + 5 条教训（含踩坑校正） | 不确定如何落"定格/出格"时查阅 |
assets/template.md |
分析输出统一模板 | 写分析文档时照此结构填充 |
scripts/locate_section.py |
从本机 9 版 MinerU 库按"版本+年级+关键词"抽取某节真实原文（第 0 步锚定） | 需要自动抽原文时运行 |
scripts/extract_pdf.py |
教材 PDF 文本提取（用户给 PDF 时） | 用户给 PDF 时先用它提取 |
scripts/md_to_html.py |
Markdown → 科技感自包含 HTML（第 5 步产出另一格式：渐变封面/徽章/深色代码块/阴表格/双栏目录） | 写完后同步生成 .html |
深度档位（标准版 / 加厚版）
同一套三境界模板有两档深度，由用户语气决定：
- 标准版（本技能默认）：严格照 assets/template.md 填充，每节约 80–120 行，作为快速交付。
- 加厚版（用户说"更厚/更深入/详细/展开/加厚"时启用）：在标准版基础上强制加厚下列要素：
- 入格：① 课标条目逐字摘抄 + 行为动词拆解（知道/能用/通过实验…）；② 栏目功能清单逐条原文举证（引用教材原栏目标题与原句片段）；③ 八法精确定位到页码/段落并说明教学作用。
- 定格：① 每处陡台阶配 学情预判 + 迷思概念 + 教材处理 + 脚手架 + 评价点；② 补 教材编排意图分析（为何此序、跨章衔接）；③ 习题逐题归类（基础/开放/跨学科）+ strengths/可补强；④ 情境链逐例表（情境/位置/功能/时代性）。
- 出格：① 重组设想含可落地教学片段；② 留白探究升级为完整微项目（目标/材料/步骤/评价）；③ 边界审查逐条列"若引入的后果"；④ 按需追加 典型教学片段设计 与 跨版本对比（见下）。
可选增值（按节需要添加，不强制）
- 典型教学片段设计：在出格内写一段 5–10 分钟课堂片段（情境导入→学生活动→教师追问→小结），概念课/混合课/技能课尤宜。
- 跨版本对比：加厚版时必做。用
scripts/locate_section.py抽取各版原文后对比 沪科/人教/科教/北师郭玉英四版（不含李春密），维度含定义原句、方法显隐、情境取向、特色栏目。不得编造；某版缺文即标注"本版无对应节"。
Workflow（标准作业流程）
第 0 步：锚定真实原文（最关键）
- 用户给了 PDF → 运行
scripts/extract_pdf.py提取文本，确认真实版本与章节页码；
bash python scripts/extract_pdf.py "<pdf路径>" --out pdf_text.txt
读取后删除临时文件（不留在用户文件夹）。 - 用户只给节名、无 PDF → 用
scripts/locate_section.py从本机 9 版 MinerU 库自动抽取：
bash python scripts/locate_section.py --version 沪科 --grade 8 --keyword "快与慢" --out sec.txt
支持的--version：沪科 / 人教 / 科教 / 北师郭玉英（含别名）。 - 加厚版跨版本对照：对需对比的其余版本同样用
locate_section.py抽取。 - 在产出文档"适用教材"处写明版本·年级·章·节，并标注"✓已提取 / ✗缺原文替代"。
> ✅ 完成标准：主版本原文已落盘为临时文件且可读；缺原文时已显著标注假设。
第 1 步：亮标尺（先读 framework.md）
加载 references/framework.md，在文档"〇、分析标尺"处列出：
五支柱理论 + 六原则 + 五策略 + 物理八法，作为后续判断的依据。
> ✅ 完成标准：标尺段落已写入文档"〇、分析标尺"，五支柱/六原则/五策略/八法/课型定位五项均在。
第 2 步：入格（描述性 · 读懂）
按 assets/template.md 的"一、入格"填充，做到客观、可核对：
1. 课标/学业要求映射：定位三级主题编号与原文，双向对齐。
2. 四分类结构图：现象 → 概念 → 规律/模型 + 方法 → 价值（解构法）。
3. 栏目功能清单：逐栏目列表（问题/实验/想想议议/科学世界/作业/请提问…）+ 对应素养。
4. 四维核心素养标签：物理观念/科学思维/科学探究/科学态度与责任。
5. 科学方法显性化：识别本节用到的"八法"（比值定义、理想化模型、控制变量、累积、转换、类比、实验归纳、等效代替）。
> 入格不评价、不发挥，只忠实描述"教材是什么"。
> ✅ 完成标准：1.1 课标三级主题编号+原文双向对齐；1.2 层次树四分类完整；1.3 栏目清单逐条有功能+素养；1.4 四维标签每维至少一处落点；1.5 八法表全（有原句的标注页码，未显性者标"未显性"）。
第 3 步：定格（解释性 · 内化）
最有价值的产出层，按"二、定格"填充：
1. 认知序陡台阶诊断：定位学生最难跨越的台阶，给脚手架。
- 技能课→读数规则/误差/估读留白；概念课→相对性/抽象关系；混合课→比值定义+理想模型双台阶。
- 区分"教材留白"与"真陡坡"，且必须按真实版本判断：沪科版 2024/2025 在测量节明确写出"估读到分度值下一位""有效数字""误差≠错误"，属明教点而非留白；人教版才是留白。跨版本不可套用同一判断（见 examples.md 教训一·修订）。
2. 学业质量红线对标：是否达标、是否超纲。
3. 习题/活动体系评估：基础/开放/跨学科分布，是否需补强。
4. 情境链评价：情境是否贴合建构主义与时代性。
> ✅ 完成标准：2.1 至少定位 1 处陡台阶并配脚手架；2.2 红线对标有达标/超纲判断；2.3 习题至少分基础/开放/跨学科三类；2.4 情境链含时代性评价。
第 4 步：出格（创造性 · 重构）
按"三、出格"填充，每一项都要落地且有边界：
1. 重组设想（基于定格发现，如误差前置/相对性前置/模型思想前置）。
2. 跨学科联结（数学比值/计量史/语文诗词/美术/信息技术传感器）。
3. 本土情境（校园扶梯/长江索道/地标电梯/道路限速换算）。
4. 留白探究设计（累积法微项目/匀速存在性实验/估算素养）。
5. 边界审查（红线刹车，必须写）：显式声明"不引入 X（加速度/s-t图/矢量/惯性系/不确定度/伽利略相对性…）"，并说明不出界理由。
> ✅ 完成标准：3.1 至少 1 个重组设想含可落地片段；3.2 至少 2 个跨学科方向；3.3 至少 2 个本土情境；3.4 至少 1 个留白探究设计；3.5 边界审查至少 3 条。
第 5 步：反思与产出（同时产出 md 与 html 两种格式）
- 文档"四、反思与经验"：科学性/有效性自评 + 本次补充到"陡台阶清单"的新条目 + 待确认项。
- 按
assets/template.md结构输出 Markdown 文件《节名》_教材分析.md。 - 同步生成 HTML 版本（第二格式，可预览/打印）：
bash python scripts/md_to_html.py "《节名》_教材分析.md" --title "《节名》教材分析"
该脚本内置轻量 Markdown 解析（无需第三方依赖，优先复用环境内markdown库），
输出科技感版式的自包含单文件 HTML：深蓝→青渐变网格封面、双栏目录(TOC)、
圆角阴影表格、深色代码块、【标签】自动渲染为徽章、入格/定格/出格关键词高亮，并含打印样式，
与同名 .md 配套。 - 最终向用户交付：
《节名》_教材分析.md+《节名》_教材分析.html两份。 - 用户要求"合并成册"时，先把各节 .md 拼接为《教材分析研修手册》(.md)，再用同一脚本生成手册的 .html。
- 清理临文件（提取脚本/文本），并更新长期记忆（如建立"认知序陡台阶清单"横向积累）。
> ✅ 完成标准：md 和 html 两份文件均已落盘；html 在浏览器中可正常预览、目录可跳转；临时文件已清理。
错误处理策略
| 异常场景 | 处理方式 |
|---|---|
locate_section.py 对某版本未命中 |
该版本标注"本版无对应节"，不编造。 |
locate_section.py 仅命中目录/索引 |
标注"仅目录提及，正文待核"。 |
| 用户不提供主版本 | 默认以沪科版为主分析版本，提醒用户可指定。 |
| 用户仅给节名，无年级 | 推断：力学/运动学→八年级，电学/热学→九年级。标注"年级为推断，请确认"。 |
| PDF提取失败（PyMuPDF未安装） | 提示安装命令 pip install pymupdf，或请用户粘贴原文。 |
md_to_html.py 依赖 markdown 库缺失 |
内置轻量解析器自动回退，功能完整。 |
| 临时文件清理失败 | 在交付说明中列出残留文件路径，请用户手动删除。 |
关键纪律（务必遵守）
- 无原文不伪造：缺原文时标注假设，拿到原文即校正（教训一）。
- 先标尺后三境界：每次都先亮五理论/六原则，判断才有据。
- 定格要出"陡台阶+脚手架"：这是分析的高光，不可空泛。
- 出格必做"边界审查"：创造性不滑向超纲失真。
- 课型决定方法：技能/概念/混合课侧重点不同，八法因地制宜（见 framework.md 第九节）。
- 跨版本不编造：每个差异点指向某版原句；北师大版即郭玉英版（不含李春密版）。
跨版本 / 跨课型稳健性
同一套"三境界 + 八法"框架在沪科（混合课）、人教（技能/概念）、科教、北师郭玉英（混合）均成立；
差异仅在课型方法侧重点与版本表述，框架本身可迁移到初中物理任意一节。本技能不绑定单一版本，
标准版做单版分析，加厚版可扩为跨版本四版对照。
