v1.3.5 · Yamada（山田凉）

NPClassworks v1.3.5 · Yamada（山田凉）

v1.3.5 整理学校自习管理入口与高级参数，改善手机和大屏的操作反馈。代号保持 Yamada（山田凉），配套 NPClassworksKV v1.3.5 与 NPEduTools v1.1.5 · EVA-02（二号机）。

改进与修复

• 统一 NPEP 自习管理入口：设置、执行状态、报告与照片在同一工作区内切换，旧噪音排程只作为兼容路径，避免管理员为同一安排维护两套设置。
• 常用设置优先：双阈值、连续超限时间和提醒间隔收到默认收起的高级设置；未修改考试模式的只读查看不产生未保存草稿，验证失败定位对应设置区。
• 手机布局：修复自习设置右半边横向裁切，模式、时间和日期输入随窄屏排列，长作业来源名称不撑宽页面。
• 作业板更稳定：保留当前作业布局直到新数据到达，减少录入后的刷新抖动；保存、同步与等待刷新分别反馈。
• 自习默认值：新安排默认北京时间 19:15–21:30，估算声压级新策略默认双阈值 50／65；不覆盖已有自定义时段或阈值。临时使用电脑按连续无操作时长返回，默认十分钟，与原生端策略一致。
• 诊断可追踪：学校诊断导出保留 v1.1.5 · EVA-02（二号机） 对应的规范版本与可选提交标识，继续排除任意附加文本。

移除功能

延续 v1.3.0 的退役规则：非 NPEP 浏览器噪音检测入口关闭，无论学校是否开启 NPEP。网页不再开始浏览器手动／本机定时采集，也不因原生设备离线自动退回浏览器麦克风。采集与全屏自习展示由 NPEduTools 执行。

旧浏览器历史兼容代码和既有本机记录保留；入口停用不清空站点数据，不将旧评分转换为原生统计。已有作业板、教学管理与通知功能继续使用。

升级与使用

1. 先备份并更新 KV v1.3.5，应用完整迁移链、核对健康状态，再更新网页及 NPEduTools v1.1.5。
2. 只配置过旧噪音时段、尚未建立新自习设置的范围由 KV 兼容迁移；已有新策略与明确自定义安排保留，不自动启用考试安排或照片。
3. 保存作业和管理草稿后刷新／重开 PWA，通常无需清空站点数据。核对班级、日期／星期、两种模式、学校口令和默认设备。
4. 配置保存、请求受理、设备应用和实际采集仍是不同事实，以新鲜执行回执判断状态。照片只在授权的学校管理后台查看，保留期限与备份边界仍由部署方说明。

验证与发布边界

网页单元、lint、构建、浏览器与三仓组合 CI 通过；可选 Claude 审查按配置跳过，不计作测试通过。真实设备、USB、触控和声学验收不由自动测试替代，联机校准仍为 Beta。dBFS 与估算 dB(A) 分开显示，不用于班级评分或排名。

本 Release 提供前端源码及可离线保存的说明，不是桌面安装包；GitHub 发布完成不代表每个学校已完成部署或设备升级。公开附件不包含学校配置、密钥、学生资料或数据库备份。

完整变更 v1.3.0…v1.3.5 · 部署配对 · 反馈。

v1.3.0

NPClassworks v1.3.0 · Yamada（山田凉）

版本概述

v1.3.0，代号 Yamada（山田凉），是基于 v1.2.5 的 NPEP 自习管理更新。配套 NPClassworksKV v1.3.0 与 NPEduTools v1.1.0 · EVA-02（二号机）。

学校后台统一管理自习安排、作业来源、自习座位表、设备与报告；全屏自习展示和实际采集转由 NPEduTools 承担。网页继续提供作业板、教学管理、通知和考试操作，本版不重新推出这些既有功能。

新增功能

NPEP 成为独立管理分组

• 左侧 NPEP 与“日常管理”“学校配置”等同级，集中放置大屏互联、噪音／自习监测及相关管理入口，减少在大屏设备页面反复展开查找。
• 设备概览、远程操作、诊断与执行回执集中展示，分别说明“保存配置”“请求受理”“设备应用”和“实际采集”。陈旧、离线或失败状态不冒充正在监测。
• 沿用学校现有管理账号与后端授权范围；本版不新增独立的逐账号 NPEP 权限编辑器。

自习安排、作业和自习座位表

• 后台按学期、年级和班级配置继承、覆盖或关闭，支持星期、生效／结束日期与日历例外；日常模式和考试模式独立设置时段，允许某个模式没有安排。
• 新配置默认 北京时间 19:00–21:30，保留用户明确自定义的排程。适用学校、班级、星期及日期仍需管理员填写，不硬编码某所学校的三晚开始日期。
• 配置自习展示的噪音显示方式、临时收起时间、双阈值、连续超限时间及提醒间隔。高阈值连续时长默认 3 秒，“注意纪律”默认 10 分钟内至多一次。
• 选择今日作业的来源行政班，结合授课规则展示其适用走班作业，去重并隐藏无作业科目。轮换默认 60 秒，支持后台调整，原生端按内容分页并延后应用阅读中的更新。
• 后台上传、替换、撤回 自习座位表，查看版本及来源。已绑定大屏也可上传本班图片，后台标明设备来源；双方并发修改返回冲突，不用旧预览覆盖新的座位表。
• 界面说明定时展示提前 5 分钟打开座位表、开始前 2 分钟播放 10 秒准备提示、开始后 2 分钟返回原页面。座位表不加入作业轮换。

学校口令与远程设备管理

• 班级开启 NPEP 时配置学校管理口令；支持管理员批准设备申请，以及先预授权、再由大屏使用学校服务地址和口令连接。预授权不等于设备已经连接或开始执行。
• NPEP 接管后的管理验证使用学校班级口令，旧本机管理口令不作为回退；保存口令、修改口令和设备收到新策略仍分别显示结果。
• 查看设备上报的麦克风、摄像头列表，远程设置并锁定默认输入设备。大屏通过管理验证解除锁定后保持解锁，直到管理员再次锁定；列表或状态过时则提示刷新核对。

一页查看自习报告、照片与记录

