核心用法
Jellyfin Control 是一款面向家庭影音场景的命令行工具，通过 Jellyfin API 实现远程播放控制。其核心功能包括：
智能续播系统：输入剧集名称即可自动定位下一未播放集，无需手动查找进度；电影则精确恢复上次观看位置。
多设备投屏：自动发现网络中的活跃会话（智能电视、手机、浏览器），支持模糊匹配设备名称定向投送。
内容检索：快速查询媒体库获取内容 ID 与元数据。
显著优点
- 零配置复杂度：通过环境变量完成认证，无需修改代码
- 容错设计：内置重试逻辑，兼容 LG WebOS/Tizen 等平台的 Seek 降级方案
- 语义化操作：自然语言设备匹配（如 "Chromecast"），降低记忆成本
- 开源透明：代码结构清晰，核心逻辑与 CLI 分离便于二次开发
潜在局限
- 网络依赖：完全依赖局域网/服务器可达性，断网即失效
- 设备限制：仅支持已建立 Jellyfin 会话的活跃设备，无法唤醒关机设备
- 权限边界：API Key 权限决定可操作范围，无法突破服务器配置限制
- 无图形界面：纯 CLI 交互，对非技术用户存在门槛
适合人群
- 自建 Jellyfin 服务器的家庭用户（尤其配合智能家居自动化）
- 需要批量管理媒体会话的进阶玩家
- 寻求 "语音控制电视" 替代方案的极客用户
常规风险
- 凭证泄露：API Key 存储于环境变量，共享环境或日志可能暴露
- 误操作覆盖：模糊匹配可能选中错误设备，建议在家庭网络内使用
- API 版本漂移：Jellyfin 服务器升级可能导致接口不兼容