偷偷时间

把时间留给重要的事。

一款本地优先、纸墨风格的 Android 学习计时与统计工具。

下载体验

直接下载偷偷时间 v0.4.0 APK

也可以从仓库内的 releases/ 目录查看同一份安装包。

如果聊天应用的内置浏览器不支持 APK 下载，请复制下载链接到手机系统浏览器打开。

当前提供的是 Debug 测试包，适合直接安装体验。最低支持 Android 8.0（API 26）。安装时如果系统提示“未知来源应用”，请只为当前文件管理器临时授权。

• 版本：0.4.0
• 包名：com.example.studenttimetotalnote
• SHA-256：84CF256A9988088270B64FBA32123AE5B0E1EBB9E0A5C4A4F6659A56684E9F07

界面预览

当前图片是已经确认并落地到应用中的界面设计预览；由于发布整理时没有可用的 ADB 设备或模拟器，因此不将其冒充为真机截图。

功能

• 点击“开始学习”，填写本次学习内容后立即计时。
• 计时状态会保存在本机，即使应用退到后台或重新打开也能继续恢复。
• 结束计时后自动保存本次学习记录。
• 统计页默认优先展示今日；周、月、年度和“使用以来”统计收纳在右上角设置菜单中。
• 日、周、月、年均可通过左右按钮切换周期，并明确显示具体日期、自然周范围、月份或年份。
• 周、月默认分别进入上一完整自然周和上一完整自然月；进入当前周期后实时累计。
• 趋势图会跟随选中的日、周、月或年更新，年度统计展示 12 个月趋势。
• “使用以来”汇总设备中现存的全部学习时间，不受日期、自然周、月份或年份限制。
• 完全相同的备注会合并统计，并按累计学习时长从高到低排列。
• 点击某个备注可查看其中的每次学习记录，并可单独删除指定记录；删除后对应时间会从各周期统计中扣除。
• 没有数据时保持克制的空状态，不展示无意义的统计内容。

数据与隐私

偷偷时间不要求账号，也不申请联网权限。计时状态和学习记录均通过 Room 保存在设备本地。卸载应用或清除应用数据会删除这些记录；当前版本暂不提供云同步与导出功能。

技术栈

• Kotlin 2.1.20
• Jetpack Compose + Material 3
• Room
• ViewModel + Kotlin Coroutines
• Android Gradle Plugin 8.9.2
• Gradle 8.11.1
• JDK 17

本地构建

1. 使用 Android Studio 打开项目根目录。
2. 确保已安装 JDK 17 与 Android SDK 36。
3. 等待 Gradle 同步完成。
4. 在项目根目录执行：

.\gradlew.bat :app:testDebugUnitTest :app:lintDebug :app:assembleDebug

生成的 APK 位于：

app/build/outputs/apk/debug/app-debug.apk

项目的 Gradle Wrapper 默认使用腾讯镜像下载 Gradle 8.11.1，便于网络受限环境完成首次同步。

项目结构

app/src/main/
├─ java/.../data/          # Room 数据库与本地存储
├─ java/.../domain/        # 计时、周期与聚合规则
├─ java/.../ui/home/       # 计时首页
├─ java/.../ui/statistics/ # 统计与记录管理
└─ res/                    # 图标、文字与 Android 资源

验证状态

• 21 项 JVM 单元测试通过。
• Android Lint（Debug）通过。
• Debug APK 构建通过。
• AndroidTest APK 编译通过；本次构建时未连接测试设备，因此未执行会影响设备应用数据的仪器测试。

当前限制

• APK 为 Debug 测试签名，不是应用商店正式签名版本。
• 数据只保存在当前设备，暂不支持备份、导出或跨设备同步。
• 项目暂未声明开源许可证；未经许可不自动获得复制、修改或再分发授权。