酷狗音乐第三方客户端MoeKoe Music使用指南：自动领取VIP+多平台支持 MoeKoe Music是一款现代化的酷狗音乐第三方客户端，支持Windows、macOS和Linux多平台，具有简洁美观的界面设计、Hi-Fi音质支持和每日自动领取VIP功能。本文详细介绍MoeKoe Music的主要特性、安装使用方法、开发部署指南以及常见问题解决方案。关于歌曲下载方式在文章底部值得珍藏下载无损音乐地址（每日更新）：https://zhzyk.vip/category/music/MoeKoe Music简介MoeKoe Music是一款开源、简洁、高颜值的跨平台音乐播放器，支持酷狗账号登录，提供歌词显示、每日推荐歌曲、主题色切换等实用功能。其最大亮点是每日自动领取VIP特权，让用户无需付费即可享受高品质音乐体验。要想正常听歌一定要登录酷狗账号、一定要登录酷狗账号、一定要登录酷狗账号（重要的事情说三遍！！！）{bilibili bvid="BV1gVoMYxE1R" page=""/}{mtitle title="更新说明"/}最新版：v1.6.1发布于 2026年3月26日更新说明What's Changed🔖 release: 周期性更新,非必要无需更新🐛 fix: 修复分享可能出现的异常🐛 fix: 修复事件处理函数参数，增加事件对象解构🚀 feat: 优化歌曲信息展示和样式🚀 feat: 优化播放逻辑 Closes #902🔥 remove: 删除无用代码🚀 feat: 增强插件能力v1.5.9 建议：登陆后/音乐库/vip签到，手动点一下vip签到 发布于 2026年2月6日🐛 fix 🔖 release: 修复VIP领取失败任务：更新子模块 APILinux: 跟进ARM64编译支持What's ChangedLinux: 跟进ARM64编译支持 by @LFRon in{dotted startColor="#ff6c6c" endColor="#1989fa"/}v1.5.8发布于 2026年2月4日💥 breaking: 重构目录结构🐛 fix: 修复掉登录问题⬆️ upgrade: 升级 API服务 V1.5.0✨feat: 添加 RPC 基础 URL 管理功能，支持自定义设置与测试连接🐛 fix: 优化设备信息管理，修复 dfid 获取逻辑feat: 🎸 macOS 状态栏歌词跑马灯支持与构建策略优化 (#823)🚀 perf: 优化插件系统🐛 fix: 移除播放兼容模式，Closes #817🚀 perf: 升级新的VIP接口 Closes #816, #820🐛 fix: 修复MV无法播放，Closes #804✨ feat: 添加音频输出设备选择功能✨ feat: 添加音频输出设备变化监听与麦克风权限请求功能发布版本 v1.5.7 修复风控问题 （已知问题：会强制退出登录）fix: open mv window for electron修复：打开 Electron 的 mv 窗口Squashed commit of the following:已取消以下提交：⬆️ upgrade: 升级 API服务谨慎升级 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 #711upgrade: 升级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 #19What's Changed📈 analytics: 增加issue验证条件，移除 PULL_REQUEST_TEMPLATE.md 填充 by @iAJue📈 analytics: 添加issue验证 by @iAJue✨ feat: 添加帮助链接功能 by @iAJueWhat'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.8What's Changed增加EdgeOne一键部署fix(PlayerControl): 添加音频加载失败时的重试机制feat(i18n): 添加音频加载失败的翻译文本fix: 修正http资源加载替换为https、接口图片域名不统一的问题 fixes #415fix: 移除Content-Security-Policy元标签perf: 优化音乐地址由http替换httpsfeat: 补充资源加载https协议feat: 更新自动启动设置功能，允许在保存设置时动态调整应用开机自启选项feat: implement MoeKoe Music Protocol and sharing functionality across the app增加歌曲列表网格模式更新mac主图标文件修复 随机播放显示异常&无效在设置中添加启动最小化选项并实现最小化启动应用的功能在设置中添加自动启动选项并实现登录时启动应用程序的功能节流桌面歌词拖动解决了因作者添加的文字描边导致的观感不佳What's Changedci: 添加 Docker 和 Docker Compose 配置以支持容器化部署docs: 在README.md中添加本地docker编译方式feat(PWA): 添加PWA支持以提升应用体验refactor: 优化Docker配置和README文档添加Touchbar控制及歌词显示客户端安装软件下载{anote icon="fa-download" href="https://pan.quark.cn/s/e6fc3b17cb5d" type="error" content="点此下载客户端"/}主要特性现代化界面设计：简约而不简单的UI设计，提供流畅的用户体验Hi-Fi音质支持：支持高品质音频播放，享受极致音乐体验主题切换功能：支持浅色/深色主题，并提供多种主题色彩选择跨平台兼容性：完美运行于Windows、macOS和Linux系统每日推荐歌曲：智能推荐算法，发现更多好音乐无社交干扰：专注于音乐本身，无任何社交功能官方服务器直连：直接连接酷狗官方服务器，无第三方API自动领取VIP：每日自动领取VIP特权，登录即享VIP启动问候语：个性化启动问候，增添使用乐趣歌词显示功能：实时显示歌词，享受K歌体验安装与使用下载安装访问下载页面获取最新版本根据操作系统选择对应的安装包下载并安装应用程序账号登录首次启动时，建议登录酷狗账号以获得完整音乐体验：点击左侧菜单中的"登录"按钮使用酷狗账号密码或扫码登录登录成功后即可同步歌单和收藏基本操作搜索音乐：在顶部搜索栏输入关键词播放控制：使用底部播放控制栏控制音乐播放查看歌词：点击播放界面中的歌词图标切换主题：在设置中调整界面主题创建歌单：在"我的音乐"中创建和管理歌单开发与部署技术栈前端框架: Vue 3构建工具: Vite桌面框架: Electron编程语言: JavaScript状态管理: PiniaUI组件库: 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"应用已损坏"提示在 macOS 系统上，当您下载并尝试打开 MoeKoe Music 时，可能会遇到系统提示应用"已损坏"或"无法打开"的问题。这通常是由于 macOS 的安全机制（Gatekeeper）阻止了未经苹果官方认证的应用运行所导致的。方法一：使用终端清除隔离属性（推荐）：清除应用扩展属性，在终端输入：xattr -cr /Applications/MoeKoeMusic.app注意：如果你把 MoeKoe Music 拖到了“应用程序”文件夹以外的位置，或者应用的名字不完全一样，需要把 /Applications/MoeKoeMusic.app 换成你电脑上对应的正确路径。 如果软件名不一样，请把 MoeKoeMusic.app 换成它准确的名字用双引号 " " 包住路径（推荐，最不容易出错代码如下）xattr -cr "/Applications/MoeKoe Music.app"📌 快捷技巧：不用手打路径在终端输入（注意最后有个空格）：xattr -cr 打开“访达” → “应用程序”文件夹 把 MoeKoe Music 的图标直接拖进终端窗口 终端会自动补全带正确转义的完整路径按下回车即可执行成功后不会有任何输出信息，但再次双击应用就能正常打开了。如果执行后还是提示找不到文件，可能是应用名字不完全匹配，可以在终端输入：'ls /Applications/ | grep MoeKoe' 查看一下确切的名字，再按上面的格式处理。第二种解决方法：临时禁用Gatekeeper（仅测试用），在终端输入以下命令并按回车（系统会提示你输入管理员密码）：sudo spctl --master-disable注意：输入密码时，屏幕上不会有任何显示，这是正常的，直接输入完按回车即可。点击屏幕左上角的苹果图标 -> 系统设置 -> 隐私与安全性。在这个页面的中间部分，往下滑，找到 “安全性” 这一栏。 允许一下来源应用程序里选择：任何来源。 操作完成后，务必立即重新打开安全设置，在终端中执行：sudo spctl --master-enable系统设置 -> 隐私与安全性。在这个页面的中间部分，往下滑，找到 “安全性” 这一栏。 允许一下来源应用程序里选择：任何来源，改回需要的安全设置自动领取VIP问题确保使用最新版本MoeKoe Music尝试退出后重新登录清除应用缓存后再次尝试如问题持续，可能是官方政策限制VIP歌曲播放问题确认账号VIP权益是否有效重新启动应用并重新登录对于确实无法播放的VIP歌曲，可能需要使用官方应用Windows7不兼容问题MoeKoe Music已不再支持Windows7系统，建议升级到Windows10或更高版本。开源项目地址更新-内附苹果手机安装包，请不要升级，理论上每日签到可实现"永久VIP"苹果手机客户端领取方法：在右下角，我的>福利活动中心>天天签到领VIP客户端安装软件下载{anote icon="fa-download" href="https://pan.quark.cn/s/e6fc3b17cb5d" type="error" content="点此下载客户端"/}歌曲下载汇总下载无损音乐歌曲【每日更新】⬇️https://zhzyk.vip/category/music/