🗂️ Workspace & Produtividade de Projeto#

Esta página cobre o conjunto de ferramentas voltadas à organização do workspace (pasta de projeto) e à produtividade ao alternar entre projetos: troca rápida de workspace, templates de novo projeto, execução de código multi-linguagem, gravação de macros, remapeamento de atalhos e o modelo de confiança de pastas (Workspace Trust).

Acesso à maioria delas: menu Ferramentas → Workspace & Editor.

🔁 Workspace Switcher (src/ui/workspace_switcher.py)#

Atalho: Ctrl+Shift+W ou Ferramentas → Workspace & Editor → Alternar Workspace.

Painel flutuante (700×480) para trocar rapidamente entre workspaces recentemente abertos.

• Lista de workspaces recentes com ícone indicando o tipo detectado (Git, projeto Python, projeto JS/Node...)
• Pré-visualização da árvore de diretórios ao passar o mouse sobre um item
• Busca em tempo real por nome de pasta
• Ações: abrir, remover da lista de recentes, abrir no explorador de arquivos do sistema

📋 Project Templates (src/ui/project_templates.py)#

Atalho: Ferramentas → Workspace & Editor → Novo Projeto a partir de Template.

Cria projetos novos a partir de templates pré-definidos ou customizados pelo usuário. Cada template é uma pasta com arquivos e um template.json de metadados.

Templates embutidos#

Funcionalidades#

• Janela de criação (820×580) com preview da estrutura de arquivos antes de confirmar
• Variáveis de substituição nos arquivos do template: {{project_name}}, {{author}}, {{year}} e outras, substituídas no momento da criação
• Templates customizados: qualquer pasta pode ser salva como template novo
• Suporte a comandos pós-criação (ex.: git init, pip install -r requirements.txt) executados automaticamente após gerar os arquivos

▶️ Code Runner Configurável (src/ui/code_runner.py)#

Atalho: Ferramentas → Workspace & Editor → Configurar Code Runner. A execução em si é via F5 (Executar Arquivo).

Permite rodar arquivos em qualquer linguagem com comando, argumentos e variáveis de ambiente customizáveis por linguagem.

Linguagens pré-configuradas#

Python, JavaScript, TypeScript, Ruby, PHP, Go, Rust, Java, Kotlin, Swift, Lua, Perl, Bash, PowerShell, R, Julia, Dart, Scala, Elixir, Haskell, C e C++ - mais de 30 linguagens no total, incluindo variações de runtime.

Funcionalidades#

• Editar o comando de execução de qualquer linguagem (por exemplo, trocar python por python3.12 ou adicionar flags)
• Argumentos extras e variáveis de ambiente específicas por linguagem
• Timeout configurável por execução (evita que um script travado prenda o terminal indefinidamente)
• Histórico de execuções com timestamp

🎬 Macro Recorder (src/ui/macro_recorder.py)#

Atalhos: Ctrl+Shift+M (iniciar/parar gravação) · Ctrl+Alt+M (reproduzir).

Grava e reproduz sequências de teclas e ações do editor.

Funcionalidades#

• Toolbar flutuante com botões Gravar / Parar / Reproduzir
• Captura texto digitado, atalhos de teclado e navegação de cursor
• Múltiplas macros nomeadas, com persistência em JSON
• Reprodução com delay configurável (útil para visualizar a macro rodando passo a passo)
• Importar/exportar macros como arquivo JSON, para compartilhar com outra instância do Codis

⌨️ Key Remapper (src/ui/key_remapper.py)#

Acesso: Configurações → Atalhos de Teclado...

Permite remapear qualquer atalho de teclado da aplicação. Os atalhos customizados são persistidos separadamente da configuração principal e aplicados em toda a sessão.

Arquitetura interna#

Para redefinir um atalho: localize a ação na lista pesquisável, clique em Capturar, pressione a nova combinação desejada - a janela de captura (320×120) registra a combinação e a salva imediatamente.

🔒 Workspace Trust (src/ui/workspace_trust.py)#

Sistema de segurança acionado automaticamente ao abrir uma pasta nunca aberta antes nesta máquina.

Como funciona#

Ao abrir um workspace novo, o Codis exibe um diálogo de confiança perguntando se o conteúdo da pasta é confiável. Pastas marcadas como não confiáveis têm os seguintes recursos restringidos automaticamente:

Persistência#

A lista de pastas confiáveis fica em ~/.codis/trusted_workspaces.json. Uma vez confiada, a pasta (e qualquer subpasta dela) não pergunta novamente. Para revogar a confiança de uma pasta, edite ou remova a entrada correspondente nesse arquivo.

Este modelo é equivalente ao "Workspace Trust" do VS Code: protege contra a abertura descuidada de repositórios desconhecidos que poderiam, por exemplo, embutir um .codis/plugins/malicioso.py ou configurar um LSP apontando para um binário malicioso.

🪟 Panel Detach (src/ui/panel_detach.py)#

Gerencia o destacamento de painéis (Terminal, Output, Git, Debug, Regex, Problems) para janelas flutuantes independentes, arrastáveis e redimensionáveis.

Antes da versão atual, o destacamento só funcionava com o modo K-UI ativo, pois a lógica vivia dentro do controlador holográfico. O PanelDetachManager foi extraído como uma classe independente, instanciada uma única vez na inicialização do CodisApp, e funciona tanto no modo clássico quanto no modo K-UI - incluindo a janela flutuante com moldura holográfica (KFloatWindow), que é reaproveitada de K-UI.

Compartilhar uma única instância entre os dois modos resolve um problema de UX: painéis destacados não são fechados à força quando o usuário alterna o K-UI ligado/desligado - eles continuam abertos normalmente.