面向自主学习的离线 Android 学习监督、专注计时与任务计划应用
StudyGuard 将学习任务计划、专注计时、应用使用提醒与学习统计整合在一款原生 Android 应用中。支持纸书学习与手机学习双模式,数据默认保存在本机,无账号、无广告,学习功能可离线使用。
Note
当前正式版为 0.3.8,支持 Android 8.0 及以上。计划与总结使用本地规则。0.3.7-dev 在 Android 16 官方模拟器已验证 45 分钟锁屏计时,厂商真机的耗电和后台行为仍待实测。
- 双模式学习计时:支持手动开始、暂停与恢复。纸书模式允许锁屏持续计时;手机模式仅累计本应用及自选学习应用白名单内的有效时间。
- 计划与任务管理:支持创建、编辑、改期与完成学习任务;可基于本地规则生成未来最多 7 天的计划草案,支持通过日历选择日期。
- 分段学习支持从计划页补做往期任务。每段结束后可选择「下次继续」或「任务已完成」,累计时长和待确认状态会保存。
- 减少分心提醒:自主配置受限娱乐应用与学习白名单。基础模式通过系统使用情况监测提醒,也可自愿开启无障碍增强;始终放行通信、桌面、系统设置与卸载界面。
- 学习进度与统计:按有效学习时间触发进度检查,提供科目时长、近 7/30 日趋势、学习打卡与本地日总结。
- JSON 本地备份与恢复:在设置中导出完整学习数据为 JSON,恢复时校验格式、关联关系与校验和,确认后覆盖恢复。
- 随时自由退出:提前结束无需填写原因,紧急解除无需密码或倒计时等待。
计时以可确认的观察区间为准。进程中断、长观测缺口与明显时钟跳变不会补计未知时间;记录时长仅反映应用使用/计时状态,普通应用的应用限制能力受 Android 系统机制约束。
- 前往 GitHub Releases 下载
StudyGuard-0.3.8-release.apk(debug与androidTest包仅用于开发测试,日常试用请选择release)。 - 在手机文件管理器中打开 APK,按系统提示授权并安装。
- 应用包名为
io.studyguard.app,不会覆盖上游 FocusForcePlus。本版沿用 StudyGuard 开发证书,可直接覆盖同签名旧开发版;证书与安装包校验值见验证报告与 Release 中的SHA256SUMS.txt。自行构建的包签名不同,升级前请先在设置中导出备份。 - 从 0.3.8 起,可在「设置 → 应用更新」检查、下载并通过系统安装器更新。默认自动换源,也可指定 GitHub 官方、gh-proxy.com 或 ghfast.top。旧版需先手动覆盖安装一次。
| 权限 | 用途 | 是否必需 |
|---|---|---|
| 使用情况访问 | 识别前台应用并累计受监督学习时长 | 开始监督前开启 |
| 通知权限 | 显示计时运行状态与分心提醒 | 按需开启 |
| 无障碍服务 | 仅读取窗口包名以增强提醒,不读取文字、输入或页面内容 | 可选 |
| 精确闹钟 / 勿扰访问 | 沿用原版工具的可选提醒辅助能力 | 可选 |
- 仅在手动检查或下载更新时联网。学习记录保存在本机,并排除系统云备份与设备转移。
- 用户主动导出的 JSON 备份文件未加密;若保存至云盘目录,可能由对应文档提供方同步。卸载会删除应用内部数据,详见 隐私政策。
- 技术栈:Kotlin
2.2.10· Jetpack Compose · Material 3 · Room · Gradle9.3.1· AGP9.1.1 - 环境要求:JDK
21· Android SDK Platform36.1(minSdk 26/targetSdk 36)
git clone https://github.com/vanvan-program/StudyGuard.git
cd StudyGuard
./gradlew :app:assembleDebug :app:testDebugUnitTest :app:lintDebug --max-workers=1- Windows 可使用
gradlew.bat或scripts/Build-StudyGuard.ps1;如遇中文路径编码问题请见 BUILD-ENCODING.md。 - Release 构建启用 R8 与资源收缩;自行签名可通过环境变量配置
KEYSTORE_FILE、KEYSTORE_PASSWORD、KEY_ALIAS、KEY_PASSWORD(仓库不含私钥)。
| 验证项 | 结果 |
|---|---|
| JVM 单元测试 | 184 项通过(0 失败 / 0 跳过) |
| Android 16 设备回归 | 38 项通过 |
| Release 实测 | 锁屏计时 45 分钟,监督中断 0 次。已验证按科目查看较早事件和重启后确认任务 |
| 覆盖升级 | 从 0.3.6-dev 升级后,三条测试任务保留 |
| Lint Debug | 0 errors / 31 warnings / 10 hints |
完整验证证据与已知待处理项见 VALIDATION-0.3.7-dev.md。
- 本项目基于 karOS555/FocusForcePlus(固定上游提交
f2987bc)二次开发,保留上游版权及 GNU GPLv3 协议。 - 相关文档:上游原始说明 · StudyGuard 修改记录 · 第三方组件与许可证声明 · 文档目录。