考试助手（exam-helper）是一个单文件 HTML 应用，用于本地加载 Excel/CSV 题库并快速检索、查看答案。它无需服务器、无需联网，打开即用。
核心特性
- 单文件离线使用：构建产物只有一个
exam-helper.html，双击即可在浏览器中运行。 - 自动递归加载目录：选择包含题库文件的文件夹后，自动读取
.xls、.xlsx、.csv及子目录中的文件。 - 多种检索方式：
- 中文关键字
- 全拼，如
anquan - 拼音首字母，如
aq - 英文缩写（大写），如
GDW - 空格分隔表示“且”关系
- 自适应展示：响应式网格布局，宽屏一行多个卡片；每页固定 10 行，根据列数自动计算题数。
- 答案高亮：单选题、多选题的正确选项自动标绿，判断题、简答题直接显示答案。
- 备注醒目：备注信息以红色加粗显示，重要提示一目了然。
快速开始
npm install
npm run build
构建完成后，用浏览器打开生成的 exam-helper.html，点击「选择题库目录」并选中题库文件夹，即可在搜索框中实时检索题目。
首次使用必须手动选择一次目录，后续打开会自动使用浏览器缓存的题库数据。
题库格式
题库文件使用 Excel 工作表，第一行为表头，必须包含以下列：
| 列名 | 说明 |
|---|---|
| 序号 | 题目序号 |
| 一级纲要 | 题目所属章节/分类 |
| 二级纲要 | 二级分类（可留空） |
| 题目分类 | 题库分类，如“专业题库” |
| 题型 | 单选题 / 多选题 / 判断题 / 简答题 |
| 题干 | 题目内容 |
| 选项 | 用 ` |
| 答案 | 单选题填 A/B/C/D；多选题填 ABCD 等；判断题填 A/B 或 正确/错误；简答题可填写完整答案 |
| 题目依据 | 出处/标准（可选） |
| 试题分数 | 分值（可选） |
| 试题编码 | 编码（可选） |
| 备注 | 备注信息，会红色加粗显示（可选） |
| 说明 | 其他说明（可选） |
| 判断题解析 | 判断题解析（可选） |
项目已提供示例模板 templates/question-bank-template.xlsx，包含单选、多选、判断、简答四种题型的科普样例，可直接参考。
项目结构
src/exam-helper-template.html：应用源码模板。scripts/build.js：将 SheetJS、拼音库内联到 HTML 中，生成最终exam-helper.html。scripts/generate-template.js：生成示例题库模板。docs/：架构、设计决策、踩坑经验与扩展指南。
开源许可
MIT License