BiliMusic

项目概述

BiliMusic 想把 Bilibili 上数量庞大、标题杂乱、形态各异的音乐内容，整理成真正适合聆听的桌面音乐体验。它用 Electron 与 React 构建，会把视频标题清洗成适合搜歌词的关键词、把搜索结果组织成音乐列表、让 UP 主空间像音乐人主页一样浏览，界面则尽量向 Apple Music 的安静透亮质感靠拢。除常规桌面端外，它还包含鸿蒙 PC 的 Electron 工程。

把 B 站视频变成一座精致顺手的桌面音乐资料库。

主要功能

• 音乐搜索：支持视频搜索与用户搜索，结果以专辑/歌曲列表风格展示，可进入 UP 主空间继续浏览
• 推荐与发现：推荐页展示 B 站推荐音乐，发现页聚合音乐排行榜
• 桌面播放器：播放暂停、上下首、随机、循环、进度拖动、音量与静音，支持展开沉浸播放页
• 歌词匹配：清洗视频标题噪声、提取候选歌名、按相似度评分匹配歌词，支持手动搜索选版本
• 资料库：最近播放、我喜欢、自定义歌单、播放队列，支持导入导出歌单 JSON
• 托盘集成：关闭窗口最小化到托盘，托盘菜单与弹窗可直接控制播放
• 跨平台构建：提供 Windows、macOS、Linux 桌面安装包，以及鸿蒙 PC 的 HAP 构建准备

适用人群

• 常在 B 站听音乐、想要专门播放器的人
• 喜欢 Apple Music 界面质感的桌面用户
• 需要长期沉淀歌单与播放记录的用户
• 关注鸿蒙 PC 桌面应用生态的用户

快速上手

1. 安装 Node.js 20 或更高版本，执行 npm install 安装依赖
2. 运行 npm run dev 进入开发模式，或 npm run electron:start 构建后启动桌面端
3. 用 npm run electron:build 打包出对应平台的安装包
4. 在设置页扫码登录 B 站账号，随后即可搜索、收藏与建立歌单
5. 鸿蒙 PC 用户执行 npm run harmony:prepare 同步资源，再用 DevEco Studio 构建 HAP

核心优势

• 更像音乐 App：统一的 Apple Music 设计语言与细腻动效，而非网页播放器
• 标题智能清洗：自动去除视频标题噪声，显著提升歌词匹配命中率
• 资料库可沉淀：歌单、喜欢、最近播放与队列状态都会持久保存
• 深度桌面化：托盘控制、无边框窗口、沉浸播放与平台差异处理一应俱全

系统要求

项目	要求
操作系统	Windows、macOS、Linux；另含 HarmonyOS PC 工程
运行环境	Node.js 20 及以上、npm
打包环境	桌面打包需对应平台环境；鸿蒙构建需 DevEco Studio

注意事项

• 项目不内置任何音频、视频或歌词资源，播放内容来自 B 站
• 与 Bilibili、Apple Music 及 Apple Inc. 无任何从属或合作关系
• 歌词匹配依赖平台接口，部分视频标题不规范时可能匹配不准，可手动搜索
• 仅用于学习、研究与个人使用，请遵守相关平台服务条款与版权规定