云盘资源自动变身媒体库：cloud189-auto-save TMDB刮削与NFO生成实战

云盘资源自动变身媒体库cloud189-auto-save TMDB刮削与NFO生成实战【免费下载链接】cloud189-auto-save天翼云盘自动转存系统支持自动监控更新并转存文件。项目地址: https://gitcode.com/gh_mirrors/cl/cloud189-auto-save想让天翼云盘里的影视资源在 Emby 里显示精美的海报和剧情简介吗开源项目cloud189-auto-save天翼云盘自动转存系统原生内置 TMDB 刮削与 NFO 文件生成能力自动监控分享链接并转存、自动生成 STRM 播放文件、调用 TMDB API 智能匹配影片信息、把 NFO 元数据和海报一键落盘最终通知 Emby 刷新入库。本文带你完整走一遍这条云盘 → 媒体库的自动化链路。一、为什么需要 TMDB 刮削与 NFO 生成很多新手把资源转存到云盘后直接接入 Emby 会遇到这些问题文件名混乱资源常是01.mp4、第3集.mp4这类命名媒体服务器认不出片名和集数️没有海报和简介媒体库像一张白纸体验大打折扣手动刮削太痛苦找 TMDB ID、改名、跑刮削器……每部片子都要折腾一遍。NFO 文件就是解决这个问题的钥匙——它是 Emby / Jellyfin 通用的 XML 元数据格式一部剧的简介、演职员、年份等信息都写在里面。cloud189-auto-save 把刮削器直接做进了转存系统转存完成后 NFO 和海报自动生成全程无需人工干预。二、完整链路转存 → STRM → TMDB 刮削 → Emby 入库整个自动化流程可以拆成 4 步分享链接转存 → 生成 STRM 文件 → TMDB 刮削生成 NFO/海报 → 通知 Emby 刷新媒体库在任务页可以看到每个转存任务的状态、更新集数与追更进度刮削就是围绕这些任务自动发生的。三、快速部署 cloud189-auto-save项目支持 Docker 一键部署也可以克隆源码运行git clone https://gitcode.com/gh_mirrors/cl/cloud189-auto-save如果使用 Docker注意挂载strm目录STRM/NFO 文件会生成在这里完整命令见项目 Dockerfile 与 README 说明。浏览器访问http://localhost:3000默认账号密码均为admin登录后记得在系统页修改密码。四、配置 TMDB API Key 与刮削开关进入媒体页面这里有 STRM、Emby、CloudSaver 三大块设置关键配置项有 3 个配置项作用建议启用 STRM 生成转存后自动生成 STRM 文件✅ 必开是刮削的前提TMDB API Key调用 TMDB 数据库的密钥在 TMDB 官网免费申请后填入刮削开关 / AI 配置控制是否自动刮削及 AI 识别建议启用相关前端逻辑在 media.js 与 settings.js 中TMDB 请求还支持单独配置代理proxyTmdb网络不佳的地区记得打开。五、创建转存任务并生成 STRM在任务页创建任务只需填写选择账号粘贴天翼云盘分享链接加密链接需填访问码选择保存目录总集数可选但强烈建议填能显著提升 TMDB 匹配准确度。任务执行后系统会为每个媒体文件生成对应的.strm文件——本质是一个文本指针内容指向云盘文件的播放地址。STRM 生成逻辑位于 strm.js支持两种模式按任务生成追更过程中新增文件实时生成按 Alist 全量生成对已有目录一次性批量生成。六、TMDB 智能匹配刮削更准的秘密有了 STRM 文件刮削引擎开始工作。TMDB 查询服务实现在 tmdb.js它并不简单地取搜索结果的第一个而是用打分算法选出最匹配的一项 片名完全一致10 分 年份一致5 分 剧集连载状态匹配在播且集数吻合 / 已完结且集数接近5 分❌ 已有集数超过总集数-3 分。这套机制能有效区分同名不同年的作品比如新旧版《画江湖》。如果你的文件名非常混乱例如没有规范的S01E01格式系统还支持AI 辅助刮削调用智谱 AI、OpenAI 等兼容平台识别目录内容再反查 TMDB相关实现见 ScrapeService.js。七、NFO 文件与海报自动落盘匹配成功后ScrapeService 会自动生成标准 XML 格式的 NFO 并下载海报目录结构如下影视剧/电视剧/北上(2025)/ ├── tvshow.nfo # 剧集信息简介、演职员、TMDB ID ├── poster.jpg # 剧集海报 ├── clearlogo.png # 剧集 Logo ├── Season 01-poster.jpg # 季海报 └── Season 01/ ├── S01E01.strm # 播放指针 ├── S01E01.nfo # 单集信息集名、播出日期 └── S01E01-thumb.jpg # 剧集海报剧照电影则是更简单的三件套片名.nfoposter.jpgclearlogo.png。刮削器还会做幂等检查——已存在的文件自动跳过任务重复执行也不会浪费 API 请求。想确认刮削是否成功打开系统日志查看即可每一步都有清晰记录八、Emby 媒体库自动刷新通知最后一步让 Emby 知道有新内容了。在媒体页填入 Emby 服务器地址和 API Key 即可转存完成后系统自动触发刷新通知逻辑见 emby.js。 小细节如果 Emby 媒体库路径与云盘路径不一致可以通过路径替换规则做映射系统会逐级向上查找最匹配的目录找不到时自动降级为全库扫描非常省心。九、常见问题排查清单现象排查方向没有生成 NFO 文件确认媒体页已开启 STRM 生成与刮削开关并已配置 TMDB API KeyTMDB 匹配到了错误的影片补全任务的总集数手动重命名文件为规范格式海报 / 图片下载失败开启 TMDB 代理选项proxyTmdbSTRM 文件找不到检查部署时是否挂载了 strm 目录访问前缀是否配置正确文件被当成非媒体文件跳过到系统设置中检查媒体文件后缀配置写在最后从一条分享链接到一部带海报、带简介的媒体库条目cloud189-auto-save 把转存、STRM 生成、TMDB 刮削、NFO 写入、Emby 通知整条链路全部自动化。对于想自建追剧媒体库的新手来说这套 TMDB 刮削 NFO 生成方案几乎零门槛值得一试 核心源码索引TMDB 查询服务tmdb.js刮削与 NFO 生成ScrapeService.jsSTRM 文件服务strm.jsEmby 通知emby.js【免费下载链接】cloud189-auto-save天翼云盘自动转存系统支持自动监控更新并转存文件。项目地址: https://gitcode.com/gh_mirrors/cl/cloud189-auto-save创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考