MoeKoe Music是一款现代化的酷狗音乐第三方客户端，支持Windows、macOS和Linux多平台，具有简洁美观的界面设计、Hi-Fi音质支持和每日自动领取VIP功能。本文详细介绍MoeKoe Music的主要特性、安装使用方法、开发部署指南以及常见问题解决方案。
关于歌曲下载方式在文章底部
值得珍藏下载无损音乐地址（每日更新）：https://zhzyk.vip/category/music/
MoeKoe Music简介
MoeKoe Music是一款开源、简洁、高颜值的跨平台音乐播放器，支持酷狗账号登录，提供歌词显示、每日推荐歌曲、主题色切换等实用功能。其最大亮点是每日自动领取VIP特权，让用户无需付费即可享受高品质音乐体验。
要想正常听歌一定要登录酷狗账号、一定要登录酷狗账号、一定要登录酷狗账号（重要的事情说三遍！！！）
谨慎升级 v1.5.3 ，会导致 获取音乐失败
What's Changed
🔖 release: 发布v1.5.4(发布于 2025年12月6日)
- upgrade: 升级Dockerfile node版本 (#714)
- 🔥 remove: 移除不完全的HTTPS支持(ps:该更新可能引发安全问题)
- ✨ feat: 使用authorization认证
- ✨ feat: 增加数据源配置
- 🐛 fix: 修复登录后播放失败问题 ，Closes #708
- 修复ARM64架构下Linux无法编译API而引发应用编译失败 by @LFRon in #711
upgrade: 升级Dockerfile node版本 by @BIGMONK in #714
🔖 发布：发布 v1.5.3
升级：GitHub Actions Node.js 版本
✨feat: 优化全屏歌词动画 Closes #679
🐛 fix: 修复搜索页不显示歌名
🐛 fix: 修复外观模式自动切换问题，Closes #703
✨ feat: 优化进度条感知区域 Closes #695
✨feat: 支持本地音乐的扫描子目录 Closes #661
✨ feat: 优化快捷键点Closes #665
🐛 fix: 修复背景插件问题，Closes #655
✨ feat: 优化插件系统,支持快速安装
✨ feat: 支持设置代理访问
⬆️ upgrade: 升级 API服务 到 v1.3.9- 🔖 release: 发布v1.5.2
- ✨ feat: 支持调整桌面歌词窗口大小&新增一个Bug
- 🚀 perf: 桌面长歌词滚动效果 Closes #335
- 🐛 fix: 修复无歌词时不更新问题，Closes #624
- 🚀 perf: 优化添加到列表 Closes #643
- 🚀 perf: 优化界面激活逻辑 Closes #611
- 🚀 perf: 歌单跳转当前播放歌曲按钮优化 Closes #605
- ✨ feat: 添加一键播放 Closes #604
- 🐛 fix: 兼容自定义背景插件，Closes #626
- ✨ feat: 添加帮助链接功能
- 🗑️ cleanup: 移除示例插件
- 📈 analytics: 添加issue验证 (#586)
- 📈 analytics: 增加issue验证条件，移除 PULL_REQUEST_TEMPLATE.md 填充 (#581)
- ✨ feat: 新增SMTC协议时间轴信息支持 Closes #554
- ✨ feat: 新增榜单歌曲支持动态无限加载，Closes #521
- ✨ feat: 新增支持多账号绑定手机登录，Closes #19
What's Changed
- 📈 analytics: 增加issue验证条件，移除 PULL_REQUEST_TEMPLATE.md 填充 by @iAJue
- 📈 analytics: 添加issue验证 by @iAJue
✨ feat: 添加帮助链接功能 by @iAJue
What's Changed
- 📝docs: 更新自述文件图片 🔖 release: 发布v1.5.1
- 🐛 fix: 修复linux下托盘图标格式错误
- ✨ feat: 新增插件系统
- ✨ feat: 新增多网络架构概念（Multi-network Architecture）
- 🚀 perf: 若桌面歌词超出屏幕重启将被重置
- 🚀 perf: 优化设置界面，使其更加易用
- 🚀 perf: 增加歌单上限至500个
- 🚀 perf: 优化托盘图标显示
- 🚀 perf: 优化Mac托盘图标，优化歌词乱码问题
- 🐛 fix: 修复无歌词重复请求导致错误
- ✨ feat: [Beta]新增支持播放本地音乐
- 📝docs: General PR Template
- 📝docs: 添加问题模板的检查项和说明
v1.5.0
发布于 2025年8月7日
调整empty 等相关样式
增加歌词音译显示
优化桌面歌词穿透问题
增加阻止系统休眠选项
优化最大自动切歌次数
重构全局提示组件&登录页面
优化云盘音乐相关问
优化个人资料背景显示
发布于 2025年7月30日
更新说明
- ✨feat: 增加歌手单曲排序功能
- 🚀 perf: 优化播放随机逻辑，保证近10首不重复
- 🎨 style: 调整默认Banner
- 🐛 fix: 增加双重高亮计算机制，修复英文歌词高亮进度
- 🚀 perf: 优化桌面歌词显示和处理逻辑
- 🎨 style: 调整桌面歌词样式
- 🐛 fix: 原生窗口装饰器关闭键无效
- 📝 docs: 更新问题模板，增加社区交流链接和图标
- 🐛 fix: 修复音质不正确的问题。
- 🐛 fix: 多显示器下窗口位置错误
- ✨ feat: 增加Linux ARM64架构编译支持
- 📝 docs: 更新 README
- 🐛 fix: 修复云盘音乐播放失败
- 💄 style: 修改Mac下托盘图标样式
- 📝 docs: 我们也开始使用Gitmoji的风格了
- 🐛 fix: 修复歌单排序不同步
- ✨ feat: 新增用户详细信息展示
What's Changed
- 添加歌词翻译以及优化大屏歌词调整播放进度的行为。
- 增加ARM64架构编译支持
- 修复音质不正确的问题。
版本 1.4.8
What's Changed
增加EdgeOne一键部署
fix(PlayerControl): 添加音频加载失败时的重试机制
feat(i18n): 添加音频加载失败的翻译文本
fix: 修正http资源加载替换为https、接口图片域名不统一的问题 fixes #415
fix: 移除Content-Security-Policy元标签
perf: 优化音乐地址由http替换https
feat: 补充资源加载https协议
feat: 更新自动启动设置功能，允许在保存设置时动态调整应用开机自启选项
feat: implement MoeKoe Music Protocol and sharing functionality across the app
增加歌曲列表网格模式
更新mac主图标文件
修复 随机播放显示异常&无效
在设置中添加启动最小化选项并实现最小化启动应用的功能
在设置中添加自动启动选项并实现登录时启动应用程序的功能
节流桌面歌词拖动
解决了因作者添加的文字描边导致的观感不佳
What's Changed
- ci: 添加 Docker 和 Docker Compose 配置以支持容器化部署
- docs: 在README.md中添加本地docker编译方式
- feat(PWA): 添加PWA支持以提升应用体验
- refactor: 优化Docker配置和README文档
- 添加Touchbar控制及歌词显示
客户端安装软件下载
主要特性
- 现代化界面设计：简约而不简单的UI设计，提供流畅的用户体验
- Hi-Fi音质支持：支持高品质音频播放，享受极致音乐体验
- 主题切换功能：支持浅色/深色主题，并提供多种主题色彩选择
- 跨平台兼容性：完美运行于Windows、macOS和Linux系统
- 每日推荐歌曲：智能推荐算法，发现更多好音乐
- 无社交干扰：专注于音乐本身，无任何社交功能
- 官方服务器直连：直接连接酷狗官方服务器，无第三方API
- 自动领取VIP：每日自动领取VIP特权，登录即享VIP
- 启动问候语：个性化启动问候，增添使用乐趣
- 歌词显示功能：实时显示歌词，享受K歌体验
安装与使用
下载安装
- 访问下载页面获取最新版本
- 根据操作系统选择对应的安装包
- 下载并安装应用程序
账号登录
首次启动时，建议登录酷狗账号以获得完整音乐体验：
- 点击左侧菜单中的"登录"按钮
- 使用酷狗账号密码或扫码登录
- 登录成功后即可同步歌单和收藏
基本操作
- 搜索音乐：在顶部搜索栏输入关键词
- 播放控制：使用底部播放控制栏控制音乐播放
- 查看歌词：点击播放界面中的歌词图标
- 切换主题：在设置中调整界面主题
- 创建歌单：在"我的音乐"中创建和管理歌单
开发与部署
技术栈
- 前端框架: Vue 3
- 构建工具: Vite
- 桌面框架: Electron
- 编程语言: JavaScript
- 状态管理: Pinia
- UI组件库: Element Plus
环境准备
- Node.js (推荐v18.x或更高版本)
- npm (通常随Node.js一起安装)
- Git
获取源码
git clone https://github.com/iAJue/MoeKoeMusic.git
cd MoeKoeMusic
npm install本地开发
npm run dev构建应用
# 构建所有平台版本
npm run build
# 仅构建Windows版本
npm run build:win
# 仅构建macOS版本
npm run build:mac
# 仅构建Linux版本
npm run build:linux常见问题解决
macOS"应用已损坏"提示
解决方法：
清除应用扩展属性：
xattr -cr /Applications/MoeKoeMusic.app临时禁用Gatekeeper（仅测试用）：
sudo spctl --master-disable
自动领取VIP问题
- 确保使用最新版本MoeKoe Music
- 尝试退出后重新登录
- 清除应用缓存后再次尝试
- 如问题持续，可能是官方政策限制
VIP歌曲播放问题
- 确认账号VIP权益是否有效
- 重新启动应用并重新登录
- 对于确实无法播放的VIP歌曲，可能需要使用官方应用
Windows7不兼容问题
MoeKoe Music已不再支持Windows7系统，建议升级到Windows10或更高版本。
更新-内附苹果手机安装包，请不要升级，理论上每日签到可实现"永久VIP"
苹果手机客户端领取方法：
在右下角，我的>福利活动中心>天天签到领VIP
评论 (0)