v1.1.2

班主任平台 v1.1.2 —— 集中修复 AI 批改「长时间不出结果」与「批量停不下来」两个突出问题。

本版不含新数据库字段，升级只需替换代码后重启。核心是解决推理型模型在批改时陷入超长思考、页面长时间转圈却迟迟不返回结果的问题，并让批量批改可以一键整体停止。

本版修复

• AI 批改长时间无输出（重点修复）：此前「跟随模型」档等于完全不下发思考控制参数，推理型模型（含部分商用 flash 模型）会持续思考数分钟甚至更久而始终不输出答案，页面表现为一直转圈、既不报错也不出结果。实测同一张试卷、同一模型：不干预时 6 分钟写了约 5.6 万字思考、正文 0 字；改用「关闭思考」后 44 秒即产出完整结果。本版让「关闭思考」真正覆盖更多服务端：
  • 同时下发多套厂商命名开关，覆盖 Qwen / 通义系、OpenAI / Gemini 兼容层、Claude 系等服务端
  • 若服务端不认识其中某个扩展参数而拒绝，会自动去掉扩展字段重发一次，不会因此让整单批改失败（模型名写错这类与参数无关的报错不会白白重发）
• 「限制思考」档不再必然失败：此前该档在思考超限中止后会直接判定任务失败——因为中止时思考中还没有可提取的完整答案，而放宽重试的条件又不满足，等于设了上限反而比不设更容易失败。现在中止后会自动改用「关闭思考」重试一次，不让老师白等一场
• 批量批改可以整体停止：批改任务是排队串行执行的（停掉当前这个，排在后面的会立刻接上开跑），因此逐个停止在批量场景下等于停不下来。现在批量进度面板新增「停止全部（N）」按钮，一次停掉正在批改的和排队等待的全部任务；停止前会提示「本次结果作废、不写入成绩，试卷图片仍保留、可随时重新发起」。单条任务原有的停止入口（任务列表里的「停止」、批改详情里的「停止批改」）保持不变
• 大图不再原样发给模型：图片压缩此前只判断体积，凡小于阈值的图片一律跳过压缩，导致「体积不大、但长边严重超标」的试卷照片（如 4000×1846、约 2.5MB）原样发给模型，视觉处理量约为压缩后的 3 倍，明显拖长等待时间。现在统一按最长边判断，长边超标即等比缩放

本版改进

• 新建模型配置的默认思考模式改为「关闭思考」：实测推理型模型在「跟随模型」下普遍会陷入长思考，而绝大多数使用者不会主动调整这一项，因此把默认值改为更稳妥的一档。已有的模型配置不受影响，仍是原来的设置
• 思考模式的界面说明更明确：「跟随模型」下明确提示「此模式下思考上限不生效」，避免误以为填了上限就已生效；「关闭思考」「限制思考」的说明同步更新为当前实际行为

下载说明

文件	用途
teacher-ops-1.1.2-*.zip	Windows 用户下载这个（Win10 1803+ / Win11，解压后双击 install.bat → start.bat）
teacher-ops-1.1.2-*.tar.gz	Linux / macOS / Docker 部署
*.sha256	完整性校验，shasum -a 256 -c <文件名>.sha256

便携包已内置前端构建产物，不含 node_modules，首次启动自动安装依赖。

Docker / GHCR 镜像

docker pull ghcr.io/kyhx1984/teacher-works:v1.1.2
# 或跟随最新：docker pull ghcr.io/kyhx1984/teacher-works:latest

快速开始

Windows：解压 zip → 双击 install.bat → 双击 start.bat → 访问 http://localhost:3000（admin / admin123）

Linux / macOS：tar -xzf *.tar.gz && cd teacher-ops && ./start.sh

Docker：解压后执行 ./deploy.sh，或改用上面的 GHCR 镜像

升级与兼容性

• 无需数据迁移：本版不含数据库结构变更，升级只需替换代码后重启：
  • Docker：解压新代码覆盖 → docker compose restart
  • 源码：解压覆盖 → ./stop.sh && ./start.sh
