koishi-plugin-audiomeme 1.2.1 → 1.2.2

package/README.md

@@ -20,6 +20,12 @@ audiomeme random
 - `audiomeme random` 随机播放一个音效。
 - 兼容旧命令：`memeaudio`、`memeaudio.list`、`memeaudio.random`。
 
+## Audio Sending
+
+默认使用“远程链接”模式发送音效，适合 OneBot 等适配器，避免本地 `file://` 缓存路径在机器人端不可见导致 0 秒语音。
+
+如需让 Koishi 先下载音频再发送本地文件，可以在配置中把“音效发送模式”改为“缓存文件”。缓存模式会校验已下载文件，发现空文件、HTML 错误页或无效音频时会自动重新下载。
+
 ## ChatLuna Tool Calls
 
 本插件可以选择接入 `chatluna_character`。

package/lib/index.d.ts

@@ -9,6 +9,7 @@ export interface Config {
     cacheMaxAge: number;
     pageSize: number;
     downloadTimeout: number;
+    sendMode: 'remote' | 'cache';
     enableAudioMemeXmlTool: boolean;
     injectAudioMemeXmlToolAsReplyTool: boolean;
 }

package/lib/index.js

@@ -21,9 +21,14 @@ exports.Config = koishi_1.Schema.object({
     cacheMaxAge: koishi_1.Schema.number().default(60 * 60 * 1000).description('缓存文件最长保留时间，单位为毫秒，默认 1 小时。'),
     pageSize: koishi_1.Schema.number().min(5).max(50).default(20).description('列表每页显示的音效数量。'),
     downloadTimeout: koishi_1.Schema.number().min(1000).default(30 * 1000).description('音频下载超时时间，单位为毫秒。'),
+    sendMode: koishi_1.Schema.union([
+        koishi_1.Schema.const('remote').description('远程链接：直接把音频 URL 交给平台发送，推荐 OneBot 使用。'),
+        koishi_1.Schema.const('cache').description('缓存文件：下载到 Koishi 缓存目录后以本地文件发送。'),
+    ]).role('radio').default('remote').description('音效发送模式。'),
     enableAudioMemeXmlTool: koishi_1.Schema.boolean().default(false).description('是否启用 ChatLuna 回复中的 XML 音效工具调用。'),
     injectAudioMemeXmlToolAsReplyTool: koishi_1.Schema.boolean().default(false).description('是否将 XML 音效工具注入实验性“工具调用回复”参数中。'),
 });
+const MIN_AUDIO_FILE_SIZE = 1024;
 function matchSounds(sounds, keyword) {
     if (!keyword)
         return sounds;
@@ -50,6 +55,49 @@ function parseListArgs(input) {
 function pickRandomSound(sounds) {
     return sounds[Math.floor(Math.random() * sounds.length)];
 }
+function hasAudioMagic(buffer) {
+    if (buffer.length < 4)
+        return false;
+    if (buffer.subarray(0, 3).toString('ascii') === 'ID3')
+        return true;
+    if (buffer[0] === 0xff && (buffer[1] & 0xe0) === 0xe0)
+        return true;
+    if (buffer.subarray(0, 4).toString('ascii') === 'OggS')
+        return true;
+    if (buffer.subarray(0, 4).toString('ascii') === 'RIFF')
+        return true;
+    if (buffer.length >= 12 && buffer.subarray(4, 8).toString('ascii') === 'ftyp')
+        return true;
+    return false;
+}
+function isLikelyTextResponse(buffer) {
+    const head = buffer.subarray(0, Math.min(buffer.length, 64)).toString('utf8').trimStart().toLowerCase();
+    return head.startsWith('<!doctype') || head.startsWith('<html') || head.startsWith('{') || head.startsWith('[');
+}
+async function validateAudioFile(filePath) {
+    try {
+        const stats = await fs_extra_1.default.stat(filePath);
+        if (!stats.isFile() || stats.size < MIN_AUDIO_FILE_SIZE)
+            return false;
+        const buffer = await fs_extra_1.default.readFile(filePath);
+        const head = buffer.subarray(0, 16);
+        return hasAudioMagic(head) && !isLikelyTextResponse(head);
+    }
+    catch {
+        return false;
+    }
+}
+function assertAudioResponse(contentType, data) {
+    if (data.length < MIN_AUDIO_FILE_SIZE) {
+        throw new Error(`downloaded audio is too small: ${data.length} bytes`);
+    }
+    if (contentType && !/audio|mpeg|octet-stream/i.test(contentType)) {
+        throw new Error(`unexpected content type: ${contentType}`);
+    }
+    if (!hasAudioMagic(data.subarray(0, 16)) || isLikelyTextResponse(data)) {
+        throw new Error('downloaded file does not look like an audio file');
+    }
+}
 function formatSoundList(sounds, page, pageSize, keyword) {
     const totalPages = Math.max(1, Math.ceil(sounds.length / pageSize));
     const currentPage = Math.min(Math.max(page, 1), totalPages);
@@ -87,20 +135,33 @@ function apply(ctx, config) {
                 ? [`未找到音效：${name}`, '你可能想找：', ...suggestions.map(s => `- ${s}`)].join('\n')
                 : `未找到音效：${name}`;
         }
+        if (config.sendMode === 'remote') {
+            return koishi_1.h.audio(sound.url);
+        }
         const fileName = `${encodeURIComponent(sound.name)}.mp3`;
         const filePath = path_1.default.join(cacheDir, fileName);
+        const tempFilePath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
         try {
-            if (!await fs_extra_1.default.pathExists(filePath)) {
+            if (!await validateAudioFile(filePath)) {
+                await fs_extra_1.default.unlink(filePath).catch(() => { });
                 const response = await axios_1.default.get(sound.url, {
                     responseType: 'arraybuffer',
                     timeout: config.downloadTimeout,
                 });
-                await fs_extra_1.default.writeFile(filePath, response.data);
+                const data = Buffer.from(response.data);
+                const contentType = response.headers['content-type'];
+                assertAudioResponse(typeof contentType === 'string' ? contentType : undefined, data);
+                await fs_extra_1.default.writeFile(tempFilePath, data);
+                if (!await validateAudioFile(tempFilePath)) {
+                    throw new Error('downloaded audio failed validation');
+                }
+                await fs_extra_1.default.move(tempFilePath, filePath, { overwrite: true });
             }
             lastAccess.set(fileName, Date.now());
             return koishi_1.h.audio((0, url_1.pathToFileURL)(filePath).href);
         }
         catch (error) {
+            await fs_extra_1.default.unlink(tempFilePath).catch(() => { });
             logger.error(error);
             return '下载或播放音效失败。';
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-audiomeme",
   "description": "Play meme sounds from a JSON database with cache cleanup.",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [