核心功能
exam-rescue-html 是一款面向考前冲刺阶段的自动化复习资料生成工具。它读取知识图谱文件(knowledge_map.json),通过智能筛选与知识库检索,生成三合一抢救清单:核心公式速记、高频考点清单、高频错点清单,最终输出为可打印的HTML卡片页面。
显著优点
1. 零交互自动化:全程无需用户确认,从数据读取到文件输出一次完成,符合「静默执行协议」设计
2. 智能内容筛选:基于 importance 阈值动态调整(≥0.75 → 自动降级至 ≥0.6),确保内容充足
3. 双模式检索:结合结构化数据(knowledge_map)与非结构化知识库(note_retrieve),内容有溯源
4. 印刷友好设计:HTML模板支持打印,考前1小时快速浏览场景优化
5. 容错降级机制:空分区自动隐藏、知识库缺失时基于考点名兜底生成,流程不中断
潜在局限
- 依赖前置数据:必须依赖 exam-question-generator 生成的 knowledge_map.json,无法独立启动
- 模板耦合:强制依赖 assets/template.html,自定义样式需修改模板文件
- 文科场景弱化:纯文科场景(无公式类考点)会自动省略公式分区,功能缩减为二合一
- RAG质量波动:知识库检索结果质量直接影响卡片内容深度
适合人群
- 备考周期紧张、需要结构化冲刺资料的考试人群
- 已使用配套 exam-question-generator 完成知识图谱分析的用户
- 偏好纸质复习材料、需要考前最后一轮查漏补缺的考生
常规风险
| 风险项 | 说明 |
|--------|------|
| 文件覆盖 | 「重新生成」指令直接覆盖旧文件,无版本备份机制 |
| 数据时效 | 依赖知识库内容更新,若知识库滞后则卡片信息可能过时 |
| 打印适配 | 不同浏览器/打印设置可能导致分页异常,建议预览后调整 |
技术亮点
- 三类卡片差异化渲染(importance 分级圆点、薄弱点标签、对错对比格式)
- 占位符模板引擎实现内容-表现分离
- 完整错误矩阵覆盖 6 种异常场景,生产环境鲁棒性高