Chat com IA

Como funciona

IA → Chat com IA… abre o chat numa aba da janela, no painel à direita, que responde usando as suas próprias notas como contexto. Em vez de mandar tudo para a nuvem, o LightNote recupera os trechos mais relevantes do seu vault localmente (via ripgrep, sem depender de embeddings nem de serviço externo), monta a pergunta com esses trechos e a envia a um provedor de IA por API que você tenha cadastrado. A resposta vem com as notas-fonte como citações clicáveis — clique para abrir a nota. Ótimo para "conversar com o seu segundo cérebro" e reencontrar o que você já anotou. As conversas ficam guardadas por pasta, e você pode voltar a elas (veja abaixo); o recurso pode ser desligado em Configurações → Geral → Recursos.

A aba e a janela. O chat abre ao lado do que você está lendo, numa aba no painel à direita — uma por janela, e cada janela tem a sua conversa. Na aba, as notas são as da pasta da janela, e o contexto Editor atual acompanha a aba ativa (veja abaixo). Os seletores ficam no topo: a IA, o contexto e o Modo (o que a IA pode fazer), com os botões de anexar um arquivo e de começar uma conversa nova; numa aba estreita eles ocupam duas linhas. Antes da primeira pergunta, a tela diz sobre o que o chat vai responder e oferece atalhos de um clique, como Resumir esta pasta. No campo de pergunta, Enter envia e Shift+Enter quebra a linha; enquanto a resposta vem, o botão de envio vira Parar. Fechar a aba guarda a conversa na lista, como Nova conversa.

Mover, desacoplar e reacoplar. A aba se arrasta como qualquer outra — para o painel principal, para o de baixo ou de volta à direita —, e ao reabrir a pasta ela volta ao painel em que você a deixou. Desacoplar em janela, em Ações da conversa ou no botão do canto, leva a mesma conversa — com a pasta, os anexos, a seção da Ajuda e o que você permitiu nela — para uma janela avulsa, e a aba fecha. Na janela avulsa, Reacoplar à janela a devolve à aba da janela de onde ela saiu (ou de outra com a mesma pasta). A conversa fica aberta num lugar só, e enquanto a IA responde ela não troca de lugar. O ícone da bandeja (IA → Chat com IA…) abre a janela avulsa, que tem o seletor Notas de: para escolher a pasta.

Quem respondeu e comparar respostas. Sob cada resposta aparece, discreto, o assistente e o modelo que a escreveram — útil quando a conversa trocou de assistente ou quando o primeiro modelo da lista falhou. O chat lembra o último assistente escolhido por janela e pasta. Para mandar a mesma pergunta a mais de um, use Comparar respostas… no menu do chat ou escreva /comparar antes da pergunta: veja Comparar respostas.

Ferramentas e permissões

O Modo: o que a IA pode fazer. O seletor Modo, na faixa do topo, tem três valores. Só notas responde com os trechos que a busca por termos recuperou, e nada é executado. Ler deixa o modelo procurar sozinho — ler um arquivo, pesquisar notas, listar tarefas, consultar esta Ajuda — antes de responder, sem alterar nada. Alterar com aprovação soma a isso criar notas e tarefas, mudar propriedades e anotar na nota do dia, sempre com a sua confirmação. Quem nunca escolheu começa em Ler, porque ler é seguro. No fim da resposta aparece a lista das ferramentas usadas, para você julgar a resposta em vez de confiar nela.

O teste do modelo. Ler e Alterar com aprovação exigem um provedor por API (uma CLI local não tem como receber ferramentas). Ao escolhê-los, o LightNote testa na hora se o modelo sabe chamar ferramentas: muitos provedores aceitam o pedido e simplesmente as ignoram, o que sem essa verificação viraria uma resposta inventada com cara de consultada. O teste é lembrado por sete dias para cada par provedor+modelo. Se ele reprovar, só Só notas fica disponível, e o botão Verificar de novo, ao lado da mensagem, refaz o teste ignorando o que ficou guardado — o provedor pode ter estado fora do ar naquele instante.

