快速配置系统运行时(linxira-component-manager)
为什么存在
应用之下还有一层东西:能力捆绑包、运行时、工具链、领域工作区。它们有依赖、
有互斥、有「必需」项,逐个 pacman -S 既看不清关系,也没法解释为什么要装。
linxira-component-manager 把这一层做成类似 Windows「启用或关闭功能」的
可展开三态树:勾选即请求安装,展开即可看到嵌套关系,确认前还能看到完整的计划。
图形界面、TUI 和命令行共用同一条事务核,四条入口(GUI、TUI、CLI、agent)
走的是同一个 plan → confirm → apply 链。
职责边界
归它:Catalog v3 捆绑包树的选择界面(GUI / TUI / CLI)、节点元数据与 选择文档预览、confirmation 之前的计划展示。
不归它:
- 不把组件 ID 展开成包名,也不直接调用任何包管理器。
- 不做计划、确认与特权执行。那三步在
linxira-components。 - 不做移除。Phase 1 只安装已就绪的软件包目标。
- 不定义元数据。bundle、角色、选择策略都来自 catalog。
委托出去的事务:三条入口最终都落到同一条链,归属方是
linxira-components——写入选择文档后执行 plan,
展示不可变的 request-plan.json,确认后执行
confirm --catalog ... --plan ... --output-dir ...,若存在
directPackageTargets 再通过 pkexec apply --confirmation ... 提权执行;回执由后端
写在 /var/lib/linxira/components/receipts。
三条入口自身都不提权:GUI、TUI 与 CLI 都不调用 sudo、不执行 pacman、不写回执,
也不把组件 ID 翻成包名。提权只可能来自 pkexec,且只发生在 apply 一步。
怎么用
图形界面
linxira-component-manager # 用默认 catalog
linxira-component-manager --catalog ./catalog-v3.json
linxira-component-manager --select component-fish # 预选叶子,可重复
默认依次查找 /usr/share/linxira/catalog/catalog-v3.json 与
/usr/share/linxira/catalog/catalog.json;都没有时会打开空界面,用 Ctrl+O
选择文件,Ctrl+S 保存选择 JSON。--select ID 只做预选,真正的安装事务仍在
界面里完成——欢迎中心的终端页就是这样把某个 shell 预选好后交过来的。
界面只展示 surface 为 components 的顶层 bundle(省略时按 components 处理)。
右侧标签页分别显示节点详情、实时选择 JSON 和「Backend plan」。点
Plan with linxira-components 后:
- 把完整的
org.linxira.component-selection.v1文档写进私有临时目录; - 运行
linxira-components plan --catalog ... --selection ... --output-dir ...; - 显示不可变的
request-plan.json,分别列出 ready 包目标、pending 与 unsupported; - 你确认后,对这份确切的计划运行
linxira-components confirm; - 若
directPackageTargets非空,运行pkexec linxira-components apply --confirmation ...。
没有任何直接包目标、只有 pending / unsupported 时,只确认,不请求 pkexec。
pending 与 unsupported 永远不参与应用。
终端界面
linxira-component-manager --tui
linxira-component-manager --tui --catalog ./catalog-v3.json
按键:↑/↓(或 k/j)移动,空格切换选择,a 全选/全不选,Enter 生成计划并确认
安装,q 或 Esc 退出。授权模式为 auto:以 root 运行就直接执行,否则走 pkexec。
指令模式
linxira-component-manager list
linxira-component-manager list --json
linxira-component-manager status component-fish
linxira-component-manager status component-fish --json
linxira-component-manager install component-fish --dry-run
linxira-component-manager install component-fish --yes
linxira-component-manager --catalog ./catalog-v3.json install component-fish
list只列component与application中可用(available)的叶子, 并从linxira-components inventory读取安装状态;后端不可用时状态显示unknown。status接受一个或多个叶子 ID。install走同一条plan → confirm → apply链。--dry-run只打印计划中的 包目标;--yes跳过交互确认(供 agent 使用);--json输出机器可读结果。 未安装的 pending 项会在输出里单独说明并跳过。- 退出码:
0成功,2选择或计划被拒(catalog 不可用也算)、3授权或执行失败,64没给子命令(此时打印帮助)。
何时需要 root
GUI、TUI 与 CLI 的授权模式默认是 auto:以 root 运行时直接执行 apply,
普通用户运行时通过 pkexec 请求 Polkit 授权。计划与确认两步都不提权。
你不需要自己写 sudo,也不应该用 root 启动图形界面——那样会绕过 Polkit 的确认;
本仓库约定的提权路径只有 linxira-components + Polkit 这一条。
已知限制
- Phase 1 只安装:已就绪的软件包目标可以装,移除尚未支持。
- pending 与 unsupported 叶子会在确认前明确列出,但永远不会被应用。
- 没有
--component、profile/application、包管理器、remove 或 shell 回退; 这些不是「还没写文档」,而是刻意不存在。 - 只消费 Catalog v3,不翻译 v2 的 profile 或包数组。bundle 图出现直接或间接循环 会被拒绝。
- required 叶子被锁定并说明原因;
exclusive会清掉同级互斥项;bounded超过maxSelected时会拒绝,而不是静默截断。 - 无可用 catalog 时 CLI 直接报错,需要
--catalog PATH或安装linxira-catalog。
深入设计
嵌套示例见仓库的 examples/catalog-v3.example.json;事务形状见
Components,内部实现见
linxira-component-manager。