README.md

🎵 Kiki音乐播放器

一个简洁美观的本地音乐播放器，支持Web浏览器和Windows桌面应用两种使用方式。

功能特点

• ✅ 支持多种音频格式（MP3, WAV, OGG, M4A等）
• ✅ 播放列表管理
• ✅ 播放/暂停控制
• ✅ 上一首/下一首切换
• ✅ 进度条拖拽控制
• ✅ 音量调节
• ✅ 时间显示
• ✅ 响应式设计，支持移动端
• ✅ 现代化UI界面
• ✅ 支持打包成Windows .exe桌面应用

使用方法

方式一：浏览器使用

1. 直接在浏览器中打开 index.html 文件
2. 点击"添加音乐"按钮选择本地音频文件
3. 在播放列表中点击任意歌曲开始播放
4. 使用控制按钮进行播放控制

方式二：桌面应用（.exe）

开发环境运行

1. 确保已安装 Node.js (版本 16 或更高)
2. 在项目目录下安装依赖：

   npm install

3. 运行应用：

   npm start

打包成.exe文件

1. 安装依赖（如果还没安装）：

   npm install

2. 打包Windows应用：

   npm run build-win

3. 打包完成后，在 dist 目录下会生成：

   • Kiki音乐播放器 Setup x.x.x.exe - 安装程序
   • Kiki音乐播放器 x.x.x.exe - 便携版（无需安装）

打包说明

• 打包需要一些时间，请耐心等待
• 首次打包会自动下载Electron相关文件
• 生成的.exe文件可以直接在Windows系统上运行
• 如果遇到打包问题，请确保网络连接正常

技术栈

• HTML5
• CSS3 (Grid布局、渐变效果)
• JavaScript (ES6+)
• Web Audio API
• Electron (桌面应用)

浏览器兼容性

支持所有现代浏览器：

• Chrome/Edge (推荐)
• Firefox
• Safari
• Opera

注意事项

• 由于浏览器安全限制，音频文件需要从本地文件系统选择
• 建议使用Chrome或Edge浏览器以获得最佳体验
• 支持同时添加多个音频文件到播放列表
• 桌面应用版本无需浏览器即可运行

未来改进

• 支持拖拽文件添加
• 播放模式切换（单曲循环、随机播放等）
• 歌词显示
• 播放历史记录
• 音频可视化效果

许可证

MIT License