KatelyaTV/CHANGELOG.md

更新日志 (CHANGELOG)

本文档记录 KatelyaTV 项目的重要更新和功能变更。

[0.5.0] - 2025-09-02

🎉 新增功能

• ⏭️ 跳过片头片尾功能
  • 智能检测播放时间是否在跳过区间内
  • 支持手动设置片头、片尾跳过时间段
  • 播放时自动显示跳过按钮，8秒后自动隐藏
  • 每个用户可独立配置，支持跨设备同步
  • 完全兼容所有存储后端（LocalStorage、Redis、D1、Upstash）

🔧 技术改进

• 新增 SkipController 组件，提供完整的跳过功能界面
• 新增 SkipSegment 和 EpisodeSkipConfig 数据类型
• 扩展所有存储实现以支持跳过配置 CRUD 操作
• 新增 /api/skip-configs API 路由，支持服务端跳过配置管理
• 完善的类型定义和错误处理

🌐 部署兼容性

• ✅ Cloudflare Pages - Edge Runtime 完全兼容
• ✅ Docker 部署 - 自动 Runtime 转换，完全兼容
• ✅ Vercel 部署 - 自动适配，完全兼容
• ✅ 传统服务器 - Node.js Runtime，完全兼容
• ✅ 其他云平台 - 全面支持各种部署环境

📚 文档更新

• 更新 README.md，添加跳过功能介绍和使用教程
• 新增 DEPLOYMENT_COMPATIBILITY.md 部署兼容性说明
• 添加功能特性详细描述
• 完善环境变量和配置说明

🧪 测试验证

• 新增 test-docker-compatibility.js 兼容性测试脚本
• 验证所有 22 个 API 路由的 Edge Runtime 配置
• 确认所有存储后端的跳过配置功能支持

---

[0.4.0] - 之前版本

基础功能

• 🔍 多源聚合搜索
• 📺 高清视频播放
• ⭐ 收藏功能
• 📖 播放历史记录
• 👥 多用户支持
• 🐳 Docker 一键部署
• ☁️ 多平台部署支持
• 🌓 深色模式
• 📱 PWA 支持

---

版本说明

版本号规则

• 主版本号：重大功能更新或架构变更
• 次版本号：新功能添加或重要改进
• 修订版本号：Bug 修复和小幅优化

更新类型说明

• 🎉 新增功能 - 全新的功能特性
• 🔧 技术改进 - 代码优化、性能提升、架构改进
• 🌐 部署兼容性 - 部署方式和环境支持
• 📚 文档更新 - 文档完善和说明补充
• 🧪 测试验证 - 测试覆盖和质量保证
• 🐛 Bug 修复 - 问题修复和稳定性改进
• ⚡ 性能优化 - 响应速度和资源使用优化
• 🎨 界面改进 - UI/UX 优化和视觉改进

---

贡献指南

如果您想为项目贡献代码或反馈问题：

1. 提交 Issue - 报告 Bug 或提出功能建议
2. 发起 Pull Request - 贡献代码改进
3. 完善文档 - 帮助改进项目文档
4. 测试反馈 - 在不同环境下测试并反馈

感谢所有贡献者的支持！🙏