Update README.

README.md

@@ -151,9 +151,7 @@ uv pip install numpy==1.26.4
 pip install numpy==1.26.4
 ```
 
-### 🎮 运行系统
-
-`VoiceDialogue` 支持两种运行模式：**命令行模式 (CLI)** 和 **API 服务模式**。
+### 🖥️ 应用模式
 
 #### 1. 命令行模式 (默认)
 
@@ -161,18 +159,14 @@ pip install numpy==1.26.4
 
 ```bash
 # 启动语音对话系统 (默认使用中文，沈逸角色)
-uv run main.py
-# 或
 python main.py
+# 或使用 uv
+uv run main.py
 
 # 指定语言和角色
-uv run main.py --language en --speaker Heart
-# 或
 python main.py --language en --speaker Heart
 
-# 查看所有可用角色
-uv run main.py --help
-# 或
+# 查看所有可用参数
 python main.py --help
 ```
 
@@ -187,6 +181,8 @@ python main.py --help
 ```bash
 # 启动 API 服务器
 python main.py --mode api
+# 或使用 uv
+uv run main.py --mode api
 
 # 指定不同端口和启用热重载
 python main.py --mode api --port 9000 --reload
@@ -198,6 +194,10 @@ python main.py --mode api --port 9000 --reload
 - 实时模型状态监控
 - RESTful API 设计
 
+#### 3. 桌面应用模式 (Electron)
+提供图形界面的桌面应用程序。
+
+
 ## ⚙️ 配置选项
 
 ### 启动参数
@@ -236,6 +236,32 @@ python main.py --mode api --port 9000 --reload
 - **文件位置**: `src/VoiceDialogue/services/text/generator.py`
 - **自定义**: 你可以修改系统提示词变量的值。
 
+### 构建完整应用
+项目提供了完整的构建脚本，可以一键构建包含Python后端和Electron前端的完整应用：
+
+1. 首先，激活当前 Python 环境
+
+```bash
+source .venv/bin/activate
+# 或使用 conda
+conda activate voicedialogue
+```
+
+2. 使用构建脚本
+
+```bash
+# 使用构建脚本（推荐）
+bash scripts/build.sh
+
+# 或分别构建
+bash scripts/build-python.sh  # 构建Python后端
+bash scripts/build-electron.sh # 构建Electron前端
+
+# 清理构建产物
+bash scripts/clean.sh
+```
+
+
 ## 📁 项目结构
 
 ```text
@@ -244,46 +270,27 @@ VoiceDialogue/
 │   └── voice_dialogue/                # 主要源代码目录
 │       ├── __init__.py               # 包初始化文件
 │       ├── cli/                      # 命令行界面模块
-│       │   ├── __init__.py
 │       │   └── args.py               # 命令行参数解析
 │       ├── api/                      # Web API 模块 (FastAPI)
-│       │   ├── __init__.py
 │       │   ├── app.py                # FastAPI 应用实例
 │       │   ├── server.py             # uvicorn 服务器
 │       │   ├── core/                 # API 核心配置
 │       │   ├── routes/               # API 路由
-│       │   │   ├── __init__.py
-│       │   │   ├── asr_routes.py     # 语音识别路由
-│       │   │   ├── tts_routes.py     # 文本转语音路由
-│       │   │   ├── system_routes.py  # 系统管理路由
-│       │   │   └── websocket_routes.py # WebSocket 路由
 │       │   ├── schemas/              # 数据模型
 │       │   ├── dependencies/         # API 依赖项
 │       │   └── middleware/           # 中间件
 │       ├── config/                   # 配置管理
-│       │   └── paths.py              # 路径配置
+│       │   ├── paths.py              # 路径配置
+│       │   └── speaker_config.py     # 说话人配置
 │       ├── core/                     # 核心模块
 │       │   ├── constants.py          # 全局常量和队列
 │       │   └── launcher.py           # 系统启动器
 │       ├── models/                   # 数据模型和任务
-│       │   ├── language_model.py     # 语言模型定义
-│       │   └── voice_task.py         # 语音任务定义
 │       ├── services/                 # 服务模块
 │       │   ├── audio/                # 音频处理服务
-│       │   │   ├── capture.py        # 回声消除音频捕获
-│       │   │   ├── player.py         # 音频播放
-│       │   │   ├── generator.py      # TTS 音频生成器
-│       │   │   └── generators/       # TTS 引擎管理
 │       │   ├── speech/               # 语音识别服务
-│       │   │   ├── monitor.py        # 语音状态监控
-│       │   │   ├── recognizer.py     # ASR 识别服务
-│       │   │   └── recognizers/      # ASR 引擎管理
 │       │   └── text/                 # 文本生成服务
-│       │       └── generator.py      # LLM 文本生成
 │       └── utils/                    # 工具函数
-├── third_party/                      # 第三方库
-│   ├── moyoyo_tts/                   # GPT-SoVITs TTS 引擎
-│   └── AECAudioRecorder/             # 回声消除音频录制器
 ├── electron-app/                     # Electron 桌面应用
 │   ├── main.js                       # Electron 主进程
 │   ├── preload.js                    # 预加载脚本
@@ -298,17 +305,16 @@ VoiceDialogue/
 │   ├── build-python.sh               # Python 打包脚本
 │   ├── build-electron.sh             # Electron 打包脚本
 │   └── clean.sh                      # 清理脚本
-├── tests/                            # 测试文件
-├── docs/                             # 文档目录
+├── third_party/                      # 第三方库
+│   ├── moyoyo_tts/                   # GPT-SoVITs TTS 引擎
+│   └── AECAudioRecorder/             # 回声消除音频录制器
+├── assets/                           # 资源文件
 ├── dist/                             # 分发包输出目录
 ├── build/                            # 构建临时文件
-├── assets/                           # 资源文件
-│   ├── models/                       # 模型文件存储
-│   ├── audio/                        # 音频资源
-│   ├── libraries/                    # 库文件
-│   └── www/                          # Web资源
-├── main.py                           # 项目启动入口（简化版）
-├── pyproject.toml                    # 项目配置文件 (uv/pip)
+├── tests/                            # 测试文件
+├── docs/                             # 文档目录
+├── main.py                           # 项目启动入口
+├── pyproject.toml                    # 项目配置文件 (uv)
 ├── requirements.txt                  # Python 依赖
 ├── uv.lock                           # uv 锁定文件
 ├── .python-version                   # Python 版本配置
@@ -408,6 +414,21 @@ python --version
 # 如果版本过低，请升级或使用虚拟环境
 ```
 
+### 8. 桌面应用相关问题
+- **问题**: Electron 应用启动失败或功能异常。
+- **解决方案**: 
+  - 确保 Node.js 版本 >= 16
+  - 重新安装依赖：`cd electron-app && npm install`
+  - 检查 Python 后端是否正常运行
+
+### 9. 构建打包问题
+- **问题**: 使用构建脚本失败。
+- **解决方案**: 
+  - 确保有执行权限：`chmod +x scripts/*.sh`
+  - 检查所有依赖是否安装完成
+  - 查看具体错误日志进行调试
+
+  
 ## 📊 性能优化建议
 
 ### 硬件优化