Mediary Scout 是一个面向自托管用户的“云盘媒体库获取与追踪”系统。用户输入电影、剧集或动漫名称后，系统通过 LLM Agent 在 PanSou、Prowlarr 等资源索引中搜索资源，按清晰度、字幕、去重和缺集状态选择合适资源，并将资源转存或离线到用户自己的 115、夸克网盘或光鸭云盘中，随后再回读网盘状态进行验证。项目使用 TypeScript / Next.js / Postgres 构建，支持 Docker Compose 部署，定位是高级用户自建工具，而不是面向大众的一键式影音产品。
适用领域
媒体库自动化 / 云盘资源管理 / 自托管应用 / LLM Agent 工作流 / 影视剧集追踪 / 网盘转存与离线下载 / Next.js Web 应用 / Postgres 队列与状态管理
配置难度
中高。项目提供 Docker Compose 快速启动，但真正可用需要理解自托管、云盘登录、LLM API、Prowlarr、TMDB、网络访问和安全暴露等配置。对于熟悉 NAS、Docker 和影音自动化的用户难度适中；对于普通用户门槛较高。
商业价值
该项目对个人和小型家庭媒体库场景有较高实用价值，可以显著减少手动搜索、筛选、转存和追踪缺集的时间。对开发者而言，它展示了 LLM Agent 与确定性工作流结合的实际应用范式，也具备扩展到更多网盘、更多索引器和更复杂媒体管理场景的潜力。但由于版权合规、平台接口不稳定和自托管定位，其商业化为托管 SaaS 的风险较高，更适合作为开源自托管工具、私有部署方案或技术参考项目。
01
技术亮点
- 将媒体获取建模为状态机，而不是简单搜索和下载，能够记录已拥有、缺失和正在追踪的剧集状态。
- LLM Agent 会基于实际搜索结果、字幕需求、质量偏好和去重逻辑做选择。
- 支持转存后回读网盘状态进行验证，降低资源获取失败但误判成功的概率。
- 支持 115、夸克和光鸭云盘，并将不同网盘作为一等工作区处理。
- 采用云端转存或离线下载方式，不需要将文件下载到本地磁盘。
- 支持定时补齐缺失剧集，适合追更中的番剧、剧集和综艺。
- Next.js Web UI 提供搜索、媒体墙、详情页、实时任务队列、通知和设置界面。
- Postgres 保存任务队列和运行状态，Worker 重启后可基于数据库和网盘真实状态恢复。
- Docker Compose 部署门槛相对可控，并提供中文文档和中国大陆构建加速说明。
- 项目架构预留了新增云盘品牌的插件化扩展空间。
02
目标用户
- 拥有 115、夸克网盘或光鸭云盘账号的高级用户
- 希望自动搜索、转存、追踪影视资源的个人影音爱好者
- 有 NAS、软路由、VPS 或家用服务器的自托管用户
- 熟悉 Docker Compose、环境变量、反向代理或内网穿透的开发者
- 希望构建个人或家庭云盘媒体库的用户
- 对 LLM Agent 自动化工作流感兴趣的开发者
03
配置要求
- 必须具备 Docker / Docker Compose 运行环境。
- 需要 Postgres，Docker Compose 已包含。
- 至少需要一个可用的云盘账号：115、夸克网盘或光鸭云盘。
- 115 和夸克支持扫码登录或 Cookie；光鸭需要 access_token 和 refresh_token。
- 需要一个 OpenAI-compatible LLM 接口，包括 baseURL、apiKey 和 modelId。
- TMDB 元数据默认可通过作者提供的代理使用，但生产环境建议配置自己的 TMDB API Key。
- 如果要使用磁力、BT 或多索引器聚合，建议配置 Prowlarr。
- 如果部署在中国大陆，可能需要 Docker 镜像源和 npm 镜像源。
- 如果要长期自动追剧补集，需要部署在 always-on 的主机上。
- 如需外网访问，应配置 Tailscale、Cloudflare Tunnel 或其他受保护的访问方式，并避免裸露服务端口。
04
适用场景
- 输入电影或剧集名称后，自动搜索资源并转存到自己的云盘
- 追踪剧集季度和集数，自动识别缺失集数并定期补齐
- 根据偏好选择高质量资源、中文字幕资源或避免重复资源
- 将 115、夸克、光鸭多个云盘作为独立媒体工作区进行管理
- 通过 Prowlarr 聚合磁力或 BT 索引，并让 115 或光鸭执行离线任务
- 在家庭 NAS、软路由或 VPS 上搭建私有媒体获取系统
- 通过 Bark、Server酱、企业微信或 webhook 接收获取结果和每日摘要通知
05
部署与配置
- 准备一台可长期运行的机器，例如 NAS、软路由、闲置 PC 或 VPS。
- 安装 Docker 和 Docker Compose。
- 克隆仓库：git clone https://github.com/fancydirty/mediary-scout && cd mediary-scout
- 复制环境变量示例：cp .env.example .env。大多数配置也可以后续在 Web UI 中完成。
- 启动服务：docker compose up -d。该命令会启动 Web 应用、Postgres 和内置 PanSou。
- 如果在中国大陆无法访问 Docker Hub，需要先配置 Docker Registry 镜像；构建时可使用 npm 镜像参数，例如 docker compose build --build-arg NPM_REGISTRY=https://registry.npmmirror.com。
- 打开浏览器访问 http://<host>:3000。
- 进入 Settings，配置至少一个云盘账号、LLM OpenAI-compatible 接口、可选的 TMDB Key、Prowlarr 和通知渠道。
- 如需多人模式，在 .env 中设置 MEDIA_TRACK_MULTI_USER=1，然后执行 docker compose up -d web。
- 如需公网或异地访问，建议使用 Tailscale 或 Cloudflare Tunnel，不建议直接暴露 3000 端口。
06
风险与注意事项
- 项目涉及影视资源搜索、网盘转存、磁力和离线下载，用户需要自行确保使用行为符合当地法律法规和平台服务条款。
- 依赖 115、夸克、光鸭等非官方或半官方接口，网盘平台接口变更、风控、会员策略变化都可能导致功能失效。
- 需要用户提供云盘凭据、Cookie、Token 和 LLM API Key，自托管环境的安全性非常重要。
- 如果将服务直接暴露到公网，可能存在账号、Token 或内部服务被攻击的风险。
- LLM Agent 的资源选择并非绝对可靠，可能出现选错版本、字幕不匹配、质量不符合预期等情况。
- 项目当前星标约 286，生态和长期维护确定性仍需观察。
- 对于非技术用户部署和排错成本较高，不适合作为开箱即用消费级产品。
- 中国大陆网络环境下 Docker Hub、TMDB、部分 LLM 或索引器可能访问不稳定。
- Prowlarr、PanSou、TMDB、LLM 服务和网盘服务任一环节异常都会影响完整工作流。
- 光鸭当前版本说明更偏向磁力、ed2k、BT 离线任务，不支持 115、夸克或光鸭分享链接互转的完整场景。
2026-06-28
第22名
新收录 · github_search
