Referência de Definições
Cada definição no Bromure Agentic Coding pertence a um único espaço de trabalho: cada espaço de trabalho tem os seus próprios agentes, credenciais, políticas de segurança, aparência e recursos de VM, editados num único local — o editor de definições. As únicas exceções são o painel Automatização (a nível de aplicação, guardado nas preferências da aplicação), a imagem de navegador transferida e os modelos locais transferidos (ambos partilhados entre espaços de trabalho).
Este capítulo é a referência do próprio editor e de todos os dezasseis painéis. Cada painel tem a sua própria página com uma captura de ecrã, uma tabela de definições com valores predefinidos e ligações para o capítulo aprofundado que explica a funcionalidade subjacente.
Abrir o editor de definições
Há quatro formas de aceder ao editor:
- Ícone de engrenagem da barra de ferramentas — com um espaço de trabalho selecionado na janela principal, clique no ícone de engrenagem na barra de ferramentas (dica Editar espaço de trabalho).
- Menu de contexto da barra lateral — clique no menu ⋯ numa linha de espaço de trabalho na barra lateral e escolha Editar….
- Novo espaço de trabalho — clique no botão + na parte inferior da barra lateral (dica Novo espaço de trabalho). Isto abre o mesmo editor como uma janela de Novo espaço de trabalho, pré-preenchida a partir do seu modelo de preferências; o botão de confirmação diz Criar em vez de Guardar.
- Preferências — escolha Preferências… no menu da aplicação (⌘,). Isto abre o editor associado ao modelo de preferências (ver abaixo) e adiciona o painel Automatização a nível de aplicação.
Ao editar um espaço de trabalho existente, a janela tem o título Editar espaço de trabalho. Só existe uma janela de editor de cada vez — abrir as definições de um espaço de trabalho diferente substitui a janela de editor atual.
A janela do editor
O editor é uma janela de dois painéis: uma barra lateral de categorias à esquerda, cada uma com um ícone de gradiente colorido, e um painel de detalhes com deslocamento à direita. Cancelar (ou Esc) descarta as suas alterações; Guardar (ou Criar) aplica-as.
As gravações são transacionais por janela — nada é aplicado até clicar em Guardar ou Criar. Algumas ações têm efeitos secundários imediatos de qualquer forma, porque operam sobre estado partilhado ou externo: transferências e remoções de modelos locais (globais, partilhadas entre espaços de trabalho), transferências de modelos de injeção de prompt, autorização OAuth de MCP, Registar… / Esquecer de subscrição, importação de chaves SSH e tudo no painel Automatização (que escreve as preferências da aplicação em tempo real).
Os segredos que digita em qualquer parte do editor nunca são escritos no profile.json em texto simples. Ao guardar, são separados para secrets.enc, cifrados com AES-GCM com uma chave-mestra mantida no Keychain do macOS, com permissões de ficheiro 600. Consulte Credenciais e a fronteira de transmissão para o modelo completo.
O modelo de preferências ("Predefinições")
Abrir o editor a partir de Preferências… não edita nenhum espaço de trabalho — edita um espaço de trabalho modelo obrigatoriamente designado Predefinições (o campo Nome está oculto). Cada novo espaço de trabalho é derivado deste modelo, pelo que tudo o que definir aqui — agentes, credenciais, salvaguardas, aparência — torna-se a sua predefinição pessoal para futuros espaços de trabalho.
O modelo de fábrica é fornecido com o Claude Code ativado como agente principal no modo Subscrição (início de sessão interativo), todas as salvaguardas definidas como Perguntar antes de escrever e o nível de rastreio da sessão em Detalhes do pedido de IA. As predefinições citadas ao longo deste capítulo são estes valores de fábrica; se tiver editado as Preferências, os novos espaços de trabalho herdam os seus valores.
Nota: O painel Automatização é a nível de aplicação, não por espaço de trabalho. Só aparece quando o editor é aberto através de Preferências…, e as suas alterações têm efeito imediato em vez de na gravação.
Os painéis
| Painel | O que configura |
|---|---|
| Geral | Nome do espaço de trabalho, cor de destaque, comportamento ao fechar a janela, iniciar ao iniciar sessão e notas. |
| Agentes | Que agentes de programação (Claude Code, Codex, Grok Build) estão disponíveis, qual é o principal e como cada um se autentica. |
| Modelos locais | Inferência no dispositivo: o interruptor principal, encaminhamento Local/Híbrido e o catálogo de modelos MLX com transferências. |
| Fusion | Síntese de respostas multimodelo (BETA): que modelos fundir e que modelo julga. |
| Pastas | Pastas do anfitrião partilhadas na VM em /home/ubuntu/<basename> (até 8). |
| Credenciais | Identidade Git, chaves SSH, tokens de forge, credenciais de nuvem e de base de dados — todas mantidas no anfitrião e trocadas de falsa→real na transmissão. |
| Ambiente | Variáveis KEY=VALUE simples exportadas para todas as shells da VM. |
| MCP | Servidores Model Context Protocol, traduzidos para a configuração nativa de cada agente ativado e injetados no arranque. |
| Rastreio | Quanto o proxy regista, o modo privado em Macs inscritos e o estado da troca de token de subscrição. |
| Salvaguardas | Políticas de escrita do lado do anfitrião por recurso: Desligado, Perguntar antes de escrever, Bloquear destrutivas ou Apenas leitura. |
| Cadeia de fornecimento | Defesas na obtenção de pacotes: limite de idade, consultas OSV, filtragem socket.dev ou Delpi, remoção de scripts de instalação e pedidos sobre lockfiles. |
| Injeção de prompt | Deteção no dispositivo de instruções injetadas ou maliciosas no tráfego de IA do agente. |
| Aparência | Tipo de letra, cursor, cores e opacidade da janela do terminal. |
| Navegador | O Chromium incorporado e controlável pelo agente: persistência do perfil e gestão da imagem do navegador. |
| Recursos | As três camadas de armazenamento, a RAM da VM e a rede NAT ou em ponte. |
| Automatização | A nível de aplicação (apenas Preferências): a API de automatização HTTP de loopback e o servidor bromure-cli mcp. |
Onde as definições são guardadas
As definições por espaço de trabalho residem em ~/Library/Application Support/BromureAC/profiles/<uuid>/profile.json, com os segredos no secrets.enc cifrado adjacente. O modelo de preferências é guardado como profile-template.json mais profile-template.enc junto ao diretório de perfis — deliberadamente fora dele, para que nunca apareça na barra lateral de espaços de trabalho. O painel Automatização escreve as preferências a nível de aplicação (UserDefaults) em vez de qualquer ficheiro de perfil.