用途
该技能面向 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