• 按班级与会话查看时段、趋势、平均值／峰值、采集覆盖率、双阈值超限与提醒次数，并在同一详情中查看有权限的照片、退出验证和异常恢复记录。
• 区分手动与学校定时会话，标注日常 ClassIsland 学校时间、考试模式 Windows 时间及报告的时间异常；旧报告没有可靠归属时保留设备历史入口，不猜测归入新班级。
• 数据单位明确显示 dBFS 或 估算 dB(A)，参考校准显示来源与有效性，DLY-2202 联机参考保留 Beta 标识。不将旧网页评分、数字电平与估算声压级混为同一种统计。
• 学校独立启用单张照片策略：默认最小间隔 30 秒、保留 30 天，最长 180 天；延长保留需确认风险。仅同校 OWNER 与第二管理员可查看照片，不提供公开图片链接；普通自习结束报告不向全班显示照片。
• 展示捕获、待上传、已存储、失败或过期的真实结果，不能仅凭退出事件或请求受理就声称服务器已经收到照片。

移除功能

• 移除非 NPEP 的网页噪音检测使用入口，关闭浏览器手动采集、本机定时采集及旧网页定时监测展示入口。无论学校是否启用 NPEP，网页都不再提供新的浏览器噪音采集。
• 原生设备离线、失联或不支持新协议时，网页提示实际状态，不会自动退回浏览器麦克风采集。需要继续监测时使用 NPEduTools，不把刷新 PWA 当成原生采集恢复。
• 保留旧浏览器本机历史的查看与既有数据，不因本次入口停用自动清空站点数据；旧记录不转换为原生报告，也不与新统计混合。
• 这是采集入口和运行路径的退役，不表示旧噪音模块已经全部从仓库删除，也不影响原生监测的后台控制与报告。

Bug 修复与体验优化

• 修复座位表切班失败后旧预览可能作用于新班级的问题，提交前再次核对确认过的作用范围及修订。
• 修复陈旧电平与监测状态、结束尾段显示、时钟变化标注，以及保存配置与桌面执行反馈混淆；设备状态恢复时保留尚未解决的操作错误。
• 恢复学生手机端空状态的可读布局，改善 NPEP 设置与设备恢复反馈；统一关于页和诊断的版本元数据为 1.3.0 / Yamada（山田凉）。

升级说明

1. 备份数据库、学校服务配置和 NPEP 身份，先更新 KV v1.3.0、应用完整 Prisma 迁移链并核对 /ready，再更新网页及 NPEduTools v1.1.0。保留既有绑定、身份和自定义安排。
2. 保存未提交的作业或管理草稿后刷新／重开 PWA；通常不需清空站点数据，以免丢失旧浏览器历史、草稿及大屏绑定。
3. 核对班级管理口令、两种模式的时段、设备能力及锁定状态。已预授权的班级仍可预先配置自习，但设备收到配置且实际开始采集须以新鲜回执为准。
4. 启用照片前告知学校使用人员，核对摄像头、查看账号、保留期限、补传与清理。服务器当前数据清理不承诺清除所有备份副本，备份期限由部署方另行说明。
5. 原来的网页独立噪音采集不再可用；学校未启用 NPEP 时仍可使用作业板等功能，监测需求另行准备桌面端。日常与考试时间来源不同，应分别验收。

测试与使用边界

• 已合并 PR #11 的必要 CI 通过，涵盖单元、lint、构建、浏览器及三仓契约／全栈检查；可选 Claude 审查按原配置跳过。
• 本地网页单元 697 项通过、14 项跳过，完整浏览器 183 项通过，ESLint 通过；隔离原生 PostgreSQL 的真实网页／KV 配对全栈验证通过。跳过不计为通过。
• 真实课堂大屏、触摸、摄像头、DLY-2202 USB、声学校准及长期运行仍待现场验收；联机校准保留 Beta。关闭网页不会自动停止原生采集，发布草稿不代表所有设备已升级或生产部署完成。
• 不上传原音频，不提供视频片段捕获，不按噪音数据给班级评分或排名。新增照片按学校策略传往学校 KV，不向星火动力云端上传捕获画面。

文件、反馈与完整变更

release-v1.3.0.md 为本版可离线保存的发布说明；GitHub 正式发布后的 Source code (zip / tar.gz) 是前端源码，需安装依赖并构建，不是 NPEduTools 安装包。不附带学校私有配置、令牌或数据库备份。

GitHub Issues 接收版本、复现步骤与脱敏诊断，请勿公开口令、配对码或学生资料。

查看完整变更：v1.2.5...v1.3.0。本草稿对应已合并源码 e0dff559bd7cfdd8dbd1a5a13104290b1546eac5。

v1.2.5

NPClassworks v1.2.5 · Hitori（后藤一里）

版本概述

v1.2.5 是基于 v1.2.0 的配对、定时监测展示、界面及安全更新，沿用代号 Hitori（后藤一里），按正式版发布。配套 NPClassworksKV v1.2.5 与 NPEduTools v1.0.0 · EVA-01（初号机）。

本版重点让学校预先开放大屏配对，让定时监测有独立、清楚的展示页面，并改善学生、教师、大屏及学校管理的布局。v1.2.0 已有的通知、考试／日常切换、考试方案与原生噪音报告继续保留；本版不是重新推出这些功能。

新增功能

预授权配对：管理员不必同时在线

• 学校后台可以提前对已有班级大屏开放 NPEP 配对，也可按当前学期的年级或全校批量处理；先预览范围，再确认提交。
• 被授权的大屏网页可生成 8 位、10 分钟有效的一次性配对码，同时显示供 NPEduTools 使用的后端地址。桌面输入后确认固定的学校、班级和设备归属，管理员无需实时批准。
• 保留原有“桌面申请、学校管理员批准”的流程。关闭预授权不会撤销已经配对的设备；未来新建的大屏也不会自动继承本次批量开放。
• 范围或授权发生变化时要求刷新并重新确认，不自动把旧预览应用到新名单；已经被占用的大屏不被新配对替换。

定时监测独立页面与限时返回

• 原生桌面实际开始定时采集并上报可信状态后，网页进入专用监测画面，集中显示电平、采样质量、时段、状态和来源。仅有规则或“开始请求已受理”不会被当作正在监测。
• 作业板、通知和未提交草稿保留。可以暂时返回作业板，返回不停止采集；到期再自动返回监测画面。时长由学校后台配置，默认 10 分钟，范围 1–60 分钟。
• 停止定时监测使用学校管理 PIN 验证；手动监测维持原有启停方式。网页保护不是浏览器或 Windows 的锁定模式。
• 新增展示状态心跳，让桌面区分网页可见、暂时返回、隐藏、受阻及未知状态；不因为网页没有响应而误报采集已经结束，也不额外启动第二个网页麦克风。

体验优化

