Files
KatelyaTV/SKIP_FEATURE_GUIDE.md
T
katelya d5726c4f07 feat: Implement intelligent skip feature with enhanced settings
- Added support for time input in minutes:seconds format for skipping segments.
- Introduced automatic skipping functionality for both opening and ending segments.
- Enhanced UI for skip settings with a floating configuration card.
- Implemented countdown timer for automatic next episode playback.
- Added batch settings for configuring multiple skip segments at once.
- Updated SkipController component to handle new skip logic and UI changes.
- Created comprehensive usage guide for the new skip feature.
2025-09-02 14:49:56 +08:00

3.3 KiB

🎬 智能跳过功能使用指南

功能特色

🚀 全新智能跳过体验

  • 🎯 分:秒格式输入 - 更符合观影习惯,如 2:10 表示 2 分 10 秒
  • 自动跳过 - 无需手动点击,到达设定时间自动跳转
  • 🎭 智能片尾 - 可设置从指定时间直接跳转下一集
  • 🎨 优化布局 - 悬浮式配置显示,不与内容重叠

📱 使用方法

1. 开启跳过设置

在播放页面,点击标题右侧的 "跳过设置" 按钮

2. 智能配置模式(推荐)

全局开关

  • 启用自动跳过 - 到达时间自动跳转,无需手动点击
  • 片尾自动播放下一集 - 片尾时显示倒计时,自动播放下一集

片头设置

  • 开始时间: 0:00 (通常从视频开始)
  • 结束时间: 2:10 (跳过 2 分 10 秒的片头)

片尾设置

  • 开始时间: 19:20 (从 19 分 20 秒开始检测片尾)
  • 结束时间: 留空 (直接跳转下一集) 或 20:50 (跳过片尾到此时间)

3. 支持的时间格式

  • 分:秒格式: 2:10, 19:20, 1:30.5
  • 秒数格式: 130, 1160, 90.5
  • 自动识别: 系统会自动识别并转换格式

🎯 使用场景示例

场景一:跳过片头

片头设置:
开始时间: 0:00
结束时间: 2:10

效果: 视频开始播放时,自动从0秒跳转到2分10秒

场景二:片尾直接下一集

片尾设置:
开始时间: 19:20
结束时间: 留空

效果: 播放到19分20秒时,显示倒计时,自动播放下一集

场景三:跳过片头+片尾

片头: 0:00 → 2:10 (跳过片头)
片尾: 19:20 → 留空 (直接下一集)

效果: 完全自动化的观影体验

🎨 界面说明

播放时显示

  • 倒计时器: 片尾时屏幕中央显示"X 秒后自动播放下一集"
  • 跳过提示: 自动跳过时显示"自动跳过片头/片尾"
  • 取消按钮: 可随时取消自动操作

配置显示

  • 悬浮卡片: 右下角显示当前跳过配置
  • 状态标识: 显示自动跳过状态
  • 快速修改: 点击卡片可快速修改配置

⚙️ 高级功能

精确设置

  • 支持小数点精度: 90.5
  • 支持多段跳过: 可设置多个片头/片尾段落
  • 智能检测: 自动识别当前播放时间是否在跳过区间

数据同步

  • LocalStorage: 单设备本地存储
  • 云端同步: 支持 Redis、D1、Upstash 跨设备同步
  • 实时更新: 配置修改后立即生效

🔧 故障排除

常见问题

  1. 时间格式错误: 确保使用 分:秒 格式,如 2:10
  2. 配置不生效: 检查是否开启了"启用自动跳过"开关
  3. 重叠显示: 新版本已修复,配置卡片不会与内容重叠

兼容性

  • 支持所有部署方式 (Docker, Vercel, Cloudflare Pages)
  • 支持所有存储后端 (LocalStorage, Redis, D1, Upstash)
  • 支持桌面和移动设备

💡 使用技巧

  1. 首次设置: 建议先观看一遍内容,记录片头片尾时间
  2. 批量配置: 使用智能配置模式一次性设置片头和片尾
  3. 个性化: 不同类型的内容可以设置不同的跳过规则
  4. 测试验证: 设置后可以快进到设定时间测试效果

🎉 享受更流畅的观影体验!