排查 Olares One eGPU 问题

开机卡住、系统无法识别 eGPU、运行中掉卡，或 Windows 报显卡驱动错误时，使用本文排查。

先尝试快速修复

平台	现象	检查方法
Olares OS	开机卡在 Olares logo	关闭 Olares One，断开 eGPU 后重新启动，再确认 Gen1 临时方案已安装并启用。
Olares OS	系统启动但看不到 eGPU	检查扩展坞供电、连接顺序和认证的雷电 5 线材。确认扩展坞连接到 Olares One 的雷电 5（USB-C）接口。
Olares OS	eGPU 在使用过程中掉卡	确认 Gen1 临时方案已生效。检查扩展坞供电是否充足，并确认显卡供电线已牢固连接。
Windows	内置显卡报错	清洁安装驱动后重启 Windows。

Olares OS 冷启动的正确顺序为：扩展坞通电 → 连接雷电线 → Olares One 开机。首次安装 Windows 驱动时，请按 Windows 设置指南中的顺序连接。

bash

lspci -nn | grep -i nvidia
nvidia-smi

输出中应同时显示内置显卡和 eGPU。要确认 Gen1 临时方案是否生效，请运行下方诊断脚本并查看 Summary。链路速率显示 2.5 GT/s PCIe 表示 Gen1 已生效。

下载 collect-egpu-info.sh。
在出现问题的那次开机后运行。如果上次开机卡住，可断开 eGPU 正常开机后再运行。系统保留相关日志时，报告也会包含上一次开机的日志。
bash
```
chmod +x collect-egpu-info.sh
sudo ./collect-egpu-info.sh
```
打开当前目录生成的 egpu-report-*.txt，查看 Summary。
- 如果运行脚本时 eGPU 仍然连接，但显示 External GPU detected : NO，请检查扩展坞供电、雷电 5 线材和雷电 5（USB-C）接口。
- 如果为了从开机卡住状态中恢复而主动断开了 eGPU，显示 External GPU detected : NO 属于正常现象。系统保留相关日志时，报告仍可能包含上一次开机的日志。

脚本不会修改系统设置或上传数据。它会读取系统信息，并在当前目录写入一份报告。报告包含系统与驱动版本、雷电和 PCIe 拓扑、链路速率、BAR 分配、临时方案状态及相关日志。

分享前检查报告

报告可能包含设备主机名、内核命令行、硬件拓扑和系统日志。公开分享前，请检查文件并删除不希望公开的信息。

准备以下信息：

检查截图，并删除不希望公开的个人信息或设备信息。

同时记录扩展坞与显卡型号、操作系统、连接方式、开机顺序、现象、发生概率和已尝试的操作。对于偶发的启动问题，请使用相同连接顺序完成数次冷启动，并记录每次结果。冷启动是指完全关闭 Olares One 后，再按推荐顺序给扩展坞通电、连接线材并启动 Olares One。

如果问题仍未解决，或者想讨论文档中未列出的硬件组合，可以前往 Olares 论坛发帖。建议尽量提供以下信息：

发帖前请检查诊断文件和截图，删除不希望公开的信息。