（8101期）qbittorrent – BitTorrent 远程下载管理专家

BitTorrent 远程下载管理专家 基于 qBittorrent WebUI 的命令行客户端，支持远程管理种子任务与自动分类，实现安全高效的下载自动化。 使用说明 qbittorrent Skill 是一款基于 Bash 脚本开发的 qBittorrent WebUI API 客户端，专为需要远程管理 BitTorrent 下载任务的用户设计。通过简洁的命令行接口，用户可以在本地或远程服务器上实现种子任务的全面自动化管理，无需依赖图形界面即可完成复杂的下载任务编排。 核心用法方面，该 Skill 通过调用 qBittorrent v4.1+ 提供的 WebUI API 实现功能交互。用户首先需在 ~/.clawdbot/credentials/qbittorrent/config.json 中配置目标地址及认证信息，随后即可通过 ./scripts/qbit-api.sh 执行各类操作。主要功能涵盖：列出种子（支持按状态、分类筛选）、添加任务（支持 Magnet 链接、URL 及本地种子文件）、任务控制（暂停、恢复、删除、重新校验）、分类与标签管理，以及全局速度限制和传输统计查询。所有命令均返回结构化的 JSON 数据，便于与其他自动化工具链集成。 显著优点包括：纯 Bash 实现确保了极佳的兼容性和低资源占用，适合在 NAS、树莓派等资源受限设备运行；完善的分类和标签系统支持复杂的媒体库自动化整理；速度限制功能可有效管理带宽占用；命令行特性使其能轻松集成到 Crontab、Home Assistant 等自动化工作流中。此外，删除操作默认保留文件，需显式添加 --files 参数才会清理磁盘，这一设计有效避免了误删风险。 潜在缺点与局限性在于：输入参数验证相对简单，对种子哈希值的格式检查不够严格，可能导致无效请求；文件上传功能未对种子文件类型进行严格校验；作为 T3 级社区来源项目，长期维护更新存在不确定性；功能强依赖于 qBittorrent WebUI 的可用性和网络连通性，若目标服务离线则无法工作。 适合的目标群体主要包括：拥有 NAS 或家庭服务器的进阶用户，需要通过脚本实现下载自动化的极客用户，以及运维人员构建媒体资源自动化获取管道。对于仅需偶尔手动下载的普通用户，直接操作 qBittorrent 原生界面可能更为直观。 使用该技能可能存在的常规风险包括：配置文件以明文存储密码，若权限设置不当（未执行 chmod 600）可能导致凭据泄露；Cookie 临时文件存储于 /tmp 目录，在多用户共享服务器环境下存在被其他用户读取的潜在风险；若配置为连接公网可访问的 qBittorrent 实例且未启用 HTTPS，认证信息可能在传输过程中被截获；此外，自动化脚本错误可能导致非预期的任务删除或带宽占满，建议在生产环境部署前充分测试。 原始说明 Manage torrents with qBittorrent. Use when the user asks to "list torrents", "add torrent", "pause torrent", "resume torrent", "delete torrent", "check download status", "torrent speed", "qBittorrent stats", or mentions qBittorrent/qbit torrent management.