一个面向英语初学者的情景对话学习工具，帮助你通过 **预测场景 → 定制剧本 → 排练对话 → 实战演练** 的四步学习法，快速掌握日常场景中的实用英语表达。

## 快速开始

### 第一步：安装插件

1. 在 uTools 中搜索"HelloEnglish"或打开插件应用
2. 首次打开会看到 5 个内置示例计划，可直接上手体验

### 第二步：配置 AI API（必须）

进入「设置」→「AI 模型配置」：

1. 点击「添加 API 配置」
2. 选择服务商（推荐：硅基流动 / OpenAI）
3. 填入你的 API Key
4. 点击「测试连接」验证可用性
5. 保存后，聊天和语音识别共享同一配置

> 💡 **硅基流动用户**：预设中已填写正确的 Base URL 和模型名称，只需填入 API Key
> 💡 **语音识别**：使用与聊天相同的 API Key，通过 Whisper 接口转文字

### 第三步：配置 TTS 发音（可选）

如需更高质量的真人发音，进入「设置」→「语音播放设置」：

1. 选择预设（硅基流动 / OpenAI）或自定义
2. 填入 TTS API Key（可复用聊天 API Key）
3. 选择音色
4. 点击「测试发音」试听效果

> 不配置 TTS 也能使用，会自动降级为浏览器自带发音

### 第四步：开始学习

**方案 A：使用内置示例**
- 首页已有 5 个内置示例计划，点击「排练」或「对话」直接开始

**方案 B：创建自己的计划**
1. 首页点击 ➕ 按钮创建新计划
2. 填写计划标题和描述
3. 在「AI 场景推荐」中输入你下周可能遇到的场景
4. 设置每组对话数量 → 点击「获取 AI 推荐」
5. 添加推荐的场景到计划中，手动调整句子
6. 保存计划

## 使用说明

### 首页
- 顶部三个统计卡片：总计划数、对话总数、场景数
- 下方卡片网格展示所有学习计划
- 每张卡片显示计划标题、场景数、对话数
- 操作按钮：排练 / 对话 / 编辑 / 删除
- 场景以标签形式展示，点击直接进入对话

### 新建计划页
- **AI 场景推荐**：描述场景 → 设置对话数 → 获取推荐 → 添加到计划
- **手动创建**：添加场景 → 填写 Q&A 对话对
- 对话数量可通过 − / + 按钮调整（2~30 句，即 1~15 组）

### 排练页面
- 顶部场景标签切换
- Q/A 选项卡切换练习角色
- 三个播放按钮：播放 / 单句↔整组 / 单次↔循环
- 进度条和练习统计
- 上一组/下一组导航
- 到达最后一组时显示「去 AI 对话练习」按钮

### 实战对话页面
- AI 自动开始对话
- **语音模式**：点击麦克风区域 → 允许麦克风权限 → 开始录音 → 自动识别并发送
- **文字模式**：点击「文字」按钮切换 → 键盘输入 → Enter 发送
- AI 回复自动播放发音，可点击重播
- 对话记录自动保存到历史

### 历史记录页面
- 查看所有实战对话记录
- 点击展开查看完整聊天内容
- 支持导出全部数据

## API 服务商配置参考

| 服务商 | 聊天 Base URL | TTS 接口地址 | 语音识别 |
|--------|--------------|-------------|---------|
| OpenAI | https://api.openai.com/v1/chat/completions | https://api.openai.com/v1/audio/speech | ✅ Whisper |
| 硅基流动 | https://api.siliconflow.cn/v1/chat/completions | https://api.siliconflow.cn/v1/audio/speech | ✅ ASR |
| DeepSeek | https://api.deepseek.com/chat/completions | ❌ 不支持 | ❌ |
| Claude | https://api.anthropic.com/v1/messages | ❌ 不支持 | ❌ |

> 注意：TTS 和语音识别需要对应服务商支持。硅基流动和 OpenAI 同时支持三者。