feat: 云盘/下载音乐分离/粘性头部/播放状态同步/歌手关注

新增: - 音乐云盘页面(列表/详情弹窗/删除/存储空间, NOS multipart上传+LBS区域查询+进度事件) - 下载音乐页面(独立于本地音乐, 只显示应用下载的歌曲) - PageHeader粘性头部组件(IntersectionObserver控制显隐, 渐变模糊背景) - useLocalMusic composable(LocalSong类型/formatFileSize/localSongToSong/fetchMissingCovers) - 云盘上传完整流程(cloud_upload命令: check->token->LBS->NOS分块上传->info->publish) - 云盘API(user_cloud/user_cloud_detail/user_cloud_del) - 歌手关注/取关(artist_sub/artist_sublist命令, ArtistDetail关注按钮+artistSublist查询状态) - 本地音乐多文件夹扫描(scan_local_folders命令, settings.localMusicPaths, 模态框管理) - 侧边栏下载音乐和云盘导航项, 路由新增downloaded-music和cloud-music - md5 crate依赖改进: - 路由全部改为懒加载 - keep-alive缓存管理重写(30s TTL+导航栈保护+FavoriteSongs常驻+10s定时清理) - 播放器状态同步改为轮询isAudioPlaying(替代audio-started事件), 超时后watchForLatePlayback继续监听 - audio.rs新增is_playing原子状态+is_audio_playing命令 - 同步命令改async+spawn_blocking(list_local_songs/delete_local_song/check_local_song/get_default_download_path) - scan_dir_for_songs抽取为公共函数, 新增downloaded_only参数 - RoamDrawer tab状态从组件本地ref移至store(roamTab替换roamInitialTab) - App.vue onMounted改为非阻塞 - 多页面添加骨架屏加载态和加载失败重试 - 多页面使用PageHeader替代手动返回按钮 - PlaylistDetail/ArtistDetail添加简介弹窗(溢出时显示查看完整介绍) - Home推荐/排行榜拆分为独立fetch函数支持分别重试 - Toast去重(3s窗口)+数量限制(最多3条) - LocalMusic移除删除功能改文件夹模态框, ArtistDetail头像改圆形简介内嵌 - README重写修复: - 播放超时后后端实际开始播放但UI显示暂停(watchForLatePlayback+tick定期同步isAudioPlaying) - FM播放缺少playSeq竞态保护 - scrobble离线时仍发送(添加navigator.onLine检查) - RoamDrawer已打开时点击评论按钮无法切换(roamTab移至store) - 关闭RoamDrawer后再打开永远显示评论(closeRoamDrawer重置roamTab) - 歌手详情页关注状态离开后丢失(artist_detail不返回followed, 改用artistSublist查询) - audio-ended事件在切歌时误触发(新增_switchingSong标志拦截) - 路由beforeEach中localStorage key从user改为user_profile - toggle播放前先同步后端状态
2026-06-22 00:58:51 +08:00 · 2026-06-04 07:03:27 +08:00
parent e40f82cc51
commit 3535e2e8a0
30 changed files with 2516 additions and 782 deletions
--- a/README.md
+++ b/README.md
@ -1,126 +1,102 @@
+<div align="center">
+
 # Nekosonic

-一款轻量的跨平台音乐播放器，支持 Windows / Linux / macOS，音源源自网易云音乐。
+轻量跨平台桌面音乐播放器 · 网易云音乐

