📕 Vademecum MFF

👋 Benvenuto

MFF (MarcoFLY Framework) è uno strumento di controllo epistemico sopra l’AI generativa: rende visibile quanto un modello è sicuro di ciò che dice, affermazione per affermazione, e ti aiuta a verificarlo. Questa app applica il framework automaticamente a ogni messaggio, su decine di modelli di provider diversi, con le TUE chiavi API (BYOK).

Le due modalità: «MFF Framework» inietta il protocollo epistemico (etichette, scudi, carta dello stato) e consuma crediti MFF solo quando il framework viene applicato davvero. «Chat semplice» (PLAIN) è conversazione libera senza framework e senza crediti — ma con TUTTE le funzioni della piattaforma: allegati, ricerca web, peer review, lettura vocale, export.

Cosa MFF NON è

• Non garantisce verità: le etichette riflettono ciò che il modello dichiara di sapere; la verifica finale resta tua.
• Non sostituisce esperti: per decisioni mediche, legali, fiscali o finanziarie serve un professionista.
• Non azzera le allucinazioni: le riduce e le rende riconoscibili, ma il modello può sbagliare anche con bollino verde.

🚀 Avvio rapido — 3 passi

1. 1Configura una chiave API (o usa i crediti MFF inclusi). Vai in Impostazioni → Chiavi provider AI: incolla una chiave — la via più rapida è «Collega OpenRouter» via OAuth, una chiave sola per centinaia di modelli, gratuiti inclusi.
2. 2Crea una sessione dalla Dashboard: scegli modalità (MFF o PLAIN), dominio, modello — e se vuoi i moduli di difesa. Ogni scelta è spiegata nelle sezioni di questo vademecum.
3. 3Scrivi la domanda: la risposta arriva in streaming, con le etichette. Con 📎 alleghi immagini e documenti, con 🌐 chiedi una ricerca web prima della risposta. Ogni messaggio ha 📋 copia, 🔊 lettura, ⚖ peer review e la rigenerazione.

🔓 Chiavi gratuite, provider per provider

Ogni capitolo qui sotto è linkabile (icona 🔗): dalle Impostazioni della PWA arrivi dritto al provider che stai configurando. La regola di lettura: 🆓 si parte senza carta · 🌱 costo d’ingresso minimo · 💳 serve credito — dichiarato, mai nascosto.

🏷️ Le etichette epistemiche

Ogni affermazione porta il suo livello di impegno dichiarato. Non sono decorazione: sono un contratto — e restano nell’export. La regola aurea: il tag PRECEDE il contenuto, un tag per blocco.

I suffissi: da dove viene e quanto ci crede

Dopo l’etichetta possono comparire suffissi di fonte: [doc] documento ufficiale · [test] testimonianza · [comm] comunicato · [log] registro tecnico · [emp] dato empirico · [lit] letteratura scientifica · [leg] fonte legale · [cert] certificazione verificabile. Poi [mem] = memoria del training non verificata in sessione (sempre da controllare) e [p:75%] = probabilità soggettiva stimata dal modello. Il glossario in fondo li spiega tutti.

🛡️ Gli scudi — moduli di difesa

Nella modalità MFF puoi attivare fino a 9 moduli epistemici che guidano il comportamento del modello. L1 è sempre attivo; il set predefinito L1+L2+L3 è ottimo per la maggior parte dei compiti. Le schede qui sotto sono le STESSE che vedi nel wizard di creazione sessione.

💬 Sessioni: ogni scelta e cosa implica

Una sessione è una conversazione completa con un modello: ha titolo, modello, modalità, dominio, lingua e scudi propri, fissati alla creazione. Ogni scelta del wizard cambia qualcosa di concreto nel motore.

Il dominio fa due cose

Primo: definisce cosa significano 🟢/🔵/🟡 in quel contesto — in dominio scientifico «SICURO» vuol dire risultato replicato e pubblicato; in dominio creativo la soglia è un’altra. Secondo: imposta la temperatura predefinita, da 0.2 (Legale: conservativo e ripetibile) a 1.0 (Creativo: massima variabilità). Nelle impostazioni avanzate puoi forzarla.

La modalità operativa

MFF-E: analisi epistemica rigorosa · MFF-G: riduce rumore e ridondanza · MFF-X: interpreta e spiega senza alterare · MFF-EX: le combina (la modalità centrale) · MFF-EGX: aggiunge la disciplina della sintesi · AUTO: sceglie il protocollo turno per turno. PLAIN: nessun framework, nessun credito.

La lingua della sessione è una scelta, e resta

