三步让 Home Assistant 自动显示垃圾回收日:Waste Collection Schedule 完整上手流程 三步让 Home Assistant 自动显示垃圾回收日Waste Collection Schedule 完整上手流程【免费下载链接】hacs_waste_collection_scheduleHome Assistant integration framework for (garbage collection) schedules项目地址: https://gitcode.com/GitHub_Trending/ha/hacs_waste_collection_schedule垃圾车哪天来你记不清了吗Waste Collection Schedule 是 Home Assistant 的一个自定义集成专门替你从回收服务商的网站抓垃圾回收日程框架每天自动拉取一次把日程灌进 HA 内置日历再生成一组 sensor 供 Lovelace 卡片显示。它已收录上千个服务商覆盖德、英、奥、加、澳、美等二十多个国家的市政与私营机构。读完这篇你就能把它装进自己的 HA 并跑出第一张X 天后收垃圾的卡片。用 HACS 三步装好 Waste Collection Schedule前提HA 已装好 HACS。装 HACS 之后打开 HACS 的Integrations面板点Explore Download Repositories。搜索Waste Collection Schedule进入条目点Download——文件会落到config/custom_components/。重启 Home Assistant。装完去配置 → 集成 → 添加集成搜索Waste Collection Schedule然后按向导走选国家或 Generic→ 选服务商 → 填参数 → 自定义垃圾类型 → 建 sensor。参数地区、邮编、街道号等具体要填什么以你选中的那个 source 的文档为准——文档链接就在 README 的服务商列表里。没有 HACS 也能手动装把仓库里的 custom_components/waste_collection_schedule 整个目录复制进 HA 的config/custom_components/同样重启。GUI 配不动就写 YAMLsources 与 sensors 的最小配置向导覆盖不了的高级配置直接写configuration.yamlwaste_collection_schedule: sources: - name: west_lindsey_gov_uk # source 名与 source 文件名一致 args: post_code: your_postcode customize: - type: brown bin show: false # 隐藏不关心的类型 - type: green bin alias: Yard Waste # 改成好认的名字 fetch_time: 10:00 sensors: - name: next_collection value_template: in {{value.daysTo}} daysfetch_time是每天几点去抓默认01:00时间值必须带引号原因见下方排查清单。sensors 侧还支持details_format控制 more info 弹窗的展示方式、count、leadtime、types过滤、event_index看第 N 次回收等完整参数表在 安装与配置文档。原理速览一个 source 一条流水线把原理说透只需三句source 是抓取器。每个 service provider 对应一个 source 模块仓库source/目录下约一千个.py文件它把从哪抓、怎么解析封装起来你的args就是喂给它的定位参数。抓取有节奏。框架按fetch_time定时执行fetch_interval_days可把节奏拉长到几天一次random_fetch_time_offset再加随机偏移避免大家同一秒去访问同一网站。出口是日历加 sensor。抓回来的日程自动写入 HA 日历实体sensor 实体则提供value.date日期、value.daysTo几天后、value.types哪些垃圾类型三个变量给你拼模板。不依赖任何外部网站的场景也有兜底ICS / iCal 通用源直接读你手里的 ICS 文件静态源支持你手填日期或按固定周期生成日程。多个 source 想合进一个日历可以用 multiple 包装源。验证配好没有手动触发一次 fetch_data配完后别干等第二天凌晨日历页能看到一条Waste Collection日历实体点进去应有回收事件开发者工具 → 服务调用waste_collection_schedule.fetch_data立即强制刷新看 sensor 状态与daysTo属性是否符合预期有异常就翻 HA 日志里waste_collection_schedule的报错行。配好后出问题的 4 种常见现象现象 1时间被解析成 600报Invalid time specified。原因是 HA 的 YAML 1.1 解析器会把不带引号的10:00当成六十进制数读成600。 处理所有时间一律加引号fetch_time: 10:00、day_switch_time: 18:30。现象 2实体建出来了但日历/sensor 是空的。原因多为 source 参数填错或缺少必需参数数据根本没查回来。 处理重新配置该 source逐个对照 安装文档 里该 source 的参数说明同一服务商多个地区时检查args是否对应你自己的片区。现象 3重启后一直不刷新。原因fetch_time还没到点或服务商网站临时抽风。 处理手动触发waste_collection_schedule.fetch_data验证通路再调大random_fetch_time_offset错峰。现象 4我的服务商不在列表里。先翻 README 确认确实没有再到项目 issue 提 Source Request附上服务商网页和你要查的地址参数。收尾记住这两层配置就够了Waste Collection Schedule 的全部配置就两层sources负责从哪抓、怎么显示sensors负责把数据摆到卡片上。框架每天按fetch_time自动抓取日历实体自动更新sensor 给 Lovelace 喂料——你唯一要做的是选对 source、填对args。遇到问题先查 FAQ日期格式、今天/明天模板、按类型建 sensor 都有现成片段再查对应 source 的文档页GUI 与 YAML 的边界、多 source 合并等细节都在 安装文档 里。【免费下载链接】hacs_waste_collection_scheduleHome Assistant integration framework for (garbage collection) schedules项目地址: https://gitcode.com/GitHub_Trending/ha/hacs_waste_collection_schedule创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考