这个项目能做什么

PlaylistPillar 是一个以 Docker 为基础应用分发的自托管音乐目录引擎。其既定目标是将流媒体平台的播放列表转化为持久、可浏览的本地归档，同时保留播放列表的上下文，而非将曲目视为一次性文件。 核心方法 - 元数据优先归档：导出内容被描述为包含嵌入的 ID3 标签、专辑封面（JPEG/PNG）和发行年份信息，并对照 MusicBrainz 和 Discogs 等公开唱片数据库进行交叉引用。 - 结构保留：原始播放列表顺序、曲目元数据和封面艺术均被保留，因此即使曲目日后从流媒体服务中消失，本地副本仍会显示封面、艺术家、专辑和曲目编号。 - 播放列表差异引擎：可重新扫描先前归档的播放列表，以查看自上次导出以来哪些曲目被移除、添加或更改。 部署与界面 - Docker 原生：通过单个 compose.yaml 配置即可在任何 Docker 环境中运行，无需描述系统级依赖。 - 响应式 Web 仪表板：可从任何设备管理归档、查看存储使用情况并浏览导入的播放列表。 - 多语言界面：仪表板和导出日志提供英语、西班牙语、法语、德语、日语和葡萄牙语版本。 - 后台工作器：队列中的播放列表以限速、重试和进度跟踪的方式处理，不会阻塞浏览器会话。 导出与存储详情 - 导出格式：结构化文件夹（艺术家 / 专辑 / 曲目.mp3）或带有嵌入元数据的单个压缩 .pillar 捆绑包。 - README 中给出的存储估算：320 kbps 下每小时音乐约 80-120 MB，每张专辑封面额外 1-3 MB；一个 50 首歌曲的播放列表通常占用 300-450 MB。 - 技术说明：令牌桶请求排队，默认使用 SQLite，可选 PostgreSQL，专辑封面压缩为 WebP 并带 PNG 回退，SHA-256 校验和记录在侧车清单中用于完整性验证。 入门指南 1. 配置环境：提供可选的流媒体平台 API 令牌以加速元数据增强，并在 compose.yaml 中设置存储卷。 2. 启动仪表板，然后粘贴播放列表链接或上传包含 URL 的 .txt 文件。 3. 系统在后台处理曲目，保留封面和元数据，并在归档就绪时通过仪表板通知。 仓库布局 README 描述了后端（Python、Flask + Celery），包含工作器、模型和元数据增强器；Vue.js 前端，包含组件和区域设置文件；Docker 文件；文档；测试；以及 MIT 许可证。 2026 年路线图中提到的项目包括批量导入向导、用于流派和情绪建议的离线 AI 标签、每周自动播放列表镜像，以及移动配套应用。 支持与合规性 README 宣传了一个诊断模块，可生成包含配置、日志、容器健康和网络状态的支持就绪快照，并声称典型响应时间低于两小时，工作时间内提供实时聊天。它还声明 API 令牌使用 AES-256 静态加密，且从不记录，匿名公共元数据查询是一个选项。免责声明指出该项目旨在用于个人归档用途，不绕过地理限制、DRM 或订阅层级，用户有责任遵守集成平台的服务条款。