Sonarr

核心用法

Sonarr 是一款开源的电视节目自动化管理工具，通过本地 API 与客户端交互实现剧集库的智能化运维。用户需先在本地部署 Sonarr 服务（默认端口 8989），配置 API 密钥后方可使用本技能。

主要功能模块：

• 剧集搜索：通过 TVDB 数据库检索目标剧集，返回带编号的候选列表及 TVDB 详情页链接
• 库管理：支持添加/移除剧集，可配置质量配置文件（Quality Profile）与监控选项
• 自动化搜索：添加剧集时可立即触发索引器搜索，自动抓取匹配资源
• 元数据校验：内置 exists 检查避免重复添加，支持根文件夹与质量配置预查询

交互流程：用户发起搜索 → 系统返回带 TVDB 链接的编号列表 → 用户选择编号 → 执行添加并可选立即搜索。移除操作需二次确认是否删除实体文件。

显著优点

• 开源生态：完全开源，社区活跃，无订阅费用
• 标准化集成：基于 TVDB 元数据，与主流下载器（qBittorrent、NZBGet 等）联动成熟
• 灵活配置：支持质量配置覆盖、监控策略（整季/未来集/全部）、多根文件夹管理
• 自动化程度高：search-on-add 机制减少人工干预，适合长期追更场景

潜在缺点与局限性

• 部署门槛：需自建服务、配置反向代理、维护索引器与下载器，技术门槛较高
• 网络依赖：依赖海外 TVDB 数据库，国内访问可能需代理；索引器多为海外站点
• 无内置播放器：纯管理工具，需配合 Plex/Jellyfin 等实现播放
• 文件系统风险：--delete-files 操作不可逆，误删可能造成数据丢失

适合人群

• 已部署 NAS/Homelab 的进阶用户
• 习惯自托管开源媒体栈（Sonarr/Radarr/Plex 组合）的自动化爱好者
• 有海外网络环境或代理配置能力的用户

常规风险

• 配置泄露：config.json 含明文 API 密钥，权限设置不当可能导致未授权访问
• 误操作风险：批量删除文件无回收站机制，脚本参数错误可能清空库
• 版权合规：自动化下载受版权内容需用户自行承担法律风险
• 服务可用性：本地服务宕机时技能完全不可用，无降级方案

核心功能

Sonarr Skill 是一款专为影视收藏爱好者设计的剧集管理工具，通过简洁的命令行界面与自托管的 Sonarr 媒体服务器进行交互。核心功能包括：剧集搜索（对接 TVDB 数据库）、智能添加（支持质量配置和即时搜索）、库内查重、以及完整的剧集生命周期管理（移除时可选择保留或删除文件）。

显著优点

极致安全架构：代码仅 164 行，零第三方依赖包，仅使用系统预装的 curl 和 jq。无 eval/exec/system 等危险函数，用户输入通过 jq -sRr @uri 进行 URI 转义，有效防御注入攻击。

隐私优先设计：所有网络通信仅限于用户自托管的 Sonarr 实例，无数据外泄风险。不收集任何用户敏感信息，符合 GDPR 数据最小化原则。

来源可信：发布于 ClawHub 社区平台，维护者账号历史可追踪，获得 T2 级别信任认证。

潜在局限

配置灵活性不足：配置文件路径固定为 $HOME/.clawdbot/credentials/sonarr/config.json，暂不支持环境变量覆盖，在多用户或 CI/CD 场景下需要额外适配。

凭据管理依赖用户：API Key 以明文形式存储于配置文件，需用户自行设置文件权限（建议 chmod 600），暂未提供密钥管理服务集成。

网络容错待完善：当前 curl 调用未设置超时参数，网络异常时可能导致命令挂起，建议手动添加 --connect-timeout 参数。

适合人群

• 已部署 Sonarr 的 NAS/家庭服务器用户
• 注重隐私、不愿将媒体库数据上传云端的技术爱好者
• 需要批量管理剧集订阅的自动化运维场景

常规风险提示

1. 配置权限风险：API Key 泄露可能导致 Sonarr 实例被未授权访问，务必严格控制配置文件权限。
2. TVDB ID 输入验证：建议在使用前手动验证 TVDB ID 格式，避免因无效 ID 导致 API 报错。
3. 网络可用性：Skill 完全依赖本地 Sonarr 服务，若服务未启动或网络不通，所有功能将无法使用。