• 已有配置零影响：既有的模型供应商配置（含思考模式、思考上限、提示词）完全保持原样；本版只改了「新建配置」的默认值
• 建议升级后做的事：把仍在用「跟随模型」的推理型模型改为「关闭思考」，可显著缩短等待时间；若某个模型确实需要保留推理过程，可继续用「跟随模型」，但请留意思考上限在该档下不生效
• 升级前已有的批改任务与考试记录完整保留
• 三种既有部署方式（源码 / Docker / Windows 批处理）均不受影响
• AI 批改仍为可选功能，默认不启用，未配置模型则完全不影响原有班级事务管理

完整变更见 v1.1.1...v1.1.2 提交对比。

v1.1.1

班主任平台 v1.1.1 —— AI 试卷批改的使用体验与健壮性集中增强。

在 v1.1.0 引入「AI 试卷批改」的基础上，本版围绕老师的实际批改流程做了系统增强：从整卷批量发起、录入参考答案，到批改过程中的进度可见与随时中止，再到批改后的复核依据（每题自评把握度）、原图对照与人工修正。数据库变更全部为启动时幂等自动补列，升级无需手工迁移。

本版新增

• 批量批改整卷：为一份试卷下所有已上传照片的学生一次性发起批改。发起前预检并列出「无照片」学生（可跳过、日后单独处理），已在批改的学生自动跳过，重复点击不会产生重复任务。整卷进度一屏可见，完成后仍走逐个查看 / 编辑 / 采纳的原有流程
• 参考答案录入（支持三种方式）：可为试卷录入参考答案——直接粘贴文本、上传答案文件（.txt / .md / .csv）或上传答案图片。一次录入、多次批改复用，且不随批改任务删除而丢失。有答案时 AI 以答案为准判分；未录入则完全保持原有行为，零回归
• 每题 AI 自评把握度：AI 为每道题给出 0~100 的把握度，逐题以「高（≥80）/ 中（≥60）/ 低（<60）」标签标注（悬停可看具体百分比与含义），并在批改详情顶部汇总「平均把握度、已给出把握度的题目数、把握较低的题数与题号」，帮助老师把复核精力优先放在最可能需要人工确认的题目上。界面上同时明确提示「这是模型自评，不代表判分一定准确」。导出的 Excel 同步增加「AI把握度」列与概览行
• 批改进度可观测 + 一键停止：批改过程中除「已生成 N 字」外，新增「距上次输出秒数」「本周期新增字数」与「疑似重复输出」提示——用于区分「慢但在正常生成」与「疑似陷入循环」；同时常驻显示两道自动守护线（连续无输出 5 分钟 / 累计 45 分钟自动终止）。任一阶段都可点「停止批改」立即中止（排队中的任务同样可停），已停止的任务标记为「已停止」而非「失败」
• 图片压缩参数可配置：上传图片的最长边、体积阈值、JPEG 质量可在「AI 模型配置」中调整，按学校网络与模型能力自行权衡清晰度与上传耗时
• 分值按大题分层展示：批改详情与编辑界面按大题分组，组头显示该大题满分与得分小计；当模型标注的大题满分与各小题合计不符时给出醒目提醒，便于快速定位分值识别问题
• 批改详情原图常驻：批改详情中原始试卷图片常驻可查，多图时通过缩略图切换，核对逐题判分时不必反复关闭弹窗

本版改进

• 默认提示词增强：教师定位由「小学」改为「各学段、各科目」；新增「看图题与图形题识别」要求——图文结合判分、把图中关键条件写入题目描述、识别学生直接在图上作答的情况，并明确要求图意不清时不臆造数据
• 判分结果收敛：总分 / 满分与逐题合计不一致时以逐题合计为准；分数越界自动收敛；判定与分值自相矛盾时按分值纠正，减少明显不合理的结果
• 截断兜底：平台限制输出长度导致答案被截断时，自动放宽上限重试；中断时保留已收到的内容，必要时从模型的思考过程中打捞答案，尽量避免整单批改作废
• 思考模式三态：可选「跟随模型 / 限制思考 / 关闭思考」，并可按需设置思考字数上限（0 表示不限制），避免长思考模型因额度不足而答不完；对推理型模型另有「思考失控」提前中止与早停打捞兜底
• 并发与重复保护：批改任务排队执行（本地单模型默认串行，商用 API 可调并发）；对同一学生重复发起时复用已有任务，不重复消耗算力
• 人工修正与长期留存：支持批改后手工修改判分与评语，人工结果最终生效并覆盖 AI 结果；逐题明细随采纳一并写入考试记录，即便日后清理批改任务，仍可在成绩档案中回看与导出

