HACS：Home Assistant 自定义元素商店

自动化控制 7.9k（+2） 1.6k Python 2026-11-15 访问官网 ↗ 在 GitHub 打开

Home Assistant 集成，通过 UI 发现、下载、更新和移除自定义组件、主题等社区元素，并提供仓库与问题追踪快捷方式。

HACS（Home Assistant Community Store）是一个 Home Assistant 集成，让用户通过界面管理自定义元素的下载：发现新的自定义元素、下载、跟踪、更新与移除，并提供指向相关仓库和问题追踪器的快捷方式。README 指向通用文档、配置与 FAQ 等链接，问题应在本仓库提交。

Star 趋势2026-11-08 — 2026-11-15当前 Stars 7.9k24h +2

#community #hacs #home-assistant #integration #package-manager

项目信息

所有者: hacs
Star: 7.9k
Fork: 1.6k
开源协议: —
主要语言: Python
发布时间: 2019-02-26
最近更新: 2026-11-13

项目更新

2.0.52025-01-28
2.0.5 是一个纯修复版本，只做了一件事：把前端资源升级到 20250128065759 版本，解决此前前端与后端不匹配导致的界面异常。升级后 HACS 面板显示应恢复正常，无需其他操作。
2.0.42025-01-27
HACS 2.0.4 发布，本次仅包含一项修复：针对 Lovelace 数据中出现的弃用警告做了兼容处理，升级后可消除相关报错。
2.0.32025-01-14
HACS 2.0.3 发布，修复了一个下载校验问题：此前对 .can_download 的额外检查可能导致部分资源无法正常下载，现已移除该检查，下载流程恢复正常。
2.0.22025-01-05
HACS 集成 2.0.2 是一个以修复为主的小版本。manifest 中的文档链接已更新为有效地址；调整了一处字符串，消除 hassfest 检查报错。配置选项流程（option flow）在 Home Assistant 版本高于 24.11.99 时不再写入 configentry，避免与新版接口冲突。另外，系统恢复（restore）过程中的 setrepository_id 增加了保护，减少数据回写时的异常风险。升级后无需额外操作，若你此前遇到 hassfest 校验失败或恢复配置时报错，这一版可直接解决。
2.0.12024-09-04
HACS 2.0.1 是一次小修小补的版本。修复了更新列表不完整的问题——此前「待更新」页面可能漏显部分可更新项，现在会一次性全部列出，方便你核对。前端方面同步了 Home Assistant 核心界面至 a09f44d，溢出菜单也换成了新版 ha-menu 组件，外观与操作手感与官方界面更趋一致。升级后无需额外配置，日常使用基本无感，主要价值在于修正列表显示和跟上核心 UI 的节奏。
2.0.02024-08-21
HACS 2.0.0 是一次大版本升级，破坏性变更不少。更新前请先备份 Home Assistant 配置目录，2.x 与旧版不兼容，且要求 Home Assistant 2024.4.1 及以上版本。新功能方面：前端全面重做，改用数据表呈现（升级重启后需清浏览器缓存才能看到）；新增 update 实体，被跟踪仓库及 HACS 自身的更新会与其他更新通知并列显示；新增 switch 实体，用于控制仓库预发布版；元数据改用 Cloudflare 托管的新数据源；新增 Template 类型，支持自定义模板仓库。其他破坏性变更：sensor 平台被移除，不再支持 YAML 配置，NetDaemon 应用下架，/hacsfiles/ 主题端点失效，不再触发 hacs 前缀自定义事件，info.md 不再渲染、改用 README。若此前已启用实验特性，多数变化其实早已生效。
1.34.02024-01-21
HACS 1.34.0 更新实验功能方面，更新实体现在可以指定拉取标签或分支，不再局限于默认版本；下载非 zip 格式的 release 资源时，特定版本获取错误的问题也一并修复，下载前还会先校验 hacs.json 与 HACS 自身版本，避免拉到不兼容的仓库。实验性前端同步了从 2023 年 4 月到 2024 年 1 月的一批改动。对普通使用者影响更直接的是几处 Bug 修复：zip 包只提取指定文件而不是全部内容；某个分类只要有内容下载成功就始终保持启用状态；已下载的项目，文档链接会正确指向实际安装的版本；配置流程里的设备步骤做了调整，删除 python_script 仓库时名称显示也修正了。代码层面则是一轮清理：去掉了多余的版本检查，清单加载提前到校验阶段，解压时空文件名不再报错，URL 注册和更新平台分别改用官方辅助函数与 UpdateEntityFeature。
1.33.02023-09-24
HACS 1.33.0 更新。这次有两处破坏性变更：YAML 配置正式废弃，相关用法需要尽快迁移到界面配置；同时最低要求提升到 Home Assistant 2023.6.0 和 Python 3.11，老版本环境将无法升级。新增了一个实验性功能开关，可在创建配置条目时选择是否启用，目前默认关闭，且已改为保存在选项（options）中而非条目数据里，后续调整不会影响已有配置。修复方面：删除组件时的名称引号显示错误已纠正；websocket 命令在更新仓库信息时增加了保护，避免异常数据导致崩溃；任务尚未完成时禁止重载集成，防止状态错乱；另外统一了消息格式。如果你之前用 YAML 配置 HACS，升级前请先完成迁移，否则配置将不再生效。
1.32.12023-04-08
HACS 1.32.1 紧跟 1.32.0 发布，除修复自定义模板年份显示错误外，主要更新集中在 1.32.0：实验性功能新增 custom_templates 自定义模板支持，配套前端也跟进适配，并常驻显示「新仓库」筛选器（需开启实验性功能才生效）。此外还做了一批改进——避开线性搜索提升性能、遇到未知分类改为警告而非直接报错、禁止添加未知分类，开发环境前端改用路径直连。整体属于小步快跑的稳定与体验修补。
1.32.02023-04-08
HACS 1.32.0 更新。实验性功能新增对 customtemplates 的支持，集成端与前端均已跟进；前端实验版还会常驻「新仓库」筛选器。重构方面避开了若干线性查找，开发环境改用直连路径替代代理。未知分类的处理更宽容：遇到不认识的分类不再直接报错中断，改为给出警告，同时在入口处拦截、禁止添加未知分类。已启用实验特性的用户才能体验到 customtemplates 相关改动，普通用户感知主要来自稳定性提升。