refactor(api)!: 平台 id 回退——joox/5sing/bili/apple 恢复全名，目录对齐 bd/mg

- 撤销 3381e9b/1b972ec 中 jx/5s/bl/ap 四个短码，恢复 joox/5sing/bili/apple；
  qian→bd、migu→mg 保留
- 目录与文件对齐保留的新 id：sdk/qian/→sdk/bd/、sdk/migu/→sdk/mg/、
  sdk/apis/qian.ts→bd.ts、migu.ts→mg.ts、src/http/migu-stream.ts→mg-stream.ts
  （规则改为「目录=对外 id」，聚合入口的模块变量同步更名；music.migu.cn 等域名、
  上游 music-lib 对照注释、miguGet 等功能标识符不动）
- 对外 id 全表：kw kg tx wy qs xm me qt lr mg bd joox 5sing bili apple

**破坏性变更**：joox/5sing/bili/apple 四平台的 URL、/sources 返回与
data/auth.json 凭据键恢复全名，已存短码键的登录态需重新登录。

验证：typecheck ✓、pnpm test 112/112 ✓

src/routes-login.ts

@@ -8,7 +8,7 @@ import * as qsPassport from '../sdk/qs/passport.ts'
 import * as biliAuth from '../sdk/bili/login.ts'
 import { status as xmStatus } from '../sdk/xm/index.ts'
 import { status as meStatus } from '../sdk/me/index.ts'
-import { status as qianStatus } from '../sdk/qian/index.ts'
+import { status as bdStatus } from '../sdk/bd/index.ts'
 import { status as jooxStatus } from '../sdk/joox/index.ts'
 import { status as appleStatus } from '../sdk/apple/index.ts'
 import { status as fivesingStatus } from '../sdk/5sing/index.ts'
