Chat IA

Come funziona

IA → Chat IA… apre la chat in una scheda della finestra, nel riquadro di destra, che risponde usando le tue note come contesto. Invece di inviare tutto al cloud, LightNote recupera localmente gli estratti più pertinenti dal tuo vault (tramite ripgrep, senza embedding né servizi esterni), costruisce la domanda con quegli estratti e la invia a un provider IA via API che hai registrato. La risposta arriva con le note di origine come citazioni cliccabili — clicca per aprire la nota. Ottimo per "dialogare con il tuo secondo cervello" e ritrovare ciò che hai già annotato. Le conversazioni vengono salvate per cartella e puoi tornarci in seguito (vedi sotto); la funzionalità può essere disattivata in Impostazioni → Generale → Funzionalità.

La scheda e la finestra. La chat si apre accanto a ciò che stai leggendo, in una scheda nel riquadro di destra: una per finestra, e ogni finestra ha la sua conversazione. Nella scheda, le note sono quelle della cartella della finestra, e il contesto Editor corrente segue la scheda attiva (vedi sotto). I selettori stanno in alto: l'IA, il contesto e la Modalità (cosa può fare l'IA), con i pulsanti per allegare un file e per avviare una nuova conversazione; in una scheda stretta occupano due righe. Prima della prima domanda lo schermo dice su cosa risponderà la chat e offre scorciatoie con un clic, come Riassumi questa cartella. Nel campo della domanda, Invio invia e Shift+Invio va a capo; mentre la risposta arriva, il pulsante di invio diventa Ferma. Chiudere la scheda conserva la conversazione nell'elenco, come Nuova conversazione.

Spostare, sganciare e riagganciare. La scheda si trascina come qualsiasi altra — nel riquadro principale, in quello in basso o di nuovo a destra — e, riaprendo la cartella, torna nel riquadro in cui l’hai lasciata. Sgancia in una finestra, in Azioni della conversazione o dal pulsante nell'angolo, porta la stessa conversazione — con la sua cartella, gli allegati, la sezione della Guida e ciò che vi hai permesso — in una finestra separata, e la scheda si chiude. Nella finestra separata, Riaggancia alla finestra la riporta nella scheda della finestra da cui è uscita (o di un'altra con la stessa cartella). Una conversazione è aperta in un solo posto, e non cambia posto mentre l'IA risponde. L'icona nell'area di notifica (IA → Chat IA…) apre la finestra separata, che ha il selettore Note da: per scegliere la cartella.

Chi ha risposto e confrontare le risposte. Sotto ogni risposta compaiono, discreti, l'assistente e il modello che l'hanno scritta — utile quando la conversazione ha cambiato assistente o quando il primo modello dell'elenco non è riuscito. La chat ricorda l'ultimo assistente scelto per finestra e cartella. Per inviare la stessa domanda a più di uno, usa Confronta risposte… nel menu della chat o scrivi /compare prima della domanda: vedi Confrontare le risposte.

Strumenti e permessi

La Modalità: cosa può fare l'IA. Il selettore Modalità, nella barra in alto, ha tre valori. Solo note risponde con gli estratti recuperati dalla ricerca per termini, e non viene eseguito nulla. Leggere lascia che il modello cerchi da solo — leggere un file, cercare nelle note, elencare le attività, consultare questa Guida — prima di rispondere, senza modificare nulla. Modificare con approvazione aggiunge la creazione di note e attività, la modifica delle proprietà e le annotazioni nella nota del giorno, sempre con la tua conferma. Se non hai mai scelto, si parte da Leggere, perché leggere è sicuro. Alla fine della risposta compare l'elenco degli strumenti usati, così puoi giudicare la risposta invece di fidarti.

Il test del modello. Leggere e Modificare con approvazione richiedono un provider via API (una CLI locale non può ricevere strumenti). Quando li scegli, LightNote verifica subito se il modello sa chiamare gli strumenti: molti provider accettano la richiesta e semplicemente li ignorano, il che senza questa verifica diventerebbe una risposta inventata che sembra documentata. L'esito viene ricordato per sette giorni per ogni coppia provider+modello. Se fallisce, resta disponibile solo Solo note, e il pulsante Verifica di nuovo, accanto al messaggio, ripete il test ignorando quanto memorizzato: il provider poteva essere solo irraggiungibile in quel momento.

