SuperAPI AI 工具集

network-diagnostics

测试与质量

查看项目

更新于 10-15 21:08

技能介绍

用途:在 macOS 上排查网络问题,触发语包括“debug my network”“internet is slow”“check connectivity”“why is my internet bad”“diagnose network”。

主要能力:检查默认路由(route -n get default,无路由记为 critical);用 ping -c 5 -t 5 1.1.1.1 与 8.8.8.8 测延迟丢包,按丢包率与平均延迟分级(0% 且 <50ms 为 ok,<10% 或 50–200ms 为 info,10–25% 或 200–500ms 为 warn,≥25% 或 ≥500ms 为 critical);用 dig 检查 DNS 解析,空结果记 warn,缺 dig 时回退 nslookup 或 host;用 scutil --dns 列出解析器;用 networksetup -listallhardwareports 与 ifconfig 记录网卡和 IPv4 接口;检测 utun/ppp 判断 VPN;用 lsof 列出本用户监听端口(前 10)与已建立连接;延迟检查通过时可选用 traceroute(限约 15 秒)。

使用方式:直接调用时执行 bash ${CLAUDE_PLUGIN_ROOT}/scripts/render-single.sh network-diagnostics;由 daily-health-report 调用时只返回 JSON 路径。结果写入 ~/.mac-guardian/data/network-diagnostics-<ISOdate>.json,顶层 severity 取最严重发现,summary 指出主要问题或确认网络正常。

限制:只读操作,不刷新 DNS、不重启接口、不切换 VPN;每个外部工具需用 command -v 检查,缺失时记为“tool not available”。