MedTimer用药数据分析完全指南:图表、表格、日历三视图看懂你的服药依从性
MedTimer用药数据分析完全指南:图表、表格、日历三视图看懂你的服药依从性
MedTimer 是一款免费、开源的 Android 用药提醒应用,内置的「Analysis(数据分析)」屏幕提供图表、表格、日历三种视图,帮你用 30 秒看懂自己的服药依从性:哪些天按时服药、哪些次被跳过、整体完成率是多少。本指南带你逐个看懂三视图,并附赠进阶的药物水平曲线玩法。
如何打开 MedTimer 的数据分析页面
进入应用后,点击底部导航的 Analysis 图标即可打开数据分析页。页面顶部有一排视图切换按钮,在源码 StatisticsScreen.kt 中可以看到共 4 个入口:
- Charts(图表):趋势总览,看依从性最快的方式
- Table(表格):逐条记录明细,支持搜索和排序
- Calendar(日历):按月复盘每天的事件
- Levels(药物水平):进阶曲线视图,估算血药浓度走势 📈
你选择的视图和时间范围会被记住,下次打开自动恢复。
图表视图:一键看懂服药依从性趋势
图表视图是看趋势的主力,由三块内容组成:
| 区块 | 含义 |
|---|---|
| 每日堆叠柱状图 | 每种药物每天「已服用」剂数,按颜色区分,图例显示药名 |
| 「最近 N 天」饼图 | 所选时间段内 已服用 / 已跳过 的占比 |
| 「总计」饼图 | 全部历史 已服用 / 已跳过 的占比,一眼看长期依从性 |
📊 时间范围选择:图表右上角的下拉框可切换 6 档窗口——24 小时、2 天、3 天、7 天、14 天、30 天,定义见 RangeDropdown.kt。选 7 天看一周节奏,选 30 天看月度完成率,最直观。
配色小技巧:如果你在药物设置中为某支药开启了自定义颜色,柱状图会自动使用该颜色,方便多药并服时区分系列。统计口径由 StatisticsProvider.kt 聚合:只统计「已服用」与「已跳过」两种状态的事件。
表格视图:逐条核对每一次服药记录
点击 Table 进入明细表格,每行是一次提醒事件,包含 4 列(定义见 ReminderTable.kt):
- Taken:实际服用时间(跳过的记录显示为「-」)
- Name:药物名称(点击可打开编辑,补记或修正状态)
- Dosage:剂量
- Reminded:提醒触发时间
两个实用操作:
- 顶部搜索框:输入药名即可过滤行,输入即时生效、后台防抖 300ms,历史记录再多也不卡顿(逻辑见 StatisticsScreenViewModel.kt)。
- 点击列头排序:表格支持按任意列排序,比如按 Reminded 倒序查看最近的事件。
⚠️ 注意:应用中的标签过滤器只作用于表格视图,图表与日历始终统计全部药物,避免口径混淆。
日历视图:按月复盘漏服与补服
点击 Calendar 切换到月历模式,默认展示过去 3 个月的数据(见 CalendarContent.kt),有事件的日期会在格子中高亮标记。
点击任意一天,下方卡片列出当天每一条提醒,每条包含:
- 状态图标:✅ 已服用、❌ 已跳过、🔔 已触发未处理(图标映射见 DayEventsCard.kt)
- 时间线:提醒时间 → 实际服用时间(如
8:00 → 8:42,箭头表示延迟了 42 分钟) - 药名 + 剂量:一眼确认是哪种药、吃了多少
💡 复盘技巧:连续几天出现红色「跳过」图标,就是调整提醒时间的信号——把提醒挪到你通常醒着的时间段,比单纯「靠意志力」有效得多。
进阶玩法:Levels 药物水平曲线
如果你在某支药的设置中填写了半衰期和达峰时间,Levels 视图就能基于你的实际服药记录估算药物水平曲线:实线是历史,虚线是未来预测,每个剂量点都有标记。曲线会随当前时间每 5 分钟自动刷新,适合关注「上次服药后药物还剩多少」的场景(估算逻辑见 LevelsPresenter.kt)。
常见问题与数据导出
Q:图表里的百分比怎么算的? 饼图百分比 = 该状态事件数 ÷(已服用 + 已跳过)。「已触发未处理」不计入,所以漏点按钮的当天会在饼图中缺席。
Q:数据存在哪里? 全部数据保存在本机数据库,离线可用、不上传,隐私友好。
Q:如何把记录带给医生? 通过应用菜单可导出 CSV / PDF 格式的用药记录,导出器位于 feature/ui/src/main/java/com/futsch1/medtimer/feature/ui/exporters/。
小结
- 看趋势 → 图表视图 + 30 天范围,饼图即长期依从性
- 查细节 → 表格视图 + 搜索排序,点击药名直接修正
- 找规律 → 日历视图按月扫红标,定位漏服高发日
更多上手细节可参考官方帮助文档 docs/help/review-events.md 与 docs/help/manage-medicines.md;图表库等技术选型背景见 docs/adr/0001-compose-analysis-charting-libraries.md。
