乐于分享
好东西不私藏

教师批改 200 份试卷太崩溃?这个开源工具让 AI 自己点鼠标,置信度够高才敢下分

教师批改 200 份试卷太崩溃?这个开源工具让 AI 自己点鼠标,置信度够高才敢下分

一句话剧透:一个 MIT 开源的"AI 阅卷辅助工具"——用浏览器窗口截图 + 视觉模型评分 + 置信度阈值 + 鼠标坐标点击,把"教师批改机械题"这件事自动做完;并且内置了 Codex Skill,你可以基于这套骨架改成任何"机械点击"场景。


教师批改的痛苦,不在"判断",在"重复"

期末考试结束,200 份试卷摞在桌上,全是同一道机械题 —— 选择题 / 填空题 / 简答题的固定答案,答案位置在卷子上几乎不变,分值按钮就在屏幕右侧那几个固定坐标。

判卷这件事,真正的"判断"只占 5%,剩下 95% 都是机械劳动:截图、看答案、点分数、点下一份、点分数、点下一份…… 一份卷子 30 秒, 200 份就是 100 分钟,3 个小时不抬头,脖子僵硬,眼睛酸胀

更难受的是 —— 教师不是不能判断,是判断太简单了,机器也能做真正该花时间的,是后面那 30 分的论述题、作文、需要看学生思路的主观题。但因为前面 70 分的机械题耗光了精力,到了真正需要耐心的部分反而敷衍了

今天这个开源项目,就是来解决"机械点击 = 浪费生命"这件事的


这个项目,把"截屏 → 评分 → 点击"做成了完整流水线

Liuhe808/local-grading-automation[1] 是个发布 4 天的"AI 阅卷辅助工具"(star 还不算多,目前个位数,但项目结构完整,已经被作者自己用 Codex 在 3 周内迭代到 11 个 commit )。

它的核心思路很直接 —— 用你电脑上的浏览器 + Python + 视觉模型,组成一条事件驱动的批改流水线

1.截屏:在浏览器里打开阅卷系统页面,工具自动捕获当前窗口
2.裁剪:框选学生答案区域(一次框选,后续 200 份卷子复用同一个坐标
3.AI 评分:把裁剪的截图发给视觉模型( OpenAI / DeepSeek / 任意 OpenAI 兼容接口),让模型给出建议分 + 置信度
4.决策:置信度 ≥ 阈值 → 自动点击对应分数按钮;置信度低 → 暂停等你审核 或 自动跳过
5.翻页:等阅卷系统翻到下一份,重复 1-4

整个过程最关键的一条规则写在了 README 里 —— "模型未返回前不会点击。暂停或重新继续后,旧请求即使返回也不会触发点击,避免上一份结果点到下一份。"

这才是真正让老教师敢用的设计 —— 它把"AI 误判"的可能性从机制上掐死了


5 大设计亮点,把"AI 阅卷"做成了工程级方案

我用下来,最让我意外的不是"AI 能不能判分"(这个 GPT-4o / Claude / Qwen-VL 都能做),而是作者把工程细节抠到了极致。我挑 5 个最戳我的点聊聊。

1. 置信度阈值 —— 不是"AI 说了算",是"你说了算"

工具里有三个置信度档位

高置信度:自动点击分数按钮
中等置信度:暂停批改,等教师人工审核
低置信度:自动跳过这道题,留给教师单独处理

这意味着 AI 永远不是"代教师做决定",而是"做确定的部分 + 难的部分留给人"。跟 39 期 Lujie-Careerkit 强调"AI 简历优化不编造经历"是同一种思路 —— AI 工具要守住"不替人拍板"的底线

2. 显式启用 + 127.0.0.1 —— 安全设计到位

工具启动后只在 127.0.0.1 监听( localhost ),不会暴露公网。所有自动化行为需要用户在网页里点"开始批卷"才启动 —— 不会自己偷偷点、不会后台运行

这跟 39 期 Lujie-Careerkit 强调"数据存本地 SQLite"、 37 期 ackem 强调"AI 桌面伴侣本机运行"是同一种"本地优先"的工程哲学 —— 工具的便利不能以"绑架用户"为代价

3. Windows 鼠标接口 —— 绕过浏览器沙箱

工具通过 Python 调用 Windows 的鼠标接口(pyautogui / Windows API )直接在屏幕坐标上点击 —— 不依赖阅卷系统的 API ,不要求系统开放接口,不被浏览器的安全策略拦截

换句话说:只要教师能打开阅卷系统的网页,工具就能配合。这是它适配各种封闭阅卷系统的关键 —— 不需要学校升级系统、不需要 IT 部门配合。

4. Codex Skill 内置 —— 这个项目的"最大彩蛋"

工具目录里直接内置了一个 Codex Skillskill/local-grading-automation),包含 SKILL.md + agents/ + references/ 三个子目录。

