ha-hacs-publishing

用途：帮助把 Home Assistant 集成发布到 HACS，覆盖从校验到上架默认仓库的完整流程。主要能力与用法：一、GitHub Actions 校验。创建 .github/workflows/validate.yml，在 push、pull_request、schedule（cron '0 0 * * *'）和 workflow_dispatch 时运行两个任务：使用 hacs/action@main（category: integration）做 HACS 校验，使用 home-assistant/actions/hassfest@master 做 Hassfest 校验。资料说明这两个浮动引用是 HACS 官方推荐值，不应盲目改动；同时指出浮动引用会降低可复现性并带来供应链风险，若更看重可复现性可固定到 release SHA/tag。二、README 模板。包含 HACS 与 GitHub Release 徽章、功能列表、安装步骤（HACS 推荐方式：打开 HACS、三点菜单→Custom repositories、以 Integration 类型添加仓库地址、搜索并 Download、重启 Home Assistant；手动方式：复制 custom_components 目录并重启）、配置步骤（设置→设备与服务→添加集成→搜索→按向导配置）与支持链接。三、品牌提交。HACS 默认仓库要求向 home-assistant/brands 提交品牌：fork 仓库、创建 custom_integrations/{domain}/ 目录、加入 icon.png（256x256）及可选的 logo.png 与 icon@2x.png（512x512），然后提交 PR。四、发布。HACS 使用 GitHub Releases 而非仅 tag：git tag -a v1.0.0 -m "Release 1.0.0" 后 git push origin v1.0.0，再到 GitHub 创建带 changelog 的 Release；版本必须与 manifest.json 一致。五、加入 HACS 默认列表。需通过所有校验、至少发布一个 release、提交品牌到 home-assistant/brands，fork hacs/default 并按字母顺序在 integration 文件中加入仓库后提交 PR；不在默认列表也可由用户手动添加自定义仓库。限制与说明：未提供具体收费、价格或平台信息；相关技能为 HACS 元数据（ha-hacs）与文档（ha-documentation）。