Assistente de IA na seleção (Ctrl+K / Ctrl+I)

Perguntar e editar com IA

IA padrão. No topo de Configurações → Assistentes de IA, a IA padrão escolhe o assistente usado pelo Ctrl+K/Ctrl+I, pelo chat Chat com IA (que você pode trocar por sessão) e pelas tarefas automáticas (reescrever a pergunta, resumir, resumo de áudio, gerar contexto). Ela lista tanto as CLIs quanto os provedores de API. Já a transcrição de áudio e os embeddings têm provedor próprio, e o LightNote sugere um modelo conforme o provedor escolhido.

Pressione Ctrl+K (Perguntar à IA) ou Ctrl+I (Editar com IA) no editor — com ou sem seleção — para abrir um popup flutuante estilo "inline chat": o campo de prompt já vem com a seleção abaixo de uma linha em branco; digite a instrução por cima e envie com Ctrl+Enter. No popup você escolhe a IA (a padrão vem pré-selecionada) e o modo de resultado: substituir a seleção vendo um diff (Original × Sugestão, com Aceitar / Copiar / Rejeitar) ou apenas exibir a resposta como texto.

O LightNote roda a CLI de IA em modo "one-shot" (sem abrir terminal). As CLIs e a IA padrão ficam em Configurações → Assistentes de IA.

Conectar um modelo

Modelos por API. Além das CLIs locais, você pode cadastrar modelos de LLM por API compatível com OpenAI (OpenAI, Groq, DeepSeek, OpenRouter, Gemini, Anthropic, instâncias locais como Ollama/LM Studio…) em Configurações → Assistentes de IA. Escolha um provedor do catálogo (já com a URL pronta), cole a chave (guardada codificada só nesta máquina), use Buscar modelos… e Testar. Os modelos cadastrados aparecem no mesmo seletor do Ctrl+K, ao lado das CLIs.

Conectar em um passo. O caminho normal não é preencher a tabela: em Configurações → Assistentes de IA, clique em Conectar uma IA…, escolha o provedor (a lista marca quem tem plano gratuito e quem roda no seu computador, sem chave), siga os três passos, abra a página de chaves no botão e cole a chave. O LightNote preenche o endereço e o modelo sozinho e testa a conexão antes de salvar — chave errada aparece ali, não no meio de uma conversa. A lista de cima mostra o que já está conectado e, no que falta algo, o que falta (“falta colar a chave”, “falta escolher o modelo”); um duplo clique reabre o assistente naquele provedor.

Ajustes finos. Endereço, modelo, permissão de MCP, comandos das CLIs, transcrição de áudio e embeddings continuam todos disponíveis em Avançado, no fim da página — e dentro do próprio assistente, em Opções avançadas, dá para mudar a URL base e o modelo antes de conectar. Nada foi removido: só saiu da frente de quem está começando. Nos embeddings há ainda o campo Dimensões, opcional: alguns modelos aceitam devolver um vetor menor (512 em vez de 1536), o que corta o cache pela metade com pouca perda. Deixe em (padrão do modelo) se não souber — nem todo provedor aceita o parâmetro. Trocar o valor invalida o cache: vetores de dimensões diferentes não se comparam, então ele é descartado e reconstruído na busca seguinte, o que custa novas chamadas.

Nem toda falha é igual. O LightNote separa as classes porque elas pedem gestos opostos. Sobrecarga do provedor e limite de ritmo passam sozinhas: o app repete a chamada por conta própria, respeitando o tempo que o provedor pedir, e você só vê o erro se nem assim funcionar. Saldo ou limite de gastos não passa com repetição nenhuma — a mensagem diz isso, para você não ficar tentando. Conversa longa demais pede sessão nova, não outro modelo. E a falha do modelo — aposentado, fora da sua conta, fora do seu plano, ou aceitou a chamada e não respondeu — é a única que trocar de modelo resolve. Quando o tempo pedido é longo demais para esperar, a mensagem diz quantos segundos ele pediu, em vez de deixar a janela parada.

Trocar o modelo sozinho. Marque Trocar de modelo automaticamente quando o atual falhar e o LightNote tenta, na ordem mostrada ali mesmo, os modelos recomendados para aquele provedor. Vem desmarcado de propósito: cada tentativa é uma chamada cobrada na sua conta. A alternativa nunca custa mais que o modelo que você escolheu — a lista é publicada do mais caro ao mais barato e o app só desce por ela; um modelo personalizado, que não está na lista, cai direto no mais barato dela. Só a falha definitiva fica gravada no provedor; quando foi a rede que falhou, a troca vale só para aquela chamada e a sua escolha continua valendo. A troca nunca é silenciosa: uma notificação diz qual modelo respondeu e se a mudança ficou gravada.

