Documentação

1. Instalar a aplicação de ambiente de trabalho

Vá à página de transferência para obter o cliente Windows / macOS / Linux e instalá-lo. Após o arranque há duas entradas permanentes no topo: Home (ativos e sessões) e Deck (o assistente de operações). Os ativos do dia a dia ficam na barra lateral do Home: hosts, chaves, encaminhamento, tarefas e definições.

• Em Definições pode alterar o terminal local predefinido (o assistente e a consola local correm aí) e o idioma do sistema.
• A aplicação de ambiente de trabalho exige uma conta do site. As contas Free mantêm todas as funcionalidades locais de ligação e gestão; sincronização cloud, monitorização e execução com IA exigem Pro.

2. Inicie sessão — os modelos cloud funcionam de imediato

O assistente, as sugestões de comandos e a exploração de monitorização usam modelos cloud por predefinição: inicie sessão e avance, sem chaves de modelo para configurar.

1. Na página de início de sessão inicie sessão com e-mail ou Google / GitHub e depois escolha "Autorizar esta máquina"; a aplicação de ambiente de trabalho assume a conta atual.
2. A lista de modelos cloud é entregue com a sua conta e pode ser escolhida diretamente no seletor de modelos da barra de entrada do Deck.
3. A utilização de modelos cloud conta para a quota da subscrição: a quota mensal é usada primeiro, depois o saldo; o Free também recebe uma quota cloud e um número de sugestões limitados em cada mês (apenas modelos básicos).
4. Consulte o estado atual, a utilização da quota mensal e o saldo em Conta → Subscrição.

Subscreva o Pro para desbloquear sincronização cloud, monitorização, execução com IA e o catálogo completo de modelos cloud. A compra faz-se dentro da aplicação de ambiente de trabalho; as renovações são geridas pela loja de aplicações. Consulte Preços.

3. Registar dispositivos e chaves

Sessões, assistente, transferência de ficheiros e encaminhamento partilham um conjunto de ativos. Coloque primeiro no inventário "a quem ligar e com quê", para não ter de voltar a montar os detalhes de ligação.

Criar uma chave (recomendado primeiro)

1. Home → Chaves → Nova chave.
2. Cole a chave pública e a chave privada; adicione a frase-passe se existir; cole o certificado se precisar de um.
3. Apenas o formato OpenSSH é suportado; converta primeiro os ficheiros PPK do PuTTY para OpenSSH.

Adicionar um dispositivo

1. Home → Hosts → Adicionar dispositivo (o estado vazio também indica "Ainda não há dispositivos, clique para adicionar").
2. Informações básicas: nome, host, tipo e grupo. O tipo afeta as sugestões de comandos e alguma interação do lado do dispositivo, por isso escolha-o com cuidado.
3. Preencha SSH (porta 22 por predefinição, nome de utilizador, palavra-passe ou chave), Telnet (porta 23 por predefinição) e/ou RDP (domínio, resolução, camada de segurança, etc.) conforme necessário.
4. O SSH tem opções extra para reutilização de sessão, agente SSH e método de autenticação; o Telnet tem deteção de prompt e verificação de eco de comandos; o RDP tem profundidade de cor, disposição do teclado e redirecionamento de unidades.
5. Guarde, ou Guardar e ligar de imediato.

Palavras-passe, chaves e outros ativos sensíveis ficam nos dados locais; iniciar sessão no site nunca os carrega como inventário cloud.

4. Abrir uma sessão

Confirme que o destino está acessível antes de o entregar ao assistente. Clique num cartão de host e escolha o protocolo a abrir.

• SSH / Telnet: abre um painel de terminal. A primeira ligação pede-lhe para confirmar a impressão digital do host; uma impressão digital alterada gera um alerta e pode recusar, confiar uma vez ou confiar permanentemente.
• SFTP: usa a mesma identidade do SSH e abre a vista de ficheiros em dois painéis.
• RDP: entra no ambiente Windows com área de transferência e unidades locais partilhadas.
• Consola local: escolha um terminal na barra de ferramentas dos hosts (Command Prompt / PowerShell / WSL, etc., conforme o que for encontrado na sua máquina).
• Após uma desconexão use Religar; o + no topo abre um novo separador para revisitar ligações recentes.
• Ajuste as definições do terminal (tipo de letra, tema) e localizar dentro do painel sem interromper a sessão.

Os separadores podem ser arrastados para reordenar ou unidos em vistas divididas: una quando precisa de dois dispositivos lado a lado, arraste de volta para a barra de separadores quando precisa de se concentrar.

5. Transferência de ficheiros e túneis

Ficheiros em dois painéis

Abra SFTP dentro de uma sessão para ver local e remoto lado a lado. Ações comuns: abrir, copiar para o diretório de destino, nova pasta/ficheiro, mudar o nome, eliminar, alterar permissões, mostrar ficheiros ocultos, copiar caminho. Em conflitos escolha saltar ou substituir conforme o pedido; o progresso fica na parte inferior do painel.

