| # 项目结构 | |
| ```text | |
| VoiceDialogue/ | |
| ├── src/ | |
| │ └── voice_dialogue/ # 主要源代码目录 | |
| │ ├── __init__.py # 包初始化文件 | |
| │ ├── cli/ # 命令行界面模块 | |
| │ │ └── args.py # 命令行参数解析 | |
| │ ├── api/ # Web API 模块 (FastAPI) | |
| │ │ ├── app.py # FastAPI 应用实例 | |
| │ │ ├── server.py # uvicorn 服务器 | |
| │ │ ├── core/ # API 核心配置 | |
| │ │ ├── routes/ # API 路由 | |
| │ │ ├── schemas/ # 数据模型 | |
| │ │ ├── dependencies/ # API 依赖项 | |
| │ │ └── middleware/ # 中间件 | |
| │ ├── config/ # 配置管理 | |
| │ │ ├── paths.py # 路径配置 | |
| │ │ └── speaker_config.py # 说话人配置 | |
| │ ├── core/ # 核心模块 | |
| │ │ ├── constants.py # 全局常量和队列 | |
| │ │ └── launcher.py # 系统启动器 | |
| │ ├── models/ # 数据模型和任务 | |
| │ ├── services/ # 服务模块 | |
| │ │ ├── audio/ # 音频处理服务 | |
| │ │ ├── speech/ # 语音识别服务 | |
| │ │ └── text/ # 文本生成服务 | |
| │ └── utils/ # 工具函数 | |
| ├── 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 # 清理脚本 | |
| ├── third_party/ # 第三方库 | |
| │ ├── moyoyo_tts/ # GPT-SoVITs TTS 引擎 | |
| │ └── AECAudioRecorder/ # 回声消除音频录制器 | |
| ├── assets/ # 资源文件 | |
| ├── dist/ # 分发包输出目录 | |
| ├── build/ # 构建临时文件 | |
| ├── tests/ # 测试文件 | |
| ├── docs/ # 文档目录 | |
| ├── main.py # 项目启动入口 | |
| ├── pyproject.toml # 项目配置文件 (uv) | |
| ├── requirements.txt # Python 依赖 | |
| ├── uv.lock # uv 锁定文件 | |
| ├── .python-version # Python 版本配置 | |
| └── README.md # 项目说明文档 | |
| ``` |