SuperAPI AI 工具集

ha-repairs

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:在 Home Assistant 自定义集成中实现修复问题(Repair Issues),向用户提供需要处理的问题的可操作通知,这是 Gold tier IQS 的要求。

适用场景:用户可自行修复的配置问题、有可用固件更新、使用了已弃用功能、缺少可选依赖、需要用户操作的服务中断。不适用于瞬时错误(应使用日志)、实体不可用(应使用 available 属性)、内部错误(应使用异常)。

主要能力:通过 homeassistant.helpers.issue_registry 的 async_create_issue 创建问题,支持 is_fixable、severity、translation_key、translation_placeholders、learn_more_url、data 等参数。严重级别有 CRITICAL(保留给 HA 核心,自定义集成不要使用)、ERROR(已损坏)、WARNING(应尽快处理),自定义集成应使用 ERROR 或 WARNING。问题分为不可修复(用户在 HA 外部操作)和可修复(通过 Repair Flow 在 HA 内修复)两类。

使用方式:不可修复问题直接调用 async_create_issue 并设置 is_fixable=False;可修复问题需设置 is_fixable=True 并在 repairs.py 中实现 RepairsFlow 子类,通过 async_create_fix_flow 返回对应流程。需在 strings.json 中配置 issues 的 title、description 及 fix_flow 步骤文案。问题解决后用 async_delete_issue 删除;无“按条目删除全部”的变体,需逐个删除已知的按条目 ID。

限制:CRITICAL 级别保留给 Home Assistant 核心,自定义集成不得使用。async_delete_issue 不存在删除某条目全部问题的变体。相关技能包括 ha-config-flow、ha-coordinator、ha-quality-review。