AI 一卷通
返回首页 手机传照片
学习指南 使用说明
开启探索

欢迎你，一卷通的新同学

这是围绕你这个项目写的帮助文档。结构借鉴开智文档站，但内容只讲 一卷通：怎么启动、怎么创卷、怎么扫描、怎么分析、怎么订正。

版本 v5.14.2 · 首页左下“使用说明”已改为直达本页
AI 一卷通 › 真实界面预览
一卷通桌面端真实界面截图
一卷通手机传照片真实界面截图
左边是老师电脑端真实界面，右边是手机传照片页真实界面。现在首屏不再是模拟卡片，而是项目当前可运行页面的真实截图。

一卷通是什么？

它是一个给老师用的拍照自动判卷工具。老师拍答题卡照片后，系统会先识别姓名、班级和答案，再自动判分，最后生成可复核的成绩记录。

  • 适合：课堂默写、填空题、小测、讲评前快速出结果。
  • 重点不是“替老师决定”，而是“把重复劳动先做掉”。
  • 老师始终保留最后裁定权，尤其是材料题和异常识别结果。

手机也能传照片

不一定非要把照片先导到电脑。手机和电脑在同一 WiFi 下时，可以直接用手机打开上传页，拍一张传一张，电脑端自动导入。

同一 WiFi
手机和电脑连同一个校园网或路由器，才可以互相传。
打开手机页
手机浏览器访问 `http://电脑IP:3456/mobile.html`。
电脑端自动导入
拍照后照片先进入服务器待处理区，再进入扫描批改主流程。

快速导航

1
解析试卷
导入试卷，解析题目结构，设置答案。
2
生成文档
生成背诵版、默写版、试卷或答题纸。
3
扫描批改
选择试卷和班级，上传答题卡照片，AI 自动判分。
4
成绩分析
点试卷卡片查看成绩报告，含排名、矩阵、讲评三种分析视图。
5
错题订正
按学生汇总错题，一键打印订正卷。
6
常见问题
启动失败、导入失败、看不到学生，都可以从这里快速排查。

解析试卷

点“输入试卷”后，现在仍是“两步走”，但第一步先选资料关系，再选输入方式。

  1. 输入页：先选资料关系（只有题目 / 题目和答案在一起 / 题目和答案分开），再上传文档（当前支持 `.docx`）或直接粘贴文本。
  2. 解析结果页：改成左右双栏工作台——左边看卷，右边设答案。
解析结果页现在怎么用？

左边是试卷区：试卷标题直接并入左侧顶部，并居中显示。下面按大题连续展示整张卷子，不再用顶部 tab 切换。单选题不再做小卡片墙，而是更像真实试卷正文那样逐题顺排；默认无边框，鼠标移到当前题时才出现蓝色方框，右上外挂编辑/上移/下移/删除工具条。

右边是答案设置区：单选题继续收成更接近 e 卷通的三列表格，只保留“小题号 / 分值 / 答案”；答案列用输入框，不再重复显示题目内容。材料题右边只保留答案区，单问直接“第X题 + 答案框 + 分值”，多问才显示小问标签。

批量设置：右侧单选题标题行保留“批量设置答案”按钮；表格上方保留“从 X 到 X 题，X 分/题”的批量分值工具条，材料题区也有同样句式的分值工具条。

这一步为什么重要？

Word 导入后，系统会自动保存 stem、stemWithAnswer、sectionTitles。如果题目里带图片，也会把图片提取到 ~/一卷通数据/images/，并在题干里保留图片位置。后面的试卷 Word、错题订正卷 Word 会继续使用这些数据。

生成文档

在试卷列表右侧点“生成文档 ▾”。不同试卷类型，可生成的文档不一样。

试卷类型 可生成文档
纯填空题试卷 背诵版（含答案）/ 默写版（挖空）/ 答题纸（扫描用）
混合题型试卷 试卷 / 答题纸

生成后的 PDF 默认保存到 ~/Desktop/。

扫描批改

