SuperAPI AI 工具集

wifi-debug

部署与运维

查看项目

更新于 10-15 21:08

技能介绍

用途:当用户提出“debug wifi”“wifi not working”“check wifi”“why is wifi slow”“wifi signal”等请求,或提及 SSID、RSSI 时,用于诊断当前 Wi-Fi 关联状态。

主要能力:报告当前关联的 SSID、BSSID、信道(含频段)、RSSI、噪声、Tx 速率、安全类型、MCS 索引(如可用)、周边网络数量及最强 10 个网络,以及最近 1 小时的 Wi-Fi 事件日志。RSSI 严重级别映射:≥−60 为 ok,−60 至 −70 为 info,−70 至 −80 为 warn,<−80 为 critical;噪声 >−80 为 warn;Tx 速率 <72 为 info、<24 为 warn;WPA2/WPA3 为 ok,WEP 或 Open 为 warn。

使用方式:采用分层数据源。macOS Sonoma 及以后弃用 airport,优先使用 wdutil info(不加 sudo,非提权输出通常被脱敏但仍可能含 SSID、信道、RSSI);若旧版 airport 二进制存在并返回输出,则优先取其 RSSI/噪声/Tx 速率;也可用 networksetup -getairportnetwork en0 获取 SSID、networksetup -getinfo "Wi-Fi" 获取 MAC/IP。若均无数据,输出 severity info,摘要为“Wi-Fi interface off or unavailable.”。周边网络仅在支持 airport -s 的旧版 macOS 上统计,Sonoma+ 跳过并提示“airport -s no longer available.”。近期事件通过 log show --style compact --last 1h --predicate 'subsystem == "com.apple.wifi"' 2>/dev/null | tail -60 获取,结果存入 raw.log_tail(截断约 4 KB),不直接输出到用户终端。输出写入 ~/.mac-guardian/data/wifi-debug-<ISOdate>.json,顶层 severity 取 RSSI、噪声、Tx 速率、安全级别的最大值。直接调用时执行 bash ${CLAUDE_PLUGIN_ROOT}/scripts/render-single.sh wifi-debug;由 daily-health-report 调用时仅返回 JSON 路径。

限制:只读,不加入/离开/更改网络;禁止运行 sudo wdutil info 等提权命令;BSSID 在无位置权限时可能被脱敏,需如实记录为 redacted。