VoiceStudio — MOSS-TTS-Nano 引擎¶

MOSS-TTS-Nano (OpenMOSS) 是低资源、多语言支持的选择：一个 100M 参数的自回归编解码器语言模型，可在 4 核 CPU 上实时运行——无需 GPU——支持原生 48 kHz 输出和 20 种语言，采用 Apache-2.0 许可证。它填补了“可运行于无风扇笔记本”这一档次的空白，同时仍覆盖阿拉伯语、希伯来语、波斯语、韩语和土耳其语等语言。

何时选择它¶

• 仅使用 CPU 或低功耗硬件，但仍需要克隆功能和非英语语言覆盖。
• 你的语言属于以下之一：中文、英语、德语、西班牙语、法语、日语、意大利语、希伯来语、韩语、俄语、波斯语、阿拉伯语、波兰语、葡萄牙语、捷克语、丹麦语、瑞典语、匈牙利语、希腊语、土耳其语。

安装¶

该软件包不在 PyPI 上——请从上游仓库安装到 VoiceStudio 的 Python 环境中：

git clone https://github.com/OpenMOSS/MOSS-TTS-Nano.git
cd MOSS-TTS-Nano
uv pip install -e .

然后通过 Model Catalogue（TTS 标签页 → 使用）或 OMNIVOICE_TTS_BACKEND=moss-tts-nano 选择该引擎。

模型选择¶

首次使用会下载权重（若下载截断会重试一次）。参见 downloading-models.md。

行为说明¶

• 克隆仅支持参考片段：传入一个参考片段。风格指令、预设说话人和速度控制不受支持，会被静默忽略，因此混合引擎调用点仍能正常工作。
• 该模型输出 48 kHz 立体声；VoiceStudio 会降混为单声道，与流水线的其余部分保持一致（配音混合器按片段将 TTS 输出视为单声道）。
• 可在 CPU 或 CUDA 上运行。

上游未固定¶

上游仓库直接从 git 安装，没有固定的发布版本，而它导出的模型类此前已经发生过变更（#1287）。因此，VoiceStudio 在报告引擎就绪之前，会验证确实存在可用的模型类——而不仅仅是包可以导入。如果引擎显示不可用并带有“does not expose a usable model class”消息，请拉取最新上游并重新运行 uv pip install -e .，或打开一个 issue 并附上你使用的版本。

一键安装不受影响：它固定在一个经过审查的提交（8b7bcc93，2026-09-06）上，并运行该提交所附带的运行时。

已知限制¶

• 没有声音设计、没有指令模式、没有速度控制——仅支持从参考片段进行克隆。
• 质量低于大型引擎；参见 benchmarks.md。

一键安装¶

点击 Model Catalogue → MOSS-TTS-Nano 中的 安装。VoiceStudio 会将一个经过审查的上游提交克隆到数据目录下自己的文件夹中，为它提供独立的 Python 环境（在 NVIDIA GPU 上使用 PyTorch 的 CUDA 构建），并在单独的进程中运行它。

它安装的内容不会影响 VoiceStudio 本身或任何其他引擎，同一行中的 卸载 只会删除该文件夹。该按钮在 Intel Mac 上不提供，因为其固定的 PyTorch 版本在该平台上没有构建版本。

首次合成会下载模型及其音频分词器。下载进行期间，生成过程会保持运行；如果下载停滞并超时，请在 设置 → 性能与设备 中提高计算时间预算，然后重试。

文本分词器会复用已配置的 Hugging Face Hub 缓存，包括 HF_HOME / HF_HUB_CACHE 的覆盖设置。加载时会保留 HF_MODULES_CACHE，而不是在下载的模型代码旁边创建嵌套缓存，从而让应用在 Windows 上的短缓存路径继续有效。已经下载到旧嵌套缓存中的分词器在离线状态下仍可使用，无需再次下载。

故障排除¶

• “moss_tts_nano package not installed”：执行上面的克隆 + uv pip install -e . 步骤。
• 上游更新后的入口点错误：参见上文“上游未固定”。
• 一般问题：install/troubleshooting.md。

另请参阅：languages.md、expressive-speech.md、磁盘使用情况。

修复旧版托管安装¶

旧版托管安装可能缺少读取参考片段所需的音频后端。Model Catalogue 现在会检测到它们过时的依赖标记，并再次提供“安装”选项。选择它可修复现有环境中的依赖；检出代码和缓存的模型都会保留。检查安装状态不会下载任何内容。验证需要一个可用的 torchaudio 音频后端，包括启用 Python 优化时也是如此。用户自管环境仍由你掌控：请在该引擎的虚拟环境中安装 soundfile。