本版修复

• 删除仍在生成中的批改任务时，现在会一并中止，不再让进程继续等待模型空耗资源
• .gitignore 改为模板 .gitignore.example，便于各部署环境自行维护，不再强制覆盖使用方配置

下载说明

文件	用途
teacher-ops-1.1.1-*.zip	Windows 用户下载这个（Win10 1803+ / Win11，解压后双击 install.bat → start.bat）
teacher-ops-1.1.1-*.tar.gz	Linux / macOS / Docker 部署
*.sha256	完整性校验，shasum -a 256 -c <文件名>.sha256

便携包已内置前端构建产物，不含 node_modules，首次启动自动安装依赖。

Docker / GHCR 镜像

docker pull ghcr.io/kyhx1984/teacher-works:v1.1.1
# 或跟随最新：docker pull ghcr.io/kyhx1984/teacher-works:latest

快速开始

Windows：解压 zip → 双击 install.bat → 双击 start.bat → 访问 http://localhost:3000（admin / admin123）

Linux / macOS：tar -xzf *.tar.gz && cd teacher-ops && ./start.sh

Docker：解压后执行 ./deploy.sh，或改用上面的 GHCR 镜像

升级与兼容性

• 无需数据迁移：本版新增的两个数据库列（exams.answer_ref、exam_records.detail）均在启动时幂等自动补齐，升级只需替换代码后重启：
  • Docker：解压新代码覆盖 → docker compose restart
  • 源码：解压覆盖 → ./stop.sh && ./start.sh
• 升级前已有的批改任务与考试记录完整保留；老任务缺少本版新增字段（如把握度）时界面自动降级不显示，不影响使用
• 三种既有部署方式（源码 / Docker / Windows 批处理）均不受影响
• AI 批改仍为可选功能，默认不启用，未配置模型则完全不影响原有班级事务管理

完整变更见 v1.1.0...v1.1.1 提交对比。

v1.1.0

班主任平台 v1.1.0 —— 全新「AI 试卷批改（多模态）」正式发布。

在 v1.0.x 稳定的班级事务管理基础上，本版新增 AI 试卷批改能力：老师上传试卷图片，AI 自动逐题批改、给分并生成总评，可一键采纳录入成绩。功能默认不启用，需在设置中开启并配置模型供应商，对既有功能与数据库结构零影响。

本版新增

• AI 试卷批改（多模态）：上传试卷照片 / 扫描件，AI 逐题判分、标注对错、生成整体评语；批改结果可一键采纳进成绩册，或导出留档
• 多供应商可配置切换：兼容 OpenAI 接口的任意服务——云端（DeepSeek / OpenAI 等）或本地（LM Studio / Ollama / vLLM），可保存多套配置、随时切换、一键连通性测试
• 流式响应 + 实时进度：批改时实时显示「模型思考中…已生成 N 字」，慢速本地推理模型批改整卷也不会被误判超时
• 思考模式与「思考失控保护」：可开启「抑制思考」——对支持的模型尽力关闭思考过程；对所有模型启用失控保护，思考超过设定上限仍未作答即提前中止，避免长时间空转
• 灵活的 Token 策略：可关闭「限制 Tokens」，让推理型模型按自身上下文上限自由生成（思考过程也占用额度，限制过小会导致答案被截断）
• 返回结果多级容错：模型输出的 JSON 出现缺逗号、多余尾逗号或轻微残缺时自动修复 / 打捞，尽量避免整单批改失败
• 传输层稳健化：底层改用 http/https 直连，规避慢速模型长等待被客户端默认超时误杀（表现为「fetch failed」）

