Spotizerr 2.0 发布：Spotify/Deezer下载工具的重大架构升级

Spotizerr 是一个开源的 Spotify 和 Deezer 音乐下载工具，它允许用户通过简单的 Web 界面从这两个平台获取音乐资源。最新发布的 2.0 版本带来了多项重大改进，包括全新的监视列表功能、下载历史记录、重复下载预防机制等，同时对整个项目的架构进行了现代化改造。

核心功能升级

1. 监视列表(Watchlist)功能

监视列表是 2.0 版本中最引人注目的新特性。它允许用户：

• 持续追踪 Spotify 上的播放列表和艺术家
• 自动检测并下载新发布的音乐内容
• 通过专门的 /watchlist 页面管理所有监视项
• 配置个性化的监视参数，包括轮询间隔和艺术家专辑分组

技术实现上，后端新增了 /api/playlist/watch 和 /api/artist/watch 等 API 端点，采用定期轮询机制检查内容更新。这种设计既保证了实时性，又避免了过度请求导致的 API 限制问题。

2. 下载历史记录系统

新的历史记录功能为系统增加了持久化存储能力：

• 完整记录所有下载任务的状态（完成/错误/取消）
• 提供 /history 页面展示历史活动
• 支持分页、排序和过滤的 /api/history API 端点

这一功能不仅提升了用户体验，也为后续的统计分析奠定了基础。历史数据存储在专门的 data/history 目录中，确保了数据的持久性和可管理性。

3. 重复下载预防机制

系统现在能够智能识别并处理重复下载请求：

• 自动检测正在处理或排队中的相同任务
• 对于手动请求，返回明确的错误提示
• 对于监视列表触发的任务，自动跳过重复项

这一改进显著提升了系统效率，减少了不必要的资源消耗。

架构优化与技术改进

前端现代化改造

2.0 版本完成了前端代码向 TypeScript 的迁移，这一变化带来了：

• 更强的类型安全性
• 更好的代码可维护性
• 更高效的开发体验
• 新增的监视列表和历史记录页面

后端架构重构

后端服务进行了多项重要改进：

• API 端点结构优化，使用更规范的 RESTful 设计
• 配置管理系统重构，采用新的 ./data 目录结构
• Celery 任务日志集成到主应用日志系统
• 新增 Redis 数据清理定期任务

部署与配置变更

新版本引入了以下部署要求：

• 必须预先创建多个数据目录
• Docker 容器配置需要相应调整
• 配置文件位置变更为 ./data/config/main.json
• 构建过程现在需要 Node.js 环境

技术实现亮点

凭证验证机制

新增的凭证验证功能在用户添加或编辑 Spotify/Deezer 凭证时：

• 执行基本格式验证
• 尝试建立连接测试有效性
• 实现重试逻辑处理临时网络问题

这一改进大幅提升了系统的健壮性和用户体验。

日志系统增强

日志管理得到了显著改善：

• 解决了重复日志处理器问题
• 为每个任务生成独立的日志文件
• 统一了日志格式和存储位置

总结

Spotizerr 2.0 代表了该项目的一个重要里程碑。通过引入监视列表、历史记录等核心功能，以及全面的架构现代化改造，该项目在功能性、可靠性和可维护性方面都达到了新的高度。特别是 TypeScript 的引入和 API 设计的规范化，为未来的功能扩展奠定了坚实基础。

对于现有用户，升级到 2.0 版本需要注意目录结构和配置文件的变更，但这一过渡将为用户带来更稳定、更强大的音乐下载体验。新加入的自动化监视功能尤其适合那些希望第一时间获取喜爱艺术家新作品的音乐爱好者。