基于 Sonarr API 的电视节目管理工具，支持搜索、添加、删除剧集，需用户自行配置本地实例，适合媒体库自动化管理。
说明：
## 核心用法
Sonarr Skill 是一个用于管理 Sonarr 媒体库的命令行工具，通过 Bash 脚本封装 Sonarr API 实现电视节目管理。用户需先在 `~/.clawdbot/credentials/sonarr/config.json` 配置 Sonarr 实例地址和 API 密钥，即可通过自然语言指令完成剧集搜索、添加、删除等操作。
主要工作流程为：使用 `search “剧名”` 搜索节目，系统返回带 TVDB 链接的编号列表供用户确认，随后执行添加并自动触发下载搜索。支持 `–no-search` 参数跳过立即搜索，以及 `remove` 命令配合 `–delete-files` 删除媒体文件。
## 显著优点
1. **操作简洁直观**：将复杂的 Sonarr API 调用封装为简单命令，降低使用门槛
2. **安全设计完善**：URL 参数使用 `jq @uri` 编码，无命令注入风险；删除文件前强制用户确认
3. **依赖精简可靠**：仅依赖系统标准工具 `curl` 和 `jq`，无额外动态加载
4. **错误处理健全**：使用 `set -e` 确保异常安全退出，API 错误不泄露敏感信息
5. **配置灵活**：支持默认质量配置，同时允许单次操作覆盖
## 潜在缺点与局限性
1. **单实例限制**：仅支持配置单一 Sonarr 实例，不适合多服务器管理场景
2. **T3 来源风险**：由个人开发者维护，长期更新和支持存在不确定性
3. **网络协议默认 HTTP**：配置示例使用 HTTP，公网场景需用户自行改为 HTTPS
4. **无交互式配置向导**：新用户需手动编辑 JSON 配置文件，体验不够友好
5. **功能边界清晰**：专注电视节目，不支持电影管理（需 Radarr 等其他工具）
## 适合的目标群体
– 已部署 Sonarr 的 NAS/家庭媒体服务器用户
– 希望通过自然语言快速添加剧集的自动化爱好者
– 熟悉命令行操作、具备基础 JSON 配置能力的用户
– 追求简洁工具链、不愿使用复杂 Web 界面的效率型用户
## 使用风险
1. **配置泄露风险**：API 密钥以明文存储于本地文件，需确保文件权限（建议 600）
2. **误删文件风险**：虽有人工确认环节，但批量操作时仍需警惕 `–delete-files` 参数
3. **网络暴露风险**：默认 HTTP 通信，公网部署建议配合 VPN 或反向代理 HTTPS
4. **服务可用性依赖**：Skill 本身不验证 Sonarr 实例健康状态，异常时依赖 curl 超时机制
会员专属
