RuView 是 GitHub 上累積 89,915 個星標的開源 WiFi 感應平台,由 ruvnet 開發,定位為「將普通 WiFi 轉化為空間智能感應系統」。該項目以 Rust 撰寫、採用 MIT 授權,自 2025 年 6 月創立以來,透過利用 WiFi 訊號的 Channel State Information(CSI)技術,實現了無鏡頭、無穿戴裝置的人體偵測、生命體徵監測與穿牆空間感知,是無線感應領域近年最具話題性的開源項目之一。

RuView 是什麼?為何能用 WiFi 穿牆感應人體?
RuView 是一套開源 WiFi 感應平台,透過分析 ESP32 感應器捕捉的 Channel State Information(CSI)訊號,將人體對無線電波的擾動轉化為存在偵測、呼吸心率量測與活動辨識,全程無需鏡頭或穿戴裝置。
RuView 的核心原理建立在一個物理事實之上:WiFi 路由器發出的無線電波在穿透空間時,會被房間內的人體散射與擾動,而這些擾動可以被低成本的 ESP32 感應節點以 CSI 訊號的形式捕捉。系統再透過訊號處理與神經網路模型,從這些細微的訊號變化中重建出「房間內發生了什麼」——包括有誰在、在做什麼、呼吸與心跳頻率如何,甚至隔著牆壁都能感應。
該平台支援的存在偵測與生命體徵量測涵蓋多個層面:呼吸頻率透過 0.1 至 0.5 Hz 的頻段濾波與相位分析即時計算,心率則利用 0.8 至 2.0 Hz 頻段提取,兩者均以非接觸方式運作,使用者只需身處訊號覆蓋範圍即可。此外,系統還能進行多人計數、活動辨識、跌倒偵測、環境指紋映射與睡眠品質監測,並能估計 17 個身體關鍵點的姿態,形成一套完整的空間智能解決方案。
RuView 的 CSI 訊號處理架構有哪些技術亮點?
RuView 以多頻段融合與多站點融合架構處理 CSI 訊號:三個頻道乘五十六個子載波形成一百六十八個虛擬子載波,並以注意力加權的跨視角嵌入融合多個感應節點資料,再交由神經網路輸出關鍵點與生命體徵。
從技術架構觀察,RuView 的訊號處理管線相當完整。系統先由 4 至 6 個 ESP32 節點組成的網狀網路,以 TDM 協定在 1、6、11 三個頻道捕捉 CSI 訊號,再透過多頻段融合將三個頻道與五十六個子載波組合成一百六十八個虛擬子載波,擴展感應頻寬。隨後的多站點融合會將節點間的多條訊號鏈路以注意力加權方式整合,形成跨視角的空間嵌入,並以一致性閘控過濾不可靠的量測,使系統在無需重新調校的情況下穩定運行數日。
訊號處理層面,系統整合了 Hampel 濾波、SpotFi、Fresnel 幾何模型、BVP 與頻譜分析等經典無線感應技術,將原始 CSI 轉化為乾淨的特徵。其 AI 骨幹 RuVector 負責注意力機制、圖形演算法與訊號壓縮,最終由神經網路輸出人體關鍵點、生命體徵與房間模型。值得注意的是,RuView 具備自我學習能力:系統可在約三十秒內以尖峰神經網路適應新環境,並透過對比學習從原始 WiFi 資料自行建立房間指紋,毋須人工標註,配合 MERIDIAN 跨環境泛化機制,確保模型在不同房間均能維持表現。

