SuperAPI AI 工具集

fedora-hyprland-installer

部署与运维

查看项目

更新于 10-16 09:28

技能介绍

用途:面向 Fedora Linux 管理 Hyprland 桌面栈,覆盖安装、配置、验证、有限修复、更新与卸载,按需识别 GPU 厂商(NVIDIA/AMD/Intel/混合)以配置环境变量。

主要能力:内置 detect-system.sh、detect-gpu.sh、preflight.sh、backup.sh、install.sh、configure.sh、verify.sh、repair.sh、uninstall.sh 等脚本。安装流程先检查系统与 GPU、验证 Fedora 版本/网络/包管理器/sudo,再备份现有配置;用 install.sh --dry-run 预览软件包计划,用户明确同意后安装 Hyprland、Wayland 门户包(xdg-desktop-portal-hyprland、xdg-desktop-portal-gtk)、PipeWire/WirePlumber、终端、启动器、状态栏与认证代理;configure.sh 写入初始 ~/.config/hypr/hyprland.conf;verify.sh 检查二进制、门户服务、PipeWire 与 /usr/share/wayland-sessions/hyprland.desktop。修复流程先用 repair.sh(不带 --apply)报告缺失配置、缺失门户包、未激活的 PipeWire/WirePlumber 服务,经用户同意后加 --apply;更新流程为备份、预览、--update、验证;卸载流程说明将被移除的包、备份,再以 uninstall.sh --yes 移除 Hyprland 相关包。

使用方式:以 bash 显式调用并引用路径,例如 bash "$SKILL_DIR/scripts/detect-system.sh";$SKILL_DIR 需解析为包含 SKILL.md 的目录,无法解析时应停止并请用户提供。

限制:脚本按仓库安全策略不可直接执行;不使用 apt/pacman/yay;不改装既有 GNOME/KDE 桌面环境,Hyprland 作为显示管理器中的会话选项加入;备份写入 ~/.local/state/fedora-hyprland-installer/backups/;本技能不启用 RPM Fusion、不安装 GPU 驱动,NVIDIA 不走 .run 安装器;GPU 检测只识别厂商,不保证配置适配具体驱动版本、混合显卡路由、显示器或笔记本;修复仅覆盖所报告的检查项,不诊断损坏符号链接、内核参数、驱动不匹配等;生成的配置是最小起点,不会合并进已有 hyprland.conf;Fedora 包可用性随版本与已启用仓库而变化;安装、卸载、改服务、重建 initramfs 需权限与明确同意,不得硬编码密码。详细参考手册内容暂未提供。