• 调整学生手机、教师工作台、班级大屏和学校管理的布局层级与响应式显示；改善大屏远距离阅读与操作入口。
• 优化考勤、作业录入、发布历史、通知中心、考试方案和噪音管理的列表、操作区域与结果提示，减少窄屏拥挤及状态混淆。
• 配对、设备状态、考试操作和监测报告分区展示，保留“请求受理”和“设备实际完成”的区别。
• PWA 不再预缓存无用的旧横幅；减少不使用的图标字体格式预加载。减少部分静态请求不等于所有设备首屏速度都提高。
• 关于页、恢复诊断和大屏上报统一读取包元数据，本版为 1.2.5 / Hitori（后藤一里）。

Bug 修复与安全改进

• 修复空闲作业板没有当前时段或返回状态时的空值边界，避免页面因定时监测状态为空而崩溃；旧会话不能继续占用当前展示。
• 网络恢复事件早于连接真正可用时，允许有限重试，改善背景资源恢复。
• OAuth 登录交接绑定浏览器验证信息，并使用一次性换取流程；实时私有订阅按授权范围过滤，减少跨身份或跨范围的信息访问。
• 无关公开信息刷新不再误关闭已经打开的作业导出。
• 保留网页不收录元信息和既有访问控制；搜索引擎指令仍不能代替登录与权限验证。

测试与发布保障

• 更新摘要依据 v1.2.0 至已合并 main 的实际 Diff，并核对 #2、#3、#4、#5 的 PR 及对应跨端验收记录。
• 已合并预授权功能完成固定三端提交的九阶段联合验收；定时展示与保护完成十七阶段隔离验收。它们是对应功能提交的既有证据，不是本次版本信息修改后的全部重跑。
• 本轮候选网页测试 677 项通过、1 项可选合成桌面输入测试跳过、0 失败；另行运行 3 项契约测试全部通过。ESLint、生产构建和静态 PWA 校验通过。跳过项不计为通过。
• 真实教室大屏、手机输入法、长期运行及 v1.2.0 至本版的生产 PWA 升级未在本轮重新实测，不能把自动化检查描述为现场验收。

升级说明

1. 先备份并更新 NPClassworksKV v1.2.5，应用完整 Prisma 迁移链并核对就绪状态，再更新网页，最后更新需要新保护能力的桌面至 NPEduTools v1.0.0。
2. 保留前端／API 分离配置。网页配对展示的是后端 API 地址；不要把前端网页路径填入 NPEduTools。已有 NPEP 部署身份及配对无需重新初始化。
3. 保存网页未提交内容后刷新或重新打开 PWA。通常不需要清空站点数据，以免丢失本机草稿、选班和绑定。
4. 预授权升级后默认不向未开放的大屏自动授权。使用批量操作前核对学期、班级、启用状态和预览范围。
5. 上线前核对学校定时时段、返回时长和管理 PIN。旧桌面在线不代表支持 0.8／0.9 保护与展示协议；应按设备实际能力判断。
6. 开发仍可使用 pnpm dev 统一启动前端与原生 PostgreSQL 后端；生产构建使用 pnpm run build，之后执行 pnpm pwa:validate。

使用边界与反馈

• 网页控制和展示不替代桌面采集。关闭网页、返回作业板或网页失联不会自动停止桌面会话；原生接管时不自动退回网页采样。
• 噪音数据是 dBFS 信号电平，不是校准后的声压级，不与旧网页评分混用，不用于班级排名。本版不提供原音频上传、摄像头采集或跨班批量考试控制。
• 学校排程仍依赖可靠的 ClassIsland 学校时间。需要立即停止离线设备时，必须在设备侧处理。
• ExamAware 编辑器退出协商的已知问题仍保留：切换前保存并关闭编辑器，返回日常前结束放映。
• Release 公布不等于服务器已经部署，也不等于所有学校设备已升级。未合并的设备操作概览与诊断导出不列为本版功能。

问题请通过 GitHub Issues 反馈，提供版本、复现步骤与脱敏诊断，不公开账号令牌、配对码或学生资料。

文件说明

文件	作用
release-v1.2.5.md	本版功能、升级及限制说明，可离线保存
GitHub Source code (zip / tar.gz)	发布标签对应的前端源码；需要安装依赖并构建，不是 Windows 安装程序

不附带教学软件本体、NPEduTools 安装包、数据库备份或服务器私有配置。

Full Changelog

查看完整变更：v1.2.0...v1.2.5。

v1.2.0

NPClassworks v1.2.0 · Hitori（后藤一里）

版本概述

v1.2.0 是基于 v1.1.5 的学校互联与原生课堂工具更新，以 Hitori（后藤一里） 为代号，按正式版发布。

本次新增 NPEP 设备配对与学校管理、桌面通知投递、完整考试／日常远程切换、ExamAware 方案控制，以及原生噪音监测、学校年级／班级排程与统计报告。同时更新暖橙色图标，完善页面元信息与本地开发流程。原有作业、通知、考勤、模板及准备清单流程继续保留。

配套后端为 NPClassworksKV v1.2.0；桌面端为 NPEduTools InDev 20261002（Pre）。网页和 KV 按正式版准备，但 NPEP 的真实班级大屏、学校排程及长期运行现场验收仍未完成，原生联动建议先在单台设备试用。

新增功能

NPEP 学校设备互联

• 学校后台设备管理：在学校管理页的 NPEP 设备互联区域管理配对、设备状态、暂停／恢复及撤销。完成配对即授权当前提供的学校互联能力，确认文案明确学校、班级与设备范围。
• 状态与能力展示：显示连接信息、设备回执和当前支持的能力，区分历史操作结果与最近状态。连接成功不代表麦克风、ClassIsland 或 ExamAware 已经配置完成。
• 完整考试／日常远程切换：学校后台可对单台设备发起切入考试或返回日常，联动桌面软件运行、Windows 登录自启动与自动录课暂停。受阻时展示执行步骤、原因和部分完成状态，支持核实与重试。
• ExamAware 方案控制：查看和管理考试方案、向指定设备投递，核对方案摘要并明确请求开始放映，展示投递／放映回执。需要新版 NPEduTools 及 ExamAware 桥接 0.4.0。

通知同时送达网页与桌面

• 统一弹窗设置：“网页大屏与 NPEduTools 弹窗提示”同时控制两个显示端。次要通知允许关闭弹窗，仍可接收；普通、重要、紧急通知仍须弹窗提示。
• 原生通知回执：显示设备投递与处理情况。桌面端通过 HTTP 轮询收件，采用独立置顶窗口；普通及以上通知配合变暗遮罩，需手动关闭。
• 默认显示一天：未填写失效时间的新通知默认在发布时间一天后停止显示，编辑器预览与后端保持一致。已有明确失效时间的通知不因本次升级统一重写。

原生噪音监测与学校排程

