云映扫描目录规划：避免父目录与子目录重复纳入

一个 NAS 里既选电影总目录，又单独选里面某个子目录，可能让后续排查变得复杂；少选一层，又可能漏掉想看的内容。本篇先在应用之外画清目录范围，再到云映用少量样本验证。目标是知道哪份内容通过哪个扫描入口进入媒体库，不假定所有来源会用相同方式自动去重，也不靠重复扫描来猜遗漏位置。

先画出真正的目录关系

选择一份小型测试目录，记录根目录、两层子目录和其中几段自己的视频。可以用普通文本缩进表达，不必制作复杂图表。每个样本写明完整位置、文件名与用途，特别区分一个真实文件、一个复制副本和一个不同剪辑版，名称相同并不能说明它们是同一个数据对象。

在服务器或文件工具中确认目录当前存在，账号能进入，视频也能实际打开。原来保存的旧路径可能已失效，不能仅凭云映显示的来源名称判断它仍指向预期位置。先把源数据关系弄清，再选择扫描范围，可以避免把目录权限或文件移动问题当成扫描器漏识别。

若整棵目录都需要，优先用清楚的上层入口覆盖；若只需要几个分支，就分别记录选择的分支，不把不相干的总目录也同时加入。具体选择和递归处理以当前来源界面为准，不承诺所有协议、目录层级和符号链接都采用相同规则。第一次只覆盖样本，确认后再扩大。

把个人录像、电影和待整理素材分开，是自己的文件管理策略，不表示应用一定会自动生成对应分类。扫描选择表达访问范围，媒体类型与匹配结果另行核对。不要为了一次测试批量移动正式原件，也不在 Calibre 等其他软件管理的目录里随意重排；测试目录独立，后续才能安全回退。

完成一轮扫描后，按样本列表查每个条目，核对名称、来源、时长和一处画面。任务结束提示不能证明所有预期文件都已进入当前可见范围，也不能证明正文可播。找不到时先清除搜索与分类条件，再进入实际来源检查，不立刻把整棵目录重新加入第二次，希望数量自己变对。

统计卡片数时注意剧集聚合和多个版本的显示关系，文件数不一定与首页卡片数一一对应。检查的是每个样本有明确去向，而不是强迫两个数字相同。若一个条目内有多个可选项目，逐一辨认实际播放内容；相同海报和标题会让不同路径看起来一样，必须保留文件层证据。

发现两张相似卡片，先写出它们的来源与实际路径，再打开固定场景。可能是父子范围重合，也可能本来就存在两个复制文件或两个版本，不应仅凭相似名称删除。当前来源若能明确调整扫描选择，先记下原配置，再用小范围变化验证，不预设调整目录会自动安全移除所有旧条目。

不要为了测试去重直接删除本地录像，应用中的移除可能涉及真实文件。保留样本原件，选择明确可丢弃的副本观察当前提示和结果即可。若不清楚某项操作影响的是索引、扫描设置还是内容文件，先停止这项清理，保留路径记录；让重复暂时可见，比误删唯一内容更容易继续处理。

先核对目标子目录是否在计划范围，再检查当前账号是否可读、文件扩展名和实际内容是否适合当前导入路径。目录里存在字幕或预览图，不应把它们算作缺失视频。样本在另一工具正常，而当前目录完全不可见时，重点是访问与范围；目录可见但某个文件不能播，则另查格式和完整性。

必要时单独选择一个更小的子目录做对照，记录改变前后差异。一次只改变扫描范围，不同时改文件名、权限和视频编码，否则结果难解释。大目录可能需要更久，但等待时间不是完整性的证据，最终仍要回清单查首、中、末几个位置，确认每个计划分支都有实际内容参照。

最后留下来源名称、根路径、选中分支、样本文件及检查结果。后续新增目录时先补清单，再调整范围，这样发现卡片增加或减少时能解释原因。服务器搬家后也可沿这份方案核对新路径，不必凭记忆重新选择所有父子目录，更不需要把反复扫描次数当作维护完成的标准。

完成标准是计划内样本都能找到并播放，疑似重复能说明来源，未纳入内容有明确原因。没有逐个验收的大库部分写清仍待抽查，不把五个样本成功扩大成几千个文件全已验证。扫描是建立访问索引的一步，真正清楚的范围与实际内容检查，才能让长期媒体库保持容易维护。