Ogni modifica chiede la tua conferma. La modifica compare nella conversazione in parole chiare ("creare l'attività Comprare il pane") con tre risposte: Consenti, solo questa volta; Consenti in questa conversazione, che lascia passare lo stesso strumento senza chiedere fino alla fine della conversazione (la conversazione lo segnala ogni volta: Consentito dalla conversazione); e Rifiuta, che non chiude la conversazione: il modello viene avvisato e prosegue spiegando o proponendo altro. Eliminare non riceve mai quel permesso: ogni eliminazione chiede. Azzera i permessi di questa conversazione, in Azioni della conversazione, fa chiedere di nuovo tutto, come una nuova conversazione o un'altra cartella. Sovrascrivere file qualsiasi e accedere alla rete restano volutamente esclusi. Quando la modifica va nella nota del giorno, la richiesta dice in quale cartella finirà.

Quando l'IA chiede o si ferma. Se manca un dato da cui dipende la risposta — quale bacheca, quale di due note —, l'IA può chiederlo a te: la domanda compare nella conversazione con un'opzione per link e, quando serve, il campo Altra risposta…; Non rispondere lascia proseguire il modello senza quel dato. Una volta risposta, la domanda diventa testo, e le opzioni di una domanda vecchia non fanno nulla. Dopo molti passi senza finire, la conversazione si ferma e mostra Continua, che dà altri passi allo stesso lavoro; se il modello ripete la stessa ricerca tre volte senza progressi, si ferma e dice quale. Il testo di ogni passo compare man mano che il modello scrive.

Su cosa risponde

Le note o il file aperto. Il menu Contesto: in alto nella chat sceglie di cosa parla la conversazione: Note del vault (predefinito, descritto sotto) o Editor corrente — che risponde sul file aperto nell’editor anziché sul vault, usando la selezione e le righe circostanti (o l’intero file, con la casella Intero file). Nella scheda, Editor corrente segue la scheda attiva della finestra: cambiare scheda cambia il file, la scheda della chat stessa non conta, e quando la scheda attiva non è un editor di testo la voce diventa non disponibile senza cambiare la tua scelta. Nella finestra separata è l’editor da cui hai aperto la chat. E nell’assistente rapido (Ctrl+K), il risultato ha un pulsante Continua nella chat → che apre la chat già nell’ambito Editor corrente, con la domanda e la risposta di quel turno — per approfondire senza ricominciare.

Quali note? Nella scheda, quelle della cartella della finestra: cambiare la cartella della finestra cambia quella della chat, e la conversazione in corso passa nell'elenco. La finestra separata risponde su una cartella per volta, scelta nel menu Note da:, che elenca le cartelle aperte ora, seguite dalle recenti; Scegli cartella… punta a qualsiasi altra — così interroghi le note di un progetto mentre lavori in un altro. Scelta a mano, la cartella resta finché non la cambi di nuovo. Mentre una domanda è in corso — anche se ferma in attesa della tua conferma —, i selettori di IA, contesto e cartella restano bloccati: la risposta in arrivo appartiene al modello e alla cartella di quando hai chiesto.

Come chiedere. Il recupero è per argomento, non per istruzione: LightNote prende le parole della tua domanda e cerca le note che le contengono. Cita un tema che compaia nelle note ("cosa ho annotato su Postgres?") anziché una richiesta generica ("fai un riassunto") — quest'ultima non ha alcuna parola di contenuto da cercare, quindi non viene recuperato nulla e la chat avvisa che la risposta non ha usato le tue note. Vengono lette solo note .md/.markdown; in una cartella che non ne ha, la chat lo segnala e non consuma una chiamata all'IA.

Ricerca, riassunto e riscrittura migliori. Il recupero usa un indice locale con ranking BM25 che ignora gli accenti ("configuração" trova "configuracao") e funziona anche nelle lingue senza spazi tra le parole (giapponese, cinese, coreano) — ripgrep è il ripiego mentre l’indice viene costruito. Il pulsante Riassumi questa cartella — e la voce Riassumi con l'IA… nel menu contestuale di qualsiasi cartella dell'esploratore — legge le note a lotti e restituisce un documento. E in Impostazioni → Generale → Funzionalità, l’opzione Riscrivere la domanda con l’IA espande la domanda in parole chiave prima di cercare (costa una chiamata API per domanda).

Chiave e conversazioni

