VHD Mounter - 智能SEGA街机游戏VHD挂载管理和运行保活工具

✨ 核心特性

🔍 智能扫描与识别

• 全盘扫描：自动扫描所有固定磁盘驱动器的根目录
• 关键词过滤：精确识别包含 SDEZ、SDHD、SDDT 关键词的VHD文件
• 快速定位：优化的扫描算法，快速定位目标文件

💾 专业VHD管理

• 一键挂载：自动将VHD文件挂载到M盘
• 智能清理：挂载前自动分离现有VHD，避免冲突
• 安全卸载：程序退出时自动解除VHD挂载，保护数据安全

🎯 用户友好界面

• 全屏选择：多VHD文件时提供直观的全屏选择界面
• 实时状态：操作过程中显示详细的状态信息
• 键盘操作：支持方向键选择、回车确认、ESC退出

🔄 自动化运行

• 程序启动：根据文件名关键词自动选择启动目录（SDHD → bin，其余 → package），并执行 start.bat（目录名忽略大小写）
• 进程监控：持续监控 sinmai、chusanapp、mu3 相关进程
• 智能重启：目标进程异常退出时自动重新启动

🛡️ 系统保护

• 关机监听：监听Windows系统关机事件
• 安全退出：确保在系统关机前完成VHD卸载操作
• 资源保护：防止因异常退出导致的VHD资源占用

🚀 快速开始

系统要求

• 操作系统：Windows 10 1903+ / Windows 11
• 运行时：.NET 6.0 Runtime
• 权限：管理员权限（VHD操作必需）
• 硬件：至少1GB可用磁盘空间

安装与运行

方式一：直接运行（推荐）

1. 下载最新版本的可执行文件
2. 右键点击 → "以管理员身份运行"
3. 程序将自动开始扫描和挂载流程

方式二：从源码编译

# 克隆仓库
git clone https://github.com/username/vhdmount.git
cd vhdmount

# 编译项目
dotnet build --configuration Release

# 发布独立应用
dotnet publish --configuration Release --self-contained true --runtime win-x64

📖 使用指南

基本操作流程

1. 启动程序

   • 以管理员身份运行 VHDMounter.exe
   • 程序显示全屏白色界面并开始扫描

2. VHD文件选择

   • 单个文件：自动挂载
   • 多个文件：使用 ↑↓ 键选择，Enter 确认

3. 自动挂载与启动

   • VHD文件挂载到M盘
   • 自动搜索启动目录：SDHD → bin，其余 → package（忽略大小写）
   • 在上述目录执行 start.bat 文件

4. 后台监控

   • 程序最小化到系统托盘
   • 持续监控目标进程状态
   • 异常时自动重启应用

键盘快捷键

按键	功能
↑↓	在选择界面中切换选项
Enter	确认当前选择
Esc	安全退出程序

高级功能

调试模式

程序内置调试功能，可以通过以下方式启用：

# 启用详细日志输出
VHDMounter.exe --debug

自定义配置

• 目标关键词：可在源码中修改 TARGET_KEYWORDS 数组
• 监控进程：可在源码中修改 PROCESS_KEYWORDS 数组
• 挂载盘符：可在源码中修改 TARGET_DRIVE 常量

🔧 技术架构

核心技术栈

• UI框架：WPF (.NET 6.0)
• VHD操作：Windows DiskPart API
• 进程管理：System.Diagnostics
• 系统集成：Microsoft.Win32.SystemEvents
• 异步编程：async/await 模式

关键组件

VHDManager 类

• ScanForVHDFiles() - VHD文件扫描
• MountVHD() - VHD挂载操作
• UnmountVHD() - VHD卸载操作
• FindFolder(folderName) - 通用目录定位（忽略大小写）
• FindPackageFolder() - Package文件夹定位（对 FindFolder("package") 的封装）
• StartBatchFile() - 批处理文件启动
• IsTargetProcessRunning() - 进程状态检查

MainWindow 类

• 用户界面管理
• 系统事件监听
• 应用程序生命周期控制

安全机制

• 权限检查：启动时验证管理员权限
• 资源清理：异常情况下的资源自动释放
• 进程隔离：独立进程启动，避免相互影响
• 系统集成：响应系统关机事件，确保数据安全

🐛 故障排除

常见问题

Q: 程序启动后提示权限不足 A: 确保以管理员身份运行程序，VHD挂载操作需要管理员权限。

Q: 找不到符合条件的VHD文件 A: 检查VHD文件名是否包含SDEZ、SDHD或SDDT关键词，且文件位于磁盘根目录。

Q: VHD挂载失败 A: 检查M盘是否被其他程序占用，程序会自动尝试清理但可能需要手动处理。

Q: start.bat启动失败 A: 确认对应启动目录中存在 start.bat 文件（SDHD: bin；其他关键词: package），且目录名大小写不影响搜索和定位。

Q: 进程监控不工作 A: 检查目标程序是否正常运行，进程名是否包含预定义的关键词。

日志和调试

程序运行时会输出详细的调试信息到控制台，可以通过以下方式查看：

1. 在命令行中启动程序
2. 查看控制台输出的调试信息
3. 根据错误信息进行相应的故障排除

🤝 贡献指南

我们欢迎社区贡献！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

开发环境设置

# 安装依赖
dotnet restore

# 运行测试
dotnet test

# 启动调试
dotnet run --project VHDMounter.csproj

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 感谢 Microsoft 提供的 .NET 平台和 WPF 框架
• 感谢 Windows DiskPart 工具提供的VHD管理能力
• 感谢所有贡献者和用户的支持

---

注意：本工具仅供学习和研究使用，请确保遵守相关法律法规和软件许可协议。