# foxAI - guida rapida

foxAI è una volpe che vive sul desktop e ti aiuta con i documenti. Tutto quello che legge resta sul tuo computer: il "cervello" (un modello di intelligenza artificiale) gira lì, senza internet. Serve internet solo la prima volta, per scaricarlo (circa 2 GB).

Al primo avvio un benvenuto in tre passi spiega cosa fa la volpe, come tratta i tuoi dati e che stai usando un'intelligenza artificiale, poi ti fa scegliere il modello prima di scaricarlo (dimensione, spazio libero, tempo stimato). Il download riprende da dove si era fermato se la connessione cade. Il benvenuto si rivede da Impostazioni → Informazioni.

L'icona di foxAI (una testa di volpe di profilo disegnata con una sola linea arancione; sul Mac è nera o bianca come le altre icone della barra) sta nella barra dei menu in alto (Mac) o vicino all'orologio (Windows). Da lì trovi Chatta, Annulla, Scadenze, Note, Strumenti PDF, Impostazioni ed Esci.


## Cosa fa la volpe da sola

- Cammina e trotta verso mete sempre diverse, si ferma ad annusare o a scavare e riparte, si siede, si sdraia, si stiracchia, sbadiglia, si gratta, si lecca la zampa, si scrolla. Quando è di buon umore fa l'inchino del gioco, si rincorre la coda, salta, fa una capriola.
- Se tieni il puntatore vicino a lei mentre è ferma, gira la testa a guardarlo; se il puntatore resta fermo vicino al pavimento, a volte ci fa sopra il balzo del topo.
- In Impostazioni → Volpe scegli quanto è grande (piccola, normale, grande) e il ritmo: calma, normale o vivace.
- Ogni tanto sale sulla finestra che stai usando e ci passeggia sopra. Se sposti o chiudi la finestra, cade e atterra sulle zampe.
- Si nasconde al bordo dello schermo o dietro una finestra, lasciando fuori la coda, e ogni tanto sbircia. Un clic la fa uscire.
- Con più monitor a volte passa dall'uno all'altro.
- Di notte, o quando non usi il computer, dorme.
- A Natale e d'estate porta un cappello. Dopo un riordino si veste secondo il lavoro: per esempio visiera e calcolatrice per le fatture.
- Quando guardi un film o giochi a schermo intero, sparisce e poi torna. Una finestra semplicemente ingrandita non la fa sparire.
- Se cambi desktop (su Windows i desktop virtuali, su Mac gli Spaces) la volpe viene con te, con il fumetto e la chat.

Ognuna di queste cose si spegne in Impostazioni → Volpe. "Non disturbare" (dal menu) la manda nell'angolo in basso a destra: resta seduta e tace, tranne che per gli errori.


## Come interagire

- **Carezza**: passa il mouse avanti e indietro sopra di lei, senza premere. Socchiude gli occhi e poi si siede contenta.
- **Un clic**: si guarda intorno. Se dorme, si sveglia.
- **Prenderla e lanciarla**: trascinala e lasciala andare. Cade, rimbalza sui bordi e atterra.
- **Dispetto**: se la lanci forte o fai 4 clic di fila, si offende, si gira di spalle e borbotta per un po'. Le passa da sola.
- **Doppio clic**: apre la barra della chat sopra di lei. Invio manda la domanda, Esc la chiude.
- **Tasto destro**: apre il menu con Chatta, Annulla ultimo riordino, Scadenze, Note, Strumenti PDF, Impostazioni, Concentrazione 25 min, Non disturbare e Nascondi. Mentre legge dei documenti c'è anche "Interrompi la lettura".
- **Trascinare dei file sulla volpe**: li riordina (vedi sotto). Se le dai solo foto, ti chiede se farne un PDF; per unire più PDF usa «Strumenti PDF…» dal menu.
- **Ctrl+Alt+F** (sul Mac Ctrl+Option+F): apre la chat da qualunque programma; la stessa combinazione la richiude. Si cambia in Impostazioni → Pausa e scorciatoia.


## Cosa chiedere in chat

Scrivi come parleresti. Qualche esempio:

