Radarr

Radarr 是什么

专为家庭影音发烧友、NAS 私有云用户及媒体中心管理者量身打造的 Radarr 影视自动化检索、监控入库、画质质量分级与媒体资产治理系统。系统深度整合 Radarr 官方 REST API，突破传统人工手动搜寻种子、复制磁力链和手工重命名文件的繁琐环节，实现从自然语言片名搜寻、TMDB 元数据智能对齐、最佳压制版本质量筛选到自动化重命名整理的全流程闭环管理。

核心应用场景

适用于家庭 NAS 私有影视中心日常新片自动化追更添加、4K HDR 高码率影视资源版本智能过滤筛选、媒体服务器磁盘空间定期审计与归档整理，以及 Plex/Emby/Jellyfin 影视刮削协同。

关键功能特性

基于 REST API 的 Radarr 服务端毫秒级安全互联、TMDB 全球影视数据库多语种元数据精准映射、基于用户画质偏好（4K/REMUX/WEB-DL）的智能优选下载、影视文件标准化自动化重命名归档，以及存储容量健康度监控。

标准操作流程

用户下达影片搜索或入库指令；系统通过 TMDB 检索电影唯一 ID 与元数据；调用 Radarr 接口加入监控并触发索引器全网搜寻；挑选最优版本推送至下载器；完工后自动触发刮削整理并向用户反馈入库卡片。

输入与输出规范

输入包括电影名称、TMDB ID、期望分辨率画质、监控状态指令或存储路径参数；输出包括电影详情卡片、下载进度状态、入库成功通知及媒体库存储健康度报表。

环境依赖与权限要求

依托 Python 3.8+ 运行时环境与基础网络客户端，需用户本地局域网或云端已部署运行 Radarr 服务并提供有效 API Key。

边界限制与避坑指南

实际下载速度与资源可用性取决于用户配置的外部索引器与下载器网络连通性；受版权保护的商业影视资源需遵守当地法律法规。

目标适用人群

家庭影院爱好者、NAS 私有云玩家、媒体库运维工程师、影视自媒体编辑及高清影视收藏发烧友。

安装与启用指引

配置环境变量 `RADARR_API_KEY` 与服务端 URL 后在对话中触发（例如‘帮我添加电影《奥本海默》，要求 4K HDR 优先’），系统秒级响应入库。

来源背景与开源协议

本技能源自官方注册表认证收录，具有完备的元数据规范定义与清晰的版权授权，遵循 GPL-3.0 许可协议。在提供高效专业能力的同时严守数据安全边界，为用户的数字化与智能化业务提供稳固可靠的技术支持。

常见问题答疑

1. 该管理接口如何与本地或 NAS 部署的 Radarr 影视系统建立通讯？

在实际应用中，系统全面基于标准 REST API 接口与专用 API Key，能够毫秒级安全接入本地或局域网 NAS 服务端。

2. 当用户想要追一部新上映的影片时，系统如何执行全网搜索与添加？

在实际应用中，系统全面支持输入电影中文译名或英文原名，自动匹配 TMDB 影视元数据并将其添加至监控下载队列中。

3. 在多分辨率版本筛选中，系统如何根据用户偏好匹配 4K 或 1080P 片源？

在实际应用中，系统全面支持绑定自定义质量预设策略，按用户设定的码率、HDR 格式及特定压制小组自动筛选最佳版本。

4. 对于磁盘空间有限的影音服务器，系统具备何种存储空间监控能力？

在实际应用中，系统全面支持实时查询媒体库根目录剩余磁盘容量，在空间不足前发出预警提示，并支持按策略清理旧资源。

5. 电影下载完成后，系统如何协助处理影视海报、演职员表与 NFO 刮削？

在实际应用中，系统全面支持触发自动整理重命名工作流，规范化生成符合 Kodi 与 Plex 标准的影视海报与元数据。

6. 在局域网多设备协同中，如何确保 API Key 等核心认证凭据的安全？

在实际应用中，系统全面采用受限环境变量配置机制，所有通讯请求限制在局域网可信通道内，绝不外发敏感系统配置信息。

7. 用户能否通过自然语言指令查询近期即将上映或已归档入库的电影清单？

在实际应用中，系统全面具备语义意图解析能力，支持诸如‘查看上周新入库的科幻电影’等口语化交互，并输出规整清单。

8. 遇到种子资源断流或长时间无下载速度时，该系统提供何种救援调度？

在实际应用中，系统全面支持自动扫描长时间停滞的任务，智能向备用索引器发起重新搜索并替换为高健康度的下载任务。