È separata dalla lingua dell’interfaccia. Cambiare lingua UI NON traduce le risposte già generate: l’etichetta epistemica appartiene al testo che quel modello ha prodotto — tradurlo sotto le etichette le falsificherebbe.

Dentro la conversazione

• Ogni messaggio successivo porta il contesto della sessione: fai follow-up senza ripetere. Per argomenti nuovi apri una sessione nuova (contesto pulito, costi minori).
• Sotto ogni risposta: 📋 copia · 🌐 fonti · 🔊 lettura vocale · ⚖ peer review · 🔄 rigenera. I tuoi messaggi si possono modificare e reinviare.
• «▸ Continua» prosegue una risposta troncata dal budget; nelle sessioni oltre i 100 messaggi «⤒ Carica messaggi precedenti» risale la storia.
• Tutte le sessioni sono nell’Archivio: riapri e continui da dove eri. Da lì si eliminano anche, singolarmente.

🧠 Scegliere il modello

Il selettore mostra sempre il listino completo del provider, marcando quali modelli risultano serviti in questo momento: la verità viene dal catalogo live, non da una lista scritta a mano. Un modello non servito è visibile e marcato, non nascosto.

Anche le capacità vengono dal catalogo: visione → allegati immagine abilitati; reasoning → pensiero esteso con L5; generazione immagini → il modello entra nelle rotte di generazione. Il nome del modello non decide nulla: decide ciò che il provider dichiara.

Gratuiti contro a pagamento

I modelli :free non costano nulla, con tre compromessi: contesto e budget documenti più stretti, niente ricerca web 🌐, e quote giornaliere del provider (un 429 su un :free spesso significa solo «riprova più tardi o cambia :free»). I modelli a pagamento girano sulla TUA chiave: paghi il listino del provider, MFF non aggiunge nulla.

Se il provider fallisce: il failover dichiarato

Su errori recuperabili (rate limit, sovraccarico, modello ritirato) il motore prova le riserve: prima i fallback che indichi tu nelle impostazioni avanzate (fino a 3, in ordine), poi la catena di policy sui tuoi provider con chiave. Tutto è DICHIARATO: risposta, etichette e carta riportano chi ha davvero servito. Il turno riparte da zero sul modello di riserva — quello che leggi è sempre di un solo modello. Errori non recuperabili (chiave non valida, saldo esaurito) non fanno failover: vengono mostrati, e il credito MFF torna indietro.

🔌 Provider e routing

MFF parla con 17 provider, in due famiglie. Il provider della sessione lo scegli TU alla creazione — non c’è un instradamento nascosto: quello che scegli è quello che risponde, e se serve un ripiego viene dichiarato (v. failover).

Aggregatori: una chiave, tanti vendor

• OpenRouter (chiave sk-or-…): centinaia di modelli, inclusi i :free; si collega anche in un click via OAuth. Sui modelli a pagamento usa il suo web_search nativo. Piccolo markup (~5%) rispetto al diretto.
• OrcaRouter (chiave sk-orca-…): aggregatore zero-markup con chiave propria e indipendente — non usa il tuo credito OpenRouter.

Diretti: la strada più corta e le capacità native

OpenAI · Anthropic · Google · Groq · Cerebras · Mistral · DeepSeek · xAI · Perplexity · Z.AI · NVIDIA NIM · SambaNova · Hyperbolic · Cohere · Cloudflare Workers AI. Nessun markup, e le funzioni native del vendor: la ricerca web integrata di Anthropic, le citazioni native di Perplexity (mostrate tra le fonti), i free tier ampi di Groq, Cerebras, NIM e SambaNova.

La generazione di immagini è una capacità della piattaforma, non del modello di chat: se il modello di sessione non genera immagini, il motore instrada sul primo dei tuoi provider con chiave che può farlo, e lo dichiara.

🔑 Configurare le chiavi API

1. 1Vai in Impostazioni → Chiavi provider AI e apri la card del provider.
2. 2Incolla la chiave: MFF la valida SUBITO con una query di test reale — una chiave che non passa il test non viene salvata.
3. 3La chiave viene cifrata lato server (key-ring AES con rotazione) e non viene mai più mostrata in chiaro, mai messa in un URL, mai mandata al browser. Il modello non la vede MAI: le richieste partono dal server.
4. 4Ogni chiave mostra un semaforo (attiva · non valida · in pausa) e, in vista Esperto, la whitelist 🎯 dei modelli consentiti: la sessione e il failover non usciranno mai dalla lista.

Dove creare la chiave, provider per provider

