用途:该技能用于查询 Plex Media Server 中的电影、电视剧、音乐及播放历史,适合用户询问“我有哪些电影”“最近添加了什么”等媒体库相关问题时使用。
主要能力:通过 plexapi 访问服务器,可列出所有媒体库分区、按标题或 ID 获取分区、查看最近添加、继续观看、On Deck 与观看历史;支持对电影、剧集、单集进行搜索和筛选,并读取标题、年份、时长、评分、类型、演职人员、观看次数等字段。
使用方式:需在 workspace/.env 中配置 PLEX_SERVER_URL。认证采用 Plex OAuth PIN 流程,分两步:先生成授权链接并保存状态,用户登录后再轮询获取 token;也可直接使用已有 Plex token 认证。认证后以 UV 内联 Python 脚本执行查询,依赖 plexapi>=4.18。
限制:Plex API 有较严格的速率限制,轮询需退避重试;token 可能被撤销,失效后需重新认证;分区标题区分大小写;部分方法返回生成器,必要时需转为列表。具体收费、价格与平台信息暂未提供。