快速开始
欢迎来到绿荫助手（Verdure Assistant）的世界！本指南将帮助您快速了解和运行项目。
🎯 项目简介
绿荫助手是一个基于 .NET 9 的智能语音助手项目，提供了完整的语音交互解决方案。无论您是初学者还是有经验的开发者，都能从这个项目中学到现代 .NET 开发的精髓。
核心特性
- 🎤 语音交互：支持"你好小电"和"你好小娜"唤醒词
- 🌐 跨平台：支持 Windows、Linux、macOS
- 📱 多终端：API、MAUI、WinUI、Console 四种部署方式
- 🏗️ 现代架构：依赖注入、异步编程、模块化设计
🚀 5分钟快速体验
前提条件
确保您的开发环境满足以下要求：
- ✅ .NET 9.0 SDK 或更高版本
- ✅ Git 版本控制工具
- ✅ 代码编辑器（推荐 Visual Studio 2022 或 VS Code）
步骤一：克隆项目
bash
git clone https://github.com/maker-community/Verdure.Assistant.git
cd Verdure.Assistant步骤二：检查环境
验证 .NET 环境是否正确安装：
bash
dotnet --version
# 应该显示 9.0.x 或更高版本步骤三：构建项目
bash
# 还原 NuGet 包
dotnet restore
# 构建所有项目
dotnet build --configuration Release步骤四：运行控制台版本（推荐首次体验）
控制台版本是最简单的入门方式：
bash
cd src/Verdure.Assistant.Console
dotnet run您将看到类似以下的交互菜单：
===============================
绿荫助手 (Verdure Assistant)
===============================
请选择操作:
1. 开始语音对话
2. 停止语音对话
3. 切换对话状态 (自动模式)
4. 切换自动对话模式
5. 发送文本消息
6. 查看连接状态
7. 退出
===============================🎮 试用不同版本
WinUI 桌面应用（Windows 专用）
如果您使用 Windows 10/11，可以体验图形界面版本：
bash
cd src/Verdure.Assistant.WinUI
dotnet run特点：
- 现代化的 Windows 应用界面
- 可视化语音状态显示
- 直观的控制按钮
API 服务版本（适合服务器部署）
适合部署到服务器或树莓派：
bash
cd src/Verdure.Assistant.Api
dotnet run特点：
- RESTful API 接口
- 适合嵌入式设备
- 支持远程调用
📖 下一步学习
恭喜！您已经成功运行了绿荫助手。现在可以深入学习：
🏗️ 理解架构
🔧 开发环境
- 环境搭建 - 配置完整的开发环境
- Visual Studio 开发 - 使用 VS 进行开发
- VS Code 开发 - 使用轻量级编辑器开发
📱 深入项目
选择您感兴趣的项目类型深入学习：
- API 服务 - 学习后端服务开发
- MAUI 应用 - 掌握跨平台移动开发
- WinUI 应用 - 了解 Windows 桌面应用开发
- Console 应用 - 学习控制台应用开发
❓ 常见问题
Q: 运行时提示缺少依赖？
A: 确保已安装 .NET 9 SDK，并运行 dotnet restore 恢复包：
bash
dotnet restoreQ: Windows 上无法运行 WinUI 版本？
A: WinUI 需要 Windows 10 1809 或更高版本，确保系统满足要求：
bash
# 检查 Windows 版本
winverQ: 语音功能无法使用？
A: 语音功能需要：
- 麦克风权限
- 网络连接（连接到语音服务）
- 音频设备正常工作
Q: 编译出错？
A: 常见解决方案：
- 清理并重新构建：
dotnet clean && dotnet build - 检查 .NET 版本：
dotnet --version - 更新 Visual Studio 到最新版本
🔍 故障排除
如果遇到问题：
- 查看日志：控制台输出通常包含详细的错误信息
- 检查网络：确保能访问外部服务
- 验证权限：确保应用有必要的系统权限
- 查看文档：参考 故障排除指南
💬 获取帮助
现在您已经成功入门了绿荫助手！接下来选择您感兴趣的方向继续深入学习吧。🎉