# SpellVoice

**Repository Path**: Umbrella167/SpellVoice

## Basic Information

- **Project Name**: SpellVoice
- **Description**: SpellVoice，魔法语音输入助手，游戏语音输入助手
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpellVoice

实时语音转文字工具，按住按键录音，松开即识别，支持热词和脏话替换。AI润色

## 在线体验

[https://voice.magetech.com.cn/](https://voice.magetech.com.cn/)
魔法语音输入助手,SpellVoice


## 功能

- 按键录音（默认 `V` 键按住说话）
- 实时语音识别，结果自动复制到剪贴板
- 可选自动输入到游戏/应用（Unicode 模拟键盘输入）
- 热词列表提升专业术语识别率
- 脏话替换表自动过滤
- PyQt6 GUI + 系统托盘

## 快速开始

### 环境要求

- Windows 10/11
- Python 3.9+
- 麦克风

### 安装

```bash
pip install -r requirements.txt
```

### 配置

复制 `config.json` 并填入你的 API 凭据：

```json
{
  "api_key": "YOUR_API_KEY_HERE",
  "resource_id": "YOUR_RESOURCE_ID_HERE",
  "recognize_url": "YOUR_RECOGNIZE_URL_HERE",
  "record_key": "v",
  "exit_key": "esc",
  "auto_type_in_game": false,
  "scene_prompt": "",
  "hotwords": [],
  "profane_map": {}
}
```

| 字段 | 说明 |
|---|---|
| `api_key` | API 密钥 |
| `resource_id` | API 资源 ID |
| `recognize_url` | 识别接口地址 |
| `record_key` | 录音按键（按住录音，松开识别） |
| `exit_key` | 退出按键 |
| `auto_type_in_game` | 是否自动模拟键盘输入到当前窗口 |
| `hotwords` | 热词列表，提升识别准确率 |
| `profane_map` | 脏话替换，格式 `{"脏话": "替换词"}` |

### 运行 Demo

纯终端模式，无 GUI：

```bash
python demo.py
```

按住 `V` 键说话，松开后自动识别并输出结果。

### 运行 GUI

```bash
python -m spellvoice
```

## 项目结构

```
spellVoice/
├── __init__.py      # 包入口
├── config.py        # 配置读写
├── stt_core.py      # 核心引擎（录音、识别、输入模拟）
├── gui.py           # 主窗口 GUI
├── settings.py      # 设置窗口 GUI
├── demo.py          # 终端 Demo
├── config.json      # 配置文件
└── requirements.txt # 依赖
```

## 依赖

- [PyQt6](https://pypi.org/project/PyQt6/) - GUI 框架
- [pyaudio](https://pypi.org/project/pyaudio/) - 音频录制
- [requests](https://pypi.org/project/requests/) - HTTP 请求
- [keyboard](https://pypi.org/project/keyboard/) - 全局按键监听
- [pyperclip](https://pypi.org/project/pyperclip/) - 剪贴板操作

## License

MIT