skizzophrenic/SquachWatch-CYD

项目用途

SquachWatch-CYD 是一套面向 ESP32 触摸屏开发板的独立固件，核心硬件是 2.8 英寸的 ESP32-2432S028R，也就是常说的「廉价黄屏」（Cheap Yellow Display）。板子通过 WiFi 和蓝牙低功耗监听已知的无线特征，识别 Flock Safety 车牌识别摄像头、Axon 执法记录仪、拍摄眼镜、蓝牙读卡器、AirTag 等追踪器、Remote ID 无人机、Ring 门铃与摄像头、去认证洪泛、仿冒热点，以及 Flipper Zero、Pwnagotchi 等渗透测试硬件。整套系统直接跑在板子上，插 USB 供电即可，不需要电脑。购买硬件前可以先在浏览器模拟器里操作真实界面。

界面采用游戏化风格：动态背景、吉祥物 Squachy、全屏告警卡片、可跨重启保留的检测日志（约 1,800 条记录），以及可选的 microSD CSV 记录。此外还有桌面时钟模式、宾果卡片和检测图鉴等附加内容。

支持的开发板

默认目标是 2.8 英寸 CYD；其他 ESP32 显示板支持程度不一，包括 3.2 英寸和 3.5 英寸 CYD 变体、Freenove ESP32-S3 系列、Elecrow CrowPanel 7.0、可扫描 5 GHz 的 RockBase NM-CYD-C5 与 Waveshare ESP32-C5 板、LilyGo T-Deck Plus、M5Stack 设备，以及 LilyGo T-Watch S3/S3 Plus。标为 BETA 的构建测试时间较短。购买前应查看板型表和对应说明。

快速开始

最省事的方式是浏览器烧录：打开网页烧录器，从列表中选板型（不确定时可按背面印刷的代码查找），用 USB 连接板子，点击 Connect & Install。桌面版 Firefox、Chrome、Edge 或 Brave 均可使用。烧录完成后板子进入主界面，底部三个软按钮分别是 [ SCAN ] 返回待机页、[ LOG ] 打开检测日志、[ DESK ] 进入桌面模式。检测到目标时会弹出全屏告警卡片，10 秒后自动消失，也可点击关闭。

如果要从源码构建，先安装 PlatformIO，克隆仓库，在项目目录执行 pio run -t upload；非默认板型需指定构建环境，例如 pio run -e freenove-s3 -t upload。新手完整步骤见构建指南。

检测可信度与限制

固件对每条特征都标注可信度，并与 IEEE OUI 注册表核对：97 条硬件前缀中 33 条为 High、4 条为 Medium、60 条为 Low。这对 Flock 影响最大：49 条前缀里只有一条注册在 Flock Safety 名下，其余属于通用芯片和模组厂商，附近的 ESP32 也可能命中。ALERT FILTER 可设为只允许 High 可信度触发全屏告警。项目把 Flock、Axon、读卡器和拍摄眼镜的检测描述为可靠，Remote ID 和 iBeacon 为精确格式匹配，Raven、通用 ALPR 和 Google 追踪网络为尽力而为。逐条特征的来源记录另有文档。

隐私、安全与使用条件

板子扫描时不需要联网，但默认会在启动时短暂连接已保存的网络做更新检查并同步 NTP 时间，可在设置中关闭 UPDATE CHECK。板间通信功能 SquachMesh 默认关闭；开启 TRANSMIT 后会广播固定标识，扫描者可能据此还原你的活动轨迹，固件在开启前会先显示全屏警告。设备支持 PIN 锁、胁迫 PIN、拍摄用隐私模式以及远程更新开关。OTA 更新经过签名，板子会拒绝非本板型的固件。项目采用 GPL-3.0 许可证。

HotRepo 点评

在 2026-11-09 的 C++ 日榜记录中，该项目为 492 星、82 个 fork，当天新增 7 星，最好名次为第 13 名。这只是单次快照，不能当成趋势，但已让一个非常垂直的硬件探测器进入当天较显眼的 C++ 项目行列。更值得注意的是花哨界面背后的工程投入：特征可信度分级、主机端测试、用同一份源码编译的 PC 模拟器，以及逐条特征的来源文档。代价是，最吸引眼球的界面之下，不同目标的检测可信度差异很大，行动之前最值得读的是项目自己给出的可信度标注。

项目源码与说明