qBittorrent WebUI API

通过 qBittorrent 的 WebUI API（版本 4.1 及以上）管理种子。

设置

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

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

快速参考

列出种子

# All torrents
./scripts/qbit-api.sh list

# Filter by status
./scripts/qbit-api.sh list --filter downloading
./scripts/qbit-api.sh list --filter seeding
./scripts/qbit-api.sh list --filter paused

# Filter by category
./scripts/qbit-api.sh list --category movies

过滤器：全部,下载中,做种中,已完成,已暂停,活跃,不活跃,停滞,出错

获取种子信息

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

添加种子

# By magnet or URL
./scripts/qbit-api.sh add "magnet:?xt=..." --category movies

# By file
./scripts/qbit-api.sh add-file /path/to/file.torrent --paused

控制种子

./scripts/qbit-api.sh pause <hash>         # or "all"
./scripts/qbit-api.sh resume <hash>        # or "all"
./scripts/qbit-api.sh delete <hash>        # keep files
./scripts/qbit-api.sh delete <hash> --files  # delete files too
./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   # global speed/stats
./scripts/qbit-api.sh speedlimit # current limits
./scripts/qbit-api.sh set-speedlimit --down 5M --up 1M

应用信息

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

响应格式

种子对象包括：

• 哈希值、名称、状态、进度
• 下载速度、上传速度、预计剩余时间
• 大小、已下载量、已上传量
• 分类、标签、保存路径

状态下载中,下载停滞,上传中,上传停滞,下载暂停,上传暂停,下载排队中,上传排队中,检查下载文件,检查上传文件,错误,文件缺失