用途：通过本地 UniFi OS 网关 API（在 Cloud Gateway Max 上测试）只读查询和监控 UniFi 网络，适用于查询 UniFi 状态、列出网络设备、查看连接客户端、网络健康、WiFi 状态、网关状态和告警等场景。
主要能力：提供设备（AP、交换机、网关）状态与健康、在线客户端连接位置、站点健康概览、DPI 应用流量洞察、近期告警与事件。所有操作均为只读 GET 请求。
配置：在 ~/.claude-homelab/.env 中填写 UNIFI_URL（网关 IP/主机名，HTTPS）、UNIFI_USERNAME（本地 UniFi OS 管理员用户名）、UNIFI_PASSWORD（密码）、UNIFI_SITE（站点名，通常为 default）。
使用方式：命令支持可选 json 参数输出原始 JSON，默认输出可读表格。仪表盘：bash scripts/dashboard.sh；设备：bash scripts/devices.sh；客户端：bash scripts/clients.sh；健康：bash scripts/health.sh；应用流量：bash scripts/top-apps.sh 15；告警：bash scripts/alerts.sh 50。
限制：需要能访问 UniFi 网关，使用 UniFi OS 登录与 /proxy/network API 路径；全部为只读调用。通过 zsh-tool 调用脚本时必须使用 pty: true，否则输出不可见。参考文件 references/api-endpoints.md 记录了已验证端点。