# Time

轻量 Electron 桌面应用：巨字时钟 + 多闹钟 + 番茄钟 + 通用倒计时，顶栏 + 4 个标签挤在同一个 ~440×400 小窗口里。

- **巨字时钟** —— `HH:MM:SS` 24 小时制；首页另含日期、下一闹钟、番茄 / 倒计时状态、已启用闹钟数
- **多闹钟** —— 支持 `once` / `daily`，列表按本地时刻升序；`once` 响过后自动停用，`daily` 保留并排到下一天同刻
- **番茄钟** —— `25 / 5 / 15` 三段式，每完成 4 轮 focus 后插一个长休；可暂停 / 继续 / 跳过 / 重置；底部展示今日完成数
- **通用倒计时** —— `HH:MM:SS` 自由设置，自动记住上次时长；归零后弹“完成”按钮，8 秒无操作自动收起
- **6 套皮肤** —— Linear Dark、黄铜暗色、Solarized、Nord、Catppuccin Mocha、Vercel Light
- **4 张浮窗** —— 时钟 / 番茄钟 / 闹钟 / 倒计时各自一个独立 BrowserWindow；启动期预创建 + `hide`，点击瞬开；用户拖过的位置会记住
- **系统集成** —— 顶栏（4 个浮窗 toggle + 图钉置顶 + 齿轮）、托盘菜单、单实例锁、写盘失败 toast、主窗几何持久化、多显示器越界回退

提醒统一走系统通知（`Notification` API）。

---

## 快速开始

### 用户

1. 下载安装包或便携版（见 [打包](#打包)）
2. 首次启动若被 Windows SmartScreen 拦截，点「更多信息 → 仍要运行」
3. 顶栏右侧依次是 4 个浮窗 toggle、图钉（置顶）、齿轮（设置）；主面板 4 个标签：**时钟 / 番茄钟 / 倒计时 / 闹钟**
4. 浮窗右键 / 双击 / Esc / × / 触屏长按 都能关

### 开发者

```bash
npm install
npm run dev          # electron-vite + HMR
npm run typecheck    # node + web 两份 tsconfig 都过一遍
npm run build        # 构建产物到 out/
npm run package      # 打包 → release/（NSIS 安装包 + portable 单文件）
```

需要 Node.js 20+。

---

## 键盘交互

| 范围 | 按键 | 行为 |
|---|---|---|
| 浮窗 | `Esc` | 关闭（实际是 hide，预创建 BrowserWindow 不销毁） |
| 主窗标签条 | `←` / `→` | 切换上一个 / 下一个标签 |
| 主窗标签条 | `Home` / `End` | 跳到第一个 / 最后一个标签 |
| 闹钟 / 倒计时编辑器 | 滚轮 / `Shift` + 滚轮 | 时间步进 ±1 / ±5 |

---

## 数据存储

Windows 上是 `%APPDATA%/time/`（macOS / Linux 类似路径）：

- `app-state.json` —— 主状态（闹钟 / 番茄钟 / 倒计时 / 设置）
- `window-state.json` —— 主窗位置、大小（同步 `writeFileSync` 落盘）

`app-state.json` 写盘走 300ms 防抖 + 合并同批次 + `.tmp → rename` 原子提交；版本不匹配或解析失败时复制为 `.bak-v1` 后回退默认状态。`window-state.json` 不参与备份。

落盘前会剥离 `pomodoro.active` / `countdown.active` —— 重启后回到 idle，避免“旧 endsAt 已过期”的假象；闹钟的 `active=enabled` 完全持久化，重启后调度器按规则继续排程。

---

## 打包

```bash
npm run package
```

产物落在 `release/`：

- `Time Setup <version>.exe` —— NSIS 安装包（当前用户安装，可改安装目录）
- `Time-<version>-portable.exe` —— 免安装单文件

`productName = Time`，`appId = com.guan.time`，当前版本 `0.1.0`。未配置代码签名与自动更新。

---

## 已知限制

- 仅本地时区，UI 仅中文
- 未配置代码签名 —— 首次启动会被 SmartScreen 拦截
- macOS / Linux 标题栏已分支（macOS `hiddenInset` / Linux 系统 `default`），但仅在 Windows 上完整验证过打包
- 提醒只走系统通知；若系统级关闭了通知，闹钟 / 番茄钟阶段切换 / 倒计时归零都不会响
- 闹钟重复仅支持 `once` / `daily`；没有工作日 / 每周指定日
- 闹钟仅按本地时刻升序排列，**没有拖拽重排**
- 番茄钟持久化的 30 天完成历史（`byDate`）当前不展示在 UI 上；面板只显示今日完成数
- 没有“全局重置应用”入口 —— 只能分别重置番茄钟 / 倒计时到 idle