diff --git a/README.md b/README.md
new file mode 100644
index 0000000..777bd33
--- /dev/null
+++ b/README.md
@@ -0,0 +1,223 @@
+# Mimo-TTS CLI
+
+基于 MiMo-TTS API 的命令行文本转语音工具。
+
+## 功能特性
+
+- 文本转语音合成
+- 支持多种音色（9 种）
+- 自动语气转换（根据标点符号）
+- 支持流式输出
+- 直接播放音频
+- 保存到文件
+- CLI 美化输出
+
+## 下载安装
+
+### 预编译二进制
+
+从 [Releases](https://github.com/titor/mimo-tts/releases) 下载对应平台的二进制：
+
+| 平台 | 文件名 |
+|------|--------|
+| Linux x86_64 | mimo-tts-linux-amd64 |
+| Linux ARM64 | mimo-tts-linux-arm64 |
+| macOS Intel | mimo-tts-darwin-amd64 |
+| macOS Apple Silicon | mimo-tts-darwin-arm64 |
+| Windows x86_64 | mimo-tts-windows-amd64.exe |
+
+```bash
+# Linux/macOS
+chmod +x mimo-tts-*
+sudo mv mimo-tts-* /usr/local/bin/mimo-tts
+
+# Windows
+# 将 .exe 文件放到任意目录，添加到 PATH
+```
+
+## 快速开始
+
+### 1. 配置 API Key
+
+```bash
+# 方式一：交互式配置
+mimo-tts onboard
+
+# 方式二：命令行配置
+mimo-tts config set --api-key YOUR_API_KEY
+```
+
+获取 API Key：https://platform.xiaomimimo.com/
+
+### 2. 语音合成
+
+```bash
+# 直接播放
+mimo-tts --text "你好世界" --play
+
+# 保存到文件
+mimo-tts --text "你好世界" --output hello.wav
+
+# 输出到 stdout（二进制流）
+mimo-tts --text "你好世界" > hello.wav
+```
+
+## 使用方法
+
+### 基本用法
+
+```bash
+# 文本转语音
+mimo-tts --text "要合成的文本" --play
+
+# 从文件读取
+mimo-tts --file text.txt --play
+```
+
+### 参数说明
+
+| 参数 | 简写 | 说明 | 默认值 |
+|------|------|------|--------|
+| `--text` | `-t` | 要合成的文本 | - |
+| `--file` | `-f` | 从文件读取文本 | - |
+| `--voice` | `-v` | 音色名称 | mimo_default |
+| `--style` | - | 风格描述 | - |
+| `--output` | `-o` | 输出到文件 | - |
+| `--play` | - | 直接播放 | false |
+| `--stream` | - | 流式输出 (PCM16) | false |
+
+### 可用音色
+
+```
+mimo_default  - MiMo默认
+冰糖        - 甜美清脆的女声
+茉莉        - 温柔知性的女声
+苏打        - 阳光活力的男声
+白桦        - 沉稳大气的男声
+Mia         - 英文女声
+Chloe       - 英文女声
+Milo        - 英文男声
+Dean        - 英文男声
+```
+
+列出所有音色：
+```bash
+mimo-tts voices
+```
+
+### 风格描述
+
+使用 `--style` 参数指定语音风格：
+
+```bash
+mimo-tts --text "你好" --style "开心" --play
+mimo-tts --text "你好" --style "东北话" --play
+mimo-tts --text "你好" --style "唱歌" --play
+```
+
+### 自动语气转换
+
+工具会自动根据文本中的标点符号添加语气：
+
+- `！` → 添加 [激动] 语气
+- `？` → 添加 [疑惑] 语气
+- `。` → 添加 [平静] 语气（默认）
+
+示例：
+```bash
+mimo-tts --text "你好吗？" --play    # 自动添加疑惑语气
+mimo-tts --text "太棒了！" --play   # 自动添加激动语气
+```
+
+### 流式输出
+
+使用 `--stream` 参数进行流式输出：
+
+```bash
+# 流式输出到文件
+mimo-tts --text "你好" --stream --output output.pcm
+
+# 流式播放
+mimo-tts --text "你好" --stream --play
+```
+
+注意：流式输出格式为 PCM16（原始音频），无 WAV 头。
+
+### 配置管理
+
+```bash
+# 查看当前配置
+mimo-tts show-config
+
+# 设置 API Key
+mimo-tts config set --api-key YOUR_KEY
+
+# 设置默认音色
+mimo-tts config set --voice 茉莉
+```
+
+## 配置文件
+
+配置文件位于：`~/.config/tts/config.toml`
+
+```toml
+api_key = "YOUR_API_KEY"
+default_voice = "mimo_default"
+```
+
+## 开发编译
+
+### 环境要求
+
+- Rust 1.70+
+- Cargo
+
+### 编译
+
+```bash
+# Debug 构建
+cargo build
+
+# Release 构建
+cargo build --release
+
+# 运行
+cargo run -- --text "你好" --play
+```
+
+### 测试
+
+```bash
+# 运行测试
+cargo test
+
+# 运行特定测试
+cargo test tone
+```
+
+## 项目结构
+
+```
+src/
+├── main.rs      # 主入口
+├── cli.rs      # CLI 参数定义
+├── api.rs     # API 调用
+├── config.rs   # 配置管理
+├── tone.rs    # 语气转换
+└── ui.rs     # UI 美化
+```
+
+## 退出码
+
+| 码 | 说明 |
+|----|------|
+| 0 | 成功 |
+| 1 | 参数错误 |
+| 2 | 配置错误 |
+| 3 | API 调用失败 |
+| 4 | 文件操作失败 |
+
+## 相关链接
+
+- MiMo 开放平台：https://platform.xiaomimimo.com/
+- GitHub：https://github.com/titor/mimo-tts
\ No newline at end of file