设置参考

设置页按功能分为六个子页：

• 存储与同步：115 目录、STRM 保存位置和同步任务；
• 媒体服务：TMDB、Emby 和播放设置；
• 命名与分类：媒体名称、目录和分类；
• 词表：识别别名、屏蔽词和发布组；
• 消息接入：Telegram 和企业微信；
• 系统配置：可选的系统 Token 和网络代理。

修改后点击“保存设置”。第一次使用时，建议先保留默认值，只用少量文件测试。

存储与同步

目录设置

设置	填写内容
STRM 播放入口	Emby 能访问的 QPlay 播放地址。通常填写 http://NAS地址:8099 或 HTTPS 域名。
STRM 保存目录	NAS 上保存 STRM 的目录，默认 /media。QPlay 和 Emby 需要使用同一份目录。
待整理网盘绝对路径	115 中放入待识别文件的目录。不使用自动整理时留空。
媒体库网盘绝对路径	115 中已经整理好的媒体目录，全量和增量同步都需要。
未识别网盘绝对路径	自动整理无法识别的文件存放目录；不使用自动整理时留空。
临时网盘绝对路径	播放临时副本使用的 115 目录。

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

同步和自动整理

• 增量同步：检查最近新增或变化的媒体，适合日常使用。
• 全量同步：重新检查整个媒体库，适合首次使用或发现媒体变化没有同步时使用。
• 自动整理：识别文件名称、移动文件并按规则重命名。需要同时填写待整理、媒体库和未识别目录。
• 定时任务：默认每 20 分钟运行日常维护；不需要时留空关闭。
• 复制播放保留时间：同时播放产生的临时副本保留时间，默认 60 分钟，可设置 1–10080 分钟。
• 子账号临时目录清理时间：需要定期清理子账号临时目录时设置，不需要时关闭。
• 最小视频大小：小于设置值的视频不会进入媒体库。
• 自动整理后删除空目录：只清理真正为空的目录。

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

文件类型

• 视频文件后缀决定哪些视频生成 STRM；
• 非媒体文件后缀用于保存图片、NFO 等伴随文件；
• 字幕文件后缀用于保存字幕文件。自动整理会把能与视频唯一配对的字幕按整理后的视频名称重命名，保留语言、特效或原名称标记，再移动到 115 视频目录并下载到对应 STRM 目录。字幕名可以使用完整视频名、剧名.S01E01.zh-cn.ass 或 S01E01.zh-cn.ass；仅写集号时，必须只有一个视频与该集号对应；
• 选择自定义后缀时，直接在对应列表中添加扩展名。

同名文件处理

• 跳过：保留媒体库中的文件，删除待整理目录中的重复文件。默认值，使用前请确认；
• 覆盖：用待整理文件替换媒体库中的同名文件；
• 保留最大体积：只保留体积更大的文件；
• 智能洗版：按页面中的规则比较清晰度、来源和版本。

媒体服务

• 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：只有使用反向代理并且需要显示真实客户端地址时才填写；普通用户留空。
• Emby 删除联动：需要时按Emby 删除联动配置；不使用时留空。

命名与分类

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

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

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

词表

• 精准识别词：每行填写一个别名和正式名称，例如 旧名称 => 新名称；
• 自动整理屏蔽词：每行填写一个不希望整理的关键词；
• 自定义发布组词：补充文件名中的发布组名称；
• 自定义占位符词：识别文件名中的来源或平台标记。

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

消息接入

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

系统配置

• 系统 Token：只有使用 Emby 删除联动等可选功能时才需要。填写或生成后必须保存。
• 系统代理：只有 NAS 无法直接访问 TMDB、Telegram 或授权服务时才启用。支持 HTTP 和 SOCKS5。

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