UI-Lovelace-Minimalist项目中的input_select服务调用问题解析

问题背景

在UI-Lovelace-Minimalist项目升级到最新版本后，用户报告了一个关于input_select服务调用的兼容性问题。具体表现为card_scenes_welcome卡片和card_vertical_button卡片在使用input_select实体时出现错误："input_select/select_option"服务调用失败，提示"Extra keys not allowed @ data['target']['option']"。

问题本质

这个问题源于Home Assistant服务调用机制的变更。在较新版本的Home Assistant中，服务调用的参数结构变得更加严格，要求将实体ID(entity_id)放在target字段中，而其他参数如option则需要放在data字段中。

技术分析

在旧版本的实现中，代码将所有参数(包括entity_id和option)都放在了target字段中，例如：

target: |
  [[[
    var obj;
    if( entity.entity_id.startsWith("input_select.") )
      obj = { entity_id: entity.entity_id, option: variables.ulm_card_vertical_button_state };
    return obj;
  ]]]

这种写法在新版本中会导致验证错误，因为option参数不应该出现在target字段中。

解决方案

正确的实现方式应该是：

target:
  entity_id: "[[[ return entity.entity_id; ]]]"
data:
  option: |
    [[[
      if( entity.entity_id.startsWith("input_select.") )
        return variables.ulm_card_vertical_button_state;
    ]]]"

这种结构明确区分了：

1. target字段：仅包含服务调用的目标实体ID
2. data字段：包含服务调用需要的其他参数

影响范围

这个问题主要影响以下几类卡片：

1. card_scenes_welcome：欢迎场景卡片
2. card_vertical_button：垂直按钮卡片
3. 其他使用input_select.select_option服务的卡片

临时解决方案

在官方修复发布前，用户可以手动修改相关模板文件：

1. 对于card_vertical_button，将target字段重命名为data字段
2. 或者回退到1.3.10版本

最佳实践建议

1. 始终遵循Home Assistant最新的服务调用规范
2. 在自定义卡片开发时，明确区分target和data字段的用途
3. 对于input_select服务调用，确保option参数位于data字段中
4. 定期检查并更新卡片模板以保持兼容性

总结

这个问题展示了Home Assistant生态系统中的一个常见挑战：API规范的演进可能导致现有实现出现兼容性问题。通过理解服务调用的参数结构规范，开发者可以更好地编写和维护兼容性良好的卡片模板。UI-Lovelace-Minimalist项目团队已在1.3.13版本中修复了此问题，为用户提供了更加稳定可靠的使用体验。