Add MusicWorkshop application

services/metadata/README.md

@@ -0,0 +1,89 @@
+# Metadata Services
+
+这个目录用来管理 `MusicWorkshop` 的第三方元数据代理，不改主项目前后端代码。
+
+当前默认地址：
+
+- 网易云：`http://127.0.0.1:3000`
+- QQ：`http://127.0.0.1:3300`
+
+这两个地址与后端默认配置保持一致，可直接填到设置页的 `metadata.netease` 和 `metadata.qq`。
+
+## 目录说明
+
+```text
+services/metadata/
+  README.md
+  versions.lock
+  config/services.env.example
+  scripts/
+  src/                # 第三方源码，已加入 .gitignore
+```
+
+运行时日志和 PID 会写到：
+
+```text
+.dev-runtime/metadata/
+```
+
+## 初始化
+
+先按需复制一份本地覆盖配置：
+
+```bash
+cd /home/liumangmang/GiteaRepos/LiuMangMang/MusicWorkshop/services/metadata
+cp config/services.env.example .env.local
+```
+
+然后执行初始化：
+
+```bash
+./scripts/bootstrap.sh
+```
+
+它会：
+
+- 在 `src/netease-api/` 准备一个本地 npm 工作区，并固定安装 `NeteaseCloudMusicApi`
+- 拉取 QQ 的第三方源码到 `src/qq-music-api/`
+- 将 QQ 固定到 `versions.lock` 中的 revision
+- 安装各自依赖
+- 为 QQ 服务补一个最小端口兼容补丁（仅当上游仍写死 `3200` 时）
+- 为 QQ 服务补一个 `/search` 兼容层，让返回结构对齐 `MusicWorkshop` 当前后端解析逻辑
+
+如果 `src/qq-music-api/` 里已经存在你自己的工作区，`bootstrap.sh` 会保留现状，只提示当前 revision 和锁定 revision 是否一致。
+
+## 启动与停止
+
+启动：
+
+```bash
+./scripts/start.sh
+```
+
+查看状态：
+
+```bash
+./scripts/status.sh
+```
+
+停止：
+
+```bash
+./scripts/stop.sh
+```
+
+## 设置页填写
+
+在 MusicWorkshop 设置页中填：
+
+- 网易云音乐 API：`http://127.0.0.1:3000`
+- QQ 音乐 API：`http://127.0.0.1:3300`
+
+保存后，前端会从“尚未检测”进入实际探测状态。
+
+## 上游来源
+
+- 网易云默认使用 npm 包 `NeteaseCloudMusicApi`，因为 GitHub 归档仓库主分支已被清空，只保留版权说明
+- QQ 默认使用 `Rain120/qq-music-api` 的固定 revision，因为当前后端已经兼容它的 `data.song.list` / `result.list`
+
+如果你要切换到自己的 fork，只需要改 `.env.local` 里的源类型和对应的 `*_REPO_URL` / `*_REF`。