简体中文 | English
一款面向 Android 智能手表的独立番茄钟，使用 Kotlin、Jetpack Compose 和 Wear Compose Material 3 构建。通过专注、短休息和长休息安排学习节奏，无需账号或配套手机应用。
- 完整计时流程：开始、暂停、继续，以及带确认的停止操作；显示剩余时间、本轮进度和轮数。
- 自定义节奏：分别设置学习、短休息和长休息时长，调整长休息间隔，或关闭长休息。
- 后台计时与提醒：前台服务配合系统闹钟处理阶段切换，常驻通知支持暂停、继续和停止，到点发送通知及振动提醒。
- 正在进行的活动：支持的 Wear OS 系统可在表盘显示番茄钟入口，亮屏使用动画图标、息屏使用静态图标；启动器最近任务显示当前阶段与倒计时，点按直接返回计时页。
- 实况动态（Live Updates）：在支持的系统上请求突出显示计时通知，由系统显示实时倒计时；与正在进行的活动、普通通知分别使用独立渠道和开关。
- 手表交互：圆屏进度环、横向分页、滚轮选择器与表冠交互，可配置系统返回和右滑返回行为。
- 屏幕样式：可选择圆屏或方屏；方屏计时页使用顶部留出时钟开口的圆角矩形进度框，沿用阶段配色、大号倒计时和居中操作按钮。列表分别使用带缩放变形的
TransformingLazyColumn和普通LazyColumn；列表底部的返回按钮在圆屏上使用边缘按钮，在方屏上使用居中的小圆形按钮。方屏使用侧边直线滚动指示器和底部横向分页圆点，沿用圆屏指示器的配色、圆角和过渡效果；分页圆点叠放在首页底部，页面内容保持全屏高度。 - 本地保存：使用 DataStore 保存设置和计时状态，支持进程重建后的状态恢复。
- 中英双语与触觉适配：提供中文、英文资源，内置 Google / 小米 Wear 滚动触觉兼容层。
主界面从左到右依次为 计时、计时设置、通用设置，左右滑动即可切换。在计时页点击开始按钮进入学习。
| 设置 | 默认值 | 可选范围 |
|---|---|---|
| 学习时长 | 25 分钟 | 1 分钟至 23 小时 59 分钟 |
| 短休息时长 | 5 分钟 | 1 分钟至 23 小时 59 分钟 |
| 长休息时长 | 15 分钟 | 1 分钟至 23 小时 59 分钟 |
| 长休息轮数 | 每 4 轮学习后 | 2–12 轮，或「总不」 |
| 屏幕样式 | 圆屏 | 圆屏 / 方屏 |
| 方屏计时进度条圆角 | 24 dp | 1–100 dp |
| 通知样式 | 仅正在进行的活动开启 | 实况动态 / 正在进行的活动 / 普通通知，各自独立开关 |
flowchart LR
ready[准备学习] -->|手动开始| focus[专注学习]
focus -->|普通轮次完成| short[短休息]
focus -->|达到长休息轮数| long[长休息]
short -->|休息结束| ready
long -->|休息结束，轮数清零| ready
- 学习结束会自动开始休息；休息结束后等待手动开始下一轮学习。短休息保留累计轮数，长休息结束后清零。
- 在计时页先暂停，再点击停止并确认，会清空本轮进度和累计轮数。通知中的停止操作需要在 10 秒内再次点击确认。
- 时长修改在下一次开始学习时采用；当前学习及其休息仍使用本轮开始时保存的时长。长休息轮数修改会立即参与后续休息类型的判断。
- 设备重启后，应用收到开机广播时会回到待开始状态，保留设置并重置计时进度与轮数。
- 学习和休息计时运行时显示正在进行的活动；暂停或休息结束待开始时移除活动入口，继续计时后恢复，确认停止后随常驻通知一起移除。点按活动入口或计时通知会回到计时页，离开设置编辑器不会保存未确认的草稿。
通用设置提供屏幕样式、权限检查、系统应用设置、返回手势配置和关于页面。在 通用设置 → 屏幕样式 选择圆屏或方屏后，计时页及计时设置、通用设置、屏幕样式、权限和关于页面的列表立即切换，选择会保存到本地。方屏模式下还会显示 计时进度条圆角，使用数字选择器统一调整首页进度框四角半径（1–100 dp，默认 24 dp）；保存后立即生效，取消不保存，切换屏幕样式后仍保留数值。实际半径不超过进度框短边的一半，并保留顶部时钟开口。方屏计时布局适配正方形与长方形屏幕，暂停后仍在原位显示继续和停止按钮；圆屏计时页和时长 / 轮数选择器保持原有布局。在 Android 16 / Wear OS 6（API 36）及以上系统中，右滑返回由「系统返回手势」统一控制；较旧系统可分别设置。
通用设置 → 通知样式提供「实况动态」「正在进行的活动」「普通通知」三个独立开关，默认仅开启正在进行的活动。每种展示使用不同的通知 ID 和同名系统通知渠道；同时开启时分别发送通知，同一条通知不会同时携带实况动态和正在进行的活动数据。开关会立即保存并更新当前通知，不改变本轮时长；不读取或迁移旧版单选项及旧开关值。
前两种展示仅在学习或休息计时运行时附带活动数据。暂停或待开始时撤销正在进行的活动通知，实况动态退回所在渠道的普通计时通知，继续后恢复活动入口。若仅开启正在进行的活动，暂停期间会在「普通通知」渠道保留继续和停止按钮。三个开关全部关闭时，计时服务运行期间仍需保留一条基础服务通知，使用「普通通知」渠道。确认停止会清理三种计时通知；阶段提醒使用独立的「阶段提醒」渠道，不受这三个开关影响。
三种渠道共用当前阶段、倒计时和停止确认状态：运行时显示暂停按钮，暂停时显示固定剩余时间和继续按钮，休息结束后显示待开始和开始按钮。重新打开应用会恢复进行中或已暂停会话的通知，并在从系统设置返回时重新核对通知权限与渠道状态；系统时间变化只校正通知的展示时间，不修改单调时钟截止点。迟到或重复闹钟不会提前结束下一阶段，通知停止确认的 10 秒窗口包含设备休眠时间。
- 面向 Android 智能手表，要求设备具备
android.hardware.type.watch特性；最低系统要求以 应用构建配置 中的minSdk为准。 - 默认生成
armeabi-v7a、arm64-v8a和包含这两种架构的通用 APK。 - 内置的 miwearhaptics 主要面向中国大陆版小米手表 5 / 5 eSIM 的 Wear 触觉适配。默认优先使用可调用的 Google 接口，再回退到小米接口；两者均不可用时不提供对应滚动触觉。
最低 API 配置不代表所有机型、固件均已通过验证。滚动触觉取决于系统提供的 Wear SDK，与阶段完成时的通知振动分别处理。
正在进行的活动通过 Wear OS Ongoing Activity API 提供，入口位置、动画与倒计时展示取决于系统、启动器和表盘支持。活动使用透明背景单色图标，附带返回计时页的无障碍说明；系统使用与应用相同的单调时钟截止时间显示倒计时。阶段切换更新同一个通知 ID，暂停、关闭开关或结束时撤销活动通知，以清除系统缓存的入口。相同状态不会重复发布，避免通知限流丢失更新。未支持该 API 的设备仍可使用普通计时通知；显示活动需要允许应用通知并开启「正在进行的活动」通道。
Wear OS Live Updates 从 Wear OS 7 起提供。实际展示由系统、设备厂商及系统通知设置决定；开启实况动态不代表系统一定会突出显示；系统不支持或未允许时，其渠道显示普通通知，也可独立开启正在进行的活动。倒计时使用系统计时器，无需每秒重新发送通知。
可在 通用设置 → 权限检查 查看状态并打开相应系统设置。
| 权限 | 用途与操作 |
|---|---|
通知 POST_NOTIFICATIONS |
显示计时和阶段提醒；Android 13 / API 33 及以上需要运行时授权，也需保持系统通知开关开启。 |
实况动态 POST_PROMOTED_NOTIFICATIONS |
声明请求突出显示计时通知，不弹出运行时授权框；API 36 及以上在权限页检查系统允许状态并提供系统设置入口，旧系统标为无需申请。Wear 上展示仍需系统支持。 |
精确闹钟 SCHEDULE_EXACT_ALARM |
用于熄屏后的到点处理；Android 12 / API 31 及以上可从权限页进入系统特殊访问设置。 |
前台服务 FOREGROUND_SERVICE、FOREGROUND_SERVICE_SPECIAL_USE |
运行计时服务，由应用清单声明，按系统版本检查。 |
清单还声明开机广播、振动和唤醒锁权限。这些项目不都需要用户手动授权，权限页会区分已开启、待开启和当前系统无需申请。
未获得精确闹钟权限时会回退到非精确闹钟，提醒可能延迟。通知或阶段提醒通道被关闭、振动被禁用时，相应提醒也会受到影响；后台运行还取决于设备的电池管理策略。
计时无需联网，设置和计时状态保存在本地 DataStore。关于页面的网页链接交由外部应用打开。
构建时使用仓库自带的 Gradle Wrapper，应用信息与构建环境要求以以下配置文件为准：
| 配置来源 | 内容 |
|---|---|
| 应用构建配置 | 应用信息、Android SDK 要求、Java / Kotlin 编译目标 |
| 依赖版本目录 | Android Gradle Plugin、Kotlin、Wear Compose 等依赖 |
| Wrapper 配置 | Gradle 发行版 |
| JVM 配置 | Gradle 守护进程所需的 JDK |
根据上述配置准备 JDK 和 Android SDK；安装到设备还需要 SDK Platform-Tools 中的 adb。也可以使用支持项目 AGP 配置的 Android Studio 打开项目。首次构建需要联网下载 Gradle 和依赖，缺失的 JDK 工具链也可能被自动下载。
- 克隆或下载本仓库，保留完整的
miwearhaptics/目录；它通过 Gradle included build 参与插件和运行时依赖解析。 - 在 Android Studio 中配置 SDK，或在根目录的
local.properties中设置sdk.dir为本机 SDK 路径，例如 Windows 的sdk.dir=C:/Android/Sdk。该文件不应提交到版本控制。 - 在项目根目录执行构建。
Windows / PowerShell：
.\gradlew.bat :app:assembleDebugmacOS / Linux：
./gradlew :app:assembleDebug调试 APK 输出到 app/build/outputs/apk/debug/，包括 app-armeabi-v7a-debug.apk、app-arm64-v8a-debug.apk 和 app-universal-debug.apk。
Windows / PowerShell：
.\gradlew.bat :app:assembleReleasemacOS / Linux：
./gradlew :app:assembleReleaseRelease APK 输出到 app/build/outputs/apk/release/，文件名为 WearPomodoro-<版本号>-<ABI>.apk，其中 ABI 为 armeabi-v7a、arm64-v8a 或 universal。
Release 启用 R8 代码优化、混淆和资源缩减。应用不额外整包保留代码，Android 组件入口及反射需求由 AGP 和依赖自带规则处理；自定义规则目录为 app/src/main/keepRules/，由 AGP 自动读取。
Release 仅打包英文默认资源和中文语言资源，并压缩原生库以减小 APK；安装时系统会解压原生库，因此 APK 大小不等于安装占用。构建还排除依赖版本标记和未使用的 Kotlin built-ins 元数据，保留许可证、服务注册与启动性能配置。新增语言时需同步 locales_config.xml 和 Release 的 localeFilters；若以后引入 kotlin-reflect，需取消对 .kotlin_builtins 的排除。
按设备 ABI 选择对应 APK 可进一步减小下载体积；universal 同时包含两种 ARM 架构。未提供签名配置的 Release APK 未签名，安装或分发前需要签名。
将新建的 Git 标签推送到 GitHub 后，发布工作流 会按 CI 的方式构建 Debug APK，自动生成发行说明，并将 APK 附加到对应标签的 GitHub Release；Actions 产物也仅包含 APK。APK 中的应用版本仍由 应用构建配置 决定。
.
├── .github/ # Issue / PR 模板、贡献指南与赞助配置
├── app/
│ ├── build.gradle.kts # Android 应用与 APK 输出配置
│ └── src/main/
│ ├── AndroidManifest.xml
│ ├── java/cc/star0/wear/pomodoro/
│ │ ├── model/ # 设置、状态与纯计时转换逻辑
│ │ ├── data/ # DataStore 持久化
│ │ ├── timer/ # 控制器、前台服务与开机处理
│ │ ├── notifications/ # 常驻通知和阶段提醒
│ │ ├── permissions/ # 权限检查与状态报告
│ │ ├── text/ # UI / 通知共用文本格式化
│ │ └── ui/ # Compose 页面、导航与交互
│ └── res/ # 中英文资源、图标及图片
├── docs/assets/ # README 使用的应用图标
├── miwearhaptics/ # 独立 Gradle 插件与 Java 运行时库
├── gradle/ # 版本目录、Wrapper 与 JVM 配置
├── settings.gradle.kts
├── README.md
├── README_en.md
└── AGENTS.md # 开发与代理协作指南
欢迎提交 Issue 和 Pull Request。问题反馈请附上设备型号、固件 / Android 版本、应用版本、复现步骤及相关日志；界面问题可附截图。
具体流程见 贡献指南，提交 Issue 时可选择问题反馈或功能建议模板。
修改前请阅读 AGENTS.md。修改触觉插件时，同时参考其 维护指南。常用代码检查命令为：
.\gradlew.bat :app:assembleDebug :app:lintDebug
.\gradlew.bat :app:testDebugUnitTestmacOS / Linux 将命令入口换为 ./gradlew。Robolectric 测试覆盖通知开关组合与持久化、独立渠道及活动数据、图标资源、倒计时、阶段切换、暂停恢复和通知清理；系统表盘 / 启动器显示、点按返回计时页，以及涉及计时、通知、手势或触觉的修改，还应在目标设备上验证。功能和构建方式变化时，请同步更新两种语言的 README。
如果这个项目对你有帮助，欢迎通过 Ko-fi 或微信赞赏支持开发。
微信赞赏码：
作者：星澪 Star_ZER0 · 个人主页。本应用由 AI 辅助编写。
- 主项目采用 GNU AGPL v3，详见 LICENSE。
- 内置
miwearhaptics使用其独立的 GNU LGPL v3 许可证，详见 miwearhaptics/LICENSE。