用途:该技能用于指导实现基于 Kokoro TTS 的文本转语音系统,适用于语音助手(如 JARVIS 语音响应)、实时自然韵律合成、离线 TTS(不依赖云服务)以及多音色场景。风险等级标注为 MEDIUM,原因是会生成音频输出、可能合成不当内容且资源消耗较高。
主要能力:Kokoro TTS 部署与音色配置;低延迟实时流式合成;音色定制与韵律控制;音频输出优化与格式转换;合成内容过滤。文档给出音色示例:af_heart(温暖友好,默认)、af_bella(专业正式)、am_adam(男声)、bf_emma(英式口音)。
使用方式:采用 TDD 流程,先写失败测试再实现,随后重构为流式、缓存与异步兼容。核心依赖为 kokoro>=0.3.0,配套 numpy、soundfile、sounddevice、scipy、pydantic、structlog。示例实现 SecureTTSEngine,通过 KPipeline(lang_code="a") 初始化,synthesize 返回 24kHz WAV 路径。验证命令:pytest tests/test_tts_engine.py -v、pytest --cov=jarvis.tts --cov-report=term-missing、mypy src/jarvis/tts/、python -m jarvis.tts --test "Hello JARVIS"。
性能与安全:流式合成边生成边播放;单例缓存 pipeline;分块读取音频;异步执行避免阻塞事件循环;启动时预加载音色。安全上过滤敏感模式(如 password、api_key、secret),限制文本长度(最大 5000 字符),临时目录权限 0o700,播放后清理文件,不记录敏感文本,并发限制 2 个并设 30 秒超时。
限制:资料未提供具体收费、价格、平台支持范围与合成效果指标,这些暂未提供。