名称： qbittorrent
版本： 1.0.0
描述： 通过 qBittorrent 管理种子任务。当用户请求"列出种子"、"添加种子"、"暂停种子"、"恢复种子"、"删除种子"、"检查下载状态"、"种子速度"、"qBittorrent 统计信息"或提及 qBittorrent/qbit 种子管理时使用。

qBittorrent WebUI API

通过 qBittorrent 的 WebUI API (v4.1+) 管理种子任务。

配置

配置文件路径：~/.clawdbot/credentials/qbittorrent/config.json

{
  "url": "http://localhost:8080",
  "username": "admin",
  "password": "adminadmin"
}

快速参考

列出种子

# 所有种子
./scripts/qbit-api.sh list

# 按状态筛选
./scripts/qbit-api.sh list --filter downloading
./scripts/qbit-api.sh list --filter seeding
./scripts/qbit-api.sh list --filter paused

# 按分类筛选
./scripts/qbit-api.sh list --category movies

可用筛选器：all, downloading, seeding, completed, paused, active, inactive, stalled, errored

获取种子信息

./scripts/qbit-api.sh info <hash>
./scripts/qbit-api.sh files <hash>
./scripts/qbit-api.sh trackers <hash>

添加种子

# 通过磁力链接或 URL
./scripts/qbit-api.sh add "magnet:?xt=..." --category movies

# 通过种子文件
./scripts/qbit-api.sh add-file /path/to/file.torrent --paused

控制种子

./scripts/qbit-api.sh pause <hash>         # 或 "all"
./scripts/qbit-api.sh resume <hash>        # 或 "all"
./scripts/qbit-api.sh delete <hash>        # 仅删除任务，保留文件
./scripts/qbit-api.sh delete <hash> --files  # 删除任务及文件
./scripts/qbit-api.sh recheck <hash>

分类与标签

./scripts/qbit-api.sh categories
./scripts/qbit-api.sh tags
./scripts/qbit-api.sh set-category <hash> movies
./scripts/qbit-api.sh add-tags <hash> "important,archive"

传输信息

./scripts/qbit-api.sh transfer   # 全局速度与统计
./scripts/qbit-api.sh speedlimit # 当前速度限制
./scripts/qbit-api.sh set-speedlimit --down 5M --up 1M

应用信息

./scripts/qbit-api.sh version
./scripts/qbit-api.sh preferences

响应格式

种子对象包含以下字段：
- hash, name, state, progress
- dlspeed, upspeed, eta
- size, downloaded, uploaded
- category, tags, save_path

状态值：downloading, stalledDL, uploading, stalledUP, pausedDL, pausedUP, queuedDL, queuedUP, checkingDL, checkingUP, error, missingFiles