WiFi 哨兵

本文由CODEX全自动编写。

WiFi 哨兵是借助 AI 开发的 Mac 菜单栏工具。Wi-Fi 看起来还连着、网页却打不开时，帮你区分连接与上网状况，减少反复打开系统菜单检查的操作。

• 分别检查 Wi-Fi 关联、局域网响应及两个外网目标。
• 展示检测结论、故障复核进度和自动／手动恢复次数。
• 默认 60 秒检测，可调整间隔和业务目标；异常日志支持详情、翻页及导出。
• 自动恢复每次启动默认关闭，确认后才按策略尝试；连续失败进入冷却。

公开版本 0.1 / build 5.3，仅有 Apple Silicon（arm64） 安装包，没有 Intel 安装包。最低编译目标 macOS 13；既有检查主机为 macOS 27.0.1，更早系统未实机验证。它不会增强无线信号，不保证恢复所有故障。

1. 安装

下载 DMG 与 SHA-256 校验文件，核对后将应用拖入 Applications。正式包已经 Developer ID 签名及 Apple 公证，按系统首次打开提示核对来源即可。

2. 保持监测，先观察

从菜单栏双眼 Wi-Fi 图标打开“状态与操作”，查看结论及局域网、外网响应。关闭窗口仍可从菜单栏重新打开。保持自动恢复关闭时也能检测并查看异常。

3. 调整检测设置

在“检测设置”修改间隔或填写自定义业务地址，点击保存。默认访问 Apple 与 Cloudflare 检测目标；设置其他地址前确认可以接受向该地址周期请求。已保存网络名称与网关端口为可选项，普通使用可先留空。

读取当前网络名称可能需要 macOS 定位授权；应用不读取位置坐标或 Wi-Fi 密码。拒绝授权后按应用提示使用，部分网络核对与重联功能会受限。

4. 选择恢复方式

需要时勾选“允许本次启动自动恢复”并阅读确认；重新启动仍需再次确认。默认保守策略在局域网正常时，不会仅凭外网异常就自动关开 Wi-Fi。“上网异常循环恢复”可能在局域网正常而两个外网目标持续超时后触发，请先了解影响。

两种策略都至少需要三轮、持续 120 秒的符合条件故障；连续两次自动恢复验证失败后，冷却 30 分钟清醒时间。“检测并按策略处理”在自动恢复开启时也可能触发恢复；只观察时请关闭总开关。

手动“一键重联 Wi-Fi…”也会先确认。自动或手动恢复可能短暂关开 Wi-Fi，中断会议、下载、SSH 和 VPN。不能接受中断时只用监测。

5. 异常、更新与卸载

查看“异常日志”和“执行与权限”；分享导出诊断前删除 SSID、地址、用户名和私人路径。真实断网自动恢复、指定网络重联及 -3900 情况仍未充分验证，签名公证不代表网络恢复能力已通过。

更新或回滚前正常退出并保留旧应用；如重新开启 Wi-Fi 未确认，先到系统菜单处理。卸载前确认没有未完成恢复事务；本地设置与日志在 ~/Library/Application Support/WiFiSentinel/，需要时在正常退出后自行备份或删除。

完整使用说明 · 安装与回滚 · 验证范围。项目采用 MIT 许可。截图来自真实运行；截图中自动恢复开启，新启动仍默认关闭。