• 班级大屏入口：从课堂工具进入噪声监测；原生接管后，网页负责开始／停止、显示最近状态和报告，由 NPEduTools 使用已保存的麦克风。
• 明确采集边界：原生接管时停用旧网页采集和旧网页定时功能，避免两个端同时占用麦克风；失联不自动退回网页采集。关闭网页后，桌面会话可以继续运行。
• 统计报告：展示有效采样时长、覆盖率、能量平均、峰值、削波和设备／算法来源；只上传统计，不上传录音。KV 每台设备保留最近 30 天、最多 200 份，页面显示最近 20 份。旧网页历史仍在原浏览器中，不混合为原生报告。
• 学校定时规则：学校后台按年级或班级管理每周时段，支持继承、覆盖、停用、预览与修订冲突处理。桌面按 ClassIsland 学校时间执行；网页展示规则、执行状态和报告来源。
• 手动停止与考试状态：手动停止自动会话可跳过当前时段并明确恢复；考试期间暂停自动监测。无法关联来源的报告标为未知，不能当作手动报告。

体验优化

• 暖橙色品牌图标：更新真实路径 SVG、浏览器图标、PWA 图标、maskable 及单色资源，并保留可编辑母版与验证材料。
• 统一版本与代号：关于页面、诊断信息和上报信息从应用版本元数据读取；本版统一为 v1.2.0 / Hitori（后藤一里），修正先前源码包仍显示 v1.1.0 的情况。
• 网页显示最近设备状态：明确提示网络延迟、操作已受理与实际运行状态的区别，避免把按钮请求成功当作设备已完成操作。

Bug 修复与页面元信息

• 调整开发依赖扫描范围，避免文档／生成缓存中的 HTML 被误当作应用入口，改善管理页动态模块加载问题。
• 所有生产 SPA 页面共用 robots: noindex, follow 元信息，要求搜索引擎不收录页面；该指令不代替登录权限或访问控制。
• 页面 canonical、Open Graph 和分享图地址由 VITE_SITE_ORIGIN 统一生成，默认使用前端地址 https://newfires.top，不再残留无关的 cs.newfires.top；API 地址独立配置。
• 修正 PWA 通知角标资源、管理页配对文案和浏览器夹具，使通知与学校授权提示符合当前功能语义。

测试与发布保障

• 本次版本与说明准备后，重新运行 654 项网页单元测试、ESLint、隔离生产构建与静态 PWA 校验，均通过；本轮没有重复全部浏览器或真实数据库验收。
• 已合并功能完成 654 项网页单元测试、ESLint、生产构建与静态 PWA 资源校验；最新功能 CI 完成 152 项浏览器检查，以及真实全栈 37 项和独立 N1 配对验收 1 项。
• 增加 NPEP 配对、通知、考试／日常切换、方案、原生噪音与学校排程的契约和跨端检查；统一入口联动网页、KV 和桌面测试。本地使用原生 PostgreSQL，避免依赖生产环境调试。
• 自动 Claude 审查改为显式开启：安装对应 GitHub App、配置 API 密钥，并设置 CLAUDE_REVIEW_ENABLED=true 后运行。未配置时跳过，不影响构建、单元、浏览器或契约检查；跳过不表示完成 AI 审查。
• 以上是既有功能验证证据，不将自动化结果描述为真实大屏验收，也不将 Release 草稿创建描述为生产部署完成。

升级说明

1. 建议先更新 NPClassworksKV v1.2.0 并应用完整 Prisma 迁移，再更新前端。保持现有前端／API 分离部署方式；后端升级前备份数据库及 NPEP 配置身份。
2. 已配对桌面升级至 NPEduTools InDev 20261002；使用方案功能时升级 ExamAware 桥接至 0.4.0。旧设备不一定支持新控制或学校排程，不能仅凭“在线”判断兼容。
3. 前端开发使用 pnpm install --frozen-lockfile，配置 Windows 原生 PostgreSQL 与后端本地环境后运行 pnpm dev，统一启动前后端；仅启动网页使用 pnpm dev:web。生产构建使用 pnpm run build，完成后执行 pnpm pwa:validate。
4. 大屏保存未提交内容后更新 PWA，不需要清除站点数据；以免丢失本机草稿、选班、设备绑定或离线待上传内容。旧页面需刷新／重新打开才能取得新代码。
5. 首次部署 NPEP 可先保持关闭，核对原有业务后再启用单台设备；已经激活的服务保留原身份，不重复初始化。上线前检查已保存的年级／班级规则，避免新桌面接收意外时段。

使用边界与反馈

• 原生噪音数值为 dBFS，不是校准声压级，不与旧网页评分混用，也不用于班级排名。当前不提供原音频上传、摄像头或跨班批量考试控制。
• 自动排程依赖可靠的 ClassIsland 学校时间；规则离线租期与设备运行情况需以桌面提示为准，服务器禁用无法立即通知离线设备。
• ExamAware 编辑器退出协商仍有已知问题；切换前保存并关闭编辑器，返回前结束放映，不强制结束未保存窗口。
• v1.2.0 与旧版本之间的真实 PWA 升级、教室设备长期运行及学校排程现场验收仍需补充，不把已有其他版本升级测试视作本版实测。

问题请通过 GitHub Issues 反馈，附版本、复现步骤及脱敏诊断信息，不提交账号令牌、配对码或学生资料。

文件说明

文件	作用
release-v1.2.0.md	本版发版说明，可离线保存
GitHub Source code (zip / tar.gz)	发布标签对应的前端源码，发布后自动提供；需要安装依赖并构建，不是桌面安装包

本次不附带 NPEduTools、ExamAware 或 ClassIsland 安装包，也不附带数据库备份与服务器私有配置。

Full Changelog

查看前端完整变更：v1.1.5...v1.2.0

v1.1.5

NPClassworks v1.1.5 · Ikuyo（喜多郁代）

版本概述

v1.1.5 是基于 v1.1.0 的课堂使用体验与可靠性更新。

本次更新围绕教师备课、学生核对与大屏抄写，新增个人作业模板、历史作业复用、必做与选做、需带物品、提交说明、发布前预览、明日与假期清单，以及文字分享。大屏布局和教师确认机制同步调整，并修复连续编辑、版本冲突、历史操作及考勤重试中的多项问题。

新增功能

教师备课与发布

