Update README: clarify instructions, update paths, and refine directory structure documentation

README.md

@@ -141,9 +141,13 @@ brew install ffmpeg
 5. **安装额外依赖**
 ```bash
 # 安装 kokoro-onnx
+uv pip install kokoro-onnx
+# 或
 pip install kokoro-onnx
 
 # 重新安装指定版本的 numpy
+uv pip install numpy==1.26.4
+# 或
 pip install numpy==1.26.4
 ```
 
@@ -157,19 +161,19 @@ pip install numpy==1.26.4
 
 ```bash
 # 启动语音对话系统 (默认使用中文，沈逸角色)
-uv run src/VoiceDialogue/main.py
+uv run main.py
 # 或
-python src/VoiceDialogue/main.py
+python main.py
 
 # 指定语言和角色
-uv run src/VoiceDialogue/main.py --language en --speaker Heart
+uv run main.py --language en --speaker Heart
 # 或
-python src/VoiceDialogue/main.py --language en --speaker Heart
+python main.py --language en --speaker Heart
 
 # 查看所有可用角色
-uv run src/VoiceDialogue/main.py --help
+uv run main.py --help
 # 或
-python src/VoiceDialogue/main.py --help
+python main.py --help
 ```
 
 **首次运行说明**：
@@ -182,10 +186,10 @@ python src/VoiceDialogue/main.py --help
 
 ```bash
 # 启动 API 服务器
-python src/VoiceDialogue/main.py --mode api
+python main.py --mode api
 
 # 指定不同端口和启用热重载
-python src/VoiceDialogue/main.py --mode api --port 9000 --reload
+python main.py --mode api --port 9000 --reload
 ```
 
 **API 服务特性**：
@@ -237,47 +241,78 @@ python src/VoiceDialogue/main.py --mode api --port 9000 --reload
 ```text
 VoiceDialogue/
 ├── src/
-│   └── VoiceDialogue/
-│       ├── main.py              # 主程序入口
-│       ├── api/                 # Web API 模块 (FastAPI)
-│       │   ├── app.py           # FastAPI 应用实例
-│       │   ├── server.py        # uvicorn 服务器
-│       │   ├── core/            # 核心配置
-│       │   ├── routes/          # API 路由
-│       │   ├── schemas/         # 数据模型
-│       │   └── middleware/      # 中间件
-│       ├── config/              # 配置管理
-│       │   └── paths.py         # 路径配置
-│       ├── core/                # 核心模块
-│       │   └── constants.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 引擎
-├── tests/                       # 测试文件
-├── assets/                      # 资源文件
-│   ├── models/                  # 模型文件存储
-│   ├── audio/                   # 音频资源
-│   ├── libraries/               # 库文件
-│   └── www/                     # Web资源
-├── main.py                      # 项目启动入口（简化版）
-├── pyproject.toml               # 项目配置文件
-├── requirements.txt             # Python 依赖
-└── README.md                    # 项目说明文档
+│   └── 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              # 路径配置
+│       ├── 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                    # 预加载脚本
+│   ├── loading.html                  # 加载页面
+│   ├── utils.js                      # 工具函数
+│   ├── package.json                  # Electron 依赖配置
+│   ├── assets/                       # Electron 资源文件
+│   ├── build/                        # 构建配置
+│   └── python-dist/                  # Python 分发包
+├── scripts/                          # 构建和部署脚本
+│   ├── build.sh                      # 主构建脚本
+│   ├── build-python.sh               # Python 打包脚本
+│   ├── build-electron.sh             # Electron 打包脚本
+│   └── clean.sh                      # 清理脚本
+├── tests/                            # 测试文件
+├── docs/                             # 文档目录
+├── dist/                             # 分发包输出目录
+├── build/                            # 构建临时文件
+├── assets/                           # 资源文件
+│   ├── models/                       # 模型文件存储
+│   ├── audio/                        # 音频资源
+│   ├── libraries/                    # 库文件
+│   └── www/                          # Web资源
+├── main.py                           # 项目启动入口（简化版）
+├── pyproject.toml                    # 项目配置文件 (uv/pip)
+├── requirements.txt                  # Python 依赖
+├── uv.lock                           # uv 锁定文件
+├── .python-version                   # Python 版本配置
+└── README.md                         # 项目说明文档
 ```
 
 ## 🔧 系统架构