ExamPass Assistant 

面对厚重的课堂讲义和复杂的期末考试，如何高效提炼重点、检验掌握程度？ExamPass Assistant 是一款开源的 AI 驱动考试辅助工具。它能一键读取 PPTX、DOCX、PDF 等课件，通过多 Agent 深度编排流程，自动生成结构化知识清单、交互式章节测试、动态知识图谱及仿真期末试卷，将静态文档转化为动态的学习利器。

核心亮点：智能、交互、闭环

1. 多模态内容提取与结构化

• 广泛兼容：支持 PPTX、DOCX、PDF 格式，递归扫描目录并按章节自动分组。
• 智能解析：利用 Claude 多模态能力或 MinerU/PaddleOCR 回退机制，精准提取文字、表格及图片中的关键信息。
• 知识清单 HTML：
  • 完美渲染：支持 MathJax 公式，双色标注（知识点黑粗+解释浅灰）。
  • 重点分级：四色标签标识重要程度（必考/重点/高频/了解），自带目录导航。

2. 交互式章节测试

• 9 种题型自适应：涵盖选择、多选、判断、填空、简答、计算、代码、问答及综合题。
• 学科智能匹配：算法课自动生成计算与代码题，文科课自动规避计算题。
• 即时反馈：点击选项即可批改，提供逐题解析与易错提醒，支持浏览器直接打开与打印。

3. 动态知识图谱

• 可视化依赖：左章右组件树布局，虚线连接概念依赖，枢纽概念 ★ 标记。
• 交互增强：悬停显示 Tooltip，叶节点支持编辑笔记卡（粘贴图片、刷新保留），顶部搜索高亮，底部自由缩放。

4. 仿真期末试卷

• 蓝图式命题：交互式询问难度、时长与偏好，联网参考名校真题。
• 科学分值分布：总分 100 分，全章覆盖，枢纽权重更高，难度呈梯度分布。
• 双重验证：做题 Agent 两遍验证确保题目逻辑严密、答案准确。

技术架构：多 Agent 深度编排

默认 /exampass 命令调度 5 个专业子 Agent，形成严谨的生产流水线：

注：所有中间产物保存在 .epa_work/ 目录，支持断点续传与秒级缓存复用。

快速开始

1. 安装

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

2.使用命令

• 全流程深度处理（推荐）：

  /exampass <课件目录>
  # 生成：知识清单 + 章节测试 + 知识图谱 + 仿真试卷
  

• 快速模式（单 Agent）：

  /exampass fast <课件目录>
  # 跳过子 Agent 编排，快速产出初稿
  

• 单独生成知识图谱：

  /exampass graph <课件目录>
  

• 单独生成仿真期末卷：

  /exampass final <课件目录>
  

• 更新工具：

  /exampass update
  

适用场景

• 大学生：考前突击，将几十页 PPT 转化为精简清单与自测题，高效通过期末考。
• 授课教师：一键将课件转化为结构化教案与配套习题，减轻备课负担。
• 考研/考证党：将厚重参考书转化为精简知识网络，配合自测题查漏补缺。