Radarr

核心用法

Radarr Skill 是面向媒体自动化管理场景设计的命令行工具，通过与 Radarr 服务端 API 交互，实现电影搜索、添加、收藏管理等功能。用户配置服务端 URL 和 API Key 后，可通过自然语言指令完成工作流：搜索电影名称 → 获取带 TMDB 链接的候选列表 → 选择目标 → 可选择性添加整个电影系列。

关键特性：

• 智能搜索：支持模糊匹配，返回 TMDB 链接便于用户核验
• 系列收藏识别：自动检测电影所属系列，提供一键添加全集选项
• 灵活添加策略：默认立即触发搜索，支持 --no-search 仅入库
• 根目录与质量配置：内置配置查看命令，便于用户调试

显著优点

• 降低操作门槛：封装复杂 API 调用为简洁命令，适合非技术用户
• 防重复机制：exists 命令预先检查库中是否已存在
• 元数据透明：强制展示 TMDB 链接，减少误添加风险
• 系列管理高效：解决系列电影逐部添加的繁琐问题

潜在局限

• 本地依赖：需预装 curl 和 jq，部分精简环境可能缺失
• 配置固定性：defaultQualityProfile 为静态配置，频繁切换需手动修改
• 无交互确认：除 remove 外，多数操作无二次确认，依赖用户仔细核对
• 网络依赖：TMDB 和 Radarr 服务端需同时可达

适合人群

• 自建媒体库（NAS/服务器）的影音爱好者
• 使用 Radarr 实现自动化下载的用户
• 偏好命令行高效操作的技术用户

常规风险

• 误删风险：remove --delete-files 为物理删除，需严格确认
• API 密钥泄露：配置文件中明文存储，需确保 ~/.clawdbot/ 目录权限正确（建议 600）
• 重复下载：若误操作添加已存在电影，可能触发重复下载任务
• 系列误判：TMDB 系列数据可能包含无关影片，需人工核对链接

使用建议

• 首次使用先运行 config 确认质量配置 ID 匹配预期
• 对系列添加操作，建议先点击 TMDB 链接查看完整系列列表
• 移除操作务必确认 --delete-files 参数意图

核心用法

Radarr Skill 是专为自动化电影管理设计的 API 封装工具，通过本地 HTTP 接口与 Radarr 媒体服务器交互。用户需先配置 ~/.clawdbot/credentials/radarr/config.json 指定实例地址、API 密钥及默认质量模板。

主要命令流程：

• search "Movie Name" — 搜索电影并返回带 TMDB 链接的编号列表
• add <tmdbId> — 添加电影（默认立即触发搜索）
• add-collection <collectionId> — 批量添加系列集
• remove <tmdbId> — 移除电影（可选删除文件）

关键交互设计：搜索结果必须展示可点击的 TMDB 链接 [Title (Year)](https://themoviedb.org/movie/ID)；若电影属于系列集，系统会主动询问用户是否整批添加。

显著优点

• 本地化架构：仅与 localhost:7878 或用户指定的本地 Radarr 实例通信，零外部 API 依赖
• 极简依赖：仅使用系统标准工具 curl 和 jq，无第三方包，供应链攻击面趋近于零
• 配置灵活：支持按操作覆盖默认质量模板，满足差异化收藏需求
• 安全合规：无硬编码密钥、无数据外泄、无危险函数调用

潜在局限

• 输入验证薄弱：位置参数 $1, $2 缺乏格式校验（如 tmdbId 未强制数字验证）
• 无超时保护：curl 命令未配置连接/最大超时，极端网络状况下可能挂起
• 配置文件权限：未检查 config.json 的访问权限（建议 600），存在多用户环境泄露风险
• Radarr 依赖：需用户自行部署并维护 Radarr 服务，本身不提供下载功能

适合人群

• 已搭建 Radarr + 下载工具（qBittorrent/Sabnzbd 等）链路的 NAS/HTPC 用户
• 追求「搜索-添加-监控」工作流自动化的电影收藏爱好者
• 重视隐私、拒绝云服务托管媒体库的本地优先用户

常规风险

• API 密钥泄露：配置文件若权限宽松，其他本地用户可能读取 Radarr 管理密钥
• 误删文件：remove --delete-files 操作不可逆，虽会询问用户但仍需谨慎
• 网络层暴露：若用户错误配置 url 为公网地址且 Radarr 未设鉴权，可能遭受未授权访问
• 质量模板误配：defaultQualityProfile ID 错误将导致添加任务失败或不符合预期规格