@@ -425,10 +425,10 @@ export const loginRoutes = async(fastify) => {
 
   // ---------- 哔哩哔哩 ----------
 
-  fastify.post('/login/bl/qr', {
+  fastify.post('/login/bili/qr', {
     schema: {
       summary: '获取哔哩哔哩扫码登录二维码',
-      description: '用 B站 App 扫码后轮询 /login/bl/qr/check 完成登录。返回 key 需原样回传，qrimg 为 data URL 可直接展示。',
+      description: '用 B站 App 扫码后轮询 /login/bili/qr/check 完成登录。返回 key 需原样回传，qrimg 为 data URL 可直接展示。',
       tags: ['登录'],
     },
   }, async(_request, reply) => {
@@ -439,7 +439,7 @@ export const loginRoutes = async(fastify) => {
     }
   })
 
-  fastify.post('/login/bl/qr/check', {
+  fastify.post('/login/bili/qr/check', {
     schema: {
       summary: '轮询哔哩哔哩扫码状态',
       description: 'status：waiting 等待扫码 / scanned 已扫码待确认 / success 登录成功（自动保存凭据并返回账号资料）' +
@@ -455,10 +455,10 @@ export const loginRoutes = async(fastify) => {
     }
   })
 
-  fastify.delete('/login/bl', {
+  fastify.delete('/login/bili', {
     schema: { summary: '退出哔哩哔哩登录', tags: ['登录'] },
   }, async() => {
-    clearCredentials('bl')
+    clearCredentials('bili')
     return { logged: false }
   })
 
@@ -476,8 +476,8 @@ export const loginRoutes = async(fastify) => {
   fastify.get('/login/status', {
     schema: {
       summary: '查看登录状态',
-      description: 'wy 为实时校验（未登录或 cookie 失效返回 logged: false），kg/tx/bl 为已存凭据（含 VIP 等级与最近更新时间），' +
-        'qs/xm/me/lr/bd/jx/ap/5s 为已存凭据。',
+      description: 'wy 为实时校验（未登录或 cookie 失效返回 logged: false），kg/tx/bili 为已存凭据（含 VIP 等级与最近更新时间），' +
+        'qs/xm/me/lr/bd/joox/apple/5sing 为已存凭据。',
       tags: ['登录'],
     },
   }, async() => {
@@ -493,11 +493,11 @@ export const loginRoutes = async(fastify) => {
       xm: xmStatus(),
       me: meStatus(),
       lr: lrAuth.status(),
-      bl: biliAuth.status(),
-      bd: qianStatus(),
-      jx: jooxStatus(),
-      ap: appleStatus(),
-      '5s': fivesingStatus(),
+      bili: biliAuth.status(),
+      bd: bdStatus(),
+      joox: jooxStatus(),
+      apple: appleStatus(),
+      '5sing': fivesingStatus(),
     }
   })
 }

src/routes.ts

@@ -5,7 +5,7 @@
 
 import { notFound, upstream } from './http/api-error.ts'
 import { signStream } from './http/stream-sign.ts'
-import { registerMiguStream, takeMiguStream } from './http/migu-stream.ts'
+import { registerMiguStream, takeMiguStream } from './http/mg-stream.ts'
 import { getMusicInfo } from '../sdk/kg/musicInfo.ts'
 
 const QUALITIES = ['64k', '128k', '320k', 'flac', 'flac24bit']
@@ -300,8 +300,8 @@ export const musicRoutes = async(fastify: any) => {
     if (!ticket) throw notFound('解密票据不存在或已过期（请重新调用 /url/mg 取流）')
     // 流式下载 + 逐块解密：咪咕 Z3D 密钥流按 32 字节循环，块内保持全局偏移即可，
     // 避免把上百 MB 的 wav/flac 整段读进内存（httpFetch 有 64MB 缓冲上限）
-    const { miguZ3DStreamKey, isMiguAudioMagic } = await import('../sdk/migu/util.ts')
-    const { pipeDecryptedMiguStream, miguStreamContentType } = await import('./http/migu-stream.ts')
+    const { miguZ3DStreamKey, isMiguAudioMagic } = await import('../sdk/mg/util.ts')
+    const { pipeDecryptedMiguStream, miguStreamContentType } = await import('./http/mg-stream.ts')
     const streamKey = miguZ3DStreamKey(ticket.fileKey)
     reply.raw.writeHead(200, {
       'Content-Type': miguStreamContentType(ticket.url),
@@ -513,7 +513,7 @@ export const musicRoutes = async(fastify: any) => {
 
   const albumSchema = (withPage: boolean) => ({
     summary: '获取专辑详情与曲目列表',
-    description: '支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/jx/ap（见 /sources 的 album 能力位）。' +
+    description: '支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/joox/apple（见 /sources 的 album 能力位）。' +
       'kw 单页固定 1000 条、xm/me 固定 30 条、limit 不生效。',
     tags: ['歌手专辑'],
     params: params({
@@ -538,7 +538,7 @@ export const musicRoutes = async(fastify: any) => {
   fastify.get('/album/:source/search/:keyword', {
     schema: {
       summary: '搜索专辑',
-      description: '支持 kg/kw/tx/wy/mg/bd/jx/ap（见 /sources 的 albumSearch 能力位）。',
+      description: '支持 kg/kw/tx/wy/mg/bd/joox/apple（见 /sources 的 albumSearch 能力位）。',
       tags: ['歌手专辑'],
       params: params({ source: pSource('album.searchAlbum'), keyword: { type: 'string', description: '专辑名关键词', example: '魔杰座' } }),
       querystring: qs({ page: pPage, limit: pLimit }),
@@ -563,8 +563,8 @@ export const musicRoutes = async(fastify: any) => {
   fastify.get('/playlist/:source/search/:keyword', {
     schema: {
       summary: '搜索歌单',
-      description: '支持 kg/kw/tx/wy/mg/bd/jx/bl/5s/ap（见 /sources 的 playlistSearch 能力位）。' +
-        '部分平台该能力受限（如 bd 歌单搜索接口已下线、bl 需登录），失败时返回 502。',
+      description: '支持 kg/kw/tx/wy/mg/bd/joox/bili/5sing/apple（见 /sources 的 playlistSearch 能力位）。' +
+        '部分平台该能力受限（如 bd 歌单搜索接口已下线、bili 需登录），失败时返回 502。',
       tags: ['歌单'],
       params: params({ source: pSource('playlist.searchPlaylist'), keyword: { type: 'string', example: '华语' } }),
       querystring: qs({ page: pPage, limit: pLimit }),
@@ -586,7 +586,7 @@ export const musicRoutes = async(fastify: any) => {
   fastify.get('/playlist/:source/categories', {
     schema: {
       summary: '获取歌单分类',
-      description: '支持 kw/kg/tx/wy/mg/bd/jx/bl/5s/ap（见 /sources 的 playlistCategories 能力位）。',
+      description: '支持 kw/kg/tx/wy/mg/bd/joox/bili/5sing/apple（见 /sources 的 playlistCategories 能力位）。',
       tags: ['歌单'],
       params: params({ source: pSource('playlist.getCategories') }),
       response: responses('PlaylistCategoriesResult'),
@@ -630,8 +630,8 @@ export const musicRoutes = async(fastify: any) => {
 
   const playlistSchema = (withPage: boolean) => ({
     summary: '获取歌单详情与曲目列表',
-    description: 'id 为歌单 id 或链接（部分平台支持链接/裸 id，如 bl 的 season:<id>:<mid>:<bvid>、' +
-      'jx/bd/mg 的网页链接）。列表按 page/limit 切片（聚合接口自身分页的平台由平台决定）。',
+    description: 'id 为歌单 id 或链接（部分平台支持链接/裸 id，如 bili 的 season:<id>:<mid>:<bvid>、' +
+      'joox/bd/mg 的网页链接）。列表按 page/limit 切片（聚合接口自身分页的平台由平台决定）。',
     tags: ['歌单'],
     params: params({
       source: pSource('playlist'),
@@ -701,7 +701,7 @@ export const musicRoutes = async(fastify: any) => {
       schema: {
         summary: `解析${kind === 'song' ? '歌曲' : kind === 'album' ? '专辑' : '歌单'}链接`,
         description: '把平台链接（或裸 id）解析成结构化歌曲/曲目数据。支持平台见 /sources 的 parse 能力位；' +
-          '5s 歌曲/歌单、apple/bl/jx/bd/mg 三类、kw/kg/tx/wy 部分支持。',
+          '5sing 歌曲/歌单、apple/bili/joox/bd/mg 三类、kw/kg/tx/wy 部分支持。',
         tags: ['链接解析'],
         params: params({ source: pSource('parse.parseSong') }),
         body: parseBodySchema,

src/server.ts

@@ -49,7 +49,7 @@ const DOCS_PREFIX = '/docs'
 const API_TITLE = 'MusicServer 聚合音乐 API'
 const API_DESCRIPTION = '多平台音乐聚合接口：搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析。' +
   '支持 kw（酷我）/ kg（酷狗）/ tx（QQ音乐）/ wy（网易云）/ qs（汽水音乐）/ mg（咪咕）/ bd（千千）/ ' +
-  'jx / bl（哔哩哔哩）/ 5s / ap（Apple Music，仅试听）与有声平台 xm（喜马拉雅）/ me（猫耳FM）/ qt（蜻蜓FM）/ lr（懒人听书）。'
+  'joox / bili（哔哩哔哩）/ 5sing / apple（Apple Music，仅试听）与有声平台 xm（喜马拉雅）/ me（猫耳FM）/ qt（蜻蜓FM）/ lr（懒人听书）。'
 
 const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8'))