转存前先看落点
动手之前先读你的入库目录。这部片已经在库里，就不会重复获取一遍。
自部署 · 不是一个托管服务
把片收进你自己的网盘
说一个片名，它跨资源源检索，把最合适的转存进你自己的网盘， 然后回读网盘里的真实文件做验证，按 TMDB 规范命名归位。 剧集还会持续盯着缺哪几集，定时巡检只补缺口。
0BSD 开源 Docker / 飞牛 fnOS 凭证只在你自己的实例里
- 落点检查目标目录无影片，开始获取
- 预搜快照候选 3 条
- 评分决策无 A 级候选 → 转入别名兜底
- 选片仲裁选中《野兽之心 2160p 中字》
- 转存到暂存区（第 1 次转存）
- 回读验证一部正片（视频 1）
- 改名归位野兽之心 (2026).mkv
- 结论影片已入库
先看它跑一遍
真实界面录屏：从首页的最近热门点进去 → 点「获取」→ 转存 → 去通知页看到这条「已入库」。
它能做什么
和「搜索 + 转存」脚本的差别，主要在后半段。
转存后回读验证
「转存成功」不等于文件真的落好了。它会重新列网盘里的真实文件和体积， 对照预期核对，确认落盘才标记已入库 —— 不确认就不算成功。
追到补齐为止
一本剧按季记账，每季记着还缺哪几集。补的时候只找缺的那几集，不用把整部剧重新搜一遍。
定时巡检只处理缺口
可以设每天几个时间点。巡检只关心仍有缺口的剧，回来的结果进通知页当日报读。
五块网盘都是一等工作区
夸克 / 115 / 光鸭 / 123 / 天翼。多块盘可以同时接，侧栏随时切换当前工作区，各自的库互不干扰。
过程留痕，可以查
每一步的证据都摊在活动页上：搜到什么、为什么选它、转存了几次、验证结论是什么。
真实界面
下面三张都是本项目的实际截图，不是设计稿。
怎么跑起来
配好三样东西就能用：TMDB → AI → 一块网盘。
-
1
配 TMDB
片名、季集数、上映状态都靠它。必须自己申请 —— 代码里没有任何内置 key，也没有环境变量兜底。填在「设置 → 资源与服务」。
-
2
配 AI
资源文件名里有一堆歧义（多季打包、简繁混杂、同名异作）。填任意 OpenAI 兼容端点的地址、key、模型名，点「测试连接」验证。
-
3
连一块网盘
转存落在哪块盘。连一块就能跑；之后想加盘随时加，多块盘是一等工作区。
-
4
搜片名，点「获取」
剩下的交给后台：检索 → 核对落点 → 转存 → 回读验证 → 入库。过程去活动页看。
装在哪儿
Docker Compose
任何常开主机
git clone https://github.com/CodeByZack/media-robot
cd media-robot
cp .env.example .env
docker compose --project-directory . -f deploy/docker/docker-compose.yml up -d起来后打开 http://<主机>:3000。
它不做什么
这部分不是免责声明，是选型信息 —— 先看清边界，再决定要不要装。
- 不下载到本地磁盘。转存是直接进网盘，你的硬盘全程不落文件。
- 不提供托管服务。没有官方实例、没有账号体系，你得自己跑一个。
- 不伪造成功。找不到资源就如实报「暂无资源」并继续尝试，不会塞一个不相干的文件充数。
- 不自带任何凭证。TMDB key 和 LLM key 都得你自己填，代码里没有内置的。
- 不保证资源存在。资源池取决于 PanSou（可选再接 Prowlarr），池子里没人分享就是真的没有。
- 定时巡检要有常开主机才有意义。关机的机器不会替你补集。
- 115 / 夸克通常需要会员。123 / 天翼的免费账号也能转存。
常见问题
它会乱动我的网盘吗？
只会做你自己手动也能做的转存和改名整理，每一步都在活动页留痕可查。网盘凭证只存在你自己实例的数据库里。
我需要准备什么？
一台能跑 Docker 的常开设备（或一台飞牛 NAS）、一个自己申请的 TMDB read token、一个 OpenAI 兼容的 LLM 端点，以及一块受支持的网盘账号。
支持哪些网盘？
夸克、115、光鸭云盘、123网盘、天翼云盘。各盘转存能力不同：光鸭只能磁力 / 离线下载，115 和 123 支持原生离线下载。多块盘可以同时接，侧栏切换工作区。
要花钱吗？
软件本身 0BSD 开源免费。你要自己承担的三项：TMDB key 免费、LLM 按量计费（一次干净的获取通常 0–2 次调用）、以及网盘会员费 —— 115 / 夸克通常需要会员，123 / 天翼免费账号也能转存。
为什么某部片搜不到资源？
资源池来自 PanSou（可选再接 Prowlarr），池子里没人分享就真的没有。这时它会如实报「暂无资源」并继续尝试，不会伪造成功、也不会塞一个不相干的文件进去。