Skip to content

Repository files navigation

正念番茄

一款按自然时钟运行的独立 Apple Watch 番茄钟。

固定的 25 分钟专注与 5 分钟休息节奏,配合触觉提醒、休息滋养提示和每日番茄统计;打开 App 即进入当前自然半小时的节奏。

设计概念

项目从三个视觉方向出发:温暖的生长感、克制的静心感与更有游戏感的像素番茄。当前首发实现采用 B「静心圆环」;A「番茄花园」和 C「番茄小队」保留为后续可扩展主题。

A · 番茄花园

专注时看见一株慢慢生长的番茄,休息时由番茄伙伴提示喝水、远眺等滋养活动。

番茄花园概念稿

B · 静心圆环(当前实现)

以大号时间和圆环进度为核心,降低信息噪声,让专注和休息的状态一眼可辨。

静心圆环概念稿

C · 番茄小队

像素番茄角色与收集式统计,适合未来扩展成更具陪伴感和趣味性的主题。

番茄小队概念稿

当前版本

  • 每个半小时固定为 25 分钟专注 + 5 分钟休息。
  • 专注显示倒计时,休息显示正计时。
  • App 前台使用 Watch 触觉,后台使用本地通知提醒阶段切换。
  • 自动统计每日番茄模式开启时长和完整覆盖的 25 分钟番茄数。
  • 提供圆形与角落表盘复杂功能,可点击快速进入 App。
  • 首发「静心圆环」主题。
  • 主题页已预留「番茄花园」,未来主题不会修改计时与统计核心。

日常使用

为减少抬腕后过早回到表盘,在 Apple Watch 中打开:

Watch 设置 → 通用 → 返回时钟 → 正念番茄 → 自定 → 1 小时后

把 App 放到当前表盘的右下角:

  1. 在 iPhone 打开 Watch App,进入「我的表盘」并选择当前表盘。
  2. 在「复杂功能」中选择右下角槽位。
  3. 选择「正念番茄」,之后点击表盘上的番茄即可打开 App。

也可以直接在手表上长按表盘,选择「编辑 → 复杂功能」完成设置。

打开工程

工程文件由 XcodeGen 根据 project.yml 生成:

xcodegen generate
open MindfulTomato.xcodeproj

选择 MindfulTomato Scheme 和 Apple Watch 真机或模拟器运行。首次进入 App 时允许通知,才能在退回表盘后收到阶段震动提醒。

验证

执行完整的本地验证:

make verify
make simulator

Apple Watch 一键续装

免费 Personal Team 开发签名的描述文件有效期为 7 天。首次真机配对 完成后,在仓库根目录执行以下命令即可续签并覆盖安装:

make install-watch

脚本会优先通过局域网发现已配对的 Apple Watch,自动续签、 覆盖安装并启动 App。如果无线发现失败,将配对的 iPhone 用数据线 连接 Mac 后再执行一次;Apple Watch 本身不需要接线。 如果 CoreDevice 保留了过期隧道,脚本会只刷新当前用户的开发连接服务并 重试安装一次。

如果同时配对了多块手表,可显式指定 CoreDevice 标识符:

WATCH_DEVICE="<device-uuid>" make install-watch

更详细的模拟器、签名和真机步骤见 docs/testing/watch-device-validation.md

产品与技术边界记录在 docs/plans/2026-07-30-mindful-tomato-design.md。 表盘入口与续装方案记录在 docs/plans/2026-07-31-complication-renewal-design.md

About

A mindful Pomodoro timer for Apple Watch, featuring fixed 25/5-minute cycles, haptic reminders, a calm visual timer, restorative break prompts, and simple daily focus statistics.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages