<!-- Generated from pt-BR/docs.html. Do not edit by hand. -->

> Markdown twin of https://conduitllm.com/pt-BR/docs.html
> Instale o Conduit, adicione seu primeiro provedor, conecte ferramentas MCP e compile a partir do código-fonte.

---
Documentação

# Primeiros passos

Conduit é um aplicativo desktop. Não existe uma versão hospedada para fazer login: você roda tudo na sua própria máquina, com a sua própria chave de provedor.

## Instalação

Os instaladores estão na página de [GitHub Releases](https://github.com/runningpixels/conduit/releases), **v1.0.0-rc.7** é a build com tag atual para Windows, macOS e Linux. Você também pode compilar a partir do código-fonte, o que leva cerca de cinco minutos em uma máquina que já tenha a toolchain.

### Pré-requisitos

| Requisito | Versão | Observações |
| --- | --- | --- |
| Node.js | 20 | A versão usada pelo CI |
| pnpm | 10.34.4 | Fixado; `corepack enable` é o caminho mais fácil |
| Rust | stable | Via `rustup`, com `rustfmt` e `clippy` |
| Visual Studio 2022 Build Tools | — | Só no Windows, para compilação nativa |

No Windows, o repositório inclui `check-setup.ps1`, que verifica os quatro itens e diz exatamente o que está faltando.

### Compilar e rodar

terminal

```
git clone REPO_URL conduit
cd conduit
pnpm install
pnpm dev
```

`pnpm dev` inicia o servidor Vite e depois o shell desktop. O primeiro build em Rust demora um pouco; os seguintes são incrementais.

| Comando | O que faz |
| --- | --- |
| `pnpm dev` | Roda o app em modo de desenvolvimento |
| `pnpm build` | Produz um instalador nativo para a sua plataforma |
| `pnpm check` | Faz typecheck do workspace TypeScript |

### Plataformas suportadas

- **Windows 10 / 11** — x86_64, instalador NSIS, sem exigir privilégios de administrador
- **macOS 11 Big Sur ou superior** — binário universal para Apple silicon e Intel
- **Linux** — Ubuntu 20.04+ em `.deb` ou AppImage; outras distribuições em melhor esforço

**Os binários ainda não são assinados pelo sistema operacional.** O macOS Gatekeeper e o Windows SmartScreen vão alertar na primeira execução porque os bundles não têm assinatura em nível de OS. Os payloads de auto-update *são* assinados e verificados separadamente. Compilar a partir do código-fonte evita esse aviso por completo.

## Sua primeira conversa

O Conduit não deixa você conversar até ter um jeito de alcançar um modelo. Na primeira execução, o onboarding pede para você escolher um provedor e fornecer uma credencial.

### Usando um provedor hospedado

1. Abra **Settings → Providers & Keys** (⌘,).
2. Escolha seu provedor e cole a chave de API dele.
3. Selecione um modelo na lista que o Conduit busca desse provedor.

A chave vai para o cofre de credenciais do seu sistema operacional, Windows Credential Manager, macOS Keychain ou Linux Secret Service. O Settings guarda apenas uma referência a ela, nunca o valor. Em máquinas sem chaveiro funcional, existe um armazenamento criptografado baseado em arquivo como opt-in explícito.

### Usando um modelo local, sem chave

Instale [Ollama](https://ollama.com) ou LM Studio, baixe um modelo e selecione esse provedor nas configurações. Nenhuma credencial é necessária e nada sai da sua máquina. Combinado com o modo somente local, que recusa provedores na nuvem de cara, o Conduit não faz nenhuma requisição à internet.

Anexe imagens quando o modelo suportar visão. Edite qualquer mensagem e reenvie: editar sua última mensagem a reescreve no lugar, enquanto editar uma mensagem anterior cria um fork — uma nova conversa a partir daquele ponto — mantendo o original intacto. Exporte uma conversa em Markdown ou JSON.

### Provedores suportados

Dezessete provedores vêm integrados — o endpoint compatível com OpenAI é o décimo sétimo, não um adicional.

| Provedor | Credencial | Base URL |
| --- | --- | --- |
| Anthropic | Chave de API | Editável |
| OpenAI | Chave de API | Editável |
| Google Gemini | Chave de API | Fixa |
| xAI | Chave de API | Editável |
| Z.ai | Chave de API | Editável |
| Moonshot AI | Chave de API | Editável |
| Qwen | Chave de API | Editável |
| DeepSeek | Chave de API | Fixa |
| Mistral | Chave de API | Fixa |
| Groq | Chave de API | Fixa |
| Together AI | Chave de API | Editável |
| Fireworks AI | Chave de API | Editável |
| OpenRouter | Chave de API | Fixa |
| OpenCode Zen | Chave de API | Fixa |
| Ollama | Nenhuma — local | Editável |
| LM Studio | Nenhuma — local | Editável |
| Qualquer endpoint compatível com OpenAI | Opcional | Editável |

A última linha cobre gateways auto-hospedados como vLLM e LiteLLM, além de qualquer provedor que ainda não tenha um adaptador dedicado: informe ao Conduit uma base URL e, se o endpoint exigir, uma chave.

### Adicionando GPT, Claude, Grok, GLM, Kimi e o resto

O Conduit conversa com as famílias de modelos que as pessoas realmente usam em 2026 — GPT, Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen e MiniMax — por meio de um destes três caminhos, dependendo do modelo que você quer.

1. **Adaptador integrado.** Anthropic, OpenAI, Gemini, xAI, Z.ai, Moonshot AI, Qwen, DeepSeek, Mistral, Groq, Together AI e Fireworks AI têm cada um um provedor dedicado: escolha-o, cole a chave e carregue a lista de modelos. Isso cobre Claude, GPT, Gemini, Grok, GLM, Kimi, Qwen e DeepSeek diretamente — cada um vem com seu próprio endpoint padrão, então não há base URL para procurar.
2. **Um gateway.** OpenCode Zen ou OpenRouter catalogam o resto atrás de uma única chave, incluindo o MiniMax e o que mais esses serviços estiverem oferecendo no momento — o Conduit busca a lista ao vivo em vez de um catálogo fixo.
3. **Qualquer endpoint compatível com OpenAI.** Para um provedor sem adaptador dedicado, ou um proxy auto-hospedado como vLLM ou SGLang, aponte o provedor compatível com OpenAI para a base URL desse endpoint e forneça uma chave se ele exigir.

O adaptador integrado do Qwen usa por padrão o endpoint internacional da DashScope, e o do Moonshot usa `api.moonshot.ai` — os dois campos continuam editáveis se você precisar de outra região.

## Atalhos de teclado

Use Ctrl no lugar de ⌘ no Windows e no Linux.

| Atalho | Ação |
| --- | --- |
| ⌘K | Paleta de comandos: busca, comandos, modelos e artefatos |
| ⌘1–⌘9 | Ir para Início, Chats, Apps, Slides, Documentos, Biblioteca, Fluxos de trabalho, Conectores, Memória |
| ⌘N | Nova conversa |
| ⌘, | Settings |
| ⌘/ | Abrir esta folha de atalhos |
| ⌘\ | Alternar a barra lateral |
| ⌘J | Alternar o painel de documentos |
| ⌘⇧E | Expandir o painel de artefatos, ou restaurar o layout |
| ⌘⇧P | Alternar provedor |
| ⌘⇧W | Alternar busca web neste turno |
| ⌘⇧F | Criar um fork da conversa aqui |
| ⌘⇧C | Copiar a última mensagem do assistente |
| Esc | Fechar um painel ou parar uma resposta em execução |

A paleta de comandos é modal: digite `>` para comandos, `@` para artefatos, `/` para modelos ou texto comum para buscar em todas as mensagens que você já enviou. O Settings também tem sua própria busca no topo da folha, para você pular direto para uma configuração pelo nome em vez de percorrer as seções.

## Ferramentas e conectores

### Ferramentas integradas

Estas não precisam de configuração:

- **Busca e fetch na web** — backends Auto / hospedado / local (Exa por padrão e sem chave, Tavily, Brave, SearXNG, DuckDuckGo; busca hospedada na Anthropic, OpenAI, Gemini e OpenRouter), listas de domínios permitidos e bloqueados, e citações numeradas inline
- **Autoria de documentos** — criar e editar artefatos HTML, Markdown e texto, e exportá-los
- **Área de transferência** — ler e escrever no clipboard do sistema
- **Utilitários** — calculadora, hora atual, UUID e valores aleatórios

Uma ferramenta pede sua confirmação antes de executar, a menos que esteja marcada como somente leitura. As ferramentas integradas somente leitura rodam automaticamente, e a de um conector só se o servidor a marcar como somente leitura; qualquer outra pede sua confirmação antes de executar. A busca web vem desligada por padrão e pede consentimento na primeira vez; a busca hospedada só funciona pelo endpoint oficial da Anthropic, OpenAI ou Gemini, e cai para os backends locais acima assim que você aponta um provedor para uma base URL personalizada. As consultas a um backend de busca local vão para esse serviço; o Exa, o padrão, pode mantê-las conforme seus próprios termos.

A busca de páginas do modelo só alcança sites https públicos: nunca `localhost` nem um endereço da sua própria rede, e cada redirecionamento é verificado. Ela devolve o título e o texto legível de uma página em vez de HTML bruto, e lê PDFs de até 20 MB. Um PDF escaneado sem texto conta como uma página sem conteúdo.

### Conectores MCP

O Conduit roda servidores Model Context Protocol como conectores supervisionados. Adicione um processo local na página de **Conectores** com o comando e os argumentos que o iniciam, ou aponte para um endpoint MCP remoto que fale streamable HTTP.

A ferramenta de um conector roda sem perguntar apenas se o servidor a marca como somente leitura (a indicação padrão `readOnlyHint` ou o campo próprio do Conduit, `permissionLevel`). Qualquer outra ferramenta pergunta antes, e você pode lembrar uma aprovação para um chat ou para sempre. Antes da 1.0.0-rc.6, as ferramentas da maioria dos servidores de terceiros rodavam sem perguntar, então os conectores que você já usa podem passar a pedir confirmação por ferramentas que antes rodavam em silêncio.

O runtime reinicia servidores locais que caem com backoff, limitado a três reinícios em cinco minutos, limita a concorrência e aplica timeout de trinta segundos por chamada individual. A saída da ferramenta tem limite de tamanho e é redigida antes de chegar ao modelo, e uma proteção estrutural impede que essa saída seja reproduzida como se fosse uma instrução, a rota padrão de prompt injection por resultados de ferramentas.

**Transportes:** `stdio` local e streamable HTTP remoto já estão disponíveis hoje. O legado HTTP+SSE não é suportado.

O composer também pode trazer prompts e recursos de um conector, não só suas ferramentas: um seletor de prompt preenche os argumentos que um prompt declara antes de o resultado cair no composer para você editar, e um seletor de recurso anexa conteúdo só à próxima mensagem. O consentimento é pedido uma vez por conector, e um recurso que tenta embutir instruções é recusado e identificado, em vez de seguido silenciosamente.

Conectar um servidor na sua própria máquina é o problema da documentação. Colocar esse servidor diante de um cliente — sem configuração JSON e sem aparecer dentro do Claude Desktop — é outro. [Como demonstrar um servidor MCP para um cliente](https://conduitllm.com/pt-BR/mcp-distribution.html) compara um chat hospedado, o Claude Desktop com configuração, e entregar um cliente desktop.

### O loop do agente

Quando um modelo chama uma ferramenta, o Conduit a executa e devolve o resultado para outra rodada dentro do mesmo turno. Você controla os limites em **Settings → Agent**: número máximo de etapas de 1 a 50 e um limite de tempo de 30 segundos a 30 minutos. A UI do chat mostra uma linha do tempo de progresso ao vivo — raciocínio, chamadas de ferramentas e texto, na ordem real em que acontecem ao longo das rodadas, com o tempo decorrido e um aviso quando uma rodada trava — em vez de um simples indicador de carregamento.

## Artefatos

Saídas mais longas, documentos, scripts e pequenas páginas web se abrem em um painel ao lado da conversa em vez de preencher a rolagem das mensagens. O Conduit renderiza texto, código com destaque de sintaxe, JSON como árvore recolhível, Markdown, incluindo diagramas Mermaid e matemática com KaTeX, e HTML interativo.

O HTML interativo roda dentro de um frame com sandbox que permite scripts e nada mais: sem acesso same-origin, sem popups e sem navegação de nível superior. Os formulários funcionam — o Conduit entrega à página o evento submit dela, e nada é enviado a lugar nenhum ao enviar. Uma política de conteúdo injetada define `connect-src 'none'`, então a página não consegue fazer fetch nem abrir sockets por conta própria, e o Conduit a serve a partir de um endereço próprio com sandbox. A página não consegue chamar os comandos da própria aplicação. Uma exceção, um problema conhecido no macOS: o script de uma página ainda pode abrir uma conexão WebRTC, que a política de conteúdo não cobre; o Windows e o Linux a bloqueiam no webview. Se você precisar que um artefato carregue imagens ou fontes de um host específico, pode ampliar isso manualmente na parte de **Segurança de artefatos** de **Configurações → Privacidade e dados**.

Uma página que precise de dados em tempo real — uma cotação, o clima — ainda pode pedir isso. As chamadas `fetch()` dela vão para o Conduit, que retém a primeira solicitação a cada site novo e mostra um aviso com o nome dele. Você pode permitir esse site uma vez, sempre para essa página, ou nunca, ou deixar a página acessar qualquer site público. O Conduit então faz a solicitação por conta própria: só https, sem cookies ou logins salvos, sem endereços locais ou privados, com um tempo limite de 20 segundos, um limite de 5 MB por resposta e 120 solicitações por minuto por página. O botão de globo acima da página lista cada site que ela pediu e cada solicitação que fez. As permissões pertencem a essa página e são apagadas com ela. O modo somente local recusa tudo isso, e **Páginas podem se conectar à internet**, nas mesmas configurações de Segurança de artefatos, desliga isso.

Cole um bloco de código cercado por fences em uma conversa e o Conduit oferecerá promovê-lo a um artefato. Os artefatos podem ser exportados para o disco, opcionalmente com um sidecar de metadados.

Cada artefato guarda um payload atual. Não existe histórico de versões: editar substitui o conteúdo no lugar, então exporte qualquer coisa da qual você queira manter uma cópia.

## Documentos

Crie uma coleção em **Documents**, na barra lateral, e então adicione arquivos — texto simples, Markdown, CSV, Word (.docx) ou PDF. Solte um arquivo em qualquer lugar da janela para adicioná-lo, ou anexe uma coleção inteira pelo composer para uma única conversa. Uma resposta mostra os arquivos em que se baseou como chips clicáveis; clique em um para ver a passagem exata.

Cada coleção é embedada por um único provedor — OpenAI, Gemini, OpenRouter ou Ollama (o Anthropic não consegue gerar embeddings). A indexação envia o texto completo de um documento para esse provedor, então o Conduit pede consentimento na primeira vez, lembra sua resposta por provedor, e você pode revogá-la depois na página de **Documentos**. Escolha o Ollama e nada sai da sua máquina — o modo somente local força essa escolha. A busca em si é híbrida: similaridade vetorial mais busca por palavra-chave sobre o mesmo banco SQLite local, e as passagens recuperadas continuam indo para o provedor que responde na conversa.

A leitura acontece no próprio dispositivo, sem nenhuma etapa de OCR, então um PDF escaneado sem camada de texto não gera nada — o Conduit avisa quando isso acontece em vez de importar um documento vazio.

## Geração de imagens

OpenAI, Gemini e OpenRouter conseguem gerar imagens direto em uma conversa. O Conduit pede uma vez, antes da primeira imagem, já que cada uma é cobrada pelo provedor — só falar sobre geração de imagens não dispara esse pedido. O resultado é salvo localmente como um artefato em vez de vinculado ao provedor, então não expira.

## Apps pessoais

Uma página que vale a pena guardar pode ser salva como app pessoal: **Salvar como app** no menu ⋯ da página cria uma cópia que você abre em **Apps** na barra de navegação, ou em *Seus apps* na tela de novo chat. A cópia continua funcionando depois que você apaga o chat. Ao salvar, o Conduit pergunta quais permissões de site da página manter, uma a uma, e não mantém nenhuma que você não marcar. Quando a página do chat muda depois, o app oferece **Atualizar**. Oito apps iniciais já vêm incluídos; adicione um pela página Apps, ou pressione **Abrir app** em uma ideia que tenha um.

Uma página (um app, ou uma em um chat) pode declarar mais três coisas, cada uma verificada pelo Conduit. Ela pode guardar dados entre as aberturas — até 5 MB por página, armazenados junto com o resto dos seus dados e criptografados quando a criptografia em repouso está ativada; **Limpar dados** os remove. Pode receber algumas configurações, como uma cidade, que o Conduit pede em um formulário próprio e repassa à página em execução sem recarregá-la. E pode perguntar ao seu modelo de IA, depois que você permitir isso para aquela página: o aviso nomeia o provedor e diz quando o texto sairia do seu dispositivo, e a página recebe texto de entrada e texto de saída — sem ferramentas, histórico de chat, memória nem documentos.

Cada app pessoal tem sua própria página de **Configurações** (a engrenagem no cabeçalho do app, ou ⋯ → Configurações): qual modelo responde, tokens por dia com um limite diário para modelos na nuvem (100.000 por padrão; modelos no seu computador nunca têm limite), seus dados salvos chave por chave com Exportar e Limpar, os sites e provedores que ele pode usar e uma semana de registros de atividade de uma linha — nunca prompts, respostas ou valores salvos.

## Slides

Descreva a história, ou peça uma apresentação em qualquer chat, e o Conduit redige uma narrativa para você aprovar e depois monta *uma* apresentação ao vivo: cada mudança edita essa mesma apresentação em vez de gerar mais uma cópia. Ela abre em um estúdio, com o slide grande no centro e o chat ao lado. Peça uma mudança e o assistente edita um único slide, ou troca uma palavra na apresentação inteira.

**Roteiro** mostra cada palavra da apresentação como um único documento; digite ali, ou dê dois cliques no texto de um slide. O texto que você escreve é mantido quando o assistente reescreve um slide, a menos que você peça para mudar justamente esse texto. **Histórico** guarda uma versão para cada mudança, com o nome do seu pedido, para restaurar quando quiser. Há dois temas embutidos, além de qualquer tema que o assistente desenhe para você.

**Apresentar** abre a apresentação em tela cheia, com um **modo apresentador** separado — slide atual e próximo, notas do orador e um cronômetro — para manter privado enquanto você compartilha os slides. **Exportar** salva um único arquivo HTML que se apresenta sozinho em qualquer navegador, ou um PDF somente no Windows. Slides acrescenta dados ao seu banco de dados local: voltar a uma versão anterior aos Slides começa com um banco vazio (o arquivo antigo é mantido como backup).

## Pesquisa

Para uma pergunta que exige mais do que uma busca rápida, ative a **Pesquisa** no menu **+** do composer (ou escolha-a em Início) e pergunte. Ela exige que a busca web esteja ativada e não está disponível no modo somente local. A Pesquisa usa um backend de busca local (Exa, Tavily, Brave, seu próprio SearXNG ou DuckDuckGo), nunca a busca hospedada: as consultas vão para esse serviço e o texto das páginas vai para o provedor de chat que você escolheu.

**O resumo.** Antes de qualquer coisa rodar, a Pesquisa propõe um resumo: de uma a seis subperguntas que vai responder, um escopo opcional e uma profundidade. Você edita e aprova. Cada profundidade define até onde ela pode ir:

- **Rápida** — até 8 buscas, 15 páginas, 10 minutos
- **Padrão** — até 20 buscas, 40 páginas, 20 minutos
- **Profunda** — até 50 buscas, 100 páginas, 40 minutos

**O que ela lê.** Lê as páginas inteiras, três por vez: páginas web e PDFs de até 20 MB, processados no seu dispositivo. Um PDF escaneado não tem texto e conta como uma página sem conteúdo. Em uma página ou PDF longo, o modelo vê o início e as partes que combinam com as suas perguntas, não o todo.

**A verificação das citações.** O modelo extrai afirmações, cada uma com as palavras exatas da página que a sustentam. Uma afirmação só conta se a citação (de pelo menos 20 caracteres) estiver no texto guardado dessa página, e essa verificação é feita pelo app, não pelo modelo. Depois a Pesquisa busca de novo o que ainda está sem resposta, e um redator transforma as afirmações verificadas no relatório. As citações numeradas e a lista de fontes são geradas pelo app, não pelo modelo.

**O relatório.** O resultado é um documento Markdown nos documentos do chat: um resumo, achados por subpergunta, perguntas em aberto e fontes numeradas, com cada achado citado. O cartão no chat mostra o resumo e quantas fontes foram citadas e lidas, com um botão **Abrir o relatório**. **Parar** encerra a execução e mantém o que foi encontrado até então.

**As páginas não podem dar ordens a ela.** O texto das páginas só chega a uma chamada ao modelo sem ferramentas, então uma página que tente dar instruções não consegue fazer a Pesquisa buscar, baixar nem salvar nada. As chamadas ao modelo da Pesquisa rodam em uma conversa oculta própria.

**Limites:** em uma página longa, o modelo vê um trecho, não tudo. Um PDF escaneado não tem texto. Seus próprios documentos ainda não são uma fonte. Um modelo de raciocínio é lento, e a profundidade Profunda pode atingir o limite de tempo antes de terminar.

## Fluxos de trabalho

A página **Fluxos de trabalho** executa rotinas por você: buscar páginas, pesquisar na web, pedir ao modelo que resuma, fazer uma pergunta a você e salvar o resultado como documento. Comece por um fluxo pronto — um briefing da manhã, um resumo de página, um monitoramento de tópico — ou crie o seu no editor de etapas e execute agora ou em um agendamento (diariamente, em dias úteis em um horário fixo, ou a cada poucas horas). Abra qualquer execução para ver o que cada etapa fez; se você corrigir uma etapa, execute novamente a partir dela, sem repetir as anteriores.

Ao ligar um agendamento, primeiro é listado tudo o que o fluxo poderá fazer sozinho — os sites que ele lê, a busca na web, qual modelo, o salvamento de documentos — para você aprovar. Uma execução agendada que precise de mais, depois de uma edição por exemplo, pausa e pergunta: permitir uma vez, sempre permitir ou não permitir. Cada execução tem um limite de tempo e de tokens, e você pode interromper uma em andamento. Uma execução perdida enquanto o Conduit estava fechado acontece uma vez quando você o abre.

Para que os agendamentos continuem com a janela fechada, o Conduit pode ficar na bandeja do sistema e iniciar lá quando você entra; as duas opções vêm desligadas por padrão, e a da bandeja é oferecida uma única vez, na primeira vez que você liga um agendamento.

## Início

O Conduit abre em **Início**, o primeiro item da barra de navegação. Uma única caixa de texto começa qualquer coisa: peça uma apresentação e Slides abre com uma narrativa; peça qualquer outra coisa e um chat começa. Abaixo, **Precisa de você** lista aprovações e perguntas de fluxos de trabalho e sugestões de memória à sua espera (oculto quando não há nada), **Continue de onde parou** mostra seus últimos chats, apresentações e apps, e cada área do app tem um bloco com contagem ao vivo — ou um exemplo para experimentar enquanto estiver vazia.

Ctrl+1 a Ctrl+9 (⌘ no macOS) abrem Início, Chats, Apps, Slides, Documentos, Biblioteca, Fluxos de trabalho, Conectores e Memória, e a paleta de comandos tem uma entrada “Ir para” para cada um.

## Aparência e idioma

O Conduit tem um único design em dois modos. Em **Configurações → Aparência**, escolha escuro, claro ou seguindo o seu sistema, e escolha a cor principal — o destaque em botões, seleção e no item ativo — separadamente para cada modo; uma cor que seria difícil de ler é recusada. A mesma página define o tamanho da fonte da interface, a densidade e o tamanho dos diagramas.

A mesma página de Configurações define o idioma da interface, nos oito idiomas em que o Conduit é distribuído. Ela muda menus, botões, datas e números — não muda o idioma em que o assistente responde.

## Onde seus dados ficam

O Conduit guarda tudo no diretório de dados de aplicativo da sua plataforma: um banco SQLite para conversas, mensagens, prompts e uso, mais um blob store endereçado por conteúdo para anexos e artefatos, deduplicados por hash.

As mensagens são gravadas como um log de eventos append-only com uma view materializada por cima, o que permite que uma conversa sobreviva mesmo se o app for encerrado no meio de uma resposta. Na inicialização, o Conduit reconcilia os dois.

A criptografia opcional AES-256-GCM em repouso está disponível em **Settings → Privacy & data**, com a chave mestra encapsulada pelo chaveiro do seu sistema operacional. Ela vem desligada por padrão e ainda não cobre o texto das mensagens. Veja a [página de privacidade](https://conduitllm.com/pt-BR/privacy.html) para o escopo atual.

## Solução de problemas

### O build falha no Windows

Quase sempre é a falta da toolchain de C++. Instale o Visual Studio 2022 Build Tools com a workload "Desktop development with C++" e depois rode `check-setup.ps1` para confirmar.

### A minha chave de provedor não está sendo salva

O Conduit precisa de um cofre de credenciais do sistema operacional funcionando. Em sistemas Linux headless ou mínimos pode não haver nenhum Secret Service em execução. Inicie um daemon de keyring ou ative o armazenamento de credenciais criptografado baseado em arquivo, que exige fornecer uma chave pelo ambiente.

### Os modelos do Ollama não aparecem

Confirme que o Ollama está rodando, que pelo menos um modelo foi baixado e que a base URL configurada no Conduit corresponde à porta em que o Ollama está escutando.

### Outra coisa está quebrada

Exporte um pacote de diagnóstico em **Settings → Diagnostics** e anexe a uma issue. Ele exclui segredos, base URLs, allowlists e o conteúdo das conversas por design, e exige que você reconheça o que ele contém antes de ser gerado.

[Ler o código](https://github.com/runningpixels/conduit)
