Referência de Definições

Quase todas as definições do Bromure Agentic Coding pertencem a uma máquina. A interface das sessões chama-lhe máquina; o editor de definições ainda lhe chama espaço de trabalho — são a mesma coisa. Cada máquina leva as suas próprias credenciais, políticas de segurança, aparência de terminal, pastas partilhadas e recursos de VM, todos editados numa só janela: o editor de definições.

Algumas coisas não são por máquina:

• Modelos tem um quadro global em Preferências › Modelos que todas as máquinas herdam. O painel Modelos de cada máquina é uma substituição opcional dele.
• Automatização (a API HTTP de loopback e o servidor bromure-ac mcp) vale para toda a aplicação e aparece apenas nas Preferências.
• A imagem do navegador, os modelos dos detetores de injeção de prompt e de dados pessoais, e os descarregamentos de modelos no dispositivo são partilhados por todas as máquinas do Mac.

Este capítulo é a referência do editor e de cada um dos seus painéis. Cada painel tem a sua própria página, com uma captura de ecrã, uma tabela de definições com as predefinições, e apontadores para o capítulo que explica a funcionalidade por trás dele.

Abrir o editor

O editor abre de onde quer que esteja:

Para criar uma máquina, use o + no cabeçalho da secção Máquinas virtuais (dica Novo espaço de trabalho), Nova máquina… no seletor de máquinas do ecrã de nova sessão, ou Nova máquina… no ⌘K. Abrem o mesmo editor, intitulado Novo espaço de trabalho até você escrever um nome, com Criar em vez de Guardar. Ver Máquinas para o ciclo de vida de uma máquina.

Só existe uma janela de editor de cada vez. Abrir as definições de outra máquina substitui-a; abrir as definições da mesma máquina traz a janela existente para a frente.

A janela do editor

O título da janela e o cabeçalho de cada painel mostram o nome da máquina. A coluna da esquerda é uma barra lateral de painéis em cinco grupos, com um campo Procurar nas definições em cima; a coluna da direita é o painel selecionado. Cancelar (Esc) descarta as suas edições; Guardar (Return) — Criar numa máquina nova — aplica-as.

Os grupos e os painéis, na ordem da barra lateral:

Procurar nas definições filtra a barra lateral à medida que escreve. Compara nomes de painéis, nomes de grupos, e algumas palavras-chave por painel — por exemplo firewall ou openshell encontra Política de sandbox, ram encontra Recursos, chave api encontra Modelos, rgpd encontra Proteção de dados pessoais. Todas as palavras que escrever têm de corresponder. Se o painel selecionado ficar de fora do filtro, o editor salta para a primeira correspondência.

O que grava ao vivo e o que espera pelo Guardar

As edições no editor são um rascunho até clicar em Guardar. O que acontece a seguir depende de a máquina estar ou não em execução.

Aplicado a uma máquina em execução ao gravar, sem reinício: as variáveis de ambiente, as credenciais (tokens git, chaves de API, DigitalOcean, Linear, Twilio, registos de contentores, bases de dados), a identidade git, as políticas de escrita das salvaguardas e os filtros de perguntar antes de usar, as regras do firewall e a política de rede OpenShell (ambas se aplicam à medida que as edita), avisar o agente, o vigilante dos agentes, as credenciais estritas, a interceção transparente, os interruptores de desvio inseguro e de alerta de exfiltração, a política de cadeia de fornecimento, a política de injeção de prompt, a proteção de dados pessoais, o nível de rastreio, a substituição de modelos do espaço de trabalho, o tipo de letra do terminal, as suas cores, o cursor e a opacidade, e o nome e a cor da máquina.

Precisa de reinício: a memória da VM, o modo de rede, as pastas partilhadas, as chaves SSH (a chave do espaço de trabalho e as chaves importadas), os contextos Kubernetes, as credenciais AWS, e — sob o motor OpenShell — o Enforce binaries (a sandbox estrita), a sandbox do sistema de ficheiros e dos processos e o modo da sentinela do kernel. Quando grava um destes enquanto a máquina corre, a aplicação pergunta Reiniciar «nome» para aplicar estas alterações?, lista-as, e oferece Reiniciar agora… ou Mais tarde.

Duas edições perguntam antes de gravar:

• Alterar as pastas partilhadas numa máquina suspensa: Descartar a VM suspensa de «nome»? — o estado de RAM gravado não pode ser retomado com um conjunto diferente de partilhas, pelo que gravar descarta-o e o arranque seguinte é a frio. Descartar e gravar ou Cancelar.
• Alterar as permissões do navegador ou Manter a sessão iniciada nos sites enquanto o navegador está aberto: Reiniciar o navegador de «nome»? — Reiniciar e guardar ou Cancelar.

Imediato, faça o que fizer depois (não é desfeito por Cancelar):

• Tudo em Preferências › Modelos neste Mac: fornecedores, inícios de sessão, chaves de API e escolhas de modelo gravam à medida que os faz.
• Descarregamentos de modelos: os detetores de injeção de prompt e o modelo de dados pessoais começam a descarregar quando marca a sua caixa; os modelos no dispositivo descarregam a partir da fonte No dispositivo.
• Iniciar sessão num fornecedor ou sair dele, e o Autorizar com OAuth… / Revogar do MCP.
• O painel Automatização, e em Preferências › Recursos as definições Sub-rede dos espaços de trabalho e Transporte remoto.
• Descarregar agora / Descarregar novamente para a imagem do navegador.
• As ações de armazenamento em Recursos (Apagar pasta pessoal…, Restaurar pasta pessoal…, Redefinir para a base…), cada uma depois da sua própria confirmação.

