浏览器本地 CSI 抓包质量检查器（GL-MT6000 / mt76）

作者 Wu Jun · 更新于 2026-11-02 · 约 6 分钟

先判断抓包文件本身是否可分析，再决定是否投入时间做清洗、频谱或机器学习。 这个工具只解析本项目公开格式 double timestamp + uint16 length + mt76 CSI payload， 所有 CSI 数据都在当前浏览器标签页内处理，不会上传到服务器 ^{[1] [2]}。

它检查什么

判读规则

• 通过：至少 10 个闭合组，链组和子载波覆盖达到 98%，存在非零 I/Q，且没有时间倒序；
• 复核：文件可解析，但有尾部截断、缺链、子载波混用、时间倒序或最大空档超过 5 秒；
• 失败：没有闭合测量组、payload 头损坏、没有非零 I/Q，或根本不是本项目抓包格式。

阈值是快速筛查基线，不是 IEEE 标准，也不是对算法精度的保证。正式实验仍应记录固件、驱动、信道、带宽、 采样命令、盘剩余空间和 daemon 内存；需要更完整的统计时，再运行 Python 质量审计。

得到结果之后怎么处理

不要看到“复核”就立刻删文件，也不要看到“通过”就直接训练模型。先按下表把问题放回采集链：

这张表只处理“文件与采集链是否可用于下一步”，不评价分类器或感知任务的科学有效性。 如果结果需要提交给维护者，请附导出的 JSON/Markdown 报告、相关日志和最小复现步骤； 原始抓包可能仍含未脱敏 MAC 和绝对时间，分享前应使用 数据脱敏流程。

重要边界：空档不等于“网络丢包”

UDP 抓包文件只能证明“这段时间没有写入闭合测量组”。原因可能是网络丢包、接收程序来不及落盘， 也可能是路由器端没有触发 CSI 上报、过滤条件没有命中合法帧，或采集 daemon 已经停止。 除非同时保存了 daemon 日志、网卡计数与抓包端丢包计数，否则不能把单个时间空档归咎为某一种原因。

同样，未闭合尾组常常只是停止采集时恰好截断；它应被隔离，不应被静默补零。这个失败模式与 Python 审计脚本的口径一致，便于网页快速检查和离线复算互相对照。

数据格式与复现

网页解析的是第三方分析机侧文件：

repeated:
  float64 host_timestamp
  uint16  payload_length
  payload_length bytes:
    24-byte little-endian mt76 CSI header
    int16 I/Q pairs

该格式来自 csi_capture.py 与 csi_capture_linux.sh，payload 头定义沿用 mt76 CSI 上报结构； 本项目工具包公开了脚本、格式说明与真机回环测试 ^{[1] [3]}。 想先验证网页行为，可点击上方“加载公开 60 秒样本”。预期结果是 2,777 条记录、347 个完整组、256 子载波、8 条链/组和 1 条尾部残片。

也可以下载同一个脱敏文件后用 Python 复算：

• 60 秒公开样本
• SHA-256 与 manifest
• 工具、脚本与更多数据集

隐私说明

CSI 原始文件本身会被当前页面读取，但不会通过表单、fetch 或分析接口上传。页面只加载站点原有的 JavaScript、样式、字体与广告脚本；这些常规页面请求不应包含你选择的文件内容。导出的报告默认不包含 发送端 MAC，只保留发送端数量。浏览器扩展、恶意脚本或设备被控制时，任何本地处理都不等于绝对安全， 因此仍应在可信设备上处理未脱敏抓包。