Home

MediaInfoKeeper Wiki

MediaInfoKeeper 是面向 Emby 最新正式版的增强插件，重点解决 .strm、媒体信息持久化、片头片尾、元数据回退、网络访问和 Web 体验增强这些常见痛点。

截至当前版本，MediaInfoKeeper 已覆盖 StrmAssistant 社区版公开列出的全部功能；差异主要集中在 PRO 独占能力。

安装

1. 从发布页下载 MediaInfoKeeper.dll： https://github.com/honue/MediaInfoKeeper/releases/latest
2. 放入 Emby 配置目录下的 plugins 目录。
3. 检查文件权限和所有者与同目录其他插件一致。
4. 重启 Emby，在插件页确认版本和配置项已加载。

注意：

1. 插件优先适配 Emby 最新正式版，建议 Emby 与插件都保持最新。
2. 默认配置已可直接使用；涉及代理、剧集组、通知接管、Web 补丁等进阶能力时，建议按侧边栏对应页面逐项启用。

快速开始

1. 先阅读 MediaInfo Keeper 和 计划任务，完成基础持久化配置。
2. 如果你有 .strm 剧集，再看 IntroSkip 和 右键菜单。
3. 如果你依赖中文刮削、剧集组、封面、缩略图或缺失剧集展示，再看 MetaData。
4. 如果你需要搜索、拼音排序、通知、弹幕、深度删除、代理或发现地址改写，再看 Enhance 和 NetWork。

功能分区

通用

• 计划任务：批量提取、恢复、刷新、扫描片头、扫描外挂字幕、重建搜索索引、更新插件。
• 右键菜单：详情页直接提取媒体信息、扫描片头、设置或清除片头片尾。
• 通知：收藏剧集更新和深度删除事件通知。
• 常见问题：安装、升级、搜索增强、片头扫描、JSON 恢复等排障入口。

媒体信息

• MediaInfo Keeper：视频与音乐的 MediaInfo 持久化、恢复、备份。
• 音乐现已支持 MediaInfo、封面、内嵌歌词一并持久化与恢复。
• MusicAlbum / MusicArtist / MusicGenre 入口也可自动展开到音频条目执行。

片头片尾

• IntroSkip：.strm 片头解锁、片头扫描、播放行为打标。
• 最近版本把“片头扫描并发”和“媒体信息提取并发”拆开，便于单独调优。
• 片头片尾打标支持后续补齐策略，并默认尊重 Emby 已经扫出的系统标记。

元数据与网络

• MetaData：TMDB/TVDB 中文回退、剧集组、原语言海报、.strm 封面和缩略图提取、缺失剧集增强。
• NetWork：代理、证书策略、TMDB 域名替换、自定义本地发现地址、禁用 UDP 应答。

体验增强

• Enhance：中文模糊/拼音搜索、拼音排序名、重建搜索索引、NFO 增强、人物过滤、Web 补丁、弹幕注入、深度删除、通知接管。
• GitHub：版本信息展示与更新辅助。
• Debug 版本额外提供 DebugMediaInfo 查询接口，用于查看条目当前的媒体流、JSON 路径和封面状态。

功能说明补充

• 音乐支持补齐：持久化 Audio 的媒体信息、封面、内嵌歌词，并统一写入 MediaSourceInfo。
• 社区版能力补齐：新增外挂字幕扫描、拼音排序名、缺失剧集增强，现已与 StrmAssistant 社区版能力对齐。
• 计划任务补强：新增独立的外挂字幕扫描任务，可按计划任务范围单独执行。
• 搜索增强升级：增强中文分词自适应、兼容 Emby 4.9 连接池，并新增计划任务 6.重建搜索索引。
• 片头片尾体验改进：扫描流程重构、独立并发控制、打标成功提示、章节更新持久化、支持右键清除片头片尾。
• 网络能力增强：支持自定义本地发现地址、统一改写 HTTP/UDP 发现地址，并可通过 BLOCKED 禁用 UDP 应答。
• Web 与 UI 增强：Dashboard 资源补丁收口、dd-danmaku 弹幕注入、演职人员隐藏偏好分组整理。

升级

1. 手工替换 MediaInfoKeeper.dll 后重启 Emby。
2. 或运行计划任务 0.更新插件，按日志提示重启生效。

升级建议：

• 若更新失败且日志含 GitHub 限流，可在 GitHub 页配置访问令牌。
• 若运行环境网络受限，优先在 NetWork 中配置代理后再更新。
• 若局域网发现地址不正确，可在 NetWork 中填写自定义地址；若只希望客户端走固定反代入口，可填写 BLOCKED 禁掉 UDP 应答。

卸载

如果启用了 增强搜索，卸载前必须先关闭该功能并保存，然后重启一次 Emby，再删除插件文件。不要直接在插件页卸载或手动删除 dll，否则可能导致数据库无法读写，并出现如下错误：

SQLitePCL.pretty.SQLiteException: Error: no such tokenizer: simple

如果已经出现上述错误，但仍希望继续使用本插件，可重新放回插件文件，进入插件配置页关闭 增强搜索，并再次保存配置恢复官方索引。

建议保留已导出的 *-mediainfo.json 作为恢复备份。