Le chiavi di RICERCA (per il 🌐)

Separate dalle chiavi dei modelli: Serper, Tavily, SerpAPI, Brave — sempre in Impostazioni, sezione Ricerca web. Anche queste validate con una query di prova. Eleggi la predefinita con la ⭐: il motore prova prima quella, le altre restano riserve nell’ordine fisso Serper → Tavily → SerpAPI → Brave. Con una tua chiave paghi solo il tuo provider; senza, usi la quota inclusa di MFF (limitata e condivisa).

🌐 Ricerca web e fonti

1. 1Premi 🌐 accanto al composer: un mini-modello estrae la query di ricerca proposta e te la MOSTRA. Puoi correggerla o riscriverla — la query è una decisione tua, non un automatismo cieco.
2. 2La ricerca gira sulla catena MWAL: la tua chiave predefinita per prima, poi le riserve (Serper → Tavily → SerpAPI → Brave). Se un motore fallisce, il passaggio al successivo è dichiarato.
3. 3I risultati entrano nel contesto come blocco di grounding: la risposta può citarli, e le fonti restano nel chip 🌐 del messaggio — sopravvivono al reload e finiscono nell’export.

• Limite onesto n.1: gli snippet dei motori sono per costruzione una cache — per dati che cambiano al minuto (quotazioni, l’ora esatta) la fonte può essere pertinente ma stantia.
• Limite onesto n.2: sui modelli :free il 🌐 è disattivato per contenimento costi.

⚖️ Peer review fra modelli

Un SECONDO modello, di un provider diverso, rilegge la risposta e ti mostra il giudizio accanto all’originale. È il livello L5-B del protocollo: la convergenza di due agenti indipendenti può promuovere un 🔵 PROBABILE a 🟢 SICURO; una divergenza forza 🟡 o 🔴. Due modelli che non condividono né pesi né canale, d’accordo sulla stessa affermazione, valgono più di uno.

1. 1Alla creazione sessione, in Impostazioni avanzate, scegli il peer model: la lista pesca dai tuoi provider DIRETTI con chiave, deliberatamente diversi dal provider di sessione.
2. 2In chat premi ⚖ sotto la risposta che vuoi far rileggere: la review arriva in streaming e resta agganciata a quel messaggio, col suo verdetto di convergenza.
3. 3In alternativa, l’auto-trigger (checkbox in Avanzate) lancia la review su OGNI risposta: modalità per sessioni critiche — raddoppia il consumo del peer provider.

Le review sono persistite: le ritrovi al reload e nell’export; quelle ancorate a messaggi più vecchi della pagina caricata restano raggiungibili in testa al transcript. Se il ⚖ appare spento, la sessione non ha un peer model: si sceglie alla creazione. Funziona anche in PLAIN — e in PLAIN non consuma crediti MFF: paghi solo il tuo provider del peer.

Implicazione epistemica: se rigeneri una risposta, le review restano agganciate al messaggio a cui si riferivano — una review non migra mai su un testo che non ha mai letto.

🗂️ Carta dello stato e memoria trasferibile

La sessione raccoglie in una carta 🗂 ciò che risulta stabilito e a che titolo, estratto dalle etichette già dichiarate — non un riassunto scritto da un modello. Ogni affermazione porta il suo dichiarante: dopo un failover leggi CHI ha davvero dichiarato cosa, mai un attribuzione di comodo.

Serve a due cose: guardarla, e portarla altrove. «Copia come memoria» produce un testo da allegare a una sessione nuova — magari con un altro modello — senza trascinare il transcript intero. Chi la riceve legge che quelle etichette le ha dichiarate un altro: affermazioni da discutere, non verdetti da ereditare. Questo è anche il modo corretto di «cambiare modello»: non a sessione viva, ma con la carta che viaggia.

🪙 Crediti MFF

Welcome bonus

Ogni nuovo account riceve 500 crediti in modo progressivo: 50 all’iscrizione, +450 alla prima risposta in cui il framework viene applicato davvero. La progressione è un’anti-frode minima; superato il primo messaggio MFF, hai i 500 pieni. Nella beta gratuita i crediti non si comprano; il saldo e ogni movimento sono in Impostazioni → Crediti.

💰 Ottimizzare i costi

I modelli addebitano per token (~3-4 caratteri in italiano), in ingresso e in uscita. Ogni risposta in MFF mostra i suoi numeri nel footer tecnico: token, tempi e — quando il listino è noto — la stima di costo del messaggio e il cumulato della sessione. Se l’usage del provider non arriva, la stima è marcata con ~, mai spacciata per dato.

