Linux 安装器

该技能的功能

为 Linux 桌面应用程序解析最优且受支持的安装路径，简要说明推荐理由，在执行任何系统变更前向用户请求确认，完成安装，并返回精确的启动或卸载命令。

若所选安装源依赖缺失的工具（例如 snapd、flatpak、wine 或 winetricks），该辅助工具可通过宿主机原生包管理器先行引导安装这些依赖工具。

当不存在官方 Linux 安装包时，该工具还可返回经过筛选的社区替代方案。此类方案必须明确标注，并在安装前要求用户额外进行一次显式确认。

当既无经筛选的替代方案，也无官方安装路径时，该辅助工具可能从公开的软件包元数据中呈现未经审核的社区建议。这些仅为调研结果，而非可信的安装元数据。

默认安装源优先级顺序如下：

1. Flatpak
2. Snap
3. 原生包管理器（如 apt、dnf 等）
4. openSUSE zypper
5. Arch pacman
6. 原生 Arch AUR 辅助工具（如 yay、paru）
7. Nix profile install
8. AppImage
9. 经筛选的官方手动安装/归档回退方案
10. 经筛选的 Wine/手动回退方案

社区替代方案仅在目录（catalog）中被明确标记为“已筛选”时才允许使用。

未经审核的社区建议仅可在满足以下全部条件时安装：

1. skills.entries.linux-installer.unsafeCommunityInstalls 在 openclaw.json 中启用
2. 用户显式确认该未经审核的安装
3. 安装命令中包含 --allow-unsafe

前提条件

使用本技能前，请确保已安装该辅助工具的 CLI：

cd ~/.openclaw/skills/linux-installer
pip install -e .

工作流程

若您正在扩展经筛选的支持范围，请参考 CATALOG_GUIDE.md 判断哪些应用应纳入 catalog.json，哪些应依赖动态发现机制。

当用户请求安装某个应用时：

1. 解析最优安装路径：

linux-installer resolve "gimp"

2. 汇总解析结果，包括：

   • 选定的安装源
   • 软件包 ID
   • 是否为官方软件包、回退方案或社区替代方案
   • 是否为经筛选方案或未经审核方案
   • 是否存在缺失的依赖工具
   • 如有缺失工具，其引导安装命令
   • 源地址 URL（如可获取）
   • 公开摘要信息及尽最大努力提供的审核备注
   • 精确的安装命令
   • 启动命令
   • 警告信息或备用方案

3. 在执行安装前向用户请求确认。

4. 若所选结果为社区替代方案，需额外请求一次显式确认，明确提示该方案为非官方/由社区维护。

5. 若所选结果为未经审核的建议，则需说明：

   • 该建议系从公开软件包元数据中动态发现
   • 未经过维护者审核
   • 需先启用对未经审核建议的显式支持选项
   • 需单独确认该未经审核的安装路径

6. 获得确认后，执行安装：

linux-installer install "gimp" --source flatpak --package org.gimp.GIMP --yes

对于社区替代方案，需添加 --allow-community 参数：

linux-installer install "roblox" --source flatpak --package org.vinegarhq.Sober --yes --allow-community

对于未经审核的建议，需添加 --allow-unsafe 参数，并确保已在 openclaw.json 中启用对未经审核建议的显式支持。

7. 返回启动命令：

linux-installer run-info "gimp" --source flatpak --package org.gimp.GIMP

8. 可选：直接启动已安装的应用程序：

linux-installer run "gimp" --source flatpak --package org.gimp.GIMP

9. 卸载时，优先使用该辅助工具提供的卸载命令。若结果指向手动卸载或存在安全风险的卸载路径，则应直接返回对应命令或人工操作步骤，不得自行推断或构造卸载逻辑：

linux-installer uninstall "gimp" --source flatpak --package org.gimp.GIMP --yes

规则

• 未经用户确认，禁止执行任何安装操作。
• 未经二次显式确认，禁止安装社区替代方案。
• 除非已启用未经审核建议的显式支持，且用户明确接受该未经审核路径，否则禁止安装未经审核的建议。
• 优先采用辅助工具 CLI 的输出结果，避免依赖临时编写的 shell 逻辑进行推理。
• 若 resolve 命令返回“未找到安全的自动化安装路径”，则不得自行构造安装步骤。
• 手动/归档回退方案可展示经筛选的 manual_steps，但辅助工具不得自动下载或自动执行这些步骤。
• 手动/归档及其他存在安全风险的卸载流程可展示 manual_steps，但除非卸载路径本身已被明确筛选且确认安全，否则辅助工具不得自动删除相关文件或组件。
• Wine/手动流程风险更高，应作为回退选项呈现，而非默认方案。
• 社区替代方案必须明确标识为非官方、经筛选的替代方案。
• 未经审核的建议必须明确标识为调研结果，而非可信推荐。
• 安装完成后，必须向用户明确告知启动该应用的确切命令。