Home Assistant 将 HACS 转变为 Marketplace：所有变化一览

如果你已经使用 Home Assistant 一段时间，家里很可能早已安装了 HACS。Home Assistant Community Store 是添加社区集成、仪表盘卡片或 Home Assistant 默认不提供的主题时的首选。

随着 Home Assistant 2026.11 的发布，HACS 将以一个新名称 Marketplace 集成到 Core 中。无需再单独安装。乍一看，这似乎只是改了个名字，但更重要的是，它改变了社区作品的地位。

人人都会安装的 HACS……却从来不是官方产品

HACS 如此普及，以至于人们常常以为它一直就是 Home Assistant 的一部分。事实并非如此。它是一个独立开发的自定义集成，可让你使用社区项目：Core 中没有的集成、仪表盘卡片、主题以及各种工具。

没有它，你就得去 GitHub 上查找文件，把它们复制到正确的位置，然后自己留意新版本。HACS 会替你完成这一切。

这个矛盾一直让我觉得很有意思：这个旨在免去手动安装的工具，本身却得手动安装。到了 2026.11，这种情况就结束了。

HACS 变身 Marketplace

Home Assistant 团队将 HACS 直接集成到 Core 中，并为它取了一个对新用户来说更直观的名字：Marketplace。这是一个默认启用的 Core 集成，在“设置 > Marketplace”中拥有自己的界面。

开发者选择了务实的做法：尽可能少改动地集成 HACS。他们没有从零开始重写一个商店。Marketplace 沿用了 HACS 的基础、目录以及大部分功能。

如果你熟悉 HACS，即使换了新名字，也不会感到陌生。

可以安装哪些内容？

首先是自定义集成，这大概是 HACS 最常见的用途。它们可以为尚无官方集成的设备或服务添加支持。除此之外，还有仪表盘插件和卡片、主题以及自定义模板。

实际使用起来没有变化：搜索扩展、阅读介绍、安装，然后接收更新。

我最喜欢的新功能是：每个已安装的仓库都有自己的更新实体。因此，新版本会和 Home Assistant 的更新一起显示在“设置 > 更新”中。社区扩展终于可以像系统的其他部分一样进行管理了。

浏览目录不再需要 GitHub 账号

浏览和安装官方目录中的内容，不再需要关联 GitHub 账号。目录仍然是 HACS 的目录，但其中列出的版本会直接从对应的归档文件或 release 文件下载，无需调用 GitHub API。

在某些情况下，GitHub 账号仍然是必需的，尤其是要添加目录中没有的自定义仓库时。此外，你仍然可以通过仓库链接手动添加。HACS 广受欢迎的灵活性得以保留，而只使用目录内容的用户则少了一步操作。

我已经安装了 HACS，会怎么样？

这是所有人都会问的问题。通常来说，无需重新安装任何东西。

首次在 Home Assistant 2026.11 下启动时，Marketplace 会接管现有的 HACS 安装：已安装的仓库、自定义仓库、仪表盘资源和更新实体。之后，旧的 HACS 集成及其文件会被删除。

同时也考虑到了对旧有用法的兼容。/hacs 链接会重定向到 Marketplace，仪表盘文件仍可通过旧路径 /hacsfiles/ 访问。

这样一来，11 月的更新就不至于变成一个周末的故障排查之旅。

有时不再需要重启

这项改动更偏技术性，但非常实用。安装后，Home Assistant 现在可以刷新自定义集成的缓存。如果该集成具有兼容的配置流程，并且此前尚未加载，就能立即使用，无需完整重启。

如果仍然需要重启，Home Assistant 会通过“修复”进行提示。

单独来看，这些都只是小细节；但综合起来，它们让社区扩展变得好用得多。

注意：Marketplace 并不意味着其中的内容是“官方的”

在我看来，这是最重要的一点。Marketplace 是官方的，但其中的内容不是。它所分发的扩展仍然是由社区编写和维护的代码。

