本文为梵想云官方帮助文档，适用于梵想云 NAS 影视墙元数据刮削功能。影视墙依赖 TMDB 数据库获取海报、简介、分类信息，文件 / 文件夹命名不规范是识别失败的首要原因，严格遵循下述规则，可实现稳定刮削匹配。
一、影视墙资源文件标准命名规则
1.电影文件命名规范
基础标准格式
影片中文名.上映年份.画质编码信息.后缀
英文名.中文名.上映年份.后缀
分隔符支持英文句号 .、下划线 _、短横线 -；优先推荐英文句号 .，识别稳定性最佳。
✅ 正确示例
1. 肖申克的救赎.1994.1080p.mkv
2. Inception. 盗梦空间.2010.Blu‑ray.mp4
3. 流浪地球 2.2023.4K.H265.mov
标准全字段拆解示例（官方通用模板）
示范文件名：变形金刚5：最后的骑士.Transformers.The.Last.Knight.2017.IMAX.BluRay.1080p.TrueHD.Atmos.7.1.x265.10bit-BeiTai.mkv
逐字段详细说明（严格适配TMDB刮削规则）
1. 变形金刚5：最后的骑士：影片标准中文片名，与TMDB官方收录片名完全一致，无删减、无错字，是匹配影片元数据的核心字段。
2. Transformers.The.Last.Knight：影片官方英文原名，多单词英文名称统一用英文句号 . 分隔，提升海外影片匹配精度，为可选优化字段。
3. 2017：影片正式上映年份，必须与TMDB数据库上映年份完全一致，是区分同名系列影片的关键必填字段。
4. IMAX：影片拍摄/放映制式标识，属于影片特色参数，不影响刮削识别，可按需保留。
5. BluRay：视频源画质类型（蓝光原盘），属于画质层级标注，为自定义辅助字段。
6. 1080p：视频分辨率参数，主流标准画质标识，兼容所有刮削规则。
7. TrueHD.Atmos.7.1：音频编码及声道参数（全景声7.1声道），音频参数不干扰影片识别，可自由保留。
8. x265.10bit：视频编码格式及色深参数，x265（H.265）编码、10bit色深，属于媒体编码信息，不影响TMDB数据匹配。
9. BeiTai：资源压制组标识，属于自定义后缀信息，位于文件名末尾，不影响影视墙自动刮削识别，可保留或删除。
该合规文件名核心优势：字段完整、格式规范，包含「标准中文名+英文原名+精准年份」核心识别三要素，所有分隔符均为英文句号，无违规特殊符号，可实现TMDB 100%自动精准匹配。
⚠️ 强制要求
1. 存在同名影片时，必须添加上映年份，年份需要与 TMDB 数据库上映年份完全一致；
2. 文件名尽量使用 TMDB 官方标准中文片名，不要出现错别字、随意删减文字；
3. 禁止纯数字、无意义命名，例如 001.mp4、电影1.mp4，缺少有效片名将无法匹配元数据；
4. 文件路径、文件名请勿使用中文特殊符号：【】、《》、#、& 等。
❌ 错误示例（不推荐）
1. 肖申克救赎.mp4（缺少年份、片名简写）
2. 盗梦空间超清完整版.mp4（无年份，容易匹配到重名影片）
3. 电影 1.mkv（无有效影视名称）
2.电视剧 / 剧集命名规范
推荐文件夹层级结构（识别稳定性最优）
电视剧库根目录/
剧集名称 (首播年份) Season 01/ ✔️剧集根文件夹，加年份，解决同名剧集混淆
剧名 - S01E01 - 分集标题.mkv
剧名 - S01E02.mkv
……
Season 02/
Season 00/ ✔️S00=剧场、OVA、花絮
示例：
权力的游戏(2011)Season 01
权利的游戏.S01E01.2011.1080P.mkv
权利的游戏.S01E02.2011.1080P.mkv
权利的游戏(2012)Season 02
权利的游戏.S02E01.2012.1080P.mkv
权利的游戏.S02E02.2012.1080P.mkv
单集文件标准格式
剧集名.SxxExx.年份(可选).画质.后缀
S 代表 Season（季），E 代表 Episode（集）；季、集序号必须使用两位数格式，如 S01E01，禁止 S1E1；
番外、剧场版特别篇统一使用 S00E01，S00 代表番外系列。
✅ 正确示例
1. 星际牛仔.S01E01.1998.mkv
2. 老友记.S03E05.1080p.WEB‑DL.mp4
3. 进击的巨人.S00E01. 剧场版.mkv
❌ 禁止错误格式
1. 第 1 集.mp4（缺少剧名、季数标识）
2. 狂飙 01.mkv（无 SxxExx 标记，无法自动归类剧集）
3. 三体第一季第一集.mp4（使用中文季集文字，TMDB 无法解析）
3.通用命名补充规则
1. 电影、电视剧建议分独立文件夹存放，不要混合放在同一个媒体库目录；
2. 系列合集电影：单独新建文件夹，使用统一片名 + 年份命名；
3. TMDB 数据库未收录的小众短片、独立影片，无法完成自动刮削，会归类至【其他】；
4. 中英文混合命名建议中文名称前置，可以显著提升国产影片匹配成功率。
二、影视墙常见问题与解决方法
问题 1：添加媒体文件夹后，首页无海报、封面空白，全部归入【其他】
可能原因
1. 文件命名不符合 TMDB 规范，缺失片名、年份、季集标识；
2. 媒体库首次扫描未执行完成，元数据缓存未加载；
3. 刮削首选语言设置为英文，国产影片匹配失败；
4. 网络无法正常访问 TMDB 数据源，元数据拉取超时。
解决步骤
1. 参照第一章命名规则，重命名视频文件；
2. 进入影视墙【设置‑媒体库管理】，点击【扫描媒体库】重新执行刮削；
3. 将刮削首选语言修改为中文；
4. 点击页面顶部【刷新】重载界面；
5. 检查网络环境，关闭防火墙、代理拦截，确保可以正常访问外网。
问题 2：影片识别错误，同名影片匹配错误版本、剧集季集错乱
可能原因
1. 文件名未填写上映年份，TMDB 默认返回搜索第一条结果，造成匹配错乱；
2. 剧集未采用SxxExx标准格式，季集信息解析失败；
3. 片名存在简写、错别字，与 TMDB 官方片名不一致。
解决方法
1. 文件补充准确上映年份，区分同名影视资源；
2. 剧集统一修改为SxxExx标准命名格式；
3. 前往 TMDB 官网查询影片标准中文名称，修正本地文件名；
4. 重新扫描媒体库更新元数据。
问题 3：媒体库扫描速度缓慢，长时间卡住无响应
可能原因
1. 媒体文件夹内文件数量庞大，一次性刮削系统负载过高；
2. 存在视频文件损坏，或是不支持的后缀格式；
3. 后台下载任务占用带宽，TMDB 接口请求排队。
解决方法
1. 将资源拆分多个文件夹，分批添加、分批扫描；
2. 移除损坏、无法正常播放的视频文件；
3. 暂停梵想云其他下载任务后，重新发起扫描；
4. 重启梵想云客户端，清空影视墙缓存后重试。
问题 4：配置自定义本地播放器后，播放按钮无响应，无法调用播放器
可能原因
1. 播放器程序路径填写错误，路径包含空格、中文特殊符号；
2. 播放器已卸载，或者安装路径发生变更；
3. 播放器配置修改后未保存参数。
解决方法
1. 打开【设置‑播放器设置】，重新选择播放器 exe 完整程序路径；
2. 参照页面内【配置教程】核对路径填写规范；
3. 保存配置后刷新重启影视墙页面；
4. 切换为系统默认播放器测试播放，排查第三方播放器兼容性问题。
问题 5：媒体文件夹已经移除，影视墙依旧残留影片记录
可能原因
刮削缓存未同步更新，旧的元数据记录没有自动清理。
解决方法
1. 移除文件夹后执行【扫描媒体库】；
2. 点击首页【刷新】，系统自动清理失效文件记录；
3. 重启梵想云客户端，彻底清空本地缓存。
问题 6：TMDB 数据源刮削失败，提示接口超时
可能原因
1. DNS、防火墙拦截 TMDB 接口域名 https://api.themoviedb.org；
2. 自定义 API 密钥失效，密钥前后存在多余空格；
3. 客户端版本较低，刮削组件存在兼容性问题。
解决方法
1. 切换网络环境（手机热点 / 家用宽带），关闭防火墙重试；
2. 重新复制 API 密钥，清除首尾多余空格后保存；
3. 将梵想云客户端更新至最新版本；
4. 优先使用系统内置 TMDB 数据源，不使用第三方自定义源。
问题 7：部分老电影、小众短片无法识别，始终归类在【其他】
可能原因
TMDB 数据库暂无对应影片词条，没有可用元数据与封面资源。
解决方法
1. 前往 TMDB 官网手动创建影片词条，等待数据同步（约 24 小时）后重新刮削；
2. 将本地海报图片放到视频同目录，海报文件名与视频文件名保持一致；
3. 该类资源不支持自动分类，可在【其他】分类手动查找播放。
三、使用建议
1. 资源分类管理：电影、电视剧、短视频使用相互独立的媒体文件夹添加，降低刮削异常概率；
2. 命名前置处理：下载完成资源后，先按照 TMDB 规范完成重命名，再添加到梵想云媒体库；
3. 主动更新元数据：新增视频文件后，手动执行【扫描媒体库】+ 页面刷新，保证元数据及时更新；
4.刮削阶段网络优化：执行媒体扫描刮削时，关闭代理、加速器，避免阻断境外数据源访问；
5. 推荐本地播放器：PotPlayer、VLC，对各类视频编码格式兼容性更好。