前言¶
老师发来一份试卷 PDF，要做成能在教室一体机上讲的互动课件。常规做法是把题目截图贴进 PPT，批注写在边上，学生点选项不会判分，材料和题目也对不上位置。下面的 Skill 把这件事收敛成一条流程：输入试卷文件，输出一个单文件 HTML 课件，左侧目录逐题导航，材料区和试题区联动，选项点击即时判分，不需要额外部署服务。
这是什么¶
试卷转互动讲题课件（HTML），坐标 @user_a4f793e8/paper-to-lecture-html，当前版本 1.4.1，由 user_a4f793e8 发布，来源 community，分类 education。它解决的问题是：把老师提供的试卷（PDF / docx / 文字稿，全科适用）变成一个单文件互动讲题课件，教室一体机即开即用、可离线。
资料里带一个标签 requires_api_key=false，说明不强制依赖外部密钥即可使用。
核心功能¶
下面按课件结构和解析链路两部分介绍。
课件侧能力¶
课件本身是单文件 HTML，功能分四类：
1、导航与分区。左侧目录逐题导航；材料区与试题区联动，对应「材料精读 ↔ 试题演练」两种讲法。
2、即时反馈。点击选项即时判分；点击定位时高亮材料对应位置；完形 / 填空的挖空可揭示答案。
3、讲评辅助。解答题分步解析；主观题给出踩分点对照；术语以气泡形式解释；方法点拨用弹窗承载。
4、内容渲染。选项图卡片与配图灯箱；KaTeX 公式渲染；支持内嵌音频。
解析链路¶
解析走 MinerU，且是双路径，按输入形态选其一：
1、云端 API 自动解析。把试卷交给 MinerU 云端接口，直接取回结构化结果。
2、App 手动解析产物。在 App 里先解析完，把产物作为输入喂给这个 Skill。
两条路径的产出都指向同一个中间结构，再组装成课件，所以输入是 PDF、docx 还是纯文字稿，上游解析方式不同，下游组装逻辑一致。
题目可视化（v1.3 起，v1.4 起改流程）¶
v1.3 起支持题目可视化。v1.4 起改为两阶段流程，目的是让老师先确认内容、再决定要不要加可视化，避免先生成一堆用不上的图。
1、先交付无可视化的基线版课件，同时附一份 lecture_preview.md，内容是老师需要重点核对的项 + 可视化建议清单。
2、老师在清单上勾选。
3、勾选结果作为路由输入，调用 edu-* 可视化技能族生成 embed 面板，再重组装出带可视化的新版课件。
目前资料列出的可视化技能族覆盖六类：立体几何 3D、解析几何、函数图象、化学反应微观、物理受力、地理地球运动。可视化结果以可展开 / 缩放的折叠条挂载进课件，不改动原有课件结构，基线版的内容和排版保持原样。
内容准确性机制¶
资料称内置三重机制：
- 「知识准确性五道关」
- 独立对抗审查
- 黄金样例锚点
目标是让解析出的题干、答案和解析对齐课程标准与教材。这部分属于 Skill 内部的自检机制，实际效果取决于试卷本身的质量和触发链路，资料没有给出量化指标。
安装与启用¶
官方页面没有给出 git clone 或包管理器安装命令，因此这里不写未核实的命令。目前可确认的启用方式是触发词匹配。
在对话里直接说出触发词即可唤起。触发词有：
讲题课件
讲题神器
互动课件
试卷转HTML
双栏讲题
paper to lecture
题目可视化
立体几何演示
如果要调用可视化技能族，说明需求时应带上具体的题型（例如「立体几何 3D 演示」或「函数图象」），这样路由能落到对应技能。
关于 Cursor / Codex CLI / Claude Code 的差异：资料里没有分工具的安装说明，此处不做分别说明。
典型用法¶
按 v1.4 的流程走一遍，可复现的步骤如下。
1、给出试卷文件与目标。输入可以是 PDF、docx 或文字稿，说明要做成讲题课件。
把这份试卷做成讲题课件，需要题目可视化。
2、等基线版课件与 lecture_preview.md。这一步不生成可视化面板，先拿到可讲的基线版和需要老师核对的清单。
3、老师勾选 lecture_preview.md 中的核对项与可视化建议。
4、按勾选结果组装新版。说明要启用哪些可视化技能族，例如：
勾选项已确认。立体几何用 3D 演示，函数图象也加上，重新组装课件。
5、拿到重组装后的新版课件，可视化部分以折叠条挂载，其余结构与基线版一致。
如果只需要基线版，在第 2 步之后停止即可，不需要走勾选和重组装。
适用场景与注意¶
适合的场景：老师手里有纸质试卷或现成的 PDF / docx，需要在教室一体机上逐题讲解；需要材料与题目联动、学生作答即时判分的课堂；需要离线可用，不依赖外部服务的场合。
要注意的地方：
1、可视化是两阶段流程，先交付基线版再由老师勾选。不要跳过勾选直接要求全部可视化，否则可能生成用不上的面板。
2、可视化技能族目前资料只列出六类（立体几何 3D、解析几何、函数图象、化学反应微观、物理受力、地理地球运动），超出这六类的需求不在已核实范围内。
3、解析质量受上游 MinerU 双路径影响，复杂版式（跨页图表、多栏混排）需要先确认解析产物是否正确，再进入组装。
4、课堂一体机离线可用，但云端 API 自动解析这一路径本身需要联网，离线环境要改用 App 手动解析产物路径。
5、页面指标为抓取时点数据：评分 100000、下载 2927、安装 0。任务简报里给出的 99111 / 2768 与该数据不一致，以官方页面实时数值为准。
结尾¶
这个 Skill 的价值在于把「解析试卷 → 组装讲题课件 → 可选题目可视化」串成一条可重复的链路，产出是单文件 HTML，教室一体机即开即用。如果你手上的试卷版式复杂，建议先用一条流水线跑通一题，确认解析产物和判分逻辑，再批量处理整卷。
官方地址：https://api.skillhub.cn/user_a4f793e8/paper-to-lecture-html
