dsh-pf-stream 0.2.4 → 0.3.0

package/lib/asr/install.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 本地转写资源安装器：下载 → 校验 → 解压 → 落位。
+ *
+ * 约束：
+ * - 不引入任何运行时依赖（包只允许 pngjs）；用 Node 内置 fetch/stream/child_process。
+ * - 下载可取消、可断点续传；进度对设置页可见。
+ * - 失败必须给出可行动的原因（网络/磁盘/校验），不吞异常。
+ */
+export type InstallTarget = 'model' | 'engine' | 'all';
+export type InstallPhase = 'idle' | 'preparing' | 'downloading' | 'verifying' | 'extracting' | 'done' | 'failed' | 'cancelled';
+export interface InstallJob {
+    id: string;
+    target: InstallTarget;
+    phase: InstallPhase;
+    /** 当前资源的人类可读名（引擎包 / 模型文件）。 */
+    resource: string;
+    received: number;
+    total: number | null;
+    message: string | null;
+    startedAt: number;
+    finishedAt: number | null;
+    result: {
+        exe?: string;
+        modelPath?: string;
+        integrity?: 'sha256' | 'size';
+    } | null;
+}
+export interface InstallerOptions {
+    cacheDir: string;
+    modelId: string;
+    /** 自定义下载基地址（镜像/离线），缺省用官方源。 */
+    logger?: (line: string) => void;
+    /** 任务结束（成功/失败/取消）时回调，用于让探测缓存失效。 */
+    onFinished?: (() => void) | undefined;
+}
+/**
+ * 单任务安装器：同一时刻只允许一个下载任务，避免抢占带宽与磁盘。
+ * 状态保存在内存，页面轮询；宿主重启后重置（已落盘的文件仍有效）。
+ */
+export declare class LocalAsrInstaller {
+    private options;
+    private job;
+    private controller;
+    constructor(options: InstallerOptions);
+    /** 配置变更后同步模型档位与缓存目录（下一次安装生效，进行中的任务不打断）。 */
+    update(patch: Partial<Pick<InstallerOptions, 'cacheDir' | 'modelId'>>): void;
+    current(): InstallJob | null;
+    private patch;
+    private progress;
+    cancel(): void;
+    /** 启动安装；已有进行中的任务时直接返回该任务。 */
+    start(target: InstallTarget): InstallJob;
+    private run;
+}
+/** 计算目录占用（用于设置页显示缓存体积）。 */
+export declare function directoryBytes(dir: string): number;

package/lib/asr/install.js

