Skip to content

mokong/BreakReminder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

健康提醒助手 🔔

一个有趣的 macOS 健康提醒应用,帮助久坐族保持健康!支持自定义提醒功能,让健康管理变得轻松愉快。

应用图标

下载与安装 📥

Mac App Store

App Store 下载

系统要求

  • macOS 12.0+
  • 支持 Apple Silicon (M1/M2/M3) 和 Intel Mac

功能特性 ✨

内置提醒类型

  1. 休息提醒 🚶

    • 定时提醒起来活动,保护眼睛和颈椎
    • 有趣的自嘲文案,让健康提醒不再枯燥
    • 默认间隔:30分钟,建议:20-45分钟
  2. 喝水提醒 💧

    • 定时提醒补充水分,保持身体健康
    • 幽默的提醒语,顺便让你起来活动
    • 默认间隔:45分钟,建议:30-60分钟
  3. 提肛提醒 🧘

    • 久坐族的秘密修炼,预防痔疮问题
    • 可以偷偷做的运动,没人知道你在锻炼
    • 默认间隔:60分钟,建议:45-90分钟

注意

  • ✅ 内置提醒可以删除(删除后下次启动不再显示)
  • ✅ 可通过"恢复默认提醒"按钮恢复
  • ✅ 每种提醒可独立开关,灵活组合使用

🎨 自定义提醒(新功能)

突破内置限制,打造专属健康提醒:

  • 无限数量:创建任意数量的个性化提醒
  • 🎯 自定义名称:根据需求命名(如:眼保健操、站立办公)
  • 🎨 丰富图标:从 32+ 个 SF Symbols 图标中选择
  • 🌈 多彩主题:13 种精选颜色,视觉区分不同类型
  • ⏱️ 灵活间隔:5-180 分钟自定义,满足各种场景
  • 💬 个性文案:支持多条文案随机显示,告别单调
  • ✏️ 随时编辑:修改名称、图标、颜色、间隔和文案
  • 🗑️ 自由管理:删除不需要的提醒(内置提醒除外)

界面特性

  • 🎨 现代设计:渐变背景、卡片式布局、毛玻璃效果
  • 🎯 直观控制:每个提醒独立开关,状态一目了然
  • ⏱️ 精准调节:滑块调整间隔,支持 5 分钟步长
  • 🔔 系统通知:原生通知体验,支持随机文案
  • 📍 MenuBar 集成:可选常驻图标,随时查看和控制
  • 💾 自动保存:所有设置自动持久化,重启不丢失
  • 🎭 流畅动画:响应式交互动画,提升使用体验

项目结构 📁

BreakReminder/
├── Models/                          # 数据模型
│   ├── ReminderType.swift          # 提醒类型枚举(内置)
│   ├── ReminderSettings.swift      # 提醒设置模型(旧版)
│   └── CustomReminder.swift        # 自定义提醒模型(新)
├── ViewModels/                      # 视图模型
│   ├── ReminderManager.swift       # 提醒管理器(旧版)
│   ├── CustomReminderManager.swift # 自定义提醒管理器(新)
│   └── MenuBarManager.swift        # 菜单栏管理器
├── Views/                           # 视图
│   ├── ContentView.swift           # 主视图(旧版)
│   ├── MainContentView.swift       # 主视图(新)
│   ├── ReminderCardView.swift      # 提醒卡片组件(旧版)
│   ├── CustomReminderCardView.swift # 自定义提醒卡片(新)
│   ├── AddReminderView.swift       # 添加/编辑提醒视图
│   ├── IconPickerView.swift        # 图标选择器
│   └── ColorPickerView.swift       # 颜色选择器
└── BreakReminderApp.swift          # 应用入口

应用截图 📸

主界面

主界面 简洁现代的界面设计,渐变背景配合卡片式布局,视觉效果舒适

自定义提醒创建

自定义提醒 直观的自定义提醒创建界面,丰富的图标和颜色选择器,实时预览效果

菜单栏集成

菜单栏 便捷的菜单栏控制,实时状态显示和快速操作,支持键盘快捷键

技术栈 🛠️

  • SwiftUI
  • UserNotifications
  • Combine
  • AppKit (MenuBar)

功能对比 📊

内置提醒 vs 自定义提醒

