Skip to content

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

Choose a tag to compare

@tempChanghong tempChanghong released this 12 Oct 06:33

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

v1.1.1 是 v1.1.0 的稳定性更新,代号仍为 EVA-02(二号机)。重点修复学校管理口令验证、联机校准状态刷新、高 DPI 显示、PPT 辅助触控和侧边栏,并新增下一次定时自习预告。v1.1.0 的自习展示、独立守护、照片、座位表与校准功能继续保留,详见上一版说明。

修复与改进

  • 校准口令验证:快速校准、参考校准和联机校准明确标注本机或学校口令来源、学校口令同步版本,以及验证成功、密码错误、限流和配置不可用的结果。NPEP 接管后使用本班学校管理口令,旧本机口令继续停用。验证与校准操作串行处理,旧轮询或晚到失败不能覆盖新的验证和校准结果。
  • 联机校准说明:界面按实际流程说明连续读取 DLY-2202、麦克风同期采样、自动计算偏移、独立复核和管理员确认。断线、陈旧读数、输入变化及参考失效仍阻止沿用旧结果;联机校准保留 Beta 标识。
  • 高 DPI 布局:按 Windows 缩放后的可用工作区调整主页、侧边栏和校准窗口,在设置中提供自动、80%、90%、100% 界面大小。改善 2K 屏幕 200% 缩放时窗口和控件过大的情况。
  • ClassIsland 连接诊断:分别显示插件文件已安装、禁用、待卸载、文件不完整,以及有新鲜运行握手的“已加载并连接”。课程连接成功不再被当作时间桥接已成功。软件连接页显示经过 ClassIsland 偏移的学校时间,Windows 接收时间单独标注,陈旧学校时间不会继续显示为有效时间。
  • PPT 触控性能:全局输入钩子仅做短路径处理,将窗口命中判断移到工作线程;未放映时不处理辅助手势,减少普通触控与鼠标延迟。补齐输入队列容量、过期事件、重复提升鼠标事件等边界。
  • 侧边栏触控:展开前释放触控捕获,避免面板闪动、打不开及同一触摸误点展开后的按钮。拖动、前台失效和完全隐藏时清理过期操作。
  • 下一次定时自习:主页和自习监测页显示当前模式下一次有效安排的日期、时段和时间来源;跨午夜显示完整结束日期。安排未应用、时间失效、暂停或无后续安排时明确说明,不把预告当作正在执行。
  • 隔离验证稳定性:修复 Named Pipe 测试时序与自定义构建输出目录中校准测试资源缺失的问题,补充口令状态乱序、触控、高 DPI、时钟及下一次安排回归检查。

配套网页与 KV 保持 v1.3.0 · Yamada(山田凉),本轮仅部署更新,不另发新版。学校后台的新估算 dB(A) 策略默认中阈值 50、高阈值 65,管理员可修改;已有自定义安排、阈值及 dBFS 策略不自动覆盖。有效参考校准是使用估算 dB(A) 的前提。

下载与升级

建议普通用户下载 NPEduTools-v1.1.1-win-x64-setup.exe;需要便携部署时下载 NPEduTools-v1.1.1-win-x64.zip。两者来自同一份源码和构建,包含 App、Host、Guard、管理工具、摄像头组件、两处录课组件及其 FFmpeg/ffprobe、自包含 .NET 运行时和桥接插件。

NPEduTools 主发行附件共八项;另附 ClassIsland IPC 修复(Beta),见下方专节:

附件 用途
NPEduTools-v1.1.1-win-x64-setup.exe Windows x64 安装包
NPEduTools-v1.1.1-win-x64.zip 完整便携包
NPEduTools.ClassIsland.Bridge.cipx ClassIsland 时间与课表桥接 0.2.0.0
npedutools-examaware-bridge-0.4.0.ea2x ExamAware2 桥接 0.4.0
v1.1.1.md 本版说明
NPEduTools-v1.1.1-source.zip 与构建一致的 NPEduTools 源码
NPEduTools-v1.1.1-third-party-sources.zip 第三方源码、构建资料与许可
SHA256SUMS.txt 上述七项附件的 SHA-256 校验值
  1. 备份 %LocalAppData%\NPEduTools、NPEP 身份、录课及相关配置。正常停止录制/监测并退出 App 和 Host。
  2. 普通退出不会停止独立守护。更新、移动目录或卸载前,由维护人员按守护维护说明停止本实例守护并撤销任务。安装版守护位于安装根目录的 app\Guard\svchost.exe,默认完整路径为 C:\Program Files\NPEduTools\app\Guard\svchost.exe,不是 Microsoft 系统服务;务必按完整路径识别,不按文件名批量结束系统进程。
  3. 更新完整发行包,不单独替换一个 EXE。ClassIsland、ExamAware2 和 SecRandom 本体单独维护;按需要导入本包中的桥接插件。
  4. 升级后先核对学校连接、管理口令反馈、时间来源、设备与校准参考有效性,再测试一节自习。升级不重新启用照片,不重写用户自定义排程或阈值。

验证与已知限制

