RuView：WiFi 穿墙感知平台

项目简介

RuView（π RuView）是一个 WiFi 感知平台，把普通无线路由器发出的无线电波变成空间智能。人在空间中移动、呼吸、甚至静坐，都会对无线电波造成可测量的扰动；RuView 通过低成本 ESP32 传感器采集 Channel State Information（CSI），把这些扰动转成可用的数据：谁在那里、在做什么、状态是否正常。

它不依赖摄像头和可穿戴设备，可以穿墙、在黑暗中工作。项目主要用 Rust 编写，提供 npm 工具包 @ruvnet/ruview、ESP32 固件以及智能家居集成方案。

主要功能

• 存在与占用：穿墙检测人员、计数、追踪进出
• 生命体征：非接触测量呼吸率与心率，睡眠或静坐时同样可用
• 活动识别：依据时序 CSI 模式识别行走、坐姿、手势、跌倒
• 环境测绘：通过 RF 指纹识别房间、发现家具被移动、发现新物体
• 睡眠质量：整夜监测，含睡眠分期与呼吸暂停筛查
• 无摄像头姿态估计：从 WiFi CSI 估计 17 个身体关键点
• 内置模型工作流：录制 CSI、训练模型、加载 RVF 文件、切换 LoRA 配置
• 本地自动化 HOMECORE：提供状态、历史、自动化、签名 Wasm 插件、语音钩子与 HomeKit 支持
• 统一 RF 世界模型：把 WiFi CSI、雷达、UWB、蜂窝感知融合到一个隐私受限的场景模型中
• 可治理证据：为感知事件附加隐私策略、不确定性、溯源与见证记录
• RuView MetaHarness：由 AI 操作员引导完成上手、校准、训练、验证与结论核查

智能家居集成

原生支持四大智能家居生态：通过 HA-DISCO MQTT 发布器接入 Home Assistant；以可发现的 HAP-1.1 桥形式接入 Apple Home & HomePod；通过同一个 HA 桥或 Matter 端点接入 Google Home 与 Amazon Alexa。Siri、Google Assistant、Alexa 可以直接按房间播报存在状态和生命体征，无需自定义技能。

每个节点提供 21 个实体（11 个原始信号 + 10 个推断语义状态：有人睡觉、可能痛苦、房间活动、老人无活动异常、会议进行中、浴室占用、跌倒风险升高、离床、无移动、多房间切换），并附带 3 个入门 HA Blueprint。给 Home Assistant 加一个 --mqtt 参数即可接入。

安装与使用

npm install @ruvnet/[email protected]

通过 npx 直接运行 CLI：

# 检查本机环境并获取带出处引用的指引
npx @ruvnet/[email protected] doctor
npx @ruvnet/[email protected] guidance --topic sensing --query "model loading"

# 硬件：查看已接入设备、节点实时 CSI、60 GHz 雷达套件
npx @ruvnet/[email protected] devices
npx @ruvnet/[email protected] esp32 --watch
npx @ruvnet/[email protected] esp32 --seconds 45 --analyze
npx @ruvnet/[email protected] mmwave --source esphome --host <kit-ip>

# 智能体：MCP 走 stdio，或走 HTTP 供 ChatGPT 使用（令牌保护，只读工具）
npx @ruvnet/[email protected] mcp start
RUVIEW_MCP_GRANTS=device-access npx @ruvnet/[email protected] mcp start --http

# Claude Code：包内自带的实时感知面板（/ruview）
npx @ruvnet/[email protected] mod

# 通过 Codex 运行只读 RuView 智能体
npx @ruvnet/[email protected] agent run --host codex --repo . \
  --prompt "Find the nearest tests and cite the source files"

# 核查结论、重放确定性证明、检索已审阅知识库
npx @ruvnet/[email protected] claim-check --file REPORT.md
npx @ruvnet/[email protected] verify
npx @ruvnet/[email protected] brain search --query "calibration"

注意事项

• 智能体默认只读；写入工作区需要同时给出 --allow-write 与 --confirm。
• 读取硬件需要 device-access 授权；烧录与校准不会通过 HTTP 传输执行。
• 设备上报的生命体征被标记为未验证；检索到的知识库内容只作为证据，不作为权威结论。
• 统一 RF 世界模型的精度在通过真实数据验证前仍基于合成数据。
• 需要 ESP32 CSI 节点等硬件配合；接入 Home Assistant 需要 MQTT。

本作品整理自 GitHub 开源项目 ruvnet/RuView，原作者 @ruvnet，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。