v2.2.0 有什么新功能？​

VHDX 磁盘压缩（F-01）​

一条命令回收未使用的磁盘空间：

Compress-DistroNexusInstance -Name "Ubuntu-24.04"

使用 -WhatIf 进行空间估算演练，不实际修改磁盘。命令会在实例内运行 fstrim，然后调用 Optimize-VHD（Hyper-V）或回退至 diskpart。

Docker Desktop 集成管理（F-02）​

直接通过 PowerShell 管理 Docker Desktop 的 WSL 后端集成：

Get-DistroNexusDockerIntegration
Enable-DistroNexusDockerIntegration -Name "Ubuntu-24.04"
Disable-DistroNexusDockerIntegration -Name "Ubuntu-24.04"

备份调度（E-04）​

通过 Windows 任务计划程序安排自动备份：

New-DistroNexusBackupSchedule -Name "Ubuntu-24.04" -Frequency "Daily" -RetentionCount 7
Invoke-DistroNexusBackup -Name "Ubuntu-24.04"

实例标签（E-06）​

使用标签对实例进行分类管理：

Set-DistroNexusInstanceTag -Name "Ubuntu-24.04" -Tags "dev", "python"
Get-DistroNexusInstanceTag -Name "Ubuntu-24.04"

端口转发可视化（E-05）​

一览 WSL 实例内的监听端口：

Get-DistroNexusPortMapping -Name "Ubuntu-24.04"

更多增强​

• 导出 / 导入（E-01）：将实例备份和还原为 .tar 归档文件。
• 全局 .wslconfig 编辑器（E-02）：带安全防护的 WSL 全局配置读写。
• 实例资源配置（E-03）：查看和设置实例的稀疏 VHDX 模式。
• 主动缓存失效（E-07）：实例状态变化后自动刷新，实例列表始终最新。
• 统一错误码（E-09）：所有异常均携带结构化 DistroNexusErrorCode 类型码。

下载​

从 GitHub Releases 页面 获取 v2.2.0。

完整变更详情请参阅 v2.2.0 发行说明。

v2.1.1 的新功能？​

1. 模板选项 UI 增强​

客户端 UI 现在支持单选下拉列表之外的高级模板选项。模板现在可以定义 MultiSelect（呈现为复选框）和 Text（呈现为文本框）选项。像 database-local-stack 和 infra-cli-toolbox 这样的内置模板现在使用 MultiSelect 进行组件选择，而 dotnet-dev 和 go-dev 使用 Text 进行特定版本输入。

2. 包缓存同步​

我们修复了 C# 客户端和 PowerShell 后端对下载的包使用不同默认路径的错误。两者现在都默认使用 %APPDATA%\DistroNexus\packages。C# 客户端现在严格依赖 PowerShell 模块来评估 IsCached 状态，防止 UI 不同步。

3. 证据管道标准化​

我们引入了一个新的 PowerShell cmdlet，New-DistroNexusReleaseEvidenceBundle，它会自动将测试结果、lint 报告和回归差异收集到一个标准化的 JSON 工件中。这确保了所有未来的发布都具有确定性、可审计的工件。

4. 模板元数据验证​

为了保持我们内置模板的质量，我们添加了 Test-DistroNexusTemplateMetadata。此 linter 根据严格的模式验证 templates.json，输出详细的 JSON 报告，这些报告现在已集成到发布证据包中。

5. 自动化回归强化​

Invoke-DistroNexusTemplateAutomation 现在会生成历史回归差异，允许开发人员跟踪模板执行行为随时间的变化。我们还强化了回归基线的解析和排序，以防止在自动化测试期间出现误报。

治理和跟踪​

我们按时间顺序重新组织了项目跟踪文件，以提高可审计性和历史上下文。此外，我们通过新的交接模板和参考索引正式化了发布签核流程。

开始使用​

您可以从我们的 GitHub Releases 页面 下载最新版本。

有关更改的完整列表，请参阅 CHANGELOG.md。

感谢您使用 DistroNexus！

版本亮点​

