Communitygithub.com

David-Li0406/meta-skill-evloving

使用 PyAudio 的回调机制实时流式播放 Edge TTS 音频,消除播放间隙,处理 MP3 到 PCM 的转换和基于队列的缓冲。

meta-skill-evloving 是什么?

这是一个专门用于实现实时文本转语音(TTS)流式播放的 AI 技能,利用 edge_tts 和 PyAudio 的回调机制消除音频间隙和爆音。它通过将 edge_tts 流式输出的 MP3 音频块转换为 PCM 格式,并使用队列管理缓冲数据,确保语音播放的连续性和低延迟。该技能支持 Python 环境,依赖 pydub、asyncio 和 threading 进行异步处理和格式转换,同时内置了缓冲区欠载、格式转换异常等场景的错误处理。适用于开发实时语音助手、语音交互系统或需要低延迟 TTS 播放的应用场景。

兼容平台~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 的要求。
  • 不要假设特定的采样率或位深度;请使用音频配置中定义的值。
  • 除非明确要求,否则不要修改核心音频类的内部逻辑。

触发词

  • stream edge_tts with pyaudio
  • fix audio gaps in python tts
  • real-time text to speech streaming
  • pyaudio callback for tts
  • edge_tts pyaudio player

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".

相关技能