Skip to content

mokong/BreakReminder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 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

13 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages