Fieldwatch报告生成完全指南：Debrief、Path轨迹地图与WiGLE/GPX/KML导出一击即得

Fieldwatch报告生成完全指南：Debrief、Path轨迹地图与WiGLE/GPX/KML导出一击即得

【免费下载链接】FieldwatchReceive-only Wi-Fi and Bluetooth LE observer for Android. MIT.项目地址: https://gitcode.com/gh_mirrors/fi/Fieldwatch

Fieldwatch 是一款面向 Android 的只读式 Wi-Fi 与蓝牙低功耗（BLE）观测工具：它被动监听周围的无线电信号，不联网、无账号、无后端服务器。除了实时列表，它最强的能力是"出报告"——一键生成Debrief 现场报告、绘制Path 轨迹地图，并把扫描结果导出为GPX、KML、WiGLE CSV、CSV/JSON等通用格式。本指南带新手从零走完全流程：从建立 Sit 时间窗，到导出可直接打开的地图文件。

上图为 Fieldwatch 的整体工作流程：手机前台扫描 Wi-Fi/BLE 信号，本地完成签名匹配，Live 视图调优与告警后，最终沉淀为 Log、Sits、Debrief 报告——全部数据都留在本机。

一、先认识 Reports 标签页

Fieldwatch 底部导航的Reports页集中了所有报告与导出功能，界面源码见 ReportsScreen.kt。它包含六个区块：

官方完整操作细节见用户手册 Fieldwatch_User_Manual.pdf 与快速上手卡 instruction.txt。

二、建立 Sit：让报告有固定的时间窗

默认情况下，Debrief 和 Path 只使用最近 15 分钟的内存数据（约 400 台设备）。想要更长的时间窗或固定某个时段，先建立一个Sit：

1. 打开 Reports → Sits 区块，点击Start sit，输入一个名字（如"车库巡检 14:00"）；
2. 期间正常走动、扫描，Sit 会自动收录设备、GPS 轨迹与告警（单 Sit 最多 6000 台，见 Sit.kt）；
3. 结束巡检点End sit。已保存的 Sit 可重命名、删除，也可选中后回看该窗口的 Path 与 Debrief。

💡 开车或长距离步行时，官方建议每 10–15 分钟或每个停靠点做一次 Debrief——与你同行的信号会留在下一份报告里，路边的杂波则会自然消失。

三、Debrief（文本/PDF）：一键生成现场报告

点击Debrief (text)或Debrief (PDF)，Fieldwatch 会自动合成一份结构化报告，逻辑集中在 DebriefReport.kt。报告包含：

• 执行摘要：听到多少台 Wi-Fi AP、多少台 BLE、多少台命中签名；
• 位置与移动：你走过的 GPS 路径长度、跨度，以及在线地名（如开启"Online place names"）；
• 追踪评估⚠️：核心卖点。基于 GPS 共行（co-travel）启发式判断——
  • Possible trackers with you：整个 Sit 期间一直"贴着你走"的 AirTag/SmartTag 类标签（可能是你自己的，也可能是被放置的，需逐一核对 MAC）；
  • Possible tail：Sit 开始后才出现、随后一直跟随你的标签，提示"有人在跟着"的可能；
  • 零售信标（iBeacon 等）与可穿戴（Garmin/Fitbit/Oura）单独列出，因为它们通常不随身移动；
• 网络清单：Wi-Fi 信道分布图、隐藏 SSID、常驻设备、签名命中；
• Extra attention：命中"重点关注"签名（执法记录仪、摄像头眼镜、ALPR 等）的设备；
• 建议行动：结尾给出可执行的下一步。

报告末尾有醒目的Takeaway结论句，并附带免责声明：模式匹配是假设，不是身份认定，也不是法律结论。

两个实用开关：

• Show all radios（默认关）：开启后列出全部设备；关闭时只列你命名过、标记 Mine 或书签的设备；
• Show unmatched rotating BLE（默认关）：控制是否列出未匹配的轮换地址 BLE。

另外，AI Export按钮会生成一段可直接粘贴给聊天模型的 Markdown 附录（速率、RSSI 区间、追踪 ID 等），适合需要更深度统计的场景。

四、Path：把"你走过的路"画成轨迹地图

Path 区块是一张北向上的轨迹图（绘制逻辑见 SitPathPlot.kt）：

• 线条 = 本机的 GPS 轨迹；黑点 = 起点；蓝点 = 当前位置；
• 彩色图标 = 命中 MAC/签名告警的设备落点；数字 = 多个设备在同一位置；
• 绿色粗线段 = 你停留过的区域，路径边缘有时间刻度；
• 若收到带经纬度的无人机 Remote ID 广播，还会单独绘制其广播轨迹卡片。

📌 注意：图上图标的位置是**"你的手机听到它的地方"**（hear-point），不是该设备本身的定位。设备若主动广播坐标（如无人机），才会使用它上报的位置。

前提条件：Settings 中Tag detections with GPS保持开启（默认开），且系统定位开启、有真实移动。点击地图上的图标或下方列表行，可直接跳转到该设备详情页。

五、Sit export 与 Log export：GPX / KML / WiGLE 导出一击即得

Fieldwatch 提供两组导出（格式定义见 GeoExport.kt、SitExport.kt），操作完全一致：选格式 → 选范围（全部 / 仅 Wi-Fi / 仅 BLE）→ 点Share或Save to SD card。

Sit export：当前时间窗的"设备清单"

每个唯一设备一行，含 RSSI 区间、信道、签名、Extra attention、自定义名与观察者备注，支持 CSV / JSON lines / GPX / KML / WiGLE。

Log export：全程滚动日志

记录本次会话每一次"听到"（需 Settings 中开启 logging），同样五种格式。各格式用途：

⚠️隐私提醒：文件中的经纬度是你听到设备时手机所在位置，不是对方的位置。即使开启了 Privacy mode（屏幕打码），日志、Sit 导出和 GPX/KML/WiGLE 文件仍保留完整 MAC 与坐标——分享前请先确认。Fieldwatch 本身从不上传，一切上传行为由你自己决定。

六、新手最快上手清单

1. 系统设置：定位（精确）、Wi-Fi、蓝牙全部打开，授予 Fieldwatch 全部权限（步骤详见 instruction.txt）；
2. Settings 保持Tag detections with GPS与Logging开启；
3. 出发前 Reports →Start sit命名当前任务；
4. 每 10–15 分钟或每到一处：Debrief (PDF)留档一份；
5. 任务结束：End sit→ Sit export 选 GPX 分享给同伴，Log export 选 CSV 存档；
6. 想对比两次巡检差异：建立第二个 Sit 后用Compare (text/PDF)做"仅本次 / 仅对方 / 两边都有"的存在性对比。

按这套流程，你得到的不只是一张屏幕截图，而是一整套可回溯、可分享、可放进表格和地图软件里的完整证据链——这正是 Fieldwatch 作为离线外勤工具的核心价值。

【免费下载链接】FieldwatchReceive-only Wi-Fi and Bluetooth LE observer for Android. MIT.项目地址: https://gitcode.com/gh_mirrors/fi/Fieldwatch