本版修复

• start.sh 在 Apple Silicon 下统一以 arm64 承载 node/npm，修复 PATH 中为 x64-only node 时启动报「Bad CPU type」的问题

下载说明

文件	用途
teacher-ops-1.1.0-*.zip	Windows 用户下载这个（Win10 1803+ / Win11，解压后双击 install.bat → start.bat）
teacher-ops-1.1.0-*.tar.gz	Linux / macOS / Docker 部署
*.sha256	完整性校验，shasum -a 256 -c <文件名>.sha256

便携包已内置前端构建产物，不含 node_modules，首次启动自动安装依赖。

Docker / GHCR 镜像

docker pull ghcr.io/kyhx1984/teacher-works:v1.1.0
# 或跟随最新：docker pull ghcr.io/kyhx1984/teacher-works:latest

快速开始

Windows：解压 zip → 双击 install.bat → 双击 start.bat → 访问 http://localhost:3000（admin / admin123）

Linux / macOS：tar -xzf *.tar.gz && cd teacher-ops && ./start.sh

Docker：解压后执行 ./deploy.sh，或改用上面的 GHCR 镜像

启用 AI 批改

1. 进入「AI 批改」设置，开启功能开关
2. 新建供应商：填写服务地址（OpenAI 兼容 base_url，本地服务通常以 /v1 结尾，遗漏时系统会自动兜底）、模型名、可选 API Key
3. 本地 / 推理型模型建议：开启「流式响应」、关闭「限制 Tokens」、按需开启「思考模式」
4. 点「测试连接」确认可用后，上传试卷图片即可批改

隐私提示：试卷图片会发送到你配置的模型服务。使用本地模型（LM Studio / Ollama 等）时数据不出本机；使用云端服务时将经由对应厂商，请按所在机构的合规要求选择。

升级与兼容性

• 数据库结构与既有业务逻辑无破坏性变更，从 v1.0.x 升级无需数据迁移：解压新代码覆盖 → docker compose restart（或 ./stop.sh && ./start.sh）
• AI 批改为可选功能，默认不启用；不配置则完全不影响原有使用
• 三种既有部署方式（源码 / Docker 本地构建 / Windows 批处理）均不受影响

完整变更见 v1.0.1...v1.1.0 提交对比。

v1.0.0

班主任平台 v1.0.0 首个正式发布版本。

一站式班级事务管理：学生档案、成绩与试卷管理、背书/作业任务、请假、德育量化、座位表、课程表、资源库，支持多班级管理与数据物理隔离。

核心特性

• 多班级管理：每班独立 SQLite 数据库物理隔离，顶栏一键切换，互不影响
• 试卷与成绩联动：试卷管理生成考试记录，自动同步成绩分析；Excel 导入导出
• 背书/作业任务：任务-学生两级结构，导出全班完成情况 Excel（无记录学生显示"未完成"）
• 跨平台部署：macOS / Linux（start.sh）/ Docker（deploy.sh）/ Windows（install.bat + start.bat 全自动安装 Node 环境与依赖）
• 数据看板：学生成绩分布（按学生平均分统计）、考勤、德育等可视化

下载说明

文件	用途
teacher-ops-1.0.0-*.zip	Windows 用户下载这个（Win10 1803+/Win11，解压后双击 install.bat → start.bat）
teacher-ops-1.0.0-*.tar.gz	Linux / macOS / Docker 部署

便携包已内置前端构建产物，不含 node_modules，首次启动自动安装。

快速开始

Windows：解压 zip → 双击 install.bat → 双击 start.bat → 访问 http://localhost:3000（admin / admin123）

Linux/macOS：tar -xzf *.tar.gz && cd teacher-ops && ./start.sh

Docker：解压后执行 ./deploy.sh

本版修复要点

• 单条销假、删除资源类别等接口 bug 修复
• 删除学生级联清理背书/作业数据
• 成绩导出 500 错误与中文文件名、同名试卷覆盖等数据一致性问题修复
• Windows 批处理 CRLF 兼容与 zip 发布包支持

完整变更见 Git 提交历史。