ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

HACS 默认仓库上手指南:看懂 Home Assistant 社区商店的扩展清单是怎么维护的

HACS 默认仓库上手指南:看懂 Home Assistant 社区商店的扩展清单是怎么维护的 HACS 默认仓库上手指南看懂 Home Assistant 社区商店的扩展清单是怎么维护的【免费下载链接】defaultThe home of the default HACS repositories.项目地址: https://gitcode.com/gh_mirrors/def/default这个仓库里没有应用代码只有一批纯 JSON 列表它们正是 HACS 商店页背后的直接数据源。Home Assistant 用户打开 HACS 后能搜到哪些设备集成、仪表盘卡片和主题哪些仓库又因安全问题被下架答案都写在这几十个文件里。如果你想弄清 HACS 的内容从哪来或者准备提交自己的作品从这里入手最直接。为什么值得看这个清单仓库条目格式极简每个文件一行就是一个用户/仓库条目打开就能判断 HACS 当前推荐了哪些扩展不需要运行任何东西。下架记录有据可查critical、removed、blacklist三类文件记录了被移除的仓库和具体原因仓库消失时不用靠猜。维护动作都脚本化排序校验、重复检测、按作者批量移除有现成脚本改列表不靠手工编辑。最快上手路径五步读懂仓库克隆仓库并安装依赖scripts/setup只是按requirements.txt装上aiogithubapi和requests两个包。git clone https://gitcode.com/gh_mirrors/def/default cd default bash scripts/setup打开integration文件浏览内容每行一条用户/仓库按字母序排列plugin和theme同理。运行下面命令检查全部 8 个类别文件的字母序是否合规不合规会直接指出哪个类别乱序。python3 scripts/is_sorted.py看一眼tools/jsonschema/repositories.schema.json其中pattern字段定义了唯一允许的条目格式用户/仓库两个部分只允许字母、数字、点、短横线和下划线。打开removed文件看一条下架记录结构固定为仓库名、原因、关联链接三项。三个真实使用场景场景一提交自己的仓库进商店场景你维护着一个传感器集成希望它出现在 HACS 商店里被用户直接搜到。做法打开对应类别文件如integration把你的用户名/仓库名插到字母序正确的位置提交变更scripts/check/existing.py会自动对照 HACS 现有数据防止重复提交。效果审核通过后该仓库立刻出现在所有 HACS 用户的商店列表中不需要任何额外推广。场景二下架存在风险的扩展场景某个仓库被发现窃取认证凭据需要尽快从商店中撤下并留下记录。做法在critical文件追加一条记录写明具体原因如果是某位作者名下所有作品都要移除用scripts/remove_publishers.py遍历全部类别生成对应的移除记录。效果商店里立刻看不到该仓库后来者查removed文件就能知道它为什么消失、出于什么原因。场景三排查为什么搜不到场景你常用的一张仪表盘卡片在 HACS 里突然搜不到了。做法先在blacklist和removed两个文件里搜仓库名找到对应条目和原因说明。效果十秒钟就能区分仓库被下架还是名字记错了比到社区里提问快得多。各文件的分工integration设备与设备端集成的清单是体量最大的类别条目数以千计。pluginLovelace 仪表盘卡片的清单负责界面定制类扩展。theme主题清单决定 Home Assistant 的视觉风格。appdaemon、netdaemon、python_script三类脚本扩展的清单覆盖自动化脚本场景。template可复用的 Jinja 模板清单供写自动化时取用。critical、removed、blacklist安全与合规相关的负面清单记录被移除仓库及原因。避坑与检查清单格式条目必须严格是用户/仓库形式不符合repositories.schema.json的正则会被校验拦截。排序每次改完先跑一遍python3 scripts/is_sorted.py乱序的列表会被直接指出。查重提交前用scripts/check/existing.py确认仓库不已经在 HACS 数据里避免重复条目。原因下架时一定要写清具体原因现有critical示例都是明确的安全问题描述空泛理由没有价值。最小 diff这是纯数据仓库一次变更只动你要动的那几行diff 越干净审核越快通过。下次发现 HACS 商店里某个扩展不见了先打开这个仓库的removed和blacklist搜一遍多数疑问当场就能解开。【免费下载链接】defaultThe home of the default HACS repositories.项目地址: https://gitcode.com/gh_mirrors/def/default创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表