Cada alteração pede a sua confirmação. A alteração aparece na conversa em português claro ("criar a tarefa Comprar pão") com três respostas: Permitir, só desta vez; Permitir nesta conversa, que deixa a mesma ferramenta passar sem perguntar até a conversa acabar (a conversa avisa a cada vez: Permitido pela conversa); e Recusar, que não encerra a conversa — o modelo é avisado e segue explicando ou propondo outro caminho. Apagar nunca entra nessa permissão: cada exclusão pergunta. Zerar permissões desta conversa, em Ações da conversa, volta a perguntar tudo, assim como uma conversa nova ou outra pasta. Ficam de fora, de propósito, sobrescrever arquivos quaisquer e acessar a rede. Quando a alteração é na nota do dia, o pedido diz em que pasta ela vai cair.

Quando a IA pergunta ou para. Se falta um dado de que a resposta depende — em qual quadro, qual de duas notas —, a IA pode perguntar a você: a pergunta aparece na conversa com uma opção por link e, quando cabe, o campo Outra resposta…; Não responder deixa o modelo seguir sem o dado. Respondida, a pergunta vira texto, e as opções de uma pergunta antiga não fazem nada. Depois de vários passos sem terminar, a conversa para e mostra Continuar, que dá mais passos ao mesmo trabalho; se o modelo repete a mesma consulta três vezes sem avançar, ela para e diz qual era. O texto de cada passo aparece aos poucos, enquanto o modelo escreve.

Sobre o que ele responde

Notas ou o arquivo aberto. O combo Contexto:, no topo do chat, escolhe sobre o que a conversa é: Notas do vault (o padrão, descrito abaixo) ou Editor atual — que responde sobre o arquivo aberto no editor em vez do vault, usando a seleção e o trecho ao redor (ou o arquivo inteiro, com a caixa Arquivo inteiro). Na aba, Editor atual acompanha a aba ativa da janela: trocar de aba troca o arquivo, a aba do próprio chat não conta, e quando a aba ativa não é um editor de texto o item fica indisponível sem mudar a sua escolha. Na janela avulsa, ele é o editor de onde você abriu o chat. E, no assistente rápido (Ctrl+K), o resultado traz um botão Continuar no chat → que abre o chat já no escopo Editor atual, semeado com a pergunta e a resposta daquela rodada — para aprofundar sem recomeçar.

De quais notas? Na aba, das notas da pasta da janela: trocar a pasta da janela troca a do chat, e a conversa em andamento vai para a lista. A janela avulsa responde sobre uma pasta por vez, escolhida no combo Notas de:, que lista as pastas abertas agora, seguidas das recentes; Escolher pasta… aponta para qualquer outra — é o jeito de perguntar às notas de um projeto enquanto você trabalha em outro. Escolhida à mão, a pasta continua valendo até você trocá-la de novo. Enquanto uma pergunta está em andamento — inclusive parada esperando a sua confirmação —, os seletores de IA, de contexto e de pasta ficam travados: a resposta que está vindo pertence ao modelo e à pasta de quando você perguntou.

Como perguntar. A recuperação é por assunto, não por instrução: o LightNote extrai as palavras da sua pergunta e procura as notas que as contêm. Cite um tema que apareça nas notas ("o que anotei sobre Postgres?") em vez de um pedido genérico ("faça um resumo") — este último não tem nenhuma palavra de conteúdo para buscar, então nada é recuperado e o chat avisa que a resposta não usou as suas notas. Só notas .md/.markdown são lidas; numa pasta sem nenhuma delas o chat avisa e não gasta uma chamada de IA.

Busca melhor, resumo e reescrita. A recuperação usa um índice local com ranqueamento BM25 que ignora acentos ("configuração" acha "configuracao") e funciona também em idiomas sem espaço entre palavras (japonês, chinês, coreano) — o ripgrep é o reforço quando o índice ainda está sendo montado. O botão Resumir esta pasta — e o item Resumir com IA… no menu de contexto de qualquer pasta do explorador — lê as notas em lotes e devolve um documento. E, em Configurações → Geral → Recursos, a opção Reescrever a pergunta com IA amplia a sua pergunta em palavras-chave antes de buscar (custa uma chamada de API por pergunta).

Chave e conversas