Túneis e encaminhamento

1. Home → Encaminhamento → Novo encaminhamento.
2. Escolha um tipo: Local (uma porta local para o ambiente de destino), Remoto (uma porta remota de volta para este lado) ou Dinâmico (proxy SOCKS5).
3. Preencha nome, porta, endereço de associação, host e endereço de destino e use Iniciar encaminhamento para o ligar ou desligar. Os estados são inativo, em execução ou erro.

Ficheiros e encaminhamento não dependem do assistente e podem ser usados sozinhos.

6. Usar o assistente de operações (Deck)

Mude para Deck no topo. O lado esquerdo tem nova conversa, competências, servidores MCP, conversas recentes e referências de dispositivos; o centro é a área de conversa e de execução de ferramentas.

A sua primeira conversa

1. Confirme que um modelo está selecionado na barra de ferramentas; os modelos cloud estão disponíveis logo após iniciar sessão.
2. Mantenha o modo de aprovação em Pedir aprovação (a predefinição): clique em Permitir ou Ignorar para cada ação.
3. Use o + à esquerda da barra de entrada para adicionar dispositivos, grupos, competências ou imagens, ou arraste a partir de Referências de dispositivos. As referências tornam-se chips de contexto para o assistente conhecer o âmbito.
4. Descreva o objetivo em linguagem natural. Comece com uma inspeção só de leitura, por exemplo estado de CPU, disco e interfaces-chave.
5. Quando uma ação aguarda confirmação escolha Permitir ou Ignorar; para comandos semelhantes repetidos use "Memorizar permissão" para evitar ser interrompido pelo mesmo padrão.

Modos de aprovação

• Pedir aprovação: clique em Permitir ou Ignorar para cada ação.
• Auditar por mim: a aprovação só é pedida para ações detetadas como de risco.
• Permitir tudo: sem pedidos por passo, mas os comandos perigosos continuam bloqueados; a lista de palavras de perigo é personalizável. Não use este nível até conhecer o fluxo.

7. Ferramentas incorporadas

O assistente inclui 39 ferramentas incorporadas que cobrem execução em dispositivos, ficheiros e documentos, consulta de ativos, pesquisa de código, acesso à Web e monitorização. As ações de alteração passam primeiro pelo modo de aprovação; as consultas correm diretamente.

Execução em dispositivos

• Comando local: corre comandos nesta máquina; as tarefas longas passam para segundo plano e pode listar processos, ler a saída ou terminar a qualquer momento.
• SSH / SSH em lote: corre comandos num ou em vários dispositivos registados, em simultâneo no modo em lote.
• Telnet: corre comandos em destinos Telnet, como dispositivos de rede.

Ficheiros e documentos

• Transferência SFTP: carregar e descarregar entre esta máquina e os dispositivos.
• Ler / editar ficheiros: ler ficheiros de texto locais e remotos e aplicar substituições exatas.
• Processamento de documentos: ler PDFs, ler e escrever Excel e Word, e produzir relatórios de inspeção diretamente.

Ativos e contexto

• Encontrar dispositivos / grupos / competências: consultar ativos do inventário como contexto a qualquer momento.
• Histórico de conversas e lista de tarefas: percorra conversas anteriores e mantenha trabalho em vários passos como uma lista de verificação.

Código e referências

• Ferramentas de código: mapa da estrutura do repositório, pesquisa de conteúdo, definições de símbolos e referências.
• Explorar subagente: exploração paralela só de leitura de diretórios grandes ou documentos longos, resumida de volta para a conversa principal.
• Pesquisa na Web / obter página: pesquisar referências externas e obter o conteúdo da página; a pesquisa na Web vem com a sua conta.

Monitorização e competências

• Leitura/escrita de métricas: ler métricas de monitorização do dispositivo e, após confirmação, adicionar ou alterar métricas.
• Destilação de competências: escrever o procedimento atual como uma nova competência ou atualizar uma existente (exige confirmação).

Cenários típicos

• Inspeção: verificar CPU, disco e estado das interfaces-chave em vários dispositivos e produzir uma conclusão legível.
• Alteração: editar um ficheiro de configuração e reiniciar o serviço, confirmando passo a passo.
• Transferência: empacotar registos remotos, trazê-los de volta, analisar e gerar um relatório.
• Diagnóstico: combinar pesquisa na Web e leitura de documentos para localizar a origem de um erro.

8. Competências

Uma competência é um pedido Markdown reutilizável (nome + descrição de uma linha + corpo), guardada na biblioteca local de competências e incluída na cópia de segurança cloud.

• Criar: escreva uma em Deck → Competências; destile uma a partir de conversas anteriores com IA; ou deixe o assistente guardar uma nova competência após a sua confirmação.
• Usar: "+ → Competências" na barra de entrada, ou referencie-a diretamente. Depois de referenciada permanece ativa no turno, por isso os seguimentos não precisam de nova referência.
• Evoluir: o assistente pode refinar o conteúdo da competência enquanto a usa; as alterações também exigem confirmação.

