SuperAPI AI 工具集

home-assistant-dashboards-cards

办公与效率

查看项目

更新于 10-15 14:28

技能介绍

用途

该技能面向 Home Assistant 的 Lovelace 仪表盘与卡片配置场景。当用户询问仪表盘结构、视图/分区、卡片类型、资源或 HACS 卡片时,可使用本技能协助完成相关操作。

主要能力

技能覆盖以下方面:

  • 判断是创建新仪表盘还是编辑现有仪表盘。
  • 编辑时先定位目标卡片,并使用当前 config_hash 转换配置。
  • 优先使用内置卡片,除非确需自定义卡片。
  • 在接线卡片前先发现实体 ID。
  • 提供最小且有效的仪表盘片段或工具驱动的变更。

使用方式

技能提供了 ha-mcp 工具映射,用于执行具体操作:

  • 发现实体:ha_get_overview、ha_search_entities
  • 列出/获取仪表盘:ha_config_get_dashboard
  • 查找卡片:ha_dashboard_find_card
  • 卡片文档:ha_get_card_types、ha_get_card_documentation
  • 更新配置:ha_config_set_dashboard、ha_config_update_dashboard_metadata
  • 资源管理:ha_config_list_dashboard_resources、ha_config_set_dashboard_resource、ha_config_set_inline_dashboard_resource、ha_config_delete_dashboard_resource
  • HACS 卡片:ha_hacs_info、ha_hacs_list_installed、ha_hacs_search、ha_hacs_download

适用场景

适用于需要创建或编辑 Home Assistant Lovelace 仪表盘、配置视图与分区、选择卡片类型、管理仪表盘资源,以及查询和下载 HACS 卡片的场景。

限制与注意事项

  • 仪表盘 URL 路径必须包含连字符。
  • 策略仪表盘需要先执行“接管”(Take Control)才能编辑。
  • 资源变更可能需要硬刷新。
  • 核心 Lovelace YAML 中不会求值 Jinja 模板。

参考资料

所有参考文件均相对于本 SKILL.md 文件所在位置:

  • 设计模式:references/DESIGN_PATTERNS.md
  • 卡片模式指南:references/CARD_SCHEMA_GUIDE.md
  • 自定义资源:references/CUSTOM_RESOURCES.md