内核管理器(linxira-kernel-manager)
为什么存在
一台机器的内核状态分散在 uname、/usr/lib/modules、pacman、dkms、/boot
和 GRUB 环境里。用户想弄清「现在跑的是哪个内核、LTS 装没装、为什么提示要重启」,
通常要在五六个命令之间来回对照,还没有统一的证据。
内核管理器把这些状态收成一份只读报告,并把「装标准内核 / 下次进 LTS / 重建 initramfs / 刷新 GRUB」做成固定操作的计划。它是报告与计划工具,不是引导器写入工具。
职责边界
归它:
- 只读采集:运行内核 release、
linux/linux-lts的安装版本、pacman -Q包状态、dkms status、initramfs 与内核镜像、/proc/modules、/proc/cmdline、GRUB 菜单条目与grub-editenv list的 next/saved entry、重启标记。 - 只保留启动
linux或linux-lts这两个精确内核镜像的 GRUB 条目。 - 生成固定操作的显示型计划,记录前置条件、预期命令、预期效果、warnings、blockers 与计划摘要。
- 界面提供 Overview、Kernels、Boot、Activity / report 四个视图。
不归它:
- 不写 GRUB、不生成 initramfs、不安装或删除包、不改服务。
- 不支持自定义内核或第三方内核包。
- 不实现提权与事务后端;Apply 按钮固定不可用。内核包与驱动计划的交界在 硬件与驱动管理器。
责任链:谁读、谁规划、谁改动
| 步骤 | 执行者 | 是否改动系统 |
|---|---|---|
| 采集内核与引导状态 | 本管理器 | 只读 |
| 状态 → 固定操作计划 | 本管理器 | 只读;计划只写用户状态目录 |
| 安装内核 / 重建 initramfs / 写 GRUB | 目前没有执行者 | 未实现 |
第三行是本页最需要看清的事实:计划里的命令只是展示文本,当前没有任何组件会执行它们。 将来若接入执行能力,提权也只应走 Components 的 Polkit 路径。
怎么用
界面
应用菜单里的 Linxira Kernel Manager,或直接运行:
linxira-kernel-manager
| 页签 | 内容 |
|---|---|
| Overview | 运行内核 release、生效的下次启动内核、重启状态、warnings / blockers |
| Kernels | linux 与 linux-lts 的版本、release、headers、镜像数量;DKMS 逐内核记录 |
| Boot | 受支持的 GRUB 条目、normal / fallback / 内核镜像证据 |
| Activity / report | 选择固定操作、审阅完整计划、Save plan(Apply 不可用) |
在 Activity / report 页勾选 I reviewed this exact plan 才能保存计划;Apply 按钮
始终禁用,提示为 Apply backend is not ready。
命令行
linxira-kernel-manager --report-json
linxira-kernel-manager --plan org.linxira.kernel.ensure-standard.v1
linxira-kernel-manager --plan org.linxira.kernel.boot-lts-once.v1
linxira-kernel-manager --plan org.linxira.kernel.regenerate-initramfs.v1
linxira-kernel-manager --plan org.linxira.bootloader.refresh-grub.v1
--plan 打印 {path, plan}:计划原子写入
$XDG_STATE_HOME/linxira/kernel-manager/plans/(未设置时是
~/.local/state/...),文件名取自计划自身的 SHA-256。计划可应用时退出码为 0,
否则为 3——包括「已经无需变更」的情况。
| 操作 ID | 计划里展示的预期命令 |
|---|---|
org.linxira.kernel.ensure-standard.v1 |
/usr/bin/pacman -S --needed linux linux-headers linux-lts linux-lts-headers |
org.linxira.kernel.boot-lts-once.v1 |
/usr/bin/grub-reboot <detected-linux-lts-entry-id> |
org.linxira.kernel.regenerate-initramfs.v1 |
/usr/bin/mkinitcpio -P |
org.linxira.bootloader.refresh-grub.v1 |
/usr/bin/grub-mkconfig -o /boot/grub/grub.cfg |
这些命令是展示文本(expected.displayOnly = true),不是执行凭据。
事务边界
- 计划里
apply固定为{"implemented": false, "result": "backend-not-ready"}; 界面上的 Apply 按钮始终禁用,系统事务服务里也没有对应的内核/bootloader 操作。 - 计划有源报告摘要(
sourceReportSha256)与自身摘要(planSha256);前置条件包括 固定支持矩阵、包状态可读、目标内核是否安装、GRUB 条目是否唯一等。 boot-lts-once要求恰好存在一个带安全 ID 的linux-ltsGRUB 条目;不唯一就阻塞, 不会猜一个。refresh-grub只在 GRUB 配置可读且至少一个受支持内核已安装时才适用。
何时需要 root
目前不需要,也不提供。所有子命令都是只读或写用户自己的计划目录;程序不调用
sudo、pkexec、包管理器、服务写入、initramfs 生成或引导器写入。将来若接入
事务后端,授权也应走 Components 的 Polkit 路径。
已知限制
- 支持矩阵只有
linux、linux-lts、linux-headers、linux-lts-headers;自定义内核显式不支持。 - 只解析固定的
/boot/grub/grub.cfg与grub-editenv list;其他引导器不在范围内。 - GRUB 条目只在能解析出受支持内核镜像时保留;解析失败只会让计划阻塞,不会写入。
- 已安装状态只来自固定证据:
/usr/bin/uname -r、/usr/lib/modules、pacman -Q、dkms status、/boot、/proc/cmdline、/proc/modules与/run/reboot-required; 子进程都是固定参数、shell=False、8 秒超时。 - 计划目录逐级拒绝符号链接,文件权限为
0600。
深入设计
当前行为与边界见
linxira-kernel-manager README,
维护者约定见仓库的 AGENTS.md;内核与驱动的交界见
硬件与驱动管理器。