# GPU Stack Bootstrap

> Windows 11 + WSL2 Ubuntu 24.04 + RTX 5060 Ti (Blackwell) 全栈装机指南
>
> 目标读者：能看懂命令但没装过 NVIDIA 显卡+WSL2+CUDA 的新人

## 一句话 TL;DR

装 NVIDIA Studio 驱动（Windows）→ 装 CUDA Toolkit 12.8（WSL2）→ 装 PyTorch / Ollama / ComfyUI
→ 验证 `nvidia-smi` 看到 5060 Ti → 完事。

## 当前进度

| 章节 | 状态 | 验证方式 |
|------|------|------|
| [01 硬件与基础检查](./01-hardware-check.md) | ✅ 已跑通 | 装好显卡，nvidia-smi 能看到 |
| [02 Windows 装 Studio 驱动](./02-windows-driver.md) | ✅ 已跑通 | nvidia-smi 看到 5060 Ti + 610.47 |
| [03 WSL2 + CUDA 12.8](./03-wsl2-ubuntu.md) | ✅ 已跑通 | nvcc --version 显示 12.8 |
| [04 Ollama 装 LLM](./04-ollama-llm.md) | ✅ 已跑通 | qwen2.5:7b 聊天正常 |
| [05 PyTorch 验证](./05-pytorch-verify.md) | ✅ 已跑通 | 看到 `CUDA: True \| 5060 Ti`（torch 2.12.0）|
| [06 ComfyUI 装出图](./06-comfyui-image.md) | ✅ 已跑通 | 浏览器开 8188 出图（SDXL 6.94G）|
| [90 排错手册](./90-troubleshoot.md) | ✅ 已有 | 镜像源 / zstd / WSL2 透传失败 |

## 硬件清单

- **GPU**: NVIDIA GeForce RTX 5060 Ti (16 GB, Blackwell 架构, sm_120)
- **CPU**: AMD Ryzen 7 8845HS (实测)
- **OS**: Windows 11 + WSL2 Ubuntu 24.04 LTS
- **内存**: 32GB 起步

## 关键硬规则

1. **驱动必须 ≥ 560.94**（Blackwell 必需，5060 Ti 在 560.94 之前根本点不亮）
2. **WSL2 Ubuntu 内不能装 NVIDIA 驱动**（会和 Windows 驱动打架黑屏）—— 只装 CUDA Toolkit
3. **CUDA Toolkit 必须 ≥ 12.6**（Blackwell 必需，13.x 主流 wheel 还没出）
4. **PyTorch wheel 必须 `+cu128`**（不是 cu118/cu121/cu124，老版本不支持 Blackwell）
5. **模型放 D 盘**（`/mnt/d/`），系统盘别占满

## 推荐阅读顺序

1. 先看 [01 硬件与基础检查](./01-hardware-check.md) —— 确认你电脑符合
2. 严格按 02 → 03 → 04 跑，每步都看验证输出
3. 卡住先查 [90 排错手册](./90-troubleshoot.md)
4. 跑通后看 05 / 06 装实际工作负载

## 备份仓库

- **Gitea (主)**: https://git.errlens.top/hwd32/gpu-stack-bootstrap
- **GitCode (异地备份)**: https://gitcode.com/tupingr/gpu-stack-bootstrap

## 贡献

踩坑了补 [90 排错手册](./90-troubleshoot.md) 或直接提 PR。