RuView 的預訓練模型與基準測試表現如何?
RuView 的預訓練對比編碼器在 60,000 幀資料上訓練,達到 82.3% 的留出時間三元組準確率,4-bit 量化後僅 8KB;其公開的 MM-Fi 姿態估計模型以 82.69% 的 torso-PCK@20 超越既有學術基準。
RuView 將預訓練模型發布於 Hugging Face 平台,包括 CSI 編碼器與存在偵測頭。編碼器以 1,220 萬訓練步驟、60,000 幀與 610,000 對比三元組訓練而成,產生 128 維嵌入向量,在 M4 Pro 上達到每秒 164,183 次的嵌入計算速度;4-bit 量化版本僅佔 8KB,可在樹莓派上微秒級運行,並支援以 LoRA 適配器針對特定環境微調。系統亦提供 Docker 映像,讓沒有硬體的使用者能以模擬資料評估完整管線。
在姿態估計基準方面,RuView 發布的 MM-Fi 模型達到 82.69% 的 torso-PCK@20 準確率,三模型集成加上測試時增強後更提升至 83.59%,超越既有公開基準 MultiFormer 的 72.25% 與 CSI2Pose 的 68.41%,並以可審計的 AetherArena 排行榜公開驗證過程。該項目同時建立了可重現的證明機制:透過 SHA-256 雜湊比對,使用者能以單一指令重播確定性管線並核對輸出,確保 README 中宣稱的數字可以獨立驗證。
RuView 的邊緣運算生態與智慧家庭整合包含哪些內容?
RuView 提供涵蓋健康、安防、建築、零售、工業與 AI 領域的 105 個邊緣模組目錄,並原生整合 Home Assistant、Apple Home、Google Home 與 Alexa,每個節點可輸出二十一個實體資料。
RuView 的應用生態以「邊緣模組」為核心,官方目錄收錄 105 個經簽章的模組,涵蓋健康監測(睡眠窒息偵測、咳嗽偵測、心律不齊偵測)、安防(入侵偵測、槍聲偵測、徘徊偵測)、建築(電梯計數、能源審計、漏水偵測)、零售(客流統計、排隊時間估算、貨架互動偵測)、工業(無塵室人數控制、堆高機接近警示)與研究應用等類別。模組以簽章二進位形式在感應堆疊旁運行,系統會在空中更新目錄並於安裝前驗證每個模組,形成可擴展的感應功能市集。
智慧家庭整合方面,RuView 原生支援四大生態系統:透過 MQTT 發布器接入 Home Assistant,以 HAP-1.1 橋接成為 Apple Home 與 HomePod 可發現的裝置,並經由同一橋接或 Matter 端點接入 Google Home 與 Amazon Alexa。每個節點輸出二十一個實體,包括十一個原始訊號與十個推論語意狀態,例如「有人熟睡」「可能身體不適」「房間有人活動」「長者活動異常」「浴室有人」「跌倒風險升高」「離床」「無移動」等,Siri、Google Assistant 與 Alexa 可以直接語音查詢各房間的存在狀態與生命體徵,無需自訂技能。

