RuView BFLD 深度解析基于 802.11ac/ax 波束成形反馈的隐私门控 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/RuViewBFLDBeamforming Feedback Layer for Detection是 RuView 仓库中 wifi-densepose-bfld crate 所实现的一层隐私门控 WiFi 感知原语它把 802.11ac/ax 波束成形反馈BFI当作可选的感知输入在节点出口用类型系统与内存卫生结构性地阻止身份泄漏。本文以该 crate 的 README 与 ADR-118 为骨架结合仓库源码深入讲解三大结构性不变量I1/I2/I3、四类隐私等级、身份风险评分与相干门、BfldFrame 线格式、MQTT 主题路由以及从最小示例到生产 worker-thread HA-DISCO 的完整接入方式。一、为什么需要 BFLD明文 BFI 的身份泄漏问题IEEE 802.11ac 和 802.11ax 的波束成形反馈BFI在 STA 与 AP 之间通过未加密的管理面帧交换站点把信道响应压缩成 Givens 旋转角矩阵Φ/ψ以 VHT/HE Compressed Beamforming ReportCBFR的形式发送。任何处于 WiFi 监听模式且不加入网络的设备都可以被动嗅探这些帧。ADR-118 在背景章节引用了两项 2024–2025 年的独立研究来证明该暴露的严重程度BFIdKITACM CCS 2025仅凭 BFI 即可在 5 秒捕获内以 90% 的准确率重新识别 197 名个体LeakyBeamNDSS 2025仅使用明文 BFI 即可在 20 米外穿透墙壁检测占用TPR 82.7% / TNR 96.7%。同时捕获工具Wi-BFI、PicoScenes、面向树莓派 BCM43455c0 的 Nexmon BFI 补丁随手可得这意味着运营商若把 WiFi 感知设备部署进养老院、酒店、共享办公或租赁物业将没有任何工具可以证明系统当前处于匿名运行状态——这正是 BFLD 要填补的空白。需要强调 BFLD 的两个边界ADR-118 §1.5它不是对 CSI 管线的替代rvCSIADR-095/096仍是 CSI 的权威运行时BFI 只是可选输入尤其服务于拿不到 MIMO CSI 的单 AP 部署场景它不阻止外部攻击者被动捕获 BFILeakyBeam 一类的威胁依然存在它只保证节点自身对外输出不可识别个体。二、三大结构性不变量不靠制度文本靠类型系统BFLD 最有辨识度的设计是把三条隐私不变量结构化地写进代码README 原话enforced structurally, not by policy textID不变量执行机制I1原始 BFI 永不离开节点Sink标记 trait 层级 PrivacyClass::Raw.allows_network() falseI2身份嵌入仅存在于内存RAM-onlyIdentityEmbedding无Serialize/Clone/CopyDrop时清零存储I3跨站点身份关联在密码学上不可能SignatureHasher按站点 keyed BLAKE3 哈希 每日 epoch 轮换这三个不变量的实现细节是整篇文章的核心我们分别在下面各节展开。三、快速上手最小进程内消费示例examples/bfld_minimal.rs演示了完整的运营商视角流程构造带SignatureHasher的BfldPipeline喂入一帧SensingInputsIdentityEmbedding打印隐私门控后的BfldEventJSONuse wifi_densepose_bfld::{ BfldConfig, BfldPipeline, IdentityEmbedding, SensingInputs, SignatureHasher, EMBEDDING_DIM, SITE_SALT_LEN, }; let mut pipeline BfldPipeline::new( BfldConfig::new(seed-01) .with_signature_hasher(SignatureHasher::new([0xAB; SITE_SALT_LEN])), ); let event pipeline .process( SensingInputs { timestamp_ns: 1_700_000_000_000_000_000, presence: true, motion: 0.42, person_count: 1, sensing_confidence: 0.91, // 低风险门控停留在 Accept事件正常发布 sep: 0.2, stab: 0.2, consist: 0.2, risk_conf: 0.2, rf_signature_hash: None, }, Some(IdentityEmbedding::from_raw([0.05; EMBEDDING_DIM])), ) .expect(low-risk emit); println!({}, event.to_json().unwrap());逐字段解释SensingInputs定义见 emitter.rstimestamp_ns纳秒时间戳。注意 emitter.rs 中的注释——若希望rf_signature_hash的每日轮换锚定到 UTC 午夜调用方必须传入 unix epoch 纳秒纯单调时钟无法对齐日界。presence/motion/person_count/sensing_confidence占用、归一化运动量[0,1]、人数估计、感知置信度[0,1]注意这是感知置信度不是风险评分的conf因子。sep/stab/consist/risk_conf身份风险评分的四个因子全部取值[0,1]分别对应可分离性separability、时间稳定性temporal stability、跨视角一致性cross-perspective consistency与样本置信度。rf_signature_hash可选的 32 字节哈希当配置了SignatureHasher时管线会用嵌入派生出的哈希覆盖该字段。预期输出是一行匹配BfldEvent模式的 JSON示例源码的 doc 注释描述包含 presence、motion、person_count、identity_risk_score、rf_signature_hash且privacy_class anonymous。四、生产部署worker-thread HA-DISCOexamples/bfld_handle.rs演示更接近生产的形式先发布 retained 的online在线状态和 6 条 retained 的 HA-DISCO 配置负载再通过BfldPipelineHandle::spawn拉起一个工作线程主线程只需handle.send(PipelineInput { inputs, embedding })use wifi_densepose_bfld::{ publish_availability_online, publish_discovery, BfldConfig, BfldPipeline, BfldPipelineHandle, PipelineInput, PrivacyClass, SignatureHasher, }; // Bootstrap: retained online 6 retained HA-DISCO config payloads. publish_availability_online(mut publisher, seed-01)?; publish_discovery(mut publisher, seed-01, PrivacyClass::Anonymous)?; // Spawn worker. Per-frame: handle.send(PipelineInput { inputs, embedding }). let handle BfldPipelineHandle::spawn( BfldPipeline::new(BfldConfig::new(seed-01) .with_signature_hasher(SignatureHasher::new(salt))), publisher, ); handle.send(PipelineInput { inputs, embedding })?;BfldPipelineHandlepipeline_handle.rs封装了 worker 线程的生命周期与线程安全的发送通道让调用方不必接触底层 emitter API。Bootstrap 阶段的两个发布函数publish_availability_online与publish_discovery均来自 availability.rs 与 ha_discovery.rs只在stdfeature 下编译。五、四类隐私等级与字段暴露矩阵PrivacyClass是一个#[repr(u8)]枚举字节值本身就有序——数值越大携带的身份信息越少等级字节值语义Raw0仅本地研究的原始数据含原始 BFI 矩阵永不联网I1Derived1运营商确认的 LAN 研究模式降采样角度 identity embedding 风险评分可用Soul Signature 部署需要此级Anonymous2生产默认仅聚合感知无身份派生字段Restricted3养老院/受监管部署Anonymous 再减去风险评分与签名哈希配套的判定方法lib.rsallows_network()只在非Raw时返回 trueallows_matter()只接受 2/3 级。TryFromu8保证任何非法字节值都会得到BfldError::InvalidPrivacyClass。每个事件的字段暴露由 event.rs 头部注释给出ADR-122 §2.1 的映射字段Raw(0)Derived(1)Anonymous(2)Restricted(3)presence / motion / person_count / confidence / zone_id✅✅✅✅identity_risk_score✅✅✅❌rf_signature_hash✅✅✅❌实现上BfldEvent::with_privacy_gatingevent.rs#L80-L107构造后立即调用幂等的apply_privacy_gatingevent.rs#L112-L117把 3 级事件中的风险评分与哈希字段置为NoneSerialize派生配合skip_serializing_if Option::is_none使得被门控的字段在 JSON 中整体省略而非输出null——一个被门控的事件在观测上等同于从未拥有过该字段。六、Sink 标记 trait 层级I1 的结构化执行I1原始 BFI 永不离开节点不是靠运维纪律而是靠 sink.rs 中一组零成本标记 trait。每个输出目的地内存缓冲、MQTT 主题、Matter cluster必须实现且只能实现LocalSink、NetworkSink、MatterSink之一并用关联常量MIN_CLASS声明自己愿意接受的最低等级Sink traitMIN_CLASS接受等级LocalSinkRaw0, 1, 2, 3NetworkSinkDerived1, 2, 3MatterSinkAnonymous2, 3层级关系为MatterSink: NetworkSink。运行时门check_classsink.rs#L47-L55对每次发布做检查等级字节值 MIN_CLASS才放行否则返回BfldError::PrivacyViolation并带上违规 sink 的KIND。因为数值顺序有意义检查退化为一次简单的字节比较。crate 还提供了三个零尺寸的 kind tagLocalKind/NetworkKind/MatterKind供单元测试与隐私门编译期表使用具体 sink 实现在下游emitter、MQTT、cog-ha-matter Matter 桥。七、IdentityEmbeddingI2 的类型系统与内存卫生IdentityEmbedding是 I2身份嵌入仅存在于 RAM的执行体维度固定为EMBEDDING_DIM 128与 ADR-024 的 AETHER 对比嵌入一致。它的防护是三层叠加类型层面没有Serialize、没有Clone、没有Copy唯一取值途径是借用视图as_slice()。crate 底部用static_assertions写死了编译期断言assert_impl_all!(IdentityEmbedding: Drop)与assert_not_impl_any!(IdentityEmbedding: Copy, Clone)——未来任何 PR 若给该类型加上Clone/Copy或下游尝试派生Serialize构建会直接失败。内存卫生Drop在释放前把values全部覆写为0.0并用core::hint::black_box阻止编译器在 DCE 阶段消除清零循环——悬垂指针读到的将是零而非原始值。日志脱敏Debug只输出维度与 L2 范数原始值显示为redacted杜绝调试日志把嵌入打进日志文件。八、SignatureHasherI3 的按站点 keyed 哈希与每日轮换I3 的密码学基础在 signature_hasher.rsrf_signature_hash BLAKE3-keyed(site_salt, day_epoch || features)site_salt32 字节SITE_SALT_LEN 32由 BLAKE3 keyed 模式固定的节点独有秘密永不传输启动时从持久秘密存储TPM / KMS / strict-mode 文件加载。两个节点观测同一个人时产出的是互不相关的哈希——即使攻击者攻破其中一个节点也没有可用于跨站点桥接的密钥。day_epoch floor(unix_time_utc / 86_400)SECONDS_PER_DAYUTC 午夜翻转因此同一个人的哈希每天变化一次跨天分析无法关联同一签名。输出固定 32 字节RF_SIGNATURE_LEN。computesignature_hasher.rs#L58-L63用 keyed mode 的Hasher::new_keyed(site_salt)先写入 day_epoch 的小端字节再写入 features 规范字节compute_at则从 unix 秒直接换算 day epoch。crate 级测试 tests/signature_hasher.rs 与 tests/pipeline_i3_isolation.rs 直接验证跨站点不可关联性ADR-120 §2.7 AC2 的跨站点汉明距离准则。在管线中emitter.rs#L150-L163哈希优先从IdentityFeatures::from_embedding(emb)派生无嵌入时回退到IdentityFeatures::from_risk_factors(sep, stab, consist, risk_conf)统一走规范字节路径保证同样的输入产出 bit 一致的 wire 字节。九、身份风险评分与相干门coherence gate9.1 四因子乘法风险评分identity_risk.rs 定义风险评分identity_risk_score clamp(sep × stab × consist × conf, 0.0, 1.0)score函数identity_risk.rs#L38-L44先把四个输入各自clamp01NaN 映射为 0.0再相乘。乘法组合在不确定性下是保守的任何一个接近 0 的因子例如样本置信度极低都会把总分压向 0系统偏向不确定就报低风险——这正是隐私优先的默认姿态。9.2 阈值 → GateAction 映射分数确定性地映射到GateAction边界语义下限包含0.7即 Reject、0.9即 Recalibrate分数区间Action效果 0.5Accept正常发布0.5 ≤ score 0.7PredictOnly发布但标记为仅预测下游降置信度展示0.7 ≤ score 0.9Reject整个事件丢弃≥ 0.9Recalibrate丢弃事件并轮换 site_salt按 ADR-120同时drain()嵌入环GateAction提供了allows_publish()/drops_event()/requires_recalibrate()三个判定辅助方法供门控运行器分流。9.3 迟滞 去抖的状态机coherence_gate.rs 在无状态阈值分类之上加了两个稳定机制防止分数在边界附近振荡时门控抖动迟滞 ±0.05HYSTERESIS 0.05分数必须越过当前区间边界加上迟滞量门才考虑进入下一区间去抖 5 秒DEBOUNCE_NS 5_000_000_000新的候选 action 必须持续 5 秒墙钟时间才会晋升为当前 action中途回到当前区间则取消 pending。evaluate_with_oraclecoherence_gate.rs#L71-L84是 Soul Signature 的集成点当门即将进入Recalibrate且SoulMatchOracle报告MatchOutcome::Match时目标被降级为PredictOnly——因为高分是成功匹配的预期结果不应轮换 site_saltADR-121 §2.6。默认的NullOracle让未启用 soul-signature 的部署零成本运行。BfldPipeline::process_with_oracle把该能力暴露给调用方。9.4 emitter 中的完整流水emitter.rs 的emit_with_oracleemitter.rs#L138-L207是端到端管线risk identity_risk::score(sep, stab, consist, conf_factor) → gate.evaluate_with_oracle(risk, ts, oracle) → GateAction → if Recalibrate: ring.drain() → if action.drops_event(): return None → else: BfldEvent::with_privacy_gating(...)嵌入总是先压入EmbeddingRing滚动保留最近身份嵌入的 FIFO 环形缓冲用于可分离性计算Recalibrate时同步清空。门控通过Accept/PredictOnly时构造事件BfldEvent构造函数再做一次防御性脱敏。十、BfldFrame 线格式86 字节头 CRC-32/ISO-HDLC如果需要在节点之间传输BfldFrame 属于stdfeature线格式由 frame.rs 定义ADR-119magic0xBF1D_0001frame.rs#L31在十六进制转储中读作 BFLD版本BFLD_VERSION 1。头大小BFLD_HEADER_SIZE 86字节#[repr(C, packed)]保证在 x86_64、aarch64、xtensa-esp32s3 上字节序一致多字节整数一律小端编解码全部走to_le_bytes/from_le_bytes本 crateunsafe_code forbid见 Cargo.toml。字段BfldFrameHeadermagic、version、flags、timestamp_ns、ap_hash16 字节BLAKE3-keyed(site_salt, ap_mac)[0..16]、sta_hash16 字节每日轮换、session_id16 字节会话边界轮换、channel、bandwidth_mhz20/40/80/160、rssi_dbm、noise_floor_dbm、n_subcarriers、n_tx、n_rx、quantization0f321i162i834-bit nibble packed、privacy_class 字节、payload_len、payload_crc32。CRCCRC-32/ISO-HDLC多项式 0xEDB88320init/xorout 0xFFFFFFFF与以太网/zlib 相同只覆盖 payload 全部 section 字节含长度前缀不覆盖头ADR-119 §2.2。BfldFrame::from_bytes会校验 magic、版本、长度与 CRC篡改产生BfldError::Crc。flagsHAS_CSI_DELTA(bit 0)、PRIVACY_MODE(bit 1)、SELF_ONLY(bit 3ESP32-S3 self-only 适配器ADR-123 §2.5)位 2 与 4–15 保留RESERVED_FLAGS_MASK中的位必须原样往返向前兼容。BfldPipeline::process_to_framepipeline.rs#L155-L178把事件产出扩展为可序列化帧它会用当前激活等级覆盖模板头的时间戳与等级再经PrivacyGate::demote强制 payload 内容合规——在Anonymous下剥掉compressed_angle_matrix与csi_deltasection在Restricted下连幅度/相位代理一并剥掉这修复了 ADR-141 指出的等级字节合规但 payload 携带高信息量 BFI的缺口。研究等级Raw/Derived保留完整 payloaddemote 是 no-op。十一、MQTT 主题路由与事件 JSONmqtt_topics.rs 是纯函数式主题路由器无 broker 依赖ADR-122 §2.2ruview/node_id/bfld/presence/state # class 2 ruview/node_id/bfld/motion/state # class 2 ruview/node_id/bfld/person_count/state # class 2 ruview/node_id/bfld/zone_activity/state # class 2配置 zone_id 时 ruview/node_id/bfld/confidence/state # class 2 ruview/node_id/bfld/identity_risk/state # 仅 class 2render_events对 Raw/Derived 事件返回空列表留在本地绝不发布到公共主题树Publishtrait 抽象了发布边界crate 内置CapturePublisher供测试捕获每条消息。事件 JSON 中rf_signature_hash序列化为blake3:64 位小写十六进制字符串event.rs#L147-L161避免消费者解码 32 元素整数数组privacy_class序列化为raw / derived / anonymous / restricted字符串。真正的 broker 集成在mqttfeature 下RumqttPublisherrumqttc_publisher.rs基于 rumqttc并支持connect_with_lwt遗嘱消息与with_lwt帮助函数。按当前 Cargo.toml 的依赖声明mqtt 后端为rumqttc-v4-next 0.34use-rustls-ring与wifi-densepose-sensing-server共享 TLS/版本姿态。十二、Feature flags 与裁剪指南crate 的 Cargo.toml 定义了五个 featureFeature默认引入依赖启用内容std✅无BfldFrame、BfldPayload、BfldPipeline、BfldPipelineHandle、BfldEvent、BfldEmitter、PrivacyGate、MQTT 主题路由器、HA discoveryserde-json✅serdeserde_json强依赖stdBfldEvent::to_json()、rf_signature_hash的blake3:hex序列化器、privacy_class字符串编码mqtt—rumqttcuse-rustls-ringRumqttPublisher、connect_with_lwt、真实 broker 集成soul-signature——编译期门控标记 Soul Signature 部署ADR-118 §1.4、ADR-120 §2.7、ADR-121 §2.6veil—wifi-veilWiFi Veil 咨询集成ADR-294产出确定性攻击者 vs 保护者 BFI 身份泄漏评估默认 feature 组合为[std, serde-json]。裁剪到--no-default-features后得到 no_std 兼容核心BfldFrameHeader、PrivacyClass、Sinktrait、CoherenceGate、SignatureHasher、IdentityEmbedding、EmbeddingRing、风险评分函数与GateActionlib.rs 中这些模块均无条件编译。注意两个 example 都有required-features约束bfld_minimal需要serde-jsonbfld_handle需要stdcargo test --no-default-features才能正常通过。十三、运行示例与测试验证cargo run -p wifi-densepose-bfld --example bfld_minimal # 进程内消费者 cargo run -p wifi-densepose-bfld --example bfld_handle # worker-thread HA-DISCOcargo test -p wifi-densepose-bfld --no-default-features # no_std 兼容核心 cargo test -p wifi-densepose-bfld # 默认 std serde-json cargo test -p wifi-densepose-bfld --features mqtt # 含 rumqttc smokecrate 携带一套相当完整的测试矩阵tests/ 目录 60 个文件与本文论述一一对应结构性隐私sink_enforcement.rsI1 的 Sink 拒绝、identity_embedding.rsI2 的类型约束、pipeline_i3_isolation.rs 与 signature_hasher.rsI3 跨站点不可关联帧格式frame_header_size.rs、frame_roundtrip.rs、frame_trailing_bytes.rs、crc32_polynomial.rsCRC-32/ISO-HDLC 多项式、reserved_flags.rs门控与事件event_privacy_gating.rs、privacy_gate_demote.rs、identity_risk_score.rs、coherence_gate.rs、gate_clock_skew.rs、pipeline_determinism.rsAC6 确定性序列化MQTT/HAmqtt_topic_routing.rs、ha_discovery.rs、rumqttc_lwt.rs、availability_topic.rs性能与体验presence_latency.rsAC2、motion_publish_rate.rsAC3、serialization_throughput.rs实时 brokermosquitto_integration.rs 需要环境变量BFLD_MQTT_BROKERtcp://localhost:1883解锁对应 .github/workflows/bfld-mqtt-integration.yml CI 中的 mosquitto Docker 服务。十四、Soul Signature 与配套产物BFLD 与 docs/research/soul 的 Soul Signature 研究是互补设计前者有意制造身份60 秒注册协议运行在 class 1 derived后者测量并门控身份泄漏默认 class 2 anonymous、对未注册者默认拒绝。identity_risk_score正是 BFLD 成为 Soul Signature 执行层的枢纽分数门控某个区域是否够泄漏以允许注册结构性不变量 I1/I2/I3 保证即使注册者被匹配未注册旁观者依然匿名。目前 soul_match.rs 与 soul_channels.rs 已实现带权余弦匹配器EnrolledMatcher但命名身份锁定仍是数据门控状态——需要真实的高权重通道数据AETHER 注册 体共振仅靠心电 呼吸通道无法分离身份见tests/soul_match.rs的cardiac_alone_cannot_separate_identity_matches_audit。配套产物一览README 的 Companion artifacts 一节ADR 系列ADR-118伞形架构 I1/I2/I3、ADR-119线格式、ADR-120隐私等级与哈希轮换、ADR-121风险评分、ADR-122HA/Matter 暴露、ADR-123Pi 5/Nexmon 与 ESP32 捕获路径设计档案docs/research/BFLD11 个文件涵盖 SOTA 调研、Soul 关系、威胁模型、隐私门控、自动化集成、实现计划、评测与 ADR 草稿HA 蓝图v2/crates/cog-ha-matter/blueprints/bfld 提供三个运营商蓝图presence-lighting占用-灯光、motion-hvac运动-HVAC、identity-risk-anomaly身份风险异常CI.github/workflows/bfld-mqtt-integration.yml 含真实 mosquitto 服务的集成矩阵。十五、已知边界与诚实标注从 ADR-118 的 Consequences 与 Alternatives 章节可以明确 BFLD 的能力边界ESP32-S3 无法直接捕获 CBFR完整 BFLD 管线需要 Pi 5 / Nexmon 主机嗅探器cognitum-v0 可用见 ADR-123SELF_ONLYflag 对应的 ESP32 self-only 模式是受限变体。不阻止外部被动捕获LeakyBeam 一类的攻击依然可能BFLD 只保证节点自身输出不可识别个体运营商必须理解这个区别。每日哈希轮换阻止跨日多天分析关联个体签名对隐私目标有利但可能影响多天分析类用例。实现状态从 Cargo.toml 的版本号0.3.1对应 ADR-141 隐私控制平面与 lib.rs 的状态注释看P1帧格式 Sink 标记 trait与隐私控制平面已经落地P2–P6提取器、风险校准、MQTT 生产化、Matter 边界、Pi5/Nexmon 捕获适配器仍在推进中identity_risk_score的校准需要 KIT BFId 数据集非商业研究协议。不引入噪声式差分隐私当前设计通过结构上的不可能而非 DP 噪声实现隐私DP 方案被推迟到后续 ADR。对部署者而言BFLD 的核心价值可以概括为一句可验证的话系统是否匿名运行不再取决于某段制度文本而是取决于类型系统在编译期和运行期都拒绝让身份相关数据离开节点。任何把 RuView 部署到受监管环境养老院、酒店、共享空间的团队都可以用 sink_enforcement.rs 与 event_privacy_gating.rs 这类测试作为持续的可审计证据链的一部分配合 ADR-028 的 witness-bundle 模式延伸到新的 BFLD 表面。【免费下载链接】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），仅供参考
RuView BFLD 深度解析：基于 802.11ac/ax 波束成形反馈的隐私门控 WiFi 感知层
RuView BFLD 深度解析基于 802.11ac/ax 波束成形反馈的隐私门控 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/RuViewBFLDBeamforming Feedback Layer for Detection是 RuView 仓库中 wifi-densepose-bfld crate 所实现的一层隐私门控 WiFi 感知原语它把 802.11ac/ax 波束成形反馈BFI当作可选的感知输入在节点出口用类型系统与内存卫生结构性地阻止身份泄漏。本文以该 crate 的 README 与 ADR-118 为骨架结合仓库源码深入讲解三大结构性不变量I1/I2/I3、四类隐私等级、身份风险评分与相干门、BfldFrame 线格式、MQTT 主题路由以及从最小示例到生产 worker-thread HA-DISCO 的完整接入方式。一、为什么需要 BFLD明文 BFI 的身份泄漏问题IEEE 802.11ac 和 802.11ax 的波束成形反馈BFI在 STA 与 AP 之间通过未加密的管理面帧交换站点把信道响应压缩成 Givens 旋转角矩阵Φ/ψ以 VHT/HE Compressed Beamforming ReportCBFR的形式发送。任何处于 WiFi 监听模式且不加入网络的设备都可以被动嗅探这些帧。ADR-118 在背景章节引用了两项 2024–2025 年的独立研究来证明该暴露的严重程度BFIdKITACM CCS 2025仅凭 BFI 即可在 5 秒捕获内以 90% 的准确率重新识别 197 名个体LeakyBeamNDSS 2025仅使用明文 BFI 即可在 20 米外穿透墙壁检测占用TPR 82.7% / TNR 96.7%。同时捕获工具Wi-BFI、PicoScenes、面向树莓派 BCM43455c0 的 Nexmon BFI 补丁随手可得这意味着运营商若把 WiFi 感知设备部署进养老院、酒店、共享办公或租赁物业将没有任何工具可以证明系统当前处于匿名运行状态——这正是 BFLD 要填补的空白。需要强调 BFLD 的两个边界ADR-118 §1.5它不是对 CSI 管线的替代rvCSIADR-095/096仍是 CSI 的权威运行时BFI 只是可选输入尤其服务于拿不到 MIMO CSI 的单 AP 部署场景它不阻止外部攻击者被动捕获 BFILeakyBeam 一类的威胁依然存在它只保证节点自身对外输出不可识别个体。二、三大结构性不变量不靠制度文本靠类型系统BFLD 最有辨识度的设计是把三条隐私不变量结构化地写进代码README 原话enforced structurally, not by policy textID不变量执行机制I1原始 BFI 永不离开节点Sink标记 trait 层级 PrivacyClass::Raw.allows_network() falseI2身份嵌入仅存在于内存RAM-onlyIdentityEmbedding无Serialize/Clone/CopyDrop时清零存储I3跨站点身份关联在密码学上不可能SignatureHasher按站点 keyed BLAKE3 哈希 每日 epoch 轮换这三个不变量的实现细节是整篇文章的核心我们分别在下面各节展开。三、快速上手最小进程内消费示例examples/bfld_minimal.rs演示了完整的运营商视角流程构造带SignatureHasher的BfldPipeline喂入一帧SensingInputsIdentityEmbedding打印隐私门控后的BfldEventJSONuse wifi_densepose_bfld::{ BfldConfig, BfldPipeline, IdentityEmbedding, SensingInputs, SignatureHasher, EMBEDDING_DIM, SITE_SALT_LEN, }; let mut pipeline BfldPipeline::new( BfldConfig::new(seed-01) .with_signature_hasher(SignatureHasher::new([0xAB; SITE_SALT_LEN])), ); let event pipeline .process( SensingInputs { timestamp_ns: 1_700_000_000_000_000_000, presence: true, motion: 0.42, person_count: 1, sensing_confidence: 0.91, // 低风险门控停留在 Accept事件正常发布 sep: 0.2, stab: 0.2, consist: 0.2, risk_conf: 0.2, rf_signature_hash: None, }, Some(IdentityEmbedding::from_raw([0.05; EMBEDDING_DIM])), ) .expect(low-risk emit); println!({}, event.to_json().unwrap());逐字段解释SensingInputs定义见 emitter.rstimestamp_ns纳秒时间戳。注意 emitter.rs 中的注释——若希望rf_signature_hash的每日轮换锚定到 UTC 午夜调用方必须传入 unix epoch 纳秒纯单调时钟无法对齐日界。presence/motion/person_count/sensing_confidence占用、归一化运动量[0,1]、人数估计、感知置信度[0,1]注意这是感知置信度不是风险评分的conf因子。sep/stab/consist/risk_conf身份风险评分的四个因子全部取值[0,1]分别对应可分离性separability、时间稳定性temporal stability、跨视角一致性cross-perspective consistency与样本置信度。rf_signature_hash可选的 32 字节哈希当配置了SignatureHasher时管线会用嵌入派生出的哈希覆盖该字段。预期输出是一行匹配BfldEvent模式的 JSON示例源码的 doc 注释描述包含 presence、motion、person_count、identity_risk_score、rf_signature_hash且privacy_class anonymous。四、生产部署worker-thread HA-DISCOexamples/bfld_handle.rs演示更接近生产的形式先发布 retained 的online在线状态和 6 条 retained 的 HA-DISCO 配置负载再通过BfldPipelineHandle::spawn拉起一个工作线程主线程只需handle.send(PipelineInput { inputs, embedding })use wifi_densepose_bfld::{ publish_availability_online, publish_discovery, BfldConfig, BfldPipeline, BfldPipelineHandle, PipelineInput, PrivacyClass, SignatureHasher, }; // Bootstrap: retained online 6 retained HA-DISCO config payloads. publish_availability_online(mut publisher, seed-01)?; publish_discovery(mut publisher, seed-01, PrivacyClass::Anonymous)?; // Spawn worker. Per-frame: handle.send(PipelineInput { inputs, embedding }). let handle BfldPipelineHandle::spawn( BfldPipeline::new(BfldConfig::new(seed-01) .with_signature_hasher(SignatureHasher::new(salt))), publisher, ); handle.send(PipelineInput { inputs, embedding })?;BfldPipelineHandlepipeline_handle.rs封装了 worker 线程的生命周期与线程安全的发送通道让调用方不必接触底层 emitter API。Bootstrap 阶段的两个发布函数publish_availability_online与publish_discovery均来自 availability.rs 与 ha_discovery.rs只在stdfeature 下编译。五、四类隐私等级与字段暴露矩阵PrivacyClass是一个#[repr(u8)]枚举字节值本身就有序——数值越大携带的身份信息越少等级字节值语义Raw0仅本地研究的原始数据含原始 BFI 矩阵永不联网I1Derived1运营商确认的 LAN 研究模式降采样角度 identity embedding 风险评分可用Soul Signature 部署需要此级Anonymous2生产默认仅聚合感知无身份派生字段Restricted3养老院/受监管部署Anonymous 再减去风险评分与签名哈希配套的判定方法lib.rsallows_network()只在非Raw时返回 trueallows_matter()只接受 2/3 级。TryFromu8保证任何非法字节值都会得到BfldError::InvalidPrivacyClass。每个事件的字段暴露由 event.rs 头部注释给出ADR-122 §2.1 的映射字段Raw(0)Derived(1)Anonymous(2)Restricted(3)presence / motion / person_count / confidence / zone_id✅✅✅✅identity_risk_score✅✅✅❌rf_signature_hash✅✅✅❌实现上BfldEvent::with_privacy_gatingevent.rs#L80-L107构造后立即调用幂等的apply_privacy_gatingevent.rs#L112-L117把 3 级事件中的风险评分与哈希字段置为NoneSerialize派生配合skip_serializing_if Option::is_none使得被门控的字段在 JSON 中整体省略而非输出null——一个被门控的事件在观测上等同于从未拥有过该字段。六、Sink 标记 trait 层级I1 的结构化执行I1原始 BFI 永不离开节点不是靠运维纪律而是靠 sink.rs 中一组零成本标记 trait。每个输出目的地内存缓冲、MQTT 主题、Matter cluster必须实现且只能实现LocalSink、NetworkSink、MatterSink之一并用关联常量MIN_CLASS声明自己愿意接受的最低等级Sink traitMIN_CLASS接受等级LocalSinkRaw0, 1, 2, 3NetworkSinkDerived1, 2, 3MatterSinkAnonymous2, 3层级关系为MatterSink: NetworkSink。运行时门check_classsink.rs#L47-L55对每次发布做检查等级字节值 MIN_CLASS才放行否则返回BfldError::PrivacyViolation并带上违规 sink 的KIND。因为数值顺序有意义检查退化为一次简单的字节比较。crate 还提供了三个零尺寸的 kind tagLocalKind/NetworkKind/MatterKind供单元测试与隐私门编译期表使用具体 sink 实现在下游emitter、MQTT、cog-ha-matter Matter 桥。七、IdentityEmbeddingI2 的类型系统与内存卫生IdentityEmbedding是 I2身份嵌入仅存在于 RAM的执行体维度固定为EMBEDDING_DIM 128与 ADR-024 的 AETHER 对比嵌入一致。它的防护是三层叠加类型层面没有Serialize、没有Clone、没有Copy唯一取值途径是借用视图as_slice()。crate 底部用static_assertions写死了编译期断言assert_impl_all!(IdentityEmbedding: Drop)与assert_not_impl_any!(IdentityEmbedding: Copy, Clone)——未来任何 PR 若给该类型加上Clone/Copy或下游尝试派生Serialize构建会直接失败。内存卫生Drop在释放前把values全部覆写为0.0并用core::hint::black_box阻止编译器在 DCE 阶段消除清零循环——悬垂指针读到的将是零而非原始值。日志脱敏Debug只输出维度与 L2 范数原始值显示为redacted杜绝调试日志把嵌入打进日志文件。八、SignatureHasherI3 的按站点 keyed 哈希与每日轮换I3 的密码学基础在 signature_hasher.rsrf_signature_hash BLAKE3-keyed(site_salt, day_epoch || features)site_salt32 字节SITE_SALT_LEN 32由 BLAKE3 keyed 模式固定的节点独有秘密永不传输启动时从持久秘密存储TPM / KMS / strict-mode 文件加载。两个节点观测同一个人时产出的是互不相关的哈希——即使攻击者攻破其中一个节点也没有可用于跨站点桥接的密钥。day_epoch floor(unix_time_utc / 86_400)SECONDS_PER_DAYUTC 午夜翻转因此同一个人的哈希每天变化一次跨天分析无法关联同一签名。输出固定 32 字节RF_SIGNATURE_LEN。computesignature_hasher.rs#L58-L63用 keyed mode 的Hasher::new_keyed(site_salt)先写入 day_epoch 的小端字节再写入 features 规范字节compute_at则从 unix 秒直接换算 day epoch。crate 级测试 tests/signature_hasher.rs 与 tests/pipeline_i3_isolation.rs 直接验证跨站点不可关联性ADR-120 §2.7 AC2 的跨站点汉明距离准则。在管线中emitter.rs#L150-L163哈希优先从IdentityFeatures::from_embedding(emb)派生无嵌入时回退到IdentityFeatures::from_risk_factors(sep, stab, consist, risk_conf)统一走规范字节路径保证同样的输入产出 bit 一致的 wire 字节。九、身份风险评分与相干门coherence gate9.1 四因子乘法风险评分identity_risk.rs 定义风险评分identity_risk_score clamp(sep × stab × consist × conf, 0.0, 1.0)score函数identity_risk.rs#L38-L44先把四个输入各自clamp01NaN 映射为 0.0再相乘。乘法组合在不确定性下是保守的任何一个接近 0 的因子例如样本置信度极低都会把总分压向 0系统偏向不确定就报低风险——这正是隐私优先的默认姿态。9.2 阈值 → GateAction 映射分数确定性地映射到GateAction边界语义下限包含0.7即 Reject、0.9即 Recalibrate分数区间Action效果 0.5Accept正常发布0.5 ≤ score 0.7PredictOnly发布但标记为仅预测下游降置信度展示0.7 ≤ score 0.9Reject整个事件丢弃≥ 0.9Recalibrate丢弃事件并轮换 site_salt按 ADR-120同时drain()嵌入环GateAction提供了allows_publish()/drops_event()/requires_recalibrate()三个判定辅助方法供门控运行器分流。9.3 迟滞 去抖的状态机coherence_gate.rs 在无状态阈值分类之上加了两个稳定机制防止分数在边界附近振荡时门控抖动迟滞 ±0.05HYSTERESIS 0.05分数必须越过当前区间边界加上迟滞量门才考虑进入下一区间去抖 5 秒DEBOUNCE_NS 5_000_000_000新的候选 action 必须持续 5 秒墙钟时间才会晋升为当前 action中途回到当前区间则取消 pending。evaluate_with_oraclecoherence_gate.rs#L71-L84是 Soul Signature 的集成点当门即将进入Recalibrate且SoulMatchOracle报告MatchOutcome::Match时目标被降级为PredictOnly——因为高分是成功匹配的预期结果不应轮换 site_saltADR-121 §2.6。默认的NullOracle让未启用 soul-signature 的部署零成本运行。BfldPipeline::process_with_oracle把该能力暴露给调用方。9.4 emitter 中的完整流水emitter.rs 的emit_with_oracleemitter.rs#L138-L207是端到端管线risk identity_risk::score(sep, stab, consist, conf_factor) → gate.evaluate_with_oracle(risk, ts, oracle) → GateAction → if Recalibrate: ring.drain() → if action.drops_event(): return None → else: BfldEvent::with_privacy_gating(...)嵌入总是先压入EmbeddingRing滚动保留最近身份嵌入的 FIFO 环形缓冲用于可分离性计算Recalibrate时同步清空。门控通过Accept/PredictOnly时构造事件BfldEvent构造函数再做一次防御性脱敏。十、BfldFrame 线格式86 字节头 CRC-32/ISO-HDLC如果需要在节点之间传输BfldFrame 属于stdfeature线格式由 frame.rs 定义ADR-119magic0xBF1D_0001frame.rs#L31在十六进制转储中读作 BFLD版本BFLD_VERSION 1。头大小BFLD_HEADER_SIZE 86字节#[repr(C, packed)]保证在 x86_64、aarch64、xtensa-esp32s3 上字节序一致多字节整数一律小端编解码全部走to_le_bytes/from_le_bytes本 crateunsafe_code forbid见 Cargo.toml。字段BfldFrameHeadermagic、version、flags、timestamp_ns、ap_hash16 字节BLAKE3-keyed(site_salt, ap_mac)[0..16]、sta_hash16 字节每日轮换、session_id16 字节会话边界轮换、channel、bandwidth_mhz20/40/80/160、rssi_dbm、noise_floor_dbm、n_subcarriers、n_tx、n_rx、quantization0f321i162i834-bit nibble packed、privacy_class 字节、payload_len、payload_crc32。CRCCRC-32/ISO-HDLC多项式 0xEDB88320init/xorout 0xFFFFFFFF与以太网/zlib 相同只覆盖 payload 全部 section 字节含长度前缀不覆盖头ADR-119 §2.2。BfldFrame::from_bytes会校验 magic、版本、长度与 CRC篡改产生BfldError::Crc。flagsHAS_CSI_DELTA(bit 0)、PRIVACY_MODE(bit 1)、SELF_ONLY(bit 3ESP32-S3 self-only 适配器ADR-123 §2.5)位 2 与 4–15 保留RESERVED_FLAGS_MASK中的位必须原样往返向前兼容。BfldPipeline::process_to_framepipeline.rs#L155-L178把事件产出扩展为可序列化帧它会用当前激活等级覆盖模板头的时间戳与等级再经PrivacyGate::demote强制 payload 内容合规——在Anonymous下剥掉compressed_angle_matrix与csi_deltasection在Restricted下连幅度/相位代理一并剥掉这修复了 ADR-141 指出的等级字节合规但 payload 携带高信息量 BFI的缺口。研究等级Raw/Derived保留完整 payloaddemote 是 no-op。十一、MQTT 主题路由与事件 JSONmqtt_topics.rs 是纯函数式主题路由器无 broker 依赖ADR-122 §2.2ruview/node_id/bfld/presence/state # class 2 ruview/node_id/bfld/motion/state # class 2 ruview/node_id/bfld/person_count/state # class 2 ruview/node_id/bfld/zone_activity/state # class 2配置 zone_id 时 ruview/node_id/bfld/confidence/state # class 2 ruview/node_id/bfld/identity_risk/state # 仅 class 2render_events对 Raw/Derived 事件返回空列表留在本地绝不发布到公共主题树Publishtrait 抽象了发布边界crate 内置CapturePublisher供测试捕获每条消息。事件 JSON 中rf_signature_hash序列化为blake3:64 位小写十六进制字符串event.rs#L147-L161避免消费者解码 32 元素整数数组privacy_class序列化为raw / derived / anonymous / restricted字符串。真正的 broker 集成在mqttfeature 下RumqttPublisherrumqttc_publisher.rs基于 rumqttc并支持connect_with_lwt遗嘱消息与with_lwt帮助函数。按当前 Cargo.toml 的依赖声明mqtt 后端为rumqttc-v4-next 0.34use-rustls-ring与wifi-densepose-sensing-server共享 TLS/版本姿态。十二、Feature flags 与裁剪指南crate 的 Cargo.toml 定义了五个 featureFeature默认引入依赖启用内容std✅无BfldFrame、BfldPayload、BfldPipeline、BfldPipelineHandle、BfldEvent、BfldEmitter、PrivacyGate、MQTT 主题路由器、HA discoveryserde-json✅serdeserde_json强依赖stdBfldEvent::to_json()、rf_signature_hash的blake3:hex序列化器、privacy_class字符串编码mqtt—rumqttcuse-rustls-ringRumqttPublisher、connect_with_lwt、真实 broker 集成soul-signature——编译期门控标记 Soul Signature 部署ADR-118 §1.4、ADR-120 §2.7、ADR-121 §2.6veil—wifi-veilWiFi Veil 咨询集成ADR-294产出确定性攻击者 vs 保护者 BFI 身份泄漏评估默认 feature 组合为[std, serde-json]。裁剪到--no-default-features后得到 no_std 兼容核心BfldFrameHeader、PrivacyClass、Sinktrait、CoherenceGate、SignatureHasher、IdentityEmbedding、EmbeddingRing、风险评分函数与GateActionlib.rs 中这些模块均无条件编译。注意两个 example 都有required-features约束bfld_minimal需要serde-jsonbfld_handle需要stdcargo test --no-default-features才能正常通过。十三、运行示例与测试验证cargo run -p wifi-densepose-bfld --example bfld_minimal # 进程内消费者 cargo run -p wifi-densepose-bfld --example bfld_handle # worker-thread HA-DISCOcargo test -p wifi-densepose-bfld --no-default-features # no_std 兼容核心 cargo test -p wifi-densepose-bfld # 默认 std serde-json cargo test -p wifi-densepose-bfld --features mqtt # 含 rumqttc smokecrate 携带一套相当完整的测试矩阵tests/ 目录 60 个文件与本文论述一一对应结构性隐私sink_enforcement.rsI1 的 Sink 拒绝、identity_embedding.rsI2 的类型约束、pipeline_i3_isolation.rs 与 signature_hasher.rsI3 跨站点不可关联帧格式frame_header_size.rs、frame_roundtrip.rs、frame_trailing_bytes.rs、crc32_polynomial.rsCRC-32/ISO-HDLC 多项式、reserved_flags.rs门控与事件event_privacy_gating.rs、privacy_gate_demote.rs、identity_risk_score.rs、coherence_gate.rs、gate_clock_skew.rs、pipeline_determinism.rsAC6 确定性序列化MQTT/HAmqtt_topic_routing.rs、ha_discovery.rs、rumqttc_lwt.rs、availability_topic.rs性能与体验presence_latency.rsAC2、motion_publish_rate.rsAC3、serialization_throughput.rs实时 brokermosquitto_integration.rs 需要环境变量BFLD_MQTT_BROKERtcp://localhost:1883解锁对应 .github/workflows/bfld-mqtt-integration.yml CI 中的 mosquitto Docker 服务。十四、Soul Signature 与配套产物BFLD 与 docs/research/soul 的 Soul Signature 研究是互补设计前者有意制造身份60 秒注册协议运行在 class 1 derived后者测量并门控身份泄漏默认 class 2 anonymous、对未注册者默认拒绝。identity_risk_score正是 BFLD 成为 Soul Signature 执行层的枢纽分数门控某个区域是否够泄漏以允许注册结构性不变量 I1/I2/I3 保证即使注册者被匹配未注册旁观者依然匿名。目前 soul_match.rs 与 soul_channels.rs 已实现带权余弦匹配器EnrolledMatcher但命名身份锁定仍是数据门控状态——需要真实的高权重通道数据AETHER 注册 体共振仅靠心电 呼吸通道无法分离身份见tests/soul_match.rs的cardiac_alone_cannot_separate_identity_matches_audit。配套产物一览README 的 Companion artifacts 一节ADR 系列ADR-118伞形架构 I1/I2/I3、ADR-119线格式、ADR-120隐私等级与哈希轮换、ADR-121风险评分、ADR-122HA/Matter 暴露、ADR-123Pi 5/Nexmon 与 ESP32 捕获路径设计档案docs/research/BFLD11 个文件涵盖 SOTA 调研、Soul 关系、威胁模型、隐私门控、自动化集成、实现计划、评测与 ADR 草稿HA 蓝图v2/crates/cog-ha-matter/blueprints/bfld 提供三个运营商蓝图presence-lighting占用-灯光、motion-hvac运动-HVAC、identity-risk-anomaly身份风险异常CI.github/workflows/bfld-mqtt-integration.yml 含真实 mosquitto 服务的集成矩阵。十五、已知边界与诚实标注从 ADR-118 的 Consequences 与 Alternatives 章节可以明确 BFLD 的能力边界ESP32-S3 无法直接捕获 CBFR完整 BFLD 管线需要 Pi 5 / Nexmon 主机嗅探器cognitum-v0 可用见 ADR-123SELF_ONLYflag 对应的 ESP32 self-only 模式是受限变体。不阻止外部被动捕获LeakyBeam 一类的攻击依然可能BFLD 只保证节点自身输出不可识别个体运营商必须理解这个区别。每日哈希轮换阻止跨日多天分析关联个体签名对隐私目标有利但可能影响多天分析类用例。实现状态从 Cargo.toml 的版本号0.3.1对应 ADR-141 隐私控制平面与 lib.rs 的状态注释看P1帧格式 Sink 标记 trait与隐私控制平面已经落地P2–P6提取器、风险校准、MQTT 生产化、Matter 边界、Pi5/Nexmon 捕获适配器仍在推进中identity_risk_score的校准需要 KIT BFId 数据集非商业研究协议。不引入噪声式差分隐私当前设计通过结构上的不可能而非 DP 噪声实现隐私DP 方案被推迟到后续 ADR。对部署者而言BFLD 的核心价值可以概括为一句可验证的话系统是否匿名运行不再取决于某段制度文本而是取决于类型系统在编译期和运行期都拒绝让身份相关数据离开节点。任何把 RuView 部署到受监管环境养老院、酒店、共享空间的团队都可以用 sink_enforcement.rs 与 event_privacy_gating.rs 这类测试作为持续的可审计证据链的一部分配合 ADR-028 的 witness-bundle 模式延伸到新的 BFLD 表面。【免费下载链接】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），仅供参考