ruview-rvagent

用途

RuView rvAgent + RVF 集成用于把 vendor/ruvector/crates/rvAgent/ 接入 RuView，使现有传感管线成为智能体流程可以读取、推理并作出响应的底层。它面向跨 cog 协调、面向操作员的智能体读取 BFLD 事件等场景。

主要能力

安装该插件会把 @ruvnet/rvagent 注册为 MCP 服务器。激活时，Claude Code 会启动 npx -y @ruvnet/rvagent 并直接暴露其工具：

• bfld_last_scan：来自传感服务器的最新 BFLD 事件
• bfld_subscribe：在某个时间窗口内流式获取 BFLD 事件
• presence_now：当前房间级存在状态
• vitals_get_breathing：最新呼吸率样本
• vitals_get_heart_rate：最新心率样本
• vitals_get_all：综合生命体征快照
• vitals_fetch：历史生命体征窗口

可通过 RVAGENT_SENSING_URL 环境变量覆盖传感服务器 URL，默认值为 http://localhost:3000。源码位于 tools/ruview-mcp/，设计记录在 ADR-124。

可用 npm view @ruvnet/rvagent version 做冒烟检查，应返回 0.1.0 或更新版本。

使用方式

安装插件后，@ruvnet/rvagent 作为 MCP 服务器注册，Claude Code 通过 npx -y @ruvnet/rvagent 启动并暴露上述工具。可通过 RVAGENT_SENSING_URL 指定传感服务器地址。

适用场景

• 希望智能体对厨房中的 BFLD 存在做出反应并呼叫护理人员
• 需要 cog-pose-estimation 与 cog-bfld 在发布合成事件前进行协商
• 希望见证链在同一个 RVF blob 中同时证明传感事件和智能体决策
• 当源 BFLD 事件为 Restricted 时，如何让 rvAgent 的工具输出保持 class-3 合规

关键接口

• rvAgent 核心：vendor/ruvector/crates/rvAgent/rvagent-core/src/agi_container.rs（627 LOC），RVF 兼容状态容器
• rvAgent 中间件：vendor/ruvector/crates/rvAgent/rvagent-middleware/，包含 Witness、sanitizer、SONA、HNSW
• 智能体角色：vendor/ruvector/crates/rvAgent/.ruv/agents/rvagent-{queen,coder,tester,security}.md，参考模式
• RVF 容器：v2/crates/wifi-densepose-sensing-server/src/rvf_container.rs，新增 SEG_AGENT_STATE、SEG_DECISION
• BFLD 事件：v2/crates/wifi-densepose-bfld/src/event.rs，BfldEvent::to_json() → ToolOutput
• BFLD 管线句柄：v2/crates/wifi-densepose-bfld/src/pipeline_handle.rs，BfldPipelineHandle::send

完整集成分析位于 docs/research/rvagent-rvf-integration/README.md。

三个可交付接触点

1. RVF 线路：两个新段类型（SEG_AGENT_STATE = 0x08、SEG_DECISION = 0x09）让 rvAgent 会话与 RuView 传感会话在同一 blob 中交错。
2. 工具表面：BfldEvent → ToolOutput 垫片把 BFLD 事件转为智能体上下文，无需新增 IPC。
3. Cog 子智能体：cog-pose-estimation / cog-person-count / cog-ha-matter / cog-bfld 在 queen-agent 路由器下注册为 rvAgent 子智能体。

限制与未决问题

• vendor/ruvector/crates/rvAgent/ 的工作区纳入方式（路径依赖还是已发布 crate）
• 同步 ↔ 异步适配器（BFLD Publish 是同步的，rvAgent 后端是 tokio）
• 隐私类组合（rvAgent 的 sanitizer 是否消费 PrivacyClass）
• Soul Signature ↔ SoulMatchOracle 桥接
• BfldPipelineHandle::send 是否通过 rvagent-mcp 成为公开 MCP 工具

下一步决策：ADR-124（提议中）——"rvAgent + RVF integration for RuView agentic flows"——将记录段分配、cog 子智能体契约和隐私类组合规则，应在搭建 v2/crates/wifi-densepose-agent 之前落地。