v1.3.1 - 修正时钟取整（补丁）

补丁版本：功能与 v1.3.0 相同，修正发布构建中的一个时钟取整缺陷，建议使用本版本。

🐞 修复

• 剩余时间偶发"回退 1 秒"：暂停/刷新时 ceil((t+N) - t) 的浮点舍入在少数情况下会得到 N+1，导致刚扣减的 1 秒又显示回来。现已在时钟计算中减去 1 微秒容限（CLOCK_EPSILON），并新增 300 次 tick+pause 回归测试防止复发。
• 测试中两处对时间敏感的断言改为容错写法（暂停基准、连续 refresh 允许 1 秒真实流逝），使持续集成在 Windows 高负载下稳定通过。

🧪 质量

• 核心自动化测试 110 项断言全部通过
• CI 覆盖 Windows + Ubuntu × Python 3.10/3.12，全部通过

📥 下载

• PomodoroWorkbench.exe（约 12.2 MB，免装 Python，双击即用）

🔐 校验值（建议下载后核对）

SHA256: 27a28319dde838af2aee78111c69f53303f74c8c0e9b7a836bdba5e6d1be2e1a

核对命令（Windows PowerShell）：

Get-FileHash .\PomodoroWorkbench.exe -Algorithm SHA256

说明：v1.3.0 的二进制缺少该取整修复，已被本版本取代。

v1.3.0 - 计时精度与稳定性修复

本轮是代码审查后的质量修复版本，重点解决计时精度与跨平台健壮性。

🐞 修复

• 运行中修改时长导致进度条出现负值、倒计时与设置不一致
  （引擎为每个阶段快照总时长，进行中的阶段保持原节奏，新时长从下一阶段生效，
  设置面板会给出提示）
• 计时会随界面卡顿变慢：改为按单调时钟结算剩余时间，界面每 250ms 仅做刷新；
  
  efresh()\ 幂等，重复调用不会重复扣减；\ ick()\ 保留供无界面/第三方调用
• \make_card(padding=…)\ 参数此前从未生效，已移除

🛠 改进

• 异常日志：新增 \�pp/logger.py\，非预期异常写入 ~/.pomodoro_workbench/app.log
  （自动轮转 3×256KB），便于反馈问题时排查
• 主窗口位置与尺寸记忆：关闭时保存，下次启动恢复
• 跨平台字体自适应：Windows/macOS/Linux 自动探测可用中文字体（雅黑/苹方/Noto CJK），
  找不到时回退 Tk 默认字体
• 悬浮窗增强：📌 置顶开关（可关闭置顶）、隐藏时不刷新界面、支持多显示器负坐标
• 首次使用引导：首启显示三步上手提示，点「知道了」后不再出现
• 数据库结构版本与迁移通道：\schema_version\ + \MIGRATIONS\
• 清理死代码（\ heme.hex_to_rgb/mix_alpha\、\�larm.all_alarm_fingerprints\、
  \export.kind_label\、\stats\ 恒假条件）

🧪 质量

• 核心自动化测试 93 → 108 项断言全部通过
• GUI 冒烟新增端到端用例：阶段自然结束 → 记录会话 → 关联待办番茄数 +1，
  以及窗口位置记忆、悬浮窗置顶、首启引导检查
• CI 覆盖 Windows + Ubuntu × Python 3.10/3.12

📥 下载

• PomodoroWorkbench.exe（约 12.2 MB，免装 Python）

🔐 校验值（建议下载后核对）

\
SHA256: 2f4d0e2fa0ab7a536092662144eeb83666b25f810d5d0c05fb69b75d1a31ef4a
\
Windows 上可用 \Get-FileHash .\PomodoroWorkbench.exe -Algorithm SHA256\ 核对。

v1.2.0 - 置顶迷你悬浮窗

本次新增迷你悬浮窗，最小化主窗口也能看时间、控节奏。

🪟 新增：迷你悬浮窗

• 主窗口最小化后自动弹出（可在侧边栏关闭该行为），也可手动勾选开关
• 约 240×160 像素的无边框置顶小窗：显示当前阶段（🍅专注 / ☕短休 / 🌿长休）、剩余时间与进度条
• 内置三个快捷按钮：开始 / 暂停、跳过、回主界面
• 支持鼠标拖动到屏幕任意位置，位置自动记忆；点 × 或右键隐藏
• 配色跟随当前主题（4 套主题均适配），切换主题后自动重建
• 退出前若开着悬浮窗，下次启动自动恢复

质量

• 核心自动化测试 93 项断言全部通过，GUI 冒烟测试覆盖悬浮窗显示、快捷操作、主题重建与隐藏全流程
• CI 覆盖 Windows + Ubuntu × Python 3.10/3.12
• 界面截图更新至 10 张（新增悬浮窗截图）

下载

• PomodoroWorkbench.exe：Windows 独立可执行文件（约 11.7MB，免装 Python）

感谢社区贡献者 @dongjixuepiao 的 README 改进（PR #13）已合并入本版本。

v1.1.0 - 主题换肤与闹钟自定义

本次为主题与提醒自定义版本。

🎨 新增：界面主题系统

• 4 套配色一键切换：默认浅色 / 深色模式 / 护眼绿 / 樱花粉
• 侧边栏直接切换，重启后保持；深色模式下卡片、热力图、趋势图、提醒弹窗全部适配

⏰ 新增：闹钟提醒自定义

• 弹窗提醒 / 响铃提醒可分别开关（支持只弹窗或只响铃）
• 三种阶段铃声随时试听（15 秒自动停止）
• 自动停铃时长可调（5~120 秒）
• 支持导入自定义 WAV 铃声，文件失效自动回退内置音效

💾 数据导出与一键备份（社区贡献 PR #1）

• 待办 / 习惯 / 专注记录一键导出 CSV（Excel 直接打开）
• 数据库一键备份与还原指引

下载

• PomodoroWorkbench.exe：Windows 独立可执行文件（约 11.7MB，免装 Python）

质量

• 核心自动化测试 90 项断言全部通过，CI 覆盖 Windows + Ubuntu × Python 3.10/3.12
• 界面截图更新至 9 张（含深色 / 护眼绿 / 樱花粉主题）

v1.0.0 - 番茄工作台

首个正式版本：番茄专注 / 待办清单 / 习惯打卡 / 数据统计，三阶段专属闹钟提醒。

下载

• PomodoroWorkbench.exe：Windows 独立可执行文件（约 11.7MB，免装 Python，下载双击即用）

源码运行

• Windows：下载源码后双击 start.bat（缺 Python 会自动安装）
• macOS / Linux：./start.sh

亮点

• 零第三方依赖（纯 Python 标准库：tkinter + sqlite3）
• 4 大功能模块 + 置顶提醒弹窗 + 阶段专属铃声
• 62 项自动化测试 + GitHub Actions CI
• 完整中文文档、真实界面截图、MIT License