3步把垃圾收运日程搬进 Home AssistantWaste Collection Schedule 完整上手指南【免费下载链接】hacs_waste_collection_scheduleHome Assistant integration framework for (garbage collection) schedules项目地址: https://gitcode.com/GitHub_Trending/ha/hacs_waste_collection_schedule你有没有过这种经历忘了哪天收垃圾桶被扣上一张罚单或者大清早被收运车按喇叭提醒Home Assistant 集成框架 Waste Collection Schedule 专门解决这个问题它按天自动抓取你所在地区的垃圾收运日程直接填进 HA 内置日历还能生成下次收运日期还剩几天这类传感器让你一开门就能在仪表盘上看见答案。全文按找数据源 → 装组件 → 配实体三步走配完重启一次 HA 即可生效。它是怎么工作的先搞懂 source 和 sensor 两个概念Waste Collection Schedule 内部由两类配置组成理解这两个词后面的配置就不会迷糊source数据源负责从服务商的网页或 ICS 文件一种通用的日历文件格式里把日程抓出来。它需要你的地址、街道、地区等参数相当于告诉系统去哪查、查谁的。sensor传感器负责把抓到的数据变成 HA 里的实体比如显示垃圾类别、下次收运日期、距今天数。你可以在卡片或弹窗里自由定制它的展示方式。集成会在每天固定时间默认凌晨 1 点见 doc/installation.md向服务商轮询一次数据所以不需要你手动刷新。第一步找到你的垃圾收运服务商目的确认你的地区在支持列表里拿到 source 的名字和参数说明。操作打开仓库的 README.md 翻到 Supported Service Providers 一节按国家找到你所在地区的条目点进对应文档页查看该 source 需要哪些args参数。仓库里目前有 1000 多个 source 文档custom_components/waste_collection_schedule/waste_collection_schedule/覆盖德国、英国、奥地利、澳大利亚、法国、加拿大等地区。找不到完全对口的条目也别急下面这张表列了几条通用退路你的情况可用的 source说明文档服务商提供 ICS/日历订阅链接icsdoc/source/ics.md收运日期固定、无电子来源staticdoc/source/static.md想同时抓多个服务商合到一个日历multipledoc/source/multiple.md预期结果你手上有确定的 source 名称如muellmax_de、该 source 的参数清单以及你自己的地区/街道取值。第二步安装组件目的把集成装进 Home Assistant。操作推荐走 HACSHA 的社区插件商店。安装好 HACS 后在 HACS 的 Integrations 面板点 Explore Download Repositories搜索Waste Collection Schedule下载即可文件会自动落到config/custom_components/目录。没有 HACS 也可以手动安装把仓库里的custom_components/waste_collection_schedule文件夹整个复制到你的 HAconfig/custom_components/目录下参考 doc/installation.md 的 Manual Installation 一节。预期结果重启 HA 后在 设置 → 设备与服务 → 添加集成 里能搜到Waste Collection Schedule。第三步配置数据源和传感器目的让 HA 知道去哪抓日程、以什么形式展示。2.0 版本起推荐直接在图形界面里配置添加集成后依次选择国家、服务商、填写地址参数、挑选要显示的垃圾类型一路点下去即可。偏好 YAML 的用户则把下面这段写进configuration.yaml其中args换成你的 source 文档要求的参数waste_collection_schedule: sources: - name: muellmax_de args: service: His mm_frm_str_sel: 你的街道名 sensors: - name: next_collection多服务商场景可以在sources下加多个条目也可以用 multiple 包装源 把它们合并进同一个日历实体。预期结果重启 HA 后日历里出现一个名为 Waste Collection 的日历实体列表里多出一个 Waste Collection Schedule 日历实体。验证效果日历、实体与弹窗目的确认数据真的抓到了而不只是配置没报错。操作按下面三处检查打开日历视图确认本月各日期上标出了 Garbage、Recycle 等收运事件进入 设置 → 实体按 Waste Collection Schedule 过滤看日历实体状态是否为可用点开传感器实体的 more info 弹窗查看 upcoming 列表。如果当天没数据在开发者工具里手动调用waste_collection_schedule.fetch_data服务强制刷新一次。预期结果日历上有未来几周的收运点传感器状态显示出最近一次的垃圾类别和日期。实体列表里集成一栏应显示 Waste Collection Schedule效果类似下图常见问题排查source 实体状态为 unknown 或没有数据先确认 source 名称拼写与文档一致不带.py再核对args取值——很多 source 要求街道名与服务商下拉框里的写法逐字一致。仍然抓不到时用开发者工具里的waste_collection_schedule.fetch_data手动触发一次然后看 HA 日志里该次请求的报错。时间参数报Invalid time specified之类的错这是 YAML 1.1 的经典坑不引号的fetch_time: 10:00会被解析成数字 600。给所有时间值加上引号即可fetch_time: 10:00 day_switch_time: 18:30装了 source 但没有日历/传感器实体GUI 配置里如果你跳过了传感器步骤选了 Do not create sensor或者 YAML 里漏写了sensors段就只会有数据没有展示实体。补上至少一个传感器再重启。服务商网站改版导致抓取失败这属于上游变更先看仓库 Issues 里是否已有同类反馈确认是问题后可在 Issue 页面跟进修复进度。进阶玩法让仪表盘更好看把3 天后变成明天/今天给传感器加一行value_template模板变量说明见 doc/faq.mdvalue_template: {% if value.daysTo 0 %}今天{% elif value.daysTo 1 %}明天{% else %}{{value.daysTo}} 天后{% endif %}按类别拆分传感器用types参数为每种垃圾单独建一个传感器如只盯 Garbage再配合add_days_to: True生成daysTo属性就能用 auto-entities 之类的卡片按谁先收排序展示。定制垃圾类型的名称、图标、显隐在 source 的customize段里用alias改名、show: false隐藏不关心的桶type支持通配符可一条规则覆盖一类。降低对服务商的压力把fetch_interval_days调到 2 或更大配合random_fetch_time_offset随机错开抓取时间。写在最后回顾三个关键点先在 README 的支持列表里锁定你的 source再走 HACS 安装最后配置 source 和 sensor 并重启。Waste Collection Schedule 是一个社区持续扩充的框架——数据源文档就放在仓库的 doc/source/ 里缺哪个服务商就提一个 source request也能照着贡献指南CONTRIBUTING.md自己动手加一个。下次收运哪天来仪表盘会比你的记忆更可靠。【免费下载链接】hacs_waste_collection_scheduleHome Assistant integration framework for (garbage collection) schedules项目地址: https://gitcode.com/GitHub_Trending/ha/hacs_waste_collection_schedule创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考