HA-Fusion项目中Plex最近添加媒体海报显示问题解析

问题背景

在使用HA-Fusion项目时，部分用户遇到了Plex最近添加媒体海报无法正常显示的问题。这个问题主要出现在升级Home Assistant系统版本和Plex相关组件后，表现为条件媒体对象中的电影/电视剧海报无法加载。

技术分析

组件历史变迁

Plex最近添加功能经历了多次组件变更：

1. 原版组件由maykar开发，但两年前被归档
2. NemesisRE随后创建了分支版本以保持HACS可用性
3. 近期mkanet接管了原始仓库并添加了新功能

问题根源

新版本组件(mkanet维护)存在几个关键变化：

1. 图像获取方式改变：不再保存到/www目录，而是通过/plex_recently_added端点动态获取
2. 缺少图像分辨率选项，导致每次刷新都获取大尺寸图像
3. 最大返回数量逻辑变更，可能返回每个库的最近添加项而非单一最新项

兼容性影响

这些变更导致HA-Fusion无法正确代理图像请求，因为：

1. Fusion没有代理/plex_recently_added端点
2. 图像URL指向了HA-Fusion服务而非Home Assistant实例

解决方案

推荐配置

建议使用NemesisRE维护的分支版本，配置示例如下：

sensor:
  - platform: plex_recently_added
    host: !secret nas_host
    port: !secret plex_port
    token: !secret plex_token
    max: 1
    img_dir: /
    image_resolution: 800

SSL证书问题处理

部分用户反映SSL验证问题，即使禁用验证仍会检查Plex远程访问证书。这可能与Home Assistant核心的证书处理机制变更有关，建议：

1. 使用受信任的证书域名
2. 检查网络配置确保Plex服务可达
3. 验证组件日志获取详细错误信息

最佳实践

1. 保持组件版本稳定，避免频繁升级
2. 定期检查组件兼容性说明
3. 复杂网络环境下充分测试SSL/TLS配置
4. 监控图像加载性能，合理设置分辨率参数

通过以上分析和解决方案，用户应能恢复HA-Fusion中Plex媒体海报的正常显示功能。