• 加强了核心与安装向导链路中的模版执行与安装稳定性。
• CI 采用显式快速/全量测试分层策略，并新增 WSL2 验证通道。
• 包下载体验升级：支持字节级进度/速度显示与同文件包分组。
• 发布治理文档已同步（清单、证据追踪、本地化验证）。

完整变更覆盖（v2.0.3..v2.1.0）​

• b8e988a fix(powershell): normalize package cache path and filename resolution
• 50ea375 feat(download): add byte-level progress, speed metrics, and tests
• 75b087f feat(ui): improve download display and same-file package grouping
• 5e41c1b test(ui-automation): add package manager download flow coverage
• 5595eff docs(specs): add template-manager wizard improvement requirements
• 0c427d1 feat(wizard): support template-first startup and options step
• 5ee1078 fix(core): harden template execution and package install flows
• 8a02ca4 fix(ui): correct template apply log levels and toggle styling
• 2563edd test(ui): add screenshot regression verification baselines
• 193ae8a chore(docs): sync planning records and skill template
• 07fe349 docs(specs): add quality remediation requirements and checklists
• a5648dc feat(ci): align test scopes and add wsl validation lane
• d2388a7 docs(remediation): sync checklists and evidence tracking
• 77aeee4 docs(testing): align README and localization verification

升级说明​

推荐所有 v2.0.x 用户升级。
可从 GitHub Releases 下载安装包。

主要变更​

🔄 自动化发行版目录更新​

DistroNexus 现在会在构建过程中自动从微软官方 WSL 仓库拉取最新的发行版列表。这确保了新发布的版本总是包含最新的 Linux 发行版清单。

🐛 Bug 修复​

• 目录加载问题：修复了在加载缺少某些本地属性的发行版元数据时可能出现“属性未找到”错误的问题。
• 回退稳定性：增强了应用在无法访问在线目录时的健壮性，确保能够平滑回退到本地配置。
• ARM64 支持：改进了对目录中 ARM64 发行版变体的检测和处理。

更新方式​

您可以通过应用内更新器进行升级，或从我们的 GitHub Releases 页面下载最新安装包。

主要变更​

🔧 关键修复​

• 目录 URL 修正：修复了一个配置错误，原发行版目录 URL 指向不存在的 main 分支，现已更正为 master 分支。这将确保所有用户都能可靠地获取目录更新。

更新​

这是针对所有 v2.0.x 用户的推荐更新，以确保持续获取发行版更新。您可以通过应用内更新程序进行更新，或从 GitHub Releases 页面下载安装程序。

量化指标一览​

开发时间线：25 天从零到交付​

阶段 1：原型与 v1.0（1 月 22-25 日，4 天）​

• Day 1：初始脚本 → 项目结构 → UI 设计文档 → Go 项目初始化
• Day 2：Go/Fyne GUI 实现 → 安装/卸载 → CI 流水线 → v1.0.1 发布
• Day 3：需求文档 → 实例管理 → 包管理器 → 日志系统 → v1.0.2 发布
• Day 4：修复 → Docusaurus 官网搭建 → 部署上线

AI 交付了：完整的 Go/Fyne 桌面应用、GitHub Actions CI/CD、中英双语 README 和发布说明、Docusaurus 国际化官网。

阶段 2：架构重写 v2.0（1 月 27-31 日，5 天）​

• Day 5：需求 → PowerShell 模块（15 个 Cmdlet）→ .NET 解决方案 → Core 层 → WPF —— 一天内完成
• Day 6：WPF 应用完善 → 集成/打包/QA
• Day 7：向导框架 → 下载/缓存管理 → 日志展示 → 设置
• Day 8：模块配置优化
• Day 9：测试基础设施 → 集成验证 → legacy Go 代码清除

从 Go/Fyne 到 .NET 10/WPF 的完整重写是人类决策、AI 执行。核心骨架 —— PowerShell 模块 → .NET 解决方案 → Core → WPF —— 在一天内完成。

阶段 3：功能深化与国际化（2 月 1-8 日，5 天）​

