r/linuxbrasil • u/renanbs82 • 19h ago
Utilidade Criei uma suite de automação (ainda em teste) pra resolver problemas de teclado, mouse e bateria no meu KDE Plasma 6 Wayland — compartilhando caso ajude alguém
Quem usa Linux em laptops modernos (especialmente com gráficos híbridos, teclados específicos ou compositores Wayland) sabe que existem pequenas pedras no sapato que irritam no dia a dia:
atalhos com Ctrl engolidos, cedilha saindo `ć` em apps Electron/Chromium, teclado embutido com matriz travada ou lag ao acordar o barramento, e bateria durando metade do que deveria por causa de dGPU e PCIe ASPM mal configurados.
Para resolver esses problemas de forma automatizada e reversível, desenvolvi o **Linux / KDE Wayland Suite** , uma suíte de automação, diagnóstico e plugin para ferramentas de IA (OMP, Claude, Code, Cursor, Antigravity).
🔗 **Repositório:** https://github.com/renanbs/linux-wayland-suite (Licença MIT)
---
### 🎯 Problemas que a suíte resolve:
**Matriz de Teclado Travada (Tongfang / Avell / Clevo)**
* *Problema:* Em modelos com chassi Tongfang (Avell A62 LIV, GK5, Tuxedo, Schenker), a tecla `Ctrl` esquerda às vezes não emite nenhum evento no `evtest`/`xev` por descarte de pacotes no driver `i8042` / ACPI DSDT.
* *Solução:* Injeta parâmetros otimizados no GRUB (`i8042.nopnp=1 i8042.nomux=1 acpi_osi='Windows 2020'`), destrancando a matriz na placa-mãe.
**Lag no primeiro pressionamento de teclas modificadoras (PS/2 / `serio0`)**
* *Problema:* O Linux suspende o barramento PS/2 em idle (`power/control = auto`), gerando atraso na primeira tecla pressionada.
* *Solução:* Regra dinâmica de `udev` (`smart-keyboard-power`): mantém o barramento em `power/control = on` (latência zero) ao usar o laptop standalone, e alterna automaticamente para `auto` (economia) quando um teclado externo USB/Bluetooth é plugado.
**Cedilha nativa no layout US-intl (`' + c` = `ç`) sem Input Methods pesados**
* *Problema:* Módulos como `fcitx5` ou `GTK_IM_MODULE=cedilla` frequentemente engolem combinações de `Ctrl+C` / `Ctrl+V` em apps Qt, GTK e Electron. Além disso, o layout US-intl padrão gera `ć`.
* *Solução:* Elimina variáveis legadas de IM e configura `LC_CTYPE=pt_BR.UTF-8` + flags Ozone nos navegadores. Usa a tabela Compose nativa da libc/X11 — cedilha perfeita sem nenhum daemon de input rodando em background.
**Deadlock de Clipboard no Wayland**
* *Problema:* Processos zumbis do `xsel` congelando pipelines de terminal.
* *Solução:* Purga os processos órfãos e garante operação nativa via `wl-clipboard` (`wl-copy`/`wl-paste`).
**Gestos Touchpad de 3 e 4 Dedos + Logitech MX Master 3S**
* *Solução:* Mapeia gestos fluidos via `libinput-gestures` integrados com D-Bus do KWin (`qdbus6`) e configura o botão de polegar / SmartShift free-spin do MX Master 3S via `logiops`.
**Diagnóstico Inteligente e Otimização de Bateria (Ganho de 15% a 30%)**
* *Problema:* Laptops híbridos frequentemente deixam a dGPU (NVIDIA) acordada, PCIe ASPM desligado e PCI Runtime PM inativo sem o usuário saber.
* *Solução:* Auditoria não-destrutiva e otimizações seletivas (forçar iGPU no KWin, ASPM agressivo, C-states profundos). No meu setup (i7-10750H + GTX 1650), o tempo de bateria saltou de **2–2.5h para 3.5–4h de uso normal**.
**Integração com Ferramentas de IA e Contrato de Saída Tetra-Fásico**
* Funciona como plugin nativo para **Oh My Pi (OMP)**, **Claude Code**, **Cursor**, **Antigravity** e **OpenCode**, formatando saídas no padrão `Plano → Execução → Resumo → Ações`, com logs estruturados em `~/.local/state/`.
---
### 🛡️ Filosofia: Leitura-Primeiro e Reversibilidade Total
Nenhum comando altera seu sistema às cegas:
* Comandos de status (`kde-config status`, `battery-status`) são **100% leitura**.
* Qualquer aplicação de fix faz **backup automático** antes da alteração.
* Se quiser desfazer qualquer alteração: `kde-config rollback` restaura o snapshot anterior instantaneamente.
---
### 🚀 Como testar:
```bash
# 1. Clonar o repositório
git clone https://github.com/renanbs/linux-wayland-suite.git ~/src/linux-wayland-suite
cd ~/src/linux-wayland-suite
# 2. Instalar a CLI globalmente (~/.local/bin)
make install-cli
# 3. Rodar a auditoria de saúde do sistema (não altera nada)
kde-config status
# 4. Diagnóstico de bateria e GPU híbrida
kde-config battery-status
# 5. Inicialização guiada e interativa (com backup)
kde-config init
```
────────────────────────────────────────────────────────────────────────────────
### 🧪 Ambientes Testados e Compatibilidade
- Validado em produção: Arch Linux / Garuda Linux, KDE Plasma 6.7.x Wayland, Kernel Zen 7.2.x / Linux 6.12+, hardware Avell/Tongfang (Intel i7 + NVIDIA GTX 1650), teclado ABNT2/US-intl e Logitech MX Master 3S.
- Outros ambientes: A grande maioria dos fixes atua em camadas agnósticas de desktop (Kernel, ACPI, GRUB, udev, libc, locale e systemd), devendo funcionar também em GNOME, Hyprland, Sway, etc. (Apenas as integrações de D-Bus para gestos/overview e multi-monitor virtual desktops são específicas do KWin).
Se você sofre com algum desses problemas no seu setup Linux, fique à vontade para testar, abrir issues com seus diagnósticos ou sugerir melhorias!
PS: Sim, esse texto foi escrito com IA. A minha ideia é simplesmente ajudar a simplificar algumas coisas
•
u/Efficient_End_9965 Arch-btw 19h ago
Por acaso esse readme foi feito por ia? Parece