---
.p1~.pN 坐标，再填内容。内容装不下就删减，不许撑大框。---
用户可能只给一个课文名，也可能给完整材料。优先收集：
如果用户只说「做一份 X 学习导图」，不要空等资料；可先基于通用课文知识生成，并明确哪些内容是推断项。
---
每个课文一个任务文件夹，文件夹和最终交付文件默认使用中文课文名及中文页名，不使用英文缩写或拼音目录名：
D:\workbuddy\<日期>_<课文名>\
├── <课文名>-基础知识.html
├── <课文名>-课文理解.html
├── <课文名>-全文脉络.html
├── <课文名>-拓展联读.html # 若用户点名要求 Page 4
├── index.html # 预览入口，可保留英文技术名
├── notes.md # 课文、版本、内容取舍、推断项
└── png\ # 可选：导出图
├── <课文名>-基础知识.png
├── <课文名>-课文理解.png
├── <课文名>-全文脉络.png
└── <课文名>-拓展联读.png命名铁律（2026-09-10 固化）：
猴王出世，不得默认使用 monkeyking、caocao 等英文目录名。猴王出世-全文脉络.html、猴王出世-全文脉络.png，不得默认使用 page3-全文脉络。index.html、notes.md、png 等属于技术辅助文件，可保留固定英文名，最终展示卡片优先展示中文命名的页面和图片。如果用户只要单页，直接使用 <课文名>-<页面名称>.html，如 猴王出世-重点字词.html。
---
先判断：
| 类型 | Page 3 推荐版式 |
|---|---|
| 时间顺序叙事 | 时间轴 / 阶梯线 |
| 空间顺序 / 状物 / 借物抒情 | 核心物体主图 + 旁注 |
| 写人 | 人物中心像 + 事件/品质旁注 |
| 情感递进强 | 情绪弧线 / 花瓣 / 温度计 |
| 古诗 | 意象图谱 / 诗句路径 / 山水卷轴 |
| 说明文 | 结构拆解图 / 流程图 / 分类图鉴 |
详见 references/content-architecture.md §3。
⚠️ 古诗（组诗）专用版式（2026-09-10 固化，《古诗三首》验证）：多首古诗合编一课时，禁用"基础知识/课文理解/全文脉络/拓展联读"通用四页模板——三首诗挤一页逐句品析会把解读切碎（框小字碎、《己亥杂诗》条目被压成空条）。正确版式：一诗一页精讲 + 末页对读升华：
nv2_gushi_v2.py（POEM_COORDS 9 模块 + SUM_COORDS 9 模块，组件 .tl 时间轴/.verse 三层/.zi/.smallcard 星级/.mq/.qz 小练/.kj 口诀/.trow/.stage）。⚠️ 小学必背古诗「必背卡」专用版式（2026-09-11 固化，75 首按年级分组）：单篇记忆卡，与组诗精讲页目标不同——精讲页求"学懂一篇、对比一组"，必背卡求"背熟一首、批量产出"，故不设历史时间轴 / 考点星级 / 对读升华页。模板为每首诗一页 10 模块满版（nv2_beibei.py，12×14 砖块网格）：
小学必背古诗/<年级学期>/，总索引列 12 组制作状态；工作流：做完一组→用户确认→再开下一组（每批数据手写，不批量套用）。年级-诗名.png（节选 .page 元素，精确 A4 比例 2560×3620）；②年级-诗名.pdf（独立 A4 PDF，一诗一文件，标准 595.2×841.92pt）。文件名带年级前缀（如 一年级上-江南），便于归档；旧命名 小学必背古诗-* 已弃用。导出链路：生成器→_export_node.js（PNG）→_mkpdf_one.py（PDF），三件套（html+png+pdf）齐备。⚠️ 小学必背古诗「知识卡片互动版」子模式（2026-09-18 固化，一年级上 4 首验证）：当用户要求“互动动画版 / 配音 / 逐句解读 / 知识卡片 / 可点击学习卡 / 古诗动画卡”时，不另起新 skill，沿用本 skill 的古诗必背卡内容体系，新增一份独立互动 HTML。原则是：静态卡负责信息密度，互动版负责学习体验；两者并存，绝不互相覆盖。
<年级>-<诗名>.html 不动；新建 <年级>-<诗名>-互动动画版.html。场景素材放 scene-assets-<诗名>/scene.png。学期 index.html 在每张静态卡下方增加“互动动画版”入口。data 数组作为唯一数据源，每句包含 line/cap/meaning/words。播放、点击诗句、点击场景、点击口诀关键词都应同步驱动：诗句高亮、场景阶段、字幕、配音、逐句意思、重点词。speechSynthesis，zh-CN，低年级用慢速朗读）。无语音合成支持时隐藏/降级配音按钮，不报错。Safari/部分浏览器需在 speakLine() 时重新 getVoices() 懒加载中文声音。.switching 渐隐/渐显反馈；播放结束按钮文案用“再来一遍”；进度条比单纯圆点更直观；自测题支持展开/收起，全部展开后显示完成提示；背记口诀节点可点击跳到对应动画阶段，形成“口诀 + 画面联想”。grid-column:1 / -1；重点词颜色优先深褐/高对比，不用低对比橙红；发光层加 will-change 或 transform 驱动，避免低端设备卡顿。<div> 开闭平衡；②内嵌 JS 语法；③诗句行数 = data 数组数；④名句/易错/字词/自测条目数符合本诗静态卡；⑤无上一首诗残留内容；⑥场景图存在且路径正确；⑦打开后版式仍为单列卡片流，不能散成横向多列。.*?</div> 替换复杂 HTML 区块，会截到内层 </div> 导致旧内容残留或 .wrap 提前闭合。替换必须锚定明确区块边界（如下一个标题、poem-meta、pill 文本等），或从数据源重新生成整页。output_dir，必须复核实际落盘目录，避免素材串目录。从教材、用户材料或常识中整理：
容量下限：每模块子项数不得低于 references/capacity-baseline.md 的表格（基准《将相和》）；模块内禁止用一条长句概括，必须有并列子项，否则判定为「薄」须返工。
每课只选一个主视觉系统：
不要堆多个装饰主题，避免「杂货铺」。
固定画布：
.page{width:1280px;height:1812px;position:relative;background:#FBF4DC;overflow:hidden}
.grid{position:absolute;top:348px;left:48px;right:48px;bottom:170px;display:grid;grid-template-columns:repeat(12,1fr);grid-template-rows:repeat(14,1fr);gap:12px}顺序不可改：
.p1~.pN 坐标表。参考模板：
references/page1-layout-first-template.htmlreferences/page3-layout-first-template.htmlPage 3 是记忆页，不是普通模块页。
⚠️ 主图必须走 ImageGen 工笔重彩管线，禁止手绘 SVG 简笔画（低幼、与图鉴级定位不符）。完整管线见 references/main-image-pipeline.md，概要：
--full 完整截图，cp 英文临时文件名规避路径问题。两条路径：
植物类铁律：只画与课文有关的部位。树/花若课文不涉及根，就不要根、土堆、地下结构；反之，若核心机制在地下（如《落花生》"花生长在土里"），必须画地下剖面。判断标准：部位是否承载课文核心机制。
人物类经验：年龄写死（IN HIS FORTIES...NOT elderly）、身份特征分开写、器物接触方式明确（REST on his back, NOT piercing）、室内场景强制 ALL WALLS MUST BE COMPLETELY BLANK（防 AI 脑补乱码标语）。
.module{overflow:hidden}，防止外溢。.fill{flex:1;min-height:0}，让内容在固定框内均分。.title-pill 必须在模块框内，不能上凸被切。交付前必须跑（按篇分批传，不要跨篇混传）：
python references/_audit-bricks.py page1-基础知识.html page2-课文理解.html page3-全文脉络.html
python references/_selftest.py page1-基础知识.html page2-课文理解.html page3-全文脉络.html合格标准：
.pN 定义都被实际使用。最终必须提供：
index.html 预览入口---
Generate productionready study mindmaps and knowledge cards (学习导图 / 课文导图 / 课堂笔记 / 学习卡 / 知识卡片 / 古诗互动卡) for prim
适合 小学 / 初中语文课文学习导图：识字、写字、字词、句子品析、写作方法、课后题、阅读考点、主旨情感小学 / 初中数学某学段、某学期知识点汇总：分单元多页知识地图、计算专项、公式与方法、题型模型、易错点、综合应用
不需要。学习导图与知识卡片面向业务与内容同学，方法已固化成可复用的流水线，跟着步骤走就能产出结果。