核心用法
Jellyfin Control 是一款专为家庭影音自动化设计的 CLI 工具，实现"一句话播放"的极致体验。用户只需执行 tv play "剧名"，即可完成：验证内容存在→电视开机→启动 Jellyfin→定位未播剧集→精准续播的全流程。支持电影自动定位上次观看进度、剧集智能匹配下一集，无需手动翻找。
显著优点
- 双后端灵活适配：原生支持 Home Assistant（通用任意电视品牌）与 Direct WebOS（LG 电视免 HA 直连），自动检测配置并切换
- 零冗余操作：内容预校验机制确保电视不会为"找不到的资源"白开机
- 会话级精准控制：自动发现 TV/手机/Web 多终端会话，支持指定设备播放
- 全功能遥控：音量、静音、进退、应用启动、甚至 HDMI 源切换均可 CLI 完成
- 管理员功能：库扫描、多用户历史追踪（需管理员 API key）
潜在局限
- 品牌限制：Direct WebOS 后端仅限 LG 电视；其他品牌必须依赖 Home Assistant
- 网络依赖：Wake-on-LAN 需要电视与服务器同网段，跨 VLAN 需额外配置
- 首次配对：WebOS 直连需人工确认电视弹窗并保存
TV_CLIENT_KEY - 延迟硬编码：电视启动（默认 10s）与应用加载（默认 8s）的等待时间固定，老旧设备可能需手动调大
适合人群
- 已部署 Jellyfin 的 NAS/自托管用户
- Home Assistant 智能家居玩家
- 追求"语音/自动化触发观影"的极客家庭
- 懒得找遥控器、记不住剧集进度的 binge-watcher
常规风险
- 密钥泄露风险：
JF_API_KEY、HA_TOKEN、TV_CLIENT_KEY均为高权限凭证，必须仅存储于openclaw.json环境变量，禁止写入代码或文档 - HA 令牌权限过高：建议创建专用受限用户，避免长期令牌被滥用
- 电视误操作：WoL 广播可能误唤醒同 MAC 前缀设备（罕见）
- 会话竞争：多用户同时操作时，会话发现可能指向错误设备