Skill Instalador do Hyprland no Fedora

Esta skill oferece um fluxo de trabalho automatizado e com foco em segurança para gerenciar o Hyprland no Fedora Linux.

Resolver o Diretório da Skill

Antes de executar um script empacotado, resolva SKILL_DIR para o diretório que contém esta SKILL.md. Não presuma o diretório de trabalho atual do usuário nem adivinhe um caminho de instalação global. Se o agente não conseguir resolver o diretório da skill instalada a partir do seu contexto de tempo de execução, pare e peça ao usuário para fornecê-lo. Invoque arquivos shell empacotados explicitamente com bash e um caminho entre aspas, por exemplo bash "$SKILL_DIR/scripts/detect-system.sh".

Quando Usar

• Use ao instalar ou atualizar um conjunto de desktop Hyprland empacotado pelo Fedora.
• Use ao verificar uma sessão Hyprland, portais, PipeWire ou WirePlumber no Fedora.
• Use ao diagnosticar os casos de reparo limitados documentados abaixo ou ao remover os pacotes específicos do Hyprland instalados por este fluxo de trabalho.

Diretivas Principais e Regras de Segurança

1. Fedora em Primeiro Lugar: Sempre use ferramentas do Fedora (dnf, systemctl, loginctl). Nunca use apt, pacman ou yay.
2. Nunca Execute Cegamente: Inspecione o sistema antes de qualquer instalação ou modificação.
3. Preservar o Desktop Existente: Não desinstale o GNOME, KDE ou qualquer ambiente de desktop existente. O Hyprland deve ser adicionado como uma opção de sessão no gerenciador de exibição (GDM/SDDM/LightDM).
4. Backup Obrigatório: Sempre crie um backup com timestamp em ~/.local/state/fedora-hyprland-installer/backups/ antes de escrever ou alterar configurações em ~/.config/hypr/, ~/.config/waybar/, etc.
5. Consciência da GPU: Verifique se o sistema usa gráficos NVIDIA, AMD, Intel ou Híbridos antes de configurar variáveis de ambiente ou drivers gráficos. Nunca use instaladores .run arbitrários para NVIDIA; confie nos repositórios Fedora/RPM Fusion.
6. Operações Privilegiadas: Comandos sudo devem ser claramente identificados e comunicados ao usuário. Não codifique senhas.
7. Idempotência: Executar ações várias vezes deve ser seguro e evitar linhas de configuração duplicadas.
8. Consentimento Explícito: Mostre primeiro as alterações exatas de pacotes ou serviços. Execute scripts que modificam pacotes ou serviços apenas após a confirmação do usuário; use repair.sh sem --apply para diagnóstico.

Guia de Fluxo de Trabalho

1. Fluxo de Trabalho de Instalação

Quando o usuário pedir para "Instalar Hyprland" ou "Configurar Hyprland no Fedora":

1. Execute bash "$SKILL_DIR/scripts/detect-system.sh" e bash "$SKILL_DIR/scripts/detect-gpu.sh".
2. Execute bash "$SKILL_DIR/scripts/preflight.sh" para verificar a versão do Fedora, rede, gerenciador de pacotes e acesso sudo.
3. Execute bash "$SKILL_DIR/scripts/backup.sh" para preservar quaisquer configurações pré-existentes.
4. Mostre o plano de pacotes com bash "$SKILL_DIR/scripts/install.sh" --dry-run; após aprovação explícita, execute bash "$SKILL_DIR/scripts/install.sh" para instalar Hyprland, pacotes de portal Wayland (xdg-desktop-portal-hyprland, xdg-desktop-portal-gtk), PipeWire/WirePlumber, terminal, launcher, barra de status e agente de autenticação.
5. Execute bash "$SKILL_DIR/scripts/configure.sh" para escrever uma configuração inicial limpa e funcional do Hyprland (~/.config/hypr/hyprland.conf) adaptada ao terminal/launcher detectado e às variáveis de ambiente da GPU.
6. Execute bash "$SKILL_DIR/scripts/verify.sh" para garantir que os binários, serviços de portal, PipeWire e entradas de desktop de login (/usr/share/wayland-sessions/hyprland.desktop) existam e validar.
7. Apresente um relatório resumido detalhando pacotes instalados, caminhos de backup e instruções de login.

2. Fluxo de Trabalho de Reparo

Quando o usuário pedir para "Corrigir Hyprland", "Hyprland não inicia", "Sem áudio", "Compartilhamento de tela quebrado":

1. Execute bash "$SKILL_DIR/scripts/detect-system.sh" e inspecione os logs do sistema (journalctl -xe, journalctl --user -u xdg-desktop-portal).
2. Execute bash "$SKILL_DIR/scripts/repair.sh" para relatar uma configuração do Hyprland ausente, um pacote de portal ausente e serviços PipeWire/WirePlumber inativos.
3. Revise as alterações propostas com o usuário, então execute bash "$SKILL_DIR/scripts/repair.sh" --apply apenas após aprovação. O script pode criar uma configuração ausente, instalar pacotes de portal ausentes e habilitar ou reiniciar os serviços do usuário verificados; investigue outras falhas manualmente.
4. Execute bash "$SKILL_DIR/scripts/verify.sh".

3. Fluxo de Trabalho de Atualização

Quando o usuário pedir para "Atualizar Hyprland":

1. Execute bash "$SKILL_DIR/scripts/backup.sh".
2. Mostre o plano de pacotes com bash "$SKILL_DIR/scripts/install.sh" --dry-run --update e obtenha aprovação.

…