SuperAPI AI 工具集

ha-hacs

数据与分析

查看项目

更新于 10-15 23:48

技能介绍

用途:该技能面向 Home Assistant 自定义集成(custom integration)的 HACS 元数据准备与校验,帮助开发者按 HACS(Home Assistant Community Store)要求组织仓库和配置文件。

主要能力:给出推荐的仓库结构,包括 custom_components/{domain}/ 下的 init.py、manifest.json、config_flow.py 等,以及仓库根目录的 hacs.json、README.md、LICENSE 和 .github/workflows/validate.yml。说明 manifest.json 中 HACS 要求的字段:domain、name、version(有效的 X.Y.Z 语义化版本,HACS 自定义集成需要,HA core 集成必须省略)、codeowners、documentation、issue_tracker;并指出 integration_type 与 iot_class 由 hassfest 要求,而 HACS 校验动作会运行 hassfest,因此定位 HACS 的仓库也需提供。列出 hacs.json 的常用键:name(必填)、homeassistant、hacs、content_in_root、zip_release、filename、render_readme、country、hide_default_branch、persistent_directory。提供提交前的校验清单:manifest 字段齐全、hacs.json 至少含 name、README 含安装说明、GitHub 仓库有描述与主题、至少发布一个与 manifest 版本一致的 GitHub Release、HACS 与 Hassfest 校验通过。

使用方式:在仓库根目录创建 hacs.json,至少写入 {"name": "My Integration"},按需添加 homeassistant 等选项;在 manifest.json 中补齐必填字段;通过 HACS 校验工作流和 hassfest 检查。常见问题排查包括无效 manifest(检查 JSON 语法与语义化版本)、缺少 hacs.json(必须位于仓库根而非 custom_components)、找不到发布(需发布 GitHub Release 而非仅打标签)。

适用场景:准备或校验 HACS 提交、排查元数据校验失败。限制:资料未提供具体版本兼容范围、收费信息或除上述之外的操作步骤。