核心用法
Seerr 技能为用户提供一站式的影视内容搜索与下载请求服务。用户只需输入想看的电影或剧集名称，系统即可通过 Seerr API 完成搜索、状态检测和自动请求的全流程操作。
搜索流程：调用 /api/v1/search 接口，按关键词返回 TMDB 匹配结果，自动过滤电影（movie）和剧集（tv）类型，展示标题、年份、评分和简介供用户选择。
智能请求：确认选择后，系统检测 mediaInfo.status 字段——若状态为 5（available）则提示已存在；若为 1-4 或缺失，则自动调用 /api/v1/request 提交下载请求。电影直接请求，剧集支持全季（"seasons":"all"）或指定季数（如 [1,3]）两种模式。
状态追踪：通过 /api/v1/movie/{id} 或 /api/v1/tv/{id} 端点实时查询处理进度，并在 Discord 等渠道以图文形式反馈，包含海报、评分、状态表情（✅ 可用/⏳ 等待中/🔄 部分可用）及 Seerr 直达链接。
显著优点
- 零配置门槛：用户无需理解 Radarr/Sonarr 的复杂规则，Seerr 自动完成电影→Radarr、剧集→Sonarr 的路由
- 自托管友好：支持本地或远程 Seerr 实例，通过环境变量灵活适配不同网络环境
- 请求自动化：从搜索到入库全程无需人工介入，显著降低媒体库维护成本
- 多平台输出：针对 Discord 优化富文本消息格式，支持海报图和内联链接
潜在局限
- 依赖前置服务：必须预先部署并配置好 Seerr、Radarr/Sonarr 及对应下载器（qBittorrent/nzbget 等），技能本身不提供下载能力
- 网络可达性要求：Seerr 实例需保持运行且 API 可访问，断网或关机状态下无法使用
- 无版权合规保障：自动化请求可能涉及版权内容，用户需自行承担法律风险
- Discord 交互受限：当前不支持按钮、下拉菜单等交互组件，仅支持纯文本+图片形式
适合人群
自建 Plex/Emby/Jellyfin 媒体库的技术用户，尤其是希望简化"想看→搜索→请求→下载"流程的 Radarr/Sonarr 现有用户。不适合无 NAS/服务器环境、或完全不了解 *arr 生态的新手。
常规风险
- API 密钥泄露：
SEERR_API_KEY需妥善保管，暴露后可能导致媒体库被恶意操作 - 误请求风险：自动提交机制可能在用户未仔细确认时触发下载，占用存储和带宽
- 服务依赖链故障：Seerr/Radarr/Sonarr/下载器任一环节异常都会导致请求失败，排查链路较长