核心用法
TMS Skill 提供与 Telegram Media Server（TMS）后端 REST API 的完整交互能力，允许用户通过自然语言指令完成远程下载管理。主要功能模块包括：
1. 任务管理
- 添加下载：支持三种链接类型——直链视频（yt-dlp 解析）、磁力链（
magnet:）和种子文件 URL，POST 请求返回任务 ID 与标题 - 状态监控：实时获取下载队列状态，包括等待位置、下载进度、转码进度及错误信息
- 任务删除：通过任务 ID 终止并移除下载
2. 种子搜索
- 集成 Prowlarr 索引器，支持按关键词检索种子，可筛选质量（如 1080p）并限制返回数量（1-100 条）
- 返回结果包含磁力链、种子下载地址、做种数等关键元数据，可直接用于添加下载
3. 运维与扩展
- 健康检查端点确认服务可用性
- 可选 Webhook 机制实现下载完成/失败/停止的事件推送
- 提供 OpenAPI 规范端点便于工具链集成
显著优点
- 协议覆盖全面：单一接口处理视频直链、磁力链、种子三种主流下载源
- 状态粒度精细：区分下载进度与转码进度，队列位置可视化，失败原因可追溯
- 搜索即下载：种子检索结果可直接流转至下载任务，无需手动复制磁力链
- 轻量集成：纯 REST API 通信，无本地依赖，适合 NAS/服务器场景
潜在局限
- 依赖外部索引：种子搜索功能要求 TMS 后端预先配置 Prowlarr，否则不可用
- Webhook 可靠性：事件推送为尽力交付（best-effort），无确认重试机制，关键任务需配合轮询
- 认证单一：仅支持 Bearer Token 或 API Key 头部认证，无多用户权限分级
- 无本地文件管理：Skill 仅操作远程 TMS 任务，不直接处理本地文件系统
适合人群
- 自建 TMS 下载服务器的用户（配合 yt-dlp、Aria2/qBittorrent 后端）
- 需要通过对话界面远程管理 NAS 下载任务的技术用户
- 寻求种子聚合搜索与下载自动化整合方案的进阶用户
常规风险
- API 密钥泄露风险：
TMS_API_KEY具备完整任务控制权限，若环境变量配置不当可能导致未授权任务添加或删除 - 下载内容合规性：Skill 本身不审查下载 URL 内容，用户需自行确保磁力链/种子符合当地法律法规
- 服务器资源耗尽：批量添加大体积任务或高频搜索可能占用 TMS 后端带宽与存储
- 网络暴露面：若 TMS 服务公网可访问且未配 TLS，API 密钥存在传输层嗅探风险