用途：通过 Unraid 7.2+ 的 GraphQL API 查询和监控 Unraid 服务器的运行状态。
主要能力：可访问 27 个只读端点，覆盖系统在线状态、CPU 与内存使用率、磁盘健康与温度、阵列状态与校验进度、网络共享、日志文件、Docker 容器、虚拟机及通知计数。区分 info（静态硬件规格）与 metrics（实时使用率），监控应使用 metrics。注意 Docker 容器输出日志无法通过 API 获取，需经 SSH 使用 docker logs。
使用方式：先设置凭据，export UNRAID_URL="https://your-unraid-server/graphql" 与 export UNRAID_API_KEY="your-api-key"。API Key 在 Settings → Management Access → API Keys → Create 创建，角色选 Viewer。用辅助脚本查询：./scripts/unraid-query.sh -q "{ online }"；也可用示例脚本如 ./scripts/dashboard.sh、./examples/disk-health.sh、./examples/read-logs.sh syslog 20。脚本支持 -u URL、-k API_KEY、-q QUERY 及 -f json|pretty|raw 格式。经 zsh-tool 调用脚本时必须使用 pty: true，否则输出不可见。
适用场景：检查 Unraid 服务器是否在线、获取 CPU 与内存使用、查看磁盘健康与阵列状态、列出共享、容器与虚拟机、读取系统日志、统计未读通知。
限制：仅只读查询；Docker 容器输出日志不可通过 API 访问；详细端点、故障排查与字段文档见 references 目录内文件。官方文本暂未提供。