基于 Tautulli API 的 Plex 媒体服务器监控工具，支持实时查看播放活动、历史记录及库统计，适合家庭媒体管理员快速掌握服务器状态。
说明：
## 核心用法
Tautulli Skill 是一套用于监控 Plex Media Server 的轻量级命令行工具集，通过调用 Tautulli 的 REST API 实现数据查询。用户需预先配置 `TAUTULLI_URL` 和 `TAUTULLI_API_KEY` 两个环境变量，即可通过六个独立脚本获取服务器状态：
– **activity.sh**：实时查看当前播放流，包括用户名、影片标题、播放进度、画质及播放设备
– **history.sh**：查询观看历史，支持自定义返回条数（默认10条）
– **libraries.sh**：列出所有媒体库分区及内容数量统计
– **recent.sh**：查看最近添加的媒体内容
– **users.sh**：获取用户列表及总观看时长、最后活跃时间
– **server.sh**：显示 Plex 服务器名称、版本、平台及连接状态
所有脚本均采用统一的 API 调用模式，通过 `curl` 发送 GET 请求至 `$TAUTULLI_URL/api/v2`，并使用 `jq` 解析 JSON 响应。
## 显著优点
1. **零侵入式监控**：纯只读查询，不修改任何服务器配置，风险极低
2. **轻量依赖**：仅需系统自带的 `curl` 和 `jq`，无需额外运行时或复杂依赖链
3. **脚本化工作流**：适合集成到自动化脚本、定时任务或通知系统中
4. **清晰的输出格式**：通过 `jq` 格式化后的数据便于人工阅读或二次处理
5. **配置灵活**：通过环境变量管理连接信息，支持多实例切换
## 潜在缺点与局限性
1. **功能只读**：无法执行管理操作（如停止播放、删除记录、管理用户权限）
2. **无内置可视化**：输出为纯文本/JSON 格式，需配合其他工具实现图表展示
3. **网络依赖**：要求运行环境与 Tautulli 实例网络可达，无法离线使用
4. **参数验证有限**：`history.sh` 和 `recent.sh` 的 `limit` 参数仅提供默认值，无严格的正整数校验
5. **T3 来源风险**：个人开发者维护，长期更新保障相对较弱
## 适合的目标群体
– **家庭 Plex 管理员**：需要快速查看谁在看什么、服务器负载如何
– **媒体库运营者**：统计内容增长趋势、用户活跃度分析
– **自动化爱好者**：将监控数据接入 Home Assistant、Discord 机器人等通知渠道
– **小型团队 IT**：管理内部媒体服务器，无需复杂商业监控方案
## 使用风险
– **API Key 泄露风险**：若环境变量配置不当，可能导致 Tautulli 访问凭证暴露
– **HTTP 明文传输**：默认配置可能使用 HTTP，建议优先启用 HTTPS
– **curl/jq 版本差异**：老旧系统上的工具版本可能影响 JSON 解析行为
– **Tautulli 服务可用性**：API 查询依赖 Tautulli 自身运行状态，非 Plex 直连
会员专属
