MediaHelp智能重命名杂乱文件名如何自动规范化自定义模板实战【免费下载链接】MediaHelp网盘资源搜索订阅、网盘一键转存、定时任务自动转存、emby自动刷新全套流程方案落地项目地址: https://gitcode.com/gh_mirrors/me/MediaHelpMediaHelp 是一套「网盘资源搜索订阅 一键转存 定时任务自动转存 Emby 自动刷新」的全流程媒体库方案其中的智能重命名功能专门解决网盘里杂乱文件名1.mp4、第9期中.mp4、剧名01.mkv无法被 Emby/Plex 正确识别的问题。本文带你从零看懂MediaHelp 如何自动识别 10 多种混乱命名格式、批量规范化为剧名.S01E01.1080p.mkv这样的标准格式以及如何用自定义重命名模板打造完全属于自己的命名规则。为什么媒体库文件名必须规范化Emby、Plex 这类媒体服务器靠文件名来识别剧集、匹配海报和季集信息。文件名一旦混乱后果就是 剧集无法归集到同一部剧下海报墙变成一堆散片 集数错乱排序不对甚至缺集 电影被误判为剧集或反之MediaHelp 的典型工作流是在资源搜索里找到资源 → 一键转存或创建定时任务自动转存 → 智能重命名规范化文件名 → Emby 扫描刷新海报墙自动完整。MediaHelp智能重命名是如何工作的核心引擎位于 backend/utils/media_renamer.py由四大组件协作完成组件职责MediaAnalyzer媒体分析器识别 10 种杂乱命名格式提取标题/季数/集数/画质/来源ContextInferrer上下文推断器从目录名、文件名公共前缀、连续数字推断整批文件属于哪部剧MediaFormatter格式化器按命名风格简单/标准/中文/Emby 兼容生成新文件名CustomTemplateManager模板管理器管理预设模板与用户自定义模板持久化到配置文件杂乱文件名自动识别这些混乱格式都能救MediaAnalyzer内置了一组按优先级排列的正则模式见 media_renamer.py常见场景全部覆盖原始文件名识别能力1.mp4、01.mkv纯数字集数第1集.mp4、第一集.mp4中文数字/集数自动转换中文数字EP02.mp4、Episode3.mp4英文序号剧名01.mkv剧名数字混合格式show 24.02.22.第9期中.mp4综艺日期期数上中下show 2025.06.14纯享版.mp4综艺纯享版/花絮版等特殊版本剧名 - S01E11 - 第 11 集.mkv标准格式带中文描述还会校验集数一致性对标准文件名它还会进一步解析出年份、季集、画质480p/720p/1080p/2160p、来源WEB-DL/BluRay、编码H264/H265、音频、字幕、发布组等全部元信息为模板渲染提供充足变量。批量重命名整目录智能推断上下文最实用的能力是批量重命名当你把一个目录里几十集全部叫1.mp4~24.mp4的文件丢给它时ContextInferrer会自动完成三件事从目录名推断剧名与季数如目录叫剧名.2024.S01从文件列表的公共前缀推断剧名检测到连续数字后判定为电视剧缺失集数时自动用文件顺序补位最终整批文件一次性输出剧名.S01E01.mp4、剧名.S01E02.mp4……全部规范化。批量执行后还会自动推送重命名成功通知详见 api/smart_rename.py。自定义重命名模板实战内置风格simple简洁、standard标准、chinese中文、emby/plex兼容不满足你时就可以用自定义模板了。可用模板变量一览变量含义变量含义{title}标题{quality}画质1080p{season}季数{source}来源WEB-DL{episode}集数/期数{codec}编码H264{year}年份{group}发布组{extension}扩展名{base_episode}/{part_suffix}综艺原始期数/上中下标识支持{season:02d}这类数字格式化写法自动补零。完整变量说明见 media_renamer.py。3 个可直接抄作业的模板Emby 标准目录结构配合 Emby 的季文件夹规则最推荐{title}/Season {season:02d}/{title} S{season:02d}E{episode:02d}.{extension}中文习惯家人朋友翻库更友好{title}.第{season}季第{episode}集.{extension}细节流保留画质来源方便管理多版本{title}.S{season:02d}E{episode:02d}.{year}.{quality}.{source}.{extension}系统还内置了 17 个预设模板电影movie_imdb、综艺variety_date、动漫anime_simple等可在下拉框中直接选用定义位于 media_renamer.py。在哪里配置自定义模板方式一定时任务编辑器推荐。创建/编辑定时转存任务时在智能重命名配置中选择自定义模板输入模板内容还能点击变量快捷插入模板与风格随任务参数一起保存见 TaskEditor.vue。方式二模板接口/配置文件。通过/smart-rename/templates接口增删模板模板持久化保存在 config/custom_templates.yaml示例my_emby: template: {title}.S{season:02d}E{episode:02d}.{quality}.{extension} description: 我的Emby标准格式保存前系统会自动校验模板是否可格式化、文件名是否超长、是否含:|?*等非法字符防止生成脏文件名。完整工作流定时任务 智能重命名 Emby刷新把三块拼起来就是真正的全自动媒体库资源获取在资源搜索页搜索关键词并一键转存或直接在资源卡片上创建定时任务搜索与推荐入口见 资源搜索页创建定时任务填写分享链接、目标目录重命名风格选择自定义模板并粘贴你的模板自动执行到点后任务自动转存新文件并走智能重命名流水线is_exists双向比对原名重命名后名保证已转存的集不会重复下载详见 media_renamer.pyEmby 刷新媒体库目录扫描后规范化文件名被精准识别海报墙即刻补齐所有重命名操作都会记录历史可随时通过/smart-rename/history查看原文件名与新文件名的对应关系改错了心里也有底。常见问题Q纯数字文件名1.mp4的剧名从哪来优先从目录名推断其次从你自定义的任务名称/自定义标题注入上下文最后才用文件顺序兜底。建议在任务里填写准确的剧名。Q综艺的纯享版/花絮版会乱套集数吗不会。variety_date_special模式专门处理这类文件输出剧名.纯享版.mp4这类文件名而不强加期数。Q模板改错了会直接污染文件吗批量操作建议先走/smart-rename/preview/batch预览接口前 5 个文件的效果确认无误再执行。总结MediaHelp 的智能重命名把识别 → 推断 → 格式化三步封装成了开箱即用的能力内置 10 多种混乱格式的正则识别、目录级上下文推断、17 个预设模板加上自由组合变量的自定义模板让你转存进来的每一集都自动变成 Emby 喜欢的标准命名。配合定时任务与 Emby 自动刷新媒体库真正做到了无人值守、自动完整。【免费下载链接】MediaHelp网盘资源搜索订阅、网盘一键转存、定时任务自动转存、emby自动刷新全套流程方案落地项目地址: https://gitcode.com/gh_mirrors/me/MediaHelp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考