Basta una chiave. Al primo avvio, LightNote registra già OpenAI, Google Gemini e Anthropic (Claude) in Impostazioni → Assistenti IA: basta incollare la tua chiave API nel provider che usi. Se nessun provider ha una chiave, la finestra mostra un pulsante Configura ora che apre direttamente quella schermata.

Le conversazioni vengono conservate. Il pulsante con l'orologio in alto apre l'elenco delle conversazioni precedenti di quella cartella: fai clic su una per tornarci. Nuova conversazione archivia quella corrente invece di cancellarla, e il tasto destro nell'elenco ne elimina una definitivamente (con conferma). Le conversazioni sono conservate per cartella: cambiare la cartella delle note cambia l'elenco. Riaprendo la cartella, la scheda della chat torna con la conversazione che era aperta.

Cosa fare con la risposta

Cosa fare con una risposta. Sotto ogni risposta ci sono Copia (mette il testo in Markdown negli appunti, con la formattazione intatta) e Cattura nella nota (invia la risposta alla nota del giorno, insieme ai collegamenti alle note citate). Nel menu Azioni della conversazione trovi Copia conversazione, Salva conversazione come nota… (scrive un .md nella cartella consultata), Rigenera l'ultima risposta e Modifica l'ultima domanda.

Allegare un file. Quando la ricerca non trova quello che avevi in mente, usa il pulsante + per allegare un file: entra sempre nella domanda, fuori dalla classifica della ricerca. Vanno bene nota, codice, testo e PDF (il testo del PDF viene estratto); un binario viene rifiutato subito invece di diventare rumore nel contesto. L'allegato compare come una pillola (fai clic per staccarlo) e sparisce quando inizi una nuova conversazione. Con i provider che lo supportano, la risposta compare anche gradualmente, mentre il modello scrive.

Memoria dell'assistente. Nel menu Azioni della conversazione (il pulsante ☰ in alto), Memoria dell'assistente… apre — creandola la prima volta — la nota Memoria.md nella radice della cartella selezionata. Tutto ciò che contiene entra in ogni domanda posta su quella cartella, prima dei frammenti trovati: le tue preferenze, le decisioni che hai già preso, ciò che hai scartato e perché. È un .md qualsiasi: modificalo quando vuoi, versionalo con Git, eliminalo per spegnere la memoria. Con gli strumenti di scrittura attivi, l'assistente può anche proporre di salvare un fatto lì, e come ogni scrittura attende la tua autorizzazione.

Riassumere una cartella. Vale per l'intero spazio di lavoro o per qualsiasi sottocartella: clic destro su di essa nell'esploratore e scegli Riassumi con l'IA…. Prima di spendere, LightNote dice quante note verranno lette e quante chiamate di IA comporterà — ognuna addebitata dal tuo provider — e ti lascia scegliere la forma: Panoramica, un testo continuo, oppure Consolidare la conoscenza, con sezioni fisse (decisioni, cose in sospeso, idee, contraddizioni e domande aperte; la sezione senza contenuto viene omessa invece di essere riempita con invenzioni). Se la cartella ha più note di quante ne consenta il tetto di costo, la risposta dice quante sono rimaste fuori. Alla fine, Salva come nota scrive il riassunto dentro la cartella riassunta, con la data e il numero di note nell'intestazione, e non ne sovrascrive mai uno precedente.

Comandi, Guida e link

L'assistente conosce LightNote. Oltre alle tue note, sa di trovarsi dentro LightNote: riceve l'indice di questa Guida, un riassunto del Markdown dell'app (wikilink, callout, diagrammi, formule, calendari) e, a ogni domanda, la cartella consultata, la scheda attiva e la data. Chiedi "come creo una bacheca di attività?" come chiederesti di una nota.

Comandi con /. Digitare / all'inizio del campo vuoto apre l'elenco dei comandi, che si filtra mentre scrivi; Invio sceglie e Esc chiude. /help seguito da un argomento (/help tabelle) allega alla conversazione la sezione di questa Guida il cui titolo corrisponde all'argomento, con o senza accenti; senza argomento entra la sezione della schermata da cui hai aperto la chat. Con una domanda al posto dell'argomento (/help come creo una tabella), l'elenco mostra le sezioni che possono rispondere: quella che scegli viene allegata e la domanda parte insieme.

La sezione allegata. Compare come una pillola Guida: … accanto agli allegati, va in ogni domanda prima degli estratti delle note e si toglie con un clic su di essa o con una nuova conversazione. Nella schermata vuota, Come funziona la chat? lo fa con questa sezione e chiede subito.