Basta uma chave. Na primeira execução, o LightNote já deixa OpenAI, Google Gemini e Anthropic (Claude) cadastrados em Configurações → Assistentes de IA — só falta colar a sua chave de API no provedor que você usa. Se nenhum provedor tiver chave, a janela mostra um botão Configurar agora que abre essa tela direto.

Conversas ficam guardadas. O botão de relógio no topo abre a lista de conversas anteriores daquela pasta: clique numa para voltar a ela. Nova conversa arquiva a atual em vez de apagá-la, e o botão direito na lista apaga uma conversa de vez (com confirmação). As conversas são guardadas por pasta — trocar a pasta de notas troca a lista. Reabrir a pasta traz a aba do chat de volta com a conversa que estava aberta.

O que fazer com a resposta

O que fazer com uma resposta. Sob cada resposta há Copiar (põe o texto em Markdown na área de transferência, com a formatação intacta) e Capturar na nota (manda a resposta para a nota do dia, junto com links para as notas citadas). No menu Ações da conversa ficam Copiar conversa, Salvar conversa como nota… (grava um .md na pasta consultada), Refazer última resposta e Editar última pergunta.

Anexar um arquivo. Quando a busca não acha o que você tinha em mente, use o botão + para anexar um arquivo: ele entra sempre na pergunta, fora da disputa da busca. Vale nota, código, texto e PDF (o texto do PDF é extraído); um binário é recusado na hora, em vez de virar lixo no contexto. O anexo aparece como uma pílula (clique para desanexar) e some ao começar uma conversa nova. Nos provedores que suportam, a resposta também vai aparecendo aos poucos, à medida que o modelo escreve.

Memória do assistente. No menu Ações da conversa (o botão ☰ no topo), Memória do assistente… abre — criando na primeira vez — a nota Memória.md na raiz da pasta selecionada. Tudo o que estiver nela entra em toda pergunta feita sobre aquela pasta, antes dos trechos encontrados: as suas preferências, as decisões que você já tomou, o que descartou e por quê. É um .md comum — edite quando quiser, versione com Git, apague para desligar a memória. Com as ferramentas de escrita ligadas, o assistente também pode propor guardar um fato ali, e como toda escrita ele espera a sua autorização.

Resumir uma pasta. Vale para o espaço inteiro ou para qualquer subpasta: clique com o botão direito nela no explorador e escolha Resumir com IA…. Antes de gastar, o LightNote diz quantas notas serão lidas e quantas chamadas de IA isso fará — cada uma cobrada pelo seu provedor — e deixa você escolher a forma: Panorama, um texto corrido, ou Consolidar conhecimento, com seções fixas (decisões, pendências, ideias, contradições e perguntas em aberto; a seção sem conteúdo é omitida em vez de preenchida com invenção). Se a pasta tiver mais notas do que cabem no teto de custo, a resposta diz quantas ficaram de fora. No fim, Salvar como nota grava o resumo dentro da pasta resumida, com a data e o número de notas no cabeçalho, e sem nunca sobrescrever um resumo anterior.

Comandos, Ajuda e links

O assistente conhece o LightNote. Além das suas notas, ele sabe que está dentro do LightNote: recebe o índice desta Ajuda, um resumo do Markdown do app (wikilinks, callouts, diagramas, fórmulas, calendários) e, a cada pergunta, a pasta consultada, a aba ativa e a data. Pergunte "como crio um quadro de tarefas?" como perguntaria sobre uma nota.

Comandos com /. Digitar / no começo do campo vazio abre a lista de comandos, que filtra enquanto você digita; Enter escolhe e Esc fecha. /ajuda seguido de um tema (/ajuda tabelas) anexa à conversa a seção desta Ajuda cujo título casa com o tema, com ou sem acento; sem tema, entra a seção da tela de onde você abriu o chat. Com uma pergunta no lugar do tema (/ajuda como criar uma tabela), a lista mostra as seções que podem responder: a escolhida é anexada e a pergunta vai junto.

A seção anexada. Ela aparece como uma pílula Ajuda: … ao lado dos anexos, vai em toda pergunta antes dos trechos das notas e sai com um clique nela ou numa conversa nova. Na tela vazia, Como funciona o chat? faz isso com esta seção e já pergunta.

