项目文档

选择您感兴趣的项目类型来深入学习 Verdure Assistant 的不同实现。

🚀 项目概览

Verdure Assistant 提供四种不同的项目实现，每种都针对特定的使用场景和平台进行了优化。

项目对比

项目类型	平台支持	难度	适用场景	推荐学习顺序
Console 控制台	Windows/Linux/macOS	⭐⭐	学习核心架构，服务器部署	1️⃣ 首选
WinUI 桌面应用	Windows 10+	⭐⭐⭐	Windows 桌面用户界面	2️⃣
API 服务	Windows/Linux/macOS	⭐⭐⭐⭐	树莓派机器人，IoT集成	3️⃣
MAUI 跨平台	Android/iOS/Windows/macOS	⭐⭐⭐⭐⭐	移动应用开发	4️⃣

📱 项目详情

Console 控制台应用

最佳入门选择 - 理解项目核心架构的理想起点

• ✅ 简单直接：命令行界面，专注于核心功能
• ✅ 跨平台兼容：在所有主要平台运行
• ✅ 学习友好：清晰的代码结构，易于理解
• ✅ 快速上手：最小的依赖和配置要求

适合人群：

• .NET 初学者
• 希望理解项目架构的开发者
• 需要服务器部署的运维人员

开始学习 Console 项目 →

---

WinUI 桌面应用

现代 Windows 应用开发 - 体验最新的 Windows 应用界面

• 🖥️ 现代 UI：基于 WinUI 3 的流畅界面
• 🎤 可视化交互：实时语音波形和状态显示
• ⚙️ 图形化配置：无需手动编辑配置文件
• 🎨 主题支持：浅色/深色主题自动切换

适合人群：

• Windows 应用开发者
• UI/UX 设计师
• 桌面应用用户

开始学习 WinUI 项目 →

---

API 服务

服务端开发 - 构建强大的后端服务

• 🤖 IoT 集成：专为树莓派等嵌入式设备优化
• 📡 实时通信：WebSocket 双向通信支持
• 🌐 RESTful API：标准化的接口设计
• 🔧 设备管理：完整的设备注册和监控系统

适合人群：

• 后端开发工程师
• IoT/硬件工程师
• 系统架构师

开始学习 API 项目 →

---

MAUI 跨平台应用

移动应用开发 - 一套代码，多平台运行

• 📱 真正跨平台：Android、iOS、Windows、macOS
• 🎨 原生体验：平台特定的 UI 控件
• 🔄 离线支持：本地数据存储和同步
• 🔐 安全可靠：端到端加密和权限管理

适合人群：

• 移动应用开发者
• 跨平台技术爱好者
• 希望掌握 MAUI 的开发者

开始学习 MAUI 项目 →

🎯 学习建议

初学者路径

1. 从 Console 开始：理解核心概念和架构
2. 进入 WinUI：学习用户界面开发
3. 探索 API：掌握服务端开发
4. 挑战 MAUI：体验跨平台开发

经验开发者

根据您的兴趣和需求直接选择：

• 桌面应用开发者 → WinUI 项目
• 后端/API 开发者 → API 项目
• 移动应用开发者 → MAUI 项目
• 系统管理员 → Console 项目

全栈学习

如果您希望全面掌握整个技术栈，建议按以下顺序学习：

Console → API → WinUI → MAUI
  ↓       ↓       ↓        ↓
核心架构 → 服务端 → 桌面UI → 移动端

🛠️ 开发环境

所有项目都需要以下基础环境：

• .NET 9.0 SDK 或更高版本
• Visual Studio 2022 或 Visual Studio Code
• Git 版本控制

特定项目的额外要求请参考各项目的详细文档。

📚 相关资源

• 快速开始 - 5分钟上手指南
• 环境搭建 - 开发环境配置
• 技术栈介绍 - 了解使用的技术
• 项目架构 - 理解系统设计

---

选择一个项目开始您的 Verdure Assistant 学习之旅吧！每个项目都有详细的文档、示例代码和实践指导。