🏡 Home Assistant Builder (hab) — 🏡 Home Assistant Builder（hab）

Home Assistant Builder（hab） 是一款为LLM设计的CLI工具，用于构建和管理Home Assistant配置。 开始每个工作流 脚本scripts/hab.sh是一个支持自动安装的包装脚本，请用命令scripts/hab.sh替换所有hab命令。 alias hab='scripts/hab.sh' hab guide list hab guide auth hab schema overview hab capability probe 然后阅读特定工作流的主题和命令模式： 任务 首先命令 发现/库存 hab guide discovery； hab schema entity list 自动化/脚本/场景 hab guide automation； hab schema automation create --json 仪表板/Lovelace hab guide dashboard； hab schema dashboard card create --json 助手 hab guide helpers； hab helper types --json 日历/待办 hab guide calendar-todo 备份/系统/网络 hab guide operations； hab schema system restart ESPHome hab guide esphome； hab schema esphome validate --json 对于简单的认证读取，hab auth status加上相关模式就足够了。 输出和解析 使用--json时，Claude或其他程序将解析输出。 JSON成功和错误响应是信封；在继续之前检查这些字段： success data error.code， error.details.suggested_fix warnings， partial_result， missing_sections verification_commands， next_suggested_commands ESPHome流命令，如build、validate、upload、run和logs，可能在JSON模式下发出NDJSON事件，而不是一个最终信封。 变更和风险门 在更改状态之前检查： 阅读命令的指南/模式。 使用只读列表/获取命令收集当前状态。 使用--plan或--dry-run预览变更（如果支持）。 显示预览并在执行风险操作之前询问用户。 运行来自计划或后续获取/列表命令的验证命令。 始终在可能导致停机、数据丢失、连接丢失或硬件更改的操作之前询问用户明确确认： 系统重启， 备份还原/删除， 网络配置/应用， Thread数据集更改， 集成启用/禁用/重新加载， ESPHome上传/运行/更新/擦除闪存， 以及带有--force的任何删除操作。 不要仅仅为了使命令非交互式而添加--force。 仅在用户批准了确切的操作后使用它。 输入有效载荷 接受数据的命令通常支持： 方法 使用时 模式 --data / -d 短JSON有效载荷 hab automation create id -d '{...}' --json --file / -f 较大的YAML/JSON有效载荷 hab automation update id -f automation.yaml stdin heredoc 多行有效载荷，无需临时文件 hab automation create id <<'EOF' 对于大型自动化和仪表板，首选文件或heredoc，以免引号破坏JSON/YAML。 常见命令模式 # 认证和实例检查 hab auth status hab overview hab capability probe # 实体库存 hab entity list --domain light hab entity get light.kitchen --device --related hab search related entity light.kitchen # 安全变更预览 hab schema area create --json hab area create "Kitchen" --plan hab area create "Kitchen" # 自动化创建 hab guide automation hab schema automation create --json hab automation create kitchen_motion_light -d '{"alias":"Kitchen motion light","triggers":[{"trigger":"state","entity_id":"binary_sensor.kitchen_motion","to":"on"}],"conditions":[],"actions":[{"action":"light.turn_on","target":{"entity_id":"light.kitchen"}}]}' --dry-run # 操作 hab guide operations hab system health --json hab system restart --plan hab backup list hab backup delete --plan 响应模式 当回答用户询问hab命令时： 声明预期的安全模式：只读、预览或确认变更。 按执行顺序提供命令。 标记任何需要用户确认的命令。 说明在下一步之前要检查的JSON字段。 包括验证命令。 常见错误 错误 更好的方法 从记忆中猜测命令标志 首先运行hab schema --json 解析文本输出 使用--json并检查信封字段 在没有库存列表/获取/搜索相关之前创建资源 跳过变更预览 使用--plan或--dry-run（如果支持） 为了方便而使用--force 首先确认确切的风险操作 将ESPHome JSON视为一个对象 处理流命令的NDJSON流事件 忽略verification_commands 运行它们或解释为什么不运行