- **Ritrovare un documento già riordinato**: "dove ho messo la fattura di gennaio?", "trova il verbale Rinaldi nell'archivio". Sotto la barra compaiono delle schede: un clic apre il file o la cartella.
- **Cercare un file nel computer**: "trova il contratto Rossi nel computer", "cerca il pdf della bolletta nei documenti". Guarda in Scrivania (Desktop su Windows), Documenti e Download, e nelle cartelle che aggiungi nelle Impostazioni. Non salva niente di quello che vede.
- **Promemoria**: "ricordami domani alle 9 di chiamare Marco", "ricordami lunedì di pagare la TARI", "ricordami tra 2 ore di uscire". La volpe ripete la data per esteso: controllala. "Annulla" lo toglie subito.
- **Note**: "nota: codice cancello 4521", "segnati la taglia 42". Le ritrovi con "cerca cancello" o nella finestra Scadenze → Note.
- **Spese**: "quanto ho speso di luce nel 2026?", "totale delle bollette". Il conto si basa sui documenti che hai riordinato. Gli importi li ha letti la volpe: controllali sul documento (si correggono nell'anteprima, vedi sotto). Se nel frattempo hai cancellato o spostato qualcuno di quei documenti, la volpe te lo dice ("2 documenti non più trovati al loro posto").
- **Un documento da leggere al volo**: trascinalo sulla **barra della chat**, non sulla volpe. Poi chiedi "riassumi il documento", "traducilo in inglese", "che scadenze ci sono?", "chi firma il contratto?". Il documento non viene archiviato né spostato.
- **Timer di concentrazione**: "concentrazione", "concentrazione 40 minuti", "pomodoro", "ferma il timer". La volpe legge accanto a te e alla fine propone una pausa.
- **Conti al volo** (risposta immediata, senza "cervello"): "quanto fa 12*3+4", "il 15% di 240", "240 + 15%", "da 80 a 100 che percentuale". I numeri si scrivono all'italiana: 1.234,56.
- **IVA**: "iva 22% su 1000" (imponibile, IVA e totale), "1000 + iva", "scorpora l'iva da 1220". Aliquote 4, 5, 10 e 22%; se non la dici vale il 22%.
- **Date**: "quanti giorni mancano al 15 novembre?", "quanto manca a Natale?", "che giorno sarà tra 45 giorni?", "che giorno cade il 25 aprile?", "30 giorni lavorativi da oggi", "quanti giorni lavorativi mancano al 30 ottobre?". I giorni lavorativi saltano sabati, domeniche e festività nazionali (Pasqua e Pasquetta comprese), non le feste del patrono.
- **Scrivere un testo**: "scrivi una mail a Rossi per spostare la riunione a lunedì", "scrivi un messaggio a Giulia per dirle che arrivo tardi". Per un testo tuo incollalo dopo i due punti: "correggi: …", "riformula in tono più formale: …", "riassumi: …", "traduci in inglese: …". Subito dopo puoi chiedere "rendilo più breve" o "traducilo in francese" senza incollarlo di nuovo. Il testo compare anche sopra la barra con il pulsante **Copia**. Le parti che la volpe non sa (date, nomi) restano tra parentesi quadre, per esempio [data]: completale prima di inviare.
- **Testo da un'immagine**: trascina sulla barra della chat una foto o una schermata (PNG, JPG, BMP, TIFF; sul Mac anche le foto HEIC dell'iPhone). La volpe legge il testo, lo mostra con **Copia** e poi puoi chiedere "riassumi", "traducilo in inglese", "che scadenze ci sono?": il riassunto o la traduzione compaiono in un secondo riquadro, e il testo letto resta copiabile. L'immagine non viene salvata né spostata.
- **Aiuto**: scrivi "aiuto" o "cosa sai fare?" per un elenco di esempi.
- **Due chiacchiere**: "come stai?", "raccontami qualcosa".


## Riordinare i documenti

1. Trascina sulla volpe uno o più file PDF (anche scansionati), Word, TXT o MD.
2. La volpe li legge e apre un'**anteprima**: per ogni file vedi il nome nuovo, la cartella e le scadenze trovate. Puoi cambiare tutto prima di confermare. In "Dettagli" c'è anche l'**importo** letto dalla volpe: se è sbagliato correggilo, con la virgola per i centesimi (94,60 oppure 1.234,50); lascialo vuoto se il documento non ha un importo. Nelle spese conta quello che lasci lì.
3. Conferma: i file vengono **copiati**. Gli originali restano dove sono, a meno che nelle Impostazioni tu abbia scelto "Sposta". Di solito la cartella è sul Desktop, oppure quella che hai scelto per la categoria.

- **Fermarla a metà**: se ti accorgi di averle dato i file sbagliati, o sono tanti e ci mette troppo, scegli "Interrompi la lettura" dal menu della volpe o dall'icona (c'è solo mentre legge), oppure scrivile in chat "basta" o "ferma". Smette subito e ti mostra nell'anteprima i file che aveva già letto; gli altri restano dove sono, non li tocca. Se non ne aveva ancora letto nessuno, dice "Ho smesso di leggere."
- **Annulla**: dal menu della volpe o dall'icona, "Annulla ultimo riordino". Toglie solo le copie ancora identiche: se nel frattempo hai modificato un file, la volpe lo lascia dov'è e ti dice perché. Tutti i riordini sono anche in Impostazioni → Storico.
- **Duplicati**: un file già riordinato (anche con un altro nome) compare escluso nell'anteprima, con la data e il posto in cui l'hai messo. Per rifarlo lo stesso usa "Riordina comunque".
- **Destinazioni**: in Impostazioni → Riordino e destinazioni puoi scegliere una cartella per ogni categoria, per esempio `Fatture/{anno}`, così le fatture del 2026 finiscono in Fatture/2026.
- **Scadenze**: quelle che lasci spuntate nell'anteprima diventano promemoria. La volpe te le ricorda il giorno prima e il giorno stesso, solo quando sei al computer e con foxAI aperta.


