mirror of
https://github.com/atdunbg/Nekosonic-Music.git
synced 2026-06-21 16:48:48 +08:00
Atdunbg
3535e2e8a0
新增: - 音乐云盘页面(列表/详情弹窗/删除/存储空间, 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播放前先同步后端状态
103 lines
2.8 KiB
Markdown
103 lines
2.8 KiB
Markdown
<div align="center">
|
||
|
||
# Nekosonic
|
||
|
||
轻量跨平台桌面音乐播放器 · 网易云音乐
|
||
|
||
[](https://github.com/atdunbg/Nekosonic-Music/releases)
|
||
[](https://github.com/atdunbg/Nekosonic-Music/releases)
|
||
[](https://github.com/atdunbg/Nekosonic-Music/releases)
|
||
[](https://opensource.org/licenses/MIT)
|
||
|
||
[下载安装](https://github.com/atdunbg/Nekosonic-Music/releases)
|
||
|
||
---
|
||
|
||
</div>
|
||
|
||
## 🎵 播放
|
||
|
||
- 多音质选择（标准 / 较高 / HQ / SQ / Hi-Res）
|
||
- 私人漫游 FM（个性化推荐）
|
||
- 系统媒体控制集成（MPRIS / SMTC / Now Playing）
|
||
- 音频输出设备选择
|
||
|
||
## 🔍 发现
|
||
|
||
- 关键词搜索（歌曲 / 歌手 / 专辑）+ 搜索建议 + 热门搜索
|
||
- 歌单浏览（推荐 / 排行榜 / 用户 / 收藏）
|
||
- 歌手详情（热门歌曲 / 专辑 / 简介 + 关注）
|
||
- 专辑详情
|
||
- 每日推荐歌曲
|
||
|
||
## 🎤 歌词与评论
|
||
|
||
- 实时滚动歌词（ease-out 缓动 / 点击跳转 / 渐变透明度）
|
||
- 歌词翻译
|
||
- 全屏漫游模式（封面主色提取 + 歌词/评论双标签）
|
||
- 歌曲评论（无限滚动 + 点赞）
|
||
|
||
## ❤️ 收藏与下载
|
||
|
||
- 一键喜欢 / 取消喜欢（同步到网易云账号）
|
||
- 歌曲下载
|
||
- 音乐云盘（上传 / 删除 / 详情 / 存储空间 / 上传进度）
|
||
- 本地音乐（多文件夹扫描 / 封面补全）
|
||
- 下载音乐（独立管理 / 删除）
|
||
|
||
## 🎨 个性化
|
||
|
||
- 多主题色（天蓝 / 翠绿 / 玫红 / 紫罗兰 / 橙色 / 青色 / 粉色）
|
||
- 自定义快捷键（应用内 + 系统全局）
|
||
- 关闭行为设置
|
||
- 自动更新
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
前往 [Releases](https://github.com/atdunbg/Nekosonic-Music/releases) 下载对应平台安装包。
|
||
|
||
## 配置开发环境
|
||
|
||
```bash
|
||
npm install
|
||
npm run tauri dev # 开发
|
||
npm run tauri build # 构建
|
||
```
|
||
|
||
> 环境要求：Node.js ≥ 18 · Rust ≥ 1.70 · Tauri CLI 2
|
||
|
||
## 技术栈
|
||
|
||
| 层级 | 技术 |
|
||
|:------|:------|
|
||
| 桌面框架 | Tauri 2 |
|
||
| 前端 | Vue 3 + TypeScript + Pinia |
|
||
| 样式 | Tailwind CSS v4 + CSS 变量主题 |
|
||
| 音频解码 | symphonia + ringbuf |
|
||
| 媒体控制 | souvlaki |
|
||
| 网易云 API | ncm-api-rs |
|
||
| 构建 | Vite 6 |
|
||
|
||
## Todo
|
||
|
||
- [x] 评论查看
|
||
- [x] 歌曲下载
|
||
- [x] 本地音乐
|
||
- [x] 歌手详情页
|
||
- [x] 专辑详情页
|
||
- [x] 自定义全局快捷键
|
||
- [x] 自动更新
|
||
- [x] 歌词翻译
|
||
- [x] 更多主题
|
||
- [x] 音乐云盘
|
||
- [ ] MV 播放
|
||
- [ ] 桌面歌词
|
||
|
||
欢迎提 Issue 和 Pull request。
|
||
|
||
## 开源许可
|
||
|
||
本项目仅供个人学习研究使用，禁止用于商业及非法用途。基于 [MIT License](https://opensource.org/licenses/MIT) 开源。
|