酷狗音乐第三方客户端MoeKoe Music使用指南：自动领取VIP+多平台支持

MoeKoe Music是一款现代化的酷狗音乐第三方客户端，支持Windows、macOS和Linux多平台，具有简洁美观的界面设计、Hi-Fi音质支持和每日自动领取VIP功能。本文详细介绍MoeKoe Music的主要特性、安装使用方法、开发部署指南以及常见问题解决方案。

MoeKoe Music简介

MoeKoe Music是一款开源、简洁、高颜值的跨平台音乐播放器，支持酷狗账号登录，提供歌词显示、每日推荐歌曲、主题色切换等实用功能。其最大亮点是每日自动领取VIP特权，让用户无需付费即可享受高品质音乐体验。

主要特性

• 现代化界面设计：简约而不简单的UI设计，提供流畅的用户体验
• Hi-Fi音质支持：支持高品质音频播放，享受极致音乐体验
• 主题切换功能：支持浅色/深色主题，并提供多种主题色彩选择
• 跨平台兼容性：完美运行于Windows、macOS和Linux系统
• 每日推荐歌曲：智能推荐算法，发现更多好音乐
• 无社交干扰：专注于音乐本身，无任何社交功能
• 官方服务器直连：直接连接酷狗官方服务器，无第三方API
• 自动领取VIP：每日自动领取VIP特权，登录即享VIP
• 启动问候语：个性化启动问候，增添使用乐趣
• 歌词显示功能：实时显示歌词，享受K歌体验

安装与使用

下载安装

1. 访问下载页面获取最新版本
2. 根据操作系统选择对应的安装包
3. 下载并安装应用程序

账号登录

首次启动时，建议登录酷狗账号以获得完整音乐体验：

1. 点击左侧菜单中的"登录"按钮
2. 使用酷狗账号密码或扫码登录
3. 登录成功后即可同步歌单和收藏

基本操作

• 搜索音乐：在顶部搜索栏输入关键词
• 播放控制：使用底部播放控制栏控制音乐播放
• 查看歌词：点击播放界面中的歌词图标
• 切换主题：在设置中调整界面主题
• 创建歌单：在"我的音乐"中创建和管理歌单

开发与部署

技术栈

• 前端框架: 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"应用已损坏"提示

解决方法：

1. 清除应用扩展属性：

   xattr -cr /Applications/MoeKoeMusic.app

2. 临时禁用Gatekeeper（仅测试用）：

   sudo spctl --master-disable

自动领取VIP问题

• 确保使用最新版本MoeKoe Music
• 尝试退出后重新登录
• 清除应用缓存后再次尝试
• 如问题持续，可能是官方政策限制

VIP歌曲播放问题

• 确认账号VIP权益是否有效
• 重新启动应用并重新登录
• 对于确实无法播放的VIP歌曲，可能需要使用官方应用

Windows7不兼容问题

MoeKoe Music已不再支持Windows7系统，建议升级到Windows10或更高版本。

开源项目地址

更新-内附苹果手机安装包，请不要升级，理论上每日签到可实现"永久VIP"

苹果手机客户端领取方法：

在右下角，我的>福利活动中心>天天签到领VIP

客户端安装软件下载