设置参考

设置页顶部的分类栏包含以下子页。“词表”使用较频繁，是主菜单中的独立入口，不在这里：

• 设置首页：显示必需配置的完成进度，并列出还未完成的项目；
• 115 账号：主账号扫码登录、子账号和 Emby 用户绑定；
• 存储与同步：115 目录、STRM 保存位置和同步任务；
• 媒体服务：TMDB、Emby 和播放设置；
• 整理规则：媒体名称、目录和分类；
• 通知与消息：Telegram 和企业微信；
• 系统与安全：系统 Token、网络代理、工作台背景和透明度。

修改后点击“保存设置”。保存期间可以继续编辑，后来输入的内容会保留为未保存状态，需要再次点击保存。后台状态刷新暂时失败时，页面会提示并保留当前输入；登录或授权确实失效时仍需重新验证。第一次使用时，建议先保留默认值，只用少量文件测试。 Key、Token 和包含 Token 的 Webhook 地址默认隐藏；需要核对时，点击旁边的“显示”按钮。复制凭据时注意剪贴板中的内容。 遇到识别别名、屏蔽词或发布组问题时，从主菜单进入“词表”配置。

存储与同步

目录设置

设置	填写内容
STRM 播放入口	Emby 能访问的 QPlay 播放地址。通常填写 http://NAS地址:8099 或 HTTPS 域名。
STRM 保存目录	NAS 上保存 STRM 的目录，默认 /media。QPlay 和 Emby 需要使用同一份目录。
待整理网盘绝对路径	115 中放入待识别文件的目录。不使用自动整理时留空。
媒体库网盘绝对路径	115 中已经整理好的媒体目录，全量和增量同步都需要。
未识别网盘绝对路径	自动整理无法识别的文件存放目录，会保留文件在待整理目录中的文件夹层级，例如 待整理/某剧/Season 1/01.mkv 会放到 未识别/某剧/Season 1/01.mkv。其中的文件不会自动重试，目录也不会自动清理；可在整理记录页指定 TMDB ID 手动整理，或修改文件名、精准识别词后自行移回待整理目录。不使用自动整理时留空。
临时网盘绝对路径	播放临时副本使用的 115 目录。

后三个网盘目录填写 115 中的绝对路径，例如 /qplay/媒体库，不是 NAS 本地路径。

待整理、媒体库和未识别目录必须彼此独立，不能相同，也不能互相包含。例如，待整理设为 /qplay/待整理 时，未识别不能设为 /qplay/待整理/未识别。保存设置和启动任务时都会检查；已有重叠配置需要先改成独立目录，系统不会替你移动已有文件。

同步和自动整理

• 增量同步：检查最近新增或变化的媒体，适合日常使用。
• 全量同步：重新检查整个媒体库，适合首次使用或发现媒体变化没有同步时使用。
• 自动整理：识别文件名称、移动文件并按规则重命名。需要同时填写待整理、媒体库和未识别目录。
• 定时任务：默认每 20 分钟运行日常维护；不需要时留空关闭。
• 复制播放保留时间：同时播放产生的临时副本保留时间，默认 60 分钟，可设置 1–10080 分钟。
• 子账号临时目录清理时间：需要定期清理子账号临时目录时设置，不需要时关闭。
• 最小视频大小：小于设置值的视频不会进入媒体库；设为 0 可关闭大小过滤。
• 自动整理后删除空目录：只清理待整理目录中整理完成后的遗留文件和文件夹，不清理未识别目录。待整理目录中不再包含可整理视频或字幕的文件夹视为空目录，会连同其中剩余的图片、NFO 等文件一起删除。可整理是指符合视频或字幕后缀、视频达到最小体积，并且路径没有命中“自动整理屏蔽词”；还有这类文件的文件夹会保留。