Home Assistant 会在首次使用时显示警告，并要求管理员接受风险，之后才能安装或更新任何内容。这很合理：自定义集成会直接在 Home Assistant 中运行，而自定义卡片会在每位用户的浏览器中执行代码。因此，最好不要随便安装第一个看到的 GitHub 仓库。

不过，系统也设置了一些防护措施。下载的文件会经过检查，安装和删除操作只能影响指定目录，并且在确认安装之前会执行多项验证。如果自定义集成要替换原生集成，也必须明确确认。

不过，目前还没有数字签名或校验和来验证所分发的代码。Marketplace 让安装更方便，但不会审核每个项目。

为危险扩展准备的紧急停止按钮

目录会区分两种情况。仅仅被移除的仓库（例如已弃用、已归档等），仍会在已安装它的用户那里继续运行。用户会收到通知，但不再获得更新。

被标记为严重问题、也就是判定为有危险的仓库，则会受到严格得多的处理：Marketplace 可以将其卸载并重启 Home Assistant。

目录会在启动时检查，之后每六小时检查一次。当软件控制着门锁、警报器、供暖设备或部分电气系统时，能够如此迅速地采取措施绝非可有可无。

HACS 曾经能做、而 Marketplace 将不再支持的功能

HACS 还可以管理 AppDaemon 应用和 Python 脚本。Marketplace 不支持这些内容。

如果你正在使用它们，不会有任何文件被删除：这些文件会保留原位。只是之后不会再跟踪它们的更新，Home Assistant 会通过“修复”通知你。

对于大多数使用 HACS 安装集成和 Lovelace 卡片的人来说，这不会带来任何变化。

那蓝图呢？

蓝图不会通过 Marketplace 获取。我们仍然通过 URL 导入它们：可以是 GitHub 上的文件、Gist、Home Assistant 论坛上的帖子，或任何在线 YAML 文件。

Home Assistant 会记住原始地址，重新导入功能则可以从同一位置获取新版本。不过，蓝图没有更新实体：你需要自己记得检查。

通过分类让内容一目了然

Marketplace 还伴随着另一项工作：为集成分类。官方集成已超过 1,500 个，只按名称搜索会变得很麻烦。

开发者制定了 28 个类别，有些还细分为子类别：照明、气候、能源、电动汽车充电等。自定义集成可以在其 manifest.json 文件中声明所属类别，而 Marketplace 中的分类展示也已经在准备中。

长远来看，我们应该可以按照想要实现的功能来搜索扩展，而不必知道它的名称。对于新手来说，这会带来很大改变。

Core 的预备阶段？

Home Assistant 向开发者介绍 Marketplace 的方式引起了我的注意。一个集成或一张卡片可以先在 Marketplace 中起步。如果项目逐渐成熟、找到自己的用户群，并且确实带来价值，作者之后就可以与 Home Assistant 团队讨论将其纳入 Core 的可能性。

因此，Marketplace 可以成为社区实验项目与官方功能之间的过渡通道。考虑到社区推出新集成和新卡片的速度，我很喜欢这个想法。

我们熟悉的 HACS 时代即将结束

HACS 并没有真正消失，只是改变了身份。目录仍然存在，开发者仍然使用 hacs.json 文件，HACS 验证工具也仍然是整个系统的核心。Home Assistant 自己是这样概括 Marketplace 的：它就是集成到 Home Assistant 中的 HACS，并且尽可能少做改动。

对用户来说，这几乎全是好消息。新手不再需要费心寻找如何安装 HACS。更新会和其他更新一起显示，安装更加简单，迁移会自动完成，界面也成为系统的一部分。

只需记住一个需要注意的地方：从 Marketplace 下载的扩展仍然是社区扩展。它无法提供由 Home Assistant 团队维护的集成所具备的同等保障。

多年来，大家在安装 Home Assistant 后，首先推荐安装的就是 HACS。从 2026.11 开始，我们就不用再这么做了。对于这些年来一直让 HACS 蓬勃发展的所有人来说，这是莫大的认可！