MedTimer用药数据分析完全指南:图表、表格、日历三视图看懂你的服药依从性

原创2026-11-07 10:20:271,950 阅读

MedTimer用药数据分析完全指南:图表、表格、日历三视图看懂你的服药依从性

MedTimer 是一款免费、开源的 Android 用药提醒应用,内置的「Analysis(数据分析)」屏幕提供图表、表格、日历三种视图,帮你用 30 秒看懂自己的服药依从性:哪些天按时服药、哪些次被跳过、整体完成率是多少。本指南带你逐个看懂三视图,并附赠进阶的药物水平曲线玩法。

MedTimer 用药数据分析与提醒功能界面截图:周历概览和药物列表

如何打开 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:提醒触发时间

两个实用操作:

  1. 顶部搜索框:输入药名即可过滤行,输入即时生效、后台防抖 300ms,历史记录再多也不卡顿(逻辑见 StatisticsScreenViewModel.kt)。
  2. 点击列头排序:表格支持按任意列排序,比如按 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。

登录后查看全文
medTimer