@@ -0,0 +1,317 @@
+/**
+ * 本地转写资源安装器：下载 → 校验 → 解压 → 落位。
+ *
+ * 约束：
+ * - 不引入任何运行时依赖（包只允许 pngjs）；用 Node 内置 fetch/stream/child_process。
+ * - 下载可取消、可断点续传；进度对设置页可见。
+ * - 失败必须给出可行动的原因（网络/磁盘/校验），不吞异常。
+ */
+import { spawn } from 'node:child_process';
+import { createWriteStream, existsSync, mkdirSync, readdirSync, renameSync, rmSync, statSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { managedPaths, modelDownloadUrls, modelPreset, whisperCppUrls, } from './catalog.js';
+const PART_SUFFIX = '.part';
+function fileSize(path) {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * 逐 URL 尝试下载到 dest；dest.part 保留已下载字节，支持 Range 续传。
+ * 404/网络错误自动换下一个源；用户取消立即抛出 AbortError。
+ */
+async function downloadFirst(urls, dest, onProgress, signal) {
+    const part = `${dest}${PART_SUFFIX}`;
+    const failures = [];
+    for (const url of urls) {
+        let start = fileSize(part);
+        let response;
+        try {
+            response = await fetch(url, {
+                redirect: 'follow',
+                headers: start > 0 ? { range: `bytes=${start}-` } : {},
+                signal,
+            });
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw error;
+            failures.push(`${url}: ${error.message}`);
+            continue;
+        }
+        if (response.status === 416) {
+            // 续传位置已到文件末尾：视为完成。
+            return { url, bytes: start };
+        }
+        if (!response.ok) {
+            failures.push(`${url}: HTTP ${response.status}`);
+            continue;
+        }
+        if (start > 0 && response.status !== 206)
+            start = 0;
+        const lengthHeader = response.headers.get('content-length');
+        const incoming = lengthHeader === null ? 0 : Number(lengthHeader) || 0;
+        const total = start + incoming > 0 ? start + incoming : null;
+        if (response.body === null) {
+            failures.push(`${url}: 响应没有内容`);
+            continue;
+        }
+        mkdirSync(join(dest, '..'), { recursive: true });
+        const sink = createWriteStream(part, { flags: start > 0 ? 'a' : 'w' });
+        let received = start;
+        const source = Readable.fromWeb(response.body);
+        source.on('data', (chunk) => {
+            received += chunk.length;
+            onProgress(received, total);
+        });
+        try {
+            await pipeline(source, sink, { signal });
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw error;
+            failures.push(`${url}: ${error.message}`);
+            continue;
+        }
+        if (total !== null && received < total) {
+            failures.push(`${url}: 连接提前结束（${received}/${total} 字节）`);
+            continue;
+        }
+        return { url, bytes: received };
+    }
+    throw new Error(`下载失败，已尝试 ${urls.length} 个源：\n${failures.join('\n')}`);
+}
+function run(command, args, signal) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: 'ignore', windowsHide: true, signal });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${command} 退出码 ${String(code)}`));
+        });
+    });
+}
+function findExecutable(dir, names, depth = 3) {
+    if (depth < 0)
+        return null;
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const name of names) {
+        const direct = join(dir, name);
+        if (existsSync(direct) && statSync(direct).isFile())
+            return direct;
+    }
+    for (const entry of entries) {
+        const child = join(dir, entry);
+        try {
+            if (!statSync(child).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const found = findExecutable(child, names, depth - 1);
+        if (found !== null)
+            return found;
+    }
+    return null;
+}
+async function extractZip(archive, dest, signal) {
+    mkdirSync(dest, { recursive: true });
+    try {
+        await run('tar', ['-xf', archive, '-C', dest], signal);
+        return;
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw error;
+        if (process.platform !== 'win32')
+            throw error;
+    }
+    // Windows 老版本没有 bsdtar：退回 PowerShell。
+    await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', `Expand-Archive -LiteralPath '${archive}' -DestinationPath '${dest}' -Force`], signal);
+}
+let jobSeq = 0;
+/**
+ * 单任务安装器：同一时刻只允许一个下载任务，避免抢占带宽与磁盘。
+ * 状态保存在内存，页面轮询；宿主重启后重置（已落盘的文件仍有效）。
+ */
+export class LocalAsrInstaller {
+    options;
+    job = null;
+    controller = null;
+    constructor(options) {
+        this.options = options;
+    }
+    /** 配置变更后同步模型档位与缓存目录（下一次安装生效，进行中的任务不打断）。 */
+    update(patch) {
+        this.options = { ...this.options, ...patch };
+    }
+    current() {
+        return this.job;
+    }
+    patch(patch) {
+        if (this.job === null)
+            return;
+        this.job = { ...this.job, ...patch };
+    }
+    progress(received, total) {
+        this.patch({ received, total });
+    }
+    cancel() {
+        if (this.job === null)
+            return;
+        this.patch({ phase: 'cancelled', message: '已取消', finishedAt: Date.now() });
+        this.controller?.abort();
+        this.controller = null;
+    }
+    /** 启动安装；已有进行中的任务时直接返回该任务。 */
+    start(target) {
+        if (this.job !== null && (this.job.phase === 'downloading' || this.job.phase === 'verifying' || this.job.phase === 'extracting' || this.job.phase === 'preparing')) {
+            return this.job;
+        }
+        const job = {
+            id: `install-${++jobSeq}`,
+            target,
+            phase: 'preparing',
+            resource: '',
+            received: 0,
+            total: null,
+            message: null,
+            startedAt: Date.now(),
+            finishedAt: null,
+            result: null,
+        };
+        this.job = job;
+        this.controller = new AbortController();
+        const signal = this.controller.signal;
+        void this.run(job, signal)
+            .catch((error) => {
+            if (signal.aborted) {
+                this.patch({ phase: 'cancelled', finishedAt: Date.now(), message: '已取消' });
+                return;
+            }
+            this.patch({
+                phase: 'failed',
+                finishedAt: Date.now(),
+                message: error instanceof Error ? error.message : String(error),
+            });
+        })
+            .finally(() => {
+            this.options.onFinished?.();
+        });
+        return job;
+    }
+    async run(job, signal) {
+        const { cacheDir } = this.options;
+        const preset = modelPreset(this.options.modelId);
+        const managed = managedPaths(cacheDir);
+        const result = {};
+        mkdirSync(managed.modelDir, { recursive: true });
+        mkdirSync(managed.binDir, { recursive: true });
+        if (job.target === 'engine' || job.target === 'all') {
+            if (!existsSync(managed.exe) && process.platform !== 'win32') {
+                throw new Error('当前平台暂不支持一键安装本地引擎。请安装 whisper.cpp 后，在配置文件 audio.asr.local.binPath 填写可执行文件路径，或改用云端转写。');
+            }
+            if (!existsSync(managed.exe)) {
+                this.patch({ resource: 'whisper.cpp 引擎', phase: 'downloading', received: 0, total: null });
+                const archive = join(managed.binDir, 'whisper-cpp.zip');
+                const partialArchive = `${archive}${PART_SUFFIX}`;
+                await downloadFirst(whisperCppUrls(), archive, (r, t) => this.progress(r, t), signal);
+                // downloadFirst 只写 .part，改名由调用方负责；漏了这步解压会找不到文件。
+                if (existsSync(partialArchive))
+                    renameSync(partialArchive, archive);
+                this.patch({ resource: 'whisper.cpp 引擎', phase: 'extracting' });
+                await extractZip(archive, managed.binDir, signal);
+                rmSync(archive, { force: true });
+                const exe = findExecutable(managed.binDir, ['whisper-cli.exe', 'whisper-cli', 'main.exe']);
+                if (exe === null) {
+                    throw new Error('下载的压缩包里没有找到 whisper-cli 可执行文件');
+                }
+                // 官方 Windows 包把 exe 与 DLL 放在 Release/ 子目录：整体搬到 binDir，
+                // 否则只挪 exe 会丢掉 ggml.dll / whisper.dll，一运行就报错。
+                const exeDir = dirname(exe);
+                if (exeDir !== managed.binDir) {
+                    for (const name of readdirSync(exeDir)) {
+                        const from = join(exeDir, name);
+                        try {
+                            if (!statSync(from).isFile())
+                                continue;
+                        }
+                        catch {
+                            continue;
+                        }
+                        const to = join(managed.binDir, name);
+                        rmSync(to, { force: true });
+                        renameSync(from, to);
+                    }
+                    rmSync(exeDir, { recursive: true, force: true });
+                }
+                if (!existsSync(managed.exe)) {
+                    const located = findExecutable(managed.binDir, ['whisper-cli.exe', 'whisper-cli', 'main.exe']);
+                    if (located !== null && located !== managed.exe)
+                        renameSync(located, managed.exe);
+                }
+            }
+        }
+        if (job.target === 'model' || job.target === 'all') {
+            const modelPath = join(managed.modelDir, preset.file);
+            if (!existsSync(modelPath)) {
+                this.patch({ resource: preset.label, phase: 'downloading', received: 0, total: null });
+                const partial = `${modelPath}${PART_SUFFIX}`;
+                const done = await downloadFirst(modelDownloadUrls(preset), modelPath, (r, t) => this.progress(r, t), signal);
+                this.patch({ phase: 'verifying', message: '校验文件…' });
+                const bytes = fileSize(partial);
+                if (bytes < 1024 * 1024)
+                    throw new Error(`模型文件不完整（${bytes} 字节）`);
+                renameSync(partial, modelPath);
+                result.modelPath = modelPath;
+                result.integrity = 'size';
+                this.options.logger?.(`model downloaded from ${done.url} (${bytes} bytes)`);
+            }
+            if (!('modelPath' in result)) {
+                result.modelPath = modelPath;
+                result.integrity = 'size';
+            }
+        }
+        if (existsSync(managed.exe))
+            result.exe = managed.exe;
+        this.patch({
+            phase: 'done',
+            finishedAt: Date.now(),
+            resource: '',
+            message: job.target === 'model' ? '模型已就绪' : '本地转写已就绪',
+            result,
+        });
+    }
+}
+/** 计算目录占用（用于设置页显示缓存体积）。 */
+export function directoryBytes(dir) {
+    let total = 0;
+    try {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                total += directoryBytes(path);
+            else if (entry.isFile())
+                total += fileSize(path);
+        }
+    }
+    catch {
+        return total;
+    }
+    return total;
+}
+//# sourceMappingURL=install.js.map

package/lib/asr/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/asr/install.ts"],"names":[],"mappings":"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"}

package/lib/asr/verify.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 「点一下验证」：用一段 1 秒 440Hz 的合成音跑真实转写链路。
+ *
+ * 为什么不用 ping/模型列表：初学者关心的是「这台机器能不能出字」，
+ * 只有真正跑一次引擎才能回答。合成音没有语音内容，但足以证明
+ * 进程能启动、模型能加载、网络与密钥可用。
+ */
+import type { AsrSettings } from '../audio/types.js';
+/** 16kHz / 16bit / 单声道 WAV，1 秒 440Hz 正弦。 */
+export declare function toneWav(seconds?: number, sampleRate?: number): Buffer;
+export interface VerifyResult {
+    ok: boolean;
+    kind: 'cloud' | 'local';
+    latencyMs: number;
+    /** 云端返回的文本（几乎总是空）；本地不返回。 */
+    text: string | null;
+    message: string;
+}
+/** 本地：跑一次 1 秒音频，能产出 SRT（哪怕空）即算通过。 */
+export declare function verifyLocal(settings: AsrSettings, timeoutMs?: number): Promise<VerifyResult>;
+/** 云端：把同一段音频发给端点的 /audio/transcriptions。 */
+export declare function verifyCloud(settings: AsrSettings, timeoutMs?: number): Promise<VerifyResult>;

package/lib/asr/verify.js

@@ -0,0 +1,174 @@
+/**
+ * 「点一下验证」：用一段 1 秒 440Hz 的合成音跑真实转写链路。
+ *
+ * 为什么不用 ping/模型列表：初学者关心的是「这台机器能不能出字」，
+ * 只有真正跑一次引擎才能回答。合成音没有语音内容，但足以证明
+ * 进程能启动、模型能加载、网络与密钥可用。
+ */
+import { spawn } from 'node:child_process';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { transcriptionUrl } from '../audio/asrProviders.js';
+/** 16kHz / 16bit / 单声道 WAV，1 秒 440Hz 正弦。 */
+export function toneWav(seconds = 1, sampleRate = 16_000) {
+    const samples = Math.floor(seconds * sampleRate);
+    const data = Buffer.alloc(samples * 2);
+    for (let i = 0; i < samples; i += 1) {
+        const value = Math.round(Math.sin((2 * Math.PI * 440 * i) / sampleRate) * 0.2 * 32767);
+        data.writeInt16LE(value, i * 2);
+    }
+    const header = Buffer.alloc(44);
+    header.write('RIFF', 0);
+    header.writeUInt32LE(36 + data.length, 4);
+    header.write('WAVE', 8);
+    header.write('fmt ', 12);
+    header.writeUInt32LE(16, 16);
+    header.writeUInt16LE(1, 20);
+    header.writeUInt16LE(1, 22);
+    header.writeUInt32LE(sampleRate, 24);
+    header.writeUInt32LE(sampleRate * 2, 28);
+    header.writeUInt16LE(2, 32);
+    header.writeUInt16LE(16, 34);
+    header.write('data', 36);
+    header.writeUInt32LE(data.length, 40);
+    return Buffer.concat([header, data]);
+}
+function runCaptured(command, args, timeoutMs) {
+    return new Promise((resolve) => {
+        let stderr = '';
+        let settled = false;
+        const child = spawn(command, args, { windowsHide: true, stdio: ['ignore', 'ignore', 'pipe'] });
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill();
+            resolve({ code: null, stderr: '验证超时', spawnError: null });
+        }, timeoutMs);
+        child.stderr?.on('data', (chunk) => {
+            if (stderr.length < 4000)
+                stderr += chunk.toString('utf8');
+        });
+        child.on('error', (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ code: null, stderr: '', spawnError: error });
+        });
+        child.on('exit', (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ code, stderr, spawnError: null });
+        });
+    });
+}
+/** 本地：跑一次 1 秒音频，能产出 SRT（哪怕空）即算通过。 */
+export async function verifyLocal(settings, timeoutMs = 60_000) {
+    const started = Date.now();
+    if (settings.model === null) {
+        return { ok: false, kind: 'local', latencyMs: 0, text: null, message: '没有可执行文件' };
+    }
+    const dir = await mkdtemp(path.join(tmpdir(), 'pf-verify-'));
+    try {
+        const audio = path.join(dir, 'probe.wav');
+        await writeFile(audio, toneWav());
+        const args = (settings.args ?? []).map((token) => token
+            .split('{audio}').join(audio)
+            .split('{dir}').join(dir)
+            .split('{outbase}').join(path.join(dir, 'chunk'))
+            .split('{out}').join(path.join(dir, 'cli-out.txt')));
+        if (!args.includes(audio))
+            args.push(audio);
+        const result = await runCaptured(settings.model, args, timeoutMs);
+        const latencyMs = Date.now() - started;
+        if (result.spawnError !== null) {
+            return {
+                ok: false,
+                kind: 'local',
+                latencyMs,
+                text: null,
+                message: `无法启动：${result.spawnError.message}`,
+            };
+        }
+        if (result.code !== 0) {
+            const tail = result.stderr.trim().split(/\r?\n/).slice(-3).join(' / ');
+            return {
+                ok: false,
+                kind: 'local',
+                latencyMs,
+                text: null,
+                message: `引擎退出码 ${String(result.code)}${tail === '' ? '' : `：${tail}`}`,
+            };
+        }
+        return { ok: true, kind: 'local', latencyMs, text: null, message: '本地引擎可用' };
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+/** 云端：把同一段音频发给端点的 /audio/transcriptions。 */
+export async function verifyCloud(settings, timeoutMs = 20_000) {
+    const started = Date.now();
+    if (settings.baseUrl === null || settings.apiKey === null) {
+        return { ok: false, kind: 'cloud', latencyMs: 0, text: null, message: '缺少端点或密钥' };
+    }
+    const form = new FormData();
+    form.append('file', new Blob([new Uint8Array(toneWav())], { type: 'audio/wav' }), 'probe.wav');
+    form.append('model', settings.model ?? 'whisper-1');
+    form.append('response_format', 'json');
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(transcriptionUrl(settings.baseUrl), {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${settings.apiKey}` },
+            body: form,
+            signal: controller.signal,
+        });
+        const latencyMs = Date.now() - started;
+        if (response.status === 401 || response.status === 403) {
+            return { ok: false, kind: 'cloud', latencyMs, text: null, message: '密钥被拒绝（401/403）' };
+        }
+        if (response.status === 402) {
+            return { ok: false, kind: 'cloud', latencyMs, text: null, message: '账户余额不足（402）' };
+        }
+        if (response.status === 404) {
+            return { ok: false, kind: 'cloud', latencyMs, text: null, message: '端点不存在（404），检查服务地址' };
+        }
+        if (!response.ok) {
+            const body = (await response.text().catch(() => '')).slice(0, 200);
+            return {
+                ok: false,
+                kind: 'cloud',
+                latencyMs,
+                text: null,
+                message: `HTTP ${response.status}${body === '' ? '' : `：${body}`}`,
+            };
+        }
+        const doc = (await response.json().catch(() => ({})));
+        return {
+            ok: true,
+            kind: 'cloud',
+            latencyMs,
+            text: doc.text ?? '',
+            message: '密钥与端点可用',
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            kind: 'cloud',
+            latencyMs: Date.now() - started,
+            text: null,
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=verify.js.map

package/lib/asr/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/asr/verify.ts"],"names":[],"mappings":"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"}

package/lib/audio/acousticVad.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Stage A1 —— 声学 VAD（silencedetect + astats）与切分规划。
+ *
+ * silencedetect=noise=-35dB:d=0.4 提取静音区间；astats(reset=0) 取整窗
+ * RMS/峰值电平。静音占比 ≥95% 或峰值 < -45dBFS 判定整窗无语音（短路）。
+ * 长窗口按 VAD 谷底在 [45s, 75s] 弹性切分；无谷底可用时 60s 硬切。
+ */
+import type { VadResult } from './types.js';
+export declare const SILENT_ACTIVE_RATIO_MAX = 0.05;
+export declare const SILENT_PEAK_DB_MIN = -45;
+export interface VadScanOptions {
+    ffmpegPath: string;
+    signal?: AbortSignal | undefined;
+}
+/**
+ * 窗口声学扫描（-ss 前置输入寻址；PTS 相对窗口起点换算为绝对 PTS）。
+ * 解析失败时返回 null（调用方按无 VAD 信息继续，不短路）。
+ */
+export declare function scanVad(videoPath: string, window: [number, number], options: VadScanOptions): Promise<VadResult | null>;
+/** 整窗无语音判定（静音占比 ≥95% 或峰值 < -45dBFS）。 */
+export declare function isSilentWindow(vad: VadResult | null): boolean;
+export interface ChunkPlanOptions {
+    /** 切分窗口下限（毫秒）。 */
+    minMs: number;
+    /** 切分窗口上限（毫秒）。 */
+    maxMs: number;
+    /** 无谷底时的硬切长度（毫秒）。 */
+    hardMs: number;
+}
+export declare const DEFAULT_CHUNK_PLAN: ChunkPlanOptions;
+/**
+ * 带时间戳 provider 的切分：谷底优先（取 [min, max] 内最深静音的中点），
+ * 否则 hardMs 硬切。切点落在静音中点，句子不被腰斩。
+ */
+export declare function planChunks(window: [number, number], vad: VadResult | null, options?: ChunkPlanOptions): Array<[number, number]>;
+/** 无时间戳 provider（openai_basic）的切分：语音岛直切，>30s 的岛硬切。 */
+export declare function planIslandChunks(window: [number, number], vad: VadResult | null, maxIslandMs?: number): Array<[number, number]>;
+/**
+ * 切片音频编码（16kHz 单声道；mp3 = libmp3lame -q:a 6，opus = libopus 24k）。
+ * 返回 {bytes, mimeType}；失败抛错由路由层按块失败处理。
+ */
+export declare function sliceAudio(videoPath: string, range: [number, number], codec: 'mp3' | 'opus', options: VadScanOptions): Promise<{
+    bytes: Buffer;
+    mimeType: string;
+}>;