BiliMusic：B站桌面音乐播放器

项目简介

BiliMusic 是一款基于 Electron + React 的桌面音乐播放器，目标不是简单播放 B 站视频，而是把 Bilibili 上松散、标题复杂的音乐内容整理成适合聆听的音乐资料库。界面参考 Apple Music 的玻璃拟态、沉浸背景与弹簧动效，同时在交互上保留桌面软件的效率。

项目还包含 platform/HarmonyOS 下的鸿蒙 PC Electron 工程，针对鸿蒙托盘、无边框窗口、原生三键等行为做了单独适配。

主要功能

• 搜索：支持 Bilibili 视频搜索与用户搜索，用户结果可进入 UP 主空间继续浏览；每条曲目支持播放、下一首播放、加入队列、添加至歌单。
• 推荐与发现：推荐页展示 Bilibili 推荐音乐内容，发现页聚合音乐排行榜等内容。
• 播放器：底部播放器提供播放/暂停、上下曲、随机、循环、进度拖动、音量与静音、打开队列、添加至歌单；展开后进入沉浸播放页，含大封面、动态背景、旋转唱片与歌词面板。
• 歌词匹配：先清洗视频标题噪声（官方 MV、完整版、翻唱、Live 等），提取书名号与引号中的候选歌名，生成多组搜索词并按相似度、歌手、专辑、时长评分，缓存匹配结果，也支持手动搜索歌词。
• 歌单与队列：可新建带名称和描述的歌单，从任意页面添加歌曲，歌单详情页支持播放全部、删除歌单、单曲或批量移出；播放队列支持加入歌单和批量移除。
• 资料库持久化：本地保存当前曲目、播放队列、播放进度、音量、随机/循环状态、最近播放、我喜欢、自定义歌单、歌词缓存、主题设置与登录用户信息，并支持歌单 JSON 导入导出。
• 桌面化：关闭窗口最小化到托盘，托盘菜单可控制播放；主进程代理 Bilibili 与歌词 API 请求。

安装与使用

环境要求：Node.js 20 或更高版本、npm。

npm install
npm run dev

构建与启动 Electron：

npm run build
npm run electron:start

打包桌面安装包（输出到 release/）：

npm run electron:build

已配置的打包格式：Windows 为 NSIS 安装包，macOS 为 DMG 与 ZIP，Linux 为 AppImage 与 DEB。

HarmonyOS PC

鸿蒙工程位于 platform/HarmonyOS。同步资源：

npm run harmony:prepare

构建 HAP：

npm run harmony:build

若命令行环境找不到 hvigor 或 hvigorw，可用 DevEco Studio 打开 platform/HarmonyOS，执行 Build -> Build Hap(s)/APP(s) -> Build Hap(s)。

注意事项

• 桌面打包需要对应平台环境；HarmonyOS PC 构建需要 DevEco Studio 和鸿蒙 Electron 工程环境。
• 项目仅用于学习、研究和个人使用，与 Bilibili、Apple Music、Apple Inc. 及相关服务提供方没有从属、授权或商业合作关系。
• 项目不内置任何音频、视频或歌词资源，请遵守相关平台服务条款、版权规定和当地法律法规。
• 路线图中的本地下载管理、多歌词源回退、迷你播放窗等功能尚未完成。

---

本作品整理自 GitHub 开源项目 HanversionOvO/BiliMusic，原作者 @HanversionOvO。中文介绍由 AI 根据项目 README 整理，以原仓库为准。