SuperAPI AI 工具集

ha integration dev

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:用于开发 Home Assistant 自定义集成(Python)的参考技能,强调安全、异步模式与时间戳处理的正确性。

主要能力:围绕 custom_components 结构、ConfigEntry、DataUpdateCoordinator、config_flow、OAuth2、websocket、实体平台、DeviceInfo、unique_id、repair issues、conversation agent、诊断、安全与 pytest 测试等提供参考文档;提供基础、轮询、推送、OAuth、多设备 hub、服务响应、蓝牙、对话智能体等模板;支持生成 HACS 发布所需的 hacs.json、README.md、LICENSE 与 .github/workflows/validate.yaml。

必要用法:先澄清集成类型(轮询或推送、云端或本地)、认证方式、所需实体类型与输出方式,再选择模板并阅读对应 references 文件,生成代码后执行完成前检查清单。四条核心规则:时间戳使用 dt_util.now()/dt_util.utcnow(),属性仅可 JSON 序列化,HTTP 使用 aiohttp,存储使用 entry.runtime_data 而非 hass.data[DOMAIN]。服务在 2024.8 起称为 action;EntityDescription 自 2025.1 需 frozen=True、kw_only=True;Coordinator 需传 config_entry=entry。

适用场景:开发、扩展或通过 HACS 分发 Home Assistant 自定义集成;限制:Home Assistant 不对集成做沙箱隔离,安全需自行负责;具体作者、版本更新与更多细节暂未提供。