使用指南

从这里开始

第一次打开 XFVerse，你会看到一座空白片库。最自然的开始方式，是先加入一个存放电影或电视剧的文件夹。

1. 打开右上角用户菜单，进入“扫描任务”。
2. 添加一个本地影片文件夹。
3. 开始扫描，等待影片出现在媒体库。
4. 打开任意影片详情，点击播放。

如果你的影片保存在 NAS 或网盘中，可以稍后连接 WebDAV。影片资料、在线字幕和个性化推荐也可以按需开启，不必在第一次使用时全部配置。需要准备网盘 WebDAV 或 API Key 时，可直接查看 连接与 API 配置。

认识主界面

首页

首页汇集继续观看、最近添加、片库概览和推荐预览，适合每天打开软件后的第一站。

媒体库

所有已加入的电影、电视剧和其他视频都在这里。你可以搜索、筛选、排序，并在海报与列表视图之间切换。

影片发现

浏览热门、高分和趋势影片，搜索感兴趣的内容，也可以把尚未收藏的电影加入“想看”。

收藏、历史与洞察

收藏夹集中展示“喜欢”和“想看”；观影历史记录实际播放过的内容；观影洞察帮助你回顾电影偏好与观看节奏。

用户菜单

扫描任务、个人资料和设置都从这里进入。个人资料保存在这台电脑上，不需要注册云端账户。

建立本地片库

添加影片文件夹

1. 进入“扫描任务”，选择本地来源。
2. 点击添加文件夹，选择影片所在目录。
3. 确认路径已启用，然后开始扫描。

可以添加多个文件夹，例如把电影、电视剧和动画分别存放。XFVerse 会直接读取原位置，不会把视频复制到安装目录。

更容易识别的命名方式

清晰的文件名能让海报、年份和剧集信息更准确。推荐采用以下形式：

电影：Inception (2010).mkv
电视剧：Breaking Bad S01E01.mkv
目录：Breaking Bad / Season 01 / Breaking Bad S01E01.mkv

电影最好保留年份；电视剧文件名中建议包含 S01E01 这类季集编号。

管理文件夹

停用文件夹可以暂时跳过扫描，删除来源则只移除 XFVerse 中的文件夹配置。你的原始影片始终留在原来的位置。

连接 WebDAV 片库

添加连接

1. 进入“设置”，找到 WebDAV。
2. 填写服务地址、用户名和密码。
3. 测试连接并保存。
4. 添加需要浏览的远程目录。
5. 回到“扫描任务”，开始 WebDAV 扫描。

连接完成后，远程影片会和本地影片一起出现在媒体库中。播放体验取决于网络速度、服务器响应和影片码率。

如果你的影片在网盘中，可以先用 AList 把网盘挂载成 WebDAV，再把 AList 的 WebDAV 地址填入 XFVerse。完整流程见 用 AList 把网盘变成 WebDAV。

日常使用建议

如果经常使用同一个远程片库，可以开启启动时扫描。网络不稳定时，也可以关闭自动扫描，等连接稳定后再手动更新。

扫描与整理影片

查看扫描进度

扫描页面会展示进度、已发现内容和需要留意的项目。扫描结束后，进入媒体库查看新增影片即可。

遇到没有海报或标题不对

先确认文件名是否包含正确的片名、年份或季集编号。仍不准确时，打开影片详情并使用“修正识别”，搜索正确的电影或剧集后确认。

电视剧集数不正确

检查文件名中的季号和集号，例如 S02E05。修正后重新扫描对应文件夹，或在详情页重新选择正确的剧集。

更新片库

加入新影片、调整文件名或让离线硬盘重新连接后，再扫描对应来源即可。无需每次扫描所有位置。

浏览与管理媒体库

搜索和筛选

使用搜索框按片名查找，也可以按电影、电视剧、来源、年代、观看状态和收藏状态组合筛选。找不到内容时，先清除部分筛选条件。

海报视图与列表视图

海报视图适合轻松浏览，列表视图更适合快速核对标题、年份和来源。切换视图不会改变片库内容。

批量整理

进入选择模式后，可以同时标记多部影片为已看或未看，也可以统一移出媒体库。操作前可先用筛选缩小范围。

移出媒体库与删除记录

移出媒体库适合暂时隐藏内容，收藏和观看状态会保留；删除记录会清除这部影片在 XFVerse 中的信息。两种操作都不会删除硬盘或 WebDAV 上的原始视频。

