Subscription

订阅功能

订阅功能允许您批量导入外部资源集合，自动监控更新并执行转存操作。

---

1. 功能概述

订阅系统支持：

• UUID 订阅：通过订阅 UUID 导入资源包
• 批量管理：一键管理多个分享链接
• 自动更新：定时检测订阅内的资源变化
• 状态追踪：实时查看资源状态（有效/失效）

---

2. 添加订阅

创建订阅

1. 进入"订阅"页面
2. 点击"添加订阅"
3. 输入订阅名称和 UUID
4. 选择目标账号和保存目录
5. 保存后系统自动解析订阅内容

订阅配置

选项	说明
订阅名称	自定义订阅名称便于识别
订阅 UUID	资源分发者提供的唯一标识
自动转存	检测到新资源自动转存
生成 STRM	转存后自动生成 STRM 文件

---

3. 管理订阅资源

资源列表

订阅解析后会显示所有包含的资源：

• 资源名称
• 分享链接
• 文件大小
• 状态（有效/失效/已转存）

批量操作

• 一键转存：批量转存所有未转存资源
• 校验状态：检测分享链接是否有效
• 标记失效：手动标记无效资源

---

4. 自动更新检测

系统会定期检查订阅更新：

1. 检测订阅内是否有新资源
2. 检测现有资源是否失效
3. 根据配置自动转存新资源
4. 发送更新通知

---

5. API 接口

获取订阅列表

GET /api/subscriptions
Header: x-api-key: YOUR_API_KEY

添加订阅

POST /api/subscriptions
Header: x-api-key: YOUR_API_KEY
Body: {
  "name": "订阅名称",
  "uuid": "订阅UUID",
  "accountId": 1,
  "targetFolderId": "文件夹ID"
}

触发订阅更新检测

POST /api/subscriptions/:id/check
Header: x-api-key: YOUR_API_KEY

---

💡 使用建议

• 定期维护：定期清理失效资源
• 合理命名：使用有意义的订阅名称
• 监控通知：开启订阅更新通知