跳转至

硬件与驱动管理器(linxira-hardware-driver-manager)

为什么存在

硬件探测只回答「有什么设备」,不回答「该装哪个驱动、会改哪些包、失败怎么回滚」。 把这两件事混在一起,用户只能看到一句「建议安装」,却不知道计划里到底有什么。 这个管理器把硬件事实变成可审阅的固定策略计划,并把真正执行交给唯一的系统事务后端。

职责边界

归它:

  • 读取 linxira-hwd-detector 的只读 JSON,并严格校验 schema、名称、版本与重复键。
  • 维护固定策略表:Intel / AMD Mesa、NVIDIA open / proprietary、Hyper-V / QEMU / VMware / VirtualBox guest。
  • 汇报已安装状态:仅 linux、linux-lts 及其 headers、DKMS、initramfs、已加载模块、重启标记。
  • 生成并原子保存计划(权限 0600,位于 $XDG_STATE_HOME/linxira/hardware-driver-manager/plans)。
  • 在界面里发起 root 拥有的只读诊断,并对三种 VM guest 策略发起经确认的安装事务。

不归它:

责任链:谁读、谁规划、谁改动

步骤 执行者 是否改动系统
采集硬件事实 硬件检测(无参 JSON) 只读
事实 → 固定策略 → 计划 本管理器 只读;计划只写用户状态目录
执行驱动安装、快照、服务校验 Components 系统事务服务 + Polkit 提权,需确认与 Timeshift 快照

本管理器的所有本地动作都止于「计划」。Apply 不是本程序执行的:它只是向 org.linxira.Components1 申请计划并请求确认执行,真正的包安装、服务启用与快照由事务后端完成。

怎么用

界面

应用菜单里的 Linxira Hardware and Driver Manager,或直接运行:

linxira-hardware-driver-manager

窗口分四个页签:

页签 内容
Overview 探测到的硬件类别 ID、检测器名称与版本、Run root diagnosis
Drivers 推荐策略、完整计划 JSON、Save plan 与 Apply
Kernel compatibility linux / linux-lts 的内核、headers 与 DKMS 表
Activity / report 完整只读报告 JSON

Drivers 页签只列出与已探测硬件类别匹配的策略;一个类都没匹配上时列表为空。 勾选 I reviewed this exact plan 才能保存计划;Apply 同样要求先勾选,并额外要求 该策略属于三种 VM guest、且计划本身 applicable,否则按钮保持禁用。不属于这三种 策略时,按钮提示为 Only applicable reviewed VM guest policies have an executable backend。

命令行

linxira-hardware-driver-manager --report-json
linxira-hardware-driver-manager --plan org.linxira.driver.intel-mesa.v1
linxira-hardware-driver-manager --plan org.linxira.driver.intel-mesa.v1 --json

--plan 只接受下面这些固定策略 ID,不接受任意包名、路径或命令。计划总是写入 $XDG_STATE_HOME/linxira/hardware-driver-manager/plans/(未设置时是 ~/.local/state/...),文件名取自计划自身的 SHA-256。不加 --json 时打印计划路径, 加 --json 时打印计划本身。计划可应用时退出码为 0,否则为 3;检测器不可用时 --report-json 与 --plan 都以退出码 2 结束。

策略 ID 硬件事实 当前状态
org.linxira.driver.intel-mesa.v1 graphics.intel 只生成计划,界面不提供 Apply
org.linxira.driver.amd-mesa.v1 graphics.amd 只生成计划,界面不提供 Apply
org.linxira.driver.nvidia-open-dkms.v1 graphics.nvidia 只生成计划;必须人工复核
org.linxira.driver.nvidia-proprietary-dkms.v1 graphics.nvidia 不可用:官方 Arch 仓库没有双内核的专有 NVIDIA DKMS 包
org.linxira.driver.vm-qemu-guest.v1 vm.qemu 界面可 Apply
org.linxira.driver.vm-virtualbox-guest.v1 vm.virtualbox 不可用:双内核 guest 模块供应方尚未修好
org.linxira.driver.vm-vmware-guest.v1 vm.vmware 界面可 Apply
org.linxira.driver.vm-hyperv-guest.v1 vm.hyperv 界面可 Apply

计划里记录:策略 ID、硬编码包集合、检测器文档摘要、许可证与驱动模型、内核 / headers 与 DKMS 前置条件、预期效果、warnings、blockers、适用性,以及计划自身的 SHA-256。 计划文件用私有权限原子写入;计划目录本身是符号链接时直接拒绝。

事务边界

这是本页最需要看清的部分:

  • 本地计划是审阅物,不是执行凭据。 CLI 生成的计划与界面里的预览都只描述 「如果执行会做什么」;CLI 没有 apply 子命令,计划的 apply 字段固定为 {"implemented": false, "result": "backend-not-ready"}。
  • 只读诊断走系统 D-Bus 上的 org.linxira.Components1:固定操作 org.linxira.hardware.driver-state-diagnose.v1、空参数对象、计划风险必须是 read-only。 用户在事务服务侧确认后,回执必须满足 status = succeeded 且 changed = false。 这一步不改包、不改服务、不改系统文件。
  • Apply 只对三种 VM guest 策略开放(Hyper-V、QEMU、VMware)。点击 Apply 时, 管理器先向事务服务申请一份 root 拥有、可审阅的驱动计划(风险必须是 system-change-reboot-possible,回滚方式必须是变更前的 Timeshift 快照);确认后由 后端创建快照、执行固定包集合、校验平台服务、留下不可变回执。仓库与硬件证据在两步 之间变化,计划即作废。
  • VirtualBox、NVIDIA proprietary 以及 Intel / AMD / NVIDIA 的普通显卡计划都没有 可执行后端,界面上的 Apply 保持不可用,提示为 Apply unavailable: backend-not-ready。

何时需要 root

  • 不需要:--report-json、--plan、界面的浏览、策略预览与计划保存。
  • 需要:Run root diagnosis 与三种 VM guest 的 Apply。两者都走系统事务服务, 由 Polkit 决定是否授权(需要时弹窗);管理器自己从不调用 sudo、pkexec 或包管理器。

已知限制

  • 支持矩阵只有 linux、linux-lts 及各自 headers;需要 DKMS 的策略在缺少所需内核时 直接给 blocker。
  • NVIDIA open 与 proprietary 是两种互斥方案,必须人工选择;不从 PCI 设备 ID 推断支持。 专有 DKMS 比较因缺少双内核包而阻塞。
  • 已安装状态只来自固定证据:uname -r、/usr/lib/modules、pacman -Q、dkms status、 /boot 下的 initramfs、/proc/modules、/proc/uptime 与 /run/reboot-required; 不扫描任意路径。
  • 检测器输出有 1 MiB 上限与 10 秒超时;检测器缺失时报告不可用(CLI 退出码 2)。
  • 计划目录与文件都拒绝符号链接,文件权限固定为 0600。
  • 内部子进程都是固定参数、shell=False、8 秒超时;不接受任何路径、包名或命令输入。

深入设计

当前行为与边界见 linxira-hardware-driver-manager README, 维护者约定见仓库的 AGENTS.md;事务形态见 Components。