Radarr

核心用法

Radarr Skill 是面向自建媒体服务器用户的电影管理工具，通过命令行接口与 Radarr 自动化下载工具交互。用户可通过自然语言搜索电影名称，系统返回带编号的 TMDB 结果列表，点击链接可查看详情，确认后一键添加至下载队列。特别支持电影合集（Collection）的批量识别与添加，例如选择《钢铁侠》时可提示是否同时添加整个漫威系列。

显著优点

• 无缝集成：直接调用本地/远程 Radarr 实例 API，无需离开对话界面
• 合集智能识别：自动检测电影所属系列，减少重复搜索操作
• 即时搜索：默认开启"添加即搜索"，缩短从决策到下载的等待时间
• 灵活配置：支持品质配置档预设与单条覆盖，满足收藏级与观看级不同需求

潜在局限

• 依赖自建服务：必须预先部署 Radarr 并暴露 API，无公共托管方案
• 网络可达性要求：需确保 Skill 运行环境与 Radarr 实例的网络连通
• 配置门槛：需手动编辑 JSON 配置文件，包含 API 密钥等敏感信息
• 无元数据编辑：仅支持添加/删除操作，无法修改已入库电影的元数据或路径

适合人群

• 已搭建 Plex/Jellyfin + Radarr 自动化媒体栈的进阶用户
• 希望通过聊天界面快速扩充电影库、减少多界面切换的操作者
• 需要批量管理系列电影（如哈利波特、指环王合集）的收藏爱好者

常规风险

• API 密钥泄露：配置文件明文存储密钥，需确保 ~/.clawdbot/credentials/ 目录权限为 600
• 误删文件：remove 命令支持 --delete-files 选项，操作前强制二次确认
• 存储空间失控：合集批量添加可能一次性触发数十部电影下载，建议提前检查磁盘配额
• 版权合规：仅应用于拥有合法访问权限的内容源，Skill 本身不提供下载渠道

核心用法

Radarr Skill 是一款针对电影自动化管理工具 Radarr 的集成脚本，主要功能包括：

1. 电影搜索与添加：通过 search 命令查询电影，返回带 TMDB 链接的结果列表，支持按编号快速添加
2. 收藏系列管理：检测到电影属于某个系列（Collection）时，可一键添加整个系列
3. 本地库管理：支持检查电影是否存在、删除电影（可选是否删除文件）
4. 配置辅助：内置 config 命令查看质量配置和根目录选项

配置要求

需创建 ~/.clawdbot/credentials/radarr/config.json，包含 Radarr 实例 URL、API 密钥和默认质量配置 ID。

---

显著优点

• 零第三方依赖：仅使用系统标准工具 curl 和 jq，无额外包管理风险
• 安全编码规范：输入经过 URL 编码处理，无 eval/exec 等危险函数
• 网络通信受限：仅连接用户配置的本地 Radarr API，无外泄风险
• 凭证管理安全：API 密钥从本地配置文件读取，无硬编码
• 功能设计贴心：强制展示 TMDB 链接、删除文件前必须询问用户、支持系列批量添加

---

潜在缺点与局限性

• T3 级来源：个人开发者维护，GitHub 等平台无公开组织信息，透明度有限
• 无输入长度限制：搜索查询未设最大长度限制，极端情况下可能导致 API 异常
• API 响应缺少验证：依赖 Radarr API 返回结构，未对响应字段做完整性校验
• 配置门槛：需要用户自行创建 JSON 配置文件并获取 Radarr API 密钥，对新手不够友好
• 功能单一：专注 Radarr 集成，无法替代完整的管理界面操作

---

适合人群

• 已部署 Radarr 的电影爱好者，希望通过命令行快速添加电影
• 使用自动化工作流（如配合其他 *arr 工具链）的高级用户
• 注重隐私、不愿使用云端电影管理服务的本地部署用户

---

常规风险

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

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

| 数据泄露 | 极低 | 仅本地通信，无数据外发 |

| 恶意代码 | 低 | 静态分析通过，但 T3 来源需审慎 |

| 配置误操作 | 中 | `--delete-files` 可物理删除文件，虽已强制交互确认但仍需谨慎 |

| API 滥用 | 低 | 建议添加搜索长度限制 |

---

总体评价

该 Skill 代码质量良好，安全编码实践到位，适合已熟悉 Radarr 生态的用户使用。建议开发者补充项目元数据（LICENSE、CHANGELOG、GitHub 仓库链接）以提升可信度。