核心用法
Seerr技能通过API对接Overseerr/Seerr实例，为用户提供完整的媒体发现与请求工作流。核心功能包括：
1. 智能搜索 — 调用/api/v1/search查询TMDB数据，自动过滤电影(movie)和剧集(tv)结果，返回标题、年份、简介及当前状态（未知/待处理/处理中/部分可用/已可用）。
2. 一键请求 — 支持电影直接请求，剧集可选全部季或指定季数（如[1,3]），自动路由至后端Radarr/Sonarr实例。
3. 状态追踪 — 通过独立端点查询具体媒体状态，避免重复请求已存在内容。
4. Discord交互优化 — 在Discord场景中渲染卡片式交互界面，使用原生组件（buttons/select）替代纯文本，点击直达Seerr详情页。
显著优点
- 自动化闭环 — 搜索→确认→请求→下载全程无人工介入媒体库后端
- 精准状态感知 — 实时反馈内容可用性，防止重复下载
- 弹性季数控制 — 剧集支持全季/指定季灵活选择
- 多平台适配 — 原生支持Discord富交互，通用场景保留简洁文本输出
潜在局限
- 强依赖外部基础设施 — 必须自建Seerr+Sonarr/Radarr+下载器完整链路
- 网络暴露风险 — 需将Seerr实例URL和API密钥配置为环境变量，存在凭证泄露面
- 无内置认证层 — 技能本身不校验请求者权限，完全依赖Seerr端的用户管理
- TMDB依赖 — 搜索质量与元数据完整性取决于TheMovieDatabase
适合人群
- 已部署*arr媒体库堆栈的NAS/服务器用户
- 追求"对话式搜片"体验的家庭媒体管理员
- 需要向非技术成员开放媒体请求入口的共享场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证暴露 | SEERR_API_KEY若配置于公共仓库或日志可导致实例被滥用 |
| 存储膨胀 | 自动审批配置下可能请求低质量或重复内容，挤占磁盘 |
| 版权合规 | 需用户自行确保所请求内容的获取合法性 |
| 服务可用性 | 任一后端组件（Seerr/Radarr/Sonarr/下载器）故障将导致流程中断 |
配置建议
- 使用反向代理+HTTPS保护SEERR_URL通信
- 在Seerr端启用"请求审批"而非自动批准
- 定期轮换API密钥，避免长期凭据 |