🧠 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:
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).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.jsonpara 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¶
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.”
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?”
Bate-papo Geral:
Comando de voz: “Computador, conte-me uma piada sobre programadores.”
Redefinir memória:
Comando de voz: “Computador, esqueça tudo.” (Limpa o histórico JSON).