• 个人作业模板：模板跟随教师账号同步，换电脑也能使用；可保存标题、正文、选做内容、提交说明和常用需带物品。支持 〔页码〕 等填空项，填写并核对预览后套用，不自动发布。每个账号最多保存 50 个模板。
• 从历史作业快速复用：选择某日的一项或多项作业，每次最多 20 项，逐项核对新日期、班级和内容后发布或保存草稿。截止时间和携带日期需要重新确认；创建新记录，保留原作业及历史。
• 发布前大屏预览：使用实际作业卡片预览本次输入，可按目标班级切换，明确标注尚未发布。预览不保存或发布内容，返回编辑后保留输入。
• 必做与选做：可在正文之外单独填写选做内容，添加后区分必做与选做。作业板、放大、抄写、周总览、版本历史及导出清单同步展示。
• 提交说明：可补充“早读前交给课代表”等上交要求，与作业一起展示、同步和保存历史，也可加入个人模板。
• 本次更正原因：修改已发布作业时可填写原因，大屏更正提示和版本历史保留本次说明，后续编辑不自动沿用旧原因。

学生核对与清单分享

• 需带物品清单：作业可附带物品和独立的携带日期，大屏与学生端集中展示今日、明日及之后的准备事项。支持从更早布置的作业中提取，携带日结束后退出当前清单，原内容和历史继续保留；“今日无作业”也可附带物品。
• 明日要交与需带：按北京时间的下一个自然日，汇总明日截止作业和需带物品，并单列今日未设置截止时间的作业供核对。支持教师选班、打印/PDF、图片及文字清单。
• 放假作业汇总：自定义假期名称、日期和向前查找范围，汇总假期内布置或截止的作业，也可手动选择其他查到的作业。按科目整理后导出，不创建重复的发布记录。
• 查看今日更正：主动查看当前作业板日期、所选班级的作业在今天发生的内容更正，显示改前、改后、版本和更正原因。新打开的学生页或大屏也可查询，不必曾经显示过旧版本。
• 文字版作业清单：预览并勾选需要分享的科目，一键复制班级、日期、必做、选做、截止时间、提交说明和需带物品，便于自行粘贴到班级群。浏览器拒绝自动复制时，保留可全选的文字供手动复制。

大屏抄写与录入

• 抄写模式：按项放大作业，支持手动翻页、调整字号和定时轮播；长正文分屏保留重叠行，也可滚动查看。通知弹窗或页面进入后台时暂停轮播，作业更正时停止并提示核对，退出后恢复原浏览位置。
• 大屏填写选做与物品：录入、修改作业时可填写必做、选做、需带物品和携带日期，覆盖草稿恢复、离线保存和版本冲突处理。
• 考勤快捷入口：底部“录入作业”旁增加“录入考勤”，直接进入今日考勤。沿用现有名单和保存流程，隐藏考勤工具时同时隐藏快捷按钮。

体验优化

• 更紧凑的大屏布局：保留“NPClassworks 作业板”和“热爱创造奇迹。”标题与副标题，突出抄写、录入与日期操作；科目录入状态和需带物品改为可展开摘要，低频功能集中到更多菜单。
• 保留底部快捷栏：原有入口与左、中、右位置设置继续可用，窄屏允许换行，页面按实际栏高留出空间，便于查看最后一张作业卡片。
• 长作业排版：自动列数模式结合列宽、字号和内容长度，让较长作业跨两列；不截断正文，也不按内容量自动缩小字号。手动列数与单列模式保留原有规则。
• 简化教师确认标识：大屏和学生端隐藏未确认标识，仅显示“教师已确认”。放大、抄写、准备事项和导出清单采用相同规则，未确认作业仍正常展示，实际确认状态不变。
• 待处理中心聚焦今日：教师待处理列表、分类数量和顶部角标仅统计作业板日期为今日的未确认事项，跨午夜自动更新；旧作业仍可在发布记录中查看，不删除、不自动确认。
• 完整展示补充信息：周总览、版本历史、待处理中心及各类清单补齐选做、提交说明、需带物品等信息；教师发布列表支持搜索选做内容。
• 模板替换含义明确：套用模板时完整替换对应字段，空选填项也会清空编辑器原值；携带日期重新填写，避免旧要求混入新作业。

Bug 修复

编辑、保存与版本冲突

• 修复大屏解决正文冲突时，额外写回不可编辑字段旧值的问题；保留服务器最新提交说明等未由本次操作编辑的信息。
• 修复教师保存期间继续输入后，上次更正原因进入下一版本的问题；已提交原因会清理，保存期间新填写的原因和内容继续保留。
• 修复大屏保存期间仍能继续输入、成功关闭窗口后丢失后续修改的问题；保存和冲突处理期间统一保护相关输入与操作。
• 修复连续版本冲突后读取最新版失败时，仍保留过期对比、未正确显示错误的问题；保留本机输入，并要求重新核对。
• 修复部分保存失败只显示通用 HTTP 错误的问题，优先展示服务器提供的具体业务说明。
• 完善选做、需带物品、携带日期及无作业标记的校验与清空处理，保护可恢复草稿；防止迟到的文本框回调抢走选做输入焦点。

历史、确认与复用

• 修复旧版本确认请求被误报成功、界面显示错误确认版本的问题，与后端版本校验配合处理冲突。
• 修复草稿及已撤回内容在历史窗口出现无效确认入口的问题。
• 历史恢复与教师确认增加操作互斥及应用刷新保护，避免重复写入、保存中关闭窗口或刷新后无法判断结果。
• 修复历史复用列表刷新后继续保留已改期或失效来源的问题；进入编辑前重新核对最新内容，防止迟到请求恢复已取消的选择。
• 复用过程中保留失败项目的输入，已成功保存的项目不因下一项重试而重复提交。

清单、布局与考勤

• 修复明日清单遗漏请求进行期间刚到发布时间的作业或物品的问题，在全部响应返回后判断可见性。
• 明日清单和今日更正遇到作业版本、范围、日期或可见性变化时，清除失效结果并提示刷新；避免旧响应或不完整分页结果继续用于核对、导出。
• 修复防烧屏微移使固定快捷栏离开首屏的问题，并保持滚动后的定位与微移效果。
• 修复筛选后只剩一个科目或班级时，筛选清除入口消失的问题；修复宽屏切换到单列后残留跨列样式造成的挤压。
• 修复考勤错误重试、名单变更或跨日重新载入时，可能直接丢弃尚未保存输入的问题；重新载入前确认，并隔离已变化的考勤范围。

性能与资源优化

• 大屏辅助区域按需展开，长作业按实际布局分配列宽，减少首屏重复信息与不必要的纵向占用。
• 清单切换日期、班级或关闭窗口时取消过时请求，释放不再需要的监听，避免旧结果继续影响当前页面。
• 抄写轮播在后台或通知弹窗期间暂停；明日清单仅在窗口打开时执行跨日检查。
• 新增浏览器性能基线与真实发布版本升级验收工具。开发电脑上的自动化数据用于后续比较，不等同于教室大屏实测，也不代表所有设备获得相同速度提升。

