Tomato Focus Clock macOS / 番茄时光钟

番茄时光钟是一款 macOS 原生专注计时应用，使用 SwiftUI 和 AppKit 构建。它适合学习、写作、编程、备考和日常任务管理，把番茄钟、任务清单、统计分析和成就激励放在一个清爽的桌面应用里。

关键词：Pomodoro timer、macOS focus app、SwiftUI、AppKit、time management、productivity、番茄钟、专注计时、效率工具。

Highlights

• 多模式计时：专注、短休息、长休息、自定义倒计时和正计时。
• 任务绑定：每个任务都可以设置标题、备注、标签、优先级、预计番茄数和独立默认专注时间。
• 稳定操作：任务支持移入已完成、开始该项专注、编辑和删除，并统计今日/历史完成次数。
• 沉浸体验：支持纯倒计时全屏、悬浮窗、菜单栏状态、系统通知和运行时保持屏幕唤醒。
• 数据反馈：今日目标、近 7 天趋势、分类投入、连续达标和多样化成就。
• 本地优先：数据保存在用户本机应用支持目录，不需要登录账号。

Requirements

• macOS 13 Ventura 或更高版本
• Xcode Command Line Tools 或 Xcode
• Swift 5.9+

Install & Run

git clone https://github.com/conceal008/tomato-focus-clock-macos.git
cd tomato-focus-clock-macos
./Scripts/build_app_bundle.sh
open "番茄时光钟.app"

也可以直接以开发模式运行：

swift run PomodoroClock

如需放入应用程序文件夹，可以在构建完成后执行：

cp -R "番茄时光钟.app" /Applications/

Usage

1. 点击「新建任务」创建专注任务，并设置默认专注时长。
2. 在任务卡片中点击「开始该项专注」，计时器会使用该任务的默认时长。
3. 使用顶部模式切换专注、休息、自定义计时或正计时。
4. 点击「全屏」进入纯倒计时显示；按 Esc 或移动鼠标后点击左上角关闭按钮返回主界面。
5. 在「统计」和「成就」里查看投入、连续记录和达成进度。

Data & Privacy

应用不需要网络登录，也不会收集用户身份信息。任务、计时记录、设置和导出文件默认保存在当前 macOS 用户的 Application Support 目录中。仓库不会包含本地运行数据、导出记录、构建缓存或个人文档。

Development

./Scripts/run_checks.sh
swift build -c release

主要目录：

• Sources/PomodoroClock：应用入口
• Sources/PomodoroCore：计时、任务、统计、窗口和设置逻辑
• Sources/PomodoroChecks：轻量诊断检查
• Resources：应用图标资源
• Scripts：构建、运行和检查脚本