RuView——用 WiFi 信号穿墙“看见”人的开源神器

你有没有想过，你家里那个天天开着、你觉得没啥大用的 WiFi 路由器，其实可以变成一台穿墙"雷达"？

不需要摄像头，不需要手环，不需要任何穿戴设备——就是利用 WiFi 信号本身，就能检测到房间里有没有人、有几个人、在干什么、甚至呼吸和心跳频率。

听起来像科幻？不，这是真实存在的开源项目，叫做 RuView。

🔬 核心亮点：WiFi 怎么"看见"人？

原理其实很物理：当人在 WiFi 信号覆盖范围内活动时，身体会对无线电波产生反射、散射和遮挡。这些微弱的信号变化，叫做 信道状态信息（CSI，Channel State Information）。

RuView 使用低成本的 ESP32-S3 开发板（约 60-80 元一块）作为传感器节点，捕获这些 CSI 数据，然后通过信号处理和机器学习算法，把"信号扰动"翻译成有意义的空间信息。

简单来说：你的路由器是"发射器"，ESP32 是"接收器"，RuView 是大脑。

⚡ 核心功能

1. 👤 存在检测与人数统计 — 穿墙检测是否有人、有几个人、进出方向
2. 🫁 呼吸监测 — 非接触式实时检测呼吸频率（6-30 BPM），睡着也能测
3. 💓 心率监测 — 非接触式心率检测（40-120 BPM）
4. 🦴 人体姿态估计 — 17个关键点的骨骼姿态重建，不需要摄像头
5. 🚶 活动识别 — 走路、坐下、手势、跌倒检测
6. 🏠 房间指纹识别 — 通过 RF 指纹识别房间、检测家具移动
7. 🛏️ 睡眠质量监测 — 睡眠阶段分类、呼吸暂停筛查

🔧 快速上手

RuView 提供了三种上手路径，从简单到复杂：

方式一：Docker 快速体验（无需硬件）

# 拉取镜像并运行（使用模拟数据体验完整 UI）
docker pull ruvnet/wifi-densepose:latest
docker run -p 3000:3000 ruvnet/wifi-densepose:latest

# 浏览器打开 http://localhost:3000 即可看到仪表盘

方式二：单节点 ESP32-S3 实时感知（推荐入门）

# 1. 烧录固件到 ESP32-S3
python -m esptool --chip esp32s3 --port /dev/ttyUSB0 --baud 460800 \
  write_flash 0x0 bootloader.bin 0x8000 partition-table.bin \
  0xf000 ota_data_initial.bin 0x20000 esp32-csi-node.bin

# 2. 配置 WiFi 连接
python firmware/esp32-csi-node/provision.py --port /dev/ttyUSB0 \
  --ssid "你的WiFi名称" --password "你的WiFi密码"

# 3. 启动 RuView 服务（自动发现 ESP32 节点）
docker run -p 3000:3000 --network host ruvnet/wifi-densepose:latest --mqtt

方式三：多节点 Mesh 部署（最佳效果）

# 部署 3-6 个 ESP32-S3 节点覆盖全屋
# 每个节点 $9，全屋覆盖成本约 $27-54
# 节点间自动进行时隙分配和信道跳频
# 支持多频段 Mesh 扫描，利用邻居路由器作为"免费雷达发射器"

🏠 智能家居集成

RuView 原生支持主流智能家居平台：

• 🏠 Home Assistant — 一键接入，--mqtt 参数搞定，每节点提供 21 个实体
• 🍎 Apple Home — 通过 Matter Bridge 接入
• 🤖 Google Home / Alexa / SmartThings — 均支持

完全本地运行，不需要云服务器，不需要互联网，数据不出你家。

💰 成本分析

⚠️ 客观评价：哪些是真的，哪些需要冷静

RuView 确实很酷，但作为负责任的推荐，必须说清楚它的真实状态：

✅ 可信的

• 存在检测和运动感知 — 基于 CSI 的存在检测是经过充分验证的技术，准确率高
• 呼吸监测 — 呼吸引起的胸腔运动对 CSI 影响明显，信号强，可靠
• 学术基础扎实 — 基于 CMU 的 "DensePose From WiFi" 论文，不是伪科学
• 开源完整 — GitHub 仓库包含固件、后端、前端、文档，不是空壳

⚠️ 需要冷静的

• 穿墙姿态估计 — README 自己承认纯 WiFi 姿态精度有限（PCK@20 约 2.5%），最佳效果需要先用摄像头做"真值训练"
• 心率检测 — 微小心跳引起的 CSI 变化极弱，实际效果因人而异
• 独立可复现性 — GitHub 上有用户质疑无法复现部分结果，项目仍处于 Beta 阶段
• 工程成熟度 — Windows 网络配置、ESP32 固件稳定性等问题仍存在

🎯 适用场景

• 👴 老人居家监护 — 非接触式检测跌倒、长时间无活动告警、睡眠呼吸监测
• 🏠 智能家居感知 — 人在哪、在干什么，自动调节灯光/温度
• 🔒 隐私敏感场所 — 卫生间、卧室等不适合装摄像头的地方
• 🧪 极客研究 — WiFi 感知、边缘 AI、信号处理的学习平台

📝 总结

RuView 是目前最完整、最开源的 WiFi 空间智能感知平台。它的学术基础是真实的，代码是开源的，硬件成本是极低的。

但它不是魔法。穿墙看到完整人体骨骼这种事，目前还做不到。它最有价值的场景是存在检测、呼吸监测和智能家居集成——这些是经过验证、确实能用的。

如果你对"不用摄像头也能感知空间"这件事感兴趣，RuView 是目前最值得关注和尝试的开源项目。毕竟，用 $9 的 ESP32 把路由器变成雷达，光是这个想法就已经够酷了。

🔗 项目地址

• GitHub：github.com/ruvnet/RuView
• 在线文档：ruvnet.github.io/RuView
• 预训练模型：huggingface.co/ruvnet/wifi-densepose-pretrained