测试与发布保障

• 扩展真实 PostgreSQL、HTTP、Socket.IO 与浏览器全链路回归，覆盖账号模板隔离、并发上限与版本冲突、准备事项、选做、提交说明、历史复用及更正查询。
• 增加抄写轮播、离线首次打开、清单跨午夜失效、文字复制失败、历史写入互斥、大屏布局及考勤重试等浏览器测试。
• 增加教师确认展示和今日待处理筛选回归，包括午夜刷新失败时仍移除昨日事项、保留历史发布记录的情况。
• 补充已发布源码版本的 PWA 升级验收及手动工作流。现有固定版本验收覆盖 v1.0.1 → v1.1.0，不将其作为 v1.1.0 → v1.1.5 已完成实测的证明。
• 修正浏览器测试中的异步等待、旧文案预期和固定日期夹具，保留对实际业务行为的检查。

升级说明

• 建议与 NPClassworksKV v1.1.5 配套升级，优先更新后端以提供模板、跨日期物品查询和今日更正接口，再更新前端。
• 保留现有前端与独立 API 域名部署方式。本轮功能复用已有数据表和发布元数据，无新增数据库迁移，无需修改服务器部署代理。
• 大屏应在保存当前输入后更新应用；旧页面不会因后端更新自动获得新布局或新字段展示。不需要清除站点数据，以免丢失本机草稿、待上传作业和缓存。
• 模板保存与历史复用需要联网；抄写模式可使用已缓存作业。明日、假期和今日更正等按需查询需要联网获取结果，导出的文字、图片和纸质清单以生成时内容为准。
• “明日”指下一个自然日，不自动推断周末、节假日或下一上课日。需带事项到期隐藏，不删除历史记录。
• 未确认标识隐藏和今日待处理筛选均属于前端展示调整，不取消教师确认流程；通知已读与确认回执机制保持不变。

Full Changelog

[查看前端完整变更：v1.1.0...v1.1.5](v1.1.0...v1.1.5)

v1.1.0

NPClassworks v1.1.0 · Ikuyo（喜多郁代）

版本概述

v1.1.0 是基于 v1.0.1 的功能与可靠性更新，版本代号为 Ikuyo（喜多郁代）。

本次更新新增作业打印与图片清单、明确无作业标记、一周总览、作业更正提示、单科放大、次要通知、班级名单管理和预设背景，并继续完善大屏长期运行、通知送达、离线保存及应用升级体验。

新增功能

作业查看与分享

• 作业打印清单：按所选班级范围和作业板日期生成简洁清单，支持浏览器打印或另存为 PDF，保留教师确认、无作业及缓存提示。
• 作业清单图片：生成适合分享的 PNG 图片，包含班级、日期、科目和内容更新时间；长正文自动分页，每页保留范围信息，支持逐张保存。
• 明确“今日无作业”：教师可按科目和发布目标主动标记无作业。学生页和大屏区分尚未录入、已有作业、明确无作业；作业与无作业标记并存时提示核对，继续显示实际作业。
• 一周作业总览：支持按作业板日期或截止日期查看，提供前后周、本周及科目筛选；截止日期视图包含更早布置但在本周截止的作业。
• 作业更正提示：大屏对已经显示过、随后被修改的作业短暂突出前后差异，提醒学生核对已抄内容；提示保留两分钟，完整记录可从版本历史查看。
• 单科作业放大：点击作业可临时放大正文和截止时间，长内容支持滚动，关闭后回到原来的浏览位置。

通知与大屏

• 新增“次要”通知等级：次要通知使用 Teams 默认提示音，发布时可选择是否弹窗；普通、重要、紧急通知强制启用弹窗。
• 通知栏折叠：大屏通知栏可手动折叠；收到新通知或通知新版本时自动展开，方便及时查看变化。
• 手动噪声监测跨页面运行：手动启动后离开监测页面仍继续工作，支持主动停止；单次手动监测最长三小时，到期自动结束手动模式。定时监测按独立计划管理。
• 麦克风对照诊断：增加“安静 / 说话”两阶段对照，展示实际输入设备、数字电平变化及浏览器报告的音频处理状态，帮助选择和检查麦克风。

学校管理与外观

• 远程管理行政班名单：学校管理员可查看、编辑、排序和批量粘贴学生名单，支持合并或整班替换；保存前预览变化，版本冲突时保留输入。名单更新会通知绑定该班的大屏。
• 预设背景：内置分类图片预设，先显示缩略图，选择后才下载大图；成功缓存后可离线使用。支持取消下载，离开设置时终止未完成的请求。
• 独立项目图标：更新网站、PWA 安装及相关平台图标，使用 NPClassworks 的新标志。

体验优化

• 大屏同步状态更可信：分别展示实时连接和内容加载情况。连接正常但内容请求失败时，不再显示为正常同步；可查看当前内容更新时间。
• 周总览刷新保留结果：同一范围刷新失败保留上次完整结果，并标明时间和可能过时的状态；切周、切换查看方式或班级时隔离旧数据，避免混用。
• 管理列表刷新更稳妥：大屏列表遇到临时错误时保留旧结果，合并重复刷新；账号修改后保证补取新数据，刷新完成不会提前解除正在保存的状态。
• 通知确认反馈更明确：通知弹窗和通知中心共用当前版本的确认状态，展示处理中或保存失败反馈；同一绑定的其他标签页确认后，当前页面及时同步。
• 保留编辑中的内容：PWA 更新、设置页刷新和恢复刷新统一检查未保存输入及进行中的保存；名单、发布与学校管理表单遇到错误或冲突时提示处理。
• 更好地处理无效选班：已停用的走班教学班不再作为有效选择继续使用；选择器、活动作业板和手动刷新相互配合，保留仍然有效的行政班内容。

Bug 修复

作业与发布状态

• 修复各科录入状态直接显示科目 ID，以及新增作业被误报为作业更正的问题。
• 修复范围、日期、绑定或会话变化后，旧请求结果覆盖当前作业板、缓存或错误状态的问题。
• 修复通知错误显示“待教师确认”的问题，区分账号发布通知与需要按授课范围确认的作业。
• 修复列表分页读取不完整影响教师搜索、待处理筛选和大屏内容展示的问题；刷新失败时避免以部分页面覆盖完整结果。
• 修复通知过期、撤回、版本变化和离线恢复时的显示与确认状态处理，并保持通知生命周期与作业板日期查询的区别。
• 改善作业日期、截止时间、无作业元数据和考勤名单的输入校验，减少看似保存成功但显示含义不一致的情况。

