Update to v0.0.4: add aggregated plugins with API failover, update docs

This commit is contained in:
miao-moe
2026-06-20 12:31:39 +08:00
commit c6eeb253d0
14 changed files with 7890 additions and 0 deletions

42
README.md Normal file
View File

@@ -0,0 +1,42 @@
# Koneko API for QZ-Music
QZ Music v2/v3 音源插件集合。每个插件仅包含一个平台,官方搜索 + 多 API 音源自动测速容灾。
## 插件列表
| 文件 | 平台 | 版本 | 说明 |
|------|------|------|------|
| `Koneko_QQ音乐_v0.0.4.js` | QQ音乐 | 0.0.4 | 官方搜索 + 10路API音源容灾 |
| `Koneko_酷狗音乐_v0.0.4.js` | 酷狗音乐 | 0.0.4 | 官方搜索 + 8路API音源容灾 |
| `Koneko_酷我音乐_v0.0.4.js` | 酷我音乐 | 0.0.4 | 官方搜索 + 9路API音源容灾 |
| `Koneko_网易云音乐_v0.0.4.js` | 网易云音乐 | 0.0.4 | 官方搜索 + 6路API音源容灾 + Cookie全功能 |
| `Koneko_咪咕音乐_v0.0.4.js` | 咪咕音乐 | 0.0.4 | 官方搜索 + 8路API音源容灾 |
| `Koneko_GIT音源_v0.0.4.js` | GIT音源 | 0.0.4 | 纯音源 + 2路API音源容灾 |
## 环境变量
在 QZ Music 设置中配置环境变量,插件通过 `global.env` 读取:
| Key | 适用平台 | 说明 |
|-----|---------|------|
| `ceru_key` | 全部 | 聆澜音源API密钥可选 |
| `cookie` | 网易云 | 网易云Cookie用于搜索/每日推荐/私人FM/我喜欢的音乐等 |
| `playlist_url` | 网易云 | 网易云个人主页链接,用于获取个人歌单 |
## 音质标识
| ID | 显示 |
|----|------|
| `standard` | 标准音质 (128k) |
| `exhigh` | 高品音质 (320k) |
| `lossless` | 无损音质 (FLAC) |
| `hires` | Hi-Res |
## 容灾机制
`getUrl` 采用并发请求多个 API取第一个成功返回的 URL。聆澜 API 需要配置 `ceru_key`,未配置时自动跳过。
## 版权声明
本插件仅用于学习交流,不存储、不提供任何音乐文件。音乐版权归各平台所有。