更新助手(linxira-update)
为什么存在
滚动发行版的风险不在「更新」本身,而在「更新时没有退路」。Linxira OS 的答案
是把更新与快照做成一件事:每次更新前自动留下可引导的 Timeshift 快照,
出问题从 GRUB 快照菜单回到更新前的系统。linxira-update 负责这件事里
「检查与提醒」的半边——后台定时检查、托盘与桌面通知、Welcome 更新卡,
都读同一份状态文件;默认只提醒不动手。
职责边界
归它:检查全部已配置 pacman 仓库(Linxira 仓库加系统已启用的 Arch 仓库)的可用更新、
写 status.json、托盘图标与桌面通知、交互式全量升级、新闻与待重启服务提示、
开启 EnableAutoApply 后的快照+全自动升级。
不归它:
- 装软件不归它。组件安装走
linxira-component-manager(Config CLI 的stack也是转发到它),与更新共用同一套快照保护。 - 快照配置不归它。Timeshift 的启用与策略在
linxira-config的timeshift enable|disable|status。 - AUR 与 Flatpak 默认不碰。需在配置里显式 opt-in。
怎么用
安装完成后可以先手动走一遍完整流程:
linxira-update
之后日常可以只检查或让托盘提醒:
linxira-update --check # 只检查并通知(定时器会自动执行这一条)
linxira-update # 交互式全量升级
linxira-update --list # 只列更新不应用
linxira-update --tray # 托盘常驻(--tray --enable 同时写开机自启)
linxira-update --launch # 应用菜单与托盘点击执行的形式:在终端里打开交互流程
linxira-update --gen-config # 生成示例配置(--force 覆盖已有文件)
linxira-update --show-config # 显示当前配置
这些入口共用同一份状态:应用菜单的「Linxira Update」执行 --launch,
「Linxira Update Tray」与 linxira-update-tray.service 执行 --tray(包还附带
/etc/xdg/autostart/linxira-update-tray.desktop,登录即启动托盘),
Welcome 的更新卡只读 status.json,不另跑一次检查。
状态文件 ~/.local/state/linxira-update/status.json:check_status
(ok/error/incomplete)、available_update_count、last_check、
reboot_required,自动更新路径还会写 auto_apply 与 pre_snapshot_id。
检查不完整时更新数为 0 不代表已是最新。
定时检查由 user timer linxira-update.timer 承担(开机 2 分钟后一次,之后每小时,
Persistent=true),随包 preset 80-linxira-update.preset 在首次登录时启用;
实际执行的是 linxira-update.service,它运行 linxira-update --check,
并带 LINXIRA_UPDATE_UNATTENDED=1 标记。Welcome 更新卡与托盘只是展示层。
更新前自动快照与全自动更新
- 在已启用 Timeshift 的装好系统上,任何 pacman 事务前都有 PreTransaction 钩子自动创建 Timeshift
快照(保留最近 20 个);在 Timeshift 与 grub-btrfs 配置齐备时,快照自动进
GRUB 菜单,可只读引导验证后回滚。
详见 wiki 的
updates-and-snapshots主题(linxira-wiki show updates-and-snapshots)。 - 在
~/.config/linxira-update/linxira-update.conf加一行EnableAutoApply可开启全自动更新:默认关闭。开启后只由无人值守的linxira-update.service触发, 托盘与终端里的手动--check永远不会自动应用。硬门控有五项:btrfs 根文件系统、 Timeshift 已配置、mkinitcpio的HOOKS含grub-btrfs-overlayfs、grub-btrfsd已启用、存在可用的提权命令。全部通过才显式创建并校验快照 (timeshift --create,再按注释确认快照入列),随后执行pacman -Syu --noconfirm;任一环节失败就保留「只检查+通知」并记录原因。
何时需要 root
检查、列表、托盘、通知与 --gen-config/--show-config 都不需要 root。
应用更新时由它通过 PrivilegeElevationCommand 提权,该键只接受
sudo、sudo-rs、doas、run0,默认 sudo。自动应用路径使用
pacman -Syu --noconfirm,仅做全量升级,绝不做部分升级。
已知限制
- AUR 与 Flatpak 默认关闭,必须在配置文件里显式写
EnableAUR/EnableFlatpak。 名字为linxira或以linxira-开头的已安装外部包永远不会交给 AUR helper; 没有 pacman 仓库提供它们时,检查结果记为 incomplete。 available_update_count为 0 时,只有check_status也是ok才能理解为「已是最新」。- 自动更新只在无人值守服务里生效;在终端或托盘手动检查不会自动应用,即使门控全部满足。
- pacman PreTransaction 钩子在
timeshift.json存在时创建更新前快照,保留最近 20 个; 钩子里快照失败用|| true兜底,不会中止 pacman 事务,所以「有快照」不能当作绝对保证。 - 钩子对 Upgrade / Install / Remove 都生效;
Linxira 初始快照永不修剪, boot 与 daily 快照各保留最近 3 个。 - 更新检查不代替 Arch 新闻阅读:新闻提示只在交互流程里出现,自动路径只做包升级。
--tray --enable通过复制 XDG autostart 条目实现;目标文件已存在时会直接报错, 不会覆盖你已有的登录项。
深入设计
内部实现见 linxira-update
仓库的 README-LINXIRA.md
与 doc/man/;命令面与全部配置键速查见 wiki 的 update-cli 主题。