# 阅卷助手使用说明（手机 / 电脑）

> 版本：扩展 v1.2.21 ｜ 更新日期：2026-11-04

---

## 一、哪些浏览器能用？

| 环境 | 能不能装 | 说明 |
|---|---|---|
| **电脑 Chrome**（Windows/Mac/Linux） | ✅ 可以 | 推荐，完整体验 |
| **电脑 Edge**（Windows/Mac） | ✅ 可以 | 推荐，与 Chrome 同一套内核 |
| **电脑 Firefox** | ⚠️ 不行 | 扩展是 Chrome/Edge 格式，Firefox 装不了 |
| **安卓 Chrome** | ❌ **不支持** | Google 官方明确：手机版 Chrome 不提供扩展功能 |
| **安卓 Edge** | ⚠️ 需 Canary/Dev 版 | 稳定版尚未开放扩展；且**不能侧载解压目录**，只能用商店安装 |
| **安卓 Kiwi / Yandex / Quetta** | ✅ 可以 | 这几款支持从 Chrome 应用商店装扩展 |
| **iPhone / iPad Safari** | ❌ 不行 | iOS 不支持 Chrome 扩展 |
| **安卓 微信内置浏览器** | ❌ 不行 | 同上 |

**一句话**：**电脑端 Chrome 或 Edge 是主力场景**。手机端只有 Edge Canary/Dev、Kiwi 这类少数浏览器能用，且安装麻烦、屏幕小、框选精度低，**不推荐用手机阅卷**。

---

## 二、电脑端安装（Chrome / Edge）

### 1. 下载扩展

在网站「我的账户」页下载 `kaige-grading-extension.zip`，解压到某个固定目录（**别删**）。

### 2. 加载扩展

| 浏览器 | 操作 |
|---|---|
| Chrome | 地址栏输入 `chrome://extensions` → 右上角打开「开发者模式」→ 点「加载已解压的扩展程序」→ 选刚才解压的文件夹 |
| Edge | 地址栏输入 `edge://extensions` → 左下角打开「开发人员模式」→ 点「加载解压缩的扩展」→ 选文件夹 |

### 3. 后续升级

重新下载 zip 覆盖原文件夹 → 在扩展管理页点「重新加载」图标。
或直接运行解压包里的 `update-extension.bat`（自动下载并覆盖）。

> ⚠️ 注意：Chrome / Edge **不会自动更新**「加载已解压」的扩展，必须手动重载一次。

---

## 三、第一次设置（只需做一次）

打开要阅卷的系统网页，点浏览器工具栏的扩展图标 → 选「在网页底部打开阅卷面板」。

页面底部会出现一条紫色工具条，展开后按顺序设置三项：

### ① 框选答题区域

1. 点工具条上的 **「框选答题区」**（按钮变红表示已进入框选模式）
2. **在页面上按住鼠标左键拖动**，把学生答题的那一块框出来
3. 松开鼠标，坐标自动保存

框可以随时调整：拖动框的**中间部分**移动位置，拖动**四边和四角的小方块**改大小，点右上角红叉删除。

### ② 设分数框（填分数的那个输入框）

- **电脑**：点「设分数框」→ 把鼠标**停在**分数输入框上不动，5 秒后自动记录
  - 如果 5 秒内没检测到，它会提示你，直接**点一下**那个输入框即可
- **手机**：点「设分数框」→ **直接点一下**分数输入框（手机没有悬停，不能用 5 秒那招）

### ③ 设提交按钮

- **电脑**：点「设提交按钮」→ 鼠标停在提交按钮上 5 秒；没检测到就点一下它
- **手机**：点「设提交按钮」→ **直接点一下**提交按钮

> 设置时点到了提交按钮也不会真的提交——扩展会拦住这次点击。

三项都设好后，工具条上会显示 `答题区: (x1,y1)→(x2,y2)` 等坐标，并出现绿色小圆点标出位置。

---

## 四、调用历史评分规则（换个标准批改）

批改中途发现评分标准不合适（比如分值算错了、细则写窄了），不用重建，从历史里调出来改就行。

### 弹窗里操作（点浏览器工具栏的扩展图标）

1. **「历史规则」下拉**：列出你保存过的全部规则，显示为 `名称（X分）— 年级·科目·题型`
2. **选中即载入**：下方表单（名称、学段科目题型、满分步长、参考答案、评分细则、关键词）立刻填成这条规则的内容
3. **改完点「保存规则」**：直接更新这条规则，网页底部面板同步生效
4. 不想动原来那条 → 点 **「另存为新规则」**（自动加「（副本）」后缀，原规则保留）
5. 规则不要了 → 点 **「删除此规则」**
6. 想改完直接开批 → 点 **「应用这条规则并开始批改」**：自动保存 + 切到网页底部面板 + 开始批改

### 提示

