ESPectre 教程：先在非关键房间测误报
ESPectre 利用 ESP32 读取 Wi-Fi CSI 变化，在设备上计算运动状态。它不拍照、不录音，但运动与占用数据仍能暴露作息。部署前应告知受影响的人，并在非安防、非医疗场景验证。
1. 准备硬件与网络
支持 ESP32-C6、C5、C3、S3、S2 和经典 ESP32。准备 USB 数据线与允许浏览器访问设备的局域网。除 C5 外以 2.4 GHz 为主；官方尚未刻画 5 GHz 检测质量。
2. 从官方 Flash 工具刷稳定固件
https://espectre.dev/tools/flash/
桌面 Chrome 或 Edge 支持 Web Serial，Firefox、Safari 和手机浏览器不支持这条路径。选择 Release，核对芯片、固件前端和是否擦除整块 flash 后再确认。
3. 连接并完成首次校准
Native 和 ESPHome 可通过 USB 配网；Matter 使用控制器配对。打开 Device settings 检查连接，再用 Monitor 查看有效 CSI 包、校准状态、运动分数和 idle 恢复。设备移动后重新校准。
4. 明确它不能做什么
在不同位置反复走动和静止，记录误报、漏报、接入点换频道和家具变化。ESPectre不能识别人、计数或证明房间为空，也不能替代合规安防、医疗和紧急系统。
与 Espressif esp-csi 对比
Espressif 的 esp-csi 仓库提供 CSI 底层示例和人体检测、定位等参考应用。ESPectre 增加现成固件、校准、检测器、Home Assistant/Matter 接口和浏览器工具。研究 CSI 原理可从 esp-csi 开始；需要房间运动传感器工作流时再评估 ESPectre。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合房间级灯光、空调和非安全关键提醒。它只能检测无线环境变化，不能识别人、计数、证明房间无人，也不能替代经过认证的安防、医疗或应急系统。
采用建议
ESPectre 提供了比底层 CSI 示例更完整的房间级运动传感器路线。先在非安全关键区域用稳定固件测试误报、漏报和网络变化，并处理同意与数据访问；医疗、安防和人员识别场景不应依赖它。
原教程未展开的系统信息
核心功能
本地 CSI 运动检测
设备读取 Wi-Fi 信道状态变化并输出运动状态与分数，原始 CSI 不必上传云端。
公开验证材料
仓库提供数据集、模型权重、训练流程、性能报告和失败实验记录，便于检查项目方结论。
架构与数据流
C++ 实现分为 frontend、runtime 和 core。前端负责 ESPHome、Native 或 Matter 接口，runtime 处理 CSI 输入、校准、事件与网络生命周期，core 保存可移植检测器和特征逻辑。Micro-ESPectre 提供另一条 MicroPython 路线。
技术栈和运行条件
语言
C++、Python/MicroPython、浏览器工具
框架
ESP-IDF、ESPHome、Matter、MQTT、Direct HTTP
关键依赖
- 受支持的 ESP32
- USB 数据线
- 2.4 GHz Wi-Fi；ESP32-C5 可用 5 GHz但检测质量尚未刻画
- 桌面 Chrome 或 Edge（浏览器刷写）
运行环境
每个感知区域通常需要一块板；浏览器与设备需能在局域网通信
核验与使用边界
优势与限制
优势
- 不采集图像或音频
- 本地处理且不强制云端
- 支持多种固件与 Home Assistant 接入
限制
- 家具、墙体、天线、接入点和频道变化会影响结果
- 每个感知区域通常需要一块板
- Matter 控制器兼容性仍在验证
排错时先核对版本、运行环境和未覆盖范围。这里没有执行过的步骤不会写成实测结论。
常见问题
ESPectre v3.0.0-rc2 是稳定版吗？
不是。它是 2026-09-16 发布的候选版；当前稳定版仍是 v2.8.0。普通安装应在 Flash 工具中选择 Release 通道。
ESPectre 能识别房间里是谁吗？
不能。官方说明它检测无线环境变化，不识别人、不计数，也不能证明房间为空。
ESPectre 一定要把数据上传云端吗？
不需要。检测在 ESP32 本地完成，原始 CSI 采集是可选功能；运动状态可通过局域网接口接入 Home Assistant。
闭源产品可以直接使用 ESPectre 吗？
开源代码默认受 GPLv3 约束。无法满足源码公开义务的闭源固件需与项目方洽谈商业许可，而且 ESPHome 前端仍只提供 GPLv3 路线。