1. 1Usa i :free per bozze ed esplorazione (compromessi: contesto ridotto, niente 🌐).
2. 2Sessioni corte + carta trasferita battono le conversazioni chilometriche: la storia oltre il tetto viene comunque troncata dal motore — la carta è la memoria che viaggia senza pagare contesto.
3. 3Reasoning su Basso finché il compito non chiede di più: i token di pensiero si pagano come gli altri.
4. 4Whitelist 🎯 sulla chiave: nessun automatismo potrà scegliere un modello costoso al posto tuo.
5. 5Fallback economici nelle Avanzate: il failover rispetta la tua lista.
6. 6PLAIN per il casual: zero crediti, stesse funzioni.

⚙️ Impostazioni e diagnostica

La pagina Impostazioni ha due viste, selezionabili dal menu in testa e sincronizzate tra i tuoi dispositivi: «Utente base» mostra l’essenziale (profilo, chiavi, saldo, voce, privacy); «Utente esperto» aggiunge diagnostica, preferenze AI tecniche, whitelist 🎯 e storico movimenti. Se questo vademecum cita qualcosa che non vedi, quasi certamente sta nella vista Esperto.

La Diagnostica (vista Esperto): nessun numero inventato

• Probe BYOK: una query di test VERA su ogni tua chiave, con esito e latenza.
• Pannello immagini: dichiara QUALE delle tue chiavi genererebbe un’immagine ora, e con che modello.
• Salute modelli: telemetria di ciò che hai usato davvero (tempo di prima risposta, errori, 429).
• Censimento campi: ciò che le API dei provider espongono e MFF non traduce ancora. Un dato assente è mostrato come assente, mai spacciato per zero.

Cosa fare quando qualcosa è rosso

• Chiave «non valida»: revocata o scaduta sul sito del provider — rigenerala lì e reinseriscila. MFF non può ripararla.
• Chiave «in pausa»: il breaker l’ha fermata dopo errori ripetuti (tre «non valida» di fila = un quarto d’ora) per non bruciare richieste. Si riattiva da sola, o subito col bottone «Riattiva».
• Probe fallito su una chiave che ieri andava: guarda il codice prima di cancellare — un rate limit o un guasto del provider passano da soli.

📱 Installare MFF (PWA)

MFF è una Progressive Web App: funziona nel browser, ma installata dà icona dedicata, schermo intero senza barra URL e avvio istantaneo. Le funzioni AI restano identiche (serve la connessione: non c’è inferenza offline).

Android (Chrome / Edge / Brave)

1. 1Apri l’app nel browser: appare il banner «Installa app» → Installa. Se non appare: menu ⋮ → «Installa app» / «Aggiungi a schermata Home».

iOS (Safari)

1. 1Apri l’app in Safari (su iOS le PWA richiedono Safari) → icona Condividi → «Aggiungi alla schermata Home» → Aggiungi.

Desktop (Chrome / Edge / Brave)

1. 1Nella barra indirizzi a destra appare l’icona di installazione (monitor con freccia) → Installa: l’app si apre in finestra dedicata.

🔧 Risoluzione problemi

• Errore 429 su un modello :free → è la quota giornaliera del provider, non un guasto: aspetta qualche minuto, prova un altro :free, o usa un modello a pagamento con la tua chiave.
• Risposta interrotta a metà → «▸ Continua» sotto il messaggio riprende da dove si era fermata. Se il provider è caduto, il failover dichiarato ha già provato le riserve; l’eventuale errore resta visibile e il credito è rimborsato.
• Risposta lenta → i modelli con reasoning esteso sono lenti per costruzione: per compiti semplici usa un modello fast (Groq, Cerebras) o abbassa lo sforzo di reasoning nelle Avanzate.
• Chiave rossa o in pausa → vedi «Impostazioni e diagnostica»: rigenera dal provider se non valida; aspetta o «Riattiva» se in pausa.
• La sessione non si crea → il messaggio sotto il bottone dice il perché (modello non disponibile, crediti esauriti in MFF, sessione scaduta). Ricarica la pagina e riprova; in PLAIN i crediti non servono.
• Interfaccia con elementi vecchi → aggiorna la PWA: hard reload (Ctrl+Shift+R / Cmd+Shift+R); da installata, chiudi e riapri l’app.

❓ Domande frequenti

📖 Dizionario dei termini

Ogni termine tecnico del framework, spiegato in lingua semplice. Fuso dal glossario della guida pubblica (74 voci in 7 categorie).