用途:为 Agent 提供 MoviePilot 的可调用业务 API 面,覆盖媒体搜索与详情、种子与结果搜索、下载提交与任务、订阅增删改查与执行历史、媒体库存在性检查、站点与 RSS、存储浏览与重命名、字幕搜索、插件、调度器、工作流、系统与仪表盘等操作。
主要能力:按分类文件组织操作契约,包括 config、dashboard、database、download、filter、library、media、music、plugin、recommendation、scheduler、search、site、slash、storage、subscription、subtitle、system、torrent、transfer、workflow 等命名空间。每个操作有唯一 operation_id 与精确参数契约,无任意 REST 回退。
使用方式:先选定 operation_id,再用 read_skill 加载对应 api/<category>.md 获取完整契约,然后构造一次网关调用,仅传 operation_id、path_params、query、body。示例:{"operation_id":"media.search","path_params":{},"query":{"title":"The Wandering Earth","type":"media"},"body":{}}。路径占位符放 path_params,GET 过滤放 query,POST/PUT/PATCH 模型放 body。分页用文档字段,计数可传 page=1、count=1 读 collection.total_count。
身份与权限:操作声明 public、bound_user 或 admin 作用域。订阅写操作需授权,普通用户仅能改自己的订阅;渠道用户需在头像 > 个人信息 > 账户绑定中绑定活跃账号。
限制:不得提供 URL、方法、鉴权头、API key 或 token;不得模拟未列出的操作或使用已废弃工具名。写入返回 unknown 时不得重试,需先用读操作核实。订阅日志为浏览器资源端点,非 JSON 网关工具。SMB 路径保留 smb: 前缀,跨共享移动非原子、跨共享硬链接不支持。未列出的路由需由其他领域技能或宿主处理。