Feed 订阅导入（MRSS、RSS、CSV、JSON）
连接外部 Feed 源，按计划自动拉取新视频。
Feed 导入（有时称为抓取器）可让您的视频库自动持续增长。只需订阅一次远程 Feed，TubePress 就会按计划自动检查，拉取新视频并跳过已经导入过的内容。
此功能位于导入界面的选项卡中 — 打开 /admin/import 并切换到订阅源（/admin/feeds URL 会重定向至此）。与一次性文件上传不同，Feed 会随着来源不断发布新内容而持续为您的站点补充视频。
Feed 导入的功能
每个来源由一个 Feed URL 及若干设置组成。按计划，TubePress 会抓取 Feed，对每条条目进行标准化处理并将新条目加入队列；第二阶段再将这些队列项转换为视频。您可以选择媒体的存储方式：
每个来源还可以设置视频类型（异性恋、同性恋或成人动漫）以及新视频是自动发布还是作为草稿等待审核。
支持的 Feed 格式
支持四种格式，可通过检测并预览按钮自动识别：
| 格式 | 映射 | 说明 |
|---|---|---|
| MRSS | 自动 | Media RSS — 最丰富的选项；字段自动映射。 |
| RSS | 自动 | 标准 RSS 条目。 |
| CSV | 手动 | 通过 URL 提供的 CSV；需手动映射列。 |
| JSON | 手动 | 通过 URL 提供的 JSON 数组；需手动映射键。 |
自动与手动。 MRSS 和 RSS 可自动识别。CSV 和 JSON 是通用格式，需手动映射列，仅需设置一次 — 请参阅下方的字段映射。
添加 Feed 来源
- 打开订阅源选项卡。 前往
/admin/import，选择订阅源，然后点击添加 Feed 来源。 - 输入 Feed URL。 必须以
http://或https://开头。点击检测并预览以自动识别格式并预览前几条内容。 - 命名并确认类型。 为来源指定名称，确认检测到的格式（MRSS、RSS、CSV 或 JSON）及视频类型。
- 选择模式。 嵌入用于存储播放器链接，下载用于获取并转码文件。
- 按需映射列。 MRSS 和 RSS 自动映射；对于 CSV/JSON，将每列拖拽到对应字段。
- 设置计划和选项。 选择刷新间隔、重复规则、自动发布及最大爬取页数。
- 保存。 使用立即获取可立即拉取，或让计划自动运行。运行队列可按需处理所有待处理条目。
字段映射
Feed 将条目标准化为导入器使用的标准字段。对于 MRSS/RSS，此过程自动完成；对于 CSV/JSON，您需要将列映射至：
title
必填。没有标题的条目将被跳过。
video_url
可直接下载的文件 — 用于下载模式。
embed_url
播放器 URL — 用于嵌入模式。
guid
用于去重的唯一标识符。
thumbnail, description, duration, published_at, views
视频的可选元数据。
categories, tags, performers, channels
逗号分隔的名称，不存在时自动创建。
一个 URL 即可。 在嵌入模式下，如果未映射
embed_url，单个 video_url 可同时作为嵌入链接，因此最简 Feed 只需标题和一个 URL。计划与自动化
名为 feed_import 的后台任务在伪 cron 上大约每 30 秒运行一次 — 无需系统 crontab。每个来源仅在其自身间隔到期时才被获取：
- 仅手动 — 永不自动获取；使用立即获取。
- 每 15 分钟、每小时、每 6 小时或每天。
同一任务还会清空导入队列 — 嵌入条目每次处理多个，下载条目每次处理一个，确保大文件不会阻塞其余内容。最大页数设置（1–50）限制单次获取在分页 Feed 中的爬取深度。
cron 需要访问流量。 伪 cron 仅在站点被访问时触发。在全新或闲置的站点上，请加载一个页面以触发它 — 或配置真实的 cron 任务以保证定时执行（参见 cron 与 CLI）。
去重与过滤
去重是自动的，在两个层面上起作用：
- 按来源。 每个条目的
guid都会被记录，因此重新获取只会将真正的新条目加入队列（已处理过的条目会被计数并跳过）。 - 跨站点。 在下载模式下，条目的 ID 会存储在视频上，因此来自两个 Feed 的同一视频不会被下载两次。
重复时选项决定条目已存在时的处理方式：跳过（推荐）或更新现有。
无关键词过滤器。 Feed 没有包含/排除关键词过滤功能 — 可通过将 Feed 指向来源中特定类别或标签的 URL 来缩小范围，并使用最大页数限制深度。清除来源的条目会重置其去重记录，但不会删除已导入的视频。
Feed 故障排查
- 「无法识别 Feed 格式。」 该 URL 未返回有效的 MRSS/RSS/CSV/JSON。请在浏览器中打开，确认看到的是原始 Feed 而非 HTML 页面。
- 条目卡在「导入中」。 约 30 分钟后会自动恢复并重试；瞬时故障最多重试三次，之后才标记为失败。
- 失败的条目。 使用重新处理将某来源的所有失败条目重新加入队列。每个来源均显示其最近的状态和消息。
- 下载模式失败。 下载需要直接视频 URL（非观看页面）；私有或内部主机会被拒绝，每个文件最大 5 GB。
- 没有内容导入。 检查计划是否设为仅手动、来源是否已启用，以及站点是否有访问流量来驱动 cron。