用途:该技能用于对已配置的 qBittorrent、Transmission 或 rTorrent 实例进行下载器原生检查、诊断与直接控制。普通 MoviePilot 获取流程(站点搜索、download.add、订阅、转移、历史、媒体库检查)应优先使用 moviepilot-api;本技能适用于下载器原生检查、诊断、高级任务属性以及用户明确要求直接操作下载器提供方的场景。
主要能力:通过 scripts/mp-downloader.py 调用,支持实例与能力发现(instances、capabilities),会话级操作(读取 qBittorrent 内容布局、Transmission 会话详情、全局限速读写、统计),任务操作(列表过滤、启动、暂停、删除、强制开始、队列移动、重新校验、强制汇报 Tracker、标签读写、Tracker 读写、文件列表与文件选择、任务限速/分享率/做种时间设置、分类设置、位置设置、直接添加磁力/URL/本地种子、读取 qBittorrent 对等数据)。
使用方式:在 MoviePilot 程序目录用项目运行时执行,例如:cd <MOVIEPILOT_ROOT> 后运行 python skills/downloader-operation/scripts/mp-downloader.py instances。调用动作示例:python skills/downloader-operation/scripts/mp-downloader.py call --client "main-qb" --action tasks.list --arguments '{"status":"downloading","limit":20}'。--arguments 必须是单个 JSON 对象;大读取用 offset 和 limit 分页,默认 50,最大 200。若从 <CONFIG_PATH>/agent/skills/ 直接运行复制脚本,需先设置 MOVIEPILOT_ROOT 为程序目录。外部 MCP 客户端使用管理员专用工具 downloader_operation,参数为 client、action、arguments,client 可省略以使用默认或唯一启用的下载器。
限制:不要请求、打印或传递主机、用户名、密码、API 密钥、Cookie 或任意 URL,助手自行读取本地配置。tasks.add.direct 会绕过 MoviePilot 下载历史、站点 Cookie、路径选择、重复检查与转移编排,仅在用户明确要求直接提交时使用。tasks.location.set 与 tasks.add.direct 的路径是下载器侧路径,不是 MoviePilot 存储路径。tasks.location.set 不评估 MoviePilot 媒体分类。不要用空参数或猜测参数探测动作;助手会一次性报告所有可检测的参数错误。不要查看助手源码来发现参数。写入后应查询最小相关状态进行验证。下载器连接可能依赖 macOS 本地网络权限,应始终使用提供的 python 命令。不要使用不满足 MoviePilot 所需 Python 版本的系统 python3。