特性 内置提醒 自定义提醒
数量 固定 3 个 无限制
名称 固定 完全自定义
图标 固定 32+ 种可选
颜色 固定 13 种精选
间隔 可调整 完全自定义
文案 固定 10 条 完全自定义
编辑 仅间隔 全部可编辑
删除 不可删除 可删除

有趣的文案示例 😄

休息提醒

  • "该休息啦!别卷了,眼睛都要瞎了 👀"
  • "起来动动吧!久坐会变成沙发土豆的 🥔"
  • "该停下了!再不休息就要原地爆炸了 💥"

喝水提醒

  • "该喝水啦!别等渴了才想起来 💧"
  • "喝点水吧!你的肾在呼唤你 🫘"
  • "该喝水了!你的膀胱需要锻炼 🫧"

提肛提醒

  • "提肛时间!久坐族的秘密修炼 🧘"
  • "该提肛啦!这是你能偷偷做的运动 🤫"
  • "该提肛啦!菊花一紧,精神百倍 🌸"

使用说明 📖

基础使用

  1. 启动应用
  2. 选择需要的提醒类型(可多选)
  3. 调整提醒间隔
  4. 点击"开始提醒"
  5. 应用会在后台定时发送通知

重要提示

  • ✅ 关闭窗口(⌘W)不会退出应用,提醒继续运行
  • ✅ 应用会在后台持续运行,确保提醒正常工作
  • ✅ 可以通过 MenuBar 图标重新打开窗口
  • ⚠️ 只有通过"退出"(⌘Q)或 MenuBar 的"退出"才会真正退出应用

自定义提醒

  1. 点击"添加自定义提醒"按钮
  2. 填写提醒名称(例如:眼保健操)
  3. 选择图标(32+ 个可选)
  4. 选择颜色(13 种可选)
  5. 设置提醒间隔(5-180分钟)
  6. 输入提醒文案(每行一条,随机显示)
  7. 点击"创建"保存

编辑提醒

  • 内置提醒:只能调整间隔和开关
  • 自定义提醒:点击编辑按钮可修改所有设置

删除提醒

  • 内置提醒:不可删除
  • 自定义提醒:点击删除按钮即可删除

使用建议 💡

推荐配置

办公室打工人

  • ✅ 休息提醒:30分钟
  • ✅ 喝水提醒:45分钟
  • ✅ 提肛提醒:60分钟

程序员/设计师

  • ✅ 休息提醒:25分钟(番茄工作法)
  • ✅ 喝水提醒:50分钟
  • ✅ 提肛提醒:90分钟

学生党

  • ✅ 休息提醒:45分钟
  • ✅ 喝水提醒:60分钟
  • ⚪ 提肛提醒:可选

使用技巧

  1. 不要设置太短的间隔

    • 太频繁的提醒会打断工作流
    • 建议至少20分钟以上
  2. 根据工作性质调整

    • 需要高度集中的工作:间隔长一些
    • 轻松的工作:间隔短一些
  3. 善用菜单栏

    • 关闭主窗口,让应用在后台运行
    • 通过菜单栏快速控制
  4. 临时关闭

    • 开会或演示时,可以快速停止提醒
    • 结束后记得重新开启

健康小贴士 🌟

  • 💪 每小时至少站起来活动5分钟
  • 💧 每天喝8杯水(约2升)
  • 👀 每20分钟看20英尺外的物体20秒(20-20-20法则)
  • 🧘 提肛运动可以预防痔疮和改善盆底肌
  • 🏃 久坐是新时代的吸烟,多动动!

参与贡献 🤝

欢迎贡献代码!请遵循以下步骤:

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

许可证 📄

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

致谢 🙏

感谢所有为这个项目做出贡献的开发者!特别感谢:

  • SwiftUI 和 macOS 开发社区的优秀文档
  • 所有提供反馈和建议的用户
  • 让健康提醒变得有趣的创意灵感

让健康成为一种习惯,让工作更有活力! 💪

我的其他应用 📱

我也开发了其他实用的macOS应用,欢迎下载体验:

MouseGesture

Mac App Store 鼠标手势控制工具,让操作更高效

GenerateQR-Extension

Mac App Store 二维码生成扩展,快速创建各类二维码

JSON格式化

Mac App Store JSON数据格式化工具,开发调试好帮手

BarkPush

Mac App Store 消息推送服务工具,及时获取重要通知

About

Mac APP Break Reminder

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages