问题：xiaoya刮削时如何正确配置NFO文件路径？

Question

在使用 Xiaoya 进行媒体文件刮削时，正确配置 NFO 文件路径是确保刮削器准确识别和匹配元数据的关键步骤。常见的问题是，用户未正确设置 NFO 文件的路径格式，或未遵循刮削器要求的命名规则，导致无法识别影片信息。要解决这个问题，首先应确认 NFO 文件与视频文件位于同一目录，并使用相同主文件名（如 `video.mp4` 对应 `video.nfo`）。其次，在 Xiaoya 的配置文件中，需指定正确的路径映射规则，确保刮削器能正确访问对应目录。此外，若使用远程路径，应确保路径格式为刮削器支持的协议（如 SMB、HTTP 等），并检查网络权限设置。通过规范路径结构和配置映射规则，可大幅提升刮削成功率。

Answer 1

一、NFO 文件路径配置在 Xiaoya 刮削流程中的核心作用

在使用 Xiaoya 进行媒体文件刮削的过程中，NFO 文件的路径配置是确保元数据正确识别与匹配的关键步骤。Xiaoya 作为一款基于 Jellyfin/Kodi 刮削逻辑的轻量级媒体索引工具，依赖于标准格式的 NFO 文件来提取影片信息。然而，由于路径配置不规范或命名规则不统一，很多用户在使用过程中会遇到影片信息无法识别的问题。

解决此类问题的第一步，是确保 NFO 文件与对应的媒体文件（如 MP4、MKV 等）处于同一目录，并采用相同的主文件名。例如，视频文件名为 video.mp4，则对应的 NFO 文件应为 video.nfo。这种命名方式是刮削器识别元数据的基础。

二、路径映射规则的配置与远程访问支持

除了文件命名规范外，Xiaoya 的配置文件中还需要设置正确的路径映射规则。这一规则决定了刮削器如何访问实际的媒体文件目录。例如，在 Docker 容器中运行 Xiaoya 时，宿主机与容器之间的路径映射必须准确无误。

以下是一个典型的路径映射配置示例：

media_dir = /mnt/media:/media

其中，/mnt/media 是宿主机上的物理路径，而 /media 是容器内的虚拟路径。通过这种方式，Xiaoya 能够正确访问到宿主机上的媒体文件。

如果媒体文件位于远程服务器，路径格式应使用刮削器支持的协议，如 SMB 或 HTTP。例如：

• smb://server/share/movie/movie.nfo
• http://192.168.1.100/media/movie/movie.nfo

在使用远程路径时，还需确保网络权限设置正确，避免因权限问题导致无法读取文件内容。

三、常见问题分析与排查流程

在实际使用中，用户常遇到以下几类问题：

1. NFO 文件与视频文件不在同一目录
2. 文件名不一致（如 movie.mp4 对应 film.nfo）
3. 路径映射配置错误
4. 远程路径未使用支持协议或权限未开放

为帮助用户快速定位问题，可参考以下流程图进行排查：

graph TD
            A[开始] --> B{NFO 文件是否存在？}
            B -- 否 --> C[创建 NFO 文件]
            B -- 是 --> D{是否与视频同目录？}
            D -- 否 --> E[移动 NFO 至对应目录]
            D -- 是 --> F{文件名是否一致？}
            F -- 否 --> G[重命名 NFO 文件]
            F -- 是 --> H{路径映射是否正确？}
            H -- 否 --> I[修改配置文件路径映射]
            H -- 是 --> J{是否远程路径？}
            J -- 否 --> K[完成]
            J -- 是 --> L{协议与权限是否正确？}
            L -- 否 --> M[调整协议或权限设置]
            L -- 是 --> K

四、配置建议与最佳实践

为提升刮削成功率，建议遵循以下最佳实践：

项目	建议
文件命名	视频与 NFO 文件主名一致
文件路径	保持在同一目录结构
路径映射	确保容器内外路径一致
远程访问	使用 SMB/HTTP 协议并检查权限

通过规范路径结构、统一命名规则以及正确配置映射规则，可以大幅提升 Xiaoya 在媒体文件刮削过程中的识别准确率。