查看电影与电视剧

电影详情

详情页会展示海报、简介、类型、演员、评分和可用播放源。拥有多个版本时，可以选择其中一个播放，也可以设为默认来源。

电视剧与季

电视剧按季和集浏览。进入某一季后，可以查看集数、标题、时长和观看状态，也可以将整季标记为已看或未看。

一集接一集地观看

播放剧集时，可以切换上一集和下一集。再次打开同一集，XFVerse 会从上次保存的位置继续。

多个播放源

同一电影或剧集可以保留本地、WebDAV、不同清晰度或不同版本的多个来源。播放前可在详情页选择最合适的一个。

使用播放器

开始播放

你可以从首页的“继续观看”、媒体库、影片详情、剧集列表或观影历史进入播放器。

常用控制

音轨与播放源

有多语言音轨或多个影片版本时，可从播放器菜单直接切换。不同版本片长不一致时，续播位置可能需要稍作调整。

继续观看

正常关闭播放器后，当前进度会保存。下次从首页或详情页打开，即可继续观看。

字幕

内嵌字幕

视频文件自带的字幕会直接出现在字幕菜单中。切换播放源后，可用字幕也会随当前文件变化。

本地外挂字幕

把字幕放在视频附近，并使用相近的文件名，XFVerse 更容易找到它。例如：

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

在线字幕

在设置中配置 OpenSubtitles 后，可从播放器的字幕菜单搜索、下载并立即使用在线字幕。

寻找下一部影片

搜索与榜单

影片发现支持搜索电影和电视剧，也可以浏览热门、高分和趋势榜单。看到感兴趣的内容时，可以先加入“想看”。

让推荐更贴近你

随着“喜欢、想看、不想看、已看”和实际播放历史逐渐丰富，电影推荐会更有个人倾向。推荐理由可以帮助你快速判断是否适合今晚。

资料不等于片源

在发现页收藏的影片可能只有资料。等你以后把对应视频加入片库，它就可以进入正常的播放流程。

收藏与观影历史

四种常用状态

• 想看：留给以后准备观看的内容。
• 喜欢：收藏已经看过并愿意再次推荐的电影。
• 已看：记录观看完成的内容。
• 不想看：从个人推荐中减少这类选择。

收藏夹

收藏夹按“喜欢”和“想看”整理内容。取消收藏只会移除状态，不会影响片库和视频文件。

观影历史

历史页面可以按今天、本周、本月或指定日期浏览。点击一条记录，可以回到对应电影或剧集详情。

观影洞察

回顾自己的观看节奏

统计页可以查看观看时长、活跃日期、常看类型、时段和片长偏好，并从日历回到某一天的观影历史。

了解自己的电影偏好

配置 AI 服务后，画像分析会基于电影观看记录生成一份偏好总结。它更适合作为回顾和发现灵感，而不是给你贴上固定标签。

按你的习惯设置 XFVerse

外观与窗口

可以选择跟随系统、浅色或深色主题，并决定关闭主窗口时退出软件，还是继续留在系统托盘。

播放偏好

如果喜欢沉浸观看，可以开启播放后自动全屏。播放器中仍可随时用 F 或双击画面切换。

影片资料与字幕服务

TMDB 用于影片搜索、海报与简介；OMDb 可补充部分影片信息；OpenSubtitles 用于在线字幕。只配置自己需要的服务即可。获取和填写方式见 TMDB、OMDb 和 OpenSubtitles 配置教程。

AI 服务

AI 服务用于电影推荐、观影画像和部分识别辅助。保存服务地址、密钥和模型后，可以先测试连接，再进入相应功能。DeepSeek 示例配置见 大模型 API 教程。

缓存

海报和在线字幕会使用本地缓存。空间紧张时可以在设置中清理，之后需要的内容会按使用情况重新获取。

备份与迁移

什么时候备份

升级大版本、重装 Windows、切换电脑或准备整理大量数据前，建议先备份 XFVerse 的用户数据。

如何备份

1. 从主窗口和系统托盘完全退出 XFVerse。
2. 在文件资源管理器地址栏输入 %LOCALAPPDATA%\MediaLibrary。
3. 复制整个文件夹到安全的位置。

恢复到另一台电脑

安装相同或更新版本的 XFVerse，退出软件后再恢复完整数据文件夹。随后检查本地文件夹和 WebDAV 地址是否仍然可访问。

如果日常使用中遇到扫描、播放或连接问题，请前往 帮助与排障。