Sonarr

核心用法

Sonarr 技能提供命令行方式管理本地/远程 Sonarr 实例，主要功能包括：

1. 搜索剧集：输入关键词返回带编号的候选列表，每条结果附带 TVDB 链接便于用户核实
2. 检查重复：通过 TVDB ID 验证剧集是否已存在于库中
3. 添加管理：支持一键添加并立即触发搜索，也可选择仅监控不搜索；删除时可选择是否同时删除文件
4. 配置查询：获取根目录和画质配置信息

显著优点

• 本地化执行：纯 Bash 脚本依赖 curl/jq，无需额外运行时
• 工作流清晰：搜索→确认→添加的三步设计降低误操作风险
• 安全确认机制：删除文件前强制询问用户，避免误删数据

潜在局限

• 依赖外部服务：TVDB 链接和 Sonarr API 的可用性直接影响功能
• 无认证加密：配置文件以明文存储 API 密钥，依赖文件系统权限保护
• 功能范围窄：仅覆盖剧集管理，电影/音乐需其他工具

适合人群

自托管 NAS 或家庭服务器的影音收藏者，习惯命令行操作且已部署 Sonarr 的用户。

常规风险

• API 密钥泄露可能导致媒体库被未授权操作
• --delete-files 选项需格外谨慎，确认提示不可跳过

核心用法

Sonarr Skill 是一款专为媒体库自动化设计的命令行工具，通过与本地 Sonarr 实例交互，实现剧集搜索、添加、监控和管理的完整工作流。

基础配置：用户需在 ~/.clawdbot/credentials/sonarr/config.json 中配置本地 Sonarr 地址和 API 密钥，建立与 Sonarr 服务的安全连接。

主要功能：

• 智能搜索：sonarr search "剧名" 返回带 TVDB 链接的编号列表，便于用户核实剧集信息
• 一键添加：sonarr add <tvdbId> 自动添加剧集并触发搜索，支持 --no-search 选项仅添加不搜索
• 库管理：sonarr remove <tvdbId> 移除剧集，可选择是否删除关联文件
• 配置查询：sonarr config 获取根目录和画质配置文件

显著优点：
1. 顶级安全认证：获得 S+ 评级和满分 100 分，通过静态分析、动态分析、依赖审计等六项安全检测
2. 凭证管理安全：API 密钥从外部配置文件读取，零硬编码敏感信息
3. 网络隔离：仅访问用户配置的本地 Sonarr API，无外泄风险
4. 零依赖风险：除系统标准工具 curl、jq 外无第三方依赖
5. 流程透明：强制展示 TVDB 官方链接，确保用户确认剧集信息

潜在局限：
1. 功能单一：专注剧集管理，无电影管理（Radarr）或其他媒体类型支持
2. 本地部署依赖：需用户自行搭建并维护 Sonarr 服务，对新手有一定门槛
3. 网络限制：仅支持本地或用户配置的特定实例，无法直接对接公共索引器
4. 输入验证待完善：tvdbId 等参数的基础格式校验可由脚本层补充
5. 许可证缺失：当前未声明开源许可证，建议补充 MIT/Apache-2.0 等

适合人群：

• 已自建 Sonarr 媒体库的技术用户
• 追求安全认证、避免第三方依赖的隐私敏感用户
• 需要命令行高效管理剧集库的进阶用户

常规风险与建议：

• 若 Sonarr 通过公网暴露，建议启用 HTTPS 并在 curl 中添加 SSL 验证参数
• 建议为 API 调用添加超时和重试机制（如 --max-time 30 --retry 2）提升稳定性