Os segredos que escreve no editor nunca vão para o profile.json em texto simples. Ao gravar, são separados para secrets.enc, cifrados com uma chave guardada no Porta-chaves do macOS. Ver Credenciais e a fronteira de transmissão.

O modelo Predefinições (Preferências)

Preferências… (⌘,) abre uma janela intitulada Bromure — Preferências. Contém o mesmo editor, mas ligado a uma máquina-modelo chamada Predefinições em vez de a uma máquina real. Cada máquina nova começa como uma cópia deste modelo, pelo que o que definir lá — credenciais, salvaguardas, regras de cadeia de fornecimento, aparência, memória — passa a ser o ponto de partida das máquinas que criar depois. As máquinas existentes não são alteradas.

O sabor Preferências difere do editor de uma máquina em alguns pontos:

• Geral oculta Nome, Iniciar esta VM ao iniciar sessão, Notas e Alcance — pertencem a uma máquina, não a uma predefinição.
• Recursos não tem pilha de armazenamento (não há discos em que atuar) e acrescenta duas secções válidas para toda a aplicação: Sub-rede dos espaços de trabalho e Transporte remoto (só nas Preferências deste Mac).
• Modelos é o quadro global, não uma substituição, e grava à medida que edita.
• Aparece o grupo Aplicação, com o painel Automatização (só nas Preferências deste Mac).

O modelo de fábrica corre o Claude Code, põe todas as políticas de escrita em Perguntar antes de escrever, e registra as sessões em Detalhes dos pedidos de IA. As predefinições citadas neste capítulo são estes valores de fábrica; a partir do momento em que edita as Preferências, as máquinas novas herdam as suas.

Modelos globais e a substituição por máquina

Que fornecedores tem, que inícios de sessão, e que modelo cada agente corre definem-se uma vez, globalmente, em Preferências › Modelos. Todas as máquinas herdam esse quadro. O painel Modelos de uma máquina pode substituí-lo — Herdar, com alterações (por exemplo, a sua própria chave de API para um fornecedor, ou um fornecedor desligado) ou Autónomo (a sua configuração completa). Com a substituição desligada, o painel apenas resume aquilo que a máquina herda.

Ver Modelos para a substituição e Modelos e fornecedores para o quadro global.

Definições para: editar as predefinições de um Mac remoto

Quando está aberta pelo menos uma janela de espelho para um Mac remoto, as Preferências mostram um seletor Definições para: acima do editor, oferecendo Este Mac e cada remoto ligado. Premir ⌘, numa janela de espelho pré-seleciona esse remoto. Escolher um remoto carrega o seu modelo pela ligação («A carregar preferências de anfitrião…»); o título passa a Preferências — anfitrião. Se a busca falhar, a janela mostra Não foi possível carregar as preferências remotas com Tentar novamente.

O modelo de um remoto e o seu quadro Modelos global são editados como rascunho e enviados de volta quando clica em Guardar. As chaves de API guardadas no remoto não são enviadas para o seu Mac: aparecem como configuradas, e são mantidas a não ser que escreva uma nova. Mudar de destino atira fora um rascunho não gravado em vez de o levar consigo.

Nota: o painel Automatização e as secções Sub-rede dos espaços de trabalho e Transporte remoto de Recursos pertencem a este Mac, pelo que aparecem apenas nas Preferências deste Mac — não nas de um remoto, nem quando edita uma máquina remota a partir da sua janela de espelho. O editor de uma máquina remota também não mostra pilha de armazenamento em Recursos.

Ver Acesso remoto e o cliente nativo para as janelas de espelho.

No iPhone, iPad e Apple Vision Pro

O cliente iPhone, iPad e Vision Pro usa o mesmo editor para alterar uma máquina no servidor a que se liga:

• iPhone — uma lista ao estilo dos Ajustes: os painéis agrupados são o primeiro ecrã e cada um empurra a sua própria página. Cancelar e Guardar ficam na barra de navegação. Não há campo de busca.
• iPad e Apple Vision Pro — a disposição de barra lateral e detalhe do Mac, com Procurar nas definições, e Cancelar / Guardar ao longo do fundo.

Tudo no editor se aplica no servidor. O editor móvel deixa de fora o que só faz sentido no Mac que faz correr as máquinas: os painéis Modelos e Automatização, a secção da imagem do navegador, a tabela de regras do firewall e o editor de políticas OpenShell, e o seletor de interface em ponte. Alguns campos mudam de forma: Adicionar pasta… pede o caminho absoluto da pasta no servidor, e o AWS SSO aceita o nome do perfil tal como for escrito.

Os painéis

Onde as definições são guardadas

As definições de uma máquina vivem em ~/Library/Application Support/BromureAC/profiles/<uuid>/profile.json, com os seus segredos no secrets.enc cifrado ao lado. O modelo Predefinições é o profile-template.json mais o profile-template.enc, junto ao diretório profiles, para que nunca apareça como uma máquina. O quadro Modelos global é guardado cifrado em models.enc. O painel Automatização e as definições de sub-rede e de transporte remoto são preferências da aplicação (o domínio de predefinições io.bromure.agentic-coding), e não fazem parte de nenhum perfil.