发布前执行锁定依赖恢复、Windows 原生与学校互联回归、固定三仓联合验收,以及针对实际 result.json 候选包的 ZIP/安装器一致性、模拟安装升级卸载和内置录课组件验证。自动化使用隔离数据和合成输入;真实 USB、麦克风声学、摄像头及学校一体机验收与这些结果分别记录。

  • DLY-2202 联机校准仍为 Beta,估算 dB(A) 不等于计量级声压级。不要把 dBFS、估算 dB(A) 和旧网页评分混用,也不据此排名班级。
  • 用户报告的 ClassIsland 本体 IPC 广播集合并发修改异常可使用另附的 IPC 稳定性插件补丁(Beta)修复,或在插件不适用时采用备用本体热修复(Beta)。二者需单独安装,目标一体机验收仍待完成;详见下方修复附件及安装说明。
  • 守护恢复、2K 触控表现和长期运行仍需在目标一体机复测;无法保证阻止可提权管理员同时结束所有组件或删除任务。

使用指南 · 安装与卸载 · 完整变更 v1.1.0…v1.1.1 · 问题反馈。反馈请附版本、复现步骤和脱敏诊断,不公开口令、令牌、配对文件或师生照片。

由星火动力技术组(NPTG)开发,采用 GPL v3;第三方组件遵守各自许可。

ClassIsland IPC 修复附件(Beta)

现另附 ClassIsland IPC 广播稳定性补丁(Beta),以及插件不适用时的 ClassIsland 2.1.0.1 本体热修复备用包(Beta)。这项缺陷现在可通过插件修正运行中的 IPC 服务,优先采用插件以保留现有本体文件。以下附件需要单独下载并安装;更新 NPEduTools 不会自动应用它们。

新增附件 用途
ClassIsland.IpcStabilityPatch.cipx 优先安装的 IPC 稳定性插件补丁(Beta)
ClassIsland-2.1.0.1-ipc-hotfix-Beta-win-x64.zip 备用完整本体热修复(Beta),Windows x64 自包含
ClassIsland-IPC-Beta-INSTALL.md 中文安装、现场验证与两种方案的回退步骤
ClassIsland-IPC-Beta-sources-and-validation.zip 对应源码、第三方源码与许可、验证结果及复跑材料
ClassIsland-IPC-Beta-SHA256SUMS.txt 本次新增附件校验值;原有主发行校验文件保持不变

**插件安装与验证:**确认 ClassIsland 为 2.1.0.1 → 在插件管理中导入 .cipx 并启用 → 正常退出并重启 → 在本次启动日志确认 NPEP_IPC_PATCH_ACTIVE → 核对课表、NPEduTools 学校时钟与连接恢复,再观察真实上下课。保留原有 NPEduTools 时间与课表桥接;稳定性补丁不能替代它。仅显示已安装不足以确认生效,SKIPPED_* 或 NPEP_IPC_PATCH_NOT_ACTIVE 需要核对版本、注册冲突或安全模式。插件回退:禁用或卸载稳定性补丁并重启,不更换本体文件。

**备用本体安装与回退:**仅用于 2.1.0.1;禁用 IPC 稳定性补丁并退出 ClassIsland,备份整个应用目录及实际数据目录,然后以完整 ZIP 更新应用文件,保留配置、课表和插件数据,无需卸载重装。确认实际进程路径及 ClassIsland.dll 哈希,再验证课表、时间、重连与上下课。回退时退出程序,恢复备份应用文件和原程序路径,保留用户数据。完整步骤和哈希见中文说明。此包是非官方本地构建,未包含官方云语音服务签名密钥,依赖该密钥的功能尚未验收。

插件候选已完成三轮精确 .cipx 隔离验证,每轮 25 项通过;实际私有 Named Pipe 并发阶段合计 6000 次广播、120 次连接变化。本体候选完成编译、完整打包和 6 项隔离反例。两者均未启动真实 ClassIsland 应用,也未完成目标一体机上下课、插件组合与长期运行验收。 原有八项 NPEduTools 工件、校验值、发布标签保持不变;新增附件同样保留 Beta 标识。

更新前守护维护路径更正

完整安装包的主程序在 app 子目录,默认守护是 C:\Program Files\NPEduTools\app\Guard\svchost.exe。之前说明未明确安装根目录与主程序目录的区别;省略 app 会出现“系统找不到指定的文件”。这不等于发行包缺少守护。

先正常停止并保存监测/录制、在托盘停止后台并退出。用运行 NPEduTools 的同一 Windows 账户打开管理员 PowerShell,复制以下命令;无需先 cd,自定义安装要替换实际完整路径:

# 默认实例;路径含空格必须保持引号,无需先 cd。
$guardExe = 'C:\Program Files\NPEduTools\app\Guard\svchost.exe'
if (-not (Test-Path -LiteralPath $guardExe -PathType Leaf)) {
    throw '此路径没有守护文件。请核对实际安装目录,不要删除配置或按进程名称批量停止。'
}
$maintenance = Start-Process -FilePath $guardExe -ArgumentList '--default-pipe','--maintenance' -WindowStyle Hidden -Wait -PassThru
if ($maintenance.ExitCode -ne 0) { throw ('维护命令失败,退出码:' + $maintenance.ExitCode) }

命令通常没有弹窗。核对 %LocalAppData%\NPEduTools\config\guard\stop.json 的 Generation 与 registration.json 一致、Reason 为 Maintenance,并确认该目录的守护已退出、四个所属任务已撤销。若守护原本未运行,status.json 可能仍是旧状态。随后直接运行 v1.1.1 安装器覆盖升级,无需先卸载;维护与升级不删除配对、自定义排程、报告或校准配置。安装期间不要重新打开旧应用。

如果正确的 app\Guard 路径仍没有文件,请先核对实际安装目录和任务操作路径;不要删除配置,不要按 svchost.exe 文件名批量结束 Windows 进程,也不要从另一目录运行守护来冒充本实例维护。