Agent影视助手
Agent影视助手 是这个仓库的主线插件，重点解决一件事：
把 飞书命令入口、外部智能体、盘搜、影巢、115、夸克、MoviePilot 原生搜索 / PT 下载 收进同一套稳定工作流。
当前版本：0.2.71
当前 helper 版本：0.1.51
当前 Release：https://github.com/liuyuexi1987/MoviePilot-Plugins/releases/tag/v0.2.71
如果你是第一次用这个仓库，先把这个插件跑通就够了。
适合谁
- 你想把飞书当成类似
TG / 企业微信的资源命令入口。 - 你想让
OpenClaw、Hermes、WorkBuddy这类外部智能体稳定控制 MoviePilot。 - 你想统一处理“找资源 -> 选资源 -> 转存到 115 / 夸克”的流程。
- 你也想把 MoviePilot 原生
MP搜索 / PT搜索 / 下载 / 订阅 / 更新检查放进同一套命令入口。 - 你希望智能体不要自己乱拼影巢、盘搜、115、夸克接口，而是统一交给插件执行。
两种主要用法
1. 不使用外部智能体，只用飞书命令入口
如果你不想接外部智能体，只想要一个命令窗口，可以只配置飞书。
配好后，直接在飞书里发：
盘搜搜索 片名
影巢搜索 片名
转存 片名
夸克转存 片名
下载 片名
更新检查 片名
115登录
影巢签到
这种用法更像 TG / 企业微信机器人入口：飞书负责收消息，插件负责执行。
2. 使用外部智能体
如果你要接 OpenClaw、Hermes、WorkBuddy，建议安装 agent-resource-officer skill / helper。
外部智能体负责理解用户需求和展示结果；资源搜索、转存、下载、签到、Cookie 修复都交给插件。
重点文档：
MCP 和 Skill 怎么分工
如果你的智能体客户端支持 MoviePilot 官方 MCP，可以一起接。
- MCP 更适合查 MoviePilot 管理信息，比如插件列表、下载器状态、站点状态、历史记录、工作流。
agent-resource-officer skill / helper更适合资源流，比如盘搜、影巢、115/夸克转存、PT 编号下载、翻页、盘搜/影巢详情和 Cookie 修复。MP搜索 / PT搜索 / 下载 / 更新检查这类片名资源流，也建议优先交给agent-resource-officer，避免智能体绕过插件规则。
MCP 地址通常是：
http://你的MP地址:3000/api/v1/mcp
X-API-KEY=你的 MoviePilot API_TOKEN
核心命令
搜索
| 命令 | 作用 |
|---|---|
搜索 <片名> |
默认优先走 MP/PT；如果 MP/PT 已关闭，再按当前启用源回退 |
盘搜搜索 <片名> |
先查盘搜；盘搜没结果时按开关补查影巢 |
影巢搜索 <片名> |
先查影巢；影巢没结果时按开关补查盘搜 |
MP搜索 <片名> / PT搜索 <片名> |
走 MoviePilot 原生搜索 / PT 搜索 |
盘搜更新检查 <片名> |
只看盘搜侧更新资源 |
影巢更新检查 <片名> |
只看影巢侧更新资源 |
补充：
搜索 第 3 集、搜索 E03这类带集数线索的写法，会直接按 MP/PT 搜索，不再回退到云盘。检查 大君夫人、检查大君夫人这类写法，会按更新检查处理；但检查115登录仍然保留为 115 登录检查。更新检查 xx 剧/检查 xx 剧这类带剧集意图的写法，会按 MP/PT 搜索；云盘侧更新检查请显式使用盘搜更新检查或影巢更新检查。
转存 / 下载
| 命令 | 作用 |
|---|---|
转存 <片名> |
默认等同 115转存 <片名> |
115转存 <片名> |
搜索后优先转存到 115 |
夸克转存 <片名> |
搜索后优先转存到夸克 |
下载 <片名> |
走 MoviePilot 原生 PT 下载链，先找片并列出 PT 候选 |
注意：
转存 <片名>默认是 115，不会自动改成夸克。- 只有明确说
夸克转存 <片名>才走夸克。 下载 <片名>是 PT 下载，不是云盘转存。- PT 搜索结果里直接回编号会立即下载。
下载1是给当前 PT 结果生成下载计划，不是确认旧计划。- 云盘/影巢结果才有详情卡；想看详情用
选择 1 详情或详情 1。
选择 / 翻页
1
下载1
选择 1 详情
n
1：PT 结果里直接下载；云盘结果里继续转存/解锁。下载1：给第 1 条 PT 结果生成下载计划。选择 1 详情/详情 1：只用于云盘/影巢详情。n：下一页。
完整命令见：docs/ALL_COMMANDS.md
主要能力
云盘资源
- 盘搜搜索
- 影巢搜索 / 解锁
云盘搜索已废弃，收到后只会提示改用盘搜搜索/影巢搜索- 115 转存
- 夸克转存
- 更新检查
- 编号选择、详情、翻页
- 智能建议与候选推荐
MoviePilot 原生能力
- MP / PT 搜索
- PT 下载计划
- 订阅
- 下载任务
- 下载历史
- 入库历史
- 站点状态 / 下载器状态
- 热门探索 / 推荐
账号与修复
- 115 扫码登录 / 状态检查
- 影巢签到 / 签到日志
- 影巢 Cookie 修复
- 夸克 Cookie 修复
115登录 / 115转存 现在不再强依赖 P115StrmHelper；有它时更适合做 115 整理、STRM 和旧登录态复用，没有它也可以直接扫码后完成 115 转存。
Cookie 修复会用到本机浏览器登录态。如果 MoviePilot 在 NAS、智能体在电脑上，修复命令读取的是智能体电脑上的浏览器 Cookie，再写回 NAS 上的 MoviePilot。
和旧插件的关系
Agent影视助手 是把旧的分散能力收成一条主线。
| 旧插件 | 主要用途 | 现在建议 |
|---|---|---|
FeishuCommandBridgeLong |
旧飞书入口 | 新环境优先用 Agent影视助手内置飞书入口 |
HdhiveOpenApi |
影巢独立能力 | 主能力已收进 Agent影视助手 |
QuarkShareSaver |
夸克独立转存 | 主能力已收进 Agent影视助手 |
HDHiveDailySign |
旧影巢签到兜底 | 新环境优先走 Agent影视助手修复链 |
旧组合仍然能用，但更适合兼容老环境；新装建议优先用 Agent影视助手。
新手最容易踩的坑
外部智能体乱改命令
常见错误：
- 把
盘搜搜索、影巢搜索、MP搜索这些明确命令改写成别的入口 - 把
下载当成云盘转存 - 把云盘详情当成直接选择，或把 PT 编号下载当成详情
- 重排插件返回的编号
解决方式：让智能体安装并读取 agent-resource-officer skill。长线程跑偏时，直接对智能体说：
校准影视技能
外部智能体收到这句时，应先检查并拉取 MoviePilot-Plugins 仓库最新版，再重新加载影视技能规则；如果工作区有本地改动，就跳过自动拉取并说明原因。
跨机器地址填错
如果 MoviePilot 在 NAS，智能体在电脑上，ARO_BASE_URL 要填 NAS 地址：
ARO_BASE_URL=http://你的NAS地址:3000
不要填 127.0.0.1，那只代表智能体自己这台机器。
夸克失败不一定是 Cookie 失效
分享受限、分享者封禁、41031 不一定是 Cookie 问题。只有明确提示登录态失效时，才优先走夸克 Cookie 修复。