Radarr

核心用法

Radarr Skill 是一套面向电影自动化管理的命令行封装脚本，通过调用 Radarr REST API 实现电影搜索、入库、合集管理与删除等操作。用户配置 RADARR_URL 与 RADARR_API_KEY 后即可通过自然语言交互完成媒体库维护。

搜索流程：执行 search "电影名" 返回带 TMDB 链接的编号列表，用户选择后系统检测是否属于电影合集，提示是否批量添加。添加时强制选择画质配置（quality profile），默认触发立即搜索（search-on-add）。

关键特性：

• 智能合集识别：自动检测 TMDB 合集关系，支持整系列一键入库
• 双向搜索控制：--no-search 参数可跳过立即搜索，适用于预添加规划
• 文件级清理：删除电影时可选 --delete-files 物理清理存储
• 配置自省：config 命令暴露根目录与画质模板，降低配置门槛

显著优点

1. 降低 API 使用门槛：将复杂的 Radarr JSON API 封装为单参数 shell 命令，无需记忆端点与认证头
2. 防呆设计：强制确认画质配置、文件删除二次确认、TMDB 链接可视化校验
3. 合集工作流优化：解决系列电影逐一手动添加痛点，适合漫威、速激等长篇系列管理
4. 轻量依赖：仅依赖 curl 与 jq，兼容多数 Linux/macOS 环境

潜在缺点与局限性

• 环境变量单点配置：URL 与 API Key 以明文环境变量存储，多实例管理时需手动切换上下文
• 无状态设计：不缓存搜索结果，重复查询增加 TMDB/Radarr 双重 API 负载
• 权限边界模糊：脚本以执行用户身份运行，若 Radarr 配置为特权容器，删除文件操作存在误伤风险
• 错误处理简化：依赖 shell exit code，复杂网络超时或 Radarr 任务队列满载时反馈不够友好
• 版本锁定风险：Radarr v4/v5 API 存在字段差异，脚本未声明兼容版本范围

适合人群

• 已部署 Radarr 的 NAS/HTPC 用户，寻求比 Web UI 更快的批量操作方式
• 需要自动化脚本集成（如结合 Sonarr 做"追剧追影"统一入口）的进阶用户
• 频繁管理电影合集（导演作品集、系列续集）的收藏向用户

常规风险

| 风险类别 | 说明 | 缓解建议 |

|---------|------|---------|

| 误删数据 | `remove --delete-files` 不可逆清除存储 | 强制交互确认，生产环境建议关闭该参数 |

| API 密钥泄露 | 环境变量可被 `ps`/`proc` 窥探 | 使用专用 API Key 并限制 IP 白名单 |

| 存储膨胀 | 合集一键添加可能瞬间触发数十部电影搜索 | 配合 Radarr 磁盘配额或 `--no-search` 预规划 |

| 网络暴露 | 默认 `localhost` 配置若改为公网 URL 无额外认证层 | 始终通过 VPN/反向代理访问 Radarr 实例 |

核心用法

Radarr Skill 是一款专为本地下载管理工具 Radarr 设计的自动化助手，主要功能包括电影搜索、添加、删除及合集管理。用户通过自然语言指令即可完成原本需要在 Radarr Web 界面中手动操作的任务。

典型工作流：
1. 使用 search "电影名称" 获取带编号的搜索结果，结果以 Markdown 格式展示，包含可点击的 TMDB 链接
2. 用户选择编号后，系统会自动检测该电影是否属于某个合集
3. 若属于合集，询问用户是否同时添加整个合集
4. 添加时强制询问画质配置（Quality Profile），支持 search-on-add 立即搜索选项

关键命令：

• search：模糊搜索电影，返回 TMDB ID、年份、评分等信息
• add <tmdbId>：添加单部电影，默认立即触发搜索
• add-collection <collectionTmdbId>：批量添加整个系列
• remove <tmdbId>：移除电影，可选是否删除本地文件
• config：获取当前的 Root Folder 和 Quality Profile 配置

显著优点

1. 操作高效：将原本需多次点击 Web 界面的操作简化为单条自然语言指令
2. 合集智能识别：自动检测电影归属的系列合集，支持一键批量添加
3. 信息透明：所有搜索结果强制附带 TMDB 官方链接，便于用户核实
4. 配置灵活：通过环境变量或配置文件管理多实例，支持自定义画质配置
5. 供应链极简：仅依赖系统原生工具 curl 和 jq，无第三方 npm/pip 包风险

潜在缺点与局限性

1. 网络依赖：必须预先部署并运行 Radarr 实例，无法独立工作
2. 输入验证缺失：当前版本未对 TMDB ID 等参数进行格式校验，无效输入可能导致 API 错误
3. 错误处理不足：curl 未设置超时参数，也未检查 HTTP 状态码，极端情况下可能挂起
4. 功能边界：仅覆盖基础 CRUD 操作，高级功能如自定义格式规则编辑、手动导入等不支持
5. 本地局限：仅支持本地 Radarr 实例，无法管理远程或多实例场景

适合人群

• 已部署 Radarr + Sonarr 媒体自动化栈的家庭 NAS 用户
• 偏好 CLI/Chat 交互而非 Web UI 点击的效率型用户
• 需要频繁批量添加系列电影（如漫威宇宙、速度与激情等）的收藏者
• 对供应链安全敏感、希望最小化第三方依赖的技术用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 数据泄露 | 极低 | 所有通信限于本地 Radarr API，无外部网络调用 |

| 误操作 | 中 | 删除电影时若误选 `--delete-files` 可能导致数据丢失，需二次确认 |

| API 密钥泄露 | 低 | 建议存储于环境变量或专用配置目录，避免硬编码 |

| 服务可用性 | 低 | 无超时设置可能导致长时间无响应，建议手动中断 |

安全认证摘要

经 CLS-Certify v2.1.0 全量扫描，该 Skill 获得 A 级（85分） 安全评级。静态分析、动态分析、依赖审计均通过，无危险函数调用、无动态代码执行、无数据外泄通道。符合 GDPR 数据最小化原则，个人开发者维护（T3 可信度）。