这是最常用的页面。顺序不要乱：先选试卷，再选班级，再上传照片。

  1. 选择试卷
  2. 选择班级
  3. 选择答题卡来源：一卷通答题纸 / 外部标准答题卡
  4. 外部标准答题卡可选择“每人2面”，按正反面成组识别
  5. 上传答题卡照片
  6. 开始识别与判分
  • 外部考试：选择“外部标准答题卡”，按真实涂卡方框和作答区识别，不套用一卷通答题纸布局。
  • 正式考试 A3 正反面答题卡：按“学生A正面、学生A反面、学生B正面、学生B反面”上传，系统先两张一组预检。
  • 没有空白原卷也没关系：选一张拍得最完整、最清楚的学生答题卡，先作为本场考试的样本试扫和核对。
  • 外部答题卡拍照时，不要只拍选择题局部；每页尽量整页拍进去，四角或边缘的黑色定位块、页面边框、页码位置都尽量保留。
  • 手机宁可离远一点拍全，再让系统裁切；边缘被切掉后，系统很难判断题区真实位置。
  • 正式批量扫描前，先扫 1 张最清楚的学生卡，马上核对选择题。如果选择题顺序或分数不对，先调规则再批量扫。
  • 按学生核对：中间看完整答题卡，题块右上角用红色显示本块批改分，如 +15。
  • 按题核对切片：左侧选题目，中间直接铺全班该题切片；点击学生切片会居中放大，其他切片压暗。
  • 新扫描的外部答题卡会尽量自动按正向展示；旧数据如果没有方向信息，仍可手动旋转。
  • 选择题/判断题：代码精确匹配
  • 填空题：5 层判断（精确 → 同义词 → 易混淆 → 去虚词 → AI 兜底）
  • 材料题：AI 给分，老师还能人工调整
外部考试拍照要点

黑色长方形定位块和页面边框相当于坐标参照，拍进去更有利于判断旋转、倾斜、裁切和选择题位置。当前系统会利用外部答题卡的印刷版式做定位与校准；遇到新的外部考试，最稳的做法是先用一张清楚学生卷试扫，确认选择题再批量处理。

手机传照片

手机和电脑在同一 WiFi 下时，手机浏览器访问下面这个地址：

http://电脑IP:3456/mobile.html

成绩分析

扫描结束后，就到这里看结果。重点不是“有没有分”，而是“哪里最容易错”。

  • 试卷列表：所有已扫描试卷以卡片展示，点"报告"进入详情。
  • 试卷报告：6个统计卡片 + 左右分栏三模式（成绩排名/答题矩阵/错题讲评），可切班级、导出Excel、打印。
  • 学生分析：在成绩排名里点学生名，看个人趋势和题型得分率。

错题订正

错题订正页现在是三段式工作流：首页入口 → 班级详情 → 学生详情。

  • 首页入口：顶部切换“按班级 / 常用学生”，右侧搜索框可直接搜学生姓名。
  • 按班级：每个班一张卡片，显示学生数、试卷数、整体错误率和 Top3 高错题摘要。
  • 班级详情：按错误率分成“必须重讲 / 快速点拨 / 个别辅导”三档，并支持最近 1/3/5 份试卷范围切换。
  • 学生详情：按试卷分组显示错题，支持最近 1/3/5 次或全部范围筛选。

可直接打印“错题订正卷”：前半部分是题目，后半部分是参考答案。学生可以先做，再翻页核对。

系统设置

设置入口就在左下角“小曹”菜单里。

  • 个人信息：改用户名、改头像。
  • 测试连接：看云端扫描与本地 Ollama 文本链路是否正常。
  • 数据备份：导出 / 导入备份。
  • 抽背记录：导入 JSON，按日期查看。

数据存储

运行数据都保存在 ~/一卷通数据/。你平时最常碰到的是这些目录：

  • papers/：试卷模板
  • records/：成绩记录
  • students/：班级名单
  • photos/：手机上传照片（临时）
  • evidence/：答题卡证据图
  • backups/：自动备份

常见问题

Q：双击启动脚本没反应？
右键 启动服务.command → 打开方式 → 终端。

Q：浏览器打不开？
先确认启动服务后的终端窗口还开着。终端一关，服务就停了。

Q：Word 导入失败？
确认文件是 .docx，不是 .doc。

Q：错题订正为什么看不到学生？
必须先有扫描后的成绩记录。

Q：数据会不会丢？
系统会自动备份。建议定期把 ~/一卷通数据/ 整个复制到 iCloud 或移动硬盘。

推荐顺序

如果你是第一次上手，别贪多，按下面这个顺序最稳：

  1. 先建一张试卷
  2. 生成一份答题纸
  3. 扫 1-2 张照片试跑
  4. 去成绩分析看结果
  5. 最后再去错题订正打印订正卷