MoYoYoTech/VoiceDialogue

1# 配置指南2 3本文档介绍如何配置 VoiceDialogue 系统。4 5## 启动参数6 7通过 `main.py` 的命令行参数可以方便地进行配置：8 9| 参数 | 缩写 | 可选值 | 默认值 | 描述 |10|---|---|---|---|---|11| `--mode` | `-m` | `cli`, `api` | `cli` | 设置运行模式 |12| `--language`| `-l` | `zh`, `en` | `zh` | (CLI模式) 设置用户语言 |13| `--speaker` | `-s` | (动态获取) | `沈逸` | (CLI模式) 设置TTS语音角色 |14| `--host` | | IP地址 | `0.0.0.0` | (API模式) 服务器主机 |15| `--port` | `-p` | 端口号 | `8000` | (API模式) 服务器端口 |16| `--reload`| | 无 | `False` | (API模式) 启用热重载 |17 18**支持的说话人角色**（动态加载）:19 20- **中文角色**：`罗翔`, `马保国`, `沈逸`, `杨幂`, `周杰伦`, `马云`21- **英文角色**：`Heart`, `Bella`, `Nicole`22 23## 高级配置24 25### 大语言模型 (LLM)26 27- **模型路径和参数**: LLM 的模型和推理参数目前在代码中硬编码，方便快速启动。28- **文件位置**: `src/VoiceDialogue/services/text/generator.py`29- **自定义**: 你可以修改 `LLMResponseGenerator` 类中的配置。30 31### 语音识别 (ASR)32 33- **引擎自动选择**: 系统会根据 `--language` 参数自动选择最合适的 ASR 引擎。34- **模型配置**: ASR 模型的具体配置位于 `src/VoiceDialogue/services/speech/recognizers/manager.py`。35 36### 系统提示词 (System Prompt)37 38- **功能**: 定义 AI 角色的行为和说话风格。39- **文件位置**: `src/VoiceDialogue/services/text/generator.py`40- **自定义**: 你可以修改系统提示词变量的值。41 42## 构建完整应用43 44项目提供了完整的构建脚本，可以一键构建包含Python后端和Electron前端的完整应用：45 461. 首先，激活当前 Python 环境47 48   ```bash49   source .venv/bin/activate50   # 或使用 conda51   conda activate voicedialogue52   ```53 542. 使用构建脚本55 56   ```bash57   # 使用构建脚本（推荐）58   bash scripts/build.sh59 60   # 或分别构建61   bash scripts/build-python.sh  # 构建Python后端62   bash scripts/build-electron.sh # 构建Electron前端63 64   # 清理构建产物65   bash scripts/clean.sh66   ```