KatelyaTV/SKIP_CONTROLLER_UPDATE.md

跳过控制器功能优化：片尾倒计时改进

概述

我们已经优化了 SkipController 组件的片尾倒计时功能，现在支持基于剩余时间的倒计时模式，更符合用户的使用习惯。

主要改进

1. 新增片尾计时模式选择

• 剩余时间模式（推荐）：基于视频剩余时间进行倒计时
  • 例如：设置 "2:00" 表示还剩 2 分钟时开始倒计时
  • 适用于不同长度的剧集，更加智能
• 绝对时间模式：基于视频开始播放的时间
  • 例如：设置 "20:00" 表示播放到第 20 分钟时开始检测
  • 保持旧版本的兼容性

2. 用户界面改进

• 添加了模式选择单选框
• 根据选择的模式动态更新标签和提示文本
• 更清晰的帮助说明文档

3. 技术实现详情

配置结构变更

const batchSettings = {
  openingStart: '0:00', // 片头开始时间
  openingEnd: '1:30', // 片头结束时间
  endingMode: 'remaining', // 新增：片尾模式选择
  endingStart: '2:00', // 片尾开始时间（默认改为剩余时间）
  endingEnd: '', // 片尾结束时间（可选）
  autoSkip: true, // 自动跳过开关
  autoNextEpisode: true, // 自动下一集开关
};

核心逻辑变更

// 根据模式计算实际的开始时间
let actualStartSeconds: number;
if (batchSettings.endingMode === 'remaining') {
  // 剩余时间模式：从视频总长度减去剩余时间
  actualStartSeconds = duration - endingStartSeconds;
} else {
  // 绝对时间模式：使用输入的时间
  actualStartSeconds = endingStartSeconds;
}

使用指南

设置剩余时间模式片尾（推荐）

1. 在视频播放页面点击跳过设置按钮
2. 选择"片尾设置"部分
3. 在"计时模式"中选择"剩余时间（推荐）"
4. 在"剩余时间"字段输入期望的时间，例如 "2:00"
5. 点击"保存批量设置"

这样设置后，当视频剩余时间为 2 分钟时，将开始倒计时并自动跳转到下一集。

设置绝对时间模式片尾（兼容性）

1. 在"计时模式"中选择"绝对时间"
2. 在"开始时间"字段输入视频播放时间，例如 "20:00"
3. 点击"保存批量设置"

这样设置后，当视频播放到第 20 分钟时，将开始检测片尾。

实际效果

剩余时间模式

• 对于 25 分钟的剧集，设置 "2:00" 剩余时间
• 实际在第 23 分钟（25-2=23）开始倒计时
• 倒计时 2 分钟后自动跳转下一集

绝对时间模式

• 设置 "20:00" 绝对时间
• 实际在第 20 分钟开始检测片尾
• 无论剧集长度如何，都在第 20 分钟触发

向后兼容性

• 现有的跳过配置会继续正常工作
• 默认新配置使用推荐的剩余时间模式
• 用户可以随时在两种模式间切换

技术细节

• 组件文件：src/components/SkipController.tsx
• 核心倒计时逻辑已经支持剩余时间计算
• 主要改进是配置界面和批量设置逻辑
• 包含输入验证和错误处理

这个优化解决了用户提出的"片尾是倒计时，就是还有几分钟结束跳到下一集"的需求，让跳过功能更加智能和实用。