跳到主要内容

DistroNexus v2.0.1 - .NET 10 + WPF 基线版本

· 阅读需 5 分钟

DistroNexus v2.0.1 是首个 v2 基线版本，产品已升级为原生 .NET 10 + WPF 架构，并引入模块化自动化命令平台。

🎉 重大重构版本：.NET 10 + WPF​

DistroNexus 2.0.1 是 v2 的首个正式版本，产品从 v1.x 分支（最新版本：v1.0.2）升级到基于 .NET 10 + WPF 的全新架构。

✨ v2 新增与升级​

完整架构重构​

  • 桌面端 UI 从 Go/Fyne 全面迁移到原生 WPF
  • 基于 .NET 10 的现代化应用技术栈
  • 使用 CommunityToolkit.Mvvm 的 MVVM 架构
  • 使用 Microsoft.Extensions.DependencyInjection 构建依赖注入体系
  • 长耗时任务采用 async/await 异步执行模型

现代化 UI 与交互体验​

  • 基于 WPF-UI 的 Fluent Design 风格界面
  • 支持深色模式与更一致的视觉主题
  • 操作过程支持更清晰的状态与进度反馈
  • 设置与诊断体验增强

产品与文档双语支持​

  • v2.0.1 在 WPF 桌面客户端与项目文档中均提供英文与简体中文双语支持。
  • 核心 UI 界面、发布说明与关键操作参考均提供双语内容，提升全球与中文用户可达性。
  • 内容与本地化结构在多语言间保持一致，降低后续版本更新中的内容漂移风险。

PowerShell 模块平台（15 个 Cmdlet）​

  • 以模块化命令体系替代旧版独立脚本
  • 导出命令如下：
    • Get-DistroNexusInstance
    • Start-DistroNexusInstance
    • Stop-DistroNexusInstance
    • Move-DistroNexusInstance
    • Rename-DistroNexusInstance
    • Remove-DistroNexusInstance
    • Install-DistroNexusInstance
    • Set-DistroNexusCredential
    • Get-DistroNexusPackage
    • Save-DistroNexusPackage
    • Remove-DistroNexusPackage
    • Update-DistroNexusCatalog
    • Get-DistroNexusTemplate
    • Apply-DistroNexusTemplate
    • Invoke-DistroNexusTemplateAutomation

内置模板系统​

  • 提供内置环境模板，快速完成开发环境初始化
  • 模板元数据：config/templates.json
  • 模板脚本资源：config/templates/
  • 覆盖常见开发场景（语言运行时、容器、本地开发栈）
  • 支持参数化模板执行与自动化验证流程

目录与配置契约统一​

  • 发行版目录统一为 catalog.json
  • 设置文件统一在 %APPDATA%\DistroNexus\settings.json
  • 发布与运行时路径契约进一步一致化

仓库与发布清理​

  • 移除遗留 v1.0 Go/Fyne 源码与构建脚本
  • 旧版独立 PowerShell 脚本迁移为模块化命令工作流
  • 历史对比资料归档，仓库结构更清晰
  • 模块/构建/安装器默认版本统一到 2.0.1

📦 安装方式​

系统要求​

  • Windows 10 2004 及以上，或 Windows 11
  • .NET 10 Desktop Runtime（安装器会处理运行时依赖）
  • 已启用 WSL2（完整功能必需）

快速开始​

  1. 下载 DistroNexus-2.0.1-Setup.exe
  2. 运行安装程序
  3. 从开始菜单启动 DistroNexus

便携版​

下载 DistroNexus-v2.0.1-Release.zip：

  1. 解压到任意目录
  2. 运行 DistroNexus.Desktop.exe

自包含版​

下载 DistroNexus-v2.0.1-Release-selfcontained.zip：

  1. 解压到任意目录
  2. 运行 DistroNexus.Desktop.exe

🔄 从 v1.x（最新：v1.0.2）升级说明​

破坏性变更​

  • Go/Fyne UI 已移除，替换为 WPF
  • 旧版脚本式调用迁移为模块化 Cmdlet 调用
  • 运行时配置契约已按 v2 标准统一

保留能力​

  • 现有 WSL 实例可继续使用
  • 核心实例生命周期能力保留并增强
  • 自动化能力通过稳定模块命令面提供

✅ 测试验证摘要​

单元测试​

  • .NET 单元/集成测试套件通过
  • PowerShell Pester 单元/集成测试套件通过

UI 自动化测试​

  • 启动、导航、命令交互等核心流程已完成自动化验证
  • 发布关键 UI 路径未发现阻塞性回归

内置模版测试套件​

  • 内置模版自动化测试在“指定模版”和“全量执行”场景均可通过
  • 模版引导、参数化执行与验证流程满足发布基线要求

🔄 版本说明​

  • 本版本为 v2 基线版本，直接取代 v1.x 分支（最新：v1.0.2）
  • 升级后现有 WSL 实例可继续使用
  • 用户设置路径保持为 %APPDATA%\DistroNexus\settings.json

📝 变更汇总​

Added​

  • 基于 .NET 10 的原生 WPF 桌面客户端
  • 基于 PowerShell 模块的 15 个命令能力平台
  • 内置模版系统与自动化验证流程
  • 更完整的进度、日志与诊断能力

Changed​

  • 应用整体架构重构（UI + 服务层）
  • 目录与配置契约统一（catalog.json + %APPDATA% 设置）
  • 发布与构建元数据统一到 v2.0.1

Removed​

  • v1.0 Go/Fyne 相关实现与产物
  • 旧版独立 PowerShell 管理脚本

🔗 相关链接​

致谢：AI 在本项目中几乎完成了从需求调研、开发实现、测试验证到发布交付的全流程工作（包括当前发布日志文档）。正因为 AI 承担了近乎全部执行环节，我终于得以把时间投入到一直想完成的输出上。

感谢你使用 DistroNexus！