教材自学教程生成器

要解决什么问题

中小学教辅往往只有教材 PDF，学生预习需要「有结构、能自测、易打印」的讲义，但手工从 PDF 拆章节、统一版式、补例题与易错点，成本高且格式容易前后不一致。本技能把教材 PDF → 结构化数据 → Word .docx 做成可重复流水线，而不是一次性粘贴排版。

技能如何工作

架构是排版引擎 + 数据分离：

• scripts/build_tutorial.py：基于 python-docx 的渲染层，负责 A4 页边距、章/节样式、目录域（TOC）、彩色框（记忆锦囊、易错警示、例题）和表格等。
• data_chXX.py：按章导出 get_chXX_data()，每节走统一的 12 板块（学习导航、课前热身、知识精讲、记忆锦囊、易错警示、经典例题、重难点突破、实验与探究、生活应用、知识框架、达标检测、自我评价）。

典型流程：用 Read 读 PDF 抽目录与知识框架；可选 WebSearch 补教参；列出章节大纲供确认；复制排版模板并改封面与导入路径；并行编写各章数据；先测前两章再全量 build_tutorial.py；按 quality_checklist 做内容与格式审查后迭代修复。

内容侧有硬约束：公式用 Unicode 上下标（如 v=s/t），禁止 OMML；富文本目前仅支持 **加粗**；breakthrough 可为 None，但不要用空字典 {}。

适用边界与注意点

• 必要输入：教材 PDF 路径，或教材名称+版本+年级；以及学科（影响公式与实验表述）。
• 默认假设：读者为零基础预习学生，输出为 Word，并可联网补教参。
• 排版局限：彩色框用单列表格模拟，非 Word 文本框；目录需在 Word 里更新域后才显示完整 TOC。
• 质量责任：科学性（公式、单位、实验步骤、例题逻辑）仍依赖数据模块与审查清单，技能提供结构而非自动验真全书。