文件在媒体库内移动到其他目录后，增量同步会在本地新目录生成对应 STRM，并清理没有其他引用的旧 STRM 和空目录。文件或整个目录移出媒体库后，对应媒体索引和本地 STRM 会被删除；如果移动到待整理目录，启用自动整理的定时任务会在增量同步后继续整理。增量同步和自动整理会合并本轮新增、更新、删除 STRM 的父目录，定位包含这些目录的 Emby 媒体库并立即递归刷新；成功后不再执行全量刷新。QPlay 与 Emby 挂载路径不同时，使用“Emby STRM 路径映射”把本地相对目录转换为 Emby 可见目录；路径无法转换、无法定位所属 Emby 媒体库或定向刷新失败时自动降级全量刷新，手动全量同步始终使用全量刷新。115 暂时无法返回事件文件详情时不会删除现有 STRM。

自动整理和洗版可能移动、重命名或删除 115 文件。首次使用前请先用测试文件确认结果。

文件类型

• 视频文件后缀决定哪些视频生成 STRM；
• 非媒体文件后缀用于保存媒体库中的图片、NFO 等伴随文件。自动整理只处理视频和字幕：待整理目录中的图片、NFO 和其他文件不会被整理，在所在影片目录已经没有待整理视频后会被删除（进入 115 回收站）；目录里还有视频没整理完时会先保留；
• 字幕文件后缀用于保存字幕文件。自动整理会把能与视频唯一配对的字幕按整理后的视频名称重命名，保留语言、特效或原名称标记，再移动到 115 视频目录并下载到对应 STRM 目录。字幕名可以使用完整视频名、剧名.S01E01.zh-cn.ass 或 S01E01.zh-cn.ass；仅写集号时，必须只有一个视频与该集号对应。放在影片目录下 Subs、Subtitles 或 字幕 子文件夹中的字幕，会和该影片目录里的视频配对。如果字幕所在影片目录里已经没有待整理的视频（例如视频未识别已移走），字幕会按原文件夹层级移到“未识别”目录，不再留在待整理目录；
• 选择自定义后缀时，直接在对应列表中添加扩展名。

字幕中明确标注的季号、集号必须与视频一致。如果同一目录只有部分剧集整理成功，其他集的字幕不会自动跟随成功的视频；请保留它们，待对应视频整理成功后再配对。

重复文件处理

重复文件处理提供四种模式：

• 仅保留最新版本：比较同一作品、同一剪辑版和相同季集范围的所有已索引版本，即使最终文件名不同也会比较；按 115 文件修改时间保留最新版本，时间相同时保留已有版本。
• 仅保留最大版本：候选范围与“仅保留最新版本”相同，按文件体积保留最大版本，体积相同时保留已有版本。
• 智能洗版：按洗版规则从上到下比较同一作品的版本，保留优先级最高版本。不同剪辑版、不同集数或单集与合集不会互相替换；质量相同或无法可靠比较时按下方设置处理。
• 多版本共存：最终文件名不同的版本全部保留；最终基础名相同（忽略大小写和扩展名）时，再选择“覆盖”“跳过”“保留最新”或“保留最大”。

多版本模式的同名处理方式：

• 同名跳过：保留媒体库中的已有文件，删除待整理目录中的新文件。
• 同名覆盖：保留待整理目录中的新文件，删除同名旧文件。
• 同名保留最新：按 115 文件修改时间保留同名版本，时间相同时保留已有文件。
• 同名保留最大：按体积保留同名版本，体积相同时保留已有文件。

同名处理只比较视频，不会把字幕、图片或 NFO 当成重复视频。“仅保留最新版本”“仅保留最大版本”和“智能洗版”要求作品身份明确；身份缺失或冲突时会保留文件，避免误删。

智能洗版可分别设置：

• 电影同级：默认保留两个版本，也可保留旧版并删除新文件。
• 剧集同级：默认保留旧版并删除新文件，也可保留两个版本。
• 质量未知：默认保留两个版本，也可将新文件留在待整理目录等待处理。未知不等于低质量，不会自动删除。

