Skip to content

v1.1.0 · EVA-02(二号机)

Choose a tag to compare

@tempChanghong tempChanghong released this 11 Oct 15:58
162e2e2

NPEduTools v1.1.0 · EVA-02(二号机)

版本概述

v1.1.0,代号 EVA-02(二号机),是基于 v1.0.0 的自习功能更新。配套 NPClassworks/NPClassworksKV v1.3.0 · Yamada(山田凉)。

自习展示和麦克风采集现在由 NPEduTools 原生端承担,学校后台统一配置班级安排、作业来源、设备和照片策略。录课、通知、点名、课堂工具及考试联动继续保留。本版新增的 DLY-2202 联机校准标为 Beta;隔离自动化通过不代表真实仪表与教室验收完成。

新增功能

原生全屏自习展示

  • 新增 WPF 全屏自习页面:大时钟、阶段提示、噪音状态与实时趋势、今日作业,以及围绕“本次自习”卡片的进度环。已知结束时间时显示进度;未设置结束时间的手动自习显示已进行时间和三小时上限。
  • 定时自习提前 5 分钟打开页面并展示本班自习座位表;开始前 2 分钟显示 10 秒“准备自习”,开始后 2 分钟自动收起座位表。准备展示不提前授予麦克风采集或阈值拍照权限。
  • 开始提示为红色、结束提示为绿色,均持续 5 秒;“注意纪律”使用更深的红色。四种阶段/纪律提示配有提示音,中阈值边缘扩散效果不播音。
  • 学校选择展示的行政班作业及适用走班来源,隐藏无作业科目并去重。长作业按内容分页,轮换默认 60 秒,后台可调整;更新等待当前页读完,不突然替换阅读内容。
  • 自习结束提示后显示本次报告:时段、趋势、均值/峰值、双阈值超限时长、有效采集覆盖率、提醒次数及数据单位。默认 5 分钟后退出报告;照片与退出验证记录不向全班展示。

学校定时安排与手动自习

  • 学校可以独立设置日常、考试模式的自习安排,也可让某个模式不执行定时自习。新配置的默认时段为 北京时间 19:00–21:30;保留明确自定义安排。年级继承、班级覆盖/关闭、星期、生效日期和日历例外由学校配置,不把某一学校的开学日期作为所有部署的规则。
  • 日常定时自习使用 ClassIsland 学校时间;考试模式明确使用 Windows 时间,后台和报告标明来源。日常学校时间失效时,不默默改用 Windows 时间继续采集。
  • 手动自习可选择开始和结束日期/时间:不填开始时间则立即开始;不填结束时间则主动结束,实际会话最长 3 小时。预约开始默认提前 2 分钟打开展示,此值可在本机设置调整,到点才采集。
  • 手动展示隐藏座位表按钮,左下角保留长按“结束自习”,允许提前结束已有结束时间的会话。临时收起默认 10 分钟后返回,也可选择不自动返回;收起不停止后台采集及已获学校策略许可的拍照。
  • 手动与定时共享设备和校准,但不能同时采集。学校定时优先,接管时结束手动会话并保存报告,不自动续开;旧手动窗口不能误停新的定时会话。
  • ExamAware2 考试放映器优先:自习继续后台采集及按策略拍照,暂停自习页面与提示音,过期提示不补播;放映结束后再核对是否需要显示自习页面。

双阈值、设备准备与校准

  • 学校设置高、中两条阈值线。中阈值显示边缘扩散,高阈值增强视觉效果;连续超限默认 3 秒后才满足高阈值触发条件。“注意纪律”默认 10 分钟内至多提醒一次,与照片的限频分别处理。
  • 初始设置与设备页可选择固定麦克风、摄像头;枚举和保存不会自动开启采集。学校后台接收设备列表,可远程选择并锁定;本机通过学校管理验证解锁后,保持解锁,直到管理员再次锁定。所选设备失联不会自动换用另一台。
  • 快速校准支持管理员选择现场场景采样、检查质量并确认双阈值,无需要求全班配合制造绝对安静。它帮助设置相对信号阈值,不把场景录入当成声压级标定。
  • 参考校准使用外部 A 加权声级计的稳定参考,与本机麦克风统计计算偏移,再以另一电平复核。结果通过确认后用于正式监测、双阈值和报告;设备、输入增益或相关输入设置变化后失效,不能自动沿用未经复核的参考。
  • **联机校准(Beta)**面向 DLY-2202:连续读取仪表、与麦克风同期采样、自动计算偏移并复核,处理陈旧读数、断线和输入设置变化。USB 无实物验证已覆盖协议解析与失败路径;真实设备枚举、驱动、读数时序及声学一致性仍待实测。
  • 未参考校准时使用 dBFS;有效参考下显示 估算 dB(A),报告保留参考来源与原始数字电平。估算值不等于计量级声压级,不与旧网页评分混用,也不用于班级排名。

