产品与能力

拼好歌由三个可以独立使用的部分组成：客户端负责界面与播放，服务端负责账号、同步与插件调度，插件运行时决定音源插件在哪里执行。三者之间通过 HTTP 接口解耦，你可以只用客户端，也可以把服务端部署在自己的 Cloudflare 账号下。

插件格式只支持一种：洛雪音乐（lx-music）的音源脚本。写法见音源插件使用教程。

客户端

一套代码，覆盖手机、平板与桌面

uni-app
Vue 3
Electron

Android 提供原生安装包，Windows / macOS / Linux 提供桌面安装包
iOS 与华为纯血鸿蒙通过微信小程序运行，无预编译安装包
后台播放、歌词、歌单管理、定时关闭与个性化设置
手机、平板、桌面共用同一套界面逻辑与数据模型

客户端文档

服务端

部署在你自己的 Cloudflare 账号下

Cloudflare Workers
D1
QuickJS（WASM）

账号体系、歌单与收藏同步、播放历史，数据只存在你自己的实例里
音源插件在服务端沙箱中执行，超时、并发与调度策略可调
自带管理后台：用户、邀请码、插件可见性与用量统计
Cloudflare 免费套餐即可运行，无需自购服务器与运维

服务端文档

插件运行时

本地运行，或交给专属服务器

本地运行
专属服务器
沙箱隔离

本地运行：仅 Android 与 Windows / macOS / Linux 可用，内置 QuickJS 引擎
专属服务器：所有平台可用，插件在 Workers 侧执行后再回传结果
iOS 与鸿蒙只能使用专属服务器模式，小程序环境不执行本机插件
插件由使用者自行提供，项目不内置、不附带、不分发任何插件

平台与运行模式

三种使用组合

组合	需要准备	适用场景
仅客户端	客户端 + 本地音源插件	单机使用，不需要多端同步
客户端 + 自建服务端	客户端 + 自己的 Workers 实例	需要账号体系与多端同步
服务端供多人使用	一个实例 + 邀请码	小范围共享同一份数据

第一种组合只依赖客户端本身，Android 与桌面端可以完整运行；第二种与第三种需要先完成服务端部署，iOS 与鸿蒙也必须走这条路径。

交付形态

形态	内容	获取方式
客户端安装包	Android APK、Windows / macOS / Linux 安装包	下载页
客户端源码	uni-app + Vue 3 工程，含 Electron 打包配置	见代码仓库
服务端源码	Cloudflare Workers 工程，含 D1 结构与后台页面	见代码仓库，自行部署
文档	使用、部署、平台差异与法务文档	本站

明确不提供的内容

以下边界与项目性质直接相关，请在使用前确认：

不提供音频内容：本项目是播放器工具与开发框架，不存储、不传输、不索引任何音频；
不提供插件：不内置、不附带、不推荐、不分发任何音源插件，插件由使用者自行提供并自行承担相应责任；
不提供托管服务：项目不运营任何面向公众的在线实例，服务端需由使用者自行部署与管理；
不提供付费服务：项目完全免费、非商业，不接受商业合作、广告投放与捐赠。

下一步

项目介绍与技术架构：两部分如何协作、请求链路怎么走
平台与运行模式：各平台怎么获取、插件在哪里执行
服务端部署使用教程：从 Fork 到域名绑定的完整步骤
下载：各平台安装包