你可以用一行 prompt 让 Codex ( OpenAI 的编程助手)理解整个项目的结构,然后基于这套骨架改造成你自己场景的"机械点击工具"

Use $local-grading-automation to adapt this grading assistant to my local grading system. 

Codex 读完 SKILL.md 就知道:项目的事件驱动流程、模型图片输入方式、鼠标坐标点击、常见排查路径 —— 你不用自己啃代码, Codex 替你改

这是 36 期小狐 IP 工作室、 34 期公考花生十三 skill 的同一种设计哲学Skill 不只是"说明书",是 Agent 友好的"骨架包"。你拿过去改一改,就能套到完全不同的场景。

Skill 这件事多说一句:如果你对"给 Agent 用的 skill"不太熟,可以把它理解成"给 AI 助手的工作交接文档" —— 不是给人类看的教程,是让 AI 读完就知道怎么帮你干活的清单。 36 期小狐 IP 、 34 期花生十三、 41 期 local-grading-automation 都是这种思路。

5. 边界写得很清楚 —— 哪些能做、哪些坚决不做

README 里专门列了"不适合"的场景

❌ 需要绕过登录、验证码、风控
❌ 需要静默读取第三方系统数据
❌ 答案区域、分数按钮位置频繁变化
❌ 未获授权就处理含身份信息的学生材料

作者把"工具的边界"写得比"工具的能力"还详细 —— 这说明他很清楚自己做了什么、没做什么。这种"我懂我的局限"的作者,用起来比"什么都能做"的工具放心 100 倍


这个项目适合谁?—— 别只看"教师阅卷"

项目名字叫 "local-grading-automation",但它的骨架是通用的"机械点击 + 视觉判断"工具。基于它的 Codex Skill ,你可以改出无数种本地自动化工具:

教师批改机械题(项目本身场景)
客服批量回复模板消息(固定选项 + 视觉判断)
运营批量处理后台表单(固定按钮位置 + 自动填写)
财务批量核对发票(视觉 OCR + 固定提交按钮)
测试工程师批量点 UI(视觉判断 + 坐标点击)
审稿人批量处理投稿系统(固定评分 + 自动跳转)

只要你的工作里有"看屏幕 → 简单判断 → 点固定按钮"这种循环,这套骨架都改得出来

这就是 Skill 形态项目最值钱的点:它不只是"一个工具",是"一类工具的种子"


部署 / 使用的 2 种方式

方式 1 :直接当工具用(普通教师)

需要 Windows + Node.js 20+ + Python 3.10+:

git clone https://github.com/Liuhe808/local-grading-automationcd local-grading-automationCopy-Item.env.example.envscripts\start-local-tool.cmd

打开浏览器访问 http://127.0.0.1:5175,在网页里: 1. 填题号、满分、标准答案、给分规则 2. 点"开始捕获"框选学生答案区域 3. 记录各分值按钮坐标 4. 设置置信度阈值(达到 → 自动 / 不到 → 暂停或跳过) 5. 点"开始批卷"

整个流程从配置到第一次跑通,预计 15-30 分钟

方式 2 :基于 Skill 改造( Codex 用户)

把仓库 clone 下来之后,在 Codex 里说一句话

Use $local-grading-automation to adapt this grading assistant to my local grading system. 

Codex 会读完 SKILL.md ,告诉你这个项目怎么拆、怎么改、哪些文件管哪件事

如果你不知道 Codex 是什么 —— 可以把它当成"一个会读代码的 AI 编程助手"(跟 GitHub Copilot Cursor 是同类产品)。它能读懂项目结构、帮你改代码、回答"这个项目怎么用"。


架构拆解 —— 为什么这个项目能"跑得起来"

整个项目分 5 层

层级
角色
技术栈
1. 浏览器层
打开阅卷系统页面
Chrome / Edge
2. Web UI 层
用户操作界面
Node.js + 前端
3. Server 层
状态机 + 调度中心
Node.js Server
4. Grading API 层
截图 + 调用视觉模型
Python + FastAPI
5. 外部依赖
视觉模型 + 图床 + 鼠标
OpenAI 兼容 API / ImgBB / Windows API

