总安装量 1
评分人数 1
核心用法
plexctl 是一款专为 Plex Media Server 设计的命令行控制工具，通过直接调用 Plex 官方 API 实现媒体播放的全流程管理。用户完成首次交互式配置（plexctl setup）后，即可通过自然语言指令触发播放控制：支持模糊搜索播放（plexctl play "Inception"）、精确剧集定位（-s 2 -e 5）、多客户端指定（-c "Living Room TV"），以及播放控制（pause/resume/stop/next/prev）。搜索发现模块涵盖全库检索、最近添加内容浏览、续看列表（on-deck）和实时播放状态查询。
显著优点
极致响应速度：纯 API 调用无视觉识别开销，播放启动约 500ms，控制指令 100ms 内完成，较视觉方案快 10 倍以上。精准模糊匹配：智能处理"fight club"→"Fight Club (1999)"等自然语言输入，降低记忆成本。本地化架构：所有通信限于本地网络，零云端数据上传，配置仅存储于 ~/.plexctl/config.json。生态定位清晰：与 ClawTV 形成互补——plexctl 专注 Plex 极速控制，ClawTV 覆盖跨应用复杂导航。依赖极简：仅依赖官方 plexapi 库，无重型 AI 或视觉框架。
潜在缺点与局限性
平台单一性：仅支持 Plex，无法控制 Netflix、Disney+ 等第三方流媒体。功能边界明确：不涉及服务器设置管理（需 Web UI）、无 Apple TV 原生导航能力。网络依赖：要求 Plex 服务器与客户端处于同一局域网，公网访问需额外配置。Token 管理成本：用户需手动获取并维护 Plex token，存在一定技术门槛。无视觉反馈：无法感知客户端实际播放状态，依赖 API 返回的乐观确认。
适合的目标群体
- Plex 重度用户：拥有自建媒体库、追求极致控制效率的影音发烧友
- 智能家居集成者：希望将 Plex 纳入 Home Assistant 等自动化工作流的极客
- 多房间影音家庭：需要在不同客户端（Apple TV、Web、手机）间快速切换的场景
- Claude Agent 用户：通过 OpenClaw 生态实现"播放《黑镜》最新一集"等语音交互
使用风险
配置安全风险：Plex token 以明文存储于本地配置文件，需确保 ~/.plexctl/config.json 权限设置为 600 防止越权读取。依赖更新滞后：plexapi>=4.15.0 的宽松版本约束可能引入未测试的新版本兼容性风险。网络拓扑变更：路由器 IP 变动或 Plex 服务器迁移后需重新执行 setup 流程。Token 失效：Plex 账户安全策略变更或手动撤销 token 后，所有命令将返回认证失败。客户端状态漂移：Plex 客户端离线或进入睡眠后，API 调用可能返回虚假成功状态。