-## ✨ 特性
+[![Windows](https://img.shields.io/badge/Windows-0078D4?logo=windows11&logoColor=white)](https://github.com/atdunbg/Nekosonic-Music/releases)
+[![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black)](https://github.com/atdunbg/Nekosonic-Music/releases)
+[![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=white)](https://github.com/atdunbg/Nekosonic-Music/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

-### 播放
+[下载安装](https://github.com/atdunbg/Nekosonic-Music/releases)

- 🎵 在线音乐播放，流式缓冲边下边播
- 🎵 多音质选择（标准 / 较高 / 极高 HQ / 无损 SQ / Hi-Res）
- 🔄 播放模式切换（列表循环 / 随机播放 / 单曲循环）
- ⏯ 播放控制（播放 / 暂停 / 上一首 / 下一首 / 进度跳转 / 音量调节）
- 📋 播放队列管理（查看队列 / 移除歌曲 / 清空队列）
- 📻 私人漫游 FM（个性化推荐，VIP 试听自动跳过）
- 🎵 本地音乐播放（支持 mp3 / flac / wav / ogg / aac / m4a / wma / opus）
- 🔊 音频输出设备选择
- 🎧 系统媒体控制（蓝牙耳机/键盘媒体键/系统面板，支持 Linux / Windows / macOS）
+---

-### 发现与浏览
+</div>

- 🔍 关键词搜索歌曲 + 热门搜索标签
- 📋 歌单浏览（推荐歌单 / 排行榜 / 用户歌单 / 收藏歌单）
- 📋 歌单详情（歌曲列表 + 收藏 / 取消收藏 + 歌单评论）
- 🎤 歌手详情（热门歌曲 / 专辑 / 简介）
- 💿 专辑详情（歌曲列表 + 播放全部）
- 📅 每日推荐歌曲
+## 🎵 播放

-### 歌词与评论
+- 多音质选择（标准 / 较高 / HQ / SQ / Hi-Res）
+- 私人漫游 FM（个性化推荐）
+- 系统媒体控制集成（MPRIS / SMTC / Now Playing）
+- 音频输出设备选择

- 🎤 实时滚动歌词（自动滚动 / 点击跳转 / 渐变透明度）
- 🎤 歌词翻译显示
- 🎤 全屏漫游模式（大封面 + 歌词 / 评论双标签页）
- 💬 歌曲评论查看（热门评论 + 无限滚动加载 + 点赞）
+## 🔍 发现

-### 收藏与下载
+- 关键词搜索（歌曲 / 歌手 / 专辑）+ 搜索建议 + 热门搜索
+- 歌单浏览（推荐 / 排行榜 / 用户 / 收藏）
+- 歌手详情（热门歌曲 / 专辑 / 简介 + 关注）
+- 专辑详情
+- 每日推荐歌曲

- ❤️ 一键喜欢 / 取消喜欢（同步到网易云账号）
- ⬇️ 歌曲下载（带进度显示 / VIP 拦截 / 元数据保存）
- 🎵 本地音乐管理（列出 / 播放 / 删除 / 音频元数据与封面读取）
- 🕐 本地播放历史记录（最多 200 首）
+## 🎤 歌词与评论

-### 账号
+- 实时滚动歌词（ease-out 缓动 / 点击跳转 / 渐变透明度）
+- 歌词翻译
+- 全屏漫游模式（封面主色提取 + 歌词/评论双标签）
+- 歌曲评论（无限滚动 + 点赞）

- 🔴 网易云账号登录（二维码扫码 / 手机号密码）
- 🔑 登录态持久化（重启后自动恢复）
+## ❤️ 收藏与下载

-### 系统与设置
+- 一键喜欢 / 取消喜欢（同步到网易云账号）
+- 歌曲下载
+- 音乐云盘（上传 / 删除 / 详情 / 存储空间 / 上传进度）
+- 本地音乐（多文件夹扫描 / 封面补全）
+- 下载音乐（独立管理 / 删除）

- 📡 系统托盘（播放控制 / 显示窗口 / 退出）
- 🛡 单实例运行（防止重复启动）
- ⌨️ 自定义快捷键（应用内 + 系统全局）
- 🎨 多主题切换（天蓝 / 翠绿 / 玫红 / 紫罗兰 / 橙色 / 青色 / 粉色）
- ⚙️ 关闭窗口行为设置（每次询问 / 最小化到托盘 / 直接退出）
- 🔄 自动更新（启动静默检测 + 自定义弹窗 + 忽略版本 + 下载进度）
- 📝 更新日志查看
- 📶 网络状态检测（断网/恢复 Toast 提示 + 自动重试加载）
+## 🎨 个性化

-## 📦️ 安装
+- 多主题色（天蓝 / 翠绿 / 玫红 / 紫罗兰 / 橙色 / 青色 / 粉色）
+- 自定义快捷键（应用内 + 系统全局）
+- 关闭行为设置
+- 自动更新

-访问本项目的 [Releases](https://github.com/atdunbg/Nekosonic-Music/releases) 页面下载安装包。
+---

-## 💻 配置开发环境
+## 安装
+
+前往 [Releases](https://github.com/atdunbg/Nekosonic-Music/releases) 下载对应平台安装包。
+
+## 配置开发环境

 ```bash
-# 安装前端依赖
 npm install
-
-# 启动开发服务器
-npm run tauri dev
-
-# 构建发布
-npm run tauri build
+npm run tauri dev      # 开发
+npm run tauri build    # 构建
 ```

-### 环境要求
+> 环境要求：Node.js ≥ 18 · Rust ≥ 1.70 · Tauri CLI 2

- Node.js >= 18
- Rust >= 1.70
- Tauri CLI 2
-
-## 🛠 技术栈
+## 技术栈

 | 层级 | 技术 |
-|------|------|
+|:------|:------|
 | 桌面框架 | Tauri 2 |
-| 前端 | Vue 3 + TypeScript |
-| 样式 | Tailwind CSS v4 + CSS 变量主题系统 |
-| 状态管理 | Pinia |
-| 路由 | Vue Router 4 |
-| 音频解码 | symphonia + ringbuf (Rust) |
-| 媒体控制 | souvlaki (Linux MPRIS / Windows SMTC / macOS Now Playing) |
+| 前端 | Vue 3 + TypeScript + Pinia |
+| 样式 | Tailwind CSS v4 + CSS 变量主题 |
+| 音频解码 | symphonia + ringbuf |
+| 媒体控制 | souvlaki |
 | 网易云 API | ncm-api-rs |
-| 构建工具 | Vite 6 |
+| 构建 | Vite 6 |

-## ☑️ Todo
+## Todo

- [x] 评论系统
+- [x] 评论查看
 - [x] 歌曲下载
- [x] 本地音乐管理
+- [x] 本地音乐
 - [x] 歌手详情页
 - [x] 专辑详情页
 - [x] 自定义全局快捷键
 - [x] 自动更新
 - [x] 歌词翻译
 - [x] 更多主题
- [x] 系统媒体控制（蓝牙耳机/键盘媒体键）
+- [x] 音乐云盘
 - [ ] MV 播放
- [ ] 音乐云盘
 - [ ] 桌面歌词

 欢迎提 Issue 和 Pull request。

-## 📜 开源许可
+## 开源许可

-本项目仅供个人学习研究使用，禁止用于商业及非法用途。
-
-基于 [MIT license](https://opensource.org/licenses/MIT) 许可进行开源。
-
-## 致谢
-
- [ncm-api-rs](https://crates.io/crates/ncm-api-rs) — 网易云音乐 API 的 Rust 封装
- [Tauri](https://tauri.app/) — 跨平台桌面应用框架
- [Vue.js](https://vuejs.org/) — 渐进式 JavaScript 框架
- [Tailwind CSS](https://tailwindcss.com/) — 实用优先的 CSS 框架
- [symphonia](https://crates.io/crates/symphonia) — Rust 纯音频解码库
- [souvlaki](https://crates.io/crates/souvlaki) — 跨平台 OS 媒体控制库
+本项目仅供个人学习研究使用，禁止用于商业及非法用途。基于 [MIT License](https://opensource.org/licenses/MIT) 开源。