radarr

核心用法

Radarr Skill 是专为自托管媒体服务器设计的电影管理工具，通过调用 Radarr API 实现影音库的智能化维护。用户首先需在本地配置文件中设置 Radarr 实例地址与 API 密钥，随后即可通过自然语言指令完成电影搜索、添加、合集管理及删除等全流程操作。

该技能支持 TMDB 电影搜索与自动匹配，在展示结果时会附带可点击的 TMDB 链接便于用户确认。当检测到目标电影属于某个合集（Collection）时，系统会主动询问是否添加整个系列，大幅提升批量管理效率。添加操作默认触发即时搜索，也可通过 --no-search 参数仅入库不下载。对于已存在的电影，技能提供安全的删除机制，区分"仅移除记录"与"删除文件"两种模式，后者需用户显式确认。

显著优点

从安全架构角度看，该技能表现优异：代码中彻底杜绝了 eval/exec 等危险函数，所有用户输入均通过 jq -sRr @uri 进行严格的 URL 编码，有效防范命令注入攻击。敏感凭证采用本地配置文件隔离机制，无任何硬编码密钥风险。权限申请极度精简，仅依赖系统标准工具 curl 与 jq，无第三方包管理风险。

功能设计上，合集支持（Collection Support）是亮点功能，可一键添加系列电影；--delete-files 的显式参数设计避免了误删风险；set -e 的错误处理机制确保脚本异常时立即退出而非继续执行危险操作。

潜在缺点与局限性

该技能重度依赖用户本地的 Radarr 实例，无法独立运行，这意味着用户必须已搭建并维护 Radarr 服务。配置门槛较高，需要手动编辑 JSON 配置文件并获取 API 密钥，对非技术用户不够友好。功能局限于电影管理，不支持 TV Shows（需配合 Sonarr）。

网络安全性方面，虽然代码本身安全，但通信加密完全取决于用户配置的 URL 协议（HTTP vs HTTPS），技能本身不强制 TLS。此外，缺乏交互式配置向导，质量配置文件（Quality Profile）和根目录需通过命令行查看，用户体验有待提升。

适合的目标群体

该技能主要面向：1）拥有自托管 NAS 或家庭服务器的影音爱好者；2）使用 Radarr 管理媒体库的中高级用户；3）需要通过自动化脚本批量维护电影收藏的管理员；4）重视隐私、倾向于本地部署而非云端服务的用户群体。

不适合没有 Radarr 基础的纯新手，或期望"即开即用"无需配置的用户。对于仅偶尔观看流媒体、无本地影音库管理需求的用户价值有限。

使用风险与注意事项

配置风险：错误的 API 密钥或 URL 配置会导致连接失败，建议在配置前通过 Radarr Web UI 测试连通性。传输安全：如在公网或不信任网络使用，务必将 Radarr 配置为 HTTPS 访问，防止 API 密钥在传输过程中泄露。文件删除：虽然 --delete-files 需要显式指定，但仍建议在执行删除前二次确认，特别是使用通配符或脚本批量操作时。依赖稳定性：虽然 curl 和 jq 是系统标准工具，但在极简容器环境（如某些 Docker 镜像）中可能缺失，需提前确认环境完整性。