ZeKaiNie/universal-examprep-skill

它是什么

Exam Cram Coach 是一个 AI 考试准备家教，可安装为编码代理（如 Claude Code、Codex、Cursor、Windsurf 或 Gemini CLI）的“技能”。你将课程资料文件夹指向它——讲义幻灯片、笔记、作业、过去考题——它会逐章教你课程，显示你自己笔记中的实际图片，用真实作业/考题测验你，追踪你的错误，并编译 cheat sheet。

运作方式

此项目是一个代理技能（代理读取的一组指令）加上一个小型 Python 工具 coach.py。代理执行如 coach.py setup 的命令来解析你的资料：它将课程拆分为章节，从 PDF 页面裁剪图片，将作业文件与其解答文件配对（例如 hw2.pdf 与 hw2solutions.pdf），并将问题提取到题库中。在学习期间，代理教学时每个主张都会引用特定文件和页面，内嵌显示裁剪图片，并从题库中测验你。所有状态都存储在本地 study_state.json 中，因此你可以关闭聊天并稍后继续。

关键技术要点

• 设计上防幻觉：每个句子都标记来源——🟢（来自你的资料，附 file p.N 引用）、🟡（AI 补充）或 ⚠️（AI 生成的答案，资料中没有）。超出范围的查询会以非零状态退出，而不是捏造答案。
• 无数据库的持久记忆：进度、测验结果和错误存储在纯 JSON 文件中；错误在间隔重测中优先处理。无向量数据库，无 token 膨胀。
• 可在弱/小型模型上运行：在 Gemini Flash-Lite 和 Claude Haiku 上以超过 1,000 页的真实概率笔记进行基准测试——零命令捏造和零幻觉引用报告。
• 自动图片提取：使用 pypdfium2 从 PDF 页面裁剪向量图片，因此家教可以显示你讲义或解答中的确切图表。

范围与限制

它不是独立应用程序——需要具有终端的编码代理。PDF 支持需要 pypdfium2（可选；其他格式如 PPTX/DOCX/Markdown 无需它即可运行）。扫描或手写页面会被检测并跳过，Excel/音频文件不会被读取。有两个版本：Flash（轻量级，推荐，适用于小型模型）和 Full（v4.3，新增可打印的 HTML/PDF 学习指南和验证管道，但需要更强的模型）。