# 📘 Manuale Utente - MappaSaggio 2.0 **MappaSaggio** è un'applicazione avanzata che trasforma mappe concettuali in saggi accademici. Questa versione utilizza una **doppia architettura**: 1. **Occhi (Visione)**: Un modello legge la mappa ed estrae i dati grezzi. 2. **Cervello (Scrittura)**: Un secondo modello elabora i dati e scrive il saggio. --- ## 🚀 1. Installazione e Requisiti ### Passo A: Installare Ollama Scarica e installa Ollama da [ollama.com](https://ollama.com). ### Passo B: Scaricare i DUE Modelli Hai bisogno di due modelli distinti per far funzionare l'app al meglio. Apri il terminale e digita: 1. **Modello Visione** (per leggere): ```powershell ollama pull minicpm-v ``` 2. **Modello Scrittore** (per scrivere): ```powershell ollama pull llama3.2 ``` *(Puoi usare anche `mistral`, `gemma2` o `neural-chat` se preferisci)* ### Passo C: Avviare Ollama (CORS) Per permettere l'uso via browser, avvia Ollama con questo comando (tieni la finestra aperta): ```powershell $env:OLLAMA_ORIGINS="*"; ollama serve ``` --- ## 🖥️ 2. Guida all'Uso Passo-Passo ### 1. Caricamento * Trascina la tua mappa (PDF o Immagine PNG/JPG) nell'area tratteggiata al centro. * L'anteprima apparirà subito sotto. ### 2. Configurazione Modelli (Pannello Sinistro) * **Modello Visione**: Di default è `minicpm-v`. Non cambiarlo a meno che tu non sappia cosa stai facendo. * **Modello Scrittore**: Di default è `llama3.2`. Se vuoi usare un altro modello (es. `mistral`), scrivilo qui. ### 3. Parametri Saggio (Istruzioni di Regia) Questi campi guidano l'IA nella scrittura: * **Domanda Focale**: (Opzionale ma raccomandato) Scrivi la domanda a cui il saggio deve rispondere. * *Esempio: "Qual è la relazione tra motivazione e apprendimento?"* * **Concetto di Partenza**: (Opzionale) Indica da quale "bolla" della mappa iniziare il discorso. * *Esempio: "Il concetto di 'Bisogni Primari'"* ### 4. Generazione (Due Fasi automatiche) Nel pannello destro ("3. Risultato"), clicca su **Genera Saggio Accademico**. L'app eseguirà due passaggi: 1. **Fase 1 (Lettura)**: Vedrai apparire un box con la lista dei concetti che l'IA ha "visto". 2. **Fase 2 (Scrittura)**: Subito dopo, vedrai il saggio comporsi in tempo reale. ### 5. Esportazione * Usa i pulsanti in alto a destra nel pannello Risultato per **Copiare** il testo o **Salvarlo come MD** (Markdown). --- ## 💡 Consigli per Risultati Migliori * **Mappe Leggibili**: Se il testo nella mappa è minuscolo o sfocato, l'IA potrebbe non leggerlo. Prova a ritagliare l'immagine in sezioni più piccole se è molto grande. * **Guida l'IA**: Usare la "Domanda Focale" migliora drasticamente la coerenza del testo, perché dà all'IA un obiettivo argomentativo invece di farle fare solo un elenco.