# @camstack/addon-provider-esphome 中文文档

规范地址：https://npmcn.com/package/%40camstack/addon-provider-esphome/

版本：0\.1\.17
npm 元数据更新时间：2026-11-08T12:25:15.758Z
中文译文更新时间：2026-11-09T01:05:37.061Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40camstack/addon-provider-esphome
原文对照：https://npmcn.com/package/%40camstack/addon-provider-esphome/?lang=original
项目主页：https://camstack-docs.zentik.app/
源码仓库：https://github.com/camstack/server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：7.1 MB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：zod ^4\.3\.6，@camstack/types \*
- 首次发布：2026-10-27T12:42:21.456Z
- 最新版本发布：2026-11-08T12:25:15.591Z
- 近 30 天下载量：3062（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

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

## 安装

```sh
npm install @camstack/addon-provider-esphome
```

也可以使用：`pnpm add @camstack/addon-provider-esphome`、`yarn add @camstack/addon-provider-esphome`、`bun add @camstack/addon-provider-esphome`

## README

# @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枢纽。 只有在上述放置允许的情况下才使用一种剂.

## 文档

-   [文件/建筑/设备-模型](https://github.com/camstack/server/blob/main/docs/architecture/device-model.md)

见 [变动情况](https://npmcn.com/package/%40camstack/addon-provider-esphome/CHANGELOG.md) 对于每个版本的变化.

## 常见问题

### @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 和提交记录判断。