mirror of
https://github.com/91270/MeiamSubtitles.git
synced 2026-02-02 10:09:00 +08:00
🎬 MeiamSubtitles
MeiamSubtitles 是一款专为 Emby 和 Jellyfin 媒体服务器打造的中文字幕下载插件。它集成了 迅雷影音 与 射手网 的强大搜索能力，支持精准的视频哈希（Hash）匹配，让您的媒体库自动补全高质量字幕。
📣 广告时间
搬瓦工 $99 年付：建站神器重出江湖，THE PLAN V1 传家宝套餐，18机房随意切换。
循环优惠码：BWHCCNCXVV(6.77%)
直达通道 (传家宝套餐)
✨ 核心特性
- 🚀 精准匹配: 支持迅雷看看 (CID) 和射手网 (Hash) 双重校验逻辑，确保字幕与视频内容完美同步。
- ⚡ 极致性能: 核心采样算法全面采用异步 I/O (Async/Await) 模式，在大规模媒体库扫描时不会阻塞服务器线程。
- 🌐 广泛兼容: 深度适配 Jellyfin 10.11+ 及 Emby v4.9+，支持
zho、chi等多种国际化语言代码映射。 - 🛡️ 稳定可靠: 针对射手网 API 的老化问题增加了防御性校验，能有效处理乱码返回，保证系统长效稳定。
- 📝 详尽日志: 记录哈希计算耗时与接口原始响应，让问题排查不再是黑盒。
📦 项目组件说明
| 组件名称 | 适用平台 | 目标框架 | 说明 |
|---|---|---|---|
| Emby.MeiamSub.Thunder | Emby | .NET Standard 2.1 | 迅雷看看字幕插件 |
| Emby.MeiamSub.Shooter | Emby | .NET Standard 2.1 | 射手影音字幕插件 |
| Jellyfin.MeiamSub.Thunder | Jellyfin | .NET 9.0 | 迅雷看看字幕插件 (现代 DI 架构) |
| Jellyfin.MeiamSub.Shooter | Jellyfin | .NET 9.0 | 射手影音字幕插件 (现代 DI 架构) |
| Emby.MeiamSub.DevTool | 开发调试 | .NET 8.0 | 哈希算法测试与 API 模拟工具 |
🚀 快速安装
第一步：获取插件
前往 GitHub Releases 下载最新版本的发布包。
🔔 推荐建议：在媒体库设置中不勾选本插件作为默认自动下载器。建议仅在手动“搜索字幕”时使用，以获得更精准的人工筛选体验。
第二步：部署插件
🔹 方式 A：Jellyfin 存储库安装 (强烈推荐)
Jellyfin 用户可直接添加官方存储库，实现一键安装与自动更新：
- 控制台 -> 插件 -> 存储库 -> 点击“添加”。
- 输入名称
MeiamSub和 URL：
https://github.com/91270/MeiamSubtitles.Release/raw/main/Plugin/manifest-stable.json - 在“目录”中找到插件并安装，重启服务即可。
🔹 方式 B：手动安装 (Emby/通用)
将下载的 .dll 文件（Jellyfin 用户请下载 .zip 并解压完整目录）放入服务器的 plugins 文件夹：
- Windows:
AppData\Local\jellyfin\plugins或Emby-Server\programdata\plugins - Linux/Docker:
/config/plugins或/var/lib/emby/plugins - 群晖/威联通: 对应套件安装目录下的
plugins文件夹
❓ 常见问题排查 (FAQ)
1. 为什么在 Jellyfin 10.11+ 中搜不到字幕？
新版 Jellyfin 采用了三位字母的语言代码（如zho）。请确保您已升级至本插件的 v1.0.13.0 或更高版本，该版本已完美解决语言映射兼容性。
2. 为什么射手网有时候返回结果为空？
由于射手网 API 维护状态不佳，对于部分冷门资源或 Hash 不匹配的文件，API 可能会返回非法数据。插件目前已增加防御逻辑，会自动忽略这些无效返回以保护服务器稳定。3. 安装本插件后会影响 Open Subtitles 吗？
不会。本插件已将优先级 (Order) 调整为 100（低优先级），并在代码层面优化了并发逻辑，确保官方插件能优先获取请求机会。4. 如何提供有效的错误反馈？
如果确定有字幕但搜不到，请在 Issue 中提供日志里的Target 文件名、计算出的 FileHash 以及 ResponseBody 内容。
🤝 贡献与感谢
欢迎通过提交 Issue 或 Pull Request 来完善本项目。
- 开发守则: 遵循异步命名规范，所有修改请标注
修改人: Meiam。 - 致谢: 感谢 Emby.Subtitle.Subscene 提供的灵感与参考。
⭐️ 给个星星
如果你喜欢这个项目，请给一个 Star！这对我非常重要。
如果你有稳定的 Google Drive 团队盘资源可供媒体库插件测试，欢迎联系：91270#QQ.COM
Powered by Meiam