项目说明
RuView 是什么
RuView 做的事听起来像科幻:把普通 WiFi 变成一套空间感知系统。它能检测有没有人、测量呼吸和心率、追踪移动、监控房间——靠的是 WiFi 信号的变化,不需要摄像头,也不需要戴任何设备。官方原话是「只是物理」,穿墙、黑暗中都能工作。
它面向低功耗边缘场景,提供了 Hugging Face 上的预训练模型,并明确区分了「真实可用的模型权重」和「尚不可靠的部分」,没有把话说满。
| 能力 | 说明 |
|---|---|
| 存在检测 | 判断房间有没有人 |
| 体征监测 | 呼吸频率、心率 |
| 移动追踪 | 空间内的移动轨迹 |
| 穿墙与暗光 | 不受视线和光照影响 |
| 无穿戴 | 不需要任何可穿戴设备 |
| 智能家居 | 原生接 Home Assistant、Apple Home/HomePod(HAP-1.1)、Google Home、Amazon Alexa |
边缘模块目录按领域分得很细:健康 14 个、安全 14 个、建筑 11 个、零售 7 个、工业 7 个、研究 12 个、AI 15 个、群体 11 个。接上智能家居后,Siri、Google Assistant、Alexa 可以直接按房间播报有没有人和体征情况,不需要写自定义技能。
RuView 怎么安装
用 npx 跑官方 CLI,先做自检:
npx @ruvnet/ruview@0.9.1 doctor
列出可识别的设备:
npx @ruvnet/ruview@0.9.1 devices
接 ESP32 / Realtek RAC1 节点做实时 CSI 采集:
npx @ruvnet/ruview@0.9.1 esp32 --watch
想先看效果可以用采到的数据跑分析:
npx @ruvnet/ruview@0.9.1 esp32 --seconds 45 --analyze
RuView 怎么使用
- 先跑
doctor确认环境没问题,再用devices看能接哪些硬件。 - 接 ESP32 或毫米波套件采集 CSI 数据,
--watch可以实时看波形。 - 用
--analyze跑体征内核,验证呼吸/心率估计在你的环境里是否可信。 - 要把结果接进智能家居,走 HA-DISCO MQTT publisher(Home Assistant)、HAP-1.1 bridge(Apple Home)或 Matter 端点。
- 需要被其他 Agent 调用就起 MCP 服务:
npx @ruvnet/ruview@0.9.1 mcp start。 - 按场景挑边缘模块,不要一次全开——不同模块对硬件和布置的要求不一样。
RuView 适合谁用
- 做居家养老、独居监护,需要在不装摄像头的前提下监测体征的场景。
- 隐私敏感环境(卧室、卫生间、更衣区)需要存在检测的场所。
- 智能家居玩家想让人体感应从「红外感应」升级到「感知体征」。
- 零售、建筑、工业场景需要低成本空间感知数据的团队。
- 要求医疗级精度的体征数据——它不是医疗设备,务必看清官方对模型可信度的说明。
RuView 项目地址
- GitHub 仓库:https://github.com/ruvnet/RuView
- 项目官网:https://cognitum.one
- 预训练模型(Hugging Face):https://huggingface.co/ruvnet
- npm 包:https://www.npmjs.com/package/@ruvnet/ruview