内置插件

插件位于管理端“插件”页面，可以单独配置、手动运行或按页面提示设置定时运行。第一次使用删除或批量修改类插件前，先备份并用少量文件测试。

Emby 封面工坊

封面工坊从 Emby 媒体库生成横版封面，并写回 Emby 媒体库。

配置步骤

1. 在“设置 → 媒体服务”填写 Emby 地址和 API Key；
2. 打开“插件 → 封面工坊”；
3. 读取媒体库并选择需要更新的媒体库；
4. 选择版式、素材顺序和素材数量；
5. 点击“生成当前预览”确认效果；
6. 点击“写入已选媒体库”。

可选版式包括主题媒体墙、单图 1、单图 2、多图 1 和全屏模糊。素材数量可以设置为 3–9 张，默认 6 张。没有选择媒体库时，自动运行会更新全部可用媒体库。

需要定时更新时按页面提示设置运行时间；不需要时保持关闭。没有明确需求时使用默认字体和文字位置即可。

STRM 重定向

STRM 重定向用于批量修改 STRM 文件中的旧地址、域名或路径。

1. 打开“插件 → STRM 重定向”；
2. 填写旧字符串；
3. 填写新字符串；留空表示删除旧字符串；
4. 填写 STRM 文件夹，通常为 /media；
5. 先手动运行并检查少量文件；
6. 确认无误后再设置 Cron。

此插件只修改 STRM 内容，不修改文件名或其他文件。批量修改前请备份 media。

清理失效 STRM

清理失效 STRM 用于找出本地已经无法播放或在 115 中不存在的 STRM。

使用条件

• 已连接并启用 115 主账号；
• 已填写用于对比的 115 目录；未单独设置时会使用媒体库网盘绝对路径，两者都为空时默认 /qplay/媒体库；
• 本地 STRM 文件夹存在。

清理步骤

1. 打开“插件 → 清理失效 STRM”；
2. 填写本地 STRM 文件夹，通常为 /media；
3. 填写需要对比的 115 绝对路径，例如 /qplay/媒体库；
4. 点击“扫描失效文件”；
5. 查看结果并勾选需要删除的项目；
6. 点击“清理已选”并确认。

此插件只删除本地 STRM 和对应的 QPlay 记录，不会删除 115 文件。成功清理后，已配置 Emby 时会通过现有路径映射定位包含受影响目录的 Emby 媒体库并立即递归刷新，移除 Emby 中对应的无效媒体；路径无法转换、无法定位所属媒体库或定向刷新失败时会降级全量刷新。扫描后如果文件发生变化，请重新扫描。

多版本扫描清理

多版本扫描清理用于查看 Emby 中同一部电影或同一集剧集的多个版本，并清理不再需要的版本。

使用条件

• 已在“设置 → 媒体服务”填写 Emby 地址和管理员 API Key；
• 已连接并启用 115 主账号；
• Emby 中的 STRM 路径能通过现有路径或“Emby 路径映射”关联到 QPlay 媒体记录。

清理步骤

1. 打开“插件 → 多版本扫描清理”；
2. 点击“扫描 Emby”；
3. 按标题、版本名或媒体类型筛选结果；
4. 逐个勾选要删除的版本，或点击“选择智能清理项”；
5. 检查每组中标记为“智能保留”的版本；
6. 点击“清理已选”，核对数量后确认。

扫描只向 Emby 查询电影、单集和各版本的 STRM 路径，不扫描 115。除了 Emby 已合并显示的多版本，插件还会识别被 Emby 分成多个条目的版本：电影必须有相同的 TMDB/IMDb 标识并位于同一媒体目录，单集必须属于同一个 Emby 系列且季号、集号相同；不会只按同名归组。命中 QPlay 索引后，页面显示整理后的当前文件名，原始文件名只用于判断版本质量。页面优先允许用户手动选择：已命中 QPlay 索引的版本可以勾选；旧 STRM 即使没有索引，只要包含完整 QPlay 重定向身份，也可以作为手动候选。路径身份不完整、命中多条索引或不是 STRM 的版本不能勾选。

智能清理使用“设置 → 整理规则”中的智能洗版规则。只有同组全部版本都能安全管理、质量信息完整，且 QPlay 记录确认它们属于同一作品、同一剪辑版和相同季集范围，规则又能选出唯一最优版本时，页面才会提供智能清理项。IMAX、加长版等不同版别不会互相列为智能清理项，单集与多集合集也不会混选。质量相同、无法比较或作品信息不足时，需要手动核对后选择；没有智能建议不代表文件不可播放。

确认清理后，QPlay 会重新读取 Emby 版本集合，并确保每部电影或每一集至少保留一个版本。已索引版本会先检查保留版本的 115 文件仍然可用，再删除所选版本及其索引和无共享引用的本地 STRM。未索引版本会通过 pickcode 和完整云盘路径实时确认所选及保留文件，先保存可恢复的清理任务，再删除 115 文件；只有本地 STRM 位于 QPlay 输出目录、内容未变化且未被任何索引引用时才会删除。身份、路径或版本集合变化时操作会停止并要求重新扫描。

如果 115 文件删除失败，页面会显示具体原因，该项目不能直接再次提交，QPlay 也不会在后台自动重试这次多版本清理。请解决错误并重新扫描，确认当前保留版本后再操作。只有 115 文件已经删除、但本地记录或 STRM 收尾失败时，QPlay 才会自动重试本地清理，不会再次删除云盘文件。

定时清空文件夹

定时清空文件夹用于周期性删除 115 主账号中指定文件夹内的全部内容，同时保留所填文件夹本身。

1. 确认 115 主账号已连接并启用；
2. 打开“插件 → 定时清空文件夹”；
3. 每行填写一个 115 绝对路径，例如 /qplay/未识别；
4. 保存后点击“立即清空”，检查确认窗口中的全部路径，再用少量内容试运行；
5. 确认结果符合预期后填写五段 Cron，例如 0 4 * * * 表示每天 04:00 运行。

文件、子文件夹及其内容都会被删除。根目录 / 不能填写；重复路径会自动去重，嵌套填写的文件夹会分别保留。Cron 留空时不会自动运行，仍可手动清空。

运行冲突

同一时间只运行一个同步、整理或插件操作。当前任务结束后，再运行下一个操作。