自习座位表、照片与退出记录

  • 自习座位表支持学校远程下发,也支持已绑定大屏在设置页或定时展示中上传、替换本班图片,无需额外口令。双方更新按版本检查,冲突时保留草稿并重新确认,不覆盖更新后的远端图片。座位表不参与作业轮换;除定时准备阶段外,仅通过按钮查看。
  • 摄像头默认不持续开启。学校另行启用照片策略后,高阈值连续超限、定时退出意图和异常恢复等事件按条件捕获单张 JPEG;共用默认 30 秒最小间隔,限制图片尺寸和体积。注意纪律提示不宣称“已拍照”。
  • 照片传至学校的 NPClassworksKV,默认保留 30 天,最长 180 天;延长保留需确认风险。仅同校 OWNER 与第二管理员可查看,不生成公开图片链接,不上传原始音频或视频片段,不向星火动力云端上传捕获画面。
  • 定时阶段点击“停止后台并退出”时先检查拍照条件,再验证管理员身份。一次密码错误或默认 30 秒验证超时后,显示 30 秒红底白字、不发光的全屏警告,然后返回自习;文字按实际上传及记录状态呈现,不把待上传说成已完成。
  • 离线照片与报告保留补传状态,并检查班级、会话、策略和有效期限。过期或授权失效的数据不因重连自动越权上传。服务端到期清理与备份副本的保留期限是不同边界,学校需另行确认备份策略。

学校管理与独立守护

  • 学校互联支持“大屏填服务地址发起申请,管理员同意并设置口令”,以及“学校预授权并设置口令,大屏填服务地址和口令连接”;保留旧配对兼容入口。NPEP 接管后使用学校班级管理口令,旧本机口令不作为学校管理验证的回退。
  • Guard 通过 Windows 任务计划程序独立运行。非定时阶段退出主程序时继续待命;定时准备前唤醒,异常退出后重新核验有效安排、授权、时间及设备,再恢复采集和展示。
  • 定时异常恢复新增独立事件,恢复后检查拍照并显示警告,去重且遵守共同限频;通过验证正常退出则跳过本次时段,下一次准备前再启动。手动会话不自动续开,也不套用定时红色警告。
  • 常驻侧边栏新增快捷收窄;进入自习展示或考试放映器时完全隐藏,退出后恢复原状态。桥接操作不再挤占 ExamAware2 的主要入口,补齐断开图标并统一设置、日期、口令和设备选择控件样式。

Bug 修复与稳定性

  • 改善 Host 管道访问被拒绝、无效响应和晚到回执的恢复;通知、录课、点名、学校连接及考试状态不再把历史成功当作当前已完成。
  • 修复录课指定日期编辑、删除失败后草稿身份、过时预测与清理超时等边界,保留当前设置及未提交内容。
  • 修复座位表切班后的旧预览操作、校准失效写盘失败、采样尾段丢失、陈旧电平、报告时钟变化、损坏设备配置和 USB 取消/枚举错误等问题。
  • 更新三份服务与隐私协议,并重新确认新增的学校口令、设备管理、照片及退出记录用途;GPL v3 与第三方许可继续独立展示。

