云映文件夹扫描：把文件源整理成可浏览的媒体库

文件源连接成功后，目录里的视频还需要被整理成媒体库条目，才能按卡片、标题和分类浏览。扫描是读取文件信息并建立记录，不等于复制全部视频到手机，也不等于每个文件都能自动匹配正确海报。本篇用一个小目录建立可核对的扫描流程，再逐步扩大范围。

先确认这次扫描的是文件源

本篇面向本地目录或 SMB、WebDAV 等文件源。Emby、Jellyfin、Plex 这类媒体服务器已经由服务器管理库，通常应先在服务器端整理，再由云映读取，不把两种流程混在一起。若还没有可访问的文件源，可先完成SMB 连接或WebDAV 连接。

准备一个目录，里面放三段文件：一段普通短片、两集属于同一系列的视频。记录实际文件数、名称和路径。为了首次核对，可以暂时避免多个相同名称的副本，也不把字幕、封面图片与视频数量混算。先在文件浏览中确认三段都能看到并至少播放一段，扫描不能修复本来不可读的目录。

在“来源”找到目标文件源，进入选择文件夹或扫描视频入口。若添加来源时已经出现目录选择，就直接勾选测试目录；若当时稍后处理，现在再回到来源操作中设置。不要同时勾选父目录和多个已经包含在其中的子目录，避免自己无法判断哪些范围实际被遍历。

选好后确认当前来源名称与目录路径，再启动扫描。首次范围越清楚，结果越容易比较。把整个 NAS 根目录作为起点，可能把备份、样片和历史副本都带进来，也会增加等待与重复判断成本。扫描范围应围绕想浏览的内容，而不是服务器能看到的所有东西。

部分界面提供快速扫描和完整扫描：快速方式面向常见媒体目录，完整方式遍历更广范围，耗时可能更长。具体选项以当前版本显示为准；如果目录命名不属于常见结构，不能因为快速扫描没有发现就认定视频格式不受支持。先回到明确的目录选择或更完整范围进行核对。

扫描过程中观察进度与结果提示，等待结束后再重复操作。不要同时从多个入口对同一来源连续发起扫描，最终很难分辨哪次结果对应哪次范围。大目录需要更久时，可以先结束本次练习范围的判断，再分批增加目录，而不是不断扩大任务后抱怨没有立即完成。

扫描结束后回媒体库，先选目标来源，再看“全部”分类。逐一找三段样本，比较名称、时长与实际内容。条目数不一定永远等于文件数：剧集可能按系列组织，某些文件也可能未被识别或被已有记录去重，因此需要进入系列或详情核对，不能只看首页卡片数量。

如果电影分类为空而全部里有条目，问题可能是分类或匹配，而不是扫描完全失败。个人短片也不应强行归为电影资料。先确认文件已经进入库且能打开，再处理标题和海报。命名方面可接着看电影匹配与年份以及剧集季度集数。

漏扫表示文件浏览里可见、媒体库里找不到；错误匹配表示条目存在但资料指向了别的作品；播放失败表示条目与资料可能都正常，打开视频时出问题。三种情况需要不同检查，不能统一用“再扫描一次”处理。先记下样本路径和当前表现，再决定下一步。

漏扫时检查扫描范围是否包含该目录、文件扩展名是否在当前流程支持范围、文件是否完整，以及是否被已有同路径记录合并。错误匹配时核对片名、年份和系列信息。播放失败则回文件浏览直接打开同一文件，再用本地副本比较，避免把网络读取问题误认为资料库没有收录。

给目录新增一段文件后，可以再按当前入口扫描，观察新条目是否加入。已经存在的文件或已有匹配信息，流程可能跳过或保留，不应假定每次扫描都会清空再建。修改文件名、移动目录或更换来源地址后，旧记录与新位置也需要实际核对，不能只看扫描完成提示。

不要为了重新识别海报就随意删除本地视频条目。删除确认可能同时删除应用内视频文件，和“刷新资料”不是一回事。重要原件先保留，任何清理都读清当前确认文案。服务器文件、应用本地副本与媒体记录之间的关系，必须在自己的来源类型下确认后再操作。

三段样本验证后，再加入一个电影目录或一季剧集。每批完成就核对来源、数量范围和几个代表条目，记录明显错误。目录里若同时有成片、剪辑工程导出和低清预览，可以先把需要观看的版本放在清楚范围，避免自动匹配把相似名称全部混在同一作品下。

文件组织尽量稳定，后续更新才容易追踪。这里不要求为了应用把整个存储重排，而是先选一个适合媒体库的范围。确认新范围正常后再逐步扩大，能降低一次大规模扫描后难以解释条目来源的情况。

扫描是不是把视频全部下载到设备？ 不能这样理解。网络文件源的扫描主要建立媒体信息与路径记录，实际播放仍可能依赖服务器和网络。离线可用需要有明确的本地文件或当前版本实际完成的下载流程，不能由“扫描成功”推断。

同一文件为什么没有新增第二张卡片？ 流程可能根据已有路径或记录去重，重复扫描本来就不应被当成复制文件的方法。若是两个不同内容却同名，先核对实际路径与文件，再调整命名；不要靠反复扫描制造更多难以区分的条目。

完成时应能从媒体库回到每个样本的正确内容，知道它属于哪个来源和目录，并能说明缺失条目究竟是范围、分类、匹配还是播放问题。这样的媒体库才方便后续扩大，而不只是卡片数量增加。

依据云映官方商店说明公开的媒体管理与自动匹配能力，以及现有目录选择、扫描入口整理，2026 年 10 月 23 日核对公开版本 1.1.0。扫描范围、去重和界面选项可能随版本变化；扫描后仍需核对匹配结果，媒体条目也不等于已经保存了离线文件。