bostrot/wsl2-distro-manager
项目简介
wsl2-distro-manager 是一款面向 Windows Subsystem for Linux（WSL）与 macOS 原生 Linux 虚拟机的图形化管理工具，旨在让开发者通过可视化界面完成发行版的安装、备份、迁移与配置，彻底告别繁琐的 CLI 参数记忆。其核心能力不止于 GUI 封装，更在于内置 AI Assistant、提供 MCP（Model Context Protocol）Server 供 Agent 调用，并支持通过 SSH 管理远程 WSL 实例，将本地虚拟化运维与智能体工作流无缝衔接。
技术亮点
- 原生跨平台虚拟化管理：同时支持 Windows 的 WSL2 和 macOS 的 Linux VM，抽象了底层虚拟化差异，统一管理 rootfs 镜像、发行版导入导出与默认版本切换。
- AI Assistant + MCP Server 双重智能集成：内置 LLM 驱动的对话式操作界面，能理解自然语言指令并执行环境配置；同时暴露 MCP Server，使任意 MCP 客户端（如 Claude Desktop、Cursor）可远程调用管理接口，让 Agent 直接操作 WSL 发行版生命周期。
- 远程 WSL over SSH：突破本地限制，通过 SSH 隧道管理远程机器上的 WSL 发行版，支持分布式开发环境统一纳管，业界同类工具较少具备此能力。
- 基于 Flutter 的轻量交互层：使用 Flutter 构建跨端 UI，渲染性能与动画流畅度优于传统 Electron 工具，同时保持窗口体积与内存占用可控。
- 配置即代码的备份/迁移：支持将发行版配置、已安装包、环境变量等快照导出为可复用文件，配合 rootfs 层差分备份，实现分钟级环境复制。
架构解析
该项目采用分层架构，自上而下分为三层。交互层基于 Flutter 构建跨平台图形界面，负责展示发行版列表、系统资源占用、文件系统树，并接受用户点击或自然语言输入。控制层是核心适配器，包含三部分：本机 WSL API 封装器，通过调用 wsl.exe 命令行接口或 Windows API 完成发行版注册与启停；SSH 远程客户端模块，使用 libssh2 或 Dart SSH 库建立加密通道并对远端执行等效指令；MCP Server 模块，遵循 Model Context Protocol 规范，将管理操作暴露为工具（tools）供 AI Agent 调用。数据层管理配置文件存储、rootfs 镜像缓存、备份快照索引，同时维护一个轻量级状态数据库（如 SQLite），用于追踪各 Linux 实例的元数据与 AI 对话上下文。整个架构通过事件总线解耦界面与后端，确保 AI 指令与用户操作共享同一套命令解析引擎。
适用场景
- 本地多发行版开发环境治理：同时维护 Ubuntu、Debian、Kali 等多个 WSL 实例的开发者，可一键切换默认系统、批量调整内存/CPU 配额，或克隆出干净的 CI/CD 验证环境。
- Docker/K8s 环境快速重建：在 WSL2 中运行 Docker Desktop 的团队，借助备份与迁移功能，可将配置好的 Docker 环境连同常用镜像的 rootfs 整体打包，在同事机器或新电脑上分钟级恢复。
- AI Agent 自动化运维：将 MCP Server 接入内部 Agent 平台，让 AI 根据任务自动创建并销毁隔离的 Linux 沙箱，用于安全测试、临时编译或运行不可信脚本。
- 远程办公/数据中心统一管理：开发者的日常机器位于公司内网，通过 SSH over WSL 管理功能，从个人笔记本远程操作几台跳板机上的 WSL 环境，无需额外安装桌面协议。
- macOS 与 Windows 混合开发：在 Mac 上运行原生 Linux 虚拟机进行 Linux 专属构建，同时管理远程 Windows 机器上的 WSL，使用同一套 GUI 降低双平台心智负担。
生态对比
- vs. Windows Terminal + wsl CLI：传统方式是开发者手动记忆
wsl --install -d Ubuntu、wsl --export等命令，无图形反馈，且无法可视化查看磁盘占用。本工具则提供实时列表和操作向导，并将其封装为可由 LLM/Agent 调用的 MCP 工具，大幅降低自动化接入门槛。 - vs. Docker Desktop / Rancher Desktop：这两者主要面向容器管理，虽能运行 WSL2 后端，但聚焦镜像与编排，不覆盖发行版 rootfs、用户配置、远程实例等系统级操作。wsl2-distro-manager 则将发行版视为“可迁移的虚拟机”，在安装/备份/网络配置层面粒度更细。
- vs. Vagrant / Multipass：它们用于创建统一样式的开发 VM，但绑定自家镜像格式与配置脚本，且对 WSL2 原生支持不足。本工具直接对接各发行版官方 rootfs，支持 Windows/macOS 双宿主，并且提供开箱即用的 AI 交互层，对智能体生态更友好。