Velune 是一款免费的无广告 YouTube Music 客户端，基于 Kotlin 与 Jetpack Compose 构建。除了在线听歌，它的音乐库还支持专辑封面墙、艺术家分类浏览和彩色标签整理，帮你把听过的歌曲管理得井井有条。本文带你快速上手 Velune 的本地音乐管理能力。

音乐库总览：一个入口管理所有歌曲

打开底部导航进入Library（音乐库），顶部会有一排筛选 Chips，可以在以下视图之间快速切换：

• 🎵Songs：全部歌曲列表
• 🎤Artists：按艺术家分组浏览
• 💿Albums：专辑封面墙
• 📁Playlists：播放列表集合

这套分类逻辑由 LibraryFilter.kt 中的枚举定义，界面实现见 LibraryScreen.kt。

专辑封面墙：按专辑整理你的收藏

进入 Albums 视图后，Velune 会以网格形式展示所有收藏过的专辑封面，支持下拉刷新和封面网格布局。每张专辑卡片背后对应一条本地数据库记录，保存了封面 URL、主题色、年份、曲目数和总时长等信息，定义见 AlbumEntity.kt。

专辑界面还支持排序与筛选，源码位于 LibraryAlbumsScreen.kt。配合 Material You 动态取色，专辑主题色会自动融入界面配色，浏览体验更沉浸。

💡 小技巧：长按专辑卡片可以加入播放列表、收藏或查看详情，方便把常听专辑快速归入歌单。

艺术家分类：按歌手维度浏览

Artists 视图会把同一位艺术家的歌曲聚合在一起，点击即可进入该艺术家的专辑页。艺术家实体同样记录在本地 Room 数据库中，并通过isLocal字段区分是否来自你的本地收藏，相关定义见 ArtistEntity.kt，界面实现在 LibraryArtistsScreen.kt。

如果你喜欢"先认准歌手、再听专辑"的整理习惯，这个视图能让整个曲库立刻变得有条理。

标签整理：给播放列表打上彩色标签 🏷️

当播放列表多了之后，最头疼的就是"这个列表是干嘛的"。Velune 内置了一套彩色标签系统，一站式搞定分类：

1. 创建标签：在标签管理弹窗中新增标签，可从 24 种预设颜色中挑选（如珊瑚红、薄荷绿、雾霾蓝），颜色常量定义在 TagEntity.kt
2. 分配标签：打开 AssignTagsDialog.kt 对应的分配界面，勾选要打的标签，还支持"反向操作"——把某个标签批量应用到多个播放列表
3. 标签筛选：回到 Library 顶部，彩色标签 Chips 会直接显示出来，点一下即可筛选出对应标签的所有列表

标签与播放列表是多对多关系，一张列表可以同时属于"通勤""跑步""专注"多个标签，实现灵活的交叉筛选。

本地歌曲与智能排序

Velune 采用离线优先设计，下载/缓存的歌曲都会标记为本地歌曲（isLocal字段），并记录年份、ID3 时间等元数据，模型定义见 SongEntity.kt。

在本地播放列表中，你可以选择多种排序方式（逻辑见 LocalPlaylistViewModel.kt）：

快速上手清单 📋

1. 进入Library，先浏览 Songs / Albums / Artists 三个视图，确认收藏内容齐全
2. 为常用播放列表创建 2～3 个带颜色的标签，习惯后逐步细分
3. 用顶部标签 Chips 验证筛选效果，建立自己的分类体系
4. 播放列表内切换"艺术家"排序，把同一歌手作品集中管理

Velune 把专辑封面、艺术家分类和标签整理做进了同一个音乐库入口，配合无广告播放与离线缓存，无论是在线听歌还是本地曲库管理，都能一站式搞定。更多界面截图可参考 screenshots/ 目录，功能特性说明见 README.md。