# Hyper-V Switch

**Repository Path**: run_wind/hyper-v-switch

## Basic Information

- **Project Name**: Hyper-V Switch
- **Description**: 这是一个图形化界面的Hyper-V切换程序。
因为平时需要使用各种的虚拟机，有的必须用Hyper-V的安卓虚拟机，有的必须用 Vbox 这种不能开启 Hyper-V 的。每次去系统里面操作都太繁琐了，所以用AI生成了这个项目。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-07
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hyper-V 切换工具

一个简单易用的 Windows 工具，用于在 Hyper-V 和 VirtualBox 之间快速切换。

## 功能特性

- ✅ **一键切换**：快速启用或禁用 Hyper-V 功能
- ✅ **自动检测**：自动检测 Hyper-V 和 VirtualBox 的当前状态
- ✅ **权限管理**：自动检查管理员权限，支持一键提升
- ✅ **智能重启**：切换完成后提供自动重启选项
- ✅ **美观界面**：现代化的 UI 设计，操作直观
- ✅ **状态显示**：实时显示系统状态和详细提示

## 项目结构

```
Hyper-V Switch/
├── Models/                      # 数据模型
│   ├── ViewModelBase.cs         # ViewModel 基类
│   ├── StatusEnums.cs           # 状态枚举
│   └── SystemStatus.cs          # 系统状态模型
├── Services/                    # 服务层
│   ├── IHyperVService.cs        # Hyper-V 服务接口
│   ├── HyperVService.cs         # Hyper-V 服务实现
│   ├── IVirtualBoxService.cs    # VirtualBox 服务接口
│   ├── VirtualBoxService.cs     # VirtualBox 服务实现
│   ├── ISystemService.cs        # 系统服务接口
│   ├── SystemService.cs         # 系统服务实现
│   └── RelayCommand.cs          # 命令实现类
├── ViewModels/                  # 视图模型
│   └── MainViewModel.cs         # 主窗口 ViewModel
├── App.xaml                     # 应用程序资源
├── App.xaml.cs                  # 应用程序入口
├── MainWindow.xaml              # 主窗口 UI
├── MainWindow.xaml.cs           # 主窗口代码
└── README.md                    # 项目说明文档
```

## 使用说明

### 前提条件

1. Windows 10/11 专业版或企业版
2. .NET 9.0 或更高版本
3. 管理员权限（程序会自动检测并提示）

### 运行方法

1. 右键点击 "Hyper-V Switch.exe"
2. 选择 "以管理员身份运行"
3. 根据界面提示进行操作

### 切换 Hyper-V

#### 启用 Hyper-V
适用于以下场景：
- 使用 WSL2 (Windows Subsystem for Linux 2)
- 使用 Windows Sandbox
- 使用 Hyper-V 虚拟机
- 使用 Docker Desktop

#### 禁用 Hyper-V
适用于以下场景：
- 使用 Oracle VirtualBox
- 使用 VMware Workstation
- 使用其他需要禁用 Hyper-V 的虚拟化软件

### 注意事项

- ⚠️ **切换 Hyper-V 后必须重启系统**，新设置才会生效
- ⚠️ **重启前请保存所有工作**，避免数据丢失
- ⚠️ 禁用 Hyper-V 后，WSL2 和 Windows Sandbox 将无法使用
- ⚠️ 启用 Hyper-V 后，VirtualBox 的 64 位虚拟机将无法运行

## 技术栈

- **框架**: .NET 9.0
- **UI**: WPF (Windows Presentation Foundation)
- **架构模式**: MVVM (Model-View-ViewModel)
- **语言**: C# 12.0

## 开发说明

### 编译要求

- Visual Studio 2022 或 JetBrains Rider
- .NET 9.0 SDK
- Windows 10/11

### 构建命令

```bash
# 恢复依赖
dotnet restore

# 编译项目
dotnet build

# 运行程序
dotnet run
```

### 发布发布

```bash
# 发布为独立可执行文件
# dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true
dotnet publish -c Release
```

## 版本历史

### v1.0.0 (2026-01-07)
- ✨ 初始版本发布
- ✨ 实现 Hyper-V 开关功能
- ✨ 实现 VirtualBox 状态检测
- ✨ 实现管理员权限检查
- ✨ 实现自动重启功能
- ✨ 美观的用户界面

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！

## 联系方式

如有问题或建议，请通过 GitHub Issues 联系。

---

**注意**: 本工具仅用于切换 Hyper-V 功能，请确保在操作前备份重要数据。