WSL 离线安装详细步骤
这是 OpenClacky Windows 安装指南 的子文档
⚠️ 执行约束（必须遵守）
- 强制使用离线版，严禁尝试在线
wsl --install - 每个需要用户操作的步骤后必须等待确认，禁止自动继续
- 下载文件后需告知用户路径并引导手动安装（不可代替用户操作 GUI）
步骤 1：启用 WSL 组件
Start-Process powershell -Verb RunAs -ArgumentList "dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart"
Start-Process powershell -Verb RunAs -ArgumentList "dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart"
完成后重启：
Restart-Computer
告知用户：
"WSL 组件已启用，系统需要重启。请重启后告诉我「已重启」，我将继续安装 Kernel。"
必须等待用户「已重启」后才能继续！
步骤 2：下载并安装 WSL Kernel
此步骤完全由用户手动操作，agent 不执行任何命令，只需告知用户：
"请将以下链接复制到浏览器下载 WSL Kernel 安装包：
https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi下载完成后，双击运行 wslupdatex64.msi 完成安装，然后告诉我结果。"
必须等待用户回复后才能继续！
如果用户遇到报错："This update only applies to machines with the Windows Subsystem for Linux"
说明步骤 1 的 WSL 组件尚未生效（可能重启未完成，或 dism 命令未成功执行）。
依次重新执行以下命令：
Start-Process powershell -Verb RunAs -ArgumentList "dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart"
Start-Process powershell -Verb RunAs -ArgumentList "dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart"
然后告知用户：
"WSL 组件已重新启用，请重启电脑后再次双击运行 wslupdatex64.msi 安装 Kernel，完成后告诉我「已安装」。"
必须等待用户「已安装」后才能继续！
步骤 3：验证 Kernel 安装
wsl --status
确认输出中包含 kernel 版本信息，无报错后继续。
步骤 4：下载 Ubuntu 镜像
此步骤完全由用户手动操作，agent 不执行任何命令，只需告知用户：
"请将以下链接复制到浏览器下载 Ubuntu 镜像（文件较大约 500MB，请耐心等待）：
https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cloud-images/wsl/jammy/20250318/ubuntu-jammy-wsl-amd64-ubuntu22.04lts.rootfs.tar.gz下载完成后告诉我「已下载」，我将继续下一步。"
必须等待用户「已下载」后才能继续！
收到确认后，执行以下命令找到下载的文件路径：
Get-ChildItem "$env:USERPROFILE\Downloads" -Filter "*.tar.gz" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 FullName, Length
将查到的完整路径记录下来，供步骤 5 使用。
步骤 5：导入 WSL
将下方命令中的 <ubuntu文件路径> 替换为步骤 4 查到的实际文件完整路径后执行：
$workdir = "$env:USERPROFILE\WSL\Ubuntu-22.04"
New-Item -ItemType Directory -Force -Path $workdir | Out-Null
wsl --import Ubuntu-22.04 $workdir "<ubuntu文件路径>"
验证：
wsl -l -v
输出中应包含 Ubuntu-22.04，状态为 Stopped 或 Running。