洗版功能指南

洗版用于把已经入库的媒体替换成更符合你偏好的版本。常见场景包括：把 1080p 换成 4K，把普通 HDR 换成杜比视界，把没有字幕的版本换成带中文字幕的版本，或者把带片头片尾广告的剧集换成纯净版。

它适合有明确收藏偏好的用户。如果你只是想“有片能看”，可以先不用配置洗版。

洗版会做什么

开启洗版后，ETK 会在新资源准备入库时，对比新旧版本：

• 新版本符合你的洗版优先级时，允许入库并替换旧版。
• 新版本不如旧版时，拦截入库，避免把好版本洗回差版本。
• 新版本命中排除规则时，直接拒绝入库。
• 替换旧版时，会尝试同步清理旧文件和旧共享记录。

洗版不是简单按文件名判断，而是尽量根据媒体信息判断，例如分辨率、编码、HDR、音轨、字幕、帧率、体积和发布组。

先配置优先级

进入 Web 控制台 -> 洗版优先级，按你的收藏偏好配置规则。

常用条件包括：

• 分辨率：例如 2160p 优先于 1080p。
• 编码：例如 HEVC、AV1、AVC。
• HDR 和杜比：例如 Dolby Vision、HDR10、SDR。
• 音轨语言：例如国语、粤语、英语、日语。
• 字幕语言：例如中字、双语字幕。
• 特效字幕：适合重视字幕观感的用户。
• 帧率：例如 23.976、24、25、60。
• 体积范围：避免过小或过大的版本。
• 发布组：优先或排除指定发布组。
• 纯净版：用于筛选去掉片头、片尾或广告的剧集版本。

规则顺序越靠前，优先级越高。建议先配置少量明确规则，确认效果正常后再逐步细化。

发布组条件

发布组条件使用 ETK 内置的发布组别名表识别文件名，例如 ADWeb 会归一为 观众，CHDWEB 会归一为 彩虹岛，HDSWEB 会归一为 天空。

在洗版优先级里配置发布组后，ETK 会把发布组也纳入新旧版本比较。这样 MP 认为优先级更高的发布组版本入库时，ETK 不会再因为分辨率、编码、音轨等条件同级而把它挡掉。

如果某些订阅源删除了发布组标识，建议不要把发布组设成唯一条件，而是和分辨率、编码、纯净版等条件一起使用，避免误拦正常资源。

纯净版判断

纯净版主要用于剧集，不用于电影。电影没有稳定的“去片头片尾广告”场景，强行判断容易误伤。

ETK 会优先读取本地数据库里的 TMDb 集时长；如果本地没有，再尝试从 TMDb 获取。然后用视频物理时长和 TMDb 集时长对比：

• 洗版按单集判断。
• 当前阈值是 90 秒：物理时长比 TMDb 集时长短 90 秒以上，才更可能被认为是纯净版。
• 短剧不参与纯净版判断，因为单集太短，片头片尾误差会被放大。
• 动漫不参与短剧和纯净版判断。

TMDb 的集时长通常按分钟记录，本身可能有 1 分钟左右误差。所以纯净版条件建议和其他条件一起使用，不要只靠它决定全部洗版结果。

分集洗版和整季洗版

剧集洗版有两种常见方式：

• 分集洗版：每一集单独判断，适合连载剧或陆续入库的资源。
• 整季洗版：整季资源一起处理，适合完整季包。

如果你通过智能追剧或共享资源入库，ETK 会尽量根据当前场景选择合适的洗版方式。批量刷新、全量刷新这类维护动作通常不应该触发大量创建分享或重复洗版。

排除规则

排除规则用于明确拒绝不想要的资源，例如：

• 排除低分辨率版本。
• 排除体积过小的压制版。
• 排除没有中文字幕的版本。
• 排除非纯净版或纯净版。
• 排除指定发布组。

排除规则的优先级很高。新资源只要命中排除条件，就不会继续按普通优先级入库。

推荐配置方式

如果你刚开始使用洗版，可以按这个顺序配置：

1. 先配置分辨率和 HDR/杜比偏好。
2. 再配置音轨和字幕偏好。
3. 有明确需求时再加纯净版、特效字幕、发布组。
4. 最后用排除规则兜底，避免低质量版本入库。

不要一开始就堆很多规则。规则越复杂，越需要你理解每个条件之间的优先级关系。

什么时候不会洗版

以下情况可能不会触发洗版：

• 没有启用洗版规则。
• 新资源缺少必要媒体信息，无法比较。
• 新资源不比旧版更好。
• 新资源命中排除规则。
• TMDb 信息缺失，导致纯净版等条件无法判断。
• 资源已经是当前规则下的最佳版本。

如果你觉得应该洗版但没有发生，可以先查看任务日志里的“洗版拦截”“洗版跳过”“洗版替换”记录。

使用建议

• 洗版规则先简单后复杂，避免把正常资源误拦截。
• 纯净版适合剧集，尤其是带固定片头片尾或广告的资源。
• 短剧不建议做纯净版判断。
• 如果你的家人更在意播放体验，可以把字幕、音轨、纯净版排在画质前面。
• 如果你更在意收藏质量，可以把分辨率、HDR/杜比、发布组排在前面。
• 洗版后发现旧版没有下架时，先执行一次共享资源维护任务。