用途：为 Home Assistant Lovelace YAML 仪表盘创建交互式按钮，用于控制设备、调用服务、在视图间导航，并支持 HACS 自定义 button-card。
主要能力：覆盖原生 Button Card（简单实体控制与动作）与自定义按钮卡片 HACS（高级模板、状态驱动样式、多动作）。支持三类动作：tap_action（单击，主操作）、hold_action（长按 0.5 秒以上，次操作）、double_tap_action（双击，第三操作）。可用动作包括 none、toggle、more-info、navigate、url、perform-action（旧称 call-service）和 assist。可实现服务调用（如 light.turn_off、climate.set_temperature、light.turn_on 带 brightness、automation.trigger、script 与 scene 执行）、视图导航、外链打开、语音助手触发，以及依实体状态动态改变颜色和图标。
使用方式：在 Lovelace 仪表盘 YAML 中编写卡片，设置 type、entity、name、icon、show_state 等字段，并按需配置 tap_action、hold_action、double_tap_action。服务调用使用 action: perform-action 配合 perform_action、target 与 data。导航使用 action: navigate 与 navigation_path。自定义按钮卡片需先经 HACS → Frontend 搜索安装 button-card，再使用 type: custom:button-card，并用 state 列表定义不同取值下的 color 与 icon。
适用场景：灯具、开关、温控等实体切换；执行自动化、脚本与场景的服务按钮；房间或视图之间的导航按钮及导航网格；基于状态的高亮与图标变化；需要模板与条件逻辑的高级按钮。
限制：不适合仅展示传感器数值而无交互的场景（宜用 entity card），也不适合复杂多实体卡片（宜用 entities card 或自定义布局）。需注意新版 Home Assistant 使用 perform-action 而非 call-service。常见问题包括实体不存在、服务名错误、navigation_path 拼写或视图路径未定义、HACS 未安装或浏览器缓存未清理。更完整的高级模板与动作说明见其 references 目录文档。收费、价格与更详细版本信息暂未提供。