SuperAPI AI 工具集

ha-validate-dashboards

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:在部署或修改 Home Assistant 仪表盘(Lovelace)与配置前进行验证,尽量在影响用户前发现错误。

主要能力(三层验证):

  1. 发布前验证(API 方式):校验配置结构(如必须含 views、views 为列表、每个视图含 title、cards 为列表),递归提取所有实体 ID,通过 REST API 的 /api/states 检查实体是否存在。
  2. 发布后验证(日志分析):发布后抓取 /api/error_log,与变更前日志做 diff,识别如 custom element doesn't exist、Entity not available、Error while loading page lovelace 等错误。
  3. 视觉验证(浏览器自动化):用 MCP Chrome 工具导航到仪表盘、读取控制台消息、截图与读取页面内容,确认卡片渲染与无 JS 报错。

必要用法:脚本依赖 Python 3.11+ 与 requests、websocket-client,需设置 HA_LONG_LIVED_TOKEN,Home Assistant 建议 2025.12.3+。示例流程:发布前跑校验脚本,通过后运行 ./run.sh dashboard_builder.py 发布,再用 curl 查日志,最后用 mcp-cli 调用 claude-in-chrome 做导航与读取控制台。

适用场景:部署仪表盘变更前、修改 dashboard builder 脚本后、提交相关代码前;排查“Entity not available”、卡片不渲染、控制台报错、HACS 卡片安装后不显示等。

限制与注意:需自备 HA 地址与长期令牌;资料未提供具体收费或价格;未给出完整的验证脚本文件(如 validation_helpers.py 与 references 文档正文),仅示例片段;视觉验证较慢,简单实体 ID 变更可跳过;建议先备份、避免直接发布到生产,可先在测试仪表盘验证。