- **换规则会自动中止当前批次**：如果正在「自动运行」，切换规则会先停下来并提示，
  因为换标准 = 换评分尺度，旧标准的分数填进新标准的批次里对不上账。中止后重新点「自动运行」即可。
- **中止时正在识别的那份不会写进系统**：会提示「本次已中止，X 分未填入系统（额度已扣）」——
  分数是算出来过的，但没填、也没点提交。
- 网页底部的面板里也有同一个规则下拉，两边会保持一致。

---

## 五、日常阅卷

| 按钮 | 作用 |
|---|---|
| **单次阅卷** | 评分 → 自动填分，**不点提交**。老师核对答案和评分依据后自己点提交 |
| **自动运行** | 连续批改：自动填分 + 自动提交 + 自动翻到下一题 |
| **中止** | 停止自动运行（连续失败 3 次也会自动停） |

展开面板里可以设置**批次数量**和**每份间隔秒数**（AI 识别要十几秒，间隔别设太短）。

---

## 五之二、批完以后怎么复盘、调提示词

批完一批（或中途点了「中止」）之后，左下角的卡片会变成**「评分记录」**，顶部有 `◀ 3/15 ▶` 这样的翻阅按钮，
键盘 **← →** 也能翻。一条条看过去，就知道 AI 当时是怎么判的、扣在哪。

面板展开后底部还有一个**「阅卷记录」**区，两个标签：

| 标签 | 内容 |
|---|---|
| **本次** | 这次批改产生的每一条（中止后仍然保留，可逐条翻） |
| **历史** | 服务器上保存的全部阅卷记录（老师翻阅阅卷系统的历史记录时，点某一条，左下角卡片就同步显示那一份的 AI 分析和答题区原图） |

### 怎么用这些记录调提示词

记录卡上**没有**「重评」按钮——运行中的批次根本没空操作，停下来之后看到的又是另一份卷子，
放两个按钮在那儿只会让人误以为能用。正确的做法是：

1. **中止批次**，或者让它跑完；
2. 翻阅记录（`◀ ▶` 或键盘 `← →`），找出 AI 判得不对的那几份，看它的「评分依据」说漏了什么；
3. 点工具条的 **「▼ 展开」** 打开**全屏面板**，在左栏改评分细则（参考答案、评分细则、关键词、补充规则）；
4. 点 **「保存规则」**；
5. 回到阅卷页面，**手动点「单次阅卷」** 重新评一遍当前这份，对比新分数对不对；
6. 满意了再重新跑这一批。

> 想批量对比新旧效果，就用「历史」标签翻出旧记录，
> 对照着看同一条答案在两次批改里的评分依据差在哪。

---

## 五之三、全屏面板（改评分标准的地方）

工具条底部的 **「▼ 展开」** 不只是把面板拉高，而是把**整个浏览器窗口**变成阅卷面板：

```
┌──────────────────────────────────────────────┐
│ 凯歌云教阅卷  8分  已填 8 分…   [框选][单次][自动]… │
├───────────────────────────┬──────────────────┤
│ 后端地址 / 坐标配置        │  本次结果         │
│ 评分规则（下拉 + 按钮）     │  8  学生答案…    │
│ ┌─ 规则详情（可编辑）────┐ │  评分依据…       │
│ │ 名称  学段  科目  题型 │ ├──────────────────┤
│ │ 满分  步长            │ │  阅卷记录        │
│ │ 参考答案（多行）        │ │  [本次][历史]    │
│ │ 评分细则（多行）        │ │  8/10 …         │
│ │ 正确情形 / 错误情形      │ │  6/10 …         │
│ │ 补充规则                │ │  3/10 …         │
│ └──────────────────────┘ │                  │
│ [AI一键优化] [保存规则]     │                  │
│ 批量阅卷 批次/间隔          │                  │
└───────────────────────────┴──────────────────┘
```

- **字号跟着窗口走**：窗口拉大，字变大；缩小（Ctrl+−），字跟着变小。不会挤成一团。
- **浏览器可以自己调大小**：全屏是扩展的覆盖层，缩放窗口、切换标签页都不影响。
- 点 **「▲ 收起」** 回到原来的底部窄条，恢复默认状态。

> 改评分标准建议在**全屏**下做：字段多、字大，改起来不费劲。
> 全屏时左下角那张浮动卡片会自动隐藏（内容已经在右栏「本次结果」里了）。

---

## 五之四、调整评分记录卡（位置、大小、颜色）

左下角那张「评分记录」卡片可以随便调：

| 操作 | 怎么做 |
|---|---|
| **移动位置** | 按住卡片顶部的**标题栏**拖动 |
| **改变大小** | 鼠标移到卡片**四个角**，会冒出小三角，拖它即可。默认是正方形，拖成横的竖的都行 |
| **文字自适应** | 卡片放大，标题、分数、正文都会跟着变大（是真正的字号放大，不是拉伸，所以字还是清晰的） |

