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

124 lines
3.3 KiB
Markdown

# 🎬 智能跳过功能使用指南
## ✨ 功能特色
### 🚀 全新智能跳过体验
- **🎯 分:秒格式输入** - 更符合观影习惯,如 `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. **测试验证**: 设置后可以快进到设定时间测试效果
---
🎉 **享受更流畅的观影体验!**