ExamPass Assistant

期末季、考研季、考证季来临，面对一堆散乱的 PPT、Word 讲义和 PDF 资料，很多学生和老师都头疼：如何快速提炼重点？如何生成高质量练习题？ExamPass Assistant正是为此而生。它是一款开源 AI 驱动的考试准备助手，能将课堂课件转化为结构清晰的知识清单、交互式章节测试、知识图谱和仿真期末试卷，让复习真正事半功倍。

ExamPass Assistant 网站截图

核心特色

1. 多格式智能提取 支持 PPTX、DOCX、PDF，自动递归扫描目录，按章节分组。结合 Claude 多模态分析提取文字、表格和图片，非多模态模型还能自动 fallback 到 OCR，确保内容完整提取。
2. 多 Agent 深度协同流程 默认使用多 Agent 编排（5 大专业子 Agent）：
   • Skeleton Agent 构建章节 → 知识点依赖图（DAG）；
   • Notes Agent + Item Agent 并行生成笔记和题目；
   • Reviewer + Solver Agent 双重验证，找出问题并定向修订； 最终通过模板引擎渲染高质量输出。这种流程比单 Agent 更准确、逻辑更严谨。
3. 知识清单 HTML
   • MathJax 完美渲染公式；
   • 双色标注（核心知识点黑色加粗，解释浅灰）；
   • 四级优先级标签（必考/重点/高频/了解）；
   • 自动生成目录导航，打印友好（Ctrl+P 转 PDF）。
4. 交互式章节测试 支持 9 种题型（选择、多选、判断、填空、简答、计算、代码等），按学科智能适配（如算法课自动出计算和代码题）。点击作答 → 一键批改 → 逐题解析 + 易错点提醒，极大提升练习效率。
5. 交互式知识图谱 采用左右树布局，虚线显示知识依赖，枢纽概念标 ★，支持 hover 提示、内嵌笔记卡（可粘贴图片）、搜索高亮和缩放，帮你直观理解知识脉络。
6. 仿真期末整卷 交互式询问难度、时长和偏好，联网参考名校真题，生成 100 分蓝图试卷（全章覆盖、难度梯度合理），并提供答案与解析。

此外，还有 Fast 单 Agent 快速模式 和缓存机制，二次运行几乎秒出结果。界面全部为本地 HTML，离线可用，隐私安全。

适用人群

• 大学生：期末突击神器，快速掌握课程重点并自测。
• 教师：课件一键转为教学笔记 + 作业习题，节省备课时间。
• 考研/考证党：将参考书 PDF 转化为精炼清单和练习题。

如何部署与操作（超详细上手）

1. 环境准备

git clone https://github.com/WUBING2023/ExamPass-Assistant.git
cd ExamPass-Assistant
pip install -r requirements.txt

2. 主要命令（在支持 Skill 的 Agent 环境中输入，或本地运行对应脚本）

• /exampass <目录> —— 默认多 Agent 深度流程（推荐）；
• /exampass fast <目录> —— 快速单 Agent 模式；
• /exampass graph <目录> —— 仅生成知识图谱；
• /exampass final <目录> —— 生成仿真期末卷；
• /exampass update —— 一键拉取最新版本和依赖。

3. 输出位置 所有生成文件在当前目录，中间过程保存在 .epa_work/ 文件夹，便于调试和复用。

4. 高级用法 项目提供模块化 API，可在自己的代码中直接调用 save_knowledge_html、save_test、save_graph_html 等函数，灵活集成到其他工具链中。

作者采用 CC BY-NC 4.0 许可（非商业免费使用），项目活跃，近期还有更新计划。

总结

ExamPass Assistant 真正做到了“把讲义变利器”，从提取到生成再到交互练习，形成闭环复习体验。它特别适合短期高强度备考场景，能显著提升学习效率和考试通过率。