# MiMo V2.5 TTS — 安装说明（给 Agent 看）

> **提示**：如果用户已经在使用 MiMo 作为 LLM provider（如 Token Plan）或已安装其他 MiMo 插件（如 mimo-asr、mimo-websearch），`XIAOMI_API_KEY` 和 `XIAOMI_BASE_URL` 很可能已配置。请先检查现有的 `.env` 配置，直接复用，无需重复询问 API Key 和端点。

## 前置条件

- Hermes Agent 已安装并可运行
- Xiaomi MiMo API Key（获取地址：https://mimo.mi.com）

## 安装

> **注意**：`setup.sh` 仅供参考，请勿直接运行。请阅读以下步骤，根据用户的环境自行完成安装。
> 以下命令中的 `~/.hermes` 仅为 Unix 典型路径，**不要硬编码**。安装前请先确认 Hermes 的实际安装目录（如 `$HERMES_HOME`、`$env:HERMES_HOME` 等）。

将插件文件复制到 Hermes 插件目录并启用：

```bash
mkdir -p ~/.hermes/plugins/tts/mimo
cp plugin.yaml __init__.py ~/.hermes/plugins/tts/mimo/
hermes plugins enable tts/mimo
```

```powershell
# Windows (PowerShell)
mkdir -Force "$env:USERPROFILE\.hermes\plugins\tts\mimo"
cp plugin.yaml,__init__.py "$env:USERPROFILE\.hermes\plugins\tts\mimo\"
hermes plugins enable tts/mimo
```

安装后手动配置：

```bash
hermes config set tts.provider mimo
hermes config set tts.voice Mia       # 可选，不设则用 mimo_default
# 重启 session 生效（/reset）
```

如果希望安装独立命令行脚本：

```bash
cp mimo_tts.py ~/mimo_tts.py
chmod +x ~/mimo_tts.py
```

```powershell
# Windows (PowerShell)
cp mimo_tts.py "$env:USERPROFILE\mimo_tts.py"
```

## 环境变量

| 变量 | 必需 | 说明 |
|------|------|------|
| `XIAOMI_API_KEY` | ✅ | MiMo API Key |
| `XIAOMI_BASE_URL` | 可选 | API 端点（默认 `https://api.xiaomimimo.com/v1`，国内用户可能需要设为 `https://token-plan-cn.xiaomimimo.com/v1`） |

配置在 Hermes 的 `.env` 文件中。

## 卸载

```bash
hermes plugins disable tts/mimo
rm -rf ~/.hermes/plugins/tts/mimo
rm -f ~/mimo_tts.py
```

```powershell
# Windows (PowerShell)
hermes plugins disable tts/mimo
rm -Recurse -Force "$env:USERPROFILE\.hermes\plugins\tts\mimo"
rm -Force "$env:USERPROFILE\mimo_tts.py"
```