E o aviso que chega antes da falha. A troca automática só age depois que a chamada falhou — mas o catálogo de modelos, que o LightNote consulta sozinho, costuma saber da aposentadoria antes disso. Quando o modelo que o próprio LightNote cadastrou para um provedor sai do catálogo, um aviso diz isso, e em Configurações → Assistentes de IA aparece um botão para passar para o substituto — que, pela mesma regra, nunca é mais caro. O aviso vale só para o modelo que o app escolheu e você nunca tocou: um modelo que você digitou é escolha sua, e o LightNote não se mete nela.

Quando nada responde. O LightNote diz o que houve e oferece trocar o modelo, usar outro assistente ou desativar esse provedor até você resolver. Um provedor desativado (coluna Ativo da tabela, em Avançado) some das listas sem perder a chave nem o resto da configuração. Na lista de assistentes cada um diz se é local ou na nuvem — escolher um na nuvem faz o texto enviado sair da sua máquina.

Configurar IA. O caminho guiado para qualquer IA é o botão Configurar IA…, no topo de Configurações → Assistentes de IA (é também o que abrem o Conectar uma IA… do chat vazio e o aviso do Ctrl+K sem nenhuma IA). Ele pergunta o que você quer configurar e leva, passo a passo, por cinco caminhos: IA na nuvem, IA no seu computador com Ollama ou LM Studio, IA no seu computador direto pelo LightNote, assistente de linha de comando e busca por significado. Ao lado do botão, a tabela O que cada recurso usa mostra qual IA atende o chat, o Ctrl+K, a IA do bloco, as tarefas automáticas e a busca por significado. Os detalhes estão em IA no seu computador.

Sem chave: LLM local

Sem nenhuma IA ainda? Ao usar Ctrl+K sem nenhum assistente conectado, o LightNote explica e oferece conectar um na hora — e, assim que você conecta, a ação que você pediu continua, sem precisar repetir o atalho.

LLM local (sem chave). Provedores locais — Ollama, LM Studio, llama.cpp — dispensam chave de API: escolha um deles em Adicionar (o seletor mostra se o servidor está em execução) e use Buscar modelos… para escolher entre os modelos que você já baixou. Se o Ollama não estiver instalado, o LightNote oferece instalá-lo por você. Ele já vem cadastrado na primeira execução — falta só escolher o modelo. Como um modelo local pode demorar bem mais para responder (sobretudo na primeira geração, quando o modelo é carregado), o LightNote espera muito mais por ele do que por um serviço na nuvem. Nenhum texto seu sai da máquina.

Rodar o modelo sem nenhum programa à parte. Além do Ollama e do LM Studio, o LightNote sabe baixar e rodar um modelo por conta própria, com o programa oficial do llama.cpp: o assistente Configurar IA mostra antes quanto ele ocupa em disco e em memória e mede a velocidade no seu computador. Veja IA no seu computador.

Aceitar, prompts e onde as ações vivem

Aceitar por trecho. Quando o resultado vem em modo diff, você não precisa aceitar tudo: cada bloco alterado tem uma caixa para incluir ou não aquela mudança, e o texto final é remontado só com os trechos marcados. O prompt também leva contexto automático do arquivo (caminho, linguagem e as linhas ao redor da seleção), para a IA responder com mais precisão sem você colar nada.

Biblioteca de prompts. IA → Biblioteca de prompts… guarda prompts reutilizáveis como arquivos .md numa pasta Prompts/ do seu espaço — formato aberto, versionável no Git e parte do seu segundo cérebro. O seletor traz busca, pré-visualização e um botão para criar um prompt novo. Ao escolher um, os campos {seleção}, {arquivo}, {pasta}, {nome} e {linguagem} são preenchidos com o contexto do editor atual (variáveis suas são preservadas), e o texto é injetado no campo do Ctrl+K ou enviado ao terminal de IA ativo, sem submeter.

Não só no editor de código. As ações de IA (Ctrl+K / Ctrl+I e o menu de contexto) valem também no editor de Markdown, na nota embutida das Tarefas e no editor de consultas SQL do banco — em cada um o popup abre sobre o cursor e aplica o resultado no lugar.

Todas as ações de IA vivem no menu IA (no botão ☰ e no botão da varinha, na barra de atividades): Perguntar à IA (Ctrl+K), Editar com IA (Ctrl+I), Sessões de IA, Chat com IA, Biblioteca de prompts, Gerar arquivo de contexto do espaço, Ativar IA nesta pasta e Configurar assistentes de IA.

A janela fica aberta enquanto você escreve. Ela não se fecha quando você clica no editor — dá para reler o código ou selecionar outro trecho sem perder a instrução já digitada. Fecham-na o Esc, o ✕ da própria janela e as ações de resultado (Aceitar/Rejeitar). Ao trocar de aba ela se recolhe guardando o que estava escrito: volte ao mesmo arquivo, aperte Ctrl+K e a instrução reaparece onde parou.