qbittorrent

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，认证信息可能在传输过程中被截获；此外，自动化脚本错误可能导致非预期的任务删除或带宽占满，建议在生产环境部署前充分测试。