核心功能
sonarr-fixed 是 Sonarr 媒体库管理工具的命令行封装技能，用于自动化搜索和添加电视剧集到 Sonarr 实例。作为原项目 jordyvandomselaar/sonarr 的分支版本，主要修复了元数据声明，明确标注了必需的 API 凭证和配置文件路径。
核心用法
- 剧集搜索：
search "剧名"返回带编号的搜索结果，强制附带 TVDB 链接 - 库存在检查：
exists <tvdbId>验证剧集是否已存在 - 添加剧集：
add <tvdbId>默认立即启动搜索，支持--no-search跳过 - 移除剧集：
remove <tvdbId>可选--delete-files删除关联文件 - 配置查询：
config获取可用的根目录和质量配置
显著优点
1. 声明式配置：明确区分配置文件路径与环境变量覆盖机制
2. 交互安全：移除剧集时强制询问是否删除文件，避免误操作
3. 搜索即开即用：添加剧集默认触发立即搜索，减少操作步骤
4. TVDB 集成：结果展示强制包含可点击的 TVDB 链接，便于用户验证
潜在局限
- 本地服务依赖：必须自行部署 Sonarr 实例，无法独立运行
- 认证门槛：需获取 API 密钥并正确配置，对新手不够友好
- 质量配置隐性依赖：依赖
defaultQualityProfileID，配置错误会导致添加失败 - 无沙箱隔离：直接调用本地 bash 脚本执行 curl 操作
适合人群
- 已自建 NAS/媒体服务器的家庭影院用户
- 熟悉 *arr 生态（Sonarr/Radarr/Lidarr）的进阶用户
- 需要 CLI 批量操作剧集库的自动化爱好者
常规风险
- API 密钥泄露：明文存储于
~/.openclaw/credentials/sonarr/config.json - 文件误删：
--delete-files选项需二次确认，但脚本执行仍有不可逆风险 - 服务可达性：依赖本地 Sonarr 服务健康状态，网络/配置错误导致操作失败
- 版本兼容性：未明确 Sonarr API 版本兼容性，升级可能导致失效