位置和大小会自动记住，下次打开还在。

**换配色**：点插件图标打开弹窗 → 「**评分记录卡外观**」区

- **主题**：深紫 / 浅色 / 墨绿 / 暖橙 四套，点一下就换
- **自定义**：背景色、标题文字、分数、字段名、正文内容、次要文字 —— 六项都能用取色器单独调
- 「**恢复默认色**」回到当前主题的配色；「**恢复默认位置大小**」把卡片放回左下角并变回正方形

---

## 五之五、评分规则的导入与导出（txt）

弹窗的「评分规则」区有两个按钮：

- **导出规则 (txt)** —— 把当前这条规则存成一个 txt 文件
- **导入规则 (txt)** —— 选一个 txt 文件，内容自动填进表单，确认后点「保存规则」

导出的 txt 长这样（可以直接用记事本改，改完再导入）：

```
凯歌云教阅卷 - 评分规则
说明: 本文件可直接导入凯歌云教阅卷插件；修改文字后再导入即可。

规则名称: 初一英语·书面表达
学段: 初一
学科: 英语
题型: 书面表达
满分: 10
步长: 0.5

[参考答案]
Hello! My name is Wang Xiaoli. I'm 12 years old.

[评分细则]
4分: 自我介绍完整（姓名、年龄）
3分: 内容要点覆盖（三点以上）
2分: 语言基本通顺
1分: 有语法错误但可读

[正确情形关键词]
name,age,live

[错误情形关键词]
wrong,miss

[补充规则]
涂改处按无法辨认处理，扣分从严
```

适合的场景：**一套评分标准在多台电脑/多人之间传**、**给同事一份统一的标准**、
**把 AI 判错的细则改一改再导出去给别人用**。

---

## 五之六、浏览器最小化后还能继续阅卷吗？

**目前不行，但不会「坏掉」，而是会暂停等你。**

Chrome 在窗口最小化时会停掉页面的绘制，`captureVisibleTab` 拿不到画面——这是浏览器的限制，
不是插件的 bug。现在的表现是：

- 自动阅卷遇到最小化 → **自动暂停**，工具条提示「窗口已最小化，已暂停 · 完成 N/71」
- **把窗口恢复出来，会自动接着批**（不用重新点「自动运行」）
- 中途按「中止」可以彻底停下

所以：**离开电脑前记得把窗口恢复出来**。

理论上可以用 `chrome.tabCapture`（录屏式捕获）绕开这个限制，被捕获的标签页会保持渲染。
但那要改成视频流取帧的整套方案，工程量大、还要申请额外权限，而且录屏方式本身有
「2 次/秒」的频率限制。目前先不做，等真有老师提出「必须最小化也要跑」的需求再上。

---

## 六、手机上怎么设置坐标（如果确实要用）

1. 用 Edge Canary / Kiwi 打开阅卷系统网页
2. 打开扩展面板 → 「在网页底部打开阅卷面板」
3. 点「框选答题区」→ **手指按住拖动**（不是点一下）
4. 点「设分数框」→ **点一下**分数输入框
5. 点「设提交按钮」→ **点一下**提交按钮

手机注意事项：
- 底部工具条**会遮住页面下方**，把要设的输入框往上滚一点再点
- 工具条上的按钮可以**左右滑动**查看更多
- 屏幕小，框选精度有限，建议框得比实际答题区**稍大一点**

---

## 七、常见问题

**Q：装完扩展，网页底部没出现工具条？**
A：点扩展图标 → 「在网页底部打开阅卷面板」。部分网站需要刷新一次页面。

**Q：提示"Fail to fetch"？**
A：网络抖动，扩展会**自动重试**（最多 4 次，1.2/2.4/4.8 秒退避）。重试期间工具条会显示「网络异常，正在重试 N/4…」。
同一个请求不会重复扣费——成功那次的评分结果会被记住，后续重试只回放结果。

**Q：评分成功但分数没填进去？**
A：多半是分数框没设对。重新「设分数框」，点的时候**点输入框正中间**，别点到旁边的标签上。
结果卡上会显示「AI 实际收到的那张图」，可以对照看看框的位置对不对。

**Q：AI 说答题区是空的，但明明学生写了字？**
A：框选偏了或框后滚动过页面。裁剪图几乎全白时，工具条会提示「裁剪图几乎空白，建议重框」。

**Q：两个账号会互相看到对方的评分规则吗？**
A：不会。规则、题型、阅卷记录全部按账号隔离。

**Q：怎么退出登录？**
A：网页端在「我的账户」页右上角；插件在弹窗的「退出登录」。两边退出会同步——网页退出了，插件也会自动退出。

---

## 八、联系

遇到问题请提供：浏览器名称与版本、手机还是电脑、截图、以及工具条上的状态文字。