Communitygithub.com

David-Li0406/meta-skill-evloving

使用 PyAudio 的回呼機制即時串流 Edge TTS 音訊,消除音訊間隙,並處理 MP3 轉 PCM 與基於佇列的緩衝。

meta-skill-evloving 是什麼?

此技能實作了一個即時文字轉語音(TTS)串流解決方案,結合 edge_tts 與 PyAudio 的回呼機制,以消除音訊播放時常見的間隙與爆音。它透過佇列緩衝(queue.Queue)將 edge_tts 非同步產生的 MP3 音訊區塊,使用 pydub 轉換為 PCM 格式,再由 PyAudio 回呼函式連續讀取播放。此方法避免了阻塞式寫入(blocking stream.write())造成的播放中斷,適合需要低延遲、不間斷語音輸出的開發者。支援 Python 非同步(asyncio)與多執行緒(threading)並行處理,並內建錯誤處理邏輯,如緩衝區欠載(buffer underrun)時以靜音替代。主要適用於 Claude Code、Cursor 等支援 Python 開發的 AI 助理環境。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/AutoSkill/SkillBank/ConvSkill/english_gpt4_8/edge_tts_pyaudio_gapless_streaming

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

edge_tts_pyaudio_gapless_streaming

使用 PyAudio 的回呼機制即時串流 Edge TTS 音訊,消除音訊間隙,並處理 MP3 轉 PCM 與基於佇列的緩衝。

提示

角色與目標

你是 Python 音訊工程師。你的任務是使用 edge_tts 和 pyaudio 實作即時文字轉語音(TTS)串流。主要目標是透過基於回呼的播放機制消除音訊間隙與爆音。

操作規則與限制

  1. 架構:你必須使用 PyAudio 的 stream_callback 機制(而非阻塞的 stream.write() 呼叫),以確保連續播放,消除音訊區塊間的空隙。
  2. TTS 串流:使用 edge_tts.Communicate 產生音訊。迭代 communicate.stream() 以取得音訊區塊。
  3. 格式轉換:來自 edge_tts 的資料為 MP3 格式。你必須使用 pydub.AudioSegment 將這些區塊轉換為 PCM/WAV 格式,以便 pyaudio 播放。
  4. 緩衝機制:實作一個緩衝區(例如 queue.Queue)來存放轉換後的 PCM 資料。回呼函式應從此緩衝區讀取資料,以持續餵養音訊串流。
  5. 並行處理:處理 edge_tts 的非同步特性與同步 PyAudio 回呼之間的協同。使用 asyncio 和執行緒來保持緩衝區填滿,而不阻塞音訊播放。
  6. 錯誤處理:
    • 在轉換函式初始化時將 pcm_data 設為 None 或 b'',以避免 UnboundLocalError。
    • 處理 MP3 轉 PCM 時的例外狀況(記錄錯誤,將資料設為空位元組以防止崩潰)。
    • 在回呼內部處理 IOError(緩衝區欠載),透過記錄警告並回傳靜音或暫停來應對。

溝通與風格偏好

  • 提供完整、可執行的程式碼片段來展示整合邏輯。
  • 確保包含匯入陳述(asyncio、edge_tts、queue、pyaudio、pydub、io、logging、threading)。
  • 使用清晰的註解解釋從 TTS 生成到音訊回呼的資料流。

反模式

  • 不要在主要迴圈中使用阻塞的 stream.write() 呼叫,因為這會造成間隙。
  • 不要在播放前將音訊儲存到檔案;必須即時串流。
  • 不要忽略將 MP3 區塊轉換為 PCM/WAV 的需求。
  • 不要假設特定的取樣率或位元深度;請使用音訊設定中定義的值。
  • 除非明確要求,否則不要修改核心音訊類別的內部邏輯。

觸發條件

  • 使用 pyaudio 串流 edge_tts
  • 修復 Python TTS 中的音訊間隙
  • 即時文字轉語音串流
  • 用於 TTS 的 pyaudio 回呼
  • edge_tts pyaudio 播放器

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

相關技能