nzbget

核心功能

NZBGet Status Checker 是一款专为 Usenet 下载管理设计的轻量级监控工具，通过调用本地脚本与 NZBGet 服务端通信，提供下载队列的实时状态查询。

主要用法

• 快速计数：count 指令返回当前活跃下载任务数，适合语音助手快速响应
• 速度查询：speed 指令获取实时下载带宽（MB/s）
• 队列概览：queue 指令列出前 10 个任务，避免大队列信息过载
• 完整报告：无参数调用时输出综合状态，包含任务数、速度、剩余容量及各任务进度百分比

显著优点

1. 响应简洁：针对语音/聊天场景优化，支持纯数字、纯速度值等精简输出格式
2. 信息防过载：自动限制队列显示数量为 10 项，对积压 400+ 任务的用户友好
3. 场景覆盖全：涵盖 "有多少在下载""当前速度多少""队列里有什么"三类高频问题

潜在局限

• 仅限查询：仅支持读取状态，无法添加/删除任务、修改优先级或控制启停
• 本地依赖：需预先配置 scripts/check_nzbget.sh 脚本及 NZBGet 服务端连通性
• 无历史数据：不提供下载历史统计、速度趋势图表等分析功能
• 隐私暴露：若 NZBGet 未设置认证，脚本可能直接暴露下载内容文件名

适合人群

• NAS/Homelab 用户：运行 NZBGet 作为下载核心，需快速检查状态
• 智能家居集成：希望通过语音助手获取下载进度的自动化爱好者
• 轻度监控需求者：不需要完整 WebUI，仅需关键数字摘要的场景

常规风险提示

| 风险类型 | 说明 |

|---------|------|

| 凭证安全 | 脚本若硬编码 NZBGet 认证信息，存在配置泄露风险 |

| 网络暴露 | NZBGet RPC 接口若开放于公网，可能被未授权访问 |

| 内容敏感 | 队列中的文件名可能包含版权内容标识，响应中直接暴露 |

> 安全等级说明：本 Skill 仅执行本地脚本读取操作，本身无网络外连，但依赖的 NZBGet 服务端安全性由用户配置决定，建议配合 VPN/反代及强密码使用。

核心用法

NZBGet Status Checker 是一款轻量级的 Claude Code Skill，专为查询 NZBGet 下载管理器状态而设计。用户可通过简单的自然语言指令获取下载队列信息，无需手动登录 Web 界面。

该 Skill 提供四种查询模式：

• count：快速获取当前活跃下载数量
• speed：实时查询下载速度（MB/s）
• queue：列出队列前 10 个下载项
• 完整报告（无参数）：综合展示活跃任务数、速度、剩余容量及当前队列详情

所有功能通过调用 NZBGet 内置的 JSON-RPC API 实现，响应数据经格式化后以清晰的列表形式呈现，支持百分比进度显示。

显著优点

1. 零配置侵入：纯只读操作，不修改任何服务器配置或下载任务
2. 智能输出限制：自动限制队列显示为 10 项，避免大队列（400+ 任务）造成信息过载
3. 环境变量安全：敏感凭据（用户名/密码）通过环境变量注入，脚本内无硬编码
4. 防御式编程：大量使用空值检查与错误静默处理，确保异常场景不崩溃
5. 响应简洁：针对 count、speed 等简单查询直接返回数值，便于对话式集成

潜在缺点与局限性

1. HTTP 明文传输：使用 HTTP 而非 HTTPS 传输凭据，存在局域网嗅探风险
2. 依赖外部工具链：必须预装 curl、jq、bc 三个系统工具，缺失任一即失效
3. 无超时保护：curl 未设置连接/读取超时，网络异常时可能长时间挂起
4. 输入未严格校验：环境变量直接拼接入 URL，若被恶意篡改可能泄露凭据至非预期地址
5. 仅限局域网场景：设计初衷为访问本地/内网 NZBGet 实例，公网部署安全隐患较高
6. 功能单一：仅支持状态查询，无法执行暂停、删除、优先级调整等管理操作

适合的目标群体

• 家庭 NAS 用户：在群晖、Unraid、TrueNAS 等平台上部署 NZBGet 的自动化爱好者
• Usenet 资深玩家：需要频繁检查下载进度，但不想打开浏览器登录 Web UI 的重度用户
• CLI 环境偏好者：习惯终端操作，希望将下载状态查询整合到 Claude Code 工作流的技术用户
• 自动化脚本开发者：需要将 NZBGet 状态作为下游触发条件（如完成通知、磁盘空间检查）的进阶用户

使用风险说明

1. 凭据泄露风险：建议在可信内网使用，避免在公共 Wi-Fi 或未隔离网络环境中部署；如条件允许，应为 NZBGet 配置 HTTPS 反向代理
2. 依赖项可用性：使用前请确认 curl --version、jq --version 可用；容器化环境（如某些 Docker 镜像）可能需手动安装 jq
3. 性能影响：高频查询（如每秒一次）可能对低配置 NZBGet 主机造成轻微负载，建议合理控制调用频率
4. 版本兼容性：基于 NZBGet 标准 JSON-RPC 接口，理论兼容 v20+ 版本；极老旧版本 API 响应格式可能存在差异
5. 无持久化缓存：每次查询均为实时 API 调用，NZBGet 服务离线时将直接报错，无本地缓存兜底