• keep-alive 管理、同步设置重构
• 全量 i18n 国际化（英/中），覆盖 XAML/ViewModel/Core 三层
• 启动性能优化：窗口显示从 3-5s 降至 ~100ms
• 文档体系重构与归档制度建立

阶段 4：模板系统与发布（2 月 13-15 日，3 天）​

• 全栈模板系统（元数据 → 服务 → UI → PowerShell）
• 15 个内置模板（涵盖 .NET/Node.js/Python/Docker/K8s/数据库/AI-ML）
• 自动化测试套件（Pass/Fail/Blocked 分类）
• v2.0.1 发布，含中英双语发布说明与官网更新

AI 职责矩阵​

AI 协同编程的关键模式​

文档驱动开发​

最显著的模式。AI 在每个阶段都先产出文档, 再编写代码：

需求文档 → 任务分解 → 代码实现 → 测试文档 → 验收清单 → 归档

项目强制要求在复杂任务前创建"计划三件套"（task_plan.md、findings.md、progress.md）。45 份归档文档证明了严格的文档生命周期管理。

Copilot 指令协议​

.github/copilot-instructions.md 是人类与 AI 之间的"对齐协议"——定义语言规范、命名约定、编码模式和计划要求。它经历了多次迭代，反映了人类如何逐步优化与 AI 的协作界面。

技术栈重写：AI 执行，人类决策​

迭代式调试​

Git 日志揭示了典型的 AI 调试模式：90 分钟内 6 个连续 CI 修复提交、启动冻结问题的多文档诊断链、跨 XAML/C# 资源引用一致性修复。

关键洞察​

AI 带来效率倍增​

25 天完成了传统模式下可能需要数月的工作量——包含完整技术栈重写。总产出 50,000+ 行。人类精力聚焦于方向决策、需求确认和最终验收。

文档是 AI 的"记忆"​

文档量（20,384 行）接近源码量（26,918 行）。这不是过度文档化，而是 AI 协同编程的必然需求——每次会话的 AI 都需要高质量上下文来恢复状态并保持一致性。

Copilot 指令文件 = AI 的"工程文化"​

指令文件的多次迭代（简化 → 增加计划规则 → 文档管理规范）体现了人类如何逐步优化与 AI 的对齐。

人类决策者不可替代​

尽管 AI 完成了几乎所有执行工作，项目方向、技术栈迁移策略、发布节奏、质量门槛和推广策略仍然是人类决策。

致谢​

"AI completed nearly the entire end-to-end workflow of this project — from requirements research, development, and testing to release delivery, including this release notes document. With AI handling almost all execution work, I was finally able to invest time in the output I have wanted to create for a long time."

本分析基于 207 次 Git 提交和 100 份项目文档，由 AI 生成。

完整详细复盘：English ｜ 中文

为什么增加独立模板系统模块​

模板系统已经是 DistroNexus v2 的核心能力：

• 通过内置模板实现标准化环境引导
• 支持参数化执行与自动化验证工作流
• 桌面端与 PowerShell 模块能力统一

相比在每台机器重复手工配置，你可以直接复用模板化流程，在项目初期就保持团队环境一致。

为了让使用和维护更清晰，网站文档新增了独立的 Template System 模块。

模板系统包含什么​

从实现视角看，模板系统由三部分组成：

• 模板目录（config/templates.json），定义模板元数据与分类
• 模板脚本资源（config/templates/），在目标实例内执行环境配置
• 桌面端与 PowerShell 入口，用于交互式使用与自动化验证

这种设计让模板行为更透明，也更容易在多台机器上扩展和验证。

典型使用场景​

• 快速引导语言开发环境（如 .NET、Node.js、Python、Rust、Go）
• 为容器、数据库或全栈开发提供可复用的本地环境基线
• 在大范围应用前通过 dry-run 自动化验证模板变更

完整文档入口​

所有模板系统完整文档已在模块页集中提供：

• Template System 模块

模块包含以下文档链接：

1. 综合文档
2. 需求分析
3. 系统设计
4. 用户手册
5. 模板开发手册
6. 模板自动化测试套件手册

