如何快速上手ExamPass:3个命令把一学期PPT变成备考利器(安装+快速开始教程)
如何快速上手ExamPass:3个命令把一学期PPT变成备考利器(安装+快速开始教程)
ExamPass Assistant(简称 ExamPass)是一款 AI 考试备考工具:把一学期的 PPT、Word、PDF 课件交给它,它就能一键生成结构清晰的知识清单、可交互的章节测试和仿真期末试卷,让复习事半功倍。本文是面向新手的安装 + 快速开始教程,跑通全程只需要 3 个命令。
🎯 ExamPass 是什么:把课件变成备考资料的 AI 助手
一句话概括:你负责攒课件,ExamPass 负责把它们变成"能上考场"的东西。
| 你投入的课件 | ExamPass 产出的备考资料 |
|---|---|
| 课程 PPT(PPTX) | 每章一个合并页:知识清单 + 交互式章节测试 |
| 讲义 Word(DOCX) | 公式完美渲染(MathJax)、双色标注、四色重要度标签 |
| 参考书 PDF | 可交互知识图谱、仿真期末卷(含逐题解析) |
v2.0 的几个核心亮点:
- 📖 知识清单:按「钩子 → 一句话结论 → 为什么 → 是什么 → 怎么用 → 自测」组织,右侧还钉着原始 PPT 对照栏(整页幻灯片渲染图 + 原文),对照着看不会漏
- 📝 章节测试:点击选项、一键批改,逐题解析 + 易错提醒,支持选择/判断/填空/计算/代码等 9 种题型
- 🧩 知识图谱:左章节、右知识点的树状图,依赖虚线、枢纽概念 ★ 标记、可编辑笔记卡
- 📄 仿真期末卷:智能选题型、分值恰好 100 分,还能模仿真题风格出题
适用人群:大学生、授课教师、考研考证党。
🛠️ 安装 ExamPass:3 步完成
前提:电脑已安装 Python 3 和 pip。
# 1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/ex/ExamPass-Assistant
cd ExamPass-Assistant
# 2. 安装依赖
pip install -r requirements.txt
依赖非常轻:requirements.txt 里只有 python-pptx、python-docx、pdfplumber、pymupdf 等用于解析课件的库,几秒装完即可开始使用。
📖 命令一:/exampass <目录> 一键生成知识清单 + 章节测试
这是默认流程,也是使用频率最高的命令。把 <目录> 换成你的课件文件夹路径,输入给你的 AI 助手(Claude)即可:
/exampass /path/to/我的课程PPT
运行后它会:
- 递归扫描目录,按章节自动分组(PPTX / DOCX / PDF 都支持,图片也会做多模态识别)
- 多 Agent 流水线并行工作:骨架 Agent 搭知识框架 → 笔记 Agent + 题目 Agent 按章并行创作 → 审查 Agent 两遍验证 → 渲染合并页
- 每章产出一个 HTML 合并页,顶部 tab 切换「📖 知识清单 | 📝 章节测试」
知识清单里每个知识点都带「必考 / 重点 / 高频 / 了解」四色标签,自测题还配了可折叠的参考答案(先自己答,再看解析,主动回忆效率更高)。
🧩 命令二:/exampass graph <目录> 生成可交互知识图谱
/exampass graph /path/to/我的课程PPT
生成一张"左章节、右知识点"的交互式树状图谱:
- 依赖关系用虚线连接,告诉你"学谁之前先学谁"
- 枢纽概念标 ★,考试重中之重一目了然
- 悬停显示类型 / 重要度 / 依赖的 tooltip
- 叶节点点开即可写笔记卡(支持粘贴图片,刷新后保留)
- 顶部搜索、底部缩放,左右面板宽度可拖拽调整
📄 命令三:/exampass final <目录> 生成仿真期末试卷
/exampass final /path/to/我的课程PPT
它不是套固定模板出题,而是先分析这门课实际怎么考(算法课出计算 + 代码题,文科出填空简答),再智能分配题型和分值,蓝图合计恰好 100 分。两个常用参数:
| 参数 | 作用 | 示例 |
|---|---|---|
--ref <真题> |
模仿真题的题型、分值与措辞风格 | /exampass final 课件目录 --ref 2025真题.pdf |
--chapter <章名> |
只出某一章的测试 | /exampass final 课件目录 --chapter 第3章 |
🚀 查看结果:浏览器打开即用
所有结果输出在课件目录下的 EPA/ 文件夹,每章一个 HTML 文件:
- 双击用任意浏览器打开即可,手机端也能正常显示
- 复习结束后
Ctrl+P直接打印成 PDF - 分析结果缓存在
.epa_work/,同目录再次运行秒级出结果,未修改的章节自动跳过
❓ 常见问题(FAQ)
Q:支持哪些文件格式? PPTX、DOCX、PDF 三种。PDF 中的图片会做多模态识别;非多模态模型会自动走 OCR 回退(MinerU / PaddleOCR)。
Q:怎么更新到最新版本?
输入 /exampass update,自动拉取最新代码并重装依赖。
Q:能商用吗? 不能。项目采用 CC BY-NC 4.0 许可证,允许自由使用、修改和分享,但仅限非商业用途,详见 LICENSE。
Q:想了解内部是如何工作的? 多 Agent 编排设计文档在 docs/superpowers/specs/2026-06-08-multiagent-orchestration.md,HTML 模板引擎核心在 scripts/template_engine.py,子 Agent 方法论卡片在 agents/。
✅ 写在最后
ExamPass 的完整上手路径就是三步:安装 → 3 个命令 → 浏览器打开 HTML。一学期的 PPT 丢进去,出来的就是带原始 PPT 对照的知识清单、能一键批改的章节测试和仿真期末卷——把时间留给真正需要思考的题目,而不是翻找课件。