Radarr

核心功能

Radarr 是一款开源电影管理自动化工具的 API 封装技能，支持从 TMDB 数据库搜索电影、自动添加至监控库、批量添加电影合集，并可配置画质配置项与下载触发策略。

显著优点

• 集成化工作流：将搜索、校验、添加、合集扩展串联为交互式流程，降低多步骤操作门槛
• TMDB 原生支持：直接对接 TheMovieDatabase 元数据，返回可点击的电影详情链接
• 灵活添加策略：默认立即触发搜索，同时支持 --no-search 延迟下载，适应不同网络与存储场景
• 合集智能提示：自动识别电影所属系列，提供一键添加全系列选项，方便收藏整理
• 安全删除机制：移除电影时强制询问是否删除文件，避免误操作导致数据丢失

潜在局限

• 依赖自建基础设施：必须自行部署并维护 Radarr 服务及下载工具链（如 qBittorrent、NZBGet），无托管选项
• 配置门槛：需手动编写 JSON 配置文件，包括 URL、API Key 和质量配置项 ID，对新手不够友好
• 网络环境要求：需保证运行环境能访问 Radarr 服务及外网 TMDB API，墙内环境需额外代理配置
• 功能边界：仅覆盖电影管理，TV 剧集需配合 Sonarr 等其他工具

适合人群

• 已搭建 NAS/Homelab 的影音发烧友与 PT/NZB 用户
• 熟悉 *arr 系列生态、追求自动化管理的进阶用户
• 需要批量维护电影合集（如漫威宇宙、速度与激情系列）的收藏整理者

常规风险

• API 密钥泄露风险：配置文件中的 apiKey 需妥善保管，避免提交至公共代码仓库
• 误删数据：--delete-files 操作不可逆，需二次确认
• 资源占用：批量添加合集可能瞬间触发大量下载任务，需确保存储与带宽充足
• 服务可用性：Radarr 服务宕机时技能完全不可用，需关注上游服务状态

核心用法

Radarr Skill 是一款面向电影收藏管理的命令行工具封装，专为 Radarr 媒体库自动化平台设计。核心功能涵盖电影搜索、库存在检测、单电影/合集添加、删除管理四大模块。

搜索流程：执行 search "电影名称" 后，工具通过 Radarr API 查询 TMDB 数据库，返回带编号的候选列表，每条结果强制附赠 [标题 (年份)](https://themoviedb.org/movie/ID) 格式的可点击链接，确保用户可二次核验。

添加机制：支持 add <tmdbId> 即时添加并触发搜索，或 --no-search 仅入库待后续处理。若检测到电影隶属某个 Collection（如漫威宇宙、指环王三部曲），系统会主动提示用户是否追加完整合集。

配置管理：依赖 ~/.clawdbot/credentials/radarr/config.json 存储本地 Radarr 实例地址、API 密钥及默认质量配置（defaultQualityProfile）。

显著优点

• 零依赖攻击面：仅使用系统内置 curl 与 jq，无第三方 npm/pip 包，彻底规避供应链投毒风险。
• 网络完全可控：所有通信局限于用户配置的本地 Radarr 服务（默认 7878 端口），无外联服务器，无数据外泄通道。
• 透明可审计：332 行 Shell 脚本逻辑清晰，无混淆、无动态代码加载，静态分析即可完整理解行为。
• 用户体验优化：强制 TMDB 链接输出、Collection 智能提示、文件删除二次确认，兼顾效率与安全。

潜在局限

• 协议安全性依赖用户：Skill 本身不强制 HTTPS，若用户配置 HTTP 内网地址，存在局域网嗅探风险（虽实际威胁极低）。
• 输入校验待加强：tmdbId 等参数未做严格数字格式验证，极端情况下可能触发无效 API 请求。
• 错误处理较基础：curl 失败或 Radarr 服务不可达时的提示信息不够详尽，需用户具备基础排查能力。
• T3 来源等级：维护者为个人开发者（jordyvandomselaar），无企业背书，长期维护可持续性需观察。

适合人群

• 已部署 Radarr 的 NAS/家庭服务器用户
• 偏好命令行交互、追求轻量化工具的进阶玩家
• 对供应链安全敏感、希望最小化依赖的谨慎型用户

常规风险

• API 密钥泄露：config.json 存储明文凭据，需确保文件权限（建议 600）及目录安全。
• 误操作删除：remove 命令支持 --delete-files 物理删除，虽强制交互确认，仍需用户谨慎操作。
• 本地服务可用性：Radarr 实例离线时所有命令失效，无降级机制。