用途:该技能通过 Tautulli 的分析 API 只读访问 Plex Media Server 的使用数据,用于监控当前活动流、历史播放记录、用户观看模式、库统计与热门内容、并发流与带宽等。触发场景包括 Tautulli、Plex 分析、观看统计、当前流、谁在看 Plex、Plex 历史、最常观看、用户活动、库统计、Plex 监控等。
主要能力:所有操作均为 GET 只读请求。命令由 skills/tautulli/scripts/tautulli-api.sh 包装脚本执行,返回标准 Tautulli JSON 结构。可用命令包括 server-info、activity(可加 --details)、history(支持 --user、--section-id、--media-type、--days、--limit、--search)、user-stats(支持 --user、--sort-by、--limit、--days)、libraries、library-stats、popular、recent、home-stats、plays-by-stream、plays-by-platform、plays-by-date/hour/day、concurrent-streams(--peak)、metadata(--rating-key 或 --guid)。返回可用 jq 提取,如 activity | jq '.response.data'。
使用方式:在 ~/.claude-homelab/.env 配置 TAUTULLI_URL 与 TAUTULLI_API_KEY。API 密钥获取:打开 Tautulli 网页界面,进入 Settings → Web Interface → API,启用 API enabled 并复制密钥。示例命令:./skills/tautulli/scripts/tautulli-api.sh server-info、activity、history --days 7 --media-type movie、user-stats --user "username" --days 7、popular --media-type movie --days 30、concurrent-streams --days 7 --peak。多服务器可在 .env 中配置 TAUTULLI1_URL、TAUTULLI1_API_KEY、TAUTULLI2_URL、TAUTULLI2_API_KEY,并通过覆盖环境变量切换。通过 zsh-tool 调用脚本时需设置 pty: true。
适用场景:需要历史分析和趋势统计时使用,与 plex 技能互补——plex 提供实时服务器状态,本技能提供历史分析。可用于回答“谁在看”“最常观看”“最近观看历史”“用户本周观看量”“库中新增”“观看高峰时段”“是否达到并发流上限”等问题。
限制:需要网络访问 Tautulli 服务器;Tautulli 必须已连接 Plex Media Server;库区段 ID 与 Plex 库区段键对应;历史数据受 Tautulli 保留期配置限制;部分统计需要足够历史数据;响应时间受数据库大小与查询复杂度影响;评分键为 Plex 媒体唯一标识;默认显示友好名称。未提供具体收费、价格或平台要求的额外说明。