mcpField
H
home-assistant-dashboards-cards

home-assistant-dashboards-cards

github.com/bradsjm设计与 UI46731 次安装16 周前更新
代码仓库

关于 home-assistant-dashboards-cards

用于创建或编辑 Home Assistant 仪表盘与卡片的技能,面向通过 ha-mcp 操作仪表盘的用户。它提供从实体发现、卡片配置到仪表盘资源管理的工作步骤和注意事项。

主要功能

  1. 01发现实体 ID
  2. 02列出并查找仪表盘卡片
  3. 03查询卡片类型与文档
  4. 04更新仪表盘配置和元数据
  5. 05管理仪表盘资源及 HACS 卡片

适用场景

  1. 01新建 Home Assistant 仪表盘
  2. 02定位并编辑现有卡片
  3. 03查找自定义卡片并管理资源

MCP 相关

该技能列出 ha-mcp 的工具,用于发现实体、读取和更新仪表盘,以及管理卡片与资源。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-dashboards-cards

安装后在 Claude Code 中输入/home-assistant-dashboards-cards确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
CARD_SCHEMA_GUIDE.md
CUSTOM_RESOURCES.md
DESIGN_PATTERNS.md

详细介绍

Home Assistant 仪表板与卡片

工作流

  • 确定要创建新仪表板还是编辑现有仪表板。
  • 如果是编辑,先定位目标卡片,并使用当前的 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

注意事项

  • 仪表板 URL 路径必须包含连字符。
  • 策略仪表板必须先“接管”才能编辑。
  • 更改资源后可能需要强制刷新。
  • 核心 Lovelace YAML 不会评估 Jinja 模板。

参考资料

所有参考文件均相对于此 SKILL.md 文件所在的位置。

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

评论

支持 Markdown