联想拯救者 Y9000X 2022 修复声卡和安装电池保护教程 (Debian 12)
🚨 关键警告:驱动安装的最终步骤必须使用 root 权限
本教程假设您已解决网络问题,并已启用华为云或其他国内镜像源。
前置清理与核心环境准备
步骤 1:卸载冲突驱动与安装所有依赖 (一次完成)
我们需要先卸载与新驱动冲突的 TLP,并一次性安装所有 编译工具、DKMS 核心 以及 GUI/传感器 所需的 Python 依赖。
# 卸载 TLP,避免与新驱动的电源/电池管理冲突
sudo apt purge tlp tlp-rdw
sudo apt autoremove
# 更新软件包列表
sudo apt update
# 一次性安装所有必需依赖:核心编译工具、DKMS、GUI/Python 依赖、传感器工具、电源集成
sudo apt install -y make gcc linux-headers-$(uname -r) build-essential git dkms openssl mokutil \
lm-sensors python3-pyqt6 python3-yaml python3-venv python3-pip python3-argcomplete python3-darkdetect power-profiles-daemon powerprofilesctl firmware-iwlwifi firmware-linux-nonfree
注意:
firmware-iwlwifi和firmware-linux-nonfree是关键固件包,用于修复 Wi-Fi (AX211) 和 Intel 核显 (iGPU) 的警告。
步骤 2:内核升级(防范硬件缺失)
虽然驱动已编译,但确保内核最新是最佳实践。
# 查看内核版本
uname -r
# 从 backports 安装最新的内核(如果已安装最新版,该命令会跳过)
sudo apt install -t bookworm-backports linux-image-amd64
# 更新启动映像,将新内核和固件打包,为重启做准备 (关键)
sudo update-initramfs -u
🛠️ 核心驱动安装 (LenovoLegionLinux)
步骤 3:获取驱动代码并安装 DKMS 模块
我们使用 DKMS 机制安装,确保驱动在未来内核更新时自动重编译。
# 确保在 /root/ 家目录操作
cd ~
# 克隆仓库
git clone [https://github.com/johnfanv2/LenovoLegionLinux.git](https://github.com/johnfanv2/LenovoLegionLinux.git)
# 进入驱动核心模块目录
cd LenovoLegionLinux/kernel_module
# 使用 make dkms 进行自动安装
sudo make dkms
步骤 4:重启系统 (加载新内核和驱动)
执行重启,使内核、驱动和固件生效。
sudo reboot
⚙️ 高级功能与 GUI 启用 (解决 Python 隔离问题)
重启后,声卡和 Wi-Fi 应该已恢复。 现在,我们启用电池保护和风扇控制 GUI。
步骤 5:准备 Python 虚拟环境 (解决权限隔离)
为了运行 GUI,我们必须在 root 用户的仓库中重建虚拟环境。
# 确保您在 /root/LenovoLegionLinux 目录中 (如果不在,请 cd ~/LenovoLegionLinux)
# 创建虚拟环境
python3 -m venv venv
# 激活虚拟环境
source venv/bin/activate
# 安装 GUI 剩余依赖 (确保 Pillow, PyQt6 等都在 venv 中)
pip install PyQt6 Pillow pyyaml argcomplete darkdetect
步骤 6:授权和启动 GUI (启用电池保护)
由于您需要 root 权限操作硬件,但 GUI 需要访问您的普通用户图形界面,必须授权和设置 DISPLAY 变量。
-
回到普通用户终端 (
will@debian:~$),执行授权:xhost +si:localuser:root -
切换回 Root 终端并启动 GUI:
su - cd ~/LenovoLegionLinux # 查找 DISPLAY 变量并设置 (通常是 :1) export DISPLAY=:1 # 使用 venv 解释器的绝对路径启动 GUI /root/LenovoLegionLinux/venv/bin/python python/legion_linux/legion_linux/legion_gui.pyGUI 启动后,点击 Other Options 标签页,勾选 Battery Conservation 即可启用电池保护。
步骤 7:善后清理(重要)
GUI 设置完成后,请务必执行以下步骤,恢复系统安全设置:
- 关闭 GUI 程序。
- 回到普通用户终端(
will@debian:~$)运行:xhost -si:localuser:root