Help & Support

帮助与排障

从你看到的现象出发，按顺序完成几项检查。大多数问题都可以在不影响片库和原始影片的情况下解决。

快速找到对应问题

你遇到的情况从哪里开始
双击后没有打开XFVerse 无法启动
重装后片库还在重装后保留了原有片库
添加文件夹后没有影片扫描不到影片
海报、片名或剧集不正确影片识别不准确
WebDAV 无法连接或播放WebDAV 使用问题
视频打不开、卡顿或没有声音播放问题
找不到字幕或字幕不匹配字幕问题
海报、榜单或推荐无法加载在线功能不可用
不知道 WebDAV 或 API Key 怎么获取连接与 API 配置

XFVerse 无法启动

先确认安装版本

打开 Windows“设置 → 系统 → 系统信息”，确认系统类型与安装包一致：Intel / AMD 电脑使用 x64，Windows on ARM 设备使用 ARM64。

重新安装

  1. 重新从 官网软件下载页下载安装包。
  2. 退出可能仍在后台运行的 XFVerse。
  3. 运行安装程序完成覆盖安装。

检查安全软件

如果安全软件拦截了 XFVerse 或播放器组件，请在隔离记录中查看原因，并确认安装包来自官网。当前安装包尚未数字签名，Windows 可能显示“未知发布者”。

重装后保留了原有片库

这是正常的。卸载 XFVerse 时，片库、收藏、观看进度和设置会保留，方便重新安装后继续使用。

想重新开始

  1. 完全退出 XFVerse。
  2. 在文件资源管理器地址栏输入 %LOCALAPPDATA%\MediaLibrary。
  3. 先把整个文件夹复制到其他位置作为备份。
  4. 将原文件夹重命名，例如改为 MediaLibrary-backup。
  5. 重新打开 XFVerse，即可从空白片库开始。

如果想恢复原来的片库，退出 XFVerse 后再把备份文件夹恢复为原名称。

扫描不到影片

确认文件夹位置

  • 在文件资源管理器中直接打开该文件夹，确认视频仍然存在。
  • 移动硬盘需要保持连接，网络磁盘需要处于在线状态。
  • 确认添加的是影片所在文件夹，而不是一个空的上级目录快捷方式。

重新扫描单个来源

进入“扫描任务”，只运行出现问题的文件夹。这样更容易看到具体进度，也无需等待整个片库重新扫描。

检查影片格式

建议先用常见的 MKV 或 MP4 文件确认扫描流程。如果文件仍在复制、下载或被其他软件占用，请等文件完整后再扫描。

影片识别不准确

优化文件名

电影建议使用“片名 + 年份”，电视剧建议包含季集编号：

Arrival (2016).mkv
The Bear S02E03.mkv

手动修正

打开对应影片详情，选择“修正识别”，搜索正确的电影、电视剧或剧集后确认。修正完成后，海报和资料会随之更新。

剧集顺序不对

重点检查 S01E01 这类季集编号。特别篇通常可以放在 Season 00 或 Specials 文件夹中。

WebDAV 使用问题

无法连接

  1. 在设置中重新检查服务地址、用户名和密码。
  2. 确认当前网络可以访问 WebDAV 服务。
  3. 使用其他 WebDAV 客户端打开同一路径，确认服务本身可用。
  4. 检查账号是否拥有浏览目录和读取文件的权限。

如果 WebDAV 来自 AList，请确认 AList 首页可以正常进入对应挂载目录，并参考 AList WebDAV 配置教程 检查地址格式。

可以浏览，但无法播放

先尝试播放一部码率较低的影片。如果小文件可以播放，大文件频繁缓冲，通常需要改善网络、服务器带宽或视频缓存条件。

播放中断

确认网络没有切换，NAS 没有进入休眠。重新打开影片后，XFVerse 会尝试从已保存的进度继续。

播放问题

影片无法打开

  • 确认文件没有被移动、重命名或删除。
  • 从详情页切换到另一个播放源。
  • 用一个常见的本地 MP4 文件确认播放器是否正常。

画面卡顿

高码率、4K 或 HEVC 影片对显卡和解码能力要求更高。可以尝试其他清晰度版本，或关闭占用显卡资源的程序。

没有声音

在播放器中切换音轨，并确认 Windows 当前输出设备和系统音量。部分影片包含多条音轨，默认音轨不一定是你需要的语言或声道。

续播位置不准确

同一影片的不同版本可能片长不同。切换播放源后，可以手动调整一次进度，之后会按当前来源继续记录。

字幕问题

本地字幕没有出现

把字幕放在视频附近，并让文件名尽量一致。例如：

Movie.Name.2024.mkv
Movie.Name.2024.zh-CN.srt

字幕不匹配

确认字幕对应相同的影片版本、季集和片长。不同发行版可能有片头或删减差异，需要更换字幕结果。

在线字幕搜索没有结果

确认已经在设置中启用 OpenSubtitles，并尝试简化搜索标题或切换语言。电视剧要特别确认季号和集号。

在线功能不可用

海报、简介或榜单没有加载

检查网络连接和 TMDB 设置。恢复连接后，可以重新打开页面或再次修正影片资料。首次配置可参考 TMDB 获取与配置。

AI 推荐或画像没有结果

确认 AI 服务地址、密钥和模型已经保存并通过连接测试。电影观看记录较少时，先积累一些“已看、喜欢、想看”状态，结果会更有参考价值。DeepSeek 示例见 大模型 API 配置。

在线字幕、影片资料和 AI 互不影响

这些服务可以分别配置。某一项暂时不可用时，仍然可以继续浏览本地片库和播放影片。

备份与恢复

创建备份

  1. 完全退出 XFVerse。
  2. 打开 %LOCALAPPDATA%\MediaLibrary。
  3. 复制整个文件夹到安全位置。

恢复备份

退出 XFVerse 后，用完整备份替换当前数据文件夹。重新打开后，检查片库、设置和媒体来源是否正常。

备份保存的是 XFVerse 的片库信息和设置；本地视频与 WebDAV 文件仍需要保持在原来的可访问位置。

仍然需要帮助

提交问题时，以下信息最有帮助：

  • XFVerse 版本和 x64 / ARM64 架构。
  • Windows 版本。
  • 从打开软件到出现问题的具体步骤。
  • 你期望看到什么，以及实际发生了什么。
  • 不包含密码、密钥和私人地址的错误截图或日志片段。

可以通过 GitHub Issues ↗ 提交问题。