# Manuale Utente: TextWiller ⚡ **TextWiller** è un editor di testo intelligente progettato per aiutarti a scrivere in modo chiaro, semplice ed efficace. Integra i principi del *Plain Language* con la potenza dell'Intelligenza Artificiale locale per offrirti correzioni, suggerimenti e analisi strutturali in tempo reale. --- ## 1. Prerequisiti Prima di iniziare, assicurati di avere quanto segue: ### A. Browser Web Moderno L'applicazione funziona su qualsiasi browser moderno. Si consigliano: - **Google Chrome** - **Microsoft Edge** - **Mozilla Firefox** ### B. Ollama (Per le funzioni AI) TextWiller utilizza **Ollama** per far girare l'intelligenza artificiale direttamente sul tuo computer (senza inviare dati su internet). 1. **Scarica e Installa Note**: Vai su [ollama.com](https://ollama.com/) e installa la versione per Windows. 2. **Scarica un Modello**: Apri il terminale (Prompt dei Comandi o PowerShell) e digita: ```powershell ollama pull mistral ``` (Puoi usare anche altri modelli come `llama3`, `gemma`, ecc.) ### C. Configurazione Fondamentale (CORS) Affinché il browser possa "parlare" con Ollama sul tuo PC, devi abilitare le connessioni esterne (CORS). 1. Chiudi Ollama se è già aperto (dalla barra delle applicazioni in basso a destra, tasto destro -> Quit). 2. Apri un **Terminale** (PowerShell o CMD). 3. Incolla ed esegui questo comando per avviare Ollama correttamente: ```powershell set OLLAMA_ORIGINS=* && ollama serve ``` *Nota: Se vuoi rendere questa modifica permanente, dovrai aggiungerla alle Variabili d'Ambiente di Windows.* --- ## 2. Avvio dell'Applicazione TextWiller è una "Universal App": è interamente contenuta in un singolo file HTML. 1. Fai doppio click sul file `TextWiller.html`. 2. L'applicazione si aprirà nel tuo browser predefinito. 3. Controlla la barra laterale sinistra: - Se vedi un **pallino verde** sotto "Stato Ollama", sei pronto! - Se è **rosso**, controlla di aver avviato Ollama come descritto nel punto 1.C. --- ## 3. Guida alle Funzionalità ### Scrittura e Analisi in Tempo Reale Inizia a scrivere nell'area centrale o incolla il tuo testo (il sistema pulirà automaticamente la formattazione). - **Leggibilità (Gulpease)**: Sulla sinistra vedrai un punteggio che cambia in tempo reale. Cerca di mantenerlo sopra **60** (Verde) per una buona leggibilità. - **Statistiche**: Conteggio parole e frasi sempre visibile. ### 👁️ Mostra Problemi Clicca questo pulsante nella barra in alto per avviare l'analisi linguistica. TextWiller evidenzierà i punti critici: - **Viola** (Parole Complesse): Termini burocratici o difficili. Cliccaci sopra per vedere l'alternativa semplice (es. "tempistica" -> "tempo"). - **Rosso** (Voce Passiva): Frasi che rallentano la lettura. - **Giallo** (Avverbi): Spesso inutili. - **Lilla** (Riempitivi): Parole vuote come "praticamente", "cioè". **Interazione**: Clicca su qualsiasi parola evidenziata per aprire un menu con: - Motivo della segnalazione. - Tasto **Sostituisci**: Applica subito il suggerimento. - Tasto **🤖 Chiedi all'AI**: Chiede all'intelligenza artificiale una riscrittura specifica per quel contesto. ### 🔍 Analisi Critica AI Clicca questo pulsante per chiedere all'AI di leggere tutto il testo e fare da "Editor Cattivo". Ti fornirà una lista di: - Informazioni mancanti. - Salti logici. - Dubbi che un lettore potrebbe avere. *Il risultato apparirà in una finestra di avviso.* ### Assistente di Scrittura AI Seleziona una qualsiasi parte di testo col mouse. Apparirà un menu mobile con opzioni rapide: - **✨ Semplifica**: Riscrive per rendere il testo comprensibile a tutti. - **🔨 Correggi**: Sistema grammatica e refusi. - **✂️ Accorcia**: Sintetizza il concetto. - **👔 Rendi Professionale**: Alza il tono (formale). ### Esportazione - **Copia Testo**: Copia tutto negli appunti. - **Esporta**: Scarica il file in formato Markdown (.md), ideale per essere usato altrove. --- ## 4. Impostazioni Clicca su **⚙️ Impostazioni** in basso a sinistra per: - Cambiare l'indirizzo di Ollama (default: `http://localhost:11434`). - Scegliere quale Modello AI usare (es. passare da `mistral` a `llama3` se lo hai installato). --- ## Risoluzione Problemi Comuni - **"Stato Ollama: Disconnesso"**: - Assicurati che il terminale con `ollama serve` sia aperto. - Assicurati di aver impostato `OLLAMA_ORIGINS=*`. - Prova a ricaricare la pagina. - **"Errore AI" quando chiedo suggerimenti**: - Il modello potrebbe essere "scaricato" dalla memoria se non usato da molto. Riprova una seconda volta, di solito funziona. - Controlla che il modello scelto nelle impostazioni esista davvero nel tuo Ollama.