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

package/dist/index.mjs

@@ -1,344 +1,306 @@
 // src/index.ts
-import { Schema, h, Logger, isNullable } from "koishi";
-import os from "os";
+import { Schema, h, Logger } from "koishi";
 import fs from "fs";
-import crypto from "crypto";
 import path from "path";
-import { pathToFileURL } from "url";
+import os from "os";
+import crypto from "crypto";
+import { spawn } from "child_process";
 var name = "music-to-voice";
 var logger = new Logger(name);
 var inject = {
-  required: ["http", "i18n"],
-  optional: ["puppeteer", "downloads", "ffmpeg", "silk"]
+  optional: ["downloads", "ffmpeg", "silk", "puppeteer"]
 };
 var usage = `
----
-
-\u672C\u63D2\u4EF6\u63D0\u4F9B\u201C\u70B9\u6B4C \u2192 \u5217\u8868\u9009\u5E8F\u53F7 \u2192 \u53D1\u9001\u8BED\u97F3/\u97F3\u9891/\u6587\u4EF6\u201D\u7684\u97F3\u4E50\u805A\u5408\u80FD\u529B\u3002
+### \u70B9\u6B4C\u8BED\u97F3\uFF08\u652F\u6301\u7FFB\u9875 + \u53EF\u9009 silk/ffmpeg\uFF09
 
-\u6570\u636E\u6765\u6E90\uFF1A**GD\u97F3\u4E50\u53F0 API**\uFF08https://music-api.gdstudio.xyz/api.php\uFF09
+\u5F00\u542F\u63D2\u4EF6\u524D\uFF0C\u8BF7\u786E\u4FDD\u4EE5\u4E0B\u670D\u52A1\u5DF2\u7ECF\u542F\u7528\uFF08\u53EF\u9009\u5B89\u88C5\uFF09\uFF1A
 
----
+- **puppeteer \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF09**
 
-## \u5F00\u542F\u63D2\u4EF6\u524D\uFF0C\u8BF7\u786E\u4FDD\u4EE5\u4E0B\u670D\u52A1\u5DF2\u7ECF\u542F\u7528\uFF08\u53EF\u9009\u5B89\u88C5\uFF09
+\u6B64\u5916\u53EF\u80FD\u8FD8\u9700\u8981\u8FD9\u4E9B\u670D\u52A1\u624D\u80FD\u53D1\u9001\u8BED\u97F3\uFF1A
 
-\u6240\u9700\u670D\u52A1\uFF1A
+- **ffmpeg \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF09**\uFF08\u6B64\u670D\u52A1\u53EF\u80FD\u989D\u5916\u4F9D\u8D56 **downloads** \u670D\u52A1\uFF09
+- **silk \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF09**
 
-- puppeteer \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF0C\u7528\u4E8E\u56FE\u7247\u6B4C\u5355\uFF09
-
-\u6B64\u5916\u53EF\u80FD\u8FD8\u9700\u8981\u8FD9\u4E9B\u670D\u52A1\u624D\u80FD\u53D1\u9001\u8BED\u97F3\uFF08\u6700\u7A33\uFF1A\u4E0B\u8F7D + \u8F6C\u7801\uFF09\uFF1A
-
-- downloads \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF09
-- ffmpeg \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF0C\u53EF\u80FD\u4F9D\u8D56 downloads\uFF09
-- silk \u670D\u52A1\uFF08\u53EF\u9009\u5B89\u88C5\uFF09
-
----
+> \u672C\u63D2\u4EF6\u4F7F\u7528\u97F3\u4E50\u805A\u5408\u63A5\u53E3\uFF08GD\u97F3\u4E50\u53F0 API\uFF09\uFF1Ahttps://music-api.gdstudio.xyz/api.php
 `;
