用时记是一款 Android 10 及以上版本的手机应用使用时间统计工具。它读取系统的应用使用记录，在本地计算并保存你每天在哪些应用上花了多少时间，生成小时、日、周、月的趋势图表和应用排行，帮助你了解自己的手机使用情况，例如每天主要把时间花在了哪些应用、过去一周或一个月的使用变化。
记录默认保存在手机本机，不需要注册账号。0.3.19 起可自愿开启 WebDAV 加密同步，手机统计供 Hindsight Mobile 修改版查看；0.4.0 起还支持电脑应用用时加密同步。电脑数据显示默认关闭，只有在设置中开启「显示电脑数据」后才显示并拉取电脑记录。未开启云端同步时不执行同步请求。应用提供本地完整备份导出导入，换机或卸载前请先导出备份。
当前开发版本：0.4.1，versionCode 30，数据库版本 6。已正式发布的安装包从 Releases 下载。
完整版本历史见 更新记录，覆盖 0.1.0 至 0.4.1。
本版变化见 发布说明，桌面配对方式见 同步说明，自动发布首次配置见 发布与升级验收。
- 主要使用时间、屏幕可见时间两种统计口径，以及旧版历史，在设置的“记录与统计”中选择。
- 默认展示候选估计，可在设置中计入已确认时间；无法确定与未闭合情况持续显示。
- 按小时、日、月汇总，支持趋势、应用排行、搜索、详情和周期对比。
- 手动应用分类与分类统计、当天使用时间线、月历与年度热力图，以及用时速览、今日概览、应用排行、分类分布、七日趋势五款桌面小组件。
- 电脑用时：默认隐藏且不拉取电脑数据；在设置中开启「显示电脑数据」后，从 Hindsight 修改版加密拉取桌面应用汇总，独立展示应用排行、分类分布和最近七天，不与手机用时相加。
- 完整备份 v3 可选保存应用分类，兼容旧备份；分类调整不改写原始使用事件。
- 手机端采用低饱和薰衣草紫主题、描边卡片、下划线视图切换和悬浮底栏；宽屏使用侧边导航。界面只调整展示和交互，不改变统计口径。
- 有容量限制的报表缓存，数据变化后失效；图表样式、搜索和排序复用已加载的结果。
- 保留至少最近90个完整日期及今天的本机明细，长期保存每日双指标汇总；清理条件不足时继续保留明细。
- 增量补记、失败重试、重启和更新后调度补记；清理前先提交并核验长期汇总。
- 本地 JSON/gzip 备份v3导入导出，包含长期汇总；兼容v1/v2导入；CSV导出、数据库恢复保护和隔离的示例模式。
0.3.12引入数据库迁移和受保护的清理逻辑，新增设备测试已编译但尚未执行，物理断电也未验收。完整修复、容量实测与限制见 数据库说明。升级前请导出备份；已经压缩的旧日期只保留原记录时区的每日总量，无法精确恢复旧小时或任意时区的部分日期。
主要使用时间：估计你真正把时间花在了哪个应用上。它根据可获得的应用生命周期和窗口焦点证据归属，第三方应用的生命周期通常只能支持推断；证据不足或多窗口冲突时保留未知状态。
屏幕可见时间：按应用累计处于可见状态的时间，多个应用可能重叠（例如分屏或画中画），不能与系统亮屏时长直接等同。
已确认、候选估计、无法确定与未闭合状态表示证据质量，不代表系统提供了完整的历史记录。缺少闭合、明确失焦、时钟不连续或实例身份冲突的区间保留未知，不把未知当作零使用；候选估计不能与未知简单相加。
0.3.11 会保留原始事件并重算派生结果，因此累计可能比旧版更保守。双指标边界与验证结果见 修复说明。
应用未运行时，Android 仍可能保留近期使用事件，后续可以补记；事件保留期限和后台任务执行受到系统限制。首次安装、权限中断或长期未补记可能存在无法恢复的缺口。
需要 JDK 21、Android SDK 37 和 Build Tools。配置 JAVA_HOME、ANDROID_HOME；也可通过本地 local.properties 配置 SDK 路径，该文件不得提交。
Windows PowerShell：
./build-local.ps1
python tools/verify_dual_storage.py脚本构建 Preview APK、编译并运行统计核心与应用 JVM 回归测试，并执行 Lint。SQLite 检查脚本运行迁移和一致性检查；python tools/audit_history_storage.py另外运行历史迁移入口、强制退出恢复、索引边界和十年合成容量测试。Android 仪器测试需要独立测试设备或模拟器，不应对个人日常数据库执行测试。
其他平台可使用 Wrapper：
sh gradlew :app:assemblePreview :core:test :app:testDebugUnitTest :app:lintDebug
python3 tools/verify_dual_storage.py输出位于 app/build/outputs/apk/preview/。Preview 使用本机生成的开发签名，不保证可以覆盖其他签名的安装包。Release 构建未配置签名，发布者需自行安全配置。
应用无需注册账号。使用记录默认保存在本机；自愿开启 WebDAV 后上传端到端加密的每日双指标统计和设备清单。同步不包含原始事件、诊断日志或截图，不替代完整备份；卸载前应导出完整备份。
Git 源码树仅包含源码、数据库结构、合成测试和必要文档，不包含个人使用记录、个人手机信息、手机截图、导出备份、数据库实例、诊断日志、签名密钥或历史安装包。数据库结构 JSON 只描述表和字段，不包含数据库记录。测试使用人工构造的数据，示例模式使用程序生成的数据。Release 附件提供单独审查的安装包、源码压缩包及 SHA-256 校验文件。
详见 发布内容规则。
本项目自行编写的源码采用 GNU General Public License v3.0（GPL-3.0-only），完整条款见 LICENSE。
Copyright (C) 2026 UsageTime contributors.
第三方依赖和 Gradle Wrapper 保留各自的许可证及版权声明。