关键点:所有数据流都在本机 —— 截图从浏览器捕获 → 发给本机 Python API → 转发给视觉模型(可选本地 Ollama / LM Studio ) → 返回结果 → Node Server 决策 → 调 Windows 鼠标点击。不依赖云端调度, 不经过任何第三方服务器

这条路跟 37 期 ackem (本地 AI 桌面伴侣)、 39 期 Lujie-Careerkit (本地 SQLite 求职工作台)是同一种"本地优先"路线 —— 数据不出本机,工具不绑架用户


几个必须告诉你的"诚实点"

跟每期一样,这个项目也有些点必须告诉你

1. star 数还不多(目前个位数)。 项目发布 4 天,作者迭代了 11 个 commit ,但主动 star 的人还很少。这意味着:项目本身质量不差( Codex Skill + 完整架构 + 文档专业),但目前还是"作者自用"的阶段大规模实战验证还不够。如果你是教师,建议先小范围试用 10-20 份卷子再大规模用。

2. 仅 Windows 支持, Mac / Linux 待补。 README 里作者明确说"Windows 优先",Mac / Linux 的鼠标接口实现还在规划中。 Mac 用户暂时用不了 —— 这点跟 37 期 ackem (也只支持 Windows )一样。

3. 依赖视觉模型 = 有 API 成本。 调用 GPT-4o / Claude / Qwen-VL 判分,每次调用都要花钱。如果一次批 200 份,预计 5-15 元人民币的 API 费用(取决于模型选择和图片大小)。如果想 0 成本,可以用本地 Ollama 跑 Qwen2-VL / InternVL —— 速度慢一些但完全免费。

4. 框架的"置信度"依赖视觉模型的自评。 不同模型给的"置信度分数"含义不一样 —— GPT-4o 的 0.8 和 Qwen-VL 的 0.8 含义可能完全不同。建议先用 5-10 份卷子校准一下阈值,别一上来就信默认值。

5. 框架默认"信任教师框选的坐标",坐标错了一切错。 如果你框选答案区域时手抖了一下,所有 200 份卷子都会按错位置评分。所以第一次一定要先跑 1 份卷子 验证框选是否正确,再开始批量

6. 框架需要阅卷系统在浏览器里打开。 如果你们学校用的是专用客户端软件(不是 Web ),这个工具暂时帮不上忙。这也是它"自动化"的前提 —— Web 化阅卷。


这个项目适合谁?

K12 / 大学教师 / 培训机构老师 —— 批改机械题节省 3 小时/次
Codex / Cursor / Claude Code 用户 —— 想基于 Skill 改造自己场景的
对"本地优先 AI 工具"感兴趣的开发者 —— 学习"事件驱动 + 视觉模型 + 鼠标自动化"的工程实现
学校 IT 部门 —— 想给学校定制化阅卷系统但没有足够预算的

写在最后

2026 年最让我感慨的一个趋势是:开源工具开始认真对待"AI 的边界"了

早期 AI 工具是"我什么都能做,你信我就行"。现在这一波新工具 —— 37 期 ackem (本地 AI 桌面伴侣)、 39 期 Lujie-Careerkit (本地 AI 求职工作台)、 41 期 local-grading-automation (本地 AI 阅卷辅助) —— 都在说同一件事:

"AI 不是替人拍板,是帮人把确定的事做完 + 把难的事留给人。"

这种"工具 + 边界"的设计哲学,比单纯的"AI 能不能做"更值得讨论。一个知道"自己不能做什么"的工具,比一个声称"什么都能做"的工具可靠 100 倍

local-grading-automation 这个项目可能不会像 ackem 那样爆火(教师群体本身就小众 + Windows 限制 + 视觉模型成本),但它代表的方向 ——"Skill 形态 + 本地优先 + 边界清晰" —— 是接下来一年 AI 工具的主旋律

如果你也是教师、或者身边有当老师的朋友,强烈建议把这个工具转给他/她 —— 哪怕用不上,看看这个"AI 工具该怎么设计"也是好的

咱们下期见。


💡 温馨说明: 本文内容由「青城源码」团队结合 AI 辅助创作与人工校对整理而成。文中涉及的开源项目均可在 GitHub 公开访问,所有数据均来自项目公开仓库的真实信息。文章仅作项目介绍与个人体验分享,不构成任何 AI 工具选型或教学评估建议。开源项目请遵循其原始协议使用( MIT )。

项目链接:GitHub - Liuhe808/local-grading-automation[2] 工具类别:本地 AI 阅卷辅助 + Codex Skill License : MIT