Repository navigation
Releases: rappa850/Jellyfin.Plugin.Amane
Releases · rappa850/Jellyfin.Plugin.Amane
Release list
v1.0.9
新增
- 支持 Amane 图片 Token,演员头像可正常刮削:Amane 0.23.0 新增独立的图片 Token(
?token=查询参数,只能读取/api/resources/*)。Jellyfin / Emby 下载演员头像使用不带请求头的 HttpClient,此前遇到 Amane 本地资源只能放弃,导致头像缺失(#7)。现在在配置页填入图片 Token后,本地图片会自动附带该 Token 下载。 - 配置页(Jellyfin 10.11 / 12.1 / Emby)新增"图片 Token"字段。
安全
- 图片下载失败的日志与异常消息不再包含 URL 查询串,避免图片 Token 泄露到日志。
升级说明
- 需要 Amane 0.23.0 及以上才能使用图片 Token;Token 见 Amane 启动日志或数据目录的
image_token文件,该 Token 只能读取图片资源。 - 图片 Token 留空时行为与 1.0.8 完全一致:Amane 本地图片无法被宿主无鉴权下载,演员只会得到名字和简介。
- 浏览器里识别弹窗的预览使用配置的服务地址,该地址必须是浏览器可访问的。
- 现有配置无需迁移,升级后在配置页补填图片 Token 即可。
文档
- README 更新 Amane 0.19.0 / 0.20.1 / 0.22.0 兼容说明,说明每周上游版本检查任务,并补充图片 Token 配置步骤。
安装包
| 宿主 | 安装包 |
|---|---|
| Jellyfin 10.11.x(≥ 10.11.10) | Jellyfin.Plugin.Amane.zip |
| Jellyfin 12.1 | Jellyfin.Plugin.Amane.12.zip |
| Emby 4.9+(.NET 8) | Emby.Plugin.Amane.zip |
三个适配器版本号一致,均为单 DLL 部署,两版 Jellyfin 的包不可互换。
完整变更:v1.0.8...v1.0.9
v1.0.8
Amane v1.0.8: Jellyfin 10.11, Jellyfin 12.1 and Emby
v1.0.7
Release v1.0.7: Jellyfin 10.11.10 compatibility
v1.0.6
fix: 修复识别弹窗缩略图与演员头像 401 破图(v1.0.6) v1.0.5 把直出路径的图片 URL 也改写成了需 Bearer 鉴权的 Amane 代理/ 本地资源地址,但这类消费方无法携带 token(源码实证): - 识别/搜索弹窗缩略图 RemoteSearchResult.ImageUrl 由浏览器直连 (jellyfin-web itemidentifier.js 原样塞进 <img>); - 演员头像 PersonInfo.ImageUrl / Person ItemImageInfo.Path 由 Jellyfin 裸 HttpClient 下载(ConvertImageToLocal → ProviderManager.SaveImage)。 引入图片 URL 双轨制: - AmaneClient 新增 ToDirectImageUrl:外源 URL 原样直出,Amane 本地资源 返回 null(影片搜索结果的本地裁切海报回退 thumb_url 外源图预览); - 直出字段(ImageUrl/ThumbnailUrl/PersonInfo.ImageUrl/ItemImageInfo.Path) 全部改用 ToDirectImageUrl; - 下载路径 RemoteImageInfo.Url 保持 ToProxyImageUrl 代理不变。
v1.0.5
fix: 修复 Amane 更新后刮削拿不到最新数据与图片不显示(v1.0.5)
缓存治理:
- 演员缓存 TTL 改为配置项 ActorCacheMinutes(默认 360 分钟,0 禁用,即时生效)
- 新增 POST /Amane/ClearCache 端点与配置页"清除演员缓存"按钮
图片链路修复(Amane 有图但 Jellyfin 看不到封面):
- 图片 URL 统一经 ToProxyImageUrl 改写:外源 URL 走 Amane /api/resources/proxy
代理(绕过外源防盗链/可达性问题),相对路径本地资源(裁切海报
/api/resources/{hash})补全 ServerUrl 直取
- GetImageAsync 加固:浏览器 UA、独立超时(下限 30s)、非 2xx/非 image
内容记警告并抛异常(防 Jellyfin 缓存错误体成永久坏图)、Bearer 只发
Amane 域内 URL
- 探针脚本新增图片取图链路实测(相对/绝对两种形态)