沉浸式时钟 v4.0.0

沉浸式时钟 v4.0.0

发布日期：2026 年 8 月 5 日

v4.0.0 是沉浸式时钟的一次大版本升级。相较 v3.13.3，本版本重建了统一 UI 与响应式设置体验，
加入 Android 原生容器和正式签名 APK，并系统升级了外观、本地数据、环境监测、天气与自习信息编排。

下载附件

平台	Release 附件	说明
Web / PWA	immersive-clock-web-4.0.0.zip	供自托管的生产构建，需要 HTTPS、SPA fallback 与天气同源代理。
Windows x64	immersive-clock-4.0.0-x64-Setup.exe	NSIS 安装版。
Windows x64	immersive-clock-4.0.0-x64-Portable.exe	便携版。
Linux x64	immersive-clock-4.0.0-*.AppImage	AppImage 包，实际架构标识以附件名为准。
Linux x64	immersive-clock-4.0.0-*.deb	Debian/Ubuntu 系安装包。
Linux x64	immersive-clock-4.0.0-*.rpm	Fedora/RHEL 系安装包。
Android	immersive-clock-4.0.0-android-release.apk	使用项目长期发布证书正式签名的侧载 APK。
校验和	SHA256SUMS.txt	本次全部附件的 SHA-256 校验值。
Container	ghcr.io/qziky/immersive-clock	公开的 amd64/arm64 镜像，标签为 4.0.0、4.0、4、latest。

本次不提供 macOS 原生安装包。macOS 用户可自行部署 Web/PWA 构建。

主要变化

• 统一时钟、倒计时、秒表、自习、设置及弹层的 UI，改善移动端响应式布局、键盘操作、焦点管理与读屏体验。
• 新增 Capacitor Android 原生容器，并统一 Web/PWA、Electron 与 Android 的屏幕常亮控制。
• 升级主显示字体、信息字体、背景与页面级外观配置，支持本地资源、预览和引用清理。
• 新增本地数据检查、选择性导出、导入预检、恢复和彻底清理，覆盖设置、资源、噪音历史、缓存、诊断与设备状态。
• 环境监测升级为 0–100 环境安静评分，加入设备校准、原始特征归档、历史重算、分段统计和多标签页 Leader 协调。
• 改进天气、城市定位、分钟级降水、空气质量、天气提醒、固定时间、课程事件和倒计时提醒的编排。
• 语录支持本地内容及多个独立在线渠道，可配置启停、权重、顺序、缓存和故障转移。

更新方法

升级前建议在“设置 → 系统数据”创建完整 JSON 备份，并单独导出需要保留的噪音原始特征归档。

• Web/PWA：用 Web ZIP 内容替换自托管站点，再确认 Service Worker 已取得新版本；必要时关闭所有旧标签页后重新打开。
• Windows 安装版：退出旧版本后运行新安装程序。便携版请解压或替换到新目录。
• Linux：退出旧版本后按原包格式安装新版，或替换 AppImage 并重新授予执行权限。
• Android：从本 Release 下载 APK 后覆盖安装。后续版本必须继续使用同一发布证书才能直接升级。
• Docker：固定生产环境到 4.0.0，或按需使用 4.0、4、latest；部署后检查健康端点和天气代理。

旧设置会自动迁移至设置 schema v12，IndexedDB 会升级至 v7。自动迁移不替代备份；浏览器、
桌面客户端和 Android WebView 的本地数据彼此独立，也不会自动云同步。

Android 安装与权限

Android APK 不是应用商店包，需要允许浏览器或文件管理器“安装未知应用”。系统出现来源提示属于侧载流程，
请只使用本 GitHub Release 附件，并用 SHA256SUMS.txt 核对文件。

首次使用定位或环境监测时，系统会分别请求前台位置和麦克风权限。应用不进行后台录音；拒绝权限不会影响
时钟、倒计时和秒表。当前没有连接 Android 真机，因此本次验收以 APK 构建、application ID、版本清单和
签名指纹检查为准，不将真机安装冒烟测试描述为已完成。

数据与指标边界

• 设置、课程、语录、自定义字体、背景和噪音历史默认保存在当前客户端。
• 导出文件是明文，可能包含位置、课程安排、语录和噪音活动时间，请妥善保存。
• 环境安静评分用于同一设备、相近条件下的相对比较，不是专业声级计。
• 估算 dB(A) 需要外部参考校准，不能用于执法、职业健康、设备验收或科学实验结论。
• 新天气、在线语录、网络校时和反馈页面仍依赖网络及相应第三方服务。

发布范围说明

本 Release 的 Web ZIP 是本次 Web 端正式制品，但仓库外的在线站点不属于本次发布、部署或验收范围；
本发布说明不表示 clock.qqhkx.com 已升级至 v4.0.0，也不对其当前可用性作保证。

完整历史请查看应用内“更新日志”或仓库中的 public/docs/changelog.md。