文档链接​

• 综合文档：https://lazyworkshop-create.github.io/DistroNexus/zh-Hans/template-system/comprehensive-guide
• 需求分析：https://lazyworkshop-create.github.io/DistroNexus/zh-Hans/template-system/requirements-analysis
• 系统设计：https://lazyworkshop-create.github.io/DistroNexus/zh-Hans/template-system/system-design
• 用户手册：https://lazyworkshop-create.github.io/DistroNexus/zh-Hans/template-system/user-manual
• 模板开发手册：https://lazyworkshop-create.github.io/DistroNexus/zh-Hans/template-system/template-development-manual
• 模板自动化测试套件手册：https://lazyworkshop-create.github.io/DistroNexus/zh-Hans/template-system/automation-test-suite-manual

如果你是首次接触模板系统，建议从模块页开始并按顺序阅读。

🎉 重大重构版本：.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 管理脚本

🔗 相关链接​

• GitHub 仓库： https://github.com/lazyworkshop-create/DistroNexus
• 项目文档： https://lazyworkshop-create.github.io/DistroNexus/
• 问题反馈： https://github.com/lazyworkshop-create/DistroNexus/issues
• 讨论区： https://github.com/lazyworkshop-create/DistroNexus/discussions

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

感谢你使用 DistroNexus！

🚀 核心功能​

• 高级实例管理：

  • 启动：在后台启动实例。
  • 打开终端：为正在运行的实例打开新的终端窗口（支持自定义启动目录）。
  • 停止：直接从界面强制终止正在运行的实例。
  • 移动：将 WSL 实例迁移到不同的驱动器或文件夹且无数据丢失（非常适合搬离 C 盘）。
  • 重命名：更改实例的显示/注册名称。
  • 凭据：轻松重置或设置默认用户凭据。

• 包管理器：

  • 在线源：从云端获取并更新最新的发行版列表。
  • 下载管理器：单独下载指定的发行版包以便稍后离线使用。
  • 查看本地缓存的发行版包。
  • 监控缓存的磁盘使用情况。
  • 删除未使用的包以释放空间。

• 强大的日志记录：

  • 新的集中式日志系统，覆盖所有 PowerShell 操作。
  • 日志存储在 logs/ 目录下，并自动轮换。

• 重设计的 UI/UX：

  • 现代布局：过渡到更整洁的布局，具有专用工具栏和可滚动的内容区域。
  • 交互式卡片：“我的安装”卡片现在集成了操作按钮，通过一键即可进行管理。
  • 改进的对话框：调整了“重命名”和“凭据”对话框的大小，以适应可变长度的文本。
  • 设置增强：添加文件夹选择器和“恢复默认设置”功能，配置更轻松。

🛠 修复与改进​

• 修复了直接下载时文件名推断失败的问题。
• 修复了终端打开路径的逻辑。
• 重构代码库以提高可维护性（UI 组件拆分）。

🚀 核心功能​

• 现代图形界面 (GUI)：基于 Fyne 构建的跨平台图形化仪表盘，可视化管理一切，无需记忆复杂的命令行参数。
• 自定义安装路径：将 WSL 发行版安装到您指定的任意目录或驱动器，不再受限于系统盘默认路径，彻底释放 C 盘空间。
• 多实例与多版本共存：轻松安装同一发行版的多个副本（例如 Ubuntu-Work 和 Ubuntu-Personal），或同时保留不同版本。
• 离线支持：自动下载并缓存官方 Appx/AppxBundle 安装包。一次下载，无限次安装。
• 安全稳健：内置校验机制，防止意外覆盖现有实例，确保安装过程安全可靠。
• 自动化支持：底层的 PowerShell 脚本完全支持无头/静默模式，满足高级用户和 CI/CD 流水线的自动化需求。

📦 包含内容​

• DistroNexus.exe: 包含内置高清图标的主 GUI 应用程序。
• PowerShell 脚本: 位于 scripts/ 目录下，负责处理下载和安装的核心逻辑。
• 配置: 位于 config/settings.json 的简易 JSON 配置文件。