🧠 Modo híbrido SL5 Aura: LLM local e integração com área de transferência

Status: Estável Tecnologia: Ollama (Llama 3.2) + Arquitetura File Bridge Privacidade: 100% off-line

O Conceito: “Arquiteto e Estagiário”

Tradicionalmente, o Aura depende de regras determinísticas (RegEx) – rápidas e precisas. Este é o “Arquiteto”. O Plugin LLM Local atua como o “Estagiário”: Ele lida com solicitações difusas, resume textos e responde a perguntas gerais.

🛠 Arquitetura: a ponte da área de transferência

Devido a restrições de segurança no Linux (Wayland/X11), processos em segundo plano (como Aura) muitas vezes não conseguem acessar a área de transferência diretamente. Resolvemos isso com uma Arquitetura Bridge:

  1. O Provedor (Sessão do Usuário): Um pequeno script de shell (clipboard_bridge.sh) é executado na sessão do usuário. Ele observa a área de transferência e espelha seu conteúdo em um arquivo temporário (/tmp/aura_clipboard.txt).

  2. O Consumidor (Aura): O plugin Python lê este arquivo. Como o acesso aos arquivos é universal, os problemas de permissão são contornados.

🚀 Guia de configuração

1. Instale o Ollama

sudo pacman -S ollama xclip wl-clipboard
sudo systemctl enable --now ollama
ollama run llama3.2

2. Configure o script Bridge

Crie ~/clipboard_bridge.sh e torne-o executável:

#!/bin/bash
# Mirrors clipboard to a file in RAM
FILE="/tmp/aura_clipboard.txt"
while true; do
    if command -v wl-paste &> /dev/null; then
        wl-paste --no-newline > "$FILE" 2>/dev/null
    else
        xclip -selection clipboard -o > "$FILE" 2>/dev/null
    fi
    sleep 1.5
done

Importante: Adicione este script à inicialização automática do sistema!

3. Lógica do plug-in (ask_ollama.py)

O script está localizado em config/maps/plugins/z_fallback_llm/de-DE/.

  • Acionador: Detecta palavras como “Computador”, “Aura”, “Área de Transferência”, “Resumo”.

  • Memória: Mantém um conversation_history.json para lembrar o contexto (por exemplo, “O que acabei de perguntar?”).

  • Prompt Engineering: Prioriza os dados atuais da área de transferência em relação ao contexto histórico da conversa para evitar alucinações.

📝 Exemplos de uso

  1. Resuma o texto:

  • Ação: Copie um e-mail longo ou texto de site (Ctrl+C).

  • Comando de voz: “Computador, resuma o texto na área de transferência.”

  1. Tradução/Análise:

  • Ação: Copie um trecho de código.

  • Comando de voz: “Computador, o que o código na área de transferência faz?”

  1. Bate-papo Geral:

  • Comando de voz: “Computador, conte-me uma piada sobre programadores.”

  1. Redefinir memória:

  • Comando de voz: “Computador, esqueça tudo.” (Limpa o histórico JSON).