Drivemby 分类 YAML 怎么导入、导出和备份？示例与迁移边界

迁移或重新整理片库时，可以把支持的分类规则保存为 YAML 文件，再在 Drivemby 中预览和导入。它适合保存一份可读的规则，不等于完整恢复旧 Emby / Jellyfin 数据库，也不等于整个 Drivemby 片库备份。

本文按 2026 年 10 月 18 日核对的格式与导入行为整理。无论影视全在 NAS、全在网盘，还是分散在两边，都可以按作品配置分类；原文件不需要因此搬家。迁移整体准备见 保留原文件与并行试用指南。

先保存现状，再试一个小配置

在控制台的分类管理中，先选择「导出 YAML」，保留未修改的原文件，并保存导出时显示的警告。另行记录分类绑定了哪些来源目录、哪些封面是自己上传的，以及重要分类原来的顺序。

不要把重新导入旧 YAML 当作完整的一键回滚。导入会合并规则，不会因为旧文件里没有某个分类就自动删除它；目录绑定和上传封面等资料也不在文件里。已有重要分类时，先查看预览，确认自己能接受新增或更新的范围。

一个可以预览的 YAML 示例

下面按电影原始语言和剧集发行年份划分，并为两种媒体各留一个最后匹配的分类：

movie:
  华语电影:
    original_language: zh
  其他电影:
tv:
  2020至2026年剧集:
    release_year: "2020-2026"
  其他剧集:

movie 与 tv 是顶层；下一层是分类名称，再下一层才是条件。缩进使用空格。original_language: zh 表示按作品的原始语言匹配，不代表文件里一定有中文配音或中文字幕；release_year 表示作品年份，不是下载时间。

留空条件的「其他电影」「其他剧集」能匹配对应媒体类型，应该放在同类 YAML 规则的最后。这个示例只是规则格式，不保证你的作品都已有完整语言和年份信息，也不会替你创建文件夹、移动视频或恢复旧服务的分类。

支持哪些条件，顺序为什么重要？

语言、国家或类型条件中，同一字段多个值使用逗号分隔；排除值以 ! 开头时，建议把整个值写在引号内，例如 original_language: "zh,!en"。多项不同字段会共同约束匹配。不要直接加入分辨率、文件大小、match 表达式等未支持字段，出现不支持条件时应按预览错误调整。

同一媒体类型的 YAML 导入规则按顺序首个命中。 如果先放一个空条件分类，后面更具体的同类 YAML 规则就可能匹配不到。普通分类仍可能同时命中多个；已有指定目录的分类也会影响归类结果。因此，看到作品出现在不止一个分类时，不要直接认定 YAML 顺序失效，先检查普通分类和目录绑定。

从文件导入：先看新增与更新，再确认

1. 在分类管理选择「从文件导入」，选中 YAML 文件，检查载入的内容。也可以使用页面提供的模板作为起点。
2. 查看「预览导入」的结果，逐项核对分类名称、电影或剧集类型、条件，以及是新增还是更新。预览本身不会写入分类。
3. 如果修改了内容，再次预览；不能用修改前的预览代替当前内容的确认。
4. 确认结果符合预期后，再点「确认导入」。导入需要相应账号权益，分类数量等限制以控制台提示为准。
5. 导入后检查分类列表和已识别作品的实际归类，给分类重建留出处理时间。不要把导入请求成功当作所有作品已经完成重新归类。

名称相同不一定会更新原分类。系统识别已有的同媒体类型 YAML 导入分类时可以更新；若只是与普通分类重名，可能新增「（电影）」或「（剧集）」等后缀。看清预览，可以避免把新增误以为覆盖，也避免反复导入后才发现不符合预期。

导出和迁移时，哪些内容要另外保留？

更新已有 YAML 分类时，未在文件中指定封面，系统会保留它原来的封面；新建分类则使用默认封面。这不表示在另一个账号重新导入时，也能找回原来上传的图片。指定了 cover 时，还要确认替换封面符合自己的预期。

导出警告是迁移清单的一部分，不要只留下下载的文件而忽略警告。如果规则表现不符合预期，先核对预览、顺序、目录绑定和作品信息，保留旧配置与样本，再小范围调整。更多迁移数据边界见 迁移指南；日常维护见 媒体库维护清单。