需先验证thunderbolt链路是否被内核识别：执行lspci -nn | grep -i thunderbolt确认控制器状态为up；ls /sys/bus/thunderbolt/devices/非空；dmesg | grep -i "thunderbolt\|tb"含tb: registered日志；否则须物理重置。
麒麟OS连接外接显卡扩展坞后设备管理器无GPU条目、xrandr不显示独立显卡输出端口、系统报告中“PCI设备”列表缺失eGPU桥接器，说明系统未完成Thunderbolt链路握手或PCIe枚举失败，需从物理层到内核驱动逐级验证。
确认雷电链路是否被底层识别
这一步绕过图形界面和X Server，直查内核是否已发现扩展坞硬件。若此处无记录，后续所有驱动、xrandr、桌面设置均无效。
1、打开终端，执行：lspci -nn | grep -i thunderbolt，确认输出中含Thunderbolt控制器条目且状态为up；
2、执行：ls /sys/bus/thunderbolt/devices/，若目录为空或报No such file or directory，说明Thunderbolt总线未初始化；
3、执行：dmesg | grep -i "thunderbolt\|tb\|egpu"，查找是否有tb: registered或failed to enumerate类日志——出现后者即表明固件握手失败，必须返回物理重置；
4、若/sys/bus/thunderbolt/devices/下有编号目录（如0-1），进入该目录运行cat device_name，输出应为扩展坞型号（如Razer Core X Chroma）；【若输出乱码或为空，说明E-Marker芯片通信异常，线缆或坞站固件损坏】。
强制刷新Thunderbolt控制器与PCIe枚举
麒麟OS默认禁用部分PCIe热插拔策略，eGPU插入时可能被忽略。需手动触发内核重新扫描总线。
方法一：通过sysfs触发重扫描
1、先确认Thunderbolt控制器PCI地址：lspci | grep -i thunderbolt，记下类似00:15.0的地址；
2、执行：echo 1 | sudo tee /sys/bus/pci/devices/0000:00:15.0/remove；
3、等待2秒，再执行：echo 1 | sudo tee /sys/bus/pci/rescan；
4、立即运行：lspci -tv，查看树状结构中是否在Thunderbolt桥下新增了01:00.0 VGA compatible controller节点。
方法二：重启Thunderbolt服务（仅限Kylin V10 SP3+）
执行：sudo systemctl restart thunderbolt → 观察journalctl -u thunderbolt -n 20末尾是否有domain 0 online提示。
验证GPU驱动加载与Metal/Vulkan支持状态
即使PCIe设备已枚举，麒麟OS仍需对应开源驱动（amdgpu/nouveau）或闭源驱动（AMDGPU-PRO）才能启用渲染能力。国产系统常因内核模块签名或SELinux策略拦截加载。
1、执行：lspci -k -s $(lspci | grep -i "vga\|3d" | grep -i amd | head -n1 | awk '{print }')，检查Kernel driver in use是否为amdgpu；
2、若显示vfio-pci或空白，说明驱动被抢占或未绑定——运行：sudo modprobe amdgpu，再检查dmesg | tail -10有无amdgpu: initialized；
3、执行：glxinfo | grep "OpenGL renderer"，若仍显示llvmpipe或报错unable to open display，则需确认Xorg是否启用DRI3：grep -i dri /var/log/Xorg.0.log，应含DRI3 enabled；
4、对RX 6000/7000系列，麒麟OS默认内核（5.10.0-kylin）不包含RDNA2补丁，必须手动安装linux-image-extra包并启用amdgpu.si_support=1 amdgpu.cik_support=1内核参数。
检查供电协商与PD协议状态
eGPU扩展坞依赖USB-C PD协议获取足够功率启动PCIe链路。麒麟OS虽不提供图形化PD监控，但可通过底层接口确认电压电流是否达标。
1、执行：sudo apt install usbutils（如未安装）；
2、运行：sudo lsusb -v -d <vendor_id>:<product_id> 2>/dev/null | grep -A5 "Power"</product_id></vendor_id>，其中vendor_id可从lsusb中查得（如Razer为1532）；
3、关键看bMaxPower值：若显示500mA或900mA，说明仅协商到USB供电等级，【必须达到1500mA以上才可能驱动eGPU，否则会静默失败】；
4、若bMaxPower不足，断开所有其他Type-C外设→仅留扩展坞→执行：echo 'on' | sudo tee /sys/bus/usb/devices/<bus>-<port>/power/level</port></bus>（替换<bus>-<port></port></bus>为实际路径，如1-1.2）强制维持供电激活态。
禁用安全启动与重建initramfs
部分麒麟OS镜像启用Secure Boot后，会拒绝加载未签名的amdgpu固件或Thunderbolt用户空间代理，导致设备无法上线。
第一步：关闭Secure Boot
重启进入BIOS（开机按F2/F12），找到Security → Secure Boot选项，设为Disabled；
第二步：重建初始内存盘
1、执行：sudo update-initramfs -u -k all；
2、编辑/etc/default/grub，在GRUB_CMDLINE_LINUX_DEFAULT行末尾添加：rd.driver.pre=amdgpu thunderbolt.autosuspend=0；
3、运行：sudo update-grub → 重启。
