主题
115 网盘集成
115 网盘是 Emby Toolkit 的核心功能模块，提供完整的媒体文件管理、自动化整理和播放直链服务。
功能概述
- 双模式认证：支持 OAuth 2.0 Token 和 Cookie 两种认证方式
- 智能整理：基于 TMDb 元数据的自动化文件分类
- STRM 生成：自动生成 STRM 文件
- 播放直链：高效的 302 重定向直链播放，适用于 ETK 标准 STRM
- 音乐库同步：独立的音乐库 STRM 生成和附属文件下载
- 历史记忆：自动记忆手动纠错结果，智能避免重复劳动
STRM 用户必须满足 Emby 媒体库前提
如果 Emby 媒体库直接监听 STRM 目录，全量同步 STRM 会让 Emby 收到大量文件变化并立即扫描。这些扫描不是 ETK 主动发送的，ETK 无法拦截。
正确做法：关闭 Emby 媒体库实时监控，开启 Emby 的 NFO 读取，让 ETK 生成完 STRM、NFO、海报和媒体信息后，再由 ETK 触发 Emby 扫描。
目录
认证登录
Emby Toolkit 支持两种 115 认证方式，您可以根据使用场景选择：
管理：登录授权
这是官方推荐的认证方式，支持完整的 API 操作权限。
- 进入 设置 → 115 网盘 页面
- 点击 登录授权 按钮
- 使用 账号密码登录获取授权
特点：
- 支持文件管理、目录创建、移动等所有操作
- Token 会自动续期，无需手动处理
- 适用于需要使用智能整理功能的用户
播放：Cookie 认证
如果您只需要播放直链功能，可以使用 Cookie 认证：
- 进入 设置 → 115 网盘 页面
- 点击 扫码获取 按钮
- 选择 APP 类型（默认支付宝小程序）
- 扫码确认后自动获取 Cookie
特点：
- 仅支持播放直链获取
- 无法使用文件管理功能
- 适合仅需要播放功能的用户
凭证状态检查
系统会在每次启动时自动检查凭证有效性：
- Token 有效：显示绿色状态，可使用所有功能
- Cookie 有效：显示黄色状态，仅支持播放
- 凭证无效：显示红色状态，需要重新登录
基础配置
在 设置 → 115 网盘 页面配置以下选项：
网盘目录设置
| 配置项 | 说明 |
|---|---|
| 待整理目录 | 115 网盘中用于存放待整理文件的目录 |
| 未识别目录 | 无法自动识别分类的文件存放目录 |
| 媒体库根目录 | 分类规则的根目录，用于计算相对路径 |
| 本地 STRM 根目录 | 本地生成 STRM 文件的根目录路径 |
API 设置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| API 请求间隔 | 两次 API 请求之间的等待时间（秒） | 0.5 |
| 最大并发线程数 | 整理任务的最大并发数 | 3 |
功能开关
| 配置项 | 说明 |
|---|---|
| 启用智能整理 | 是否启用自动整理功能 |
| 下载字幕文件 | 是否自动下载关联的字幕文件 |
| 启用本地清理 | 是否清理本地失效的 STRM 文件 |
| 联动删除网盘 | 是否在Emby删除媒体项时同步删除网盘文件 |
文件扩展名
配置允许整理的文件扩展名列表，格式为逗号分隔：
mp4,mkv,avi,ts,iso,rmvb,wmv,mov,m2ts,flv,mpg智能整理规则
智能整理是 Emby Toolkit 的核心功能，通过规则引擎实现自动化分类。
规则配置
在 115 设置 → 分类规则 页面创建整理规则：
1. 基本信息
- 规则名称：规则的显示名称
- 目录名称：网盘中的目标目录名
- 启用状态：是否启用该规则
2. 匹配条件
支持以下匹配条件，可多选组合：
| 条件类型 | 说明 |
|---|---|
| 类型 | 电影 / 剧集 / 全部 |
| 类型 (Genres) | TMDb 电影类型（如动作、喜剧） |
| 国家/地区 | 制作国家/地区 |
| 语言 | 原始语言 |
| 工作室 | 制作公司/发行公司 |
| 关键词 | TMDb 关键词 |
| 分级 | 影片分级（如 PG-13、R） |
| 年份范围 | 上映年份区间 |
| 时长范围 | 影片时长区间（分钟） |
| 最低评分 | TMDb 评分门槛 |
| 演员 | 包含指定演员 |
3. 匹配模式
- AND 模式：所有条件都满足才匹配
- OR 模式：满足任一条件即匹配
4. 追剧状态
针对剧集，可以设置：
- 追剧中：自动将正在追看的剧集移动到指定目录，完结后自动移动回常规分类目录
- 常规分类：将剧集按规则移动到对应分类目录
重命名配置
在 115 设置 → 重命名规则 页面配置：
主标题设置
- 标题语言：中文 / 原始语言
- 年份格式：带括号 / 不带年份
- TMDb 标识：格式如
{tmdb=12345}、[tmdbid=12345]
文件命名格式
支持灵活的命名组件组合：
title_zh - 中文标题
title_en - 原始标题
year - 年份 (2024)
year_pure - 纯年份 2024
tmdb_bracket - {tmdb=ID}
tmdb_square - [tmdbid=ID]
s_e - S01E01
season_name_en - Season 01
sep_dash_space - " - "
sep_middot_space - " · "
resolution - 分辨率 (2160p, 1080p)
codec - 编码 (HEVC, AVC)
audio - 音频 (Atmos, TrueHD)
group - 发布组媒体信息
ETK支持媒体信息中心化和媒体信息格式化
- 中心化采用中心服务器方式，人人为我我为人人
- 格式化则是完全按自己喜好（默认音轨/字幕）生成自定义的媒体信息文件
- 两者二选一，不可同时采用
STRM 链接格式
- 标准格式：
/api/p115/play/{pick_code} - 带文件名：
/api/p115/play/{pick_code}/{filename}
记忆功能
系统会自动记忆手动纠错的结果：
- 当您手动将文件移动到其他分类后，系统会记录该 TMDb ID 对应的分类
- 后续相同媒体将自动使用历史分类，无需重复手动操作
- 分季记忆：剧集的每一季都有独立的记忆
STRM 生成与同步
STRM 是方便刮削的软链接格式。
全量同步
执行 全量同步 STRM 任务：
- 遍历 115 网盘中的分类目录
- 获取所有视频文件和字幕文件
- 生成对应的 STRM 文件到本地目录
- 自动下载匹配的字幕文件（如果开启）
增量同步
在监控模式下，新上传的文件会自动：
- 识别媒体信息（TMDb ID、类型、标题）
- 按规则分类到对应目录
- 生成 STRM 文件
- 记录整理日志
本地清理
开启本地清理功能后，系统会：
- 对比网盘和本地的文件列表
- 删除本地已失效的 STRM 文件
- 清理无 STRM 的空目录
播放直链
Emby Toolkit 提供高效的 115 直链播放支持。
直链原理
客户端请求 → Emby Toolkit → 115 API 获取直链 → 302 重定向到 CDN技术特点
- 302 重定向：最小化服务器带宽消耗
- 内存缓存：相同文件避免重复请求 115 API
- UA 模拟：自动使用客户端真实 UA，避免 403 错误
- 流控保护：防止触发 115 API 流控
- CDN 加速：直链到 115 CDN 节点
- 小号播放池：可优先使用小号秒传临时文件并获取直链，降低主号播放压力
- 复制播放：同源并发播放时可复制临时克隆体播放，避免多个客户端抢同一个源文件直链
使用方式
- 确保配置了有效的 Cookie（播放必需）
- 默认支持CMS、MH、MP115strm
- 其他第三方可通过配置正则提取PC支持
小号播放池
小号播放池用于把播放压力从主号转移到 115 小号。
开启后，播放链路会优先判断当前 Emby 用户是否有可用小号：
- 命中可用小号时，ETK 会把源文件秒传到小号临时目录。
- 小号负责获取播放直链。
- 播放停止后，临时文件会按会话清理。
- 没有可用小号时，回退主账号播放。
配置入口：
text
设置 -> 115 网盘 -> 小号池小号池支持：
- 管理员统一添加小号。
- 用户提交自己的 115 播放凭据。
- 指定小号可用的 Emby 用户或用户组。
- 扫码获取 Cookie 或 OpenAPI 授权。
- 测速阈值：低于阈值的小号会自动停用。
- 单日流量上限：达到上限后当天不再使用该小号。
- 每日测速任务：自动刷新小号可用性。
小号播放依赖源文件的 SHA1、大小和 pick code。存量资源如果缺少这些信息，需要先通过目录缓存、整理记录或媒体库刷新补齐。
复制播放
复制播放用于解决同一个源文件被多个客户端同时播放时的冲突。
开启后，ETK 会记录正在播放的源文件。当检测到同一个 pick code 被不同用户、不同客户端或不同播放会话同时请求时，会把源文件复制到临时目录，再用克隆体获取直链播放。
配置入口：
text
设置 -> 115 网盘 -> 复制播放复制播放的行为：
- 单人单会话播放：继续直连源文件，不额外复制。
- 同源并发播放：复制临时克隆体，用克隆体播放。
- 克隆体失效：自动丢弃旧记录并尝试重建一次。
- 播放停止：标记临时克隆体延迟清理，避免刚停止又续播时重复复制。
复制播放、小号播放和虚拟播放共用临时目录。临时目录可在：
text
设置 -> 115 网盘 -> 临时目录设置如果小号池已启用且当前用户有可用小号，会优先走小号播放；如果小号池启用但当前用户没有可用小号，本次播放不会再触发复制播放，而是回退主账号播放。
常见问题
- 播放卡顿：检查网络到 115 CDN 的连接质量
- 403 错误：Cookie 可能已失效，需要重新扫码
- 无法播放：确认 STRM 直链格式正确
- 小号播放失败：检查小号 Cookie/OpenAPI 是否有效、测速是否达标、是否超过单日流量上限
- 复制播放没有触发：复制播放只在同源并发播放时触发，单人单会话播放不会复制
音乐库同步
独立的音乐库管理模块。
配置
- 设置 音乐库根目录 CID
- 和视频文件共享 STRM 根目录
- 开启/关闭附属文件下载
支持格式
- 音频：mp3, flac, wav, ape, m4a, aac, ogg, wma, alac
- 附属：lrc, jpg, jpeg, png, nfo, txt, cue
MP联动
- MP安装webhook插件，请求方式：POST，URL：http://ETK-IP:5257/webhook/emby
- 存储 & 目录 配置上传到待整理目录，切勿勾选分类、重命名、刮削。如果开启MP分类，则上传到媒体库并勾选分类、重命名。
- MP上传完成ETK自动接管归类以及生成STRM
影巢联动
- 影视探索页面配置影巢KEY
- 选择喜欢的影片点击小心心弹出获取方式选择影巢
- 选择心仪的资源点一键转存
- 稍等片刻即可在Emby观赏影片
功能
- 自动生成音乐 STRM 文件
- 自动下载歌词和封面图片
- 自动下载 CUE 曲目信息
- 本地失效文件清理
共享资源中心
共享资源中心依赖 115 能力完成秒传和转存。
你需要先保证：
- 115 登录状态正常。
- 本地媒体已经入库，并有 TMDb 信息。
- 视频文件能查到 SHA1、大小、pick code 等信息。
- 后台共享维护任务可以正常运行。
共享资源中心可以做两类事：
1. 使用别人共享的资源
在 共享资源 → 中心资源库 搜索电影或剧集。
- 有签名能力时，可以点 秒传。
- 有 115 分享时，可以点 转存。
- 电影详情页会展示多个资源版本。
- 剧集详情页按季展示资源。
2. 贡献自己的资源
你的本地资源可以登记到中心端。别人成功转存你的 115 分享资源时，你会获得贡献点。
执行 共享资源维护 可以同步分享状态、补齐元数据、清理失效资源。
更多说明见 共享资源中心。
任务说明
全量同步 STRM 前检查
执行 全量同步 STRM 前，请确认 Emby 媒体库实时监控已经关闭，并且已经开启 NFO 读取。否则 Emby 会直接监听 .strm 文件生成/覆盖过程，可能产生大量入库扫描，也可能无法按预期读取 ETK 生成的本地元数据。
后台任务
| 任务名称 | 说明 |
|---|---|
| 扫描待整理目录 | 扫描待整理目录，识别媒体并执行整理 |
| 全量同步 STRM | 遍历所有分类目录，生成/更新 STRM 文件 |
| 同步目录树缓存 | 将 115 目录结构同步到本地数据库 |
| 全量同步音乐库 | 同步音乐库 STRM 和附属文件 |
| 清理未识别目录 | 一键清空未识别目录的物理文件 |
任务链
系统使用任务链机制：
- 扫描识别：多线程并发识别媒体
- 批量整理：同一部剧的文件打包处理
- STRM 生成：自动生成对应 STRM
- 清理空目录：自动清理整理后的空目录
常见问题
Q: Token 和 Cookie 有什么区别？
Token：完整的 API 权限，可进行文件管理、整理操作 Cookie：仅支持播放直链获取，无法使用整理功能
Q: 整理失败怎么办？
- 检查 115 API 是否触发流控（等待后重试）
- 查看任务日志了解具体错误
- 手动将文件移动到正确目录，系统会记忆结果
Q: 如何查看整理历史？
在 整理 → 整理记录 页面查看：
- 整理成功/失败记录
- TMDb 匹配信息
- 目标分类路径
- 支持手动纠错
Q: 为什么不自动下载字幕？
- 确认已开启「下载字幕文件」开关
- 检查文件扩展名是否在允许列表
- 115 网盘中必须存在字幕文件