RuView 官方 Claude Code / Codex 插件完全指南用 /ruview-* 命令与 Skill 驱动 WiFi 感知全流程【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView导读本文围绕 RuViewWiFi-DensePose仓库内的官方 AI 编码助手插件 plugins/ruview/README.md 展开系统讲解这个「mega-plugin」如何把 RuView 从入门到进阶的完整工作流Docker 演示、ESP32 硬件烧录与配网、传感应用运行、模型训练、多站感知、见证校验打包为可自动发现的 Skill、斜杠命令与 Agent并为 OpenAI Codex 提供完整镜像。读完本文你将掌握该插件的安装方式、内部目录契约、全部 Skill/命令/Agent 的职责分工、smoke.sh结构校验逻辑以及 ADR-0001 所定义的插件契约与命名空间协调规则。一、插件定位从「反复手抄工作流」到「一条命令直达」RuView 是一个大型双代码库项目Rustv2/、Pythonarchive/v1/、ESP32 固件、96 份 ADR。新用户与运维人员经常需要反复推导同一套工作流启动 Docker 演示、烧录并配网一个 ESP32、运行传感应用、训练姿态模型、执行见证校验witness verification。ADR-0001 指出这些工作流需要一个单一、可发现的 Claude Code 插件来承载并镜像到 Codex覆盖「practical → advanced」的完整跨度。该插件的名称与版本见 plugin.jsonname: ruview、version: 0.3.0、license: MIT关键词覆盖wifi-sensing、csi、esp32、pose-estimation、vital-signs、edge-ai等。插件描述明确其能力范围onboarding、ESP32 硬件设置、配置、传感应用、模型训练、高级多站感知、见证校验、BFLD 隐私层以及 rvAgent RVF 智能体流程。设计上它是一个「mega-plugin」——不拆分子插件广度靠 Skill 组织ADR-0001 Decision #1。代价是安装粒度较粗要么获得全部 9 个 Skill要么一个都没有。二、安装与本地测试2.1 Claude Code 安装市场方式仓库根目录的 .claude-plugin/marketplace.json 声明了名为ruview的市场marketplace其插件source指向./plugins/ruview。Claude Code 在克隆仓库的根目录查找.claude-plugin/marketplace.json因此市场清单必须放在仓库根ADR-0001 Decision #1。安装命令# In Claude Code — add this repo as a plugin marketplace, then install: /plugin marketplace add ruvnet/RuView /plugin install ruviewruview2.2 本地免安装试用从仓库克隆中直接指定插件目录即可无需安装claude --plugin-dir ./plugins/ruview2.3 CodexOpenAI CLI安装Codex 镜像位于 plugins/ruview/codex/README.md七个/ruview-*命令全部镜像为 Codex prompt另有AGENTS.md承载项目规则。按用户级安装mkdir -p ~/.codex/prompts cp plugins/ruview/codex/prompts/*.md ~/.codex/prompts/ # now in the codex TUI: /ruview-start /ruview-flash /ruview-app /ruview-train /ruview-verify /ruview-advanced项目规则方面Codex 会在仓库根与工作目录自动发现AGENTS.md可软链或复制ln -s plugins/ruview/codex/AGENTS.md AGENTS.md # repo root (if you dont already have one)可选配置将 prompts 目录软链到~/.codex/prompts/ruview以保持随仓库版本化。三、插件内部结构目录契约与自动发现ADR-0001 Decision #2 定义了严格的目录契约。完整结构如下.claude-plugin/marketplace.json # REPO ROOT — marketplace name ruview, plugin source ./plugins/ruview plugins/ruview/.claude-plugin/plugin.json # name, description, version, author, homepage, license, keywords — NO skills/commands/agents arrays plugins/ruview/skills/name/SKILL.md # frontmatter: name, description, allowed-tools plugins/ruview/commands/name.md # frontmatter: description ( argument-hint) plugins/ruview/agents/name.md # frontmatter: name, description, model plugins/ruview/docs/adrs/0001-ruview-plugin-contract.md plugins/ruview/scripts/smoke.sh # structural contract plugins/ruview/codex/AGENTS.md codex/README.md codex/prompts/*.md # Codex mirror plugins/ruview/README.md # Compatibility Namespace coordination Verification ADR sections关键设计Skill/命令/Agent 全部由目录树自动发现plugin.json刻意不枚举它们ADR-0001 Decision #2smoke.sh 第 4 项也会校验这一点。因此新增一个 Skill 只需在skills/下新建目录与SKILL.md无需改任何清单文件。从当前仓库文件列表可以确认实际落盘情况Skills10 个目录见 skills/ruview-quickstart、ruview-hardware-setup、ruview-configure、ruview-applications、ruview-model-training、ruview-advanced-sensing、ruview-cli-api、ruview-mmwave、ruview-verify以及 README/ADR 计数之外的ruview-rvagent对应 plugin.json 中声明的rvagentMCP Servernpx -y ruvnet/rvagent。Commands7 个见 commands//ruview-start、/ruview-flash、/ruview-provision、/ruview-app、/ruview-train、/ruview-advanced、/ruview-verify。Agents3 个见 agents/ruview-onboarding-guide、ruview-config-engineer、ruview-training-engineer。Codex 镜像codex/prompts/下 8 个 prompt 文件7 个命令镜像 ruview-rvagent.md。四、Skill 总览九大能力模块Skill 是插件的主体每个SKILL.md以 frontmatter 声明name、description、allowed-tools。下表继承自插件 README 并补充说明Skill职责ruview-quickstart上手与首次运行——Docker 演示、仓库构建、最快路径跑通实时看板ruview-hardware-setupESP32-S3 / C6 固件构建、烧录、WiFi 配网、串口监控ruview-configuresdkconfig 变体、NVS 配网、信道/MAC 覆盖ADR-060、边缘模块ADR-041、sensing-server 参数、Mesh、Cognitum Seedruview-applications运行存在检测、生命体征、姿态WiFlow、睡眠、环境映射、MAT、点云融合、新型 RF 应用ruview-model-training无相机姿态、相机监督姿态92.9% PCK20ADR-079、RuVector 嵌入AETHER、域泛化MERIDIAN、本地 SNN、GCloud GPU、HF 发布ruview-advanced-sensingRuvSense 多站感知、跨视角融合、RF 断层成像、持久场模型、意图信号、对抗检测、Mesh 安全ruview-cli-apiwifi-denseposeCLI 二进制含 MAT 子命令、REST APIwifi-densepose-api、浏览器/WASMwifi-densepose-wasm、wifi-densepose-wasm-edgeruview-mmwavemmWave / FMCW 雷达——ESP32-C6 MR60BHA260 GHz HR/BR/presence、HLK-LD241024 GHz、mmWave↔CSI 融合48 字节融合生命体征ruview-verifyRust 测试、确定性 Python 证明、固件哈希、ADR-028 见证包 自校验、合并前检查清单从 ruview-quickstart/SKILL.md 可以还原三条上手路径TierTier 0无硬件约 2 分钟docker pull ruvnet/wifi-densepose:latestdocker run -p 3000:3000 ruvnet/wifi-densepose:latest打开http://localhost:3000即可获得模拟 CSI 数据与完整 UI适合演示、探索 API、无传感器开发 UI。Tier 1源码构建cd v2 cargo test --workspace --no-default-features1,400 测试约 2 分钟单 crate 快速检查cargo check -p wifi-densepose-train --no-default-features确定性 Python 证明python archive/v1/data/proof/verify.py必须输出VERDICT: PASS。若 numpy/scipy 升级导致哈希不匹配可先--generate-hash再验证。Tier 2真实 ESP32-S3 感知交给ruview-hardware-setup完成烧录/配网/监控闭环后cd v2 cargo run -p wifi-densepose-sensing-server消费 ESP32 UDP CSI 流辅助工具node ../scripts/rf-scan.js --port 5006RF 房间扫描与node ../scripts/snn-csi-processor.js --port 5006SNN 实时学习。Quickstart 还明确了几条硬性约束原始 ESP32 与 ESP32-C3 不支持单核无法跑 CSI DSP 流水线单节点空间分辨率有限建议 2 节点或加 Cognitum Seed无相机姿态精度有限约 84 秒训练、PCK 中等追求 92.9% PCK20 需走相机监督训练整个方案无云、无网、无摄像头全部在边缘硬件上运行。五、Commands七条斜杠命令的工作流串联命令用途/ruview-start上手——在 Docker / 源码构建 / 硬件三条路径中选择并引导走通/ruview-flash构建 烧录 ESP32 固件8MB / 4MB确认 CSI 流/ruview-provision向节点写入 WiFi 凭据、sink IP、信道 / MAC 过滤/ruview-app运行一个传感应用/ruview-train训练 / 评估 / 发布模型含 GPU/ruview-advanced使用多站 / 断层成像 / 跨视角 / Mesh 安全特性/ruview-verify运行信任流水线 合并前检查清单以 ruview-start.md 为例命令带argument-hint: [docker|build|hardware]执行时先调用ruview-quickstartSkill再按$ARGUMENTS直达对应层级并警告三大坑ESP32-C3 / 原始 ESP32 不支持、单节点空间分辨率有限、无相机姿态建议改用相机监督92.9% PCK20。ruview-train.md 则把训练拆成五条轨道对应ruview-model-trainingSkillcamera-freeTrack A预训练 训练两步、camera-supervisedTrack B收集-对齐-训练-评估92.9% PCK20、embeddingsTrack CAETHER ADR-024、domain-genTrack D/ snnTrack E、gpuGCloud--gpu l4 --hours 2或--gpu a100 --sweepVM 默认训练后自动删除除非--keep-vm。训练后校验cargo test --workspace --no-default-featurespython archive/v1/data/proof/verify.py发布走python scripts/publish-huggingface.py最后交给/ruview-verify生成见证包。六、Agents三位专职角色的分工Agent角色ruview-onboarding-guide带领新人从零到可用环境ruview-config-engineer搭建/调优部署固件、NVS、边缘模块、Mesh、Seedruview-training-engineer训练、评估、发布模型Agent 的 frontmatter 要求namedescriptionmodel三字段smoke.sh 第 8 项强制校验。七、源码级纵深配置参数与实战细节7.1 固件构建期配置sdkconfig 变体ruview-configure/SKILL.md 给出三套构建期变体变体文件适用场景8MB默认firmware/esp32-csi-node/sdkconfig.defaults.templateESP32-S3 8MB全特性真实 WiFi CSI4MBfirmware/esp32-csi-node/sdkconfig.defaults.4mbESP32-S3 SuperMini 4MB——禁用显示、双 OTA 槽partitions_4mb.csv各约 1.856 MBHeltec N16R2firmware/esp32-csi-node/sdkconfig.defaults.heltec_n16r2Heltec 板卡切换方式为cp对应 defaults 文件覆盖sdkconfig.defaults后重新构建。严禁用 mock 模式测试——Kconfig 跌倒阈值 bug 只在真实 CSI 下暴露ruview-hardware-setup中亦有同样警告。7.2 运行时设备配置NVS 配网参数表provision.py通过串口写入csi_cfgNVS 命名空间。以下参数表继承自 configure Skill是实际配网时的权威参考Windows 下--help需PYTHONUTF81帮助文本含非 ASCII 字符python firmware/esp32-csi-node/provision.py --port COM8 \ --ssid WiFi --password secret \ --target-ip 192.168.1.20 --target-port 5005 \ # aggregator UDP sink (port default 5005) --node-id 1 \ # 0-255 --channel 6 --filter-mac AA:BB:CC:DD:EE:FF # ADR-060: pin channel filter transmitter参数组Flags说明WiFi / sink--ssid--password--target-ip--target-port(5005)--node-id--node-id取值 0-255TDM Mesh--tdm-slot--tdm-total0 基槽位索引 节点总数——多节点 Mesh 的时隙分配方式边缘处理--edge-tier {0,1,2}0关闭1统计2生命体征ADR-041检测阈值--pres-thresh(50)--fall-thresh(15000 → 15.0 rad/s²)高人流区域调高--fall-thresh降低误报issue #263生命体征--vital-win(300 帧)--vital-int(1000 ms)--subk-count(32Top-K 子载波)信道/跳频--channel(1-14 / 36-177覆盖 AP 自动检测)--filter-mac--hop-channels(1,6,11)--hop-dwell(200 ms)省略--channel并设置--hop-channels启用 ADR-061 多频跳频省略--filter-mac捕获全部发射端Cognitum Seed--seed-url(http://10.1.10.236)--seed-token(Bearer来自配对)--zone(lobby)Swarm--swarm-hb(30 s)--swarm-ingest(5 s)心跳 向量摄取间隔模式--dry-run(只生成 NVS bin 不烧录)--baud(460800)--force-partial重要警告issue #391烧录会整体替换csi_cfg命名空间——CLI 未传的键全部被擦除。务必一次传全所需参数或明知后果地使用--force-partial。不确定时先读设备串口启动日志adaptive_ctrl/csi_collector行确认当前值。大规模批量配网可用scripts/generate_nvs_matrix.py生成 NVS 分区镜像。7.3 硬件设置Windows 构建的 Python 子进程模式ruview-hardware-setup/SKILL.md 记录了 ESP-IDF v5.4 不支持 MSYS2/Git Bash 这一关键前提因此 Windows 下构建必须通过 Espressif Python venv 以子进程方式执行并剥离MSYSTEM*环境变量。该 Skill 还给出 esptool 直接烧录命令python -m esptool --chip esp32s3 --port COM8 --baud 460800 \ write_flash 0x0 firmware/esp32-csi-node/build/bootloader/bootloader.bin \ 0x8000 firmware/esp32-csi-node/build/partition_table/partition-table.bin \ 0xf000 firmware/esp32-csi-node/build/ota_data_initial.bin \ 0x20000 firmware/esp32-csi-node/build/esp32-csi-node.bin以及常见问题排查表MSys/Mingw is no longer supported、cmd.exe /C挂起、cmake not found路径错误、python_env not found缺IDF_PYTHON_ENV_PATH、sink 收不到 CSI 帧、误报跌倒等。板卡形态警告小尺寸克隆板ESP32-S3-Zero、SuperMini 等散热余量小而该固件持续满功率开 WiFiWIFI_PS_NONE并跑完整 DSP 流水线edge_tier2现场曾出现板子过热后无法再开机疑似稳压器损坏需保证通风并在部署初期触摸检查。7.4 传感应用与训练轨道ruview-applications列出了完整应用目录穿墙存在/占用检测~0.012 ms 延迟、生命体征呼吸 6–30 BPM 带通 0.1–0.5 Hz、心率 40–120 BPM 带通 0.8–2.0 Hz见wifi-densepose-vitalscrate / ADR-021、活动识别RuvSensegesture.rsDTW pose_tracker.rs、17 关键点姿态WiFlow、睡眠监测与呼吸暂停筛查、环境映射--build-index env、大规模伤员评估 MATwifi-densepose-matcrate、3D 点云融合MiDaS 深度 WiFi CSI mmWave~22 ms / 19K 点每帧、以及新型 RF 应用被动雷达、材料分类、设备指纹、mincut 人数统计。ruview-model-training给出五条训练轨道与 GCloud GPU 训练命令bash scripts/gcloud-train.sh --dry-run冒烟 →--gpu l4 --hours 2原型 →--gpu a100 --config scripts/training-config-sweep.json→--sweep全超参扫描VM 训练后自动删除除非--keep-vm以及数据布局data/recordings/原始 CSI、data/csi/预训练集、data/mmfi/MM-Fi 数据集、data/paired/相机-CSI 配对样本、data/ground-truth/MediaPipe 关键点。本地 Mac 训练走bash scripts/mac-mini-train.sh。八、兼容性Claude CodeSkill、命令、Agent 自动发现无需claude-flowMCP 服务器——Skill 直接驱动 RuView 自身工具链cargo、python、idf.py、docker、node。仅安全相关改动可选引用npx claude-flow/clilatest security scan。CodexOpenAI CLI工作流镜像在codex/prompts/可放入~/.codex/prompts/或让 Codex 指向codex/codex/AGENTS.md承载项目规则。目标仓库假定为ruvnet/RuView/wifi-densepose布局v2/crates/、firmware/esp32-csi-node/、archive/v1/、scripts/、docs/adr/。Windows 下 ESP-IDF 构建走CLAUDE.local.md中的 Python 子进程模式ESP-IDF v5.4 与 Git Bash 不兼容。九、命名空间协调插件认领 kebab-case 的ruview-*命名空间9 个 Skill 7 个命令 3 个 Agentruview-verify同时是 Skill 与命令的 stem——Claude Code 两者都能解析但claude plugin details会重复列出。插件不写入任何claude-flow内存命名空间若与ruflo市场组合使用遵循ruflo-agentdbADR-0001 §Namespace convention两者零重叠ruview-*vsruflo-*。十、验证smoke.sh 结构契约bash plugins/ruview/scripts/smoke.shsmoke.sh 实现 ≥13 项检查是插件的「结构化冒烟测试」覆盖仓库根.claude-plugin/marketplace.json存在、列出ruview且source指向./plugins/ruviewplugin.json 含name/description/versionplugin.json 含keywordsplugin.json不含skills/commands/agents数组自动发现契约每个skills/*/SKILL.md有namedescriptionallowed-tools且allowed-tools无通配符*/all tools9 个期望 Skill 全部存在每个commands/*.md有description每个agents/*.md有namedescriptionmodelREADME 含## Compatibility与Namespace coordination段落ADR-0001 存在且Status: ProposedCodex 镜像存在AGENTS.mdprompts/ 11b.命令↔prompt 奇偶校验——每个commands/name.md都有匹配的codex/prompts/name.md.claude-plugin/下无错放的 skills/commands/agents。脚本以set -u运行任何 FAIL 都会以非零退出码结束——这让插件与 Codex 镜像之间的漂移「可见化」。十一、架构决策ADR-0001plugins/ruview/docs/adrs/0001-ruview-plugin-contract.md 状态为Proposed2026-05-11核心决策单一 mega-plugin 仓库根市场清单市场名ruview插件source: ./plugins/ruview目录契约Skill/命令/Agent 自动发现不写入 plugin.jsonShell 优先的 Skillallowed-tools限于核心工具Bash/Read/Write/Edit/Glob/Grep无mcp__claude-flow__*依赖、无通配符工具命名空间ruview-*与ruflo-*零重叠Codex 镜像完整命令奇偶7 个命令全部有对应 promptsmoke 强制校验存在性奇偶非内容奇偶兼容性面面向wifi-densepose仓库布局硬件文档默认 COM8 并要求读者确认串口Smoke 契约≥13 项结构检查。ADR 也坦承成本mega-plugin 安装粒度粗Codex 镜像需手工同步smoke 只查存在性奇偶、不查内容奇偶ruview-verify存在 Skill/命令 stem 碰撞。后续计划包括按生命周期拆分ruview-edge、ruview-train、增加内容级奇偶 lint、以及针对真实代码树验证底层命令旗标sensing-server --help、gcloud-train.sh、provision.py。十二、硬件注意事项串口与平台插件文档默认 ESP32 串口为COM8——已对照一块运行 RuView CSI 固件的ESP32-S3USB VID:PID303A:1001Espressif确认串口监视器可见实时adaptive_ctrltick 与csi_collector: CSI cb #… len128 …日志。仓库CLAUDE.local.md历史上引用过COM7部分 README 片段引用COM9。烧录前务必确认实际端口python -c import serial.tools.list_ports as l; print([p.device for p in l.comports()])或设备管理器。Windows 下provision.py --help需PYTHONUTF81才能正常打印帮助文本含非 ASCII 字符。十三、扩展阅读路径插件文档与契约插件 README、ADR-0001、市场清单、plugin.jsonSkill 源码quickstart、hardware-setup、configure、applications、model-training命令与 Codex 镜像commands、codex/README.md、codex/prompts冒烟测试scripts/smoke.sh底层固件与脚本firmware/esp32-csi-node/provision.py、scripts/gcloud-train.sh、scripts/publish-huggingface.py相关 ADR 索引ADR-021生命体征、ADR-024AETHER 对比嵌入、ADR-027MERIDIAN 域泛化、ADR-028ESP32 能力审计 见证、ADR-041边缘模块、ADR-059实时 ESP32 流水线、ADR-060信道/MAC 覆盖、ADR-061QEMU Mesh、ADR-079相机地面真值训练、ADR-081自适应 CSI Mesh 内核、ADR-084/085RaBitQ 相似度传感、ADR-086边缘新颖性门控、ADR-094点云 GitHub Pages 部署。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
