🌙 夜律 NightHabit
一款由 DeepSeek Harness 生成的 Android 极简习惯养成应用,适用于安卓11和15
「记录微小改变,构建长期自律。」
✨ 项目缘起
本项目是借助 DeepSeek 全新发布的 Harness 智能体工作台 从零构建的 Android 原生应用:
- 输入一份接近 PRD 级别的《NightHabit 极简习惯养成 App UI/UX 详细设计规范 v2.0》,由 AI Agent 自主完成 需求拆解 → 架构设计 → 全量编码 → 离线编译 → 缺陷审查 → 实机验证 的完整闭环;
- 项目全程在 完全离线 的沙箱环境中编译通过(JDK 17 + Gradle 8.8 + 本地依赖缓存),并借助 Android 模拟器完成真实运行验证;
- 开发过程中由 AI 审查员发现并修复了 6 处真实运行时缺陷(闹钟续订、跨午夜日期、编辑竞态、备份原子性等),随后又经实机交互测试发现并修复了 1 处导航缺陷,最终成功完成。








通过网盘分享的文件:夜律NightHabit-v1.1.0.apk
链接: https://pan.baidu.com/s/1Z5JiEVJTOPne0ERBrQsqzw 提取码: e98t
🎯 产品理念
| 理念 | 落地方式 |
|---|---|
| 极简 | 首页只做三件事:今天完成多少 → 还差什么 → 点击完成 |
| 沉浸 | 打开不是"管理任务",而是"完成今天的小目标" |
| 私密 | 数据 100% 存于本机 Room 数据库,无服务器、无账号、无网络权限 |
🧩 功能总览
🏠 首页 Dashboard
- 问候 Header(按时段双语问候 + 日期 + 品牌 Logo 头像)
- 今日完成率渐变圆环(280dp,1000ms FastOutSlowIn 动画,主题色辉光)
- 每日一句名言卡(按日期轮换 / 可置顶固定)
- 习惯卡片列表:52dp 图标、连续天数 🔥、6dp 圆角进度条、完成粒子动画
- 快速添加 FAB(主题色光晕)
➕ 创建 / 编辑习惯
- 20 个 Emoji 图标、名称、8 色强调色
- 三种类型:普通(每天一次)/ 数量(目标次数)/ 时间(累计分钟)
- 周期:每天 / 工作日 / 周末 / 自定义周几
- 每日提醒(AlarmManager 精确调度,支持开机恢复)
📅 日历
- 月视图:44dp 单元格、完成圆点、连续完成高亮、今日描边
- 点击日期弹出 Bottom Sheet 详情(完成列表 + 完成率)
- 名言库入口:内置 24 条习惯名言,支持新增 / 删除 / 置顶
📊 统计
- 连续坚持天数 Hero 卡(渐变背景)
- 2×2 数据网格:完成次数 / 专注时长 / 最佳连续 / 近 7 日完成率
- 成长等级:Lv + 称号 + XP 进度(完成×20 + 专注分钟)
- 近 14 天完成趋势柱状图(Canvas 绘制)、习惯排行
🎯 专注模式(全屏)
- 300dp 计时圆环 + 动态呼吸渐变背景 + 星空氛围
- 番茄钟状态机:工作 / 休息、开始 / 暂停 / 重置 / 跳过
- 程序化生成的白噪音:白 / 粉红 / 布朗 / 雨声(AudioTrack 无缝循环,零音频资源)
- 专注记录入本地库,按实际流逝时长记账
⚙️ 设置
- 7 套幽暗主题实时切换(DataStore 持久化)
- 习惯提醒总开关 + 默认提醒时间
- JSON 备份 / 恢复(SAF 免存储权限、原子事务)与一键清空
- 关于页(品牌 Logo + 隐私声明)
🎨 7 套幽暗主题
| 主题 | 主色 | 设计说明 |
|---|---|---|
| 🌌 暗夜科技(默认) | #8B5CF6 | 深色基底 · 紫电科技感 |
| 🌊 深空幽蓝 | #3B82F6 | 深海蓝调 · 沉浸专注 |
| 🌆 暮光紫调 | #A78BFA | 暮色紫粉 · 温柔静谧 |
| 🌲 深林绿意 | #2F9E63 | 墨绿主色 · 自然沉静 |
| 🕯️ 烛光暖橙 | #E08A3C | 暖橙烛光 · 温馨氛围 |
| 🌹 暗夜玫瑰 | #F43F5E | 暗红玫瑰 · 神秘优雅 |
| ⬛ 纯黑 OLED | #8B5CF6 | 纯黑省电 · 极致简约 |
其中「深林绿意」「烛光暖橙」的配色与圆环主色,通过图像分析(OCR + 像素色彩采样)取自设计师提供的《多主题 UI 设计展示图》。
🛠 技术栈
Kotlin 2.0.20 · Jetpack Compose (BOM 2024.09) · Material3 1.3.0
MVVM (ViewModel + StateFlow) · Room 2.6.1 (KSP) · DataStore
Navigation Compose · AlarmManager · AudioTrack · Gson
手动依赖注入(AppContainer,零网络零注解处理)
| 模块 | 说明 |
|---|---|
data/db | Room 实体 / DAO / 迁移(v1→v2 新增名言表) |
data/repository | 习惯 / 专注仓储,应做日连续天数算法 |
data/prefs | DataStore 设置(主题 / 提醒 / 白噪音 / 时长) |
data/backup | Gson 原子备份 / 恢复 / 清空 |
reminder/ | AlarmManager 每日提醒 + 开机恢复 |
focus/ | 程序化白噪音播放器(无缝循环 + 交叉淡化) |
ui/theme | 7 主题 Design System(Color / Theme / Type / Shapes) |
ui/components | 圆环 / 习惯卡 / 粒子爆发 / 星空 / 品牌 Logo |
📦 构建与安装
版本信息
| 项 | 值 |
|---|---|
| 版本 | v1.1.0(versionCode 2) |
| 包名 | com.nighthabit.app |
| minSdk / targetSdk | 26 / 35(Android 8.0+,适配 Android 15,兼容 Android 11) |
| 产物 | release(11.4MB,正式签名)/ debug |
快速构建
cd NightHabit
./gradlew :app:assembleRelease # 或 assembleDebug
直接安装
- 将
夜律NightHabit-v1.1.0-release.apk传到手机点击安装(允许"未知来源"即可) - 或
adb install 夜律NightHabit-v1.1.0-release.apk
🧪 质量验证
- ✅ 全量 离线编译通过(assembleDebug / assembleRelease,无网络依赖)
- ✅ 模拟器实机运行验证:创建习惯 → 打卡完成(100% 圆环)→ 日历 / 统计 / 专注 / 设置全流程走通
- ✅ 主题切换持久化验证(DataStore)、名言置顶验证、备份恢复原子性验证
- ✅ AI 静态审查:修复提醒不续订 / 跨午夜日期冻结 / 编辑保存竞态 / 导入毒化数据库 / 跳过虚增时长 / 删除未取消闹钟 6 项缺陷 + 实机发现导航入口缺陷 1 项
- ✅ 数据库迁移验证(v1→v2 保留原数据)
🔐 隐私承诺
✔ 完全离线 ✔ 无账号体系 ✔ 无广告 SDK
✔ 无网络权限 ✔ 无埋点统计 ✔ 数据仅存本机
🌙 夜律 · 由 DeepSeek Harness 生成 · Made for night owls

1万+

被折叠的 条评论
为什么被折叠?



