小寻善思 · 管理员操作手册
对标"小维爱学"逻辑的班主任 + 科任教师集成工作台 · 离线可用版
适用对象：班主任 / 科任教师 / 系统管理员
版本 v1.0
数据说明：浏览器本地存储，数据不出本机
本手册与工作台内「管理员手册」页一致。工作台采用本地缓存 + 云端同步双写架构：本机浏览器留存一份缓存（键名 twb_db_v2），同时在云数据库保存一份工作空间副本。加入工作空间后，手机、教室大屏、学生端、其他电脑即可实时共享同一份数据；未加入或断网时，本机仍可离线使用，恢复网络后自动续传。
目录
- 多端云同步（首次必做）
- 首次使用与初始化
- 阅卷批改（双模式）
- 批阅权责与人工复核
- 学生 / 班级错题管理
- 试题中心
- 作业台账与提醒规则
- 班级喊话与课堂工具
- 大屏推送与讲评
- 权限矩阵与数据安全
- 自动化规则与定时任务
- 常见问题与能力边界（含 OCR / OMR）
零、多端云同步（首次必做）
工作台通过「工作空间」实现多端共享。工作空间由同步码唯一标识：同步码 → 派生 space_id → 云数据库中的一份整库文档。凡是输入同一个同步码的设备，读写的都是同一份数据。
0.1 三步完成多端打通
- 在第一台设备创建：打开教师端，页面会弹出「☁ 多端云同步设置」→ 填写同步码（建议「班级英文名 + 年份」，如
class15-2026；也可点「🎲 生成随机码」）→ 点「进入工作空间」。此时本机数据已上传云端，作为该空间的初始副本。
- 在其它设备加入：手机、教室一体机、办公室电脑打开同一链接 → 顶栏点
☁ 仅本机 → 输入同一个同步码 → 点「进入工作空间」。加入后本机数据会被云端副本覆盖（这是刻意设计：多端以云端为准）。
- 让学生扫码进入：教师端「班级与权限 → 邀请学生绑定」里的分享链接，会自动带上
&space=… 云端空间参数。把它生成二维码张贴在教室，学生扫码后只需选自己的学号即可，无需知道同步码。教室大屏同理：顶栏「🖥️ 班级大屏」按钮已自动带上班级与空间参数。
0.2 同步机制
| 环节 | 行为 |
|---|
| 本地写入 | 任何操作（阅卷 / 发作业 / 喊话 / 点名）立即写入本机缓存，界面零延迟。 |
| 云端推送 | 本地写入后 700ms 防抖再打包推送，连续操作只发一次，避免频繁小请求。 |
| 云端拉取 | 已加入的设备每 12 秒轮询一次；发现云端版本更新即自动采用并重渲染。 |
| 冲突取舍 | 整库用逻辑版本号 __rev 做最后写入胜出（LWW）。不依赖设备时钟，因此不同手机时间不准也不会乱序。 |
| 断网 / 离线 | 顶栏显示 ☁ 离线，本机照常使用；网络恢复后下一次轮询自动续传，无需人工干预。 |
课堂场景通常只有一位老师在写（大屏只读、学生只读本人数据），因此 LWW 不会造成实际冲突。若两名教师在同一轮询周期内（12s）同时修改了不同内容，后写入的一方会覆盖前者——需要多人高频协作时，建议分科目各建一个工作空间。
0.3 顶栏状态说明
| 徽标 | 含义 | 处理 |
|---|
☁ 仅本机 | 尚未加入工作空间，数据只在本机 | 点击后进入云同步设置 |
☁ 连接中… | 正在连接云端 | 等待数秒 |
☁ 已同步 | 多端同步正常 | 点击可查看同步码、立即同步、复制邀请链接、退出 |
☁ 离线 | 云端暂不可达，已回落到本地缓存 | 检查网络；恢复后自动续传 |
0.4 安全边界（务必知悉）
- 数据按工作空间隔离，不同同步码之间完全不可见；多班级仍按
classId 隔离，不会串班。
- v1 采用「不可猜测的 space_id + 域名 Origin 校验」作为边界，未引入独立账号登录。因此：同步码等同于钥匙，请勿公开张贴教师端同步码（学生用邀请链接进入即可，不需要同步码）。
- 若需更高安全等级（如一人一账号、操作可追责到人），可在现有基础上叠加账号登录，业务层无需改动。
- 学生端受权限矩阵约束，即使拿到链接也只能看到本人数据，看不到班级统计与他人成绩。
0.4 科目工作空间（避免科任教师互相覆盖）
若多位科任共用同一个工作空间，整库采用「最后写入胜出」，会出现后提交者覆盖先提交者的问题。为此系统提供按科目拆分独立工作空间：
| 角色 | 使用的空间 | 可见范围 | 写入范围 |
|---|
| 班主任 | 主空间（同步码如 class15-2026） | 整库：全班级、全科目 | 整库 + 各科空间的管理（初始化 / 汇总） |
| 科任教师 | 科目空间（class15-2026#物理） | 仅本班本科目（阅卷 / 作业 / 错题 / 本科目消息） | 仅自己的科目空间 |
| 学生 / 家长 | 班级码 + 学号（邀请链接） | 仅本人 | 仅本人答卷上传 |
配置步骤（班主任操作一次即可）
- 左侧「班级与权限 → 多端与科目空间」，确认主空间已接入（顶栏显示 ☁ 已同步）。
- 在「科目工作空间」表格中，对每一科点「📤 初始化」——把本班名册快照写入该科空间。仅在该空间尚不存在时创建，绝不覆盖科任已有数据；重复点击是安全的。
- 点「🔗 邀请链接」复制发给对应科任（形如
index.html?space=sp_xxx&sc=class15-2026%23物理）。
- 科任打开链接 → 自动加入本人科目空间并锁定为科任视角，界面只剩本科目。
- 班主任随时点「🔄 汇总」或「🔄 一键汇总全部科目」，把各科阅卷 / 答卷 / 作业 / 错题 / 消息合并回整库，即可做全班跨科目统计。
合并规则：按「班级 + 科目」整体替换该科数据；消息按 id 合并（同 id 远端优先，本机独有消息保留）。每次汇总会在「操作留痕」中记录科目与条目数。表格中的「云端状态」会显示 未创建 / 已同步 revN / 有更新 revN。
已知边界：同一位科任在两台设备上同时编辑仍遵循最后写入胜出；建议一位科任固定用一台设备录入，其他设备只查看。
一、首次使用与初始化
工作台首次打开会自动载入演示数据（两个班级、若干试卷与答卷、错题、作业、消息、点名记录均为仿真数据，学生一律使用代号 S01…S29，无任何真实姓名）。你可以直接体验全流程，或在需要时清空后导入真实数据。
1.1 核对班级与人员
- 进入左侧「班级与权限 → 班级管理」，确认班级名称、年级、类型、班级码与学生代号的对应关系。
- 切换班级：顶栏左侧「当前班级」下拉，不同班级数据完全隔离，不会串班。
- 新增班级：班级管理中点击「＋ 新增班级」，填写名称 / 年级 / 班级码 / 人数，系统自动生成代号 S01…。
1.2 切换身份预览权限
顶栏右侧「当前身份」可在 班主任 / 科任教师 / 学生 / 家长 间切换，即时预览不同角色看到的工作台范围。这是理解权限隔离最直观的方式。
1.3 导入真实名单（自动代号化）
把学校花名册变成代号名单，只需一次粘贴：
- 「班级与权限 → 班级管理」→ 点「📥 导入 / 更新名单」。
- 粘贴花名册，每行一人。支持
姓名、姓名,性别、姓名,性别,小组、序号 姓名 性别（空格 / 逗号 / 制表符均可）；以 # 开头的行为注释会自动跳过；性别省略时按男女交替填充。
- 也可点「📂 从文件导入（txt / csv）」直接选择名单文件（每行一人，行首学号 / 序号会自动跳过），免去复制粘贴。文件只在你的浏览器内解析，不会上传到服务器。
- 确认解析人数与代号预览（S01…Snn），点「导入并代号化」。
- 系统按名单顺序生成 S01…Snn 代号；人数不变时复用原学生 id，历史答卷与错题不会断链。
隐私设计（关键）：真实姓名只写入本机独立存储键 twb_names_v1，不属于教学数据库、不随云同步上传——其他设备、科任教师、学生端均无法获取。系统内所有展示、大屏、导出材料一律只用代号。
对照表管理：「班级与权限 → 数据与安全 → 姓名 ↔ 代号对照表」可查看（默认打码，点「👁 显示姓名」才展开）、单条删除、⬇ 导出 CSV（离线保管）或🔥 全部清除。导出后的对照表请离线单独保管，不拍照、不外传、不与教学材料同处存放。
隐私红线：系统内置隐私模式（settings.privacyMode=true）。任何对外材料（家长会、班会、大屏、学生端）一律只出现代号，不出现真实姓名。姓名与代号对照表必须离线单独保管，不与教学材料同处存放、不拍照、不上传。
二、阅卷批改（双模式）
工作台支持两种阅卷模式，一次任务只能用一种模式（任务创建后模式锁定，不可混用）：
① 原卷批改模式（paper）
普通打印试卷即可，学生手写作答。系统通过图像预处理（矫正歪斜 / 去阴影 / 降噪 / 裁切）后做手写识别，无需答题卡。适合随堂练习、周清、假期作业等高频轻量场景。
② 专用 OMR 答题卡模式（omr）
使用带定位标记的答题卡，通过填涂区域定位识别，识别稳定性更高。适合月考、期末等正式、大规模考试。
2.1 新建批改任务
- 左侧「阅卷批改 → 新建批改任务」。填写：试卷标题、学科、年级、考试范围、模式（原卷 / OMR）、是否允许学生自主上传。
- 录入题型与采分点：支持 4 类题型——单选题 / 多选题 / 填空题 / 解答小问。解答小问需填写每个采分点（得分 criteria + 分值），这是 AI 预评与教师终审的依据。
- 设定每个知识点的归属（用于错题归集与学情分析）。
2.2 上传答卷（双通道）
- 通道 A · 教师批量上传：教师用手机 / 扫描仪拍下或扫描学生答卷，批量上传。系统对每张图执行统一预处理，原图永远不被覆盖（raw 与 processed 分别保存）。
- 通道 B · 学生自主上传：学生 / 家长端凭班级码 + 学号进入，对自己答卷拍照交卷，同样经过本地预处理。
2.3 提交 AI 批阅
在「批阅台」点击「提交 AI 批阅」：客观题（单选 / 多选 / 填空）由 AI 自动判定；主观题（解答小问）由 AI 给出分步预评分与批注。识别置信度低于阈值（默认 0.72）的题目会被标记，自动进入人工复核清单。
三、批阅权责与人工复核
核心原则：主观题不自动终审。解答小问的 AI 结果只是"预评"，必须教师人工终审确认后才生成学生报告。客观题 AI 自动判定后默认锁定，教师仍可手动改分，所有改动留痕。
3.1 批阅痕迹与留痕
- AI 批注：每个主观题保存 AI 预评的分步结论、得分与提示。
- 教师批注 / 改分：教师每一次改分都记录"由 X 分改为 Y 分、操作人、时间、备注"，永久留存。
- 合成答卷：批阅台可将"原作答 + 批阅痕迹（✓ / △ / ✗ 与得分）"合成一张带痕迹的答卷图，用于讲评与大屏展示。
3.2 人工复核清单
「人工复核」页列出所有低置信识别与待终审主观题。复核时可直接改分、写批注，改完后该份答卷状态转为"已终审"，汇总进学情报告。
3.3 字段说明（批阅台）
| 字段 | 含义 |
|---|
置信度 conf | AI 对该题识别的把握程度；< 0.72 触发人工复核 |
得分率 rate | 该题全班平均得分 / 该题满分 ×100% |
状态 status | created 未批 → review 待复核/待终审 → done 已终审 |
标志 flag | 该题是否异常（识别存疑 / 需复核） |
四、学生 / 班级错题管理
每次阅卷终审后，系统自动把未得满分的题目归集为错题，按学科 / 知识点分类，绑定学生代号与标准答案。
- 错题清单：按学科、按知识点筛选，查看每道错题的题干、标准答案、涉及学生代号、得分率。
- 知识点诊断：按知识点聚合（出现人次 / 涉及学生数 / 平均得分率），一眼定位班级薄弱点。
- 生成巩固卷：选择知识点，一键生成"错题巩固卷"（去重、可打印），用于二次练习。
- 推大屏讲评：选中知识点或整套错题，点击「推送大屏」，教室一体机直接显示题目与典型错误。
五、试题中心
- 试卷翻新：上传带手写笔迹的纸质试卷扫描件，系统通过色度阈值法（印刷体色度≈0、彩色笔迹色度高）清除手写笔迹，得到干净原版，可重新使用。处理前后对比图可保存。
- 校本资源库：收录本校原创 / 改编 / 校际联考试卷与课件，支持检索、打印次数统计、是否校内共享标记。
- 讲评一键推大屏：资源库条目可"推送大屏"，把干净原版试卷投到屏幕讲评。
六、作业台账与提醒规则
- 科任 / 班主任在「作业台账 → 发布作业」填写学科、标题、内容、预计时长、截止时间，可关联某次阅卷任务。
- 作业发布后形成台账，按周视图查看，可追踪每位学生的提交状态（未提交 / 已提交 / 已批阅）。
- 提醒规则（差异化送达）：
- 班主任发布的「班级喊话」：实时推送，立即触达学生 / 家长端。
- 科任教师发布的作业 / 通知 / 喊话：课间推送，按学校「课间时刻表」（周一、周二至周日、每日通用窗口）自动触达，上课期间不打扰学生。
七、班级喊话与课堂工具
7.1 班级喊话（班主任专属）
仅班主任拥有实时喊话权限。喊话实时推送，请遵守班级管理规范：不点名、只谈现象；涉及校园欺凌、自伤自残等风险线索，必须按学校既定流程上报，不得以"保密"为由搁置。
7.2 课堂工具 · 随机点名
- 支持全班或按分组抽取，可设置抽取人数与科目（仅用于记录）。
- 结果可标记"回答正确 / 待跟进"，记录自动留存（时间 / 范围 / 抽中代号 / 科目 / 结果 / 备注），可导出 CSV。
- 点名记录中的学生一律以代号呈现。
八、大屏推送与讲评
「大屏推送」页提供班级大屏只读展示页链接（screen.html?class=班级ID），在教室一体机 / 投影浏览器中打开即可。
- 大屏为只读展示，自动轮播教师推送的内容：错题讲评 / 学情统计 / 试卷讲评 / 班级消息 / 答卷讲评 / 巩固卷 / 点名结果 / 自定义。
- 大屏不显示班级完整成绩明细与真实姓名，只展示教师主动推送的讲评内容。
- 教师可在大屏页「新建推送」编写自定义内容，或在各模块（错题 / 学情 / 试卷 / 消息 / 点名）点击「推送大屏」即时推送；大屏每 4 秒从本地存储同步，新内容会自动出现。
九、权限矩阵与数据安全
四类角色的能力边界（✓ 允许）：
| 能力项 | 班主任 | 科任教师 | 学生 | 家长 |
|---|
| 阅卷 / 批改 / 终审 | ✓ | ✓（本科目） | — | — |
| 作业发布与台账 | ✓ | ✓ | — | — |
| 错题 / 试题中心 | ✓ | ✓（本科目） | — | — |
| 班级喊话（实时） | ✓ | 无 | — | — |
| 发布通知 | ✓ | ✓（课间推送） | — | — |
| 随机点名 | ✓ | ✓ | — | — |
| 全班学情看板 | ✓ | 仅本科目 | — | — |
| 班级码 / 绑定 / 成员管理 | ✓ | — | — | — |
| 自动化规则 / 留痕查看 | ✓ | — | — | — |
| 个人报告 / 错题 / 上传答卷 / 收通知 | — | — | ✓ | ✓ |
隔离双保险：① 多班级按 classId 隔离，切换班级只呈现本班数据；② 科任教师额外按 subject 过滤，只看任教科目；③ 学生 / 家长端接口与页面均不返回班级整体统计，仅本人数据。
十、自动化规则与定时任务
工作台内置本地规则引擎：页面运行期间按分钟轮询，到点即执行并写入消息流（等价于服务端定时任务）。预设规则：
| 规则 | 触发 | 动作 |
|---|
| 每日作业台账汇总提醒 | 每天 17:20 | 汇总当日各科作业并推送 |
| 未提交名单提醒（仅班主任） | 每天 21:10 | 统计未提交名单 |
| 待终审答卷催办 | 每天 19:00 | 提醒教师完成终审 |
| 错题 TOP 知识点周报 | 可改每周五 | 生成巩固建议 |
| 作业台账月度归档 | 每天 22:00 | 归档已结束作业 |
若需要关闭页面也能按时执行，可在 WorkBuddy 中将同一任务登记为「自动化」定时任务（如每天 17:20 汇总作业台账），执行结果会以消息形式回到工作台。两项能力互补，配置保持一一对应即可。
十一、常见问题与能力边界（含 OCR / OMR）
11.1 关于 OCR / OMR 的真实边界
本工作台内置的图像预处理与识别为
前端演示级实现，用于展示完整业务闭环，
不等同于商用 OCR / OMR 引擎的准确率。真实落地时建议按以下边界对接：
- 原卷模式手写识别：适合结构化较好的印刷体题干 + 限定作答区；对连笔、擦改、超出作答框等情况识别率会下降，务必依赖人工复核清单兜底。
- OMR 填涂识别：对规范填涂稳定，但需保证答题卡定位标记清晰、扫描端正；歪斜过大时先用本系统的"矫正歪斜"步骤。
- 生产建议：客观题判定阈值（
autoReviewConf=0.72）可按学段调整；大规模正式考试推荐接入商用识别 API，将识别结果回写 sub.answers 后即可复用本系统的判分、批阅痕迹与学情引擎。
11.2 数据安全与合规
- 成绩、错题明细属学生个人信息，仅限教学用途，不得外传第三方或公开发布。
- 对外材料一律使用代号；大屏默认不展示完整成绩明细。
- 数据存于本机浏览器，建议定期在「班级与权限 → 数据与安全」导出 JSON 备份；离职 / 学年结束时重置班级码与演示数据。
11.3 常见问题（FAQ）
| 问题 | 处理 |
|---|
| 切到另一个班级，为什么看不到数据？ | 正常。数据按班级隔离，需回到原班级；或确认该班级确实有对应阅卷 / 作业。 |
| 科任教师看不到「班级喊话（实时）」入口？ | 正常。科任的喊话为「下课喊话（课间）」，与班主任的实时喊话区分：科任消息在课间窗口自动触达，班主任喊话立即触达。 |
| 主观题分数一直显示 0？ | 主观题未经教师终审不产生最终分，请在批阅台 / 人工复核完成终审。 |
| 学生端能看到别人的成绩吗？ | 不能。学生 / 家长仅可见本人报告与错题，无班级统计。 |
| 大屏没显示新推送？ | 确认大屏页是否已打开；它每 4 秒从本地存储同步，多等几秒即可；也可用大屏右下角按钮手动切换。 |
| 本地存储满了？ | 系统会自动清理答卷图片缓存并提示；也可在数据安全页手动清理。 |
本手册与工作台同步生成。所有模块遵循同一套数据模型与权限矩阵，教师端的每一次操作都会在「操作留痕」中可追溯。如需调整阈值、课间时刻表（breakSchedule）或学科知识点体系（knowledgePoints），均在系统设置与对应模块中配置。