前言¶
官方 MiMo V2.5 TTS 提供的是模型与 API：长文本、限流、缓存、降级和批量合成都要自己在客户端补齐。做配音流水线、Agent 朗读或 TTS+ASR 串联时，重复写分句、重试和质检脚本很耗时间。
下面介绍 SkillHub 上的 MimoTtsAsr26Free（坐标 @user_168d274d/mimofreetts，当前版本 2.9.1）。发布者 user_168d274d，来源为 community，分类 dev-programming。页面标注 requires_api_key=true（使用 MiMo 等云端能力时需自备 Key；无 Key 时可走文档描述的 edge-tts 兜底）。SkillHub 页面显示评分 100000，下载 854 次。
这是什么¶
一句话定位：在官方 MiMo TTS「引擎」之上，提供带脚本与工作流说明的「整车」——统一调用多款 TTS、可选 ASR 封装，并覆盖生产侧常见的限流、分句、缓存与异常处理。
与官方能力的对比，发布者在 SkillHub 上用表格做了归纳：官方侧重模型能力与本 Skill 未逐项列出的 API；本 Skill 侧重可执行的工程化能力（防限流、长文本、缓存、重试、批量与监听等）。以下功能点均来自该页面说明，不展开未出现的接口细节。
核心功能¶
TTS 三合一与降级¶
- 一个脚本统一调用 3 款 TTS 模型（具体模型名以安装后的 Skill 文档为准）。
- 无 API Key 时自动降级到 edge-tts，避免本地调试或 Key 未配置时完全不可用。
生产向客户端行为¶
| 能力 | 说明（据 SkillHub 页面） |
|---|---|
| 防限流 | 随机延迟 + 并发控制 |
| 长文本 | 约 120 字/段 自动切分 |
| 音频缓存 | 相同文本命中缓存，减少重复调用 |
| 异常重试 | 对 502 / 503 / timeout 自动重试 |
| 文本预处理 | 数字、符号、格式规范化（默认开启） |
| 质量自检 | 合成后检测空文件、静音、过短等 |
命令行与工作流扩展¶
页面列出的 CLI 能力包括：
--file：按行读取文件，批量合成。-o：根据输出文件后缀推断音频格式。--recommend-voice：按情感、语言等推荐音色。--watch：监听目录，对新增.txt自动合成。- ASR：提供
asr.py封装（说明中注明需 GPU 或等待云端开放）。 - 联合工作流：提供 TTS + ASR 串联示例。
- 开源方案指南：文档中涉及 edge-tts、ChatTTS、GPT-SoVITS 等选型说明。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。通用模式：
skillhub install @user_168d274d/mimofreetts --dir <你的 skills 目录>
也可让 AI 按官方指引安装：参考 SkillHub 安装文档，安装坐标 @user_168d274d/mimofreetts。
常见客户端 skills 路径（摘自 SkillHub 安装文档，按你实际环境选用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，在对应目录中查看该 Skill 的 SKILL.md 与附带脚本，确认 API Key 环境变量名、默认音色与依赖安装步骤。
API Key¶
标签 requires_api_key=true 表示使用 MiMo 等需 Key 的后端时要自行配置；无 Key 时页面说明支持 edge-tts 兜底。Key 的具体变量名与申请入口以 Skill 内文档为准，本文不臆造配置项名称。
典型用法¶
页面未给出完整的一行合成示例，但明确了可复现的能力形态。经过上面的安装步骤后，可按 SKILL.md 调用主脚本，并组合下列参数（名称均来自 SkillHub 对比表）：
- 单条或默认合成：按 Skill 文档传入文本与
-o输出路径；格式由后缀自动推断。 - 批量：
--file指向逐行文本文件，逐行生成音频。 - 音色：需要按场景选音色时加
--recommend-voice。 - 目录监听：对放稿目录使用
--watch，新增.txt即触发合成。 - ASR：在具备 GPU 或云端条件时，按文档使用
asr.py，并参考 TTS + ASR 串联示例。
长文本无需手工切段：客户端会按约 120 字/段 切分后再请求，并配合缓存与重试降低失败率。
适用场景与注意¶
适合谁
- 已用或计划用 MiMo V2.5 TTS，但不想从零实现限流、分句、缓存与重试的开发者。
- 需要 批量配音、目录监听，或希望 TTS 与 ASR 同一套 Skill 文档 里串起来的自动化场景。
- 希望在 Key 缺失或限流时仍有 edge-tts 等降级路径的本地/测试环境。
限制与注意
- ASR 依赖 GPU 或云端能力，页面明确「需 GPU 或等云端开放」，部署前要核对机器与账号条件。
- requires_api_key=true：正式使用 MiMo 类后端前准备好 Key；兜底方案能力与音质与官方 API 不同，需自行评估。
- 三款 TTS 的具体名称、速率限制与计费以 MiMo 官方与 Skill 内说明为准；本 Skill 做的是客户端工程化，不替代官方服务条款。
- SkillHub 统计为页面快照（评分 100000、下载 854）；安装与行为以 v2.9.1 包内文件为准。
结尾¶
MimoTtsAsr26Free 把官方 MiMo TTS 从「只有 API 的引擎」补成带分句、缓存、重试、批量与监听的工程化 Skill，并附带 ASR 封装与工作流示例。若你正在搭语音相关 Agent 或批处理流水线，可从 SkillHub 安装 @user_168d274d/mimofreetts，再对照包内 SKILL.md 配置 Key 与脚本。
- SkillHub 页面：https://www.skillhub.cn/skills/user_168d274d/mimofreetts
- 安装指引：https://skillhub.cn/install/skillhub.md
