Home Assistant数据管家Recorder历史数据、统计图表与自动备份一次讲透【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/coreHome Assistant 是本地优先、隐私至上的开源智能家居平台而Recorder 组件就是它的数据管家负责记录设备状态历史、生成统计图表并配合Backup 自动备份机制让你的家庭数据既查得到、也丢不了。本文带新手一次看懂 Recorder 历史数据、统计图表与自动备份三大能力。 什么是 Recorder历史数据的基石Home Assistant 中的每个设备灯、传感器、电表都会不断产生状态。Recorder 组件的作用就是把这些瞬时的状态变化持久化存入数据库从而回答这些问题昨晚几点我家断电过这个月客厅温度波动如何上个月总共用了多少度电Recorder 基于 SQLAlchemy 构建默认使用 SQLite也支持 PostgreSQL / MySQL相关定义见 homeassistant/components/recorder/manifest.json。核心调度逻辑在 homeassistant/components/recorder/init.py 中它在系统启动时自动加载无需手动配置。上图中的温度曲线与能源分布卡片正是历史数据在前端呈现的效果——没有 Recorder这些回头看的能力都不存在。 统计图表从原始数据到洞察原始状态记录非常碎真正有价值的是统计结果。Recorder 内置了统计引擎 homeassistant/components/recorder/statistics.py支持按以下维度聚合维度可选项典型用途时间周期5分钟 / 小时 / 天 / 周 / 月 / 年月度电费分析统计类型平均、最大、最小、总和、变化量、末次重置等能耗累计、温度均值你可以通过get_statistics服务在自动化中取数参数定义见 homeassistant/components/recorder/services.yaml。底层查询则封装在 homeassistant/components/recorder/history/init.py 中例如get_significant_states某时段状态变化和state_changes_during_period设备在期间的开关次数。 新手建议把每月1号自动统计上月总用电写成一条自动化数据就能直接推送到你的通知里。 数据清理purge 服务与空间管理历史数据只进不出数据库会越来越胖。Recorder 提供了几种清理手段均在 homeassistant/components/recorder/services.yaml 中声明purge删除 N 天前的全部状态和事件数据keep_days可设 0–365 天purge_entities按实体、域或通配符精准清理例如只删某个调试传感器的记录disable/enable整体暂停/恢复记录。删除后的碎片回收由 homeassistant/components/recorder/purge.py 中的purge_old_data完成repack选项还能重建数据库文件、进一步压缩体积。此外homeassistant/components/recorder/auto_repairs/ 目录下的自动修复机制会持续保证数据的一致性统计出重复数据时也能被自动发现。️ 自动备份数据安全不用愁数据库再稳也怕硬件故障。Home Assistant 内置Backup 集成homeassistant/components/backup/init.py把配置 数据库打包成加密备份文件。关键能力自动备份计划配置完成后按固定周期自动执行last_attempted_automatic_backup等状态记录在 homeassistant/components/backup/config.py 中错过一次还会自动补跑备份代理Agent备份文件可分发到本地目录、NAS 等多种存储目标代理逻辑见 homeassistant/components/backup/agent.py安全打包使用securetar保证备份归档完整可信依赖声明见 homeassistant/components/backup/manifest.json。⚠️ 新手避坑建议至少保留一份站外备份比如同步到 NAS单点存储无法对抗设备本身的故障。接入的设备越多如图中各类品牌与 Matter、Zigbee 等协议值得长期保存的数据就越多——这正是 Recorder Backup 组合的价值所在。⚙️ 数据库选择与系统健康检查SQLite默认零配置、单文件home-assistant_v2.db适合绝大多数用户PostgreSQL / MySQL数据量大、需要多设备读写时更稳两者都有独立的健康检查实现homeassistant/components/recorder/system_health/mysql.py、homeassistant/components/recorder/system_health/postgresql.py。系统健康页面homeassistant/components/recorder/system_health/init.py会展示数据库引擎、运行状态等信息排查数据没记上这类问题时应先从这里看起。✅ 新手速查清单确认 Recorder 已启用默认开启数据库位于配置目录设置合理的数据保留期定期执行purge清理为用电、温度等关键传感器建立统计图表配置 Backup 集成的自动备份并额外保留一份异地副本核心文件速览记录核心homeassistant/components/recorder/init.py统计引擎homeassistant/components/recorder/statistics.py历史查询homeassistant/components/recorder/history/init.py清理逻辑homeassistant/components/recorder/purge.py备份管理homeassistant/components/backup/manager.py把历史数据记下来、把统计图表用起来、把自动备份打开——这三步走完你的 Home Assistant 才算真正具备了数据安全感。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考