TuneWeave

统一、可扩展的跨平台音乐 API，为不同音乐平台提供一致的访问接口。

TuneWeave 使用 Rust 构建，目标是在保持较小存储体积、较低运行占用和快速启动的同时，把不同音乐平台的检索、歌单、媒体解析和账户能力统一为稳定的 HTTP API。

统一资源引用、请求参数和响应模型目前连接网易云音乐、QQ 音乐、B 站、酷狗、咪咕、酷我与汽水音乐，并支持多账户、Uni Playlist 和播放失败后的跨平台资源回退。

快速开始

下载适合当前系统的预编译包并运行：

./tuneweave

Windows 使用：

tuneweave.exe

也可以从源码启动：

cargo run --release -p tuneweave-server --bin tuneweave

服务默认监听 127.0.0.1:7832。确认服务可用：

curl http://127.0.0.1:7832/healthz
curl http://127.0.0.1:7832/v1/platforms
curl http://127.0.0.1:7832/v1/capabilities

开发者文档

• 安装与配置
• HTTP API v1
• 登录与调用方托管凭证
• Uni Playlist
• 完整路由目录
• 版本下载清单

所有业务响应使用统一 JSON 包络。资源引用带有平台前缀，例如 netease:123456、qq:0039MnYb0qxYhV 和 bilibili:bvid:BV1xx411c7mD。调用方可通过 platform 选择内容或账户平台，通过 account 选择服务器托管账户，也可使用 X-TuneWeave-Credential 携带由调用方保存的登录凭证。

接口可用性应以运行实例返回的 /v1/capabilities 为准。媒体端点返回平台提供的 URL 和必要请求头；TuneWeave 不代理媒体内容。

许可证

TuneWeave 采用 MIT OR Apache-2.0 双许可证。第三方研究来源见 THIRD_PARTY_NOTICES.md。