选择采集源
把登记表四个角的定位块拍进画面、纸面尽量占满取景框；可连续多次「拍照并识别」，每张都会进入下方复核列表。
画面若是「人正常、背景变成绿色 / 虚化」，那是 macOS 的「视频效果（人像 · 背景替换）」在起作用，
不是本系统的功能。它会抠掉纸面边缘、影响识别，请点菜单栏右上角的
控制中心 →「视频效果」，把「背景」和「人像」关掉再拍。
点击选择照片，或把照片拖到这里
支持多张连选 · 识别在浏览器本地完成，照片不外传
支持多张连选 · 识别在浏览器本地完成，照片不外传
识别结果复核（确认无误后入库）
入库后自动保存原图到「扫描图片」，并写入台账
扫描图片归档
未连接 · 连接后识别的原图将按「扫描日期」自动建文件夹保存
快速登记
—
输学号 → 自动带出姓名 → 点类型 / 类别 / 分值 → 回车保存。保存后自动清空学号，可以连续录下一位。
记录人自动取当前登录账号；与已有记录重复（同日同生同项同分）会自动跳过。类别分值来自「管理 → ② 登记表设计」。
登记台账
至
快捷
操作日志
谁在什么时候入库 / 改 / 删了哪些记录。日志随台账一起存在本机（换电脑不带走），
只用于"这件事是谁干的、什么时候干的"这类追溯，不会因为清日志而影响台账本身。
学生汇总（按人累计）
至
快捷
趋势与分布（跟随上方筛选）
柱形：最近 8 周每周的加分 / 扣分合计，按周一为一周之界；饼图：当前筛选内记录数最多的类别 Top6（悬停扇区看条数与占比）。
跟随上方「班级 / 类型 / 日期范围」筛选，点「统计」即刷新。评比材料可直接截图使用。
德育数据大屏
类型构成
类别 Top6
最近 8 周趋势
班级评比 · 人均扣分
最新录入
答题卡生成
A4 纵向：四角定位块 + 6 位学号填涂区 + 客观题填涂区。打印后发给学生涂填，再拍照上传识别判分。
扫描识别与判分
逐题分析
学校信息 · 印在登记表抬头的校名与校徽
这里改的是登记表最上面那几行：校徽、学校名称、副标题。 改完立刻生效 —— 打印预览、导出的表格抬头都会跟着变；连了学校服务器的话会自动同步到其他电脑， 不用每台机再设一遍。
① 学校名称
学校名称印在每联正上方（字号最大），副标题印在它下面一行；某一项留空就少印那一行。
② 校徽 Logo
建议用正方形 PNG（透明底更好看），最小边 200px 以上；系统会等比缩放贴在每联左上角。
上传的图片会自动压到 400KB 以内，太大的会自动缩。
⚠️ 手机直接拍的照片若是 HEIC 格式，浏览器认不出来，请先在相册里导出成 PNG / JPG 再上传。
⚠️ 手机直接拍的照片若是 HEIC 格式，浏览器认不出来，请先在相册里导出成 PNG / JPG 再上传。
③ 抬头预览
这是每联顶部实际印出来的样子（已按 A4 单联宽度等比换算）。屏幕字体和打印字体略有差别，
最终效果以「③ 打印 / PDF」里的整页预览为准。
④ 统计口径（学期与预警）
AI 配置 · 给期末评语生成配一个大模型
选一种模式、填好参数、点保存，之后只要进入「期末评语生成」就能直接用它起草。 存到服务端而不是只存本机，办公室这台和家里那台用的是同一套设置。
AI 模式
API Key
API Key
Key 保存在本机浏览器 + 服务端，不进日志、不显示在导出里。公用电脑请填完用完清掉。
模型
模型
服务地址
地址
本机跑就填
http://localhost:11434（要用 OLLAMA_ORIGINS=* ollama serve 启动，
否则网页会被跨域拦掉）；校内另一台机器就填它的 http://192.168.x.x:11434。
模型
模型
生成设置
手写事由识别（选配）
视觉模型
德育登记表打印生成器 · 类型/类别/分值全自定义 · PDF 导出 · 修改即更新
类型固定三种（违纪 / 表扬 / 警告）；二级类别可任意增删改名，分值档位可任意增删改值。
版式坐标由本页按项目数量自动计算，识别引擎读取导出的 form_layout.json 判读 ——
改完设计请务必点「导出识别配置」，把 json 放到识别引擎目录（后端 backend/ocr/），否则引擎仍按旧版式判读。
学校名称、副标题、校徽已挪到 「① 学校信息」单独一页维护，本页只管表格本身。
① 基础设置
② 分值档位与填涂框
分值档位
学生涂哪格记哪个分，支持小数；最多 6 档（再多格子会挤）
③ 二级类别
二级类别
每类 2–6 项，可改名 / 增删；建议末项放「其他」
类别按位置编码（V01… / P01… / W01…），改名不影响识别，增删会改变编码，需重新导出配置。
使用须知
1. A4 打印选「实际大小 / 100%」，不要「适应页面」；打印后沿虚线裁开，四角定位块不能被裁掉。
2. 学生用 2B 铅笔涂满数字框与选项框，每组只涂一格；类型、分值、类别各涂一个。
3. 高拍仪整页拍摄一次识别 4 联；单张拍摄也能识别（引擎自动数联）。
1. A4 打印选「实际大小 / 100%」，不要「适应页面」；打印后沿虚线裁开，四角定位块不能被裁掉。
2. 学生用 2B 铅笔涂满数字框与选项框，每组只涂一格；类型、分值、类别各涂一个。
3. 高拍仪整页拍摄一次识别 4 联；单张拍摄也能识别（引擎自动数联）。
改完设计后，切到「③ 打印 / PDF」查看整页预览并打印；识别版式会自动同步，无需再导出配置。
打印与导出
③ 输出
按名册批量生成「预印学号」登记表
从学生名册读取该班全部学生，每人一联、学号 6 位已预先涂黑，一页 4 联；打印后沿虚线裁剪分发，
学生只需涂类型 / 分值 / 类别。生成前先在「④ 学生名册」把名单和班级号维护好；新版式改过后重新生成即可。
批量导入学生名单
支持 .xlsx / .csv；表头含「学号 / 姓名 / 班级」即可自动识别列，模板可先下载填写
勾选可批量操作；停用后扫描/快速登记不再匹配该生，随时可启用
数据备份与还原
备份为一个 .zip（manifest.json + scans/ 原图），可在另一台机器上还原
只回滚名册 / 台账 / 扫描件；账号、密码、登录状态不会被回滚。回滚前会自动给现在的数据留一份快照。
设备访问码（一般不用管）
内容取自文件
德育登记系统/data/token.txt（没有这个文件就是没开）
日常登录用账号 + 密码（在右边「⑥ 用户管理」里分配，服务端统一保存）。
这里的「设备访问码」是给没登录页的老设备 / 脚本用的备用通道，填对了等价于超级管理员，
平时不用填。删数据 / 清名单 / 还原备份的权限由登录账号的角色决定，在「⑥ 用户管理」里分配。
当前数据概况
在学校电脑上改好标题、类别、Logo 后，会自动上存到服务器；其他电脑打开即同步。
用户管理
用户存在本机浏览器；连到学校服务器后由管理员统一维护。
四档角色：普通用户只有「扫描识别」；一级管理员能看台账 / 汇总、维护名册、批量打印；超级管理员另有学校信息、登记表设计、备份与数据、清空 / 还原，以及本页的账号与角色维护。
查看人只能看数据不能录入。
✕
编辑台账记录
✕
致家长通知文案
复制后粘贴到微信 / 钉钉即可发送；文案可先修改再复制。累计分按「本学期」统计口径计算。
✕
导入历史台账
表头含「日期 / 学号 / 分值」即可自动识别（支持 日期、学号、姓名、班级、类型、类别、分值、事由、登记人 列，顺序不限）；日期支持 2026/10/1、2026-10-01 和 Excel 日期格式；类型写 违纪 / 表扬 / 警告；类别按名称自动匹配当前类别表，匹配不上的行会标出并跳过。
导入按学号入账，姓名/班级优先用名册带出；同名同日同项视为重复会自动去重。
✕
台账回收站
在台账里点「删除」的记录会先进这里，不是直接抹掉 —— 删错了在这儿点还原就捞回来了。
这里看的是服务器上的回收站，所以单机用法（双击打开本地文件）没有这一栏，台账记录本身照常使用。
「彻底删除」是有去无回，只给超级管理员。
✕
期末评语生成（本学期口径）
按台账记录自动起草，可直接复制；建议发送前再人工润色一遍
文明班级评比榜
✕![]()