酷狗音乐第三方客户端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="更新说明"/}{collapse}{collapse-item label="V1.6.8" open}🐛fix: 修复单行歌词动画不生效🚀 feat: 歌词字体设置功能，支持全屏歌词🎨 style: 调整样式🚀 feat: 添加返回顶部组件并移除旧的返回顶部按钮🚀 feat: 添加自定义页面滚动条组件,接管系统🎨 style: 重构推荐搜索界面样式🐛fix: 修复歌曲当前播放定位问题🚀 feat: 优化麦克风设备选择器🚀 feat: 添加各歌单骨架加载效果🎨 style: 添加歌词容器渐变效果和动态缩放动画🚀feat: 更新云盘歌曲列表显示逻辑🚀refactor: 重构播放列表相关逻辑，优化分页和数据加载处理🚀feat: 更改在线更新安装为静默安装模式{/collapse-item}{collapse-item label="V1.6.7"} 🚀perf: 优化声明组件，支持动态加载用户协议内容🚀perf: 调整骨架屏组件📝 docs: 新增更新日志链接🚀perf: 美化更新日志展示效果，支持跳转查看✨ feat: 添加独立桌面歌词字体设置 closes #1050🐛fix: 修复 PWA 可用性设置; 调整设置页面样式✨ feat: 优化右键菜单位置调整逻辑✨ feat: 添加歌词窗口的拖动和调整大小功能，优化整体交互体验🚀perf: 风险验证模块✨ feat: 添加风险验证模块，集成安全验证逻辑✨ feat: 添加背景图和装饰元素到识别页面，优化视觉效果🐛fix: 修复用户性别✨ feat: 添加听歌识曲功能🔄 update: 更新API V.5.1🎨 style: 更新多个视图和布局以支持粘性头部🎨 style: 调整歌单描述样式🐛 fix: 修复 watch 后台路由监听🎨 style: 调整登录页面样式🐛fix: 修复搜索页面监听缓存冲突问题fix: 修复暗黑模式下的样式问题feat: 优化原生右键菜单分组🐛 fix: 修复侧边栏在暗黑模式下的样式✨ feat: 增强虚表滚动性能，优化列表显示和缓冲逻辑🐛 fix: 修复弹窗层级问题🚀perf: 优化滚动位置恢复逻辑，优化页面体验✨ feat: 优化路由缓存和动画效果，提升页面切换体验✨ feat: 增强路由视图动画效果，优化页面切换体验🚀perf: 优化设置卡片开关体验{/collapse-item}{collapse-item label="v1.6.5"}发布于 2026年6月5日What's Changed🔖 release: 83周 V1.6.5 版本发布✨ feat: 添加新手引导功能，支持用户引导和操作提示🚀fix: 优化配置选项✨ feat: 添加对Web平台应用版本显示🚀fix: 优化SongQueue.js✨ feat: 增强本地音乐支持✨ feat: 添加文件夹历史记录功能，支持快速切换和删除历史记录✨ feat: 添加播放模式切换菜单feat: 增加顺序播放模式 (#1003)🐛 fix: 部分歌曲的歌词存在base64解码失败 closes #1001🚀fix: 优化页面切换样式🚀fix: 优化歌单专辑时间显示🐛 fix: 移除主窗口加载 Chrome 扩展的 DOM 准备事件监听器🚀fix: 优化桌面歌词设置持久化功能✨ feat: 添加自定义托盘菜单服务{/collapse-item}{/collapse}{collapse}{collapse-item label="v1.6.3"}发布于 2026年5月6日What's Changed🔖 release: V1.6.3 发布; 🎨 style: 增强暗黑模式下的样式，优化视觉效果🐛 fix: 修复日志导出无效🚀fix: 强化自动更新功能,支持多平台自动更新fix(settings): fix modal content max height over viewport (#966)🐛 fix: 修复桌面快捷方式重复创建 Closes #957🎨 style: 掺杂小私货♻️ refactor: 重构发现页模块代码结构🚀fix: 优化排名选择器，添加展开/收起功能并调整样式🚀fix: 添加通用骨架屏组件，优化加载效果✨ feat: 强化发现功能，支持多种类型feat(settings): add open log path and export log (#956)✨ feat: 强化搜索功能，支持综合/mv搜索类型✨ feat: 添加推荐搜索功能并更新设置选项💄 ui: 调整样式{/collapse-item}{collapse-item label="v1.6.2"}发布于 2026年4月22日🐛 fix: 修复部分歌曲重试失败 Closes #948🐛 fix: 修正启动页面设置导致白屏 Closes #945 Closes #949 Closes #950🚀fix: 使用环境变量的 PowerShell 路径🔖 release: V1.6.2 🤐猜猜我偷偷更新了什么✨ feat: 更新logo图标文件fix(settings): let meta key and numpad keys can be set to shortcut (#937)🚀 feat: 增强无版权收藏歌曲播放(#927)✨feat: 增加搜索页面原唱标志 Closes #934🚀 feat: 强化插件窗口验证ci(*): avoid to use deprecated keywords and actions (#931)🔧 chore: 更新依赖样式至本地 (Closes #933)💄 ui: 更新主题颜色和样式以提升用户界面一致性🚀 feat: 优化"我的喜欢"显示 (#576)✨feat: 添加启动页设置选项以增强用户体验⬆️ upgrade: 升级 API服务 V1.5.1refactor(styles): replace css to scss style sheet (#922)🐛 fix: 优化歌词获取逻辑，避免重复请求并处理过期请求 Closes #917📝 docs: 添加徽章以增强 README 文件的可视化效果{/collapse-item}{/collapse}{collapse}{collapse-item label="v1.6.1"}发布于 2026年3月26日更新说明What's Changed🔖 release: 周期性更新,非必要无需更新🐛 fix: 修复分享可能出现的异常🐛 fix: 修复事件处理函数参数，增加事件对象解构🚀 feat: 优化歌曲信息展示和样式🚀 feat: 优化播放逻辑 Closes #902🔥 remove: 删除无用代码🚀 feat: 增强插件能力{/collapse-item}{collapse-item label="v1.5.9"}建议：登陆后/音乐库/vip签到，手动点一下vip签到 发布于 2026年2月6日🐛 fix 🔖 release: 修复VIP领取失败任务：更新子模块 APILinux: 跟进ARM64编译支持What's ChangedLinux: 跟进ARM64编译支持 by @LFRon in{/collapse-item}{/collapse}{collapse}{collapse-item label="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: 添加音频输出设备变化监听与麦克风权限请求功能{/collapse-item}{collapse-item label="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{/collapse-item}{/collapse}{collapse}{collapse-item label="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{/collapse-item}{/collapse}{collapse}{collapse-item label="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{/collapse-item}{collapse-item label="v1.5.1"}📝docs: 更新自述文件图片 🔖 release:🐛 fix: 修复linux下托盘图标格式错误✨ feat: 新增插件系统✨ feat: 新增多网络架构概念（Multi-network Architecture）🚀 perf: 若桌面歌词超出屏幕重启将被重置🚀 perf: 优化设置界面，使其更加易用🚀 perf: 增加歌单上限至500个🚀 perf: 优化托盘图标显示🚀 perf: 优化Mac托盘图标，优化歌词乱码问题🐛 fix: 修复无歌词重复请求导致错误✨ feat: [Beta]新增支持播放本地音乐📝docs: General PR Template📝docs: 添加问题模板的检查项和说明{/collapse-item}{/collapse}{collapse}{collapse-item label="v1.5.0"}发布于 2025年8月7日调整empty 等相关样式增加歌词音译显示优化桌面歌词穿透问题增加阻止系统休眠选项优化最大自动切歌次数重构全局提示组件&登录页面优化云盘音乐相关问优化个人资料背景显示{/collapse-item}{collapse-item label="v1.4.8"}增加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控制及歌词显示{/collapse-item}{/collapse}客户端安装软件下载{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 打开“访达” → “应用程序”文件夹 （ 也可以在屏幕顶部的"访达"菜单栏里,找到并点击"前往",然后选择"应用程序"这时,会打开一个新的"应用程序"文件夹窗口。用鼠标按住这个app应用图标,将它从磁盘窗口拖拽到终端窗口里,松开鼠标即可。 ）把 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/