课件精读

PPT 是讲课的提词卡，不是教材。 老师站在讲台上会口头补三样：术语什么意思、这一步怎么推过来、这个工具有什么用。精读 = 把这三样还原成文字。 验收：读者不看 PPT，只看这份文档也能懂。

执行顺序（照做，别自创流程）

1. 读 —— 先提取文字拿骨架；公式页 / 推导页 / 图页必须渲染成图逐张看（文字版公式不可信）。
2. 补洞 —— 按下面八查过一遍，只补会让人卡住的地方。
3. 写 —— 复制 assets/template.html 到工作目录，只改 <body> 里的内容，CSS 不动。
4. 配图 —— 几何型知识点从原 PDF 裁真图（fitz.Rect + Matrix(4,4)），base64 内联。只挑最核心的 3–5 张；裁完回看，边缘常带进 PPT 标题/页码/装饰线，需微调。
5. 出 PDF —— 跑 assets/print-pdf.ps1（Windows）。macOS/Linux 见该文件顶部注释。
6. 查 —— 把 PDF 渲染回来抽查 3–4 页，确认没超框、没断图。
7. 交 —— PDF 放目标目录，HTML 留同目录当源文件；一句话汇报位置，不讲过程。

八查（每节过一遍，只补会引起卡壳的）

分寸：判据只有一条——读者会不会因为这里读不下去？ 会 → 必补；只是「更完整 / 更漂亮」→ 不补。 ⚠️ 机械地按八查补，会把 1 页撑成 5 页。

排版（模板已实现，别改样式）

• 简洁第一：一段能说清就不写三段。
• 矢量加粗：E、r、b。
• 三级编号 3.1 / 3.1.1，每个分点挂来源页码 <span class="pill">P27</span>。
• 色块克制：tip 易考点 / warn 易错 / ok 思考题。写之前自问值不值得单独开框。
• 新术语就地定义：中文名 + 英文名 + 一句话 + 单位，不做集中符号表，不指望后文补。
• 公式用 .eq 单独成块放大；每个符号都要能在本文档查到定义。

骨架

封面（课程 + 覆盖了哪几份文件）→ 目录 → 逐节精读 → 习题（英文原文照录 + 译文 + 思路 + 答案）→ 附录（公式速查 / 英中术语对照 / 怎么复习）。 多章合订用「第 N 部分」，每部分前加 <div class="part"></div> 另起页。

别写错

• 断言「教材印错」前必须看原始排版图。老师讲义的系统性错误就两处：根号漏倒数、分数漏分子——代两个极端值（v=0、v→c）验一遍就能发现。
• 习题答案一律自己复算。原卷答案也会错、也会和题干参数对不上；原卷没答案要注明「本讲义补做」。
• 没核实的内容不写，比写错强。
• 改旧文件先备份成 .old-旧版(原因).pdf，绝不删用户文件。

技术坑

• HTML / PDF 路径不带中文——直接打印会静默失败。先打到英文临时路径，再复制过去。
• --user-data-dir 每次换一个新空目录；失败就换个名字重试。
• 终端那堆报错是浏览器的日志，只看 bytes written 和退出码。
• PyMuPDF 装到独立目录，别污染主环境：pip install --target <dir> pymupdf，用 PYTHONPATH=<dir> python ... 跑。