“导剪版关键词词表”用于区分普通版与导演剪辑版。系统只检查最终重命名后的文件名：最终名称命中“导剪版”“导演剪辑版”“Director's Cut”等词时，才把它作为导演剪辑版身份参与洗版。原始发布名命中但命名模板没有保留该词时，不会定义为导剪版。匹配到的原文可通过 customization 占位符显示；不同写法会统一为同一个导剪版身份。

质量来自文件名，不会读取视频内容。没有标注 HDR、码率档等信息时，QPlay 不会自行补成普通版本。规则中没有限制的字段不会参与优先级比较，例如默认规则不会仅因文件带有 HQ 或 REPACK 就判定它更好。

替换时先让保留版本和 STRM 就绪，再清理旧版本。删除失败会重试；如果文件已经移动、改变或替换关系失效，会暂停清理，避免继续执行旧的删除决定。

任务中断后，已移动但尚未确认或重命名的文件会在后续自动整理中继续核对。恢复时如果目标位置新出现了未经原任务确认的冲突文件，会停止该文件的收尾并保留冲突文件，不会为了完成恢复直接删除它。遇到这种情况，请先核对整理记录和目标目录。

媒体服务

• TMDB API Key：自动整理识别电影和剧集需要。页面提供注册和申请入口。
• Emby 地址：填写 QPlay 能访问的 Emby 地址。通常使用 NAS 局域网地址，例如 http://192.168.1.20:8096。不要填写 localhost。
• Emby API Key：在 Emby 管理后台创建后填写，用于读取媒体库和使用封面工坊。
• 115 直链缓存时长：默认 300 秒。播放正常时保持默认即可；播放失败时可以在“记录”页面清空直链缓存。
• STRM 播放入口：填写 Emby 实际使用的 QPlay 地址，通常为 8099。
• 视频文件名和完整路径编码：路径含空格、&、#、? 或 + 时开启，保存后重新运行全量同步。
• 可信反向代理 IP / CIDR：只有使用反向代理并且需要显示真实客户端地址时才填写；普通用户留空。
• OpenAPI 与 Emby 删除联动：需要第三方软件接入、健康检查或删除联动时，按 OpenAPI 配置；不使用删除联动时，路径映射可以留空。

整理规则

默认电影和剧集命名规则可以直接使用。点击页面顶部的“名称识别测试”按钮，输入一个实际文件名，确认识别出的标题、季集和目标路径。

“媒体分类”中的 category.yaml 同时管理一级目录和二级分类。“启用一级分类”关闭时保持原有二级分类路径；开启后可通过 primary_folders 自定义电影、剧集目录，并通过 primary_category_rules 按需增加动漫等一级分类。内置动漫示例默认保持注释，没有明确需求时保留默认规则。

完整 YAML 示例、匹配顺序、兼容行为和修改注意事项见命名与目录。

词表

• 精准识别词：每行填写一个别名和正式名称，例如 旧名称 => 新名称；
• 自定义发布组词：补充文件名中的发布组名称；
• 自定义占位符正则：识别文件名中的来源或平台标记；
• 导剪版关键词：区分导演剪辑版与普通版本；
• 自动整理屏蔽词：放在最后配置，每行填写一个不希望整理的关键词。

普通用户只需要配置确实遇到的别名或屏蔽词，不必一次填写大量规则。

通知与消息

Telegram 和企业微信可以远程执行同步、整理和状态查询。配置步骤见Telegram 与企业微信。

系统与安全

• 系统 Token：调用受保护的 OpenAPI 接口或使用 Emby 删除联动时需要。填写或生成后必须保存；健康检查不需要 Token。
• 系统代理：只有 NAS 无法直接访问 TMDB、Telegram 或授权服务时才启用。支持 HTTP 和 SOCKS5。

网络测试入口在右上角用户菜单中的“网络连通性测试”。普通用户不需要修改其他高级网络设置。