9. Servidores MCP

O assistente pode ligar-se a servidores MCP (Model Context Protocol) para trazer ferramentas externas para a mesma conversa.

• Transportes: stdio (lançado por um comando local) e Streamable HTTP (URL remoto).
• Configurar: Deck → Servidores MCP → Adicionar; preencha comando, argumentos e variáveis de ambiente, ou cole uma configuração JSON para importar.
• Ativação: depois de ativado, as suas ferramentas juntam-se ao conjunto do assistente; as ferramentas incorporadas vencem em conflitos de nome. A lista mostra o estado e o número de ferramentas de cada servidor.
• Segurança: cada chamada de ferramenta MCP passa pelo mesmo modo de aprovação das ferramentas incorporadas.

As chamadas não fazem nada enquanto um servidor não está pronto (processo não iniciado ou URL inacessível); verifique primeiro o estado na lista.

10. Sugestões de comandos no terminal

Ative Sugestões de comandos em Definições → Capacidades de IA e os candidatos aparecem junto do cursor enquanto escreve em terminais locais ou remotos. O modelo de sugestões é configurado na cloud; localmente só escolhe o número de candidatos.

• Pré-visualização e lista lado a lado; Tab para aceitar, teclas de seta para mudar; feche o painel para continuar a escrever.
• O painel aceita uma intenção em linguagem natural: prima Enter para gerar candidatos.
• Os candidatos seguem a sessão e o tipo de dispositivo atuais, coincidindo com o dialeto do momento.
• Se as sugestões não aparecerem: verifique se o interruptor está ligado, se tem sessão iniciada e se o painel atual é um tipo de sessão que suporta sugestões.

11. Monitorização e descoberta

Caminho: Home → Tarefas. Dois separadores: Monitorizar e Descobrir.

Monitorizar

1. Clique em Nova tarefa, selecione os hosts a observar e confirme.
2. Veja as métricas no cartão do dispositivo; abra os detalhes para configurar nome, protocolo, intervalo, análise, alertas e escalada com IA.
3. Opções de escalada com IA: desligada, apenas análise (L1), reparação com confirmação (L2). O L2 continua a passar pela confirmação do assistente e nunca altera a configuração em silêncio.
4. Use "Recolher agora" para verificar se uma métrica isolada produz o valor esperado.

Descobrir

1. Escolha um modelo de exploração em Definições → Capacidades de IA (os modelos cloud estão disponíveis após iniciar sessão).
2. De volta a Monitorizar, inicie Descobrir métricas automaticamente num dispositivo; o processo aparece como a explorar.
3. Reveja o resumo da exploração e os candidatos no separador Descobrir; cada um está pendente ou adotado. Selecione e clique em Adotar antes de entrarem na recolha de rotina.

A exploração apenas propõe candidatos e nunca inicia a recolha sozinha; você decide o que entra na rotina.

12. Especificações de protocolo

Os detalhes de implementação de SSH, Telnet, RDP, SFTP e da consola local — matriz de autenticação, negociação de opções, capacidades de canal, modelo de confiança e requisitos do sistema — estão reunidos na página de especificações técnicas e mantidos em sincronia com a aplicação de ambiente de trabalho.

13. Modelos personalizados (avançado, opcional)

Não é necessário por predefinição: os modelos cloud funcionam após iniciar sessão. Configure isto apenas quando quiser usar o seu próprio serviço de modelo.

1. Abra Home → Definições → Modelos → Adicionar modelo.
2. Escolha um modelo de fornecedor (OpenAI, Anthropic, DeepSeek, Ollama, OpenRouter, Moonshot, Qwen, Zhipu) ou um URL de base personalizado.
3. Introduza a chave de API e o nome do modelo, guarde, e passa a ser selecionável na barra de entrada do Deck.

As chaves de modelos personalizados são guardadas apenas nesta máquina.

14. Segurança e predefinições

• O assistente usa Pedir aprovação por predefinição. Habitue-se ao ritmo das chamadas de ferramentas com tarefas só de leitura antes de alargar a fronteira.
• "Memorizar permissão" aplica-se apenas a comandos semelhantes; não é um silêncio global.
• "Permitir tudo" continua a bloquear comandos da lista de palavras de perigo, que pode personalizar.
• As impressões digitais dos hosts têm de ser confirmadas na primeira ligação; quando uma muda, verifique se a alteração é esperada antes de escolher como confiar.
• Palavras-passe de dispositivos, material de chaves e chaves de modelos personalizados estão dentro da fronteira de confiança local — proteja o computador que executa o Termini.
• A reparação automática de alertas (L2) segue a sua política de confirmação como qualquer ação de escrita do assistente.

Consulte a página de funcionalidades para uma descrição mais completa; após instalar, siga os passos 2 → 3 → 4 → 6 acima para concluir o primeiro ciclo.