Sonarr

Sonarr 是什么

专为家庭私有云（NAS）用户、影视剧迷及家庭影院媒体中心搭建者量身打造的 Sonarr 电视连续剧自动化追更检索、剧集文件规范整理、多季质量分级管控与媒体资产治理系统。系统深度打通 Sonarr 官方标准 REST API，彻底告别传统手动在各大论坛搜寻资源、逐集复制磁力链及手工繁琐重命名整理文件的陈旧追剧模式，实现从自然语言剧名添加、TVDB 元数据智能校准、画质偏好优选下载到标准化重命名刮削的全自动化闭环。

核心应用场景

适用于家庭影视中心对正在热播的美剧/日剧/国产剧全自动追更入库、NAS 媒体服务器海量多季电视剧自动化规范重命名与刮削整理、多硬盘存储容量健康度监控与冷门剧集自动归档清理，以及 Plex/Emby/Jellyfin 剧集库自动化维护。

关键功能特性

基于官方 REST API 的 Sonarr 服务端毫秒级安全通讯通道、TVDB 全球电视剧数据库多语种元数据精准映射、单集与整季包（Season Pack）智能识别与画质分级优选、影视文件标准化自动化归类重命名，以及追剧日历与更新动态实时推送。

标准操作流程

用户下达追剧或查询指令；系统通过 TVDB 检索电视剧唯一元数据与季集列表；调用 Sonarr 接口添加监控并触发索引器全网搜寻下载；完工后自动触发刮削重命名并向用户回传更新卡片。

输入与输出规范

输入包括电视剧名称、TVDB ID、期望分辨率画质、监控季数范围或存储路径参数；输出包括剧集卡片、追剧日历、下载进度更新通知及媒体库存储健康度报表。

环境依赖与权限要求

依托 Python 3.8+ 运行时环境与基础网络客户端，需用户本地局域网或云端已部署运行 Sonarr 电视管理服务并提供有效 API Key。

边界限制与避坑指南

实际下载速度与资源可用性取决于用户配置的外部索引器与下载器网络连通性；受版权保护的商业影视资源需遵守当地法律法规。

目标适用人群

家庭影院爱好者、NAS 私有云玩家、追剧狂热粉、媒体库运维工程师及数字影视收藏达人。

安装与启用指引

配置环境变量 `SONARR_API_KEY` 与服务端 URL 后在对话中触发（例如‘帮我添加美剧《怪奇物语》并监控最新一季，要求 1080P 高清版本’），系统秒级响应追更。

来源背景与开源协议

本技能源自官方注册表认证收录，具有完备的元数据规范定义与清晰的版权授权，遵循 GPL-3.0 许可协议。在提供高效专业能力的同时严守数据安全边界，为用户的数字化与智能化业务提供稳固可靠的技术支持。

常见问题答疑

1. 该剧集管理工具如何与家庭 NAS 中部署的 Sonarr 系统建立安全通讯？

系统全面基于 Sonarr 官方 REST API 协议与专属 API Key，实现对电视媒体库全生命周期的自动化管理。

2. 当用户想要追一部正在热播的季播剧时，系统如何执行全自动追更？

系统全面能够按剧集名称快速匹配 TVDB 影视数据库，自动添加监控并在新单集更新发布时第一时间拉取下载。

3. 在多季多集的繁琐剧集整理中，系统如何实现季包与单集的智能识别？

系统全面具备智能文件解析引擎，自动区分季包（Season Pack）与单集，避免重复下载并优化磁盘利用率。

4. 对于多语言字幕需求，系统如何协助处理剧集内嵌或外挂字幕的匹配？

在实际应用中，系统全面支持自动触发与 Bazarr 等字幕工具的联动工作流，按用户语言偏好精准下载并校准中文字幕。

5. 在影视服务器存储空间即将告警时，该系统具备何种自动维护功能？

在实际应用中，系统全面实时查询各存储盘剩余空间，支持按播出年份或已看状态策略化清理陈旧剧集，释放宝贵存储。

6. 电视连续剧下载完成后，系统如何执行符合 Plex 与 Emby 的规范整理？

系统全面自动触发规范重命名协议，将混乱的文件名标准化整理为‘剧名 – S01E01 – 标题’层级结构并刮削海报。

7. 家庭局域网多设备访问时，该工具如何确保管理凭据与配置的安全？

在实际应用中，系统全面严格采用受限环境变量配置机制，所有指令通过局域网可信加密通道流转，绝不向外暴露内部接口。

8. 剧迷能否通过口语化提问了解近期即将开播或更新的剧集时间表？

在实际应用中，全面支持自然语言日历查询，例如‘查看本周有哪些我追的剧更新’，系统即可秒级呈现播出时间卡片。