@camstack/addon-provider-esphome

中文文档
0.1.17发布于 2026/11/08MITESM + CJS近 30 天下载 3062

CamStack的ESPHome设备提供者:每板一名经纪人,与esphome客户在本地API(噪音)上交谈

中文使用文档
文档目录9 节
  1. 它会做什么
  2. 绘图
  3. 行为
  4. 在哪里找到钥匙
  5. 已知限制
  6. 所需资源
  7. 它提供的东西
  8. 所需资源
  9. 文档

@camstack/addon-profer-esphome (英语)

CamStack的ESPHome设备提供器附加. 它会讲板的本地API(噪声加密或平通) esphome-client 将一个板子变成一个容器装置,每个实体有一个孩子.

它会做什么

  • 埃斯波马 (单位:千美元)provider-esphome:一个集成持有多块板(每块:主机,端口6053,加密密钥,可选的遗留密码),一个提出板的局域网扫描,并采用连接板.
    • 节点位置 : hub-only。 。 。 .
    • 能力: device-provider, (中文(简体) ), device-adoption。 。 。 .

绘图

一个板子是一个容器装置。 其实体成为儿童:

ESPHome实体卡姆施塔克儿童
切换切换
光线切换+亮度( 颜色尚未映射)
覆盖封面(打开、关闭、停止、位置)
按钮按钮
数字,选择控制
事件事件发射器( 重放状态永不起火)
传感器数值传感器,转换为数量基单位
文本传感器enum传感器
二进制传感器接触(门、窗、开口、车库门)、洪水(湿度)、烟雾、运动(运动、占用、存在),否则为二进制
动力、能、电压、电流、外观功率、动力因子传感器一个 power-meter 儿童

棋盘标记诊断或默认被禁用的实体及其状态二进制传感器不被采用.

行为

  • 现场直播通过订阅到达;没有投票.
  • 已失去的连接被重试后置( 1 s 翻倍到 60 s, 有 jitter) 。 棋盘拒绝的密钥或密码没有重试: 棋盘显示 auth-failed 直到操作员编辑它.
  • 一个无法到达的板子离线,从不为零:其子孙保留了最后的读取,容器也下线.
  • 加密密钥和遗留密码是密钥链密钥. 它们从未被读取过,从未被记录过,一个让字段空出保存所存储的值的保存.
  • 附加符只读取状态并发送一个操作员在被采纳的设备上触发的命令. 它从来不猜或尝试键.

在哪里找到钥匙

在董事会的ESPHome YAML下 api: encryption: key:在ESPHome仪表板中打开设备并选择编辑;在家庭助理中,它存储在ESPHome设备的集成条目中。 将其粘入棋盘行"Encription key"字段.

已知限制

  • 浅色和颜色温度没有映射 .
  • ESPHome子设备(软件2025.7及后期)的实体不与董事会本身分离.
  • 超过2024.4的固件未经检验.
  • 一个板只允许几个同时的API客户端(尤其是ESP8266);家庭助理持有其中之一.
  • 两个控制器可以写出相同的接力; CamStack 跟随状态的董事会报告.

所需资源

  • 已经在节点上的对等包 : @camstack/types, (中文(简体) ), zod。 。 。 .
  • 一个CamStack枢纽。 这个外加剂不会运行在代理.

软件包 @camstack/addon-provider-esphome 时间npm.

它提供的东西

  • 埃斯波马 (单位:千美元)provider-esphome:连接到一个ESPHome板上它原生的API,并采用它的开关,灯光,盖子,按钮,传感器,数字和选择. 类别:供应商.
    • 能力: device-provider, (中文(简体) ), device-adoption。 。 。 .

所需资源

  • 安置:只设枢纽.
  • 一个CamStack枢纽。 只有在上述放置允许的情况下才使用一种剂.

文档

见 变动情况 对于每个版本的变化.

版本与发布记录

@camstack/addon-provider-esphome 共发布 18 个版本,首次发布于 2026/10/27;过去 12 个月发布了 18 个版本。

版本发布日期距今
0.1.17latest2026/11/08今天
0.1.162026/11/072 天前
0.1.152026/11/072 天前
0.1.142026/11/063 天前
0.1.132026/11/063 天前
0.1.122026/11/054 天前

关于 @camstack/addon-provider-esphome 的常见问题

@camstack/addon-provider-esphome 是什么?

CamStack的ESPHome设备提供者:每板一名经纪人,与esphome客户在本地API(噪音)上交谈

如何安装 @camstack/addon-provider-esphome?

在项目目录运行 npm install @camstack/addon-provider-esphome,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.3.6)、@camstack/types(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@camstack/addon-provider-esphome 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/camstack__addon-provider-esphome 是否存在。

@camstack/addon-provider-esphome 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@camstack/addon-provider-esphome 可以商用吗?

@camstack/addon-provider-esphome 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@camstack/addon-provider-esphome 的下载量有多少?

根据 npm 官方下载统计,@camstack/addon-provider-esphome 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,062 次,日均约 102 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@camstack/addon-provider-esphome 还在维护吗?

最新版本 0.1.17 发布于 2026/11/08(今天);至今共发布 18 个版本,其中过去 12 个月发布了 18 个;首次发布于 2026/10/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。