whisper-lolo-audio-ingest
为 Whisper-lolo 构建或修改浏览器端录制和上传管道。在实现 MediaRecorder + IndexedDB 分块、组装音频 blob 或使用进度和回调配置 Vercel Blob 客户端上传时使用。
📖 中文导读:为 Whisper-lolo 构建或修改浏览器端录制和上传管道。在实现 MediaRecorder + IndexedDB 分块、组装音频 blob 或使用进度和回调配置 Vercel Blob 客户端上传时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: whisper-lolo-audio-ingest description: Build or modify the browser-side recording and upload pipeline for whisper-lolo. Use when implementing MediaRecorder + IndexedDB chunking, assembling audio blobs, or configuring Vercel Blob client uploads with progress and callbacks.
Whisper Lolo Audio Ingest
Overview
Implement long-form browser recording with chunked storage in IndexedDB and direct uploads to Vercel Blob, without serverless upload limits.
Recording workflow
- Initialize MediaRecorder with a supported mime type.
- Start with
MediaRecorder.start(timeslice)to emit chunks. - On
dataavailable, persist each chunk to IndexedDB. - On stop, rehydrate chunks and assemble a final Blob.
- Clear stored chunks after a successful upload.
Storage guidance
- Do not keep full audio in RAM; always store chunks in IndexedDB.
- Use idb-keyval for simple storage of Blob chunks.
- Guard against empty chunks; some browsers emit zero-size data.
Upload workflow (client uploads)
- Use
upload()from@vercel/blob/client. - Generate tokens via a server route using
handleUpload. - Persist
blob_urland update status touploadedafter completion. - Use
onUploadProgressfor UX feedback on large files.
Non-negotiable constraints
- Never upload audio via a Next.js API route.
- Do not wait for transcription inside HTTP requests.
- Chunk before transcription; upload only after assembly.
Common pitfalls
- Check
MediaRecorder.isTypeSupported()before selecting mime type. - Resume/pause should not break chunk order in IndexedDB.
- Ensure
onUploadCompletedworks locally only with a tunnel orVERCEL_BLOB_CALLBACK_URL.
References to consult
documentation/mediarecorder-mdn.mddocumentation/web-dictaphone-mdn.mddocumentation/idb-keyval.mddocumentation/mediarecorder-examples-mozdevs.mddocumentation/vercel-blob-client-uploads.mddocumentation/vercel-blob-sdk.mddocumentation/vercel-blob-examples.md