koishi-plugin-music-to-voice 1.0.0 → 1.0.1

package/src/index.ts

@@ -1,516 +1,460 @@
-import { Context, Schema, Logger, h } from 'koishi'
-import axios from 'axios'
-import fs from 'node:fs'
-import path from 'node:path'
+import { Context, Schema, h, Logger, Session, isNullable } from 'koishi'
 import os from 'node:os'
+import fs from 'node:fs'
 import crypto from 'node:crypto'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
 
-export const name = 'music-voice-pro'
+export const name = 'music-to-voice'
 const logger = new Logger(name)
 
-type MusicSource = 'netease' | 'tencent' | 'kugou' | 'kuwo' | 'migu' | 'baidu'
+// ✅ 只声明可选依赖，不在后台日志刷屏
+export const inject = {
+  required: ['http', 'i18n'],
+  optional: ['puppeteer', 'downloads', 'ffmpeg', 'silk'],
+} as const
+
+// ✅ 提示放插件设置页，不要后台日志输出
+export const usage = `
+---
+
+本插件提供“点歌 → 列表选序号 → 发送语音/音频/文件”的音乐聚合能力。
+
+数据来源：**GD音乐台 API**（https://music-api.gdstudio.xyz/api.php）
+
+---
+
+## 开启插件前，请确保以下服务已经启用（可选安装）
+
+所需服务：
+
+- puppeteer 服务（可选安装，用于图片歌单）
+
+此外可能还需要这些服务才能发送语音（最稳：下载 + 转码）：
+
+- downloads 服务（可选安装）
+- ffmpeg 服务（可选安装，可能依赖 downloads）
+- silk 服务（可选安装）
+
+---
+`
+
+type MusicSource = 'netease' | 'tencent' | 'kugou' | 'kuwo' | 'migu'
+type SendAs = 'record' | 'audio' | 'file'
 
 export interface Config {
-  // 命令
   commandName: string
   commandAlias: string
 
-  // API
   apiBase: string
   source: MusicSource
   searchListCount: number
 
-  // 交互
-  waitForTimeout: number
+  imageMode: boolean
+  textColor?: string
+  backgroundColor?: string
+
   nextPageCommand: string
   prevPageCommand: string
   exitCommandList: string[]
   menuExitCommandTip: boolean
 
-  // 图片歌单（预留）
-  imageMode: boolean
-
-  // 发送类型
-  sendAs: 'record' | 'audio'
+  waitForTimeout: number
+  generationTip: string
 
-  // 转码与缓存
+  sendAs: SendAs
   forceTranscode: boolean
-  tempDir: string
-  cacheMinutes: number
-
-  // 提示与撤回
-  generationTip: string
-  recallSearchMenuMessage: boolean
-  recallTipMessage: boolean
-  recallUserSelectMessage: boolean
-  recallVoiceMessage: boolean
 
-  // 调试
-  loggerinfo: boolean
+  // 勾选=撤回/不保留
+  recallMenu: boolean
+  recallGeneratingTip: boolean
+  recallSongMessage: boolean
+  recallTimeoutTip: boolean
+  recallExitTip: boolean
+  recallInvalidTip: boolean
+  recallFetchFailTip: boolean
+
+  // 频率限制（可选）
+  enableRateLimit: boolean
+  rateLimitScope?: 'user' | 'channel' | 'platform'
+  rateLimitIntervalSec?: number
 }
 
-export const Config: Schema<Config> = Schema.object({
-  commandName: Schema.string().default('听歌').description('指令名称'),
-  commandAlias: Schema.string().default('music').description('指令别名'),
-
-  apiBase: Schema.string().default('https://music-api.gdstudio.xyz/api.php').description('音乐 API 地址（GD音乐台 API）'),
-  source: Schema.union([
-    Schema.const('netease').description('网易云'),
-    Schema.const('tencent').description('QQ音乐'),
-    Schema.const('kugou').description('酷狗'),
-    Schema.const('kuwo').description('酷我'),
-    Schema.const('migu').description('咪咕'),
-    Schema.const('baidu').description('百度'),
-  ]).default('netease').description('音源（下拉选择）'),
-  searchListCount: Schema.number().min(5).max(50).default(20).description('搜索列表数量'),
-
-  waitForTimeout: Schema.number().min(10).max(180).default(45).description('等待输入序号超时（秒）'),
-  nextPageCommand: Schema.string().default('下一页').description('下一页指令'),
-  prevPageCommand: Schema.string().default('上一页').description('上一页指令'),
-  exitCommandList: Schema.array(String).default(['0', '不听了', '退出']).description('退出指令列表'),
-  menuExitCommandTip: Schema.boolean().default(false).description('是否在歌单末尾提示退出指令'),
-
-  imageMode: Schema.boolean().default(false).description('图片歌单模式（可选：需要 puppeteer 插件，当前仅保留开关）'),
-
-  sendAs: Schema.union([
-    Schema.const('record').description('语音 record'),
-    Schema.const('audio').description('音频 audio'),
-  ]).default('record').description('发送类型'),
-
-  forceTranscode: Schema.boolean().default(true).description('是否强制转码为 silk（需要 ffmpeg + silk 插件）'),
-  tempDir: Schema.string().default(path.join(os.tmpdir(), 'koishi-music-voice')).description('临时目录'),
-  cacheMinutes: Schema.number().min(0).max(1440).default(120).description('缓存时长（分钟，0=不缓存）'),
-
-  generationTip: Schema.string().default('生成语音中...').description('用户选歌后提示'),
-
-  recallSearchMenuMessage: Schema.boolean().default(true).description('撤回：歌单消息'),
-  recallTipMessage: Schema.boolean().default(true).description('撤回：生成提示消息'),
-  recallUserSelectMessage: Schema.boolean().default(true).description('撤回：用户输入的序号消息'),
-  recallVoiceMessage: Schema.boolean().default(false).description('撤回：语音消息'),
-
-  loggerinfo: Schema.boolean().default(false).description('日志调试模式'),
-}).description('点歌语音（支持翻页 + 可选 silk/ffmpeg）')
-
-type SearchItem = {
+export const Config: Schema<Config> = Schema.intersect([
+  Schema.object({
+    commandName: Schema.string().default('听歌').description('指令名称'),
+    commandAlias: Schema.string().default('music2').description('指令别名（避免命令冲突）'),
+  }).description('基础设置'),
+
+  Schema.object({
+    apiBase: Schema.string().default('https://music-api.gdstudio.xyz/api.php').description('GD音乐台 API 地址'),
+    source: Schema.union([
+      Schema.const('netease').description('源1'),
+      Schema.const('tencent').description('源2'),
+      Schema.const('kugou').description('源3'),
+      Schema.const('kuwo').description('源4'),
+      Schema.const('migu').description('源5'),
+    ])
+      .default('kuwo')
+      .description('音源（下拉选择）'),
+    searchListCount: Schema.natural().min(5).max(50).default(20).description('每页显示条数'),
+  }).description('API 设置'),
+
+  Schema.object({
+    imageMode: Schema.boolean().default(false).description('图片歌单模式（需要 puppeteer，可选安装）'),
+    textColor: Schema.string().role('color').default('rgba(255,255,255,1)').description('图片歌单文字颜色'),
+    backgroundColor: Schema.string().role('color').default('rgba(0,0,0,1)').description('图片歌单背景颜色'),
+  }).description('歌单样式'),
+
+  Schema.object({
+    nextPageCommand: Schema.string().default('下一页').description('下一页指令'),
+    prevPageCommand: Schema.string().default('上一页').description('上一页指令'),
+    exitCommandList: Schema.array(Schema.string()).default(['0', '退出', '不听了']).description('退出指令列表'),
+    menuExitCommandTip: Schema.boolean().default(false).description('是否在歌单尾部提示退出指令'),
+    waitForTimeout: Schema.natural().min(5).max(180).default(45).description('等待输入序号超时（秒）'),
+    generationTip: Schema.string().default('生成语音中…').description('生成提示文本'),
+  }).description('交互设置'),
+
+  Schema.object({
+    sendAs: Schema.union([
+      Schema.const('record').description('语音 record'),
+      Schema.const('audio').description('音频 audio'),
+      Schema.const('file').description('文件 file'),
+    ])
+      .default('record')
+      .description('发送类型'),
+    forceTranscode: Schema.boolean()
+      .default(true)
+      .description('最稳模式：下载 + ffmpeg + silk 转码（可选依赖，缺依赖自动降级直链）'),
+  }).description('发送设置'),
+
+  Schema.object({
+    recallMenu: Schema.boolean().default(true).description('撤回歌单消息'),
+    recallGeneratingTip: Schema.boolean().default(true).description('撤回生成提示消息'),
+    recallSongMessage: Schema.boolean().default(false).description('撤回歌曲消息（语音/音频/文件）'),
+    recallTimeoutTip: Schema.boolean().default(true).description('撤回超时提示'),
+    recallExitTip: Schema.boolean().default(false).description('撤回退出提示'),
+    recallInvalidTip: Schema.boolean().default(false).description('撤回序号错误提示'),
+    recallFetchFailTip: Schema.boolean().default(true).description('撤回获取失败提示'),
+  }).description('撤回设置'),
+
+  Schema.object({
+    enableRateLimit: Schema.boolean().default(false).description('是否开启频率限制'),
+    rateLimitScope: Schema.union([
+      Schema.const('user').description('按用户'),
+      Schema.const('channel').description('按频道'),
+      Schema.const('platform').description('按平台'),
+    ]).default('user').description('限制范围'),
+    rateLimitIntervalSec: Schema.natural().min(1).max(3600).default(60).description('间隔秒数'),
+  }).description('频率限制'),
+])
+
+interface SongItem {
   id: string
   name: string
-  artist?: string
-  album?: string
+  artist: string
+  album: string
+  source: MusicSource
 }
 
-type PendingState = {
-  userId: string
-  channelId: string
-  guildId?: string
-
-  keyword: string
-  page: number
-  list: SearchItem[]
-  expiresAt: number
+// --------- 小工具 ---------
 
-  menuMessageId?: string
-  tipMessageId?: string
-  voiceMessageId?: string
+function artistsToString(x: any): string {
+  if (!x) return ''
+  if (Array.isArray(x)) return x.join(' / ')
+  return String(x)
 }
 
-function safeText(x: unknown): string {
-  return typeof x === 'string' ? x : x == null ? '' : String(x)
+async function safeDelete(session: Session, messageId?: string | null) {
+  if (!messageId) return
+  const channelId = session.channelId
+  if (!channelId) return
+  try {
+    await session.bot.deleteMessage(channelId, messageId)
+  } catch {}
 }
 
-function normalizeSearchList(data: any): SearchItem[] {
-  const arr: any[] =
-    Array.isArray(data) ? data
-      : Array.isArray(data?.result) ? data.result
-        : Array.isArray(data?.data) ? data.data
-          : Array.isArray(data?.songs) ? data.songs
-            : []
-
-  return arr.map((it: any) => {
-    const id = safeText(it?.id ?? it?.songid ?? it?.rid ?? it?.hash ?? it?.mid)
-    const name = safeText(it?.name ?? it?.songname ?? it?.title)
-    const artist =
-      safeText(it?.artist) ||
-      safeText(it?.singer) ||
-      safeText(it?.author) ||
-      (Array.isArray(it?.artists) ? it.artists.map((a: any) => safeText(a?.name)).filter(Boolean).join('/') : '')
-
-    const album = safeText(it?.album ?? it?.albummid ?? it?.albumname)
-    return { id, name, artist, album }
-  }).filter((x: SearchItem) => x.id && x.name)
+function buildRateKey(session: Session, scope: 'user' | 'channel' | 'platform') {
+  if (scope === 'platform') return session.platform
+  if (scope === 'channel') return `${session.platform}:${session.channelId ?? ''}`
+  return `${session.platform}:${session.userId ?? ''}`
 }
 
-function normalizeUrl(data: any): string {
-  return (
-    safeText(data?.url) ||
-    safeText(data?.data?.url) ||
-    safeText(data?.result?.url) ||
-    safeText(data?.data) ||
-    ''
-  )
+async function gdSearch(ctx: Context, config: Config, keyword: string, page: number): Promise<SongItem[]> {
+  const data = await ctx.http.get(config.apiBase, {
+    timeout: 15000,
+    params: { types: 'search', source: config.source, name: keyword, count: config.searchListCount, pages: page },
+    headers: { 'user-agent': 'koishi-music-to-voice' },
+  })
+  if (!Array.isArray(data)) return []
+  return data
+    .map((x: any) => ({
+      id: String(x.id ?? x.url_id ?? ''),
+      name: String(x.name ?? ''),
+      artist: artistsToString(x.artist),
+      album: String(x.album ?? ''),
+      source: String(x.source ?? config.source) as MusicSource,
+    }))
+    .filter((x: SongItem) => x.id && x.name)
 }
 
-function md5(s: string) {
-  return crypto.createHash('md5').update(s).digest('hex')
-}
+async function gdUrl(ctx: Context, config: Config, item: SongItem): Promise<string> {
+  const data = await ctx.http.get(config.apiBase, {
+    timeout: 15000,
+    params: { types: 'url', source: item.source || config.source, id: item.id },
+    headers: { 'user-agent': 'koishi-music-to-voice' },
+  })
 
-function ensureDir(p: string) {
-  fs.mkdirSync(p, { recursive: true })
+  if (typeof data === 'string') return data
+  if (data?.url) return String(data.url)
+  if (data?.data?.url) return String(data.data.url)
+  return ''
 }
 
-async function tryRecall(session: any, messageId?: string) {
-  if (!messageId) return
+async function downloadToTemp(ctx: Context, src: string): Promise<string | null> {
   try {
-    await session.bot.deleteMessage(session.channelId, messageId)
-  } catch {
-    // ignore
+    const file = await ctx.http.file(src)
+    const ext = '.mp3'
+    const fp = path.join(os.tmpdir(), `music_${crypto.randomBytes(8).toString('hex')}${ext}`)
+    fs.writeFileSync(fp, Buffer.from(file.data))
+    return fp
+  } catch (e) {
+    return null
   }
 }
 
-function hRecord(src: string) {
-  return h('record', { src })
-}
-
-function hAudio(src: string) {
-  return h('audio', { src })
-}
+async function tryTranscode(ctx: Context, localPath: string): Promise<string> {
+  // ✅ 完全可选：缺依赖就原样返回
+  const anyCtx = ctx as any
+  if (!anyCtx.ffmpeg || !anyCtx.silk) return localPath
 
-function buildMenuText(config: Config, keyword: string, list: SearchItem[], page: number) {
-  const lines: string[] = []
-  lines.push(`NetEase Music:`)
-  lines.push(`关键词：${keyword}`)
-  lines.push(`音源：${config.source}  第 ${page} 页`)
-  lines.push('')
-  for (let i = 0; i < list.length; i++) {
-    const it = list[i]
-    const meta = [it.artist, it.album].filter(Boolean).join(' - ')
-    lines.push(`${i + 1}. ${it.name}${meta ? ` -- ${meta}` : ''}`)
-  }
-  lines.push('')
-  lines.push(`请在 ${config.waitForTimeout} 秒内输入序号（1-${list.length}）`)
-  lines.push(`翻页：${config.prevPageCommand} / ${config.nextPageCommand}`)
-  if (config.menuExitCommandTip) {
-    lines.push(`退出：${config.exitCommandList.join(' / ')}`)
-  }
-  lines.push('')
-  lines.push('数据来源：GD音乐台 API')
-  return lines.join('\n')
-}
-
-async function apiSearch(config: Config, keyword: string, page = 1): Promise<SearchItem[]> {
-  const params = {
-    types: 'search',
-    source: config.source,
-    name: keyword,
-    count: config.searchListCount,
-    pages: page,
+  const wav = localPath.replace(/\.\w+$/, '') + '.wav'
+  const silk = localPath.replace(/\.\w+$/, '') + '.silk'
+  try {
+    await anyCtx.ffmpeg.convert(localPath, wav)
+    await anyCtx.silk.encode(wav, silk)
+    return silk
+  } catch {
+    return localPath
+  } finally {
+    try { fs.existsSync(wav) && fs.unlinkSync(wav) } catch {}
   }
-  const { data } = await axios.get(config.apiBase, { params, timeout: 15000 })
-  return normalizeSearchList(data)
-}
-
-async function apiGetSongUrl(config: Config, id: string): Promise<string> {
-  const params = { types: 'url', source: config.source, id }
-  const { data } = await axios.get(config.apiBase, { params, timeout: 15000 })
-  return normalizeUrl(data)
 }
 
-async function downloadToFile(url: string, filePath: string) {
-  const res = await axios.get(url, { responseType: 'stream', timeout: 30000 })
-  await new Promise<void>((resolve, reject) => {
-    const ws = fs.createWriteStream(filePath)
-    res.data.pipe(ws)
-    ws.on('finish', () => resolve())
-    ws.on('error', reject)
-  })
+async function renderListImage(ctx: Context, html: string): Promise<Buffer | null> {
+  const anyCtx = ctx as any
+  if (!anyCtx.puppeteer) return null
+  const page = await anyCtx.puppeteer.page()
+  await page.setContent(html)
+  const el = await page.$('#song-list')
+  if (!el) return null
+  const buf = (await el.screenshot({})) as Buffer
+  await page.close()
+  return buf
 }
 
-async function sendVoiceByUrl(session: any, config: Config, audioUrl: string) {
-  const seg = config.sendAs === 'record' ? hRecord(audioUrl) : hAudio(audioUrl)
-  const ids = await session.send(seg)
-  return Array.isArray(ids) ? ids[0] : ids
+function makeListText(config: Config, list: SongItem[], page: number) {
+  const start = (page - 1) * config.searchListCount
+  const lines = list.map((s, i) => `${start + i + 1}. ${s.name} -- ${s.artist}${s.album ? ' -- ' + s.album : ''}`)
+  let tail = `\n\n翻页：${config.prevPageCommand} / ${config.nextPageCommand}`
+  if (config.menuExitCommandTip && config.exitCommandList?.length) {
+    tail += `\n退出：${config.exitCommandList.join(' / ')}`
+  }
+  return `音乐列表：\n${lines.join('\n')}${tail}\n\n请在 ${config.waitForTimeout} 秒内输入序号：`
 }
 
-async function sendVoiceByFile(session: any, config: Config, absPath: string) {
-  const url = `file://${absPath.replace(/\\/g, '/')}`
-  const seg = config.sendAs === 'record' ? hRecord(url) : hAudio(url)
-  const ids = await session.send(seg)
-  return Array.isArray(ids) ? ids[0] : ids
-}
+// --------- 主逻辑 ---------
 
-/**
- * 可选：使用 Koishi 市场的 ffmpeg/silk 服务
- * 返回 silk 文件绝对路径；返回 null 表示无法转码（可降级直链）
- */
-async function buildSilkIfPossible(ctx: Context, config: Config, audioUrl: string, cacheKey: string): Promise<string | null> {
-  const hasFfmpeg = !!(ctx as any).ffmpeg
-  const hasSilk = !!(ctx as any).silk
-  if (!hasFfmpeg || !hasSilk) return null
+export function apply(ctx: Context, config: Config) {
+  // 频率限制记录
+  const lastUse = new Map<string, number>()
 
-  ensureDir(config.tempDir)
+  ctx.command(`${config.commandName} <keyword:text>`, '音乐聚合点歌并发送语音')
+    .alias(config.commandAlias)
+    .action(async (argv, keyword?: string) => {
+      const session = argv.session
+      const options = argv.options ?? {}
 
-  const silkPath = path.join(config.tempDir, `${cacheKey}.silk`)
-  if (config.cacheMinutes > 0 && fs.existsSync(silkPath)) {
-    return silkPath
-  }
+      // ✅ 解决 “session 可能为 undefined”
+      if (!session) return
+      keyword = (keyword ?? '').trim()
+      if (!keyword) return `用法：${config.commandName} 歌曲名`
 
-  const rawPath = path.join(config.tempDir, `${cacheKey}.src`)
-  await downloadToFile(audioUrl, rawPath)
+      // 频率限制（可选）
+      if (config.enableRateLimit) {
+        const scope = config.rateLimitScope ?? 'user'
+        const key = buildRateKey(session, scope)
+        const now = Date.now()
+        const last = lastUse.get(key) ?? 0
+        const interval = (config.rateLimitIntervalSec ?? 60) * 1000
+        if (now - last < interval) {
+          const remain = Math.ceil((interval - (now - last)) / 1000)
+          return `操作太频繁，请 ${remain} 秒后再试。`
+        }
+        lastUse.set(key, now)
+      }
 
-  const wavPath = path.join(config.tempDir, `${cacheKey}.wav`)
-  const ffmpeg: any = (ctx as any).ffmpeg
+      let page = 1
+      let menuMsgId: string | null = null
+
+      while (true) {
+        let list: SongItem[] = []
+        try {
+          list = await gdSearch(ctx, config, keyword, page)
+        } catch (e: any) {
+          logger.warn(`[search] ${String(e?.message || e)}`)
+          const ids = await session.send('搜索失败（API 不可用或超时），请稍后再试。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallFetchFailTip) await safeDelete(session, mid)
+          return
+        }
 
-  try {
-    if (typeof ffmpeg.convert === 'function') {
-      await ffmpeg.convert(rawPath, wavPath, {
-        format: 'wav',
-        audioChannels: 1,
-        audioFrequency: 24000,
-      })
-    } else if (typeof ffmpeg.exec === 'function') {
-      await ffmpeg.exec(['-y', '-i', rawPath, '-ac', '1', '-ar', '24000', wavPath])
-    } else {
-      throw new Error('ffmpeg service API not recognized')
-    }
-  } catch (e: any) {
-    throw new Error(`ffmpeg 转码失败：${e?.message || String(e)}`)
-  }
+        if (!list.length) {
+          const ids = await session.send('没有搜索到结果，请换个关键词试试。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallFetchFailTip) await safeDelete(session, mid)
+          return
+        }
 
-  const silk: any = (ctx as any).silk
-  try {
-    if (typeof silk.encode === 'function') {
-      await silk.encode(wavPath, silkPath, { rate: 24000 })
-    } else if (typeof silk.encodeWav === 'function') {
-      await silk.encodeWav(wavPath, silkPath, { rate: 24000 })
-    } else {
-      throw new Error('silk service API not recognized')
-    }
-  } catch (e: any) {
-    throw new Error(`silk 编码失败：${e?.message || String(e)}`)
-  } finally {
-    try { fs.unlinkSync(rawPath) } catch {}
-    try { fs.unlinkSync(wavPath) } catch {}
-  }
+        // 发送歌单（文本/图片）
+        if (menuMsgId && config.recallMenu) await safeDelete(session, menuMsgId)
+
+        if (config.imageMode) {
+          const text = makeListText(config, list, page).replace(/\n/g, '<br/>')
+          const html = `<!doctype html><html><head><meta charset="utf-8"/><style>
+            body{margin:0;background:${config.backgroundColor};color:${config.textColor};font-size:16px;}
+            #song-list{padding:18px;white-space:nowrap;}
+          </style></head><body><div id="song-list">${text}</div></body></html>`
+          const buf = await renderListImage(ctx, html)
+
+          if (!buf) {
+            const ids = await session.send('图片歌单生成失败：未安装 puppeteer 服务或其不可用。')
+            const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+            if (config.recallFetchFailTip) await safeDelete(session, mid)
+            return
+          }
+          const ids = await session.send([h.image(buf, 'image/png')])
+          menuMsgId = Array.isArray(ids) ? ids[0] : (ids as any)
+        } else {
+          const txt = makeListText(config, list, page)
+          const ids = await session.send(txt)
+          menuMsgId = Array.isArray(ids) ? ids[0] : (ids as any)
+        }
 
-  return silkPath
-}
+        // 等待输入
+        const input = await session.prompt(
+          (s) => {
+            // ✅ elements 可能 undefined
+            const els = s.elements ?? []
+            return h.select(els, 'text').join('')
+          },
+          { timeout: config.waitForTimeout * 1000 }
+        )
+
+        if (isNullable(input)) {
+          if (config.recallMenu) await safeDelete(session, menuMsgId)
+          const ids = await session.send('输入超时，已取消点歌。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallTimeoutTip) await safeDelete(session, mid)
+          return
+        }
 
-function logDepsHint(ctx: Context) {
-  const hasPuppeteer = !!(ctx as any).puppeteer
-  const hasFfmpeg = !!(ctx as any).ffmpeg
-  const hasSilk = !!(ctx as any).silk
-  const hasDownloads = !!(ctx as any).downloads
-
-  logger.info('开启插件前，请确保以下服务已经启用（可选安装）：')
-  logger.info(`- puppeteer服务（可选安装）：${hasPuppeteer ? '已检测到' : '未检测到'}`)
-  logger.info('此外可能还需要这些服务才能发送语音：')
-  logger.info(`- ffmpeg服务（可选安装）（此服务可能额外依赖downloads服务）：${hasFfmpeg ? '已检测到' : '未检测到'}`)
-  logger.info(`- silk服务（可选安装）：${hasSilk ? '已检测到' : '未检测到'}`)
-  logger.info(`- downloads服务（可选安装）：${hasDownloads ? '已检测到' : '未检测到'}`)
-  logger.info('Music API 出处：GD音乐台 API（https://music-api.gdstudio.xyz/api.php）')
-}
+        const text = String(input).trim()
+        if (!text) continue
 
-export function apply(ctx: Context, config: Config) {
-  if (config.loggerinfo) logger.level = Logger.DEBUG
-  logDepsHint(ctx)
+        // 退出
+        if (config.exitCommandList.includes(text)) {
+          if (config.recallMenu) await safeDelete(session, menuMsgId)
+          const ids = await session.send('已退出歌曲选择。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallExitTip) await safeDelete(session, mid)
+          return
+        }
 
-  const pending = new Map<string, PendingState>() // channelId -> state
+        // 翻页
+        if (text === config.nextPageCommand) {
+          page += 1
+          continue
+        }
+        if (text === config.prevPageCommand) {
+          page = Math.max(1, page - 1)
+          continue
+        }
 
-  function getKey(session: any) {
-    return String(session?.channelId || '')
-  }
+        // 序号
+        if (!/^\d+$/.test(text)) continue
+        const idx = parseInt(text, 10)
+        const start = (page - 1) * config.searchListCount
+        const local = idx - start - 1
+        if (local < 0 || local >= list.length) {
+          if (config.recallMenu) await safeDelete(session, menuMsgId)
+          const ids = await session.send('序号输入错误，已退出歌曲选择。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallInvalidTip) await safeDelete(session, mid)
+          return
+        }
 
-  function isExit(input: string) {
-    const t = input.trim()
-    return config.exitCommandList.map(s => s.trim()).includes(t)
-  }
+        const chosen = list[local]
 
-  function isExpired(state: PendingState) {
-    return Date.now() > state.expiresAt
-  }
+        // 生成提示
+        let tipMsgId: string | null = null
+        {
+          const ids = await session.send(config.generationTip)
+          tipMsgId = Array.isArray(ids) ? ids[0] : (ids as any)
+        }
 
-  async function refreshMenu(session: any, state: PendingState) {
-    const list = await apiSearch(config, state.keyword, state.page)
-    state.list = list
-    state.expiresAt = Date.now() + config.waitForTimeout * 1000
-
-    if (config.recallSearchMenuMessage) {
-      await tryRecall(session, state.menuMessageId)
-      state.menuMessageId = undefined
-    }
-
-    if (!config.recallSearchMenuMessage) {
-      const text = buildMenuText(config, state.keyword, list, state.page)
-      const ids = await session.send(text)
-      state.menuMessageId = Array.isArray(ids) ? ids[0] : ids
-    } else {
-      await session.send(`已翻到第 ${state.page} 页，请直接发送序号（1-${list.length}）`)
-    }
-  }
+        // 获取播放 URL
+        let playUrl = ''
+        try {
+          playUrl = await gdUrl(ctx, config, chosen)
+        } catch (e: any) {
+          logger.warn(`[url] ${String(e?.message || e)}`)
+        }
 
-  async function handlePick(session: any, state: PendingState, pickIndex: number) {
-    const item = state.list[pickIndex]
-    if (!item) {
-      await session.send(`序号无效，请输入 1-${state.list.length}，或输入 ${config.exitCommandList.join('/')} 退出。`)
-      return
-    }
-
-    // 提示：生成中...
-    let tipId: string | undefined
-    if (!config.recallTipMessage && config.generationTip?.trim()) {
-      const ids = await session.send(config.generationTip)
-      tipId = Array.isArray(ids) ? ids[0] : ids
-    }
-
-    // 取直链
-    let songUrl = ''
-    try {
-      songUrl = await apiGetSongUrl(config, item.id)
-      if (!songUrl) throw new Error('empty url')
-    } catch {
-      await session.send('获取歌曲直链失败，请稍后再试，或更换音源。')
-      return
-    }
-
-    const cacheKey = md5(`${config.source}:${item.id}`)
-    let voiceId: string | undefined
-
-    try {
-      const silkPath = await buildSilkIfPossible(ctx, config, songUrl, cacheKey)
-      if (silkPath) {
-        voiceId = await sendVoiceByFile(session, config, silkPath)
-      } else {
-        if (config.forceTranscode) {
-          await session.send(
-            `当前配置为【强制 silk 转码】但未检测到 ffmpeg/silk 服务。\n` +
-            `请在 Koishi 插件市场安装并启用：ffmpeg、silk（可能还需要 downloads）。`
-          )
+        if (!playUrl) {
+          if (config.recallGeneratingTip) await safeDelete(session, tipMsgId)
+          if (config.recallMenu) await safeDelete(session, menuMsgId)
+          const ids = await session.send('获取歌曲失败，请稍后再试。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallFetchFailTip) await safeDelete(session, mid)
           return
         }
-        voiceId = await sendVoiceByUrl(session, config, songUrl)
-      }
-    } catch (e: any) {
-      await session.send(`生成语音失败：${e?.message || String(e)}\n请检查 ffmpeg/silk 插件是否启用，或关闭“强制转码”。`)
-      return
-    } finally {
-      state.tipMessageId = tipId
-      state.voiceMessageId = voiceId
-    }
-
-    if (config.recallSearchMenuMessage) await tryRecall(session, state.menuMessageId)
-    if (config.recallTipMessage) await tryRecall(session, state.tipMessageId)
-    if (config.recallVoiceMessage) await tryRecall(session, state.voiceMessageId)
-
-    pending.delete(getKey(session))
-  }
 
-  // 主命令：听歌 关键词
-  ctx.command(`${config.commandName} <keyword:text>`, '点歌并发送语音（GD音乐台 API）')
-    .alias(config.commandAlias)
-    .action(async ({ session }, keyword) => {
-      if (!session) return
-      keyword = (keyword || '').trim()
-      if (!keyword) return `用法：${config.commandName} 歌曲名`
+        // 发送（转码可选）
+        try {
+          let finalSrc = playUrl
+
+          if (config.forceTranscode) {
+            const localPath = await downloadToTemp(ctx, playUrl)
+            if (localPath) {
+              const out = await tryTranscode(ctx, localPath)
+              finalSrc = pathToFileURL(out).href
+            }
+          }
+
+          // ✅ 不要用 `+` 拼 Element；直接发 Fragment 数组
+          let sendIds: any
+          if (config.sendAs === 'file') {
+            sendIds = await session.send([h.file(finalSrc)])
+          } else if (config.sendAs === 'audio') {
+            sendIds = await session.send([h.audio(finalSrc)])
+          } else {
+            sendIds = await session.send([h('record', { src: finalSrc })])
+          }
+
+          const songMsgId = Array.isArray(sendIds) ? sendIds[0] : sendIds
+          if (config.recallSongMessage) await safeDelete(session, songMsgId)
+        } catch (e: any) {
+          logger.warn(`[send] ${String(e?.message || e)}`)
+          const ids = await session.send('发送失败（可能缺少转码依赖或链接失效）。')
+          const mid = Array.isArray(ids) ? ids[0] : (ids as any)
+          if (config.recallFetchFailTip) await safeDelete(session, mid)
+        } finally {
+          if (config.recallGeneratingTip) await safeDelete(session, tipMsgId)
+          if (config.recallMenu) await safeDelete(session, menuMsgId)
+        }
 
-      // ✅ DTS 关键修复：强制确认 userId/channelId 存在
-      const userId = session.userId
-      const channelId = session.channelId
-      if (!userId || !channelId) {
-        await session.send('当前适配器未提供 userId/channelId，无法进入选歌模式。')
         return
       }
-
-      let list: SearchItem[] = []
-      try {
-        list = await apiSearch(config, keyword, 1)
-      } catch {
-        return '搜索失败（API 不可用或超时），请稍后再试。'
-      }
-      if (!list.length) return '没有搜到结果，换个关键词试试。'
-
-      const state: PendingState = {
-        userId,
-        channelId,
-        guildId: session.guildId,
-        keyword,
-        page: 1,
-        list,
-        expiresAt: Date.now() + config.waitForTimeout * 1000,
-      }
-
-      if (!config.recallSearchMenuMessage) {
-        const text = buildMenuText(config, keyword, list, 1)
-        const ids = await session.send(text)
-        state.menuMessageId = Array.isArray(ids) ? ids[0] : ids
-      } else {
-        await session.send(`已进入选歌模式，请直接发送序号（1-${list.length}），或发送“${config.nextPageCommand}/${config.prevPageCommand}”翻页。`)
-      }
-
-      pending.set(channelId, state)
     })
-
-  // 中间件：处理序号 / 翻页 / 退出
-  ctx.middleware(async (session, next) => {
-    const key = getKey(session)
-    if (!key) return next()
-
-    const state = pending.get(key)
-    if (!state) return next()
-
-    // 只允许发起者操作
-    if (session.userId !== state.userId) return next()
-
-    // 超时
-    if (isExpired(state)) {
-      pending.delete(key)
-      return next()
-    }
-
-    const content = (session.content || '').trim()
-    if (!content) return next()
-
-    // 退出
-    if (isExit(content)) {
-      if (config.recallSearchMenuMessage) await tryRecall(session, state.menuMessageId)
-      pending.delete(key)
-      if (!config.recallUserSelectMessage) await session.send('已退出选歌。')
-      return
-    }
-
-    // 下一页
-    if (content === config.nextPageCommand) {
-      if (config.recallUserSelectMessage) await tryRecall(session, session.messageId)
-      state.page += 1
-      try {
-        await refreshMenu(session, state)
-      } catch {
-        state.page -= 1
-        await session.send('翻页失败，请稍后再试。')
-      }
-      return
-    }
-
-    // 上一页
-    if (content === config.prevPageCommand) {
-      if (config.recallUserSelectMessage) await tryRecall(session, session.messageId)
-      if (state.page <= 1) {
-        await session.send('已经是第一页。')
-        return
-      }
-      state.page -= 1
-      try {
-        await refreshMenu(session, state)
-      } catch {
-        state.page += 1
-        await session.send('翻页失败，请稍后再试。')
-      }
-      return
-    }
-
-    // 序号
-    const n = Number(content)
-    if (!Number.isInteger(n) || n < 1 || n > state.list.length) return next()
-
-    if (config.recallUserSelectMessage) await tryRecall(session, session.messageId)
-    await handlePick(session, state, n - 1)
-  })
 }