专为本地影音玩家打造的媒体库质检工具：EpisodeMetaValidator
随着 NAS 和 HTPC 的普及，越来越多的影音爱好者选择使用 Plex、Emby 或 Jellyfin 等软件搭建个人专属的媒体库。然而，在长期搜集、整理海量影视资源的过程中，我们经常会遇到一些“刮削遗留问题”——例如缺失的 .nfo 描述文件、未成功下载的封面海报，或者是由于文件转移操作不当留下的幽灵空目录。
对于有着“媒体库强迫症”的玩家来说，在成百上千的文件夹中手动排查这些残缺项无疑是一项浩大的工程。为了解决这一痛点，开源项目 EpisodeMetaValidator 提供了一个轻量且高效的自动化解决方案。
一、核心功能介绍
- 深度元数据质检：自动识别“电影”与“剧集”的不同规范，捕捉缺失的
.nfo或.jpg文件。 - 交互式 HTML 报告：扫描后生成现代化的修复看板，按优先级划分为“需要修复”、“忽略/异常”与“完美无瑕”。
- 智能过滤机制：内置过滤规则，自动忽略系统生成的缓存或回收站文件夹（如
@eaDir）。 - 跨平台图形界面：基于 CustomTkinter 打造，支持实时日志反馈与多任务进度管理。
二、UI 界面展示
主控面板与实时日志
自动生成的元数据校验报告
三、部署教程
EpisodeMetaValidator 提供了对普通用户和开发者都非常友好的运行方式：
- 开箱即用（推荐）：前往 GitHub 项目的 Releases 页面，下载打包好的压缩包，解压后双击
.exe文件即可直接运行，无需配置任何代码环境。 - 源码运行：如果你熟悉 Python，只需克隆仓库，在 Python 3.8+ 环境下安装
customtkinter依赖，即可通过python main.py启动这款质检仪。
(注：如果你的媒体库在 NAS 上，并通过 SMB 映射到本地电脑，请确保在 NAS 设置中开启允许软/硬链接的相关权限，以避免误报为空文件夹。)
结语
维护一个完美的本地媒体库是一件充满成就感的事情，而 EpisodeMetaValidator 则可以成为你在此过程中的得力助手。它将繁琐的排查工作自动化，并以最直观的方式呈现给你。
如果你也经常为媒体库的刮削完整度感到头疼，不妨尝试一下这款工具。
项目开源地址：ZhuMengMeng666/EpisodeMetaValidator (如果你觉得这款工具对你有帮助，欢迎前往 GitHub 为开发者点亮 Star 支持一下。)