⏸️ 维护说明
因作者目前处于高三阶段，项目已暂停非必要开发与维护。欢迎提交 PR / Issue，但处理与合并可能较慢。
沉浸式时钟（Immersive Clock） 是一款基于 React + TypeScript + Vite 构建的轻量化桌面 / 网页时钟应用。
支持时钟、倒计时、秒表与自习模式，内置天气监测、自习噪音分析、多频道励志语录、多目标倒计时轮播等实用功能。
通过 PWA 技术，支持离线使用、自动更新及桌面端安装体验。
适用场景：校园自习、专注学习、番茄钟、演示看板、桌面时钟等。
我们提供多种使用方式，满足不同场景的需求。
通过 PWA (Progressive Web App) 技术，您可以像原生应用一样安装本时钟，享受离线使用、桌面图标启动和自动更新的体验，且无需下载庞大的安装包。
安装步骤：
- 使用 Chrome、Edge 等浏览器访问演示站。
- 点击浏览器地址栏右侧的 "安装 Immersive Clock" 图标（通常是一个带有加号的小显示器图标）。
- 确认安装后，应用将以独立窗口运行，并自动在桌面/开始菜单生成图标。
如果您不想安装任何内容，可以直接访问网页版。
推荐使用 Chrome、Edge 或 Safari 的最新版本以获得最佳性能和动画体验。
如果您需要更传统的桌面软件体验（支持 Windows/macOS/Linux），可以下载 Electron 打包版本。
- 下载地址：GitHub Releases
- 安装说明：
- Windows: 下载
.exe安装包并运行。 - macOS: 下载
.dmg文件并将应用拖入 Applications 文件夹。 - Linux: 提供
.AppImage或.deb包。
- Windows: 下载
- 多模式切换：时钟 / 倒计时 / 秒表 / 自习模式一键切换。
- 智能 HUD：沉浸式交互，点击或按键显示控制栏，无操作约 8 秒自动隐藏。
- 高级倒计时：
- 支持单次、高考/考研目标日倒计时。
- 多事件轮播：支持添加多个重要日期（如四级、期末考）并按设定间隔自动轮播展示。
- 个性化定制：独立配置每个倒计时项的背景色、透明度与字体样式。
- 环境感知：
- 实时天气：集成和风天气 API，提供分钟级降水预警与气象灾害预警。
- 噪音监测：基于 Web Audio API 的高帧率实时采样，内置评分引擎，支持基线校准、最大阈值设置及包含走势图的详细自习报告。
- 专注氛围：
- 励志语录：支持多频道源（如一言），可配置不同频道的权重与自动刷新频率。
- 组件开关：可自由隐藏噪音、语录、大字时间等组件，定制专属学习界面。
- 背景定制：支持纯色、径向渐变及上传本地图片作为背景。
- 个性化字体：支持上传自定义字体文件 (.ttf/.woff2)，打造舒适的阅读体验。
- 课表导入：支持 Excel 课表文件导入，一键同步学习计划。
- PWA 支持：离线缓存、桌面安装、自动更新。
- 新手友好：提供友好的首次使用引导，帮助用户快速熟悉核心功能。
- 资源优化：静态资源（图片/字体/音频）分级缓存策略，秒级加载。
- 无障碍设计：全键盘导航支持（Space/Enter 唤出 HUD），优化 ARIA 属性。
- 模式切换：点击页面或按
Space/Enter唤出 HUD - 倒计时：双击时间进入设置，支持预设时间与提示音
- 秒表：启动、暂停、累计记录
- 自习模式：
- 多目标轮播：在设置中添加多个倒计时事件，开启轮播即可自动切换。
- 环境监测：开启噪音监测后，超过阈值将自动记录并提示；雨雪天气会有弹窗预警。
- 设置面板：调整目标年份、噪音基线、语录刷新间隔、自定义背景图等。
详细说明请见：
| 操作 | 功能 |
|---|---|
Space / Enter |
显示 HUD |
Enter / Esc |
确认或关闭模态 |
| 双击时间 | 打开倒计时设置 |
| 触摸双击 | 移动端交互支持 |
immersive-clock/
├── electron/ # Electron 主进程与预加载脚本
├── public/ # 静态资源（图标、音频、PWA manifest、文档等）
├── src/ # 源码
│ ├── components/ # UI 组件库（Clock, HUD, NoiseMonitor, ScheduleSettings 等）
│ ├── contexts/ # 全局状态管理 (Reducer/Context)
│ ├── hooks/ # 自定义 Hook（高精度计时、音频等）
│ ├── services/ # 业务服务
│ │ ├── noise/ # 噪音分析与评分引擎 (核心)
│ │ └── ... # 天气、定位服务
│ ├── utils/ # 工具函数与本地存储 (含 Excel 导入、字体管理)
│ ├── styles/ # 全局样式与变量
│ └── pages/ # 页面容器
├── tests/ # E2E 测试用例 (Playwright)
├── docs/ # 使用说明与 FAQ
├── scripts/ # 构建后处理脚本
├── vite.config.ts # Vite 配置（含 PWA 与版本注入）
└── package.json # 项目元数据与脚本
- 无法定位城市？检查浏览器定位授权或使用手动刷新。
- 噪音监测无数据？确认已授权麦克风且设备支持。
- HUD 未出现？确保未打开模态框，点击页面或按
Space/Enter。 - 如何查看公告与更新日志？点击右下角版本号或在菜单中打开弹窗。
更多问题与解答请查看 常见问题 (FAQ)。
欢迎加入我们的官方交流群，分享使用心得、反馈 Bug 或提出功能建议。
-
QQ 群：965931796
也可以通过以下方式进行反馈（建议附上复现步骤与截图/录屏，方便快速定位）：
- GitHub Issues
- 应用内反馈：点击右下角“版本号”打开公告弹窗 → 切到「意见反馈」
- 腾讯问卷
如果你想贡献代码、修复问题或在本地进行二次开发，请阅读贡献指南。
本项目从 沉浸式时钟 项目中提取并独立了噪音监测模块，旨在公开其基于心理声学与专注力理论的噪音评分引擎，为社区提供了一个高质量的噪音监测算法实现参考。
该算法不仅仅是一个简单的分贝计，而是通过多维度加权扣分制，客观量化环境噪音对学习心流的干扰程度。
如果这个项目对您有帮助，请点亮 Star ⭐