# exam-helper

**Repository Path**: zhenzekun/exam-helper

## Basic Information

- **Project Name**: exam-helper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-16
- **Last Updated**: 2025-08-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能答题助手

一个纯前端的答题助手工具，帮助您管理和查找题目答案。

## 🚀 主要功能

### 📋 试卷管理
- **选择文件夹加载试卷**：一键选择包含JSON文件的文件夹，自动加载所有试卷数据
- **智能识别格式**：支持新旧两种JSON格式，自动提取试卷ID
- **批量处理**：同时处理多个试卷文件

### 💾 文件管理
- **导出到文件夹**：将答案数据按试卷ID分类保存到对应文件夹
- **自动创建文件夹**：使用File System Access API自动为每个试卷创建专属文件夹
- **兼容性保障**：不支持新API的浏览器自动降级到传统下载方式

### 📚 答案库管理
- **查看所有答案**：浏览已导入的所有题目和答案
- **试卷ID统计**：按试卷ID统计题目数量和分布
- **手动编辑答案**：通过题目ID精确查找和修改答案
- **快速修正**：一键修正已知的错误答案

### 🤖 智能作答辅助
- **答案建议**：输入题目内容，智能匹配相似题目
- **模糊搜索**：支持关键词模糊匹配
- **精确匹配**：优先显示完全匹配的题目

### 🔐 认证配置
- **Token管理**：安全存储和管理API认证信息
- **连接测试**：验证认证信息的有效性
- **批量导入**：通过API链接批量导入答案数据

## 📖 使用指南

### 1. 基础设置
1. 打开 `exam-helper.html` 文件
2. 在"认证配置"区域输入您的Authorization Token
3. 点击"保存认证信息"并测试连接

### 2. 导入数据
**方式一：选择文件夹**
1. 点击"📁 选择文件夹加载试卷"
2. 选择包含JSON文件的文件夹
3. 系统自动加载所有试卷数据

**方式二：API导入**
1. 在"数据导入"区域输入API链接
2. 点击"批量导入答案"
3. 查看导入进度和结果

### 3. 查找答案
1. 在"智能作答辅助"区域输入题目内容
2. 点击"获取答案建议"
3. 查看匹配的题目和答案

### 4. 管理答案
- **查看答案**：点击"查看所有答案"浏览题库
- **编辑答案**：点击"✏️ 手动编辑答案"修正错误
- **统计信息**：点击"📊 试卷ID统计"查看数据分布

### 5. 导出数据
1. 点击"📤 导出到文件夹"
2. 选择目标文件夹（现代浏览器）
3. 系统自动按试卷ID创建文件夹并保存数据

## 🔧 技术特点

### 纯前端实现
- 无需后端服务器
- 数据存储在浏览器本地
- 支持离线使用（除数据导入外）

### 现代浏览器支持
- 使用File System Access API实现文件夹操作
- 自动降级兼容旧版浏览器
- 响应式设计，支持各种屏幕尺寸

### 数据格式兼容
- 支持新格式：包含examRecordId的结构化数据
- 支持旧格式：简单的题目-答案键值对
- 智能识别和转换数据格式

## 📁 文件结构

```
ceshi/
├── exam-helper.html    # 主程序文件
├── README.md          # 说明文档
└── [试卷ID]/          # 导出的试卷文件夹
    └── [试卷ID]_[时间戳].json
```

## 🛠️ 答案修正功能

### 手动编辑
1. 点击"✏️ 手动编辑答案"
2. 输入题目ID
3. 点击"🔍 查找题目"定位题目
4. 修改答案并保存

### 快速修正
- 点击"🔧 快速修正错误答案"一键修正已知错误
- 支持批量修正多个题目
- 自动更新时间戳记录修改历史

## 💡 使用技巧

1. **定期导出备份**：使用导出功能定期备份答案数据
2. **按试卷分类**：利用试卷ID统计功能管理不同考试的题目
3. **模糊搜索**：搜索时使用关键词，提高匹配成功率
4. **及时修正**：发现错误答案时及时使用编辑功能修正

## ⚠️ 注意事项

- 本工具仅供学习辅助使用，请遵守相关规定
- 数据存储在浏览器本地，清除浏览器数据会丢失答案库
- 建议定期导出数据进行备份
- 使用现代浏览器（Chrome、Edge、Firefox等）获得最佳体验

## 🔄 更新日志

### 最新版本
- ✅ 重新设计文件管理：简化为导出功能
- ✅ 优化试卷选择：通过文件夹选择自动加载
- ✅ 移除冲突功能：精简界面，避免功能重复
- ✅ 新增答案编辑：支持手动修正错误答案
- ✅ 实现文件夹导出：自动创建试卷分类文件夹

---

**提示**：这是一个学习辅助工具，请合理使用，遵守相关规定。