1. 支持系统
当前版本先支持 Mac 上的 Jellyfin。其余平台正在适配中。
| 组件 | 要求 | 状态 |
|---|---|---|
| 系统 | macOS，Intel 或 Apple 芯片 | 支持 |
| Jellyfin | 10.11.x，以 Jellyfin.app 形式安装 | 支持 |
| 下载器 | 迅雷 Mac 版，最新版并已登录 | 支持 |
| 元数据 | TMDb API Key，免费申请 | 必需 |
| Jellyfin Docker 版 | NAS、Linux 服务器 | 规划中 |
| Emby | — | 规划中 |
| qBittorrent | — | 规划中 |
2. 下载安装
两种方式任选一种。推荐用插件存储库，以后有新版本时 Jellyfin 会自动提示升级。
方式一：通过插件存储库安装 推荐
- 打开 Jellyfin 网页，进入 控制台 → 插件 → 存储库，点 + 添加。名称填“萤火虫”，地址填：
https://firefly.raystudio.club/repo/manifest.json - 回到 插件 → 目录，找到 FireFly，点安装。
- 在 Mac 菜单栏的 Jellyfin 图标里选择退出，再重新打开 Jellyfin.app。
方式二：手动安装
- 下载 FireFly_0.2.0.0.zip。也可以从 GitHub Releases 下载同一个文件，国内访问通常较慢。
- 退出 Jellyfin.app。
- 把压缩包解压到下面这个文件夹（在访达里按 ⌘⇧G 粘贴路径即可前往）：
~/Library/Application Support/jellyfin/plugins/FireFly_0.2.0.0 - 重新打开 Jellyfin.app。
先退出再覆盖。Jellyfin 运行时直接替换插件文件，可能导致插件加载失败。
3. 配置
打开 控制台 → 插件 → FireFly。页面顶部的状态区全部变绿，就说明配置完成了。
3.1 设置迅雷
- 在访达里新建文件夹 ~/Downloads/FireFly。
- 迅雷 → 设置 → 下载目录，改成这个文件夹。
- 关闭“新建任务时弹出确认”和“选择下载位置”之类的选项，让任务直接开始。
3.2 基本设置
- 迅雷下载目录 留空表示 ~/Downloads/FireFly，需要和迅雷里设置的一致。
- 电影库 / 剧集库目录 留空时自动使用 Jellyfin 里第一个电影库和节目库。和下载目录在同一块磁盘上时，入库是瞬间完成的移动。
3.3 TMDb 元数据
- API Key 在 themoviedb.org 注册账号，到 设置 → API 免费申请。
- 接口地址 / 图片地址 从下拉框里选一个连得上的，状态区会显示连接速度。图片会缓存在本地。
- 语言 默认简体中文。
- 显示预告片 开启后详情页会播放 YouTube 预告片。你的网络打不开 YouTube 时保持关闭。
3.4 资源站点
萤火虫不内置任何站点，第一次使用需要自己添加。
- 点 添加站点，在那个网站里搜一次配置页提示的示例片名，把搜索结果页的网址粘贴进来，萤火虫会自动识别搜索方式。使用 Jackett 或 Prowlarr 的话，选择 Torznab 并填写地址和 API Key。
- 给站点勾选负责的类型，比如只用它搜动漫。
- 拖动排序。萤火虫会按从上到下的顺序检索。
- 在 试一试 里输入片名，确认能搜到结果。
3.5 优选关键词
添加你偏好的画质、编码或发布组关键词，比如 2160p、HDR、中字。越靠前优先级越高，也可以限定只对某个站点或类型生效。版本列表会按这个顺序排列。
4. 使用步骤
发现榜单或搜索
详情简介、预告、收藏
下载选季、选版本
入库自动改名刷新
- 首次安装后，在浏览器里按 ⌘⇧R 强制刷新 Jellyfin 网页，加载萤火虫的入口。
- 点顶栏的 发现 图标打开热门榜单，切换分类和筛选条件；也可以直接搜索片名。
- 点海报进入详情页，查看简介和预告片。暂时不下可以点 收藏。
- 点 获取资源。剧集先选季或单集，再在版本列表里点 下载，任务会交给迅雷。
- 点右上角的 下载任务 查看进度。完成后状态变为 已入库，Jellyfin 片库会自动刷新。
萤火虫的入口只对 Jellyfin 管理员账号显示。
5. 常见问题
详情页没有“获取资源”按钮
先按 ⌘⇧R 强制刷新网页，并确认当前是管理员账号。仍然没有的话，打开 ~/Library/Application Support/jellyfin/log/ 里最新的日志，搜索 FireFly，看插件是否加载。
点“下载”后提示无法交给迅雷
迅雷没有安装，或者不是磁力链接的默认打开方式。在迅雷的设置里把它设为默认下载工具后再试。
榜单海报加载不出来
在 TMDb 设置里换一个接口地址或图片地址，看状态区是否显示连接正常。
搜不到任何版本
检查是否已经添加资源站点，以及站点是否勾选了这个类型。可以在“试一试”里单独测试每个站点。
下载完成了，但一直没有入库
确认插件设置里的下载目录和迅雷实际的下载目录一致，并且 Jellyfin 对媒体库目录有写入权限。
能在 NAS 或 Docker 里用吗？
当前版本还不行，正在适配中，会和 Emby、qBittorrent 支持陆续发布。
升级与卸载
升级：用插件存储库安装的，Jellyfin 插件页会提示新版本，点更新后重启 Jellyfin.app。手动安装的，退出 Jellyfin 后删掉旧的 FireFly 文件夹，再按方式二装新版本。
卸载：控制台 → 插件 → FireFly → 卸载，然后重启 Jellyfin。下载记录保存在设置页显示的数据目录里，想彻底清除时手动删除该目录。