先确定你需要配置什么
XFVerse 的基础播放和本地片库不依赖第三方账号。下面这些配置是可选增强项，可以按需要逐个开启。
| 你想做什么 | 需要配置 | 在 XFVerse 中填写 |
|---|---|---|
| 浏览 NAS 或网盘影片 | WebDAV | 服务地址、用户名、密码 |
| 获取海报、简介、演员和榜单 | TMDB | Read Access Token，必要时再填 API Key |
| 补充 IMDb 评分等信息 | OMDb | API Key |
| 下载在线字幕 | OpenSubtitles | Endpoint、API Key、可选账号密码、默认语言 |
| 启用 AI 推荐、画像和辅助识别 | OpenAI 兼容大模型 API | Base URL、API Key、默认模型 |
建议顺序：先配置 WebDAV 或本地片库，确认能扫描和播放；再配置 TMDB；最后按需要配置 OpenSubtitles 和大模型 API。
用 AList 把网盘变成 WebDAV
AList 可以把多个网盘、对象存储或远程目录统一整理成一个 WebDAV 服务。XFVerse 只需要连接最终的 WebDAV 地址，不需要直接理解每个网盘的登录方式。
准备 AList
- 选择一台长期在线的设备运行 AList，例如 NAS、云服务器、家用小主机或一台常开的电脑。
- 按 AList 官方安装说明 ↗ 完成部署，并登录 AList 管理后台。
- 确认你已经为 AList 设置管理员密码，并能从浏览器打开 AList 首页。
把网盘挂载到 AList
- 进入 AList 管理后台，打开“存储”或“Storage”。
- 点击“添加”，选择你的网盘或存储驱动，例如阿里云盘、OneDrive、123 云盘、S3、WebDAV 或本地存储。不同驱动的填写项可以对照 AList 存储驱动说明 ↗。
- 填写挂载路径，例如
/Movies或/Media。这个路径会成为之后在 AList 中看到的目录。 - 按对应驱动的提示完成授权。不同网盘可能需要刷新令牌、客户端 ID、访问密钥或扫码登录。
- 保存后回到 AList 首页，确认能正常进入挂载目录并看到影片文件。
只要 AList 首页能浏览这些文件，下一步就可以把同一套目录提供给 XFVerse。
找到 AList 的 WebDAV 地址
AList 的 WebDAV 通常使用 /dav 路径。更多地址格式可参考 AList WebDAV 文档 ↗。假设你的 AList 地址是：
https://your-alist.example那么 WebDAV 地址通常填写为：
https://your-alist.example/dav用户名和密码使用你的 AList 账号。连接成功后，可以在 XFVerse 的 WebDAV 路径选择窗口中进入 /Movies、/Media 等挂载目录。
在 XFVerse 中连接
- 打开 XFVerse，进入“设置”。
- 找到 WebDAV 区域，填写 AList 的 WebDAV 地址。
- 填写 AList 用户名和密码。
- 点击“测试连接”。
- 连接成功后选择需要扫描的远程目录，再回到“扫描任务”开始 WebDAV 扫描。
如果你通过反向代理访问 AList，请确认代理允许 WebDAV 所需的请求方法，并支持大文件的 Range 读取。否则可能出现能浏览目录但播放卡顿或无法播放的情况。
配置大模型 API：以 DeepSeek 为例
XFVerse 使用 OpenAI 兼容接口。DeepSeek 是较容易上手的示例；如果你使用其他兼容服务，填写方式也类似。
获取 DeepSeek API Key
- 打开 DeepSeek API 文档 ↗，按文档入口进入开放平台并登录账号。
- 进入 API Keys 页面。
- 创建新的 API Key，并在页面显示时复制保存。
- 检查账户余额或计费设置，确保 API 请求可以正常使用。
在 XFVerse 中填写
| XFVerse 字段 | DeepSeek 示例 |
|---|---|
| Base URL | https://api.deepseek.com |
| API Key | 粘贴你刚创建的 DeepSeek API Key |
| 默认模型 | deepseek-chat |
保存后点击“测试大模型”。如果你使用高级路由配置，可以先把各功能的模型都填成同一个模型，确认测试通过后再细分。
大模型 API 会产生服务商侧费用。建议先用少量推荐、画像或识别任务测试效果，再决定是否长期启用。
获取并配置 TMDB
TMDB 用于影片搜索、海报、简介、演员、评分和榜单，是最建议优先配置的在线服务。
获取认证信息
- 打开 TMDB 开发者文档 ↗，注册或登录 TMDB。
- 进入账号设置中的 API 页面。
- 按页面提示申请开发者 API 使用权限。
- 复制 Read Access Token。如果页面也提供 API Key，可以一并保存备用。
在 XFVerse 中填写
- 进入“设置 → TMDB 配置”。
- 优先填写 Read Access Token。
- 如果你已有 API Key，也可以填入“API Key（可选）”。
- 保存后点击“测试连接”。
测试成功后，影片发现、手动修正识别、海报和简介获取会更稳定。
获取并配置 OMDb
OMDb 主要用于补充部分影片信息，尤其是 IMDb 相关评分字段。它不是基础播放所必需的服务。
获取 API Key
- 打开 OMDb API Key 页面 ↗。
- 选择可用套餐。日常个人使用可以先从免费方案开始。
- 填写邮箱并提交申请。
- 按邮件提示激活，然后复制 API Key。
在 XFVerse 中填写
- 进入“设置 → OMDb 配置”。
- 粘贴 OMDb API Key。
- 保存后点击“测试连接”。
获取并配置 OpenSubtitles
OpenSubtitles 用于播放器中的在线字幕搜索和下载。你可以只配置 API Key；如果需要账号相关能力，再填写用户名和密码。
获取 API Key
- 打开 OpenSubtitles API 文档 ↗，注册或登录 OpenSubtitles。
- 进入 API 或 Consumers 页面，创建一个新的 Consumer。
- 复制生成的 API Key。
在 XFVerse 中填写
| XFVerse 字段 | 填写建议 |
|---|---|
| Endpoint | https://api.opensubtitles.com/api/v1 |
| API Key | 粘贴 OpenSubtitles API Key |
| 用户名 / 密码 | 可选；不需要登录时可以留空 |
| 默认语言 | 中文用户建议选择 zh-cn |
保存后点击测试。测试通过后，打开播放器的字幕菜单，就可以进入在线字幕搜索。
配置后如何判断是否成功
- WebDAV：测试连接成功，并且能在路径选择窗口看到远程目录。
- TMDB：测试连接成功；发现页、修正识别和海报加载可用。
- OMDb：测试连接成功；部分详情页可以补充 IMDb 相关评分。
- OpenSubtitles：测试通过；播放器中可以打开在线字幕搜索。
- 大模型：测试大模型通过；AI 推荐、观影画像或辅助识别可以正常返回结果。
如果某项服务暂时不可用，不会影响本地片库浏览和本地播放。可以先跳过它，等账号、网络或额度恢复后再测试。
密钥安全建议
- 不要把 API Key、WebDAV 密码或 AList 管理员密码发给别人。
- 截图反馈问题前，先遮住服务地址、用户名、Token 和 API Key。
- 如果怀疑密钥泄露，到对应服务商后台删除或重新生成密钥。
- 不同服务尽量使用不同密码，不要把网盘密码直接当作公开分享密码。