在线体验 | 下载 Windows 桌面端

一个现代化的纯前端音乐 APP ，可以在 CloudFlare Pages / Netlify / Vercel 上轻松部署，同时提供 Windows 桌面端。

后端基于 TuneHub API ，请多多支持后端项目原作者开发的 TuneFreeNext ，更强大、更好用。

1. 本项目仅供个人学习研究使用，禁止用于商业及非法用途。使用本项目所产生的一切后果由使用者自行承担，开发者不承担任何责任。
2. 本项目由目前最先进的多款 AI Agent 联合开发，99.9% 以上代码由 AI 生成。虽然经过多轮迭代和代码审查，且以 MIT 许可证完全开源，但无法为可靠性提供任何保证。
3. 我们承诺，本项目：不存储版权资源、不提供下载功能、不以任何形式盈利。
4. 在部分平台或服务器上部署此类项目，可能面临版权投诉，请遵守相关平台规则。

1. 受限于浏览器安全策略，部分资源无法在 https 生产环境中加载，但使用桌面端不受影响。
2. 我们暂未提供 Linux 或 Mac OS 的打包，但您可以使用 Tauri 自行打包和体验。
3. 本项目没有在非 Chrome 内核的浏览器上进行测试，不保证完全正常的显示效果。
4. 使用 Windows 桌面端需要 Webview2 支持，已知在 Windows 10（从版本 1803 开始）和更高版本的 Windows 上默认提供，如您使用其他 Windows 版本，请自行研究解决方案。

• 🔍 聚合搜索 - 支持网XX音乐、酷X音乐、QX音乐聚合搜索
• 📋 歌单管理 - 创建、导入、管理自定义歌单
• ❤️ 收藏功能 - 轻松收藏和管理喜爱的歌曲
• ⏰ 定时播放 - 睡眠定时器，支持自定义时长
• 🎨 响应式设计 - 完美适配 PC 和移动端
• 📱 PWA 支持 - 可安装为桌面/移动应用，支持媒体会话通知
• 💾 智能缓存 - 本地缓存歌曲信息，减少重复请求

应用支持 PWA (Progressive Web App)，具有以下特性：

• 可安装 - 在浏览器地址栏点击安装按钮，添加到桌面/启动器
• 离线支持 - Service Worker 缓存静态资源
• 媒体会话 - 在系统通知中心显示当前播放歌曲，支持控制播放

本项目已针对 Cloudflare Pages 进行了深度优化，支持边缘计算功能（User Management / History / Admin）。

• Cloudflare 账号
• Node.js 环境

在 Cloudflare Dashboard 中创建两个 KV Namespace：

• inspire-users
• inspire-history

或者使用 Wrangler CLI：

npx wrangler kv:namespace create USERS_KV
npx wrangler kv:namespace create HISTORY_KV

修改 wrangler.toml 文件，填入你的 KV ID：

[[kv_namespaces]]
binding = "USERS_KV"
id = "<YOUR_USERS_KV_ID>"

[[kv_namespaces]]
binding = "HISTORY_KV"
id = "<YOUR_HISTORY_KV_ID>"

[vars]
ADMIN_PASSWORD = "your_secure_password" # 用于管理后台 API

pnpm install
npx wrangler pages deploy .

部署到 Cloudflare 后，将自动启用以下功能：

• 👤 用户系统 - 注册/登录，数据存储在 KV
• 📜 播放记录 - 自动云端同步播放历史
• 🛡️ 管理接口 - 提供 RESTful API 管理用户数据

• Node.js v24.12.0
• pnpm 10.25.0

# 构建命令，产物位于 /dist
pnpm build