离线与多标签页

• 将待发送通知回执持久化并按绑定隔离；断网确认、刷新后即使通知离开当前列表，也可继续处理已保存的回执。
• 修复同一版本的展示回执与确认回执竞争导致状态倒退、跨标签确认未及时反映到弹窗的问题。
• 为大屏离线队列读改写增加跨标签互斥；草稿按标签隔离，避免一个标签保存或删除草稿影响另一标签的输入。
• 修复恢复旧草稿时丢失原修订号的问题，远端已修改时要求确认，避免无提示覆盖新内容。
• 改善教师目标收藏与最近使用的并发同步，保留离线移除意图，避免旧数据重新填回已取消的收藏。
• 完善大屏临时退出后的教师会话边界，防止旧登录、刷新或请求响应延长临时访问或覆盖新会话。

声音、背景与噪声历史

• 修复次要通知等级在提示音、弹窗和显示路径中的不一致，并加强不同通知版本的提醒去重。
• 为提示音准备阶段增加等待上限，忽略超时后的迟到播放，减少重复解码及旧音频资源干扰。
• 修复手动监测离开页面即停止、晚到授权或测试结果重新开启已停止监测等生命周期问题。
• 修复背景下载仅收到响应头后就失去超时保护的问题；新增解码超时与取消处理，失败时保留已保存的背景。
• 为噪声历史数据库打开和事务增加超时恢复。超时写事务会实际中止，迟到打开结果不能破坏新连接或影响清空后的数据。
• 修复名单粘贴对空学号、姓名空格及同名无学号学生的错误处理，拒绝含义不明确的导入并保留原文。

性能与资源优化

• 实时订阅按协议上限分批发送，支持工作区较多的教师，并在重连后恢复完整订阅。
• 按分页协议读取发布列表，减少遗漏和重复读取；大屏管理的手动刷新与轮询共用正在执行的请求。
• 预设背景按需下载并限制缓存数量，取消过时网络请求，释放失败解码和关闭预览产生的临时图片资源。
• 长作业导图采用分段排版，改善关闭和取消的响应。调度会增加完整排版耗时，本项不代表导出总速度提升。
• 合并和清理通知提醒的本地协调记录，减少重复播放与过期记录积累。
• 继续拆分学校管理、大屏设备和学校作业设置模块，并补充组件与实际交互回归，降低后续修改的影响范围。

测试与发布保障

• 增加真实前后端与 PostgreSQL 的全链路测试，覆盖会话、发布同步、通知回执及离线恢复；前后端生产部署都将配套验证作为前置条件。
• 增加真实路由和 Socket.IO 契约测试，验证科目目录、大屏会话、分页及超限分批订阅。
• 扩展浏览器测试，覆盖手动监测跨页、通知弹窗与提示音、名单导入和冲突、背景下载取消、IndexedDB 阻塞及 PWA 升级。
• 修正 CI 中嵌套后端依赖安装、测试环境隔离、时区与异步等待问题，提高部署检查的可信度。

升级说明

• 建议与 NPClassworksKV v1.1.0 · Ikuyo（喜多郁代） 配套升级。保留现有前端与独立 API 域名部署方式，无需为本次版本变更修改服务器部署代理。
• 大屏应在保存当前输入后更新应用。旧版前端不认识“次要”通知，可能按普通通知显示和播放；仅升级后端不能修正已打开的旧页面。
• 名单保存增加版本校验。旧版大屏仍可读取，但缺少版本的保存会被新版后端拒绝，请更新前端并重新加载名单。
• 管理员远程名单功能不提供代改每日考勤；移出学生保留已有学生记录和历史考勤。
• 无作业标记沿用现有字段，旧客户端可读取标题和正文；一周总览及新通知规则需要新版后端配合。
• 多标签离线保存依赖安全上下文中的 Web Locks。不支持时明确提示失败并保留输入；旧页面不遵守新锁，应更新同时运行的旧标签。
• 不需要清除浏览器数据。清除站点数据会影响本机草稿、待上传作业和缓存；普通草稿七天过期、待上传作业保留供处理的规则继续有效。
• 麦克风对照诊断使用 dBFS 数字电平，不是经校准的 dBA 声压测量；不保存录音。

Full Changelog

[查看前端完整变更：v1.0.1...v1.1.0](v1.0.1...v1.1.0)

v1.0.1

NPClassworks v1.0.1 · Nijika（伊地知虹夏）

版本概述

v1.0.1 是基于 v1.0.0 的维护更新。

本次更新围绕现有的作业录入、教师会话、班级大屏和噪声监测进行改进，重点提升断网、存储异常、长期运行及应用升级时的可靠性，同时减少重复请求和本地存储开销。

新增功能

无。 本版本不新增业务功能，主要包含体验优化、Bug 修复、性能改进和测试完善。

体验优化

• 离线保存反馈更明确：只有成功写入本机队列才提示保存成功；写入失败时保留录入内容，提示用户恢复存储或联网提交。
• 同步状态更准确：待上传队列读取失败时显示独立的异常提示，保留当前绑定最近一次成功读取的列表，支持重新读取，不再误报“没有待提交作业”。
• 草稿恢复更稳妥：读取异常时保留原数据，暂停编辑和保存以避免覆盖；重新读取成功后恢复原文。草稿超过七天自动删除的规则保持不变。
• 大屏恢复更及时：恢复联网、回到前台或浏览器唤醒后重新校验并刷新作业，减少页面长时间显示旧内容的情况。
• 历史记录按需加载：教师和大屏的版本历史每页加载 20 条，支持继续加载更早版本，并从已加载的历史中恢复内容。
• 操作期间保护录入内容：打开作业录入窗口、正在提交或正在补传时暂缓远程重载；草稿保存失败时显示提示，避免关闭窗口丢失输入。

Bug 修复

离线作业与草稿

• 修复本机存储写入失败后仍将离线作业视为保存成功的问题。
• 修复待上传作业被数量上限和过期规则静默淘汰的问题：队列满 50 项时阻止新增；等待超过七天的作业保留供人工核对，不自动删除。
• 修复队列读取异常被当作空队列的问题，包括初始化、补传完成后的重新读取及手动处理路径。
• 修复读取或解析草稿失败后直接删除原文的问题，并处理存储访问及过期清理异常，避免异常中断录入窗口。
• 为首次提交和后续重试保留同一个请求标识，配合后端减少“服务器已保存、客户端未收到响应”时的重复创建。

登录与实时同步