## Strumenti PDF

Dal menu della volpe, "Strumenti PDF":

- **Unisci**: più PDF (e anche foto) in un PDF solo. L'ordine è quello dell'elenco: lo cambi con le frecce.
- **Da immagini**: ogni foto diventa una pagina A4, dritta e centrata. Comodo per scontrini e documenti fotografati col telefono.
- **Estrai pagine**: scegli un PDF e scrivi le pagine da tenere, per esempio 2-5 oppure 1,3,6.

Trascina i file nella finestra (o usa "Scegli file…" nella versione installata). Il PDF nuovo compare accanto agli originali, che restano come sono. I PDF con password o rovinati vengono saltati, e la volpe ti dice quali. Per un'unione molto pesante (oltre 1 GB di file, o foto PNG enormi) ti chiede di dividerla in più parti. "Annulla" lo toglie subito, se non l'hai modificato.


## Impostazioni utili

- **Cartella sorvegliata**: la volpe controlla per esempio i Download e, quando arriva un file nuovo, chiede se riordinarlo. Non fa mai niente senza chiedere.
- **Briefing del mattino**: alla prima attività del giorno ti dice le scadenze di oggi e di domani. Non prima delle 7, e non prima dell'ora scelta in "Avvisi dalle" (all'inizio le 8:30).
- **Suoni**: spenti all'inizio. Puoi accenderli e scegliere il volume.
- **Pausa attiva**: spenta all'inizio. Se la accendi, dopo 50 minuti (o quanti ne scegli) di computer la volpe si stiracchia e ti propone due minuti di pausa. "Più tardi" la rimanda di un quarto d'ora; se ti alzi davvero per qualche minuto il conto riparte da zero.
- **Scorciatoia**: la combinazione per aprire la chat. Clicca nel campo e premi i tasti; se un altro programma la usa già, la pagina te lo dice (e la volpe lo dice una volta all'avvio).
- **Modello**: mostra quale cervello usa la volpe e quale consiglia per il tuo computer.
- **Sistema**: avvio insieme al computer (solo nella versione installata) e lettura dei PDF scansionati.
- **Cancella storico e indice**: cancella i dati salvati sui documenti. I file riordinati restano dove sono.


## Versione portatile (chiavetta)

- **Preparala a casa**: copia tutta la cartella foxAI sulla chiavetta (servono almeno 3 GB liberi), avviala una volta su un computer con internet, aspetta che finisca di scaricare il modello e chiudi con Esci. Da lì funziona anche senza internet.
- Avvia `foxai.exe` (Windows) o `foxAI.app` (Mac) dalla chiavetta. Non serve installare niente né essere amministratore.
- I documenti riordinati vengono copiati nella cartella `Riordinati` sulla chiavetta. Impostazioni, archivio e note restano nella cartella `data`.
- **Cosa resta sul PC**: alla chiusura foxAI cancella da sola le tracce che crea (chiavi del registro di WebView2 su Windows, cache su Mac). Restano solo le tracce che Windows tiene per qualunque programma avviato (elenco dei programmi eseguiti, Prefetch) e, se apri un documento, i "file recenti" dell'app che lo apre.
- Per chiudere usa l'icona → Esci, poi aspetta una decina di secondi prima di togliere la chiavetta.
- Il Cestino del PC non si usa: annullando un riordino, le copie vengono eliminate.


## Limiti da conoscere

- La volpe può sbagliare: a volte legge male un importo o una data detta in modo insolito. Per questo ripete sempre la data, e nell'anteprima l'importo letto si può correggere.
- I promemoria suonano solo con foxAI aperta: niente notifiche di sistema. Valgono per un giorno solo: quelli che si ripetono («ogni lunedì», «tutti i giorni») non ci sono ancora e la volpe lo dice.
- La prima risposta dopo una pausa può richiedere qualche secondo, perché la volpe "riaccende" il cervello.
- Sui computer con meno di 6 GB di memoria la volpe non riordina e non chiacchiera col modello. Note, timer e ricerca per nome funzionano lo stesso.
- I file che stanno solo nel cloud (OneDrive, iCloud) si trovano per nome, ma la volpe non li legge.
- I PDF scansionati si leggono nel riordino, non nella chat (in chat si leggono le immagini). Sulla versione portatile per Mac il primo scansionato di ogni sessione richiede circa 25 secondi in più.
- Il testo letto da un'immagine può avere qualche errore, soprattutto con foto storte o scritte a mano: controllalo prima di usarlo. Su Windows serve che l'OCR di sistema abbia l'italiano o l'inglese (si aggiunge da Impostazioni → Ora e lingua → Lingua); le foto HEIC si leggono solo sul Mac.
- I testi scritti dalla volpe (mail, traduzioni) vanno sempre riletti: è un aiuto per la bozza, non un testo da mandare a occhi chiusi. Nel riquadro «Testo pronto» lo ricorda l'etichetta «Testo generato con IA».
- Gli aggiornamenti non sono automatici: le nuove versioni si scaricano a mano.
