# Eng

**Repository Path**: aufesta/eng

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中学英语试卷批改助手

上传中学英语试卷图片，AI 自动批改：错题标注正确答案与解析、生成类似巩固题、给出整张试卷点评。

## 功能

- 📷 **上传试卷**：支持 JPG、PNG 等图片（拍照或扫描件）
- ✅ **逐题批改**：识别题目与学生答案，判断正误并计分
- 📝 **错题讲解**：错误题目旁显示正确答案，并用中文解释错因
- 🔄 **巩固练习**：每道错题附一道同考点类似题，附答案与解析
- 💬 **整体点评**：总结亮点、薄弱点、学习建议与鼓励语

## 快速开始

### 1. 获取通义千问 API Key（推荐）

1. 注册 [阿里云](https://www.aliyun.com/) 并完成**实名认证**
2. 打开 [百炼控制台](https://bailian.console.aliyun.com/) 开通模型服务
3. 进入 [API Key 管理](https://bailian.console.aliyun.com/?tab=api#/api) 创建 Key（格式 `sk-...`）

> 新用户通常有 **100 万 Token 免费额度**（约 90 天），识图模型用 `qwen-vl-plus`。

### 2. 配置环境变量

```bash
cp backend/.env.example backend/.env
# 编辑 backend/.env，填入 DASHSCOPE_API_KEY
```

`.env` 示例：

```env
DASHSCOPE_API_KEY=sk-你的百炼Key
OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
OPENAI_MODEL=qwen-vl-plus
AI_REQUEST_TIMEOUT_SEC=180
```

### 3. 一键启动

```bash
chmod +x start.sh
./start.sh
```

浏览器打开 **http://127.0.0.1:5173**

### 4. 手动启动（可选）

**后端：**

```bash
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # 并配置 DASHSCOPE_API_KEY
uvicorn main:app --reload --port 8000
```

**前端：**

```bash
cd frontend
npm install
npm run dev
```

## 使用说明

1. 点击或拖拽上传试卷图片（建议清晰、光线充足）
2. 可选填写补充说明（年级、单元、某题手写辨认困难等）
3. 点击「开始批改」，等待 AI 分析（通义通常 20～60 秒）
4. 查看批改结果：得分、批改卷面、详细解析

## 技术栈

- **前端**：React + TypeScript + Vite
- **后端**：Python FastAPI
- **AI**：通义千问 VL（OpenAI 兼容接口）

## 切换其他 AI 服务

| 服务 | BASE_URL | MODEL |
|------|----------|-------|
| **通义千问（默认）** | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen-vl-plus` |
| 通义（更快） | 同上 | `qwen3-vl-flash` |
| 智谱 | `https://open.bigmodel.cn/api/paas/v4/` | `glm-4v-flash` |
| OpenAI | `https://api.openai.com/v1` | `gpt-4o` |

## 注意事项

- 通义需在百炼控制台开通 **视觉模型** 权限
- 免费额度用完后会按量计费，建议开启「用完即停」
- 识别准确度取决于图片清晰度；手写卷建议补充说明
- 结果仅供学习参考，正式考试请以教师批改为准