Mushroom卡片模板徽章与实体过滤器的结合应用

在Home Assistant的Mushroom卡片生态中，模板徽章(mushroom-template-badge)是一个非常灵活的组件，它允许用户通过Jinja2模板自定义徽章的外观和行为。近期有开发者探索了将其与Home Assistant原生实体过滤器(entity-filter)结合使用的可能性，这为动态展示实体状态提供了新的思路。

技术背景

实体过滤器是Home Assistant内置的视图组件，它能根据预设条件动态筛选显示的实体。典型应用场景包括：

• 只显示处于特定状态的设备（如"非关闭"状态的温控器）
• 基于条件过滤传感器数据
• 实现动态显示的实体集合

而模板徽章则提供了完全自定义的能力，通过模板可以：

• 动态设置图标、颜色和文本
• 基于多个实体状态组合判断
• 实现复杂的交互逻辑

实现方案

开发者最初尝试在实体过滤器内嵌套模板徽章，成功实现了单个实体的状态过滤。例如阳台门传感器的状态可视化：

type: entity-filter
entities:
  - type: custom:mushroom-template-badge
    entity: binary_sensor.door
    color: >
      {% if is_state('binary_sensor.door', 'on') %}
        #FF0000
      {% else %}
        #008000
      {% endif %}
    icon: >
      {% if is_state('binary_sensor.door', 'on') %}
        mdi:window-open
      {% else %}
        mdi:window-closed
      {% endif %}
conditions:
  - condition: state
    state_not: 'off'

进阶挑战

当需要处理多个关联实体时（如主门传感器和通风传感器），开发者遇到了组合状态显示的难题。理想情况是：

1. 门完全开启时显示红色
2. 仅通风开启时显示橙色
3. 完全关闭时显示绿色

项目维护者提出了两种解决方案：

方案一：多徽章并列

为每个实体创建独立的模板徽章，通过实体过滤器统一控制显示条件。这种方式结构清晰但略显冗余。

方案二：模板徽章内建逻辑

更推荐的方式是直接在模板徽章内实现完整的状态判断逻辑，利用Jinja2模板的条件分支处理多实体状态组合。

最佳实践建议

对于这类多状态组合场景，推荐采用以下模式：

1. 创建虚拟传感器聚合多个物理设备状态
2. 在模板徽章中引用该虚拟传感器
3. 通过模板实现复杂的状态映射

这种架构更符合Home Assistant的设计哲学，也便于后期维护和扩展。虚拟传感器可以作为单一事实来源，而展示层则保持简洁。

总结

Mushroom模板徽章与实体过滤器的组合展示了Home Assistant生态的强大灵活性。虽然技术上可以实现嵌套使用，但从架构角度看，将业务逻辑集中在虚拟传感器或模板内部通常是更可持续的方案。开发者应根据具体场景选择最合适的实现方式，平衡灵活性与可维护性。