一个常驻系统托盘的轻量提醒工具，支持 12 种提醒方式，单文件 3.08 MB，零外部运行时依赖。
本项目是对同名 Windows 工具的净室重写：只依据行为规格重新实现，未复制原程序的任何代码。 逆向分析与技术选型论证见
docs/。
当前版本 2.0.0（Tauri 2）。1.x 的 Win32 手绘前端已移除，源码与产物归档在
_archive_v1_win32_20261023/（不含历史记录，仅作回退参考）。
| 值 | |
|---|---|
| UI 实现 | HTML/CSS/JS（tauri/ui/，1239 行） |
| 产物 | work-reminder.exe 3.08 MB + WebView2Loader.dll 157 KB |
| 空闲内存 | ~40 MB |
| 构建 | 需要 Windows GNU 工具链；本机 mingw 缺 as.exe/cc1.exe，故用远程 Linux 主机交叉编译 |
tauri/reminder-core/ 是纯逻辑 crate：调度、持久化、时间运算，
零平台依赖，可独立单元测试。
# 交叉编译到 Windows x64 并自动拉回产物（含 WebView2Loader.dll）
# 需要配置 WM_BUILD_HOST / WM_BUILD_USER / WM_BUILD_KEY 等环境变量
python tools/build_tauri.py
# 只做类型检查（快）
python tools/build_tauri.py --check
# 打印某一提醒方式的参数表与默认值
dist/tauri/work-reminder.exe --params once
# 纯逻辑验证：直接调用二进制的探针接口，不依赖像素坐标
python tools/verify_logic.py
# 全量功能验收（渲染 → 表单 → IPC → 落盘 全链路）
python tools/final_verify.py- 必须随包分发
WebView2Loader.dll：mingw 交叉编译走动态导入，MSVC 才静态链接。 缺它时进程在加载阶段即退出（0xC0000135），Windows 不弹任何提示。 - 32 位目标不支持（已实测工具链与 Rust target 均未安装，按用户决定放弃）。
- 跨机构建的取源策略与本机工具链排查记录见
docs/build.md。
| 调度类型 | 说明 |
|---|---|
| 按间隔循环 | 每 N 分钟 / 小时 |
| 每天固定时间 | 每天 HH:mm |
| 指定日期时间（一次） | 单次绝对时刻 |
| 每周指定日期 | 周一至周日多选 + 时刻 |
| 仅工作日 | 周一至周五 + 时刻 |
| 每月指定日期 | 指定日（自动夹取月末）/ 最后一天 / 最后一个工作日 |
| 每天多个时间点 | 09:00, 12:00, 17:30 |
| 限定时段循环 | 指定星期 + 时段内按间隔重复 |
| 倒计时 | N 分钟后提醒一次 |
| 番茄钟 | 专注/休息交替，跑满 N 轮后自动结束 |
| 开机后提醒 | 启动 N 分钟后提醒 |
| 连续使用电脑提醒 | 连续用机 N 分钟后提醒（空闲 5 分钟自动归零） |
通用能力：任务暂停/启用、今日不再提醒、延后提醒、开机自启动、托盘常驻、提示音、卡片弹窗。
# 依赖：Rust ≥ 1.77 与 Windows GNU 工具链（或 MSVC 工具链）
cd tauri
cargo build --release
# 运行
./target/release/work-reminder.exe产物：tauri/target/release/work-reminder.exe
用 mingw 交叉编译时，产物还需要随包附带
WebView2Loader.dll（见上方「已知约束」）。 产物最终统一收敛到dist/tauri/。
tauri/
Cargo.toml workspace 定义：主包 + reminder-core
Cargo.lock 依赖锁定
build.rs Tauri 构建 + 为 mingw 目标分发 WebView2Loader.dll
tauri.conf.json 窗口/安全策略/标识
capabilities/
default.json 权限清单（IPC 调用、窗口显隐、开机自启）
icons/ 应用图标
src/main.rs Tauri 后端：定时器、托盘、自启、IPC 命令（798 行）
reminder-core/ 纯逻辑 crate，零平台依赖
lib.rs 模块入口
time.rs 日历与时间运算（自实现，无 chrono）
model.rs 12 种 Schedule 枚举 + Task
scheduler.rs next_trigger 求解 + 触发状态机
engine.rs tick 循环 + 使用时长累计
store.rs JSON 持久化（tmp + fsync + rename 原子写）
legacy.rs v1 配置文件的导入兼容
ui/ 仅负责渲染：无定时器、无存储、无调度
index.html 104 行
app.css 608 行，TickTick 风格设计系统（5 级字阶 / 4px 网格 / 单一主色）
app.js 527 行，通过 IPC 取快照并渲染
tools/
build_tauri.py 交叉编译并在本机校验产物
fetch_to_host.py 本机下载资源后上传构建主机
verify_logic.py 纯逻辑验证（走二进制探针，不依赖像素坐标）
final_verify.py 全链路功能验收
shot_tauri.py WebView2 窗口截图（PrintWindow + PW_RENDERFULLCONTENT）
| 参数 | 作用 |
|---|---|
--probe |
启动后立即退出，用于探测进程能否正常加载 |
--params <kind> |
打印指定提醒方式的参数表与默认值，不启动 UI |
--selftest=<name> |
驱动一次脚本化交互。仅 debug 构建可用，release 构建会忽略 |
<kind> 取调度类型 token：interval daily once weekly workdays monthly
multiDaily timedInterval countdown pomodoro afterStartup usageBreak。
| 项 | 位置 |
|---|---|
| 配置 | %APPDATA%\MaXin\WorkReminder\reminders.json |
| 自启动 | HKCU\Software\Microsoft\Windows\CurrentVersion\Run 下的注册表项 |
配置格式（scheduleType 为判别式标签，其余字段按类型变化）：
{
"version": 1,
"tasks": [
{
"id": "t1761118080000-0",
"title": "喝水",
"message": "去接杯水吧，顺便起来活动一下～",
"scheduleType": "interval",
"intervalMinutes": 60,
"nextTrigger": { "date": {"year":2026,"month":10,"day":22}, "time": {"hour":16,"minute":0,"second":0} },
"mutedUntil": null,
"enabled": true,
"pomodoro": { "currentCycle": 0, "inBreak": false },
"startupBootMarker": null
}
]
}version 为 schema 版本，读取时会拒绝高于当前版本的未知结构（不静默重置）。
schedule 字段同时兼容蛇形与驼峰两种拼写，旧文件可直接加载。
- 第三方 crate：
serde/serde_json（仅 JSON）+ Tauri 2 生态（tauri、tauri-plugin-autostart、tauri-plugin-single-instance） - 外部运行时：无（无 Qt / .NET / VC++ 运行时；WebView2 为 Windows 10/11 系统自带）
- 需随包分发：
WebView2Loader.dll（mingw 构建产物依赖）
详见 docs/build.md。
cd tauri/reminder-core
cargo test --lib # 67 项，覆盖闰年、月末、周末、跨年、番茄钟全周期、空闲重置等边界| 文件 | 内容 |
|---|---|
docs/reverse-analysis.md |
逆向分析：功能模块、关键业务逻辑、外部依赖、整体架构（含证据偏移） |
docs/refactor-plan.md |
架构评估、Rust/Go/C++ 选型论证、迁移映射表 |
docs/build.md |
构建、依赖、产物、故障排查 |
docs/quality-review.md |
质量与性能评估记录 |
docs/feature-parity.md |
与原程序的功能逐项对照结果 |
docs/evidence/ |
原始证据表（277 条字符串 / 199 个函数 / 3 张跳转表 / 479 条导入） |
MIT © 2026 Ma Xin。全文见 LICENSE。