戒了吗 - Quit Yet

一个帮助用户戒除不良习惯的打卡 APP

功能特性

核心功能

• ✅ 习惯管理：添加、编辑、删除想要戒除的习惯
• 📅 每日打卡：记录每天的坚持情况
• 🏗️ 像素塔可视化：每坚持一天点亮一个像素块，破戒则塔坍塌
• 🏆 成就徽章系统：根据坚持天数解锁不同徽章（1天、3天、5天、7天、10天、15天、21天、30天、50天、100天）
• 💬 正向反馈：打卡时给予鼓励性消息
• ⏰ 每日提醒：自定义提醒时间，按时打卡
• 📊 统计数据：查看当前连续天数和最长记录

徽章系统

• 🌱 初心者（1天）
• 🌿 坚持者（3天）
• 🍀 决心者（5天）
• ⭐ 勇士（7天）
• 💪 强者（10天）
• 🏆 大师（15天）
• 👑 传奇（21天）
• 💎 不朽（30天）
• 🌟 神话（50天）
• 🔥 永恒（100天）

UI 设计

• 🎨 可爱简洁的界面设计
• 🌈 6种颜色主题可选（粉色、橙色、黄色、绿色、蓝色、紫色）
• 💫 流畅的动画效果
• 📱 Material Design 3 设计规范

技术栈

• 语言：Kotlin
• UI框架：Jetpack Compose
• 架构：MVVM
• 数据库：Room
• 导航：Navigation Compose
• 通知：WorkManager
• 依赖注入：ViewModel

项目结构

app/src/main/java/com/example/quityet/
├── data/                      # 数据层
│   ├── Habit.kt              # 习惯实体
│   ├── CheckIn.kt            # 打卡记录实体
│   ├── Badge.kt              # 徽章数据
│   ├── AppDatabase.kt        # 数据库
│   └── HabitDao.kt           # 数据访问对象
├── repository/               # 仓库层
│   └── HabitRepository.kt    # 习惯仓库
├── viewmodel/                # 视图模型层
│   └── HabitViewModel.kt     # 习惯视图模型
├── ui/
│   ├── screens/              # 界面
│   │   ├── HomeScreen.kt     # 主页
│   │   ├── AddHabitScreen.kt # 添加习惯
│   │   └── HabitDetailScreen.kt # 习惯详情
│   ├── components/           # 组件
│   │   └── CelebrationAnimation.kt # 庆祝动画
│   └── theme/                # 主题
│       ├── Color.kt
│       ├── Theme.kt
│       └── Type.kt
├── notification/             # 通知
│   └── ReminderWorker.kt     # 提醒工作器
├── utils/                    # 工具类
│   ├── DateUtils.kt          # 日期工具
│   └── MotivationalMessages.kt # 激励消息
└── MainActivity.kt           # 主活动

如何运行

前置要求

• Android Studio Hedgehog 或更高版本
• JDK 11 或更高版本
• Android SDK 34 或更高版本

运行步骤

1. 在 Android Studio 中打开项目
2. 等待 Gradle 同步完成
3. 连接 Android 设备或启动模拟器
4. 点击运行按钮

使用说明

1. 添加习惯：点击右下角的 + 按钮，输入习惯名称、描述、提醒时间，选择颜色
2. 每日打卡：进入习惯详情页，点击"今天坚持住了"按钮
3. 查看进度：在详情页查看像素塔的建造进度和解锁的徽章
4. 破戒记录：如果破戒，点击"今天破戒了"按钮，塔会坍塌，重新开始

未来优化方向

• 📊 数据统计图表
• 🎨 更多主题和像素塔样式
• 👥 社交功能（好友互相监督）
• 📝 打卡日记
• 🔔 更智能的提醒系统
• 🏅 更多成就和里程碑
• 📱 桌面小部件
• ☁️ 云端同步

许可证

MIT License