安装与升级

  1. 先备份数据库、NPEP 身份目录和本机 %LocalAppData%\NPEduTools、录课及相关配置。升级服务端时应用 KV v1.3.0 完整迁移链,核对 /ready,再更新网页 v1.3.0 和桌面 v1.1.0;保留现有配对与自定义排程。
  2. 更新、换目录或卸载前,正常停止录制/监测并退出 App/Host,随后由维护人员按 守护维护说明停止本实例的待命守护并撤销任务。普通“停止后台并退出”不会结束守护。
  3. 本版守护位于应用目录 Guard\svchost.exe,文件描述为“Windows 服务主进程”,产品仍为 NPEduTools;它不是 Microsoft 系统服务。维护时核对完整路径和所属任务,不要按名称批量结束 Windows 的 svchost.exe。
  4. 使用完整发行包,保留 App、Host、Guard、运行时与录课组件;只复制或改名一个 EXE 不能升级。ClassIsland、ExamAware2、SecRandom 本体仍单独准备;桥接插件按本次完整包更新。
  5. 在单台大屏核对学校口令、日常/考试时段与时间来源、设备锁定、双阈值、参考有效性、照片访问与上传状态,再扩大范围。新默认时间不覆盖用户明确的旧安排,照片不会仅因更新而自动启用。

测试与已知限制

  • 已合并 PR #14 的必要 CI 通过,包括 Windows、安装器及固定三仓验收。本地原生测试 1496 项、学校互联测试 295 项通过,WPF、HTTP 验收及 Probe 构建通过。
  • 三仓联合验证包括原生 PostgreSQL 的 HTTP/SQL/备份恢复 47 项通过、0 跳过、网页浏览器回归 183 项通过,以及隔离的真实网页/KV 配对全栈检查。合成输入不代表真实麦克风、摄像头或仪表已经验收。
  • DLY-2202 实物 USB、目标教室一体机、声学校准、学校时钟、任务管理器终止后的实际恢复与长期运行尚待现场验收。 联机校准继续标为 Beta;守护不是 Windows kiosk,也不能保证阻止可提权管理员同时停止组件或删除任务。
  • 守护缓存用于唤醒,不授予离线采集许可;长时间退出、缓存耗尽或配置发生变化后需重新核验。服务器撤销或改排程无法立即告知离线设备。
  • 安装 EXE 与便携 ZIP 自带 .NET 运行时、完整 App/Host/Guard/Camera/Recorder 组件及录课工具。附件经完整性和隔离交付验证;真实一体机、USB 声级计与声学验收仍单独确认。应用与安装程序未做 Authenticode 签名,SHA-256 用于完整性核对。

文档、反馈与完整变更

使用指南 · 安装与卸载 · GitHub Issues。反馈请提供版本、复现步骤和脱敏诊断,不公开口令、令牌、配对文件或师生照片。

项目采用 GPL v3,第三方组件分别遵守其许可证,由星火动力技术组(NPTG)开发。

查看完整变更:v1.0.0...v1.1.0。本草稿对应已合并源码 162e2e23d269afea0b25d941683f37b738b1e2c6。

下载文件与作用

文件 作用
NPEduTools-v1.1.0-win-x64-setup.exe Windows 10/11 x64 完整安装程序
NPEduTools-v1.1.0-win-x64.zip 自带运行时的完整便携包,解压后运行 Start-NPEduTools.cmd
NPEduTools.ClassIsland.Bridge.cipx ClassIsland 时间与课表桥接插件(0.2.0.0)
npedutools-examaware-bridge-0.4.0.ea2x ExamAware2 1.5.2 桥接插件(0.4.0,含本次放映联动改进)
NPEduTools-v1.1.0-source.zip 本版标签的项目构建源码,不能作为程序运行
NPEduTools-v1.1.0-third-party-sources.zip 第三方源码、许可证和构建材料,包含内置 FFmpeg 对应材料
v1.1.0.md 本版离线版本说明
SHA256SUMS.txt 上述七个附件的 SHA-256 校验值

ClassIsland、ExamAware2、SecRandom 本体另行准备。两种桥接插件同时放在完整程序包内并提供独立下载;不要沿用旧包里的桥接文件。本版保留 USB 联机校准 (Beta) 标识。

附件补发记录:二进制和构建源码基于已有标签 v1.1.0,完整提交 162e2e23d269afea0b25d941683f37b738b1e2c6。标签未移动;版本说明采用 main 的已审核详细文档并补充本表。后续 main 的文档及测试夹具修订没有改变本版业务源码。