【亲测免费】 **jellyfin-plugin-metashark 技术文档**

jellyfin-plugin-metashark 技术文档

---

安装指南

jellyfin-plugin-metashark 是一款专为Jellyfin设计的电影元数据插件，它能够通过整合豆瓣和TheMovieDb的数据，丰富用户的电影资料库。

步骤 1: 添加插件存储库

• 对于国内用户，推荐使用加速链接：国内加速地址
• 国际用户可直接访问：官方发布页面
• 若以上方法均受限，直接从项目Release页面下载插件包，并手动置于Jellyfin的插件目录。

步骤 2: 安装插件

• 在Jellyfin界面，导航至“插件”菜单，系统会自动识别新添加的存储库。
• 查找并安装“MetaShark”，确保其安装成功且处于激活状态。

使用说明

1. 确认激活: 安装后在控制台的插件列表验证 MetaShark 已激活。
2. 配置媒体库: 访问媒体库设置，将 MetaShark 设置为首选的元数据提供者。
3. 高级配置: 可根据网络状况调整从TheMovieDb获取数据的开关，以及启用防封禁功能保护豆瓣访问。
4. 图片显示: 遇到图片无法加载，配置正确的Jellyfin访问域名于插件设置中。

API使用文档

此插件目前没有直接对外公开的API接口供第三方调用。其功能主要通过Jellyfin的内部机制触发，当用户管理或更新媒体库时自动执行。若需定制化交互，可能需要深入了解Jellyfin的插件开发API。

项目构建与测试

对于开发者和希望自定义的用户：

1. 克隆仓库: 使用Git克隆项目到本地。
2. 环境准备: 确保已安装.NET Core SDK 8.0。
3. 构建插件:

   dotnet restore 
   dotnet publish --configuration=Release Jellyfin.Plugin.MetaShark/Jellyfin.Plugin.MetaShark.csproj
   

4. 测试插件:
   • 构建完成后，复制生成的dll文件到Jellyfin的data/plugins下的一个新文件夹内（如命名为metashark）。
   • 重启Jellyfin服务以加载新插件进行测试。

注意事项与故障排除

• 出现System.BadImageFormatException: Bad IL format.错误时，清理插件目录下的隐藏文件和meta.json再试。
• 本插件遵循开源精神分享，仅供学习交流，避免商业化应用。

通过遵循上述指南，您可以顺利集成并利用jellyfin-plugin-metashark来增强您的Jellyfin媒体服务器体验，让电影资料更加完整和丰富。