HACS 默认仓库完整指南：Home Assistant 社区扩展装什么、怎么装
【免费下载链接】defaultThe home of the default HACS repositories.项目地址: https://gitcode.com/gh_mirrors/def/default
HACS 是 Home Assistant 的“应用商店”，而这个默认仓库（hacs/default）就是商店背后的官方清单：你在 HACS 里看到的集成、插件、主题、模板，全部来自它维护的列表。如果你刚上手 Home Assistant，想直接装经过筛选的扩展、又不想自己逐个判断仓库是否可靠，这篇指南会讲清楚这份清单是什么、怎么用、以及新手容易卡在哪。
它适合谁
适合：
- 你已经装好 Home Assistant 并成功安装了 HACS，打开商店后看到“集成 / 插件 / 主题”等分类，但不确定这些条目从哪来
- 你不想自己满世界找仓库，更希望从一份“已验证清单”里挑选
- 你想知道为什么某个扩展出现在商店里，或者为什么想装的仓库显示“未收录”
不适合：
- 你还在研究怎么安装 Home Assistant 本身——这个仓库和主程序无关
- 你想把自己的作品发布为“默认收录”——那有单独的提交流程，不是自己改文件就能上架
核心价值
- 货架已经替你选过：仓库把扩展分成 integration、plugin、theme、appdaemon、netdaemon、python_script、template 等类别，列表里每一项都是已核验的仓库名，你在 HACS 商店里搜索、安装即可。
- 风险过滤内置：除了正常清单，仓库还维护 blacklist、critical、removed 三类文件，分别处理被排除、有安全问题和被下架的仓库，你不用自己操心“这个扩展能不能装”。
- 增删有统一流程：新仓库不是随手加进去的，仓库内配有排序、校验、处理归档仓库的脚本，保证列表长期保持有序和有效。
- 入口统一：你在 HACS 界面里看到的就是团队维护的同一份清单，不存在“商店一套、后台另一套”的信息差。
第一次使用怎么走
最短路径（前提是 HACS 已装好）：
- 重启 Home Assistant，在侧边栏找到 HACS 图标并进入。
- 打开“集成 / 插件 / 主题”任一分类，你看到的条目都来自这份默认清单。
- 用搜索框缩小范围，选中后安装，按仓库说明重启 Home Assistant 生效。
如果你还想看看清单本身长什么样，可以克隆源码直接浏览：
git clone https://gitcode.com/gh_mirrors/def/default打开 integration、theme 等文件，它们本质上就是一份份仓库名的 JSON 列表，不需要任何额外配置。
一个真实场景：给 Home Assistant 加一个官方没有的设备集成
目标：某品牌设备在内置集成里找不到，你想用社区集成接入。
- 打开 HACS，进入“集成”分类。
- 搜索设备名或厂牌英文名。能搜到，说明它已在默认仓库的 integration 列表中。
- 安装后，按该仓库的说明重启 Home Assistant。
- 判断结果：重启后在“设置 → 设备与服务”里出现对应集成，就可以继续配置；搜不到则说明它还没进入默认清单，需要等收录或按仓库维护者的指引手动添加，后者要自己评估可信度。
记住一个模型：HACS 里搜得到，等于在默认仓库列表里。
常见疑问与避坑
- 问：某个挺有名的仓库为什么商店里搜不到？商店只展示清单内的仓库。它可能还没被批准，也可能进了 removed 或 blacklist 名单；查看这两个文件里的 reason 字段，能直接看到被排除的原因。
- 问：装完还要做什么？查看仓库说明确认是否需要重启 Home Assistant；平时留意 HACS 的“更新”入口，新版本不会自动替你做决定，定期检查是稳定性的关键。
- 问：我需要修改这个仓库的文件吗？不需要。普通用户只用 HACS 界面，本地改动清单不会影响你的商店；它主要供 HACS 维护方使用。
下一步
- 浏览清单源码：克隆后打开 integration、plugin、theme 文件，直观了解当前货架
- 了解发布流程：想让自己的扩展被默认收录，查看项目官方文档中的发布章节
- 扩展使用：熟悉基础流程后，尝试一类没接触过的分类，比如 template 或 theme
【免费下载链接】defaultThe home of the default HACS repositories.项目地址: https://gitcode.com/gh_mirrors/def/default
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