• 为登录续期设置超时，区分暂时断网、服务故障与登录真正失效，减少网络波动导致的意外退出。
• 修复切换账号或退出后，旧会话响应覆盖当前令牌、列表或操作状态的问题。
• 防止慢心跳与连续前台恢复产生重叠请求；忽略旧绑定、旧令牌会话晚到的状态和远程指令。
• 合并正在进行的作业刷新请求；期间再有变化，当前请求结束后补一次刷新，减少重复请求及旧结果干扰。
• 修复通知回执的已确认状态被后到的展示状态降级，以及队列销毁后旧响应继续安排重试的问题。

噪声监测与诊断

• 修复麦克风授权、设备测试和音频初始化晚到时重新启动已停止监测的问题，及时释放迟到的音频流和旧会话资源。
• 修复关闭计划、关闭工具、解绑或卸载时，尚未完成的定时监测仍继续启动的问题。
• 修复噪声历史读取、保存和清空的异常反馈及竞争问题，避免迟到结果覆盖已清空的界面。
• 改善新旧页面并存时的噪声历史合并，避免漏掉旧页面后续写入，也避免清空后的记录被再次导入。
• 校正性能采样，分别记录后台暂停和超长采样间隔，减少将休眠、后台冻结误判为前台卡顿的情况。

性能与资源优化

• 教师界面按角色加载，作业录入、历史记录、通知回执等弹窗按需加载；继续保留 PWA 预缓存，支持安装缓存完成后断网首次打开相关弹窗。
• 作业补传采用逐步退避和随机延迟，恢复联网后及时尝试，减少集中重连时的请求压力。
• 通知回执离线时暂停发送，临时故障逐步延长重试间隔，权限或参数错误停止自动重试并记录原因。
• 显示缓存增加过期清理和容量限制，清理范围与待上传作业队列、草稿分离。
• 普通诊断快照按短时间窗口合并保存，关键事件及时记录，减少反复同步读取和重写本地存储。
• 噪声历史改为 IndexedDB 增量保存，减少整份历史的同步序列化与重写；保持最近 14 天、最多 5,000 条统计的保留规则。

清理与兼容性调整

• 移除 UAF（统一作业交换格式）相关导出代码、第三方打包文件、字体与生成脚本。
• 清理残留 Store、无效代码和 ESLint 错误；拆分教师会话、大屏同步、作业数据及学校管理逻辑，降低后续维护的影响范围。
• 噪声历史自动导入新版存储，并兼容仍在运行的旧页面继续写入。旧版本无法读取仅保存在新版 IndexedDB 中的新历史，回退前端时需留意这一差异。

测试与发布保障

• 增加实际 Store、Vue 组件逻辑和 HTTP 交互测试，覆盖存储失败、账号切换、版本冲突及异步响应竞争。
• 增加 Chromium 浏览器回归，覆盖教师发布到大屏更新、断网刷新与补传、PWA 更新、历史恢复、远程重载、草稿恢复和噪声历史持久化。
• 将浏览器测试与单元测试、无自动修复的 Lint 检查、构建检查一起纳入生产部署前置条件。

升级说明

• 建议与 NPClassworksKV v1.0.1 配套升级，以获得完整的提交去重、历史分页及权限修复。
• 保留现有同源或独立 API 域名的部署方式，无需为本版本调整域名或手动修改部署代理。
• 无需主动清除浏览器数据。升级前应确认未提交内容已保存；队列或草稿出现存储异常时，先按提示恢复，避免清除尚未上传的数据。
• 本版保留旧队列的存储格式；历史分页也兼容升级期间旧后端的数组响应，但完整的网络开销优化需要后端同步升级。

Full Changelog

[查看前端完整变更：v1.0.0...v1.0.1](v1.0.0...v1.0.1)

v1.0.0

NPClassworks v1.0.0 · Nijika（伊地知虹夏）

NPClassworks v1.0.0 是面向学生、教师和班级大屏的首个正式前端版本，需配合 NPClassworksKV v1.0.0 使用。

主要变化

• 重新设计学生、教师和大屏三种界面，替换 Classworks 1 旧主页。
• 支持行政班、定科班和走班教学班；学生可自行选班并纠错。
• 教师一次登录即可管理负责的多个班级，支持多班发布、待处理中心和发布结果页。
• 作业与通知完全分离，支持优先级、教师确认、版本历史、重复检测和并发冲突对比。
• 大屏增加独立账号、快速录入、通知中心、离线队列、同步状态和本机诊断。
• 增加快捷词、快捷截止时间、草稿恢复和学生本地完成标记。
• 增加定时噪音监测、麦克风选择与测试、相对安静评分和历史摘要。
• 完善 1080P、2K、4K 大屏布局、移动端管理操作及全系统状态反馈。
• 增加 PWA 更新恢复、资源缓存修复、脱敏诊断包和前端性能基线。
• 移除考试看板、随机点名及不再使用的 Classworks 1 页面与生产配置。

使用说明

• 推荐与 NPClassworksKV v1.0.0 配套部署。
• 前端可以与 API 同源，也可以使用独立 API 域名；分离时需要正确配置后端地址与 CORS。
• 麦克风、系统通知和完整 PWA 功能需要 HTTPS 或浏览器认可的安全来源。
• 本版本不提供旧公共 Classworks 实例中 UUID 作业数据的自动迁移。

部署方法见[前后端部署文档](./deployment-guide.md)。

FAQ

NPClassworks 是 Classworks 的直接继承者吗？

不是。NPClassworks 是基于 Classworks、针对高中分班与走班、教师协作和班级大屏实际需求进行的独立改造，不代表 Classworks 原项目，也不继承其官方身份或公共服务。

Novark Power 会提供公共实例吗？

目前及可预见的较长时期内不会。Novark Power 不计划像 Moonrend（斩月）与 Houlang Cloud（厚浪云）此前的 Classworks 服务一样，运营直接面向公众使用的官方实例。

使用 NPClassworks 需要自行部署前端、NPClassworksKV 和 PostgreSQL，或委托可信任的技术人员维护。

可以只部署前端吗？

不能完整使用。账号、班级、作业、通知、权限、大屏绑定和实时同步均依赖 NPClassworksKV。

FullChangeLog

[查看前端完整变更：cf9352f...v1.0.0](cf9352f...v1.0.0)

Compare 链接会在仓库创建 v1.0.0 标签后生效。

致谢

感谢 Classworks、ClassworksKV、Immersive Clock 和 2school Immersive Clock 为本项目提供基础与参考。

NPClassworks 由[星火动力（NOVARK POWER）](https://novark.ink/) 维护，遵循 GNU AGPL-3.0 许可证。