内容管理

视频和分类

视频按分类组织。分类对应 APP 首页的标签页（电影、电视剧、综艺等），可自由创建和排序。

每个分类可以：

• 配置筛选标签（地区、年份、类型等）
• 标记为 VIP 专属
• 标记为短剧（竖屏播放）

每个视频包含基本信息（片名、封面、简介、演员等）和播放地址。一个视频可以有多个播放源，用户在 A 源无法播放时可以切换到 B 源。每个播放源可以单独配置解析接口或设为 VIP 专属。

内容采集

大部分视频不需要手动添加。在后台添加采集源（对方提供的 MacCMS v10 API 地址），系统自动拉取视频信息并导入。

采集在后台「内容管理 → 采集」页面配置。

采集机制

机制	说明
单队列串行	采集任务进入 FIFO 队列逐个执行，避免并发把源站打爆
失败重试	单页拉取失败按指数退避自动重试
熔断恢复	异常时熔断保护；进程重启后把未完成的任务标记为失败（CAS 恢复），不会卡死
播放组过滤	可指定只导入哪些播放组，过滤无效线路
去重	播放地址按 hash 去重，避免重复入库

定时与手动

方式	说明
自动采集	可按采集源单独开关，采集周期可选 1/6/12/24 小时
手动采集	支持按"今日/本周/全部"快速触发，或勾选指定视频预览后导入
API 测试	添加采集源前可测试地址连通性

分类映射与标题清洗

• 分类映射：对方分类自动对应到本地分类，可在采集页绑定
• 标题清洗（自动执行）：
  • 全角字符 → 半角
  • 繁体 → 简体
  • 去除广告、水印文字
  • 去除清晰度标签（如"HD""蓝光"）
  • 罗马数字 / 英文 / 阿拉伯数字季数归一（如 Season 2、Ⅱ、第二季 统一）

过滤词

采集过滤词独立于评论屏蔽词，存放在采集页设置。命中过滤词的视频会被跳过。

采集日志

每次采集的结果都有日志，按类型分 tab 查看：新增 / 更新 / 清洗 / 跳过 / 过滤，可追踪标题清洗与过滤命中的具体情况。

专题和榜单

专题 — 手动选片的合集，适合做"春节必看""高分悬疑"等推荐。

榜单 — 根据用户观看次数自动生成，按分类统计。开启「自动推荐」后，每个分类前 3 部自动设为推荐位（客户端首页轮播、热播榜等区域优先展示）。

跳过片头片尾

支持范围

仅 手机端 APP 支持。TV 端和网页端暂不支持。

手机端 APP 播放时点击控制栏的「片头片尾」按钮，可设置片头结束时间和片尾开始时间。支持滑块调节和「标记当前位置」两种方式。进入标记区间时显示跳过按钮，也可开启自动跳过。

搜索

支持按片名、别名、演员查找。搜索结果有缓存，热门搜索词自动展示在 APP 搜索框中。