📌 项目地址ruvnet/RuView | ⭐ 59,591 颗星 | 🔧 Rust | 📜 未标注

一句话说清RuView在做什么

RuView用现成的WiFi信号“看”穿墙壁。它不是雷达,不是摄像头,是分析人体对无线电波的扰动(Channel State Information,CSI)。硬件用ESP32(9美元)加一个Cognitum Seed边缘计算模块,所有处理在本地完成,不上传,不联网。

项目源码是Rust写的,GitHub上有59591颗星。我翻了三个月内的commit,v0.5.0-alpha,代码提交频率不高。

核心架构:ESP32 mesh + Cognitum Seed

最低部署要求:

  • 至少两块ESP32(确认支持CSI的版本,ESP32-WROOM-32常见)
  • 一块Cognitum Seed(项目自己的边缘AI硬件)
  • 一台支持CSI采样的路由器(README没列兼容列表,这是最大的坑)

运行模式是ESP32组成mesh网络,每个节点采集CSI数据,传给Cognitum Seed做推理。Seed运行的是脉冲神经网络(Spiking Neural Networks),README说“adapt in under 3”,后面没写单位。我猜是3秒或3分钟。

这个架构决定了以下几点:

  • 节点越多覆盖越好,但mesh同步问题越大
  • 硬件总成本:2块ESP32(18美元)+ 1块Seed(价格未公开,估计50-100美元),对比商用毫米波雷达(80-150美元/个)还是便宜
  • 所有模型训练需要针对自家环境做,没有预训练模型下载

21个实体,10个语义状态,3个Blueprint

这是RuView最具体的输出描述。每个节点暴露21个实体,分成两类:

  • 11个原始信号:CSI幅度、相位、子载波统计等(调试用)
  • 10个推断语义状态:someone-sleeping, possible-distress, room-active, elderly-inactivity-anomaly, meeting-in-progress, bathroom-occupied, fall-risk-elevated, bed-exit, no-movement, multi-room-transition

Home Assistant集成方式:节点启动加--mqtt参数。这是README原文给的唯一命令。没有提到配置文件的格式,也没有示例参数。

3个Home Assistant Blueprint我翻到了链接,文件名是类似blueprint_presence.yaml的结构。对标的是官方Blueprint市场的标准格式,可导入、可修改。

我的判断:10个语义状态里,someone-sleepingroom-active这类基础检测可能靠谱,fall-risk-elevatedpossible-distress属于高难度任务,没有公开的精度数据。工业级跌倒检测需要9轴IMU或多雷达融合,仅靠WiFi CSI信噪比不够。

三种集成方式,全部离线

Home Assistant

--mqtt参数,MQTT Broker需要在局域网内。每个节点独立发布主题,HA通过自动发现配置实体。这个流程和ESPhome类似,但没看到固件刷写工具。

Apple Home / HomePod

RuView以HAP-1.1桥接器身份出现在局域网。Home应用自动发现,不需要写代码或装插件。原理是Seed运行HAP协议栈,模拟成桥接设备。

Matter桥接

这是兼容范围最广的方式:Google Home、Alexa、SmartThings都能用。用户可以直接问“卧室有人吗”或“客厅还有没有人”,不需要配置自定义技能。

重要差异:HAP桥接只支持Apple Home,Matter桥接覆盖其余三家。不能同时启用两个协议。

59K星背后:认知落差

我翻了docs目录,结构如下:

  • docs/integrations/home-assistant.md:集成文档,基本是命令行示例
  • docs/user-guide-apple-homepod.md:Apple Home配置,和普通HAP桥接器一样
  • docs/adr/:架构决策记录,共130+个ADR,这是项目的亮点,每个决策都有文档

但缺少的内容:

  • 没有快速部署脚本
  • 没有路由器兼容列表
  • 没有“10分钟上手”指南
  • Issue区最多的问题是:“支持哪些路由器”和“哪里买硬件”,不是“我部署成功了,遇到XXX”

我猜:95%的Star用户是看到“隔墙看人”的概念后点了Star,没真正考虑部署。剩下5%尝试了,大部分卡在硬件兼容性上。

和毫米波雷达怎么选

特性 RuView 毫米波雷达(如LD2410)
硬件成本 $60-150(含Seed) $10-30(单模块)
隐私性 最好(无摄像头,无网络) 好(不记录图像)
部署门槛 高(需ESP32 mesh+Seed+路由器配置) 低(直连ESP32或USB)
生命体征 声称有心率和呼吸检测 仅呼吸(标准版),心率需高价模块
跌倒检测 声称支持,无精度数据 明确支持,有公开测试数据(通常>95%)
跟踪人数 支持 支持(最多3-5人)
社区生态 单项目 多方案,成熟产品多

我的判断:RuView的最大价值在于单节点覆盖广阔区域(房间+走廊),但单个传感器的小范围检测不如毫米波雷达可靠。如果你需要监控整个客厅加相邻书房,RuView可能更合适。如果你只需要床边的呼吸监测或卫生间跌倒检测,买毫米波雷达。

我的结论

RuView是目前最完整的开源WiFi感知工程实践。代码结构清晰,ADR文档达到商业软件水平,证明了“WiFi CSI做人体感知”这条路能走通。

但如果你想现在用,先回答四个问题:

  1. 你有支持CSI采样的路由器吗?(去GitHub Issues搜“supported router”看唯一讨论帖)
  2. 你能接受刷固件、搭mesh、调参数的一周学习成本吗?
  3. 你要检测的是房间存在感(靠谱)还是医疗级生命体征(不靠谱)?
  4. 你愿意为每块Seed付多少钱?(价格未公开)

如果以上回答都是“是”,那RuView值得折腾。如果不是,等社区出成品硬件或图形化固件刷写工具。

ruvnet ruview deployment guideruvnet ruview supported routers,结果都指向同一个GitHub Discussion帖。2月之前没有新进展。项目的核心团队在Cognitum官网,不开放用户群。

5000f3b93-77cf-4cf7-9a03-bb484a46d994

这篇文章对你有帮助吗?

发表回复