外观
刮削与播放问题
症状一：扫描后媒体库是空的
| 检查 | 说明 |
|---|---|
| 应用有没有读取该目录的权限 | 最常见的原因，见媒体库创建 |
| 文件扩展名是否被支持 | 少见格式可能不被扫描 |
| 文件是否完整 | 下载中的文件、只有一半的文件不会被识别 |
| 目录层级是否过深 | 尝试把样片放到较浅的目录测试 |
排查方法：新建一个测试媒体库，只放一部命名规范的影片，看能否识别。用最小样本定位问题，比在几千个文件里猜要快。
症状二：识别成了别的影片
根本原因通常是命名。修正顺序：
- 先确认命名规范：片名、年份、季集信息齐全，见媒体库创建。
- 单独修正这一部的匹配，不要重扫整个库。
- 如果目录里有旧的 NFO 或图片文件，它们可能被优先读取——先清理掉再重新识别。
- 动漫的绝对集数、特别篇、多版本影片最容易出错，需要按元数据库中实际的季集编排调整。
详细做法见修正影片识别与刮削。
症状三：改了名字但海报还是旧的
元数据和图片有缓存。处理顺序：
- 先对单个项目执行重新识别或刷新元数据。
- 检查目录里是否残留旧的 NFO 和图片文件。
- 客户端也有缓存，在播放端退出重进或清理缓存。
- 以上都不行时，把该项目从库中移除再重新扫描。
症状四：字幕不显示
按这个顺序确认：
- 字幕文件名是否与视频文件同名（扩展名不同）。
- 字幕格式是否被播放端支持。图形字幕（如蓝光原盘中的 PGS）在某些客户端上需要转码才能显示。
- 播放器里是否选中了字幕轨——很多时候只是没选。
- 编码问题：中文字幕乱码通常是编码不是 UTF-8。
详见字幕加载。
症状五：播放卡顿
先判断是直接播放还是转码。多数卡顿的真实原因是播放设备不支持原片格式，触发了软件转码。
| 现象 | 倾向于 |
|---|---|
| 播放时 NAS 的 CPU 占用飙到很高 | 正在软件转码 |
| CPU 占用很低但画面卡顿 | 网络或硬盘瓶颈 |
| 只有某些影片卡 | 那些影片的格式不被播放端支持 |
| 所有影片都卡 | 网络或硬件加速未生效 |
对应的处理：
- 换一个支持直接播放的播放端（这通常是最有效的一招）。
- 确认硬件加速已开启且真的生效，见转码。
- 走有线网络测试，排除 Wi-Fi 波动。
- 检查硬盘是否刚从休眠唤醒。
症状六：手机照片没有自动备份
- 检查手机系统是否限制了应用的后台运行和网络权限。
- 确认是否设置了仅在 Wi-Fi 下备份，而手机当前用的是流量。
- 检查 NAS 上目标目录的剩余空间。
- 打开应用停留在前台一段时间，看是否开始上传——能传说明是后台限制问题。
见手机照片备份。