用途:面向 Jellyfin 媒体服务器的运维与排查工作流,覆盖只读检查与受控写入操作。
主要能力:通过 Jellyfin API 或可用的 MCP 工具查看服务器信息、媒体库、用户、活动会话、计划任务、设备与日志;处理媒体库或元数据问题;排查播放与转码问题;处理用户与账号权限变更。
使用方式:先确认目标服务器、认证来源与变更范围,不要假设默认服务器地址或管理员令牌,缺少凭据时应向用户索取。只读检查可用 API 或 MCP 工具。常见 REST 根路径包括 /System/Info、/Users、/Sessions、/Library/VirtualFolders、/Items、/ScheduledTasks、/Devices。API 密钥通常通过 X-Emby-Token 或 Authorization: MediaBrowser Token="<token>" 传递,具体取决于客户端路径。若 Jellyfin 运行在容器中,先检查容器状态、挂载的配置与媒体路径、网络可达性及近期日志。涉及数据库、插件或升级问题时,先备份或确认 Jellyfin 配置与数据路径。没有 MCP 或已认证 API 路径时,应给出用户可执行的具体 API 或管理控制台操作,而不是编造本地命令。
适用场景:媒体库与元数据修复、播放与转码诊断、用户权限调整、容器化部署检查、日志与任务排查。
限制:删除、元数据重写、媒体库重扫和用户权限变更属于写入操作,执行前需汇总目标对象 ID;具体服务器地址、令牌、版本与平台信息需由用户提供,资料未提供默认值。