Os outros comandos. /resumir resume a pasta e /nova começa uma conversa nova. Os prompts da pasta Prompts aparecem na mesma lista: escolher um põe o texto no campo, para você revisar antes de enviar.

Notas com [[ ou @. Digitar [[ ou @ no campo abre a lista das notas da pasta, que filtra enquanto você digita, com ou sem acento. Enter escolhe, e a nota entra como anexo — a mesma pílula do botão +, relida a cada pergunta e fora da disputa da busca —; o que você digitou para encontrá-la sai do campo. Esc, Espaço ou um clique fora fecham a lista sem anexar nada.

Ajuda e Markdown como ferramentas. Nos Modos Ler e Alterar com aprovação, o modelo consulta esta Ajuda sozinho (help_lookup) e a referência da sintaxe que o LightNote desenha (markdown_reference) — é assim que ele acerta o caminho do menu e a cerca de um diagrama — e, quando falta um dado, pergunta a você (ask_user). As duas primeiras também estão no servidor MCP, para as CLIs de IA; a pergunta é só do chat, porque depende de alguém diante da tela.

Links para as telas. Quando a resposta precisa de uma tela do app, ela traz um link em vez de descrever o menu: lightnote://settings/ai abre as Configurações na seção dos assistentes de IA, lightnote://help/… uma seção desta Ajuda, lightnote://wizard/clone o assistente de clonar, lightnote://open?file=… um arquivo da pasta e lightnote://new?type=lnt cria um arquivo novo. O mesmo link funciona dentro de uma nota.

Nada abre sozinho. O clique é o seu consentimento. Um link para fora da pasta, para um recurso desligado ou para um destino que não existe não abre nada, e a linha de status diz por quê.

Configurar o app e criar conexões

Mudar uma configuração. No Modo Alterar com aprovação, peça como pediria a alguém: "mude o tema para escuro", "aumente a fonte do editor para 14", "desligue o minimapa". O pedido aparece como antes → depois ("Tema: Claro → Escuro"), com um link para a seção das Configurações onde a mesma opção mora, e só vale depois de Permitir; então a conversa diz Aplicado com o valor novo.

Cada mudança pergunta de novo. Permitir nesta conversa não vale para configurações. Interpretadores e CLIs de IA também se acrescentam, alteram ou removem assim, sempre com o programa pelo nome, nunca por uma pasta. Um shell (pwsh, bash) só entra como interpretador que abre o arquivo, como em pwsh -File {file}, nunca com um comando escrito na própria linha.

O que fica de fora. Só uma lista fechada de opções é alcançável: tema, idioma, fonte do editor, visão inicial do Markdown, recursos, notas diárias e as opções de IA, entre outras. Chave de API, endereço de provedor, caminhos de programas e terminais nunca mudam pelo chat: o assistente responde com o link da seção certa. É de propósito — o texto das notas entra na conversa, e uma nota vinda de fora não pode desviar a sua IA para outro endereço.

Criar um teste HTTP ou uma conexão. Peça "crie um teste para GET https://…", "salve a conexão SSH com deploy@servidor" ou "conecte no banco de vendas": depois de Permitir, o assistente cria o .lnh, o .lns ou o .lnc no mesmo formato que o app grava, e a conversa mostra Criado com o link que abre o arquivo. Ele nunca sobrescreve um arquivo, só cria dentro da pasta e não cria o tipo de um recurso desligado na seção Recursos das Configurações.

Falta um dado? Ele pergunta. Quando falta um dado que muda o resultado — o banco, o servidor, o tipo de autenticação —, ele pergunta com as opções antes de criar.

Nenhuma senha passa pelo chat. A conexão de banco e a SSH nascem sem senha: ela é pedida quando você conecta, e o acesso de IA à conexão de banco fica desligado até você liberar. No teste HTTP, o token ou a senha vira uma variável vazia ({token}), que você preenche no teste ou no http-client.private.env.json; um segredo escrito por extenso é recusado. Os três criadores também estão no servidor MCP, para as CLIs de IA; mudar configurações é só do chat.