如何快速開始使用 RuView?
使用 RuView 有四種途徑:以 Docker 映像搭配模擬資料評估、以約 9 美元的 ESP32-S3 節點進行即時感應、以約 54 美元的 ESP32 網狀網路部署完整功能,或透過 PyPI 安裝 Python 套件整合。
RuView 的入門門檻設計得相當彈性。沒有硬體的使用者可以透過 Docker 映像在模擬資料上運行完整管線,網頁介面會即時展示感應結果;具備基本動手能力的使用者則可購買約 9 美元的 ESP32-S3 開發板,刷入官方韌體並設定 WiFi 後,即可開始捕捉 CSI 訊號進行存在偵測與生命體徵量測。預算允許的話,以 3 至 6 個 ESP32 節點組成的網狀網路約 54 美元,能提供更完整的空間覆蓋與多人感應能力。
對於開發者,RuView 在 PyPI 發布了 ruview 與 wifi-densepose 兩個 Python 套件,內含已編譯的 PyO3 輪子檔案,可跨 Linux、macOS 與 Windows 使用,並提供非同步 WebSocket 與 MQTT 客戶端。進階使用者可以透過 Claude Code 或 Codex 外掛進行引導式設定、韌體燒錄、模型訓練與驗證,或以 npx @ruvnet/ruview 執行診斷與代理操作。項目官方強調目前仍屬 Beta 軟體,API 與韌體可能變更,建議感應節點使用兩個以上以獲得最佳空間解析度。
RuView 的技術誠信與開源治理有何特別之處?
RuView 以罕見的技術誠信著稱:主動撤銷了未經充分驗證的「100% 存在偵測」宣稱,改以誠實重測的 82.3% 準確率取代,並透過可重現證明、見證記錄與分級標註公開所有基準數字的真實成熟度。
RuView 在技術溝通上展現了開源項目中少見的自我約束。項目方主動撤銷了早期發布的「100% 存在偵測」數字,指該數字僅在單一類別錄音上量測,改以誠實重新基準測試的 82.3% 留出時間三元組準確率取代;對於姿態估計模型,README 更以分級方式明確標註哪些權重已驗證、哪些僅屬實驗性質、哪些只有架構而無權重,並公開承認單一 ESP32 的即時 17 關鍵點模型目前仍未達標且運行路徑尚未接線,要求使用者勿在達到基準前宣稱該功能可用。
這種誠實文化也體現在治理機制上:項目以 ADR 架構決策記錄、見證日誌與可重現證明流程建立了一套「宣稱可驗證」的體系,每個基準數字都有對應的產生方法與驗證指令,並設有 Trust Kill Switch 讓任何人以單一指令重播確定性管線核對結果。配合 MetaHarness 工具提供來源引用的引導、確定性驗證與真實性檢查,RuView 試圖建立一個「只發布可以被證明的事」的開源開發文化,這在充斥行銷宣稱的 AI 領域尤為可貴。
RuView 的市場定位與應用前景如何?
RuView 以無鏡頭、低成本的 WiFi 感應技術切入智慧家庭、健康照護與工業安全市場,透過避開影像隱私規範與 9 美元級硬體成本,有望成為邊緣感應領域的基礎設施型開源項目。
在市場定位上,RuView 填補了一個獨特的技術空白:傳統空間感應依賴鏡頭(有隱私爭議)或穿戴裝置(有使用負擔),而 RuView 僅需部署 WiFi 訊號即可達成類似效果,且由於不涉及影像,部署可從根本上避開 GDPR 影片監控與 HIPAA 影像等隱私法規的限制,這使其在醫療照護、零售分析與工業安全等對隱私敏感的場景具備明顯優勢。成本方面,9 美元級別的感應節點與 140 美元的全套系統(含持久記憶體與見證鏈),遠低於傳統感應方案,適合大規模部署。
從生態發展角度,RuView 已形成從硬體韌體、訊號處理、預訓練模型、邊緣模組市集到智慧家庭整合的完整鏈路,並以 105 個模組涵蓋健康、安防、建築、零售與工業等多元應用。其在姿態估計基準上的公開領先成績、可重現的驗證機制與誠實的技術溝通,為項目建立了學術與實務社群之間的橋樑。隨著邊緣 AI 與隱私保護需求持續增長,RuView 作為開源 WiFi 感應的基礎設施型項目,預期將在健康監測、長者照護與空間智能領域獲得持續關注。
出處連結有哪些?
本文資料來源為 ruvnet/RuView 的 GitHub 官方倉庫、README、Hugging Face 預訓練模型頁面與官方網站,完整出處見文末。
本篇文章的原始資料來自 RuView 官方 GitHub 倉庫(ruvnet/RuView),包括 README 的 How It Works、Edge Module Catalog、Pretrained model、Model weights: what’s real, what’s not 與 Beta software 章節、Hugging Face 平台上的 wifi-densepose-pretrained 與 wifi-densepose-mmfi-pose 模型頁面,以及官方網站 Cognitum.One。讀者如欲查閱完整技術文件、基準測試細節與硬體設定指引,可直接前往 GitHub 倉庫瀏覽。