⚙️ Sistema, Performance & Pacotes#

Esta página cobre as ferramentas de Ferramentas → Sistema & Processos: Gerenciador de Pacotes Pip, Gerenciador de Processos e Modo Performance - além do Cursor Customizável e do Explorador de Arquivos Remotos, que vivem em outras partes do menu mas são, na essência, ferramentas de sistema. Também inclui uma seção técnica sobre a arquitetura de performance do editor, metas, benchmarks e como diagnosticar lentidão.

📦 Gerenciador de Pacotes Pip (src/ui/pip_manager.py)#

Atalho: Ferramentas → Sistema & Processos → 📦 Gerenciador Pip.

Interface gráfica completa para pip, organizada em quatro abas:

Funcionalidades#

• Log de operações em tempo real, com cores distintas para sucesso/aviso/erro
• Instalar, atualizar e desinstalar pacotes com barra de progresso
• Exportar e importar requirements.txt diretamente da interface
• Criação de novo ambiente virtual sem sair do Codis

🖥️ Gerenciador de Processos (src/ui/process_manager.py)#

Atalho: Ctrl+Alt+M ou Ferramentas → Sistema & Processos → Gerenciador de Processos.

Duas abas:

Funcionalidades#

• Gráficos de uso de CPU e memória em tempo real
• Painel de informações do sistema: RAM total, número de núcleos, uptime
• Filtro em tempo real por nome de processo ou PID
• Encerrar processo individual (com confirmação) ou encerrar a árvore completa de processos
• Detalhes expandidos por processo: linha de comando completa, threads, arquivos abertos
• Auto-atualização configurável (1s / 2s / 5s)

Dependência opcional: requer psutil (pip install psutil). Sem ele, o painel degrada graciosamente - a aba Sistema fica indisponível, mas a aba Codis continua funcionando, já que não depende de psutil.

🚀 Modo Performance (src/ui/performance_panel.py)#

Atalho: Ferramentas → Sistema & Processos → Modo Performance.

Permite controlar individualmente quais funcionalidades visuais são desativadas quando o monitor automático de travamentos é acionado, ou ao ativar o modo manualmente. Janela de 700×680.

Funcionalidades controláveis#

Editor: Minimap, Syntax Highlighting (debounce), Sticky Scroll, Code Folding, Inline Blame, Color Preview, Inlay Hints, Ligatures, Edit Heatmap, Code Rhythm, Autocomplete.

K-UI: Perfil de animações (dropdown de intensidade do motor holográfico).

Linting: Lint automático ao salvar.

Monitor automático#

O Codis monitora o tempo de resposta da interface continuamente. Quando detecta um travamento acima de um limiar configurável (perf_freeze_threshold_ms, padrão 500ms), aciona automaticamente o conjunto de desativações escolhido pelo usuário neste painel - sem precisar de intervenção manual.

O botão Aplicar Agora permite acionar manualmente o modo performance mesmo sem ter ocorrido um travamento, útil antes de abrir um arquivo muito grande.

📊 Performance Técnica, Benchmarks e Diagnóstico#

Seção voltada a quem quer entender como o Codis atinge sua performance e como diagnosticar lentidão - não é sobre um painel específico, mas sobre a arquitetura de performance do editor como um todo.

Metas de Performance#

Threading#

O Codis usa threads para todas as operações que não tocam na UI:

Thread principal (Tkinter mainloop)
  ├── LSP I/O thread            ← leitura/escrita stdio com servidor LSP
  ├── Lint thread               ← execução de linters externos
  ├── Git thread                ← operações git (status, blame, log)
  ├── File watcher thread       ← inotify/FSEvents/ReadDirectoryChangesW
  ├── Plugin worker thread      ← execução de plugins via ProcessRunner
  └── IA inference thread       ← chamadas HTTP para APIs de IA

Resultados das threads são agendados de volta na thread principal via root.after(0, callback) - Tkinter não é thread-safe, então nenhum código de outra thread pode tocar widgets diretamente.

Debounce e Throttle#

Modo Arquivo Grande#

Arquivos com mais de 500 KB ou 10.000 linhas ativam automaticamente o modo de arquivo grande (src/editor/large_file.py):

• Syntax highlighting desativado (o Tkinter Tag system não escala para centenas de milhares de tags).
• Minimap em modo low-res (1 pixel por linha em vez de renderização completa).
• Code folding, Inline blame e Inlay hints desativados.

O arquivo ainda é completamente editável - apenas as features visuais pesadas são suspensas.

Cache de Syntax Highlighting#

O highlighter (src/syntax/highlighter.py) mantém um cache de resultados por hash do conteúdo. Re-highlight de um arquivo não modificado é um lookup de O(1). Qualquer edição invalida apenas o cache do arquivo editado, não o cache global.

Diagnosticando lentidão manualmente#

# Perfil de inicialização
python -m cProfile -o startup.prof -m src
python -m pstats startup.prof

# Perfil de operação específica (ex: abertura de arquivo grande)
# Adicione ao código:
import cProfile
cProfile.enable()
# ... operação ...
cProfile.disable()
cProfile.print_stats(sort='cumulative')

O EventBus loga automaticamente handlers que demoram mais de 50ms em modo debug:

CODIS_DEBUG=1 python run.py

[EventBus] SLOW handler: git_panel.on_file_saved took 87ms for event editor:file:saved

Limites conhecidos do Tkinter#

Benchmarks de referência#

Medidos em: Ryzen 5 3600, 16GB RAM, SSD NVMe, Python 3.12.3, Ubuntu 22.04.

Benchmarks reproduzíveis via python -m pytest tests/ -m slow -v

Tuning pelo usuário#

Em Configurações → Performance, o usuário pode ajustar:

🖱️ Cursor Customizável (src/ui/cursor_manager.py)#

Acesso: integrado ao seletor de tema/aparência (categoria Cursor dentro de Configurações).

Substitui o ponteiro do mouse do sistema por um cursor de software: emoji, texto, imagem (PNG/SVG via Pillow) ou combinações.

Como funciona internamente#

• O cursor nativo do sistema é ocultado na janela (root.config(cursor="none"))
• Um Toplevel transparente e clicável segue o mouse em tempo real
• Esse Toplevel exibe o cursor escolhido como Label ou Canvas
• Os cliques atravessam normalmente o overlay: no Windows via SetWindowLong (passthrough nativo) e configuração de -transparentcolor; no Linux/macOS via Toplevel ultra-fino de 1px com wm_attributes("-alpha", 0.99)

Limitações conhecidas#

• Emojis dependem da fonte disponível no sistema operacional
• Cursores de imagem requerem Pillow instalado (pip install Pillow)
• Existe uma latência de até ~1 frame (≤16ms) entre o cursor real e o de software, imperceptível na maioria dos casos

🌐 Explorador de Arquivos Remotos (src/ui/remote_browser.py)#

Suporta múltiplos protocolos de acesso remoto a arquivos em uma única interface unificada:

Funcionalidades#

• Gerenciamento de conexões com perfis persistentes em JSON
• Navegação em árvore com duplo-clique para entrar em pastas
• Download e upload bidirecional
• Abertura direta de arquivos remotos no editor do Codis (texto, código, imagem ou notebook)
• Sync automático ao salvar: ao editar um arquivo aberto remotamente e salvar, o Codis faz upload de volta ao servidor automaticamente
• Menu de contexto com ações rápidas e filtro de busca

Cada protocolo é implementado como um _Adapter próprio, seguindo o mesmo padrão arquitetural usado no Chat Panel.