巡影 Mediary Scout：AI 网盘影视追更工具

项目简介

巡影（Mediary Scout）是一款开源、需要自己部署的 AI agent 媒体库工具。你只要告诉它想看哪部电影、剧或番，agent 就会自己去搜索资源，挑出最合适的转存进你自己的网盘（夸克 / UC / 115 / 光鸭 / 123 / 天翼）；转存完成后它会再读回来确认文件确实到位，以后缺哪一集还会接着补。

项目同时提供桌面版和 Docker 自部署两种形态，不提供托管服务：实例由你自己运行，网盘与 AI 模型的凭证也由你自己提供。

主要功能

• AI 搜片与获取：输入想看的片名，agent 自动搜索、选源并转存，落盘后回读验证。描述也能找片。
• 多网盘联合获取：连接多个网盘时，agent 会把各盘的资源池合并起来，再按实时剩余容量与画质决定存到哪；单块网盘能收齐就不拆开，单盘凑不齐时会在盘与盘之间互补，把同一季收齐。
• 空间感知与超额保护：设置页的网盘卡片直接显示剩余容量，已满或会员到期后超出容量的网盘会被自动禁止写入；剧集详情页和通知卡片会标出每部作品、每一集所在的网盘。
• 六大网盘支持：夸克、UC、115、123、光鸭云盘、天翼云盘，多数可用手机 App 扫码登录，部分支持分享链转存与磁力。
• 搜索源：资源搜索使用 PanSou（Docker 版自带一个，桌面版默认用公共实例，可换成自己的），可选接入 Prowlarr 找磁力，也可配置海搜（Haisou）官方 API 作为补充搜索源。
• 影视元数据开箱即用：基于 TMDB 的影视信息，无需额外配置。
• 巡检补缺：Docker 形态可 24 小时运行，持续补上缺失的剧集。
• 多用户与远程访问：Docker 版支持多用户，可通过 Tailscale / Cloudflare Tunnel 从外面访问。
• Agent API：可以让 Claude Code、Codex、OpenClaw 等 agent 直接操作巡影。
• AI 选源与外挂字幕：帮助挑选更合适的片源，并处理字幕相关问题。

安装与使用

桌面版（最省事）

从 GitHub Releases 下载：

安装后打开，在设置里连接网盘、填写 AI 模型，然后搜片点「获取」。有新版本时应用会提示下载，覆盖安装会保留数据和设置。

Docker（NAS / 软路由 / 服务器）

git clone https://github.com/fancydirty/mediary-scout && cd mediary-scout
docker compose up -d

打开 http://<主机IP>:3000，在设置里完成配置。之后可以在 设置 → 更新 里一键升级，也能设为每天自动更新。国内构建加速、远程访问、多用户、备份等细节见 部署指南。

AI 模型

自带 OpenAI 兼容接口属于可选升级，key 只保存在你自己的实例里。未配置 AI 模型时，默认使用 Kilo Code 的公共免费模型池，无需注册；此时获取任务的对话上下文（搜索查询、任务与留言内容、候选结果、文件名等）会发送给 Kilo 及其上游模型提供商。

注意事项

• 桌面版与 Docker 的差异：桌面版适合自己在 Mac / Windows 上用，定时巡检只在应用开着时运行，手机或出门访问仅限本机，不支持多用户；Docker 版适合 NAS、服务器常开，巡检 24 小时运行，支持多用户和远程访问。
• 各网盘资源量不同，例如夸克在 PanSou 上资源最多，天翼云盘的电影资源偏少。
• 巡影是开源、自部署软件，不提供托管服务，与你使用的网盘、TMDB 及任何索引器均无隶属关系。

本作品整理自 GitHub 开源项目 fancydirty/mediary-scout，原作者 @fancydirty，许可证 0BSD。中文介绍由 AI 根据项目 README 整理，以原仓库为准。