Mediary Scout

Mediary Scout 是一款面向进阶用户的开源、可自部署媒体资源获取工具。它不同于传统的自动化下载软件（如 Sonarr/Radarr + qBittorrent），而是创造性地引入了 LLM Agent（大语言模型智能体），直接与你已有的云盘账号（115、夸克、光鸭云盘）交互。

它的核心理念是：将媒体获取视为一个“状态管理”问题，而非简单的文件搬运。 Agent 会根据你的需求跨源搜索、智能筛选最佳资源、执行转存、回读验证，并持续追踪剧集的完整性，确保你的网盘媒体库始终处于“完美”状态。

核心亮点：为什么选择 Mediary Scout？

🤖 Agent 驱动的智能决策

• 凭证据行动：Agent 不仅读取搜索结果，还会理解画质编码、字幕语言、文件大小等元数据。它会像真人一样，根据你的偏好（如“只要 4K 中字”、“排除重复资源”）挑选最合适的版本。
• 转存后验证：传统工具往往只管转存不管结果。Mediary Scout 在转存后会立即“回读”网盘目录，确认文件是否成功落地、命名是否正确、集数是否完整。

☁️ 网盘原生，秒传直达

• 零本地带宽占用：所有操作均在云端完成。通过调用网盘 API 实现磁力链/分享链接的“秒传”或“保存”，无需经过本地服务器下载再上传，极大节省时间和带宽。
• 多盘隔离与管理：支持 115、夸克、光鸭云盘。每个网盘账号被视为独立的工作区，资源搜索与获取按网盘隔离，互不干扰。

📊 状态机追踪与自动补缺

• 季级状态管理：系统维护每部剧的“季级状态机”，清楚记录哪一季缺哪一集。
• 定时巡检：Agent 会定期巡检你的媒体库，只针对那些仍有缺集或正在追更的剧集发起新的搜索和补全任务，避免无效劳动。

🔌 高度可扩展与插件化

• 品牌可扩展：采用插件式架构，接入新的网盘品牌（如阿里云盘、百度网盘等）是一个收敛的开发过程。
• 集成主流索引源：支持与 Prowlarr、PanSou 等索引源对接，确保资源发现的广度。

功能概览

适用人群

• 网盘重度用户：拥有 115、夸克或光鸭云盘会员，希望最大化利用网盘存储和秒传功能。
• 自部署爱好者：熟悉 Docker、Linux 基本操作，有能力配置 API Key 和环境变量。
• 完美主义者：无法忍受媒体库中存在缺集、错误画质或无字幕版本的用户。
• LLM 应用探索者：对 Agent 在实际生活场景中的应用感兴趣，愿意尝试前沿的自动化工作流。

⚠️ 注意事项

• 非一键式产品：Mediary Scout 需要用户自行部署、配置 LLM API Key 及各网盘的 Cookie/Token。它不适合追求“开箱即用”的小白用户。
• 凭证安全：由于涉及网盘账号的高权限操作，请务必妥善保管配置文件中的敏感信息，建议在隔离环境中运行。
• 合规使用：请遵守相关法律法规及网盘服务条款，仅用于个人合法媒体的备份与管理。