Gli altri comandi. /summarize riassume la cartella e /new avvia una nuova conversazione. I prompt della cartella Prompts compaiono nello stesso elenco: sceglierne uno mette il testo nel campo, così lo rivedi prima di inviarlo.

Note con [[ o @. Digitare [[ o @ nel campo apre l'elenco delle note della cartella, che si filtra mentre scrivi, con o senza accenti. Invio sceglie, e la nota entra come allegato — la stessa pillola del pulsante +, riletta a ogni domanda e fuori dalla classifica della ricerca —; ciò che hai digitato per trovarla esce dal campo. Esc, Spazio o un clic altrove chiudono l'elenco senza allegare nulla.

Guida e Markdown come strumenti. Nelle modalità Leggere e Modificare con approvazione, il modello consulta da solo questa Guida (help_lookup) e il riferimento della sintassi che LightNote disegna (markdown_reference) — è così che azzecca il percorso del menu e la recinzione di un diagramma — e, quando manca un dato, te lo chiede (ask_user). I primi due sono anche nel server MCP, per le CLI di IA; la domanda è solo della chat, perché richiede qualcuno davanti allo schermo.

Link alle schermate. Quando la risposta ha bisogno di una schermata dell'app, porta un link invece di descrivere il menu: lightnote://settings/ai apre le Impostazioni sulla sezione degli assistenti IA, lightnote://help/… una sezione di questa Guida, lightnote://wizard/clone la procedura di clonazione, lightnote://open?file=… un file della cartella e lightnote://new?type=lnt crea un nuovo file. Lo stesso link funziona anche dentro una nota.

Niente si apre da solo. Il clic è il tuo consenso. Un link fuori dalla cartella, verso una funzionalità disattivata o verso una destinazione che non esiste non apre niente, e la riga di stato dice perché.

Configurare l'app e creare connessioni

Cambiare un'impostazione. Nella Modalità Modificare con approvazione, chiedi come chiederesti a una persona: "passa al tema scuro", "porta il carattere dell'editor a 14", "disattiva la minimappa". La richiesta compare come prima → dopo ("Tema: Chiaro → Scuro"), con un link alla sezione delle Impostazioni dove si trova la stessa opzione, e vale solo dopo Consenti; poi la conversazione dice Applicato con il nuovo valore.

Ogni modifica chiede di nuovo. Consenti in questa conversazione non vale per le impostazioni. Interpreti e CLI di IA si aggiungono, modificano o rimuovono allo stesso modo, sempre indicando il programma per nome, mai con una cartella. Una shell (pwsh, bash) è accettata solo come interprete che apre il file, come in pwsh -File {file}, mai con un comando scritto nella riga stessa.

Cosa resta fuori. È raggiungibile solo un elenco chiuso di opzioni: tema, lingua, carattere dell'editor, apertura del Markdown, funzionalità, note giornaliere e opzioni di IA, tra le altre. Chiave API, indirizzo del provider, percorsi dei programmi e terminali non cambiano mai dalla chat: l'assistente risponde con il link alla sezione giusta. È voluto: il testo delle note entra nella conversazione, e una nota arrivata da fuori non deve poter dirottare la tua IA verso un altro indirizzo.

Creare un test HTTP o una connessione. Chiedi "crea un test per GET https://…", "salva la connessione SSH a deploy@server" o "collegati al database delle vendite": dopo Consenti, l'assistente crea il .lnh, il .lns o il .lnc nello stesso formato che scrive l'app, e la conversazione mostra Creato con il link che apre il file. Non sovrascrive mai un file, crea solo dentro la cartella e non crea il tipo di una funzionalità disattivata nella sezione Funzionalità delle Impostazioni.

Manca un dato? Chiede. Quando manca un dato che cambia il risultato — il database, il server, il tipo di autenticazione —, chiede con le opzioni prima di creare.

Nessuna password passa dalla chat. Le connessioni al database e SSH nascono senza password: viene chiesta quando ti colleghi, e l'accesso dell'IA alla connessione al database resta spento finché non lo consenti. In un test HTTP, il token o la password diventa una variabile vuota ({token}) da compilare nel test o in http-client.private.env.json; un segreto scritto per esteso viene rifiutato. I tre creatori sono anche nel server MCP, per le CLI di IA; cambiare le impostazioni è solo della chat.