-var Config = Schema.intersect([
-  Schema.object({
-    commandName: Schema.string().default("\u542C\u6B4C").description("\u6307\u4EE4\u540D\u79F0"),
-    commandAlias: Schema.string().default("music2").description("\u6307\u4EE4\u522B\u540D\uFF08\u907F\u514D\u547D\u4EE4\u51B2\u7A81\uFF09")
-  }).description("\u57FA\u7840\u8BBE\u7F6E"),
-  Schema.object({
-    apiBase: Schema.string().default("https://music-api.gdstudio.xyz/api.php").description("GD\u97F3\u4E50\u53F0 API \u5730\u5740"),
-    source: Schema.union([
-      Schema.const("netease").description("\u6E901"),
-      Schema.const("tencent").description("\u6E902"),
-      Schema.const("kugou").description("\u6E903"),
-      Schema.const("kuwo").description("\u6E904"),
-      Schema.const("migu").description("\u6E905")
-    ]).default("kuwo").description("\u97F3\u6E90\uFF08\u4E0B\u62C9\u9009\u62E9\uFF09"),
-    searchListCount: Schema.natural().min(5).max(50).default(20).description("\u6BCF\u9875\u663E\u793A\u6761\u6570")
-  }).description("API \u8BBE\u7F6E"),
-  Schema.object({
-    imageMode: Schema.boolean().default(false).description("\u56FE\u7247\u6B4C\u5355\u6A21\u5F0F\uFF08\u9700\u8981 puppeteer\uFF0C\u53EF\u9009\u5B89\u88C5\uFF09"),
-    textColor: Schema.string().role("color").default("rgba(255,255,255,1)").description("\u56FE\u7247\u6B4C\u5355\u6587\u5B57\u989C\u8272"),
-    backgroundColor: Schema.string().role("color").default("rgba(0,0,0,1)").description("\u56FE\u7247\u6B4C\u5355\u80CC\u666F\u989C\u8272")
-  }).description("\u6B4C\u5355\u6837\u5F0F"),
-  Schema.object({
-    nextPageCommand: Schema.string().default("\u4E0B\u4E00\u9875").description("\u4E0B\u4E00\u9875\u6307\u4EE4"),
-    prevPageCommand: Schema.string().default("\u4E0A\u4E00\u9875").description("\u4E0A\u4E00\u9875\u6307\u4EE4"),
-    exitCommandList: Schema.array(Schema.string()).default(["0", "\u9000\u51FA", "\u4E0D\u542C\u4E86"]).description("\u9000\u51FA\u6307\u4EE4\u5217\u8868"),
-    menuExitCommandTip: Schema.boolean().default(false).description("\u662F\u5426\u5728\u6B4C\u5355\u5C3E\u90E8\u63D0\u793A\u9000\u51FA\u6307\u4EE4"),
-    waitForTimeout: Schema.natural().min(5).max(180).default(45).description("\u7B49\u5F85\u8F93\u5165\u5E8F\u53F7\u8D85\u65F6\uFF08\u79D2\uFF09"),
-    generationTip: Schema.string().default("\u751F\u6210\u8BED\u97F3\u4E2D\u2026").description("\u751F\u6210\u63D0\u793A\u6587\u672C")
-  }).description("\u4EA4\u4E92\u8BBE\u7F6E"),
-  Schema.object({
-    sendAs: Schema.union([
-      Schema.const("record").description("\u8BED\u97F3 record"),
-      Schema.const("audio").description("\u97F3\u9891 audio"),
-      Schema.const("file").description("\u6587\u4EF6 file")
-    ]).default("record").description("\u53D1\u9001\u7C7B\u578B"),
-    forceTranscode: Schema.boolean().default(true).description("\u6700\u7A33\u6A21\u5F0F\uFF1A\u4E0B\u8F7D + ffmpeg + silk \u8F6C\u7801\uFF08\u53EF\u9009\u4F9D\u8D56\uFF0C\u7F3A\u4F9D\u8D56\u81EA\u52A8\u964D\u7EA7\u76F4\u94FE\uFF09")
-  }).description("\u53D1\u9001\u8BBE\u7F6E"),
-  Schema.object({
-    recallMenu: Schema.boolean().default(true).description("\u64A4\u56DE\u6B4C\u5355\u6D88\u606F"),
-    recallGeneratingTip: Schema.boolean().default(true).description("\u64A4\u56DE\u751F\u6210\u63D0\u793A\u6D88\u606F"),
-    recallSongMessage: Schema.boolean().default(false).description("\u64A4\u56DE\u6B4C\u66F2\u6D88\u606F\uFF08\u8BED\u97F3/\u97F3\u9891/\u6587\u4EF6\uFF09"),
-    recallTimeoutTip: Schema.boolean().default(true).description("\u64A4\u56DE\u8D85\u65F6\u63D0\u793A"),
-    recallExitTip: Schema.boolean().default(false).description("\u64A4\u56DE\u9000\u51FA\u63D0\u793A"),
-    recallInvalidTip: Schema.boolean().default(false).description("\u64A4\u56DE\u5E8F\u53F7\u9519\u8BEF\u63D0\u793A"),
-    recallFetchFailTip: Schema.boolean().default(true).description("\u64A4\u56DE\u83B7\u53D6\u5931\u8D25\u63D0\u793A")
-  }).description("\u64A4\u56DE\u8BBE\u7F6E"),
-  Schema.object({
-    enableRateLimit: Schema.boolean().default(false).description("\u662F\u5426\u5F00\u542F\u9891\u7387\u9650\u5236"),
-    rateLimitScope: Schema.union([
-      Schema.const("user").description("\u6309\u7528\u6237"),
-      Schema.const("channel").description("\u6309\u9891\u9053"),
-      Schema.const("platform").description("\u6309\u5E73\u53F0")
-    ]).default("user").description("\u9650\u5236\u8303\u56F4"),
-    rateLimitIntervalSec: Schema.natural().min(1).max(3600).default(60).description("\u95F4\u9694\u79D2\u6570")
-  }).description("\u9891\u7387\u9650\u5236")
-]);
-function artistsToString(x) {
-  if (!x) return "";
-  if (Array.isArray(x)) return x.join(" / ");
-  return String(x);
+var Config = Schema.object({
+  commandName: Schema.string().description("\u6307\u4EE4\u540D\u79F0").default("\u542C\u6B4C"),
+  commandAlias: Schema.string().description("\u6307\u4EE4\u522B\u540D").default("music"),
+  apiBase: Schema.string().description("\u97F3\u4E50 API \u5730\u5740\uFF08GD\u97F3\u4E50\u53F0 API\uFF09").default("https://music-api.gdstudio.xyz/api.php"),
+  // ✅ 后台显示品牌名（你要求的）
+  source: Schema.union([
+    Schema.const("netease").description("\u7F51\u6613\u4E91"),
+    Schema.const("tencent").description("QQ\u97F3\u4E50"),
+    Schema.const("kugou").description("\u9177\u72D7"),
+    Schema.const("kuwo").description("\u9177\u6211"),
+    Schema.const("migu").description("\u54AA\u5495")
+  ]).description("\u97F3\u6E90\uFF08\u4E0B\u62C9\u9009\u62E9\uFF09").default("kuwo"),
+  searchListCount: Schema.natural().min(1).max(30).step(1).description("\u641C\u7D22\u5217\u8868\u6570\u91CF").default(20),
+  waitForTimeout: Schema.natural().min(5).max(300).step(1).description("\u7B49\u5F85\u8F93\u5165\u5E8F\u53F7\u8D85\u65F6\uFF08\u79D2\uFF09").default(45),
+  nextPageCommand: Schema.string().description("\u4E0B\u4E00\u9875\u6307\u4EE4").default("\u4E0B\u4E00\u9875"),
+  prevPageCommand: Schema.string().description("\u4E0A\u4E00\u9875\u6307\u4EE4").default("\u4E0A\u4E00\u9875"),
+  exitCommandList: Schema.array(Schema.string()).role("table").description("\u9000\u51FA\u6307\u4EE4\u5217\u8868\uFF08\u4E00\u884C\u4E00\u4E2A\uFF09").default(["0", "\u4E0D\u542C\u4E86", "\u9000\u51FA"]),
+  menuExitCommandTip: Schema.boolean().description("\u662F\u5426\u5728\u6B4C\u5355\u672B\u5C3E\u63D0\u793A\u9000\u51FA\u6307\u4EE4").default(false),
+  // ✅ 解决“太快撤回”的关键：默认 60 秒撤回歌单；并且默认“发送成功才撤回”
+  menuRecallSec: Schema.natural().min(0).max(3600).step(1).description("\u6B4C\u5355\u64A4\u56DE\u79D2\u6570\uFF080=\u4E0D\u64A4\u56DE\uFF09").default(60),
+  tipRecallSec: Schema.natural().min(0).max(3600).step(1).description("\u201C\u751F\u6210\u4E2D\u201D\u63D0\u793A\u64A4\u56DE\u79D2\u6570\uFF080=\u4E0D\u64A4\u56DE\uFF09").default(10),
+  recallOnlyAfterSuccess: Schema.boolean().description("\u4EC5\u5728\u53D1\u9001\u6210\u529F\u540E\u624D\u64A4\u56DE\uFF08\u63A8\u8350\u5F00\u542F\uFF09").default(true),
+  keepMenuIfSendFailed: Schema.boolean().description("\u53D1\u9001\u5931\u8D25\u65F6\u4FDD\u7559\u6B4C\u5355\uFF08\u63A8\u8350\u5F00\u542F\uFF09").default(true),
+  sendAs: Schema.union([
+    Schema.const("record").description("\u8BED\u97F3 record\uFF08\u63A8\u8350\uFF09"),
+    Schema.const("audio").description("\u97F3\u9891 audio"),
+    Schema.const("file").description("\u6587\u4EF6 file")
+  ]).description("\u53D1\u9001\u7C7B\u578B").default("record"),
+  // ✅ 装了 downloads+ffmpeg+silk 后会更稳（QQ 语音经常只认 silk）
+  forceTranscode: Schema.boolean().description("\u5F3A\u5236\u8F6C\u7801\uFF08\u9700\u8981 downloads + ffmpeg + silk\uFF1B\u66F4\u7A33\u4F46\u4F9D\u8D56\u66F4\u591A\uFF09").default(true),
+  maxSongDuration: Schema.natural().min(0).max(180).step(1).description("\u6B4C\u66F2\u6700\u957F\u65F6\u957F\uFF08\u5206\u949F\uFF0C0=\u4E0D\u9650\u5236\uFF09").default(30),
+  userAgent: Schema.string().description("\u8BF7\u6C42 UA\uFF08\u90E8\u5206\u73AF\u5883\u53EF\u907F\u514D\u98CE\u63A7/403\uFF09").default("koishi-music-to-voice/1.0"),
+  generationTip: Schema.string().description("\u9009\u62E9\u5E8F\u53F7\u540E\u53D1\u9001\u7684\u63D0\u793A\u6587\u6848").default("\u97F3\u4E50\u751F\u6210\u4E2D\u2026")
+});
+var pending = /* @__PURE__ */ new Map();
+function ms(sec) {
+  return Math.max(1, sec) * 1e3;
+}
+function keyOf(session) {
+  return `${session.platform}:${session.userId || "unknown"}:${session.channelId || session.guildId || "unknown"}`;
 }
-async function safeDelete(session, messageId) {
-  if (!messageId) return;
+function normalizeArtist(a) {
+  if (!a) return "";
+  if (Array.isArray(a)) return a.join(" / ");
+  return String(a);
+}
+function formatMenu(state, config) {
+  const lines = [];
+  lines.push(`\u70B9\u6B4C\u5217\u8868\uFF08\u7B2C ${state.page} \u9875\uFF09`);
+  lines.push(`\u5173\u952E\u8BCD\uFF1A${state.keyword}`);
+  lines.push("");
+  state.items.forEach((it, idx) => {
+    const n = idx + 1;
+    const artist = normalizeArtist(it.artist);
+    lines.push(`${n}. ${it.name}${artist ? ` - ${artist}` : ""}`);
+  });
+  lines.push("");
+  lines.push(`\u8BF7\u5728 ${config.waitForTimeout} \u79D2\u5185\u8F93\u5165\u6B4C\u66F2\u5E8F\u53F7`);
+  lines.push(`\u7FFB\u9875\uFF1A${config.prevPageCommand} / ${config.nextPageCommand}`);
+  if (config.menuExitCommandTip) lines.push(`\u9000\u51FA\uFF1A${config.exitCommandList.join(" / ")}`);
+  return lines.join("\n");
+}
+async function safeSend(session, content) {
+  const ids = await session.send(content);
+  if (Array.isArray(ids)) return ids.filter(Boolean);
+  return ids ? [ids] : [];
+}
+function recall(session, ids, sec) {
+  if (!ids?.length || sec <= 0) return;
   const channelId = session.channelId;
   if (!channelId) return;
-  try {
-    await session.bot.deleteMessage(channelId, messageId);
-  } catch {
-  }
-}
-function buildRateKey(session, scope) {
-  if (scope === "platform") return session.platform;
-  if (scope === "channel") return `${session.platform}:${session.channelId ?? ""}`;
-  return `${session.platform}:${session.userId ?? ""}`;
+  setTimeout(() => {
+    ids.forEach((id) => session.bot.deleteMessage(channelId, id).catch(() => {
+    }));
+  }, sec * 1e3);
 }
-async function gdSearch(ctx, config, keyword, page) {
-  const data = await ctx.http.get(config.apiBase, {
-    timeout: 15e3,
-    params: { types: "search", source: config.source, name: keyword, count: config.searchListCount, pages: page },
-    headers: { "user-agent": "koishi-music-to-voice" }
+async function apiSearch(ctx, config, keyword, page) {
+  const params = new URLSearchParams({
+    types: "search",
+    source: config.source,
+    name: keyword,
+    count: String(config.searchListCount),
+    pages: String(page)
   });
-  if (!Array.isArray(data)) return [];
-  return data.map((x) => ({
-    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)
-  })).filter((x) => x.id && x.name);
+  const url = `${config.apiBase}?${params.toString()}`;
+  const data = await ctx.http.get(url, {
+    headers: { "user-agent": config.userAgent },
+    responseType: "json",
+    timeout: 15e3
+  });
+  if (!Array.isArray(data)) throw new Error("search response is not array");
+  return data;
 }
-async function gdUrl(ctx, config, item) {
-  const data = await ctx.http.get(config.apiBase, {
-    timeout: 15e3,
-    params: { types: "url", source: item.source || config.source, id: item.id },
-    headers: { "user-agent": "koishi-music-to-voice" }
+async function apiGetSongUrl(ctx, config, item) {
+  const id = item.url_id || item.id;
+  const params = new URLSearchParams({
+    types: "url",
+    id: String(id),
+    source: item.source || config.source
+  });
+  const url = `${config.apiBase}?${params.toString()}`;
+  const data = await ctx.http.get(url, {
+    headers: { "user-agent": config.userAgent },
+    responseType: "json",
+    timeout: 15e3
   });
-  if (typeof data === "string") return data;
-  if (data?.url) return String(data.url);
-  if (data?.data?.url) return String(data.data.url);
-  return "";
+  const u = Array.isArray(data) ? data[0]?.url : data?.url;
+  if (!u) throw new Error("url not found from api");
+  return u;
 }
-async function downloadToTemp(ctx, src) {
-  try {
-    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 tmpFile(ext) {
+  const id = crypto.randomBytes(8).toString("hex");
+  return path.join(os.tmpdir(), `koishi-music-${id}.${ext}`);
 }
-async function tryTranscode(ctx, localPath) {
+async function downloadToFile(ctx, config, url, filePath) {
   const anyCtx = ctx;
-  if (!anyCtx.ffmpeg || !anyCtx.silk) return localPath;
-  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 {
-    }
+  if (anyCtx.downloads?.download) {
+    await anyCtx.downloads.download(url, filePath, {
+      headers: { "user-agent": config.userAgent }
+    });
+    return;
   }
+  const buf = await ctx.http.get(url, {
+    headers: { "user-agent": config.userAgent },
+    responseType: "arraybuffer",
+    timeout: 3e4
+  });
+  fs.writeFileSync(filePath, Buffer.from(buf));
 }
-async function renderListImage(ctx, html) {
+function runFfmpegToPcm(input, output) {
+  return new Promise((resolve, reject) => {
+    const p = spawn("ffmpeg", ["-y", "-i", input, "-ac", "1", "-ar", "48000", "-f", "s16le", output], { stdio: "ignore" });
+    p.on("error", reject);
+    p.on("exit", (code) => code === 0 ? resolve() : reject(new Error(`ffmpeg exit code ${code}`)));
+  });
+}
+async function encodeSilk(ctx, pcmPath) {
   const anyCtx = ctx;
-  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({});
-  await page.close();
-  return buf;
+  if (anyCtx.silk?.encode) {
+    const pcm = fs.readFileSync(pcmPath);
+    const out = await anyCtx.silk.encode(pcm, 48e3);
+    return Buffer.isBuffer(out) ? out : Buffer.from(out);
+  }
+  throw new Error("silk service encode not available");
 }
-function makeListText(config, list, page) {
-  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 = `
-
-\u7FFB\u9875\uFF1A${config.prevPageCommand} / ${config.nextPageCommand}`;
-  if (config.menuExitCommandTip && config.exitCommandList?.length) {
-    tail += `
-\u9000\u51FA\uFF1A${config.exitCommandList.join(" / ")}`;
+async function sendSong(session, ctx, config, url) {
+  if (config.sendAs === "record" && config.forceTranscode) {
+    const anyCtx = ctx;
+    if (anyCtx.downloads && anyCtx.silk) {
+      try {
+        const inFile = tmpFile("mp3");
+        const pcmFile = tmpFile("pcm");
+        await downloadToFile(ctx, config, url, inFile);
+        await runFfmpegToPcm(inFile, pcmFile);
+        const silkBuf = await encodeSilk(ctx, pcmFile);
+        try {
+          fs.unlinkSync(inFile);
+        } catch {
+        }
+        try {
+          fs.unlinkSync(pcmFile);
+        } catch {
+        }
+        return await safeSend(session, h("record", { src: silkBuf }));
+      } catch (e) {
+        logger.warn("transcode/send record failed, fallback: %s", e.message);
+      }
+    }
   }
-  return `\u97F3\u4E50\u5217\u8868\uFF1A
-${lines.join("\n")}${tail}
-
-\u8BF7\u5728 ${config.waitForTimeout} \u79D2\u5185\u8F93\u5165\u5E8F\u53F7\uFF1A`;
+  if (config.sendAs === "record") return await safeSend(session, h("record", { src: url }));
+  if (config.sendAs === "audio") return await safeSend(session, h.audio(url));
+  return await safeSend(session, h.file(url));
 }
 function apply(ctx, config) {
-  const lastUse = /* @__PURE__ */ new Map();
-  ctx.command(`${config.commandName} <keyword:text>`, "\u97F3\u4E50\u805A\u5408\u70B9\u6B4C\u5E76\u53D1\u9001\u8BED\u97F3").alias(config.commandAlias).action(async (argv, keyword) => {
-    const session = argv.session;
-    const options = argv.options ?? {};
+  ctx.command(`${config.commandName} <keyword:text>`, "\u70B9\u6B4C\u5E76\u53D1\u9001\u8BED\u97F3/\u97F3\u9891").alias(config.commandAlias).action(async ({ session }, keyword) => {
     if (!session) return;
-    keyword = (keyword ?? "").trim();
+    keyword = (keyword || "").trim();
     if (!keyword) return `\u7528\u6CD5\uFF1A${config.commandName} \u6B4C\u66F2\u540D`;
-    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) * 1e3;
-      if (now - last < interval) {
-        const remain = Math.ceil((interval - (now - last)) / 1e3);
-        return `\u64CD\u4F5C\u592A\u9891\u7E41\uFF0C\u8BF7 ${remain} \u79D2\u540E\u518D\u8BD5\u3002`;
-      }
-      lastUse.set(key, now);
+    const k = keyOf(session);
+    const old = pending.get(k);
+    if (old?.timer) clearTimeout(old.timer);
+    pending.delete(k);
+    let items;
+    try {
+      items = await apiSearch(ctx, config, keyword, 1);
+    } catch (e) {
+      logger.warn("search failed: %s", e.message);
+      return "\u641C\u7D22\u5931\u8D25\uFF08API \u4E0D\u53EF\u7528\u6216\u8D85\u65F6\uFF09\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002";
     }
-    let page = 1;
-    let menuMsgId = null;
-    while (true) {
-      let list = [];
-      try {
-        list = await gdSearch(ctx, config, keyword, page);
-      } catch (e) {
-        logger.warn(`[search] ${String(e?.message || e)}`);
-        const ids = await session.send("\u641C\u7D22\u5931\u8D25\uFF08API \u4E0D\u53EF\u7528\u6216\u8D85\u65F6\uFF09\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallFetchFailTip) await safeDelete(session, mid);
-        return;
-      }
-      if (!list.length) {
-        const ids = await session.send("\u6CA1\u6709\u641C\u7D22\u5230\u7ED3\u679C\uFF0C\u8BF7\u6362\u4E2A\u5173\u952E\u8BCD\u8BD5\u8BD5\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallFetchFailTip) await safeDelete(session, mid);
+    if (!items.length) return "\u6CA1\u6709\u641C\u7D22\u5230\u7ED3\u679C\u3002";
+    const state = {
+      userId: session.userId || "",
+      channelId: session.channelId || "",
+      keyword,
+      page: 1,
+      items,
+      menuMessageIds: [],
+      tipMessageIds: []
+    };
+    pending.set(k, state);
+    const menuText = formatMenu(state, config);
+    state.menuMessageIds = await safeSend(session, menuText);
+    if (config.menuRecallSec > 0 && !config.recallOnlyAfterSuccess) {
+      recall(session, state.menuMessageIds, config.menuRecallSec);
+    }
+    state.timer = setTimeout(async () => {
+      const cur = pending.get(k);
+      if (!cur) return;
+      pending.delete(k);
+      await session.send("\u8F93\u5165\u8D85\u65F6\uFF0C\u5DF2\u53D6\u6D88\u70B9\u6B4C\u3002");
+    }, ms(config.waitForTimeout));
+    return;
+  });
+  ctx.middleware(async (session, next) => {
+    const k = keyOf(session);
+    const state = pending.get(k);
+    if (!state) return next();
+    if ((session.userId || "") !== state.userId || (session.channelId || "") !== state.channelId) return next();
+    const content = (session.content || "").trim();
+    if (!content) return next();
+    if (config.exitCommandList.map((s) => s.trim()).filter(Boolean).includes(content)) {
+      pending.delete(k);
+      if (state.timer) clearTimeout(state.timer);
+      await session.send("\u5DF2\u9000\u51FA\u6B4C\u66F2\u9009\u62E9\u3002");
+      return;
+    }
+    if (content === config.nextPageCommand || content === config.prevPageCommand) {
+      const target = content === config.nextPageCommand ? state.page + 1 : Math.max(1, state.page - 1);
+      if (target === state.page) {
+        await session.send("\u5DF2\u7ECF\u662F\u7B2C\u4E00\u9875\u3002");
         return;
       }
-      if (menuMsgId && config.recallMenu) await safeDelete(session, menuMsgId);
-      if (config.imageMode) {
-        const text2 = 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">${text2}</div></body></html>`;
-        const buf = await renderListImage(ctx, html);
-        if (!buf) {
-          const ids2 = await session.send("\u56FE\u7247\u6B4C\u5355\u751F\u6210\u5931\u8D25\uFF1A\u672A\u5B89\u88C5 puppeteer \u670D\u52A1\u6216\u5176\u4E0D\u53EF\u7528\u3002");
-          const mid = Array.isArray(ids2) ? ids2[0] : ids2;
-          if (config.recallFetchFailTip) await safeDelete(session, mid);
+      try {
+        const items = await apiSearch(ctx, config, state.keyword, target);
+        if (!items.length) {
+          await session.send("\u6CA1\u6709\u66F4\u591A\u7ED3\u679C\u4E86\u3002");
           return;
         }
-        const ids = await session.send([h.image(buf, "image/png")]);
-        menuMsgId = Array.isArray(ids) ? ids[0] : ids;
-      } else {
-        const txt = makeListText(config, list, page);
-        const ids = await session.send(txt);
-        menuMsgId = Array.isArray(ids) ? ids[0] : ids;
-      }
-      const input = await session.prompt(
-        (s) => {
-          const els = s.elements ?? [];
-          return h.select(els, "text").join("");
-        },
-        { timeout: config.waitForTimeout * 1e3 }
-      );
-      if (isNullable(input)) {
-        if (config.recallMenu) await safeDelete(session, menuMsgId);
-        const ids = await session.send("\u8F93\u5165\u8D85\u65F6\uFF0C\u5DF2\u53D6\u6D88\u70B9\u6B4C\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallTimeoutTip) await safeDelete(session, mid);
-        return;
-      }
-      const text = String(input).trim();
-      if (!text) continue;
-      if (config.exitCommandList.includes(text)) {
-        if (config.recallMenu) await safeDelete(session, menuMsgId);
-        const ids = await session.send("\u5DF2\u9000\u51FA\u6B4C\u66F2\u9009\u62E9\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallExitTip) await safeDelete(session, mid);
-        return;
-      }
-      if (text === config.nextPageCommand) {
-        page += 1;
-        continue;
-      }
-      if (text === config.prevPageCommand) {
-        page = Math.max(1, page - 1);
-        continue;
-      }
-      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("\u5E8F\u53F7\u8F93\u5165\u9519\u8BEF\uFF0C\u5DF2\u9000\u51FA\u6B4C\u66F2\u9009\u62E9\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallInvalidTip) await safeDelete(session, mid);
-        return;
-      }
-      const chosen = list[local];
-      let tipMsgId = null;
-      {
-        const ids = await session.send(config.generationTip);
-        tipMsgId = Array.isArray(ids) ? ids[0] : ids;
-      }
-      let playUrl = "";
-      try {
-        playUrl = await gdUrl(ctx, config, chosen);
+        state.page = target;
+        state.items = items;
+        const menuText = formatMenu(state, config);
+        const newIds = await safeSend(session, menuText);
+        state.menuMessageIds.push(...newIds);
+        if (config.menuRecallSec > 0 && !config.recallOnlyAfterSuccess) recall(session, newIds, config.menuRecallSec);
       } catch (e) {
-        logger.warn(`[url] ${String(e?.message || e)}`);
+        logger.warn("page search failed: %s", e.message);
+        await session.send("\u7FFB\u9875\u5931\u8D25\uFF08API \u4E0D\u53EF\u7528\u6216\u8D85\u65F6\uFF09\u3002");
       }
-      if (!playUrl) {
-        if (config.recallGeneratingTip) await safeDelete(session, tipMsgId);
-        if (config.recallMenu) await safeDelete(session, menuMsgId);
-        const ids = await session.send("\u83B7\u53D6\u6B4C\u66F2\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallFetchFailTip) await safeDelete(session, mid);
+      return;
+    }
+    const n = Number(content);
+    if (!Number.isInteger(n) || n < 1 || n > state.items.length) return next();
+    if (state.timer) clearTimeout(state.timer);
+    const tipIds = await safeSend(session, config.generationTip);
+    state.tipMessageIds.push(...tipIds);
+    if (config.tipRecallSec > 0 && !config.recallOnlyAfterSuccess) recall(session, tipIds, config.tipRecallSec);
+    try {
+      const item = state.items[n - 1];
+      const songUrl = await apiGetSongUrl(ctx, config, item);
+      if (config.maxSongDuration > 0 && item.duration && item.duration / 60 > config.maxSongDuration) {
+        await session.send(`\u8BE5\u6B4C\u66F2\u65F6\u957F\u8D85\u51FA\u9650\u5236\uFF08>${config.maxSongDuration} \u5206\u949F\uFF09\uFF0C\u5DF2\u53D6\u6D88\u53D1\u9001\u3002`);
         return;
       }
-      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;
-          }
-        }
-        let sendIds;
-        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) {
-        logger.warn(`[send] ${String(e?.message || e)}`);
-        const ids = await session.send("\u53D1\u9001\u5931\u8D25\uFF08\u53EF\u80FD\u7F3A\u5C11\u8F6C\u7801\u4F9D\u8D56\u6216\u94FE\u63A5\u5931\u6548\uFF09\u3002");
-        const mid = Array.isArray(ids) ? ids[0] : ids;
-        if (config.recallFetchFailTip) await safeDelete(session, mid);
-      } finally {
-        if (config.recallGeneratingTip) await safeDelete(session, tipMsgId);
-        if (config.recallMenu) await safeDelete(session, menuMsgId);
+      await sendSong(session, ctx, config, songUrl);
+      if (config.recallOnlyAfterSuccess) {
+        if (config.tipRecallSec > 0) recall(session, tipIds, 1);
+        if (config.menuRecallSec > 0) recall(session, state.menuMessageIds, 1);
+      }
+      pending.delete(k);
+      return;
+    } catch (e) {
+      logger.warn("send failed: %s", e.stack || e.message);
+      await session.send("\u83B7\u53D6/\u53D1\u9001\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002");
+      if (!config.keepMenuIfSendFailed) {
+        pending.delete(k);
+      } else {
+        state.timer = setTimeout(() => pending.delete(k), ms(config.waitForTimeout));
       }
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-music-to-voice",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "音乐聚合点播语音插件：搜索歌曲、翻页选择、序号点播，可选转码发送语音。数据来源：GD音乐台 API。",
   "main": "dist/index.js",
   "module": "dist/index.mjs",