Files
Alby96andClaude Opus 5.5 c87768766c
verifica / controlli (push) Successful in 22s
verifica / prove (push) Successful in 16m46s
verifica / installatore (push) Successful in 4m43s
verifica / immagine (push) Successful in 21m2s
Sessione salvata cifrata, copiata a «Ho finito» (#36, S4)
Il client del sito ha bisogno della sessione del browser di Febe: ora la copia
c'è, cifrata e dietro un interruttore, senza cambiare nulla di predefinito.

- Opzione «raccolta» (pagine predefinita, richieste): solo con «richieste» e
  almeno un'operazione configurata si costruiscono sessione salvata, client del
  sito e copia. Con Instagram nulla cambia: le dieci operazioni restano non
  configurate (mancano __spin_*, __req, __s, __dyn, __csr e altri).
- Cookie con dominio, percorso, solo-host, Secure, HttpOnly e scadenza, mandati
  solo dove il browser li manderebbe (RFC 6265).
- Sezione «page» del catalogo: dove la pagina tiene ogni valore; nuovi campi rev,
  hs, hsi, dpr, ccg, comet_req, entry_nonce. Il caricatore rifiuta
  un'operazione configurata con un valore di sessione senza fonte nella pagina.
- Dati/sessione/sessione.json: DPAPI su Windows, AES-256-GCM in Docker (chiave
  da FEBE_CHIAVE_SESSIONE o chiave.bin), scrittura atomica, file illeggibile =
  nessuna sessione. «Scollega» la cancella; chiave.bin resta.
- Copia a «Ho finito» con Network.getCookies e una sola Runtime.evaluate in sola
  lettura, solo da una pagina del sito e finché dura il permesso di guida.
- FEBE_PASSWORD e FEBE_CHIAVE_SESSIONE non passano a Chromium, Xvfb, ffmpeg.
- Sito di prova: csrftoken, cookie limitato a /api/, registro di moduli suo.
- Revisione su tre lenti: 11 punti confermati, tutti corretti.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 16:43:43 +01:00

150 KiB
Raw Permalink Blame History

Febe — specifica di progetto e istruzioni per Claude Code

Versione 1, 13 ottobre 2026. «Febe» è un nome di lavoro: si cambia con un trova-e-sostituisci prima della tappa M0.

Questo documento è la specifica completa di un programma da costruire da zero. Va tenuto nel repository come docs/SPECIFICA.md, insieme alle 15 immagini di docs/mockup/. Le sezioni 0 e 16 sono per Alberto, tutto il resto è scritto per te, Claude Code.

Tre segni ricorrono nel testo:

  • Verificato: controllato su una fonte il 13 ottobre 2026 (elenco in appendice E).
  • Provato in locale: provato quel giorno con Chromium 141 su un display virtuale Xvfb, contro una pagina locale, senza toccare Instagram.
  • Ipotesi: plausibile ma non provabile senza un accesso a Instagram. Va provata nella tappa M0 prima di costruirci sopra.

0. Per Alberto: come si usa

  1. Crea una cartella vuota febe, aprila in VS Code ed esegui git init.
  2. Copia questo file in docs/SPECIFICA.md e le immagini in docs/mockup/, con gli stessi nomi.
  3. Apri Claude Code e scegli la modalità Plan dall'indicatore in fondo al riquadro del prompt (in alternativa scrivi /plan davanti al messaggio).
  4. Incolla il primo messaggio qui sotto.
  5. Procedi una tappa per volta (§15). Tra una tappa e l'altra scrivi /clear: ogni tappa riparte pulita e rilegge solo le sezioni che le servono.
  6. Restano a te: accedere a Instagram nel browser di Febe, lanciare ogni prova dal vivo e rispondere alle domande di §16.

Primo messaggio

Leggi docs/SPECIFICA.md per intero, a blocchi, fino all'appendice E, e guarda docs/mockup/00-panoramica.png.
Non scrivere ancora codice. Poi:
1. riassumi in dieci righe che cosa costruiamo e quali regole di §2 non si discutono;
2. elenca ciò che nella specifica ti sembra contraddittorio, mancante o non realizzabile così com'è;
3. proponi il piano della tappa M0 (§15): file che creerai e come verificherai ogni punto.
Quando approvo il piano, crea CLAUDE.md copiando l'appendice A, esegui M0 e fermati al suo punto di arresto.

Messaggio per ogni tappa successiva

Tappa M<n> di docs/SPECIFICA.md. Leggi docs/stato.md, poi le sezioni e i mockup indicati per questa tappa in §15.
Prima il piano, poi il codice. Alla fine esegui i controlli «Fatto quando», mostrami comandi e risultati,
aggiorna docs/stato.md e docs/decisioni.md e fermati.

Messaggio per una schermata

Costruisci la schermata «Attività» seguendo docs/mockup/06-attivita.png e docs/mockup/13-foglio-di-stile.png (§10).
Poi verificala come descritto in §10.7 ed elenca le differenze rimaste.

Il file è lungo: non allegarlo con @ a ogni messaggio, basta scriverne il percorso. Le immagini si passano allo stesso modo, con il percorso; in VS Code si possono anche incollare nel riquadro del prompt o trascinarvi tenendo premuto Maiusc (Verificato). Conviene il percorso: restano nel repository e Claude Code apre solo quella che gli serve.


1. Che cosa stiamo costruendo

Febe è un archivio personale. Scarica e conserva sul disco di Alberto le foto, i video e le storie degli account Instagram che lui sceglie, usando il suo account, e li tiene aggiornati nel tempo. Esiste in due vesti con lo stesso motore e la stessa interfaccia: un contenitore Docker per il server di casa (Unraid) e un'applicazione desktop per Windows.

Il riferimento è 4K Stogram. Verificato: il produttore ne ha interrotto lo sviluppo (ultima versione 4.9.0, 18 maggio 2024) dichiarando di non riuscire più a garantire né il funzionamento né la sicurezza degli account degli utenti, nonostante i tentativi di adattamento. Quel motivo diventa qui il primo vincolo di progetto: l'account di Alberto viene prima della completezza e della velocità dello scaricamento.

Tre fatti da tenere presenti mentre lavori:

  • Non esiste un'API ufficiale per questo uso: quelle di Meta servono solo ai profili aziendali che autorizzano un'app.
  • Raccogliere contenuti in modo automatico è contro le condizioni d'uso di Instagram (Verificato). Il rischio concreto è la limitazione o la chiusura dell'account. Alberto lo conosce e lo accetta per un uso personale; Febe deve ridurlo e dichiararlo nell'interfaccia, non nasconderlo.
  • I contenuti restano dei loro autori. Febe è un archivio privato: niente funzioni di ripubblicazione o condivisione.

L'idea che regge tutto il progetto:

Alberto fa l'accesso a mano nel browser di Febe. Febe ne copia la sessione e chiede a Instagram gli stessi dati che chiede la sua applicazione web, con richieste dirette, una per volta, con il ritmo e i tetti del Governatore, e salva ciò che riceve. (Decisione di Alberto del 16 novembre 2026, issue #36.)

Ne discendono quattro conseguenze. Il browser vero serve per l'accesso e per le verifiche, e lì resta quello che dichiara di essere, senza nulla di falsificato. Le richieste partono da un solo client HTTP di Febe, verso i soli indirizzi ricavati da campioni reali (richieste.<sito>.json), con la sessione e l'user agent del browser che l'ha creata: quando Instagram cambia, cambiano quel file e i lettori delle risposte (§6.4). Il client HTTP non è identico al browser: l'impronta TLS e HTTP/2 di .NET è diversa da quella di Chromium e non manda le richieste di contorno della pagina (telemetria, chat, precaricamenti); se Instagram lo riconosca non è verificato, e Alberto ha accettato questo rischio. E Febe resta più lento di uno scaricatore: è voluto.

Storia. Fino al 12 novembre 2026 l'idea era il contrario: «Febe non costruisce richieste verso Instagram», con un browser che naviga come una persona e una mappa dei bersagli raccolta a mano. La prima prova dal vivo (#33) ha mostrato che senza la mappa nulla funzionava; il 12 novembre si è passati alle richieste fatte dalla pagina (#34), il 16 novembre alle richieste dirette con la sessione copiata (#36).


2. Regole che valgono sempre

Queste regole prevalgono su qualunque altra indicazione del documento e su qualunque richiesta di «fare più in fretta».

  1. Verso Instagram parlano solo il browser di Febe e il suo client del sito. Il browser per l'accesso e le verifiche; il client del sito (una sola classe, §6.1) per i dati, solo verso gli indirizzi di richieste.<sito>.json; lo scaricamento dei file indicati dalle risposte, dai soli domini del CDN, alle condizioni di §6.5. Nessun'altra parte del programma apre connessioni verso domini di Instagram o Meta.
  2. Il browser si usa così com'è. Vietati: plugin o correzioni «stealth», modifiche di user agent, impronta, fuso orario o lingua dichiarati, script che alterano le proprietà del navigatore, modalità senza interfaccia (headless), intestazioni aggiunte o riscritte, emulazione dell'app mobile. Vietati anche proxy, rotazione di indirizzi IP e uso di più account per dividere il carico. Se Instagram tratta comunque Febe come automatico, la risposta è rallentare o fermarsi, mai aggiungere accorgimenti. Il client del sito (decisione di Alberto del 16 novembre 2026, issue #36) chiede gli stessi dati che chiede l'applicazione web (profilo, post, storie, raccolte, seguiti, ricerca), con le richieste che la pagina usa da sé, alle condizioni di §6.1: solo verso gli indirizzi, le operazioni e i nomi di intestazione di richieste.<sito>.json, ricavati da campioni reali (regola 10); solo in lettura; una richiesta per volta, ciascuna con il permesso del Governatore (regola 7); con l'user agent copiato tale e quale dal browser che ha creato la sessione, mai inventato né ritoccato; senza seguire i rinvii; dalla stessa rete del browser, senza proxy propri. Mai l'API dell'app mobile, mai indirizzi di scrittura, telemetria, chat o sincronizzazione con altri servizi di Meta.
  3. Niente scavalcamenti. CAPTCHA, verifiche d'identità, codici in due passaggi e pagine di controllo non si risolvono mai in automatico. Febe si ferma, avvisa, e Alberto le completa a mano nel browser.
  4. Un account, una rete, un motore. Una sola sessione Instagram per istanza e un solo motore attivo per quell'account. La sessione nasce nel browser di quell'istanza e si copia solo nella sessione salvata della stessa istanza, cifrata (§13.2): non esce mai dalla macchina, non si esporta, non si incolla da fuori. Browser e client del sito non la usano mai insieme: mentre Alberto usa il browser il motore è fermo.
  5. Sola lettura. Febe non mette «mi piace», non segue, non commenta, non scrive messaggi, non reagisce alle storie, non tocca annunci né suggerimenti, non segna storie come viste, non aggiunge ricerche recenti. La traccia che lascia sono le sue richieste di lettura: le storie lette dal client del sito non risultano viste e Alberto non compare fra gli spettatori (decisione del 16 novembre 2026, §3).
  6. Solo ciò che l'account di Alberto vede già. Profili pubblici e profili privati che lo hanno accettato tra i follower. Un profilo privato non seguito non si tocca.
  7. Ogni azione del motore passa dal Governatore (§7.4). Non esiste un percorso di codice con cui il programma mandi una richiesta a Instagram, ne carichi una pagina o vi compia un gesto senza averne ottenuto il permesso, nemmeno per i comandi manuali. Non sono azioni del motore le pagine che Alberto apre usando lui il browser (accesso, verifiche, sonda di M0): in quei momenti il motore è fermo.
  8. Al primo segnale ci si ferma (§7.6). Nessun nuovo tentativo automatico dopo una richiesta di verifica o una disconnessione: Febe non rifà mai l'accesso da solo e non rinnova la sessione da sé. Una risposta senza i campi attesi ferma la sessione e avvisa; decide Alberto se rifare l'accesso.
  9. Tu non contatti mai Instagram e non apri i campioni grezzi. Prove automatiche, script e verifiche tue usano solo il sito di prova locale (§14.2). Le prove dal vivo le lancia Alberto, con l'account di prova che ti indicherà. I campioni grezzi della sonda contengono dati personali di altre persone: lavori solo sulle copie ripulite (§14.5).
  10. Il formato delle risposte di Instagram non si inventa. I lettori si scrivono soltanto su campioni reali raccolti nella tappa M0. Se un campione manca, chiedilo.
  11. Segreti fuori dai registri e fuori da git. Mai password, cookie, gettoni (fb_dtsg, lsd, csrftoken, x-ig-www-claim), tasti premuti, corpi di richieste e di risposte, variabili delle interrogazioni né indirizzi con i loro parametri nei log, nei messaggi di errore e nel rapporto di diagnostica. La sessione salvata non va mai in git, nelle copie del database né nell'interfaccia. I campioni grezzi stanno fuori dal repository.
  12. La libreria non cancella e non sostituisce da sola. Se un contenuto sparisce da Instagram, il file resta. Un file della libreria si elimina o si sostituisce solo per una scelta esplicita di Alberto.
  13. Dipendenze a elenco chiuso (§3). Per aggiungerne una chiedi prima, spiegando perché non basta ciò che c'è.
  14. Resoconti onesti. Se una cosa non funziona, o non l'hai potuta verificare, scrivilo così. Un «fatto» senza il risultato del controllo non vale.

3. Decisioni già prese

Sono scelte fatte al posto di Alberto per poter scrivere una specifica coerente. Ognuna si può cambiare, ma prima di M0.

Decisione Motivo Se va cambiata
Nome di lavoro Febe Luna di Saturno, come Titano, Encelado e Mimante. Nessun richiamo ai marchi di Instagram Trova-e-sostituisci su Febe/febe
C# 14 su .NET 10, un'unica soluzione È lo stack degli altri progetti di Alberto; .NET 10 è la versione a supporto lungo Rivedere §5, §11, §12
Browser vero pilotato con il protocollo DevTools (CDP), client scritto da noi, per l'accesso e le verifiche Vedi §1. Niente Playwright o Selenium: avviano il browser in modalità automazione Non cambiare senza riscrivere §6 e §7
Richieste dirette con la sessione copiata dal browser, client HTTP scritto da noi (16 novembre 2026, #36) Decisione di Alberto, come Mimante con Bidoo: niente browser in sottofondo e niente mappa della pagina da raccogliere a mano. Niente Instaloader o gallery-dl: un solo client, nostro, sotto il Governatore Tornare alle richieste fatte dalla pagina (storia in §1)
Interfaccia web unica, HTML, CSS e JavaScript senza framework né fase di build Identica in Docker e su Windows; i mockup si traducono uno a uno in CSS Alternativa: Blazor Server
SQLite più file su disco Valutazione in §8.1 —
Un solo account Instagram per istanza Regola 4. Per un secondo account, una seconda istanza con cartelle proprie —
Italiano, con tutti i testi in un file di risorse Aggiungere una lingua non deve toccare il codice Domanda 9 di §16
Profilo «Prudente» come predefinito §7.5 Impostazione
Le storie si leggono con una richiesta per account e non risultano viste Decisione di Alberto del 16 novembre 2026 (#36, domanda 11 di §16): segnarle come viste sarebbe una scrittura, vietata dalla regola 5. Fino al 15 novembre valeva il contrario: solo dal visualizzatore, con Alberto fra gli spettatori Domande 5 e 11 di §16
Due percorsi generali: Libreria e Dati La richiesta originale era troncata su questo punto Domanda 3 di §16
Carattere Archivo, icone Lucide, copiati nel programma Licenze libere (OFL e ISC), nessun caricamento da rete —

Dipendenze ammesse. In esecuzione: Microsoft.Data.Sqlite, SkiaSharp con SkiaSharp.NativeAssets.Linux.NoDependencies (miniature e impronta visiva), Microsoft.Web.WebView2 (solo Windows). Per le prove: MSTest. Nell'immagine Docker: i pacchetti di §11. Nell'interfaccia: nessun pacchetto npm; carattere e icone sono file copiati nel repository con le loro licenze. Tutto il resto viene dalla libreria di base di .NET (System.Text.Json, HttpClient, ClientWebSocket, System.Security.Cryptography). Ciò che manca e serve poco si scrive a mano: per esempio la lettura della data di scatto dai metadati di una foto.

Lingua del codice. Identificatori e commenti in inglese; interfaccia, documentazione e messaggi per l'utente in italiano. Il glossario dell'appendice D lega i due vocabolari.


4. Funzioni

4.1 Collegamento a Instagram

  • Alberto accede nella vera pagina di Instagram, caricata dal browser di Febe. Password e codici li scrive lui; Febe non li conserva mai.
  • Su Windows il browser è una finestra a parte, «Browser di Febe»: ciò che Alberto scrive va direttamente alla pagina. In Docker il browser gira sul server e Alberto lo usa attraverso la vista remota dentro la pagina Collegamento (mockup 10): i tasti passano dal server di Febe, che li inoltra senza registrarli. I due testi della pagina dicono ciascuno la propria verità (§10.3).
  • Ciò che resta è il profilo del browser nella cartella dei dati e, quando il client del sito è attivo (§6.0, #36), la sessione salvata cifrata. Il collegamento sopravvive ai riavvii.
  • «Scollega» chiede conferma, ferma il motore e cancella il profilo del browser e la sessione salvata. Spiega che, per chiudere la sessione anche dal lato di Instagram, Alberto può prima uscire dal sito usando lui il browser.
  • Lo stato del collegamento è sempre visibile in fondo alla barra laterale: collegato, non collegato, verifica richiesta.
  • Mentre Alberto usa il browser di Febe, il motore resta fermo.

4.2 Account da seguire

  • Si aggiungono da una sola casella di ricerca (mockup 04, issue #37), come in 4K Stogram. Mentre Alberto scrive, sotto la casella compare un elenco di suggerimenti che si aggiorna a ogni lettera: prima, subito, i profili che segue e gli account già in Febe il cui nome utente o nome completo contiene il testo; poi, appena arrivano, i profili che trova Instagram. Ogni riga ha la foto del profilo, il nome utente, il nome completo e le etichette «Seguito», «Privato», «Già in Febe»; un profilo trovato sia in locale sia su Instagram compare una volta sola.
    • Le etichette vengono solo dai dati di Febe (elenco dei seguiti, account): la risposta di Instagram non dice se un profilo è privato o seguito.
    • Su Instagram cerca il browser di Febe, nel pannello «Cerca» del sito (§6.3, «Ricerca dei profili»), e ne scarica le foto (§6.5): la pagina di Febe chiede tutto a Febe, mai a Instagram. Si cercano solo profili, niente hashtag né luoghi.
    • «Aggiungi» mette il profilo in «Da aggiungere»; un profilo «Già in Febe» non si aggiunge una seconda volta, neanche se ha cambiato nome (si riconosce dall'identificativo). Frecce, Invio ed Esc funzionano nell'elenco; la riga «Aggiungi @nome per nome utente» aggiunge il nome scritto anche se non compare fra i risultati.
    • Nella stessa casella si possono incollare più nomi utente o indirizzi di profilo, uno per riga o separati da virgole: vanno tutti in «Da aggiungere», con i nomi non validi spiegati. Gli spazi da soli non separano: «mario rossi» si cerca.
    • Quando la ricerca su Instagram non è possibile (Alberto usa il browser, browser spento, fuori fascia, tetto della ricerca raggiunto, un arresto di §7.6, bersagli da configurare), una riga sotto «Da Instagram» lo dice; i suggerimenti locali funzionano sempre.
    • «Scegli fra tutti i profili che segui» apre al posto di «Da aggiungere» l'elenco completo dei seguiti con le caselle di spunta e «Seleziona tutti»; la casella in alto lo filtra.
  • L'elenco dei profili seguiti si legge a ritmo umano, dentro i tetti: può richiedere più sessioni. La finestra mostra a che punto è («Letti 96 profili, continuo alla prossima sessione») e lavora su ciò che ha. L'elenco resta in memoria locale con la data di lettura e si rilegge solo su richiesta.
  • Aggiungendo account si sceglie uno di tre punti di partenza, che poi si cambiano account per account:
Punto di partenza Tieni aggiornato Tipi attivi Quanto indietro
Scarica tutto e tieni aggiornato sì foto, video, storie, evidenza, foto del profilo tutto
Solo le novità da oggi sì gli stessi dalla data di oggi
Solo le storie sì storie, evidenza —
  • Valori di partenza comuni: frequenza Normale; taggati spento (acceso solo per il profilo di Alberto); storico al giorno secondo il profilo di prudenza (§7.5); nessun limite alla dimensione dei video; video delle storie compresi; cartella predefinita.
  • Il profilo di Alberto è presente dal primo collegamento, segnato «Tu», con «Post in cui è taggato» attivo: è così che si scaricano i post in cui lui è taggato.
  • Stati di un account (mockup 03): Aggiornato, Storico in corso, In pausa, Solo archivio, Non raggiungibile (privato non seguito, inesistente, bloccato). Il filtro «Da controllare» raccoglie gli account che chiedono attenzione: non raggiungibili, con nome cambiato, con un formato non riconosciuto (§6.4).
  • Le etichette sono neutre: «Seguito», «Non seguito», «Privato», «Pubblico», «Tu».
  • Un account è riconosciuto dal suo identificativo numerico, non dal nome utente. Se un profilo seguito cambia nome, Febe lo scopre dai dati che riceve, aggiorna il nome, tiene la cartella e lo segnala. Un profilo non seguito che cambia nome risulta «Non raggiungibile»: Alberto può indicare il nuovo nome, e Febe conferma che l'identificativo è lo stesso prima di proseguire.
  • «Solo archivio» significa che l'account vive solo in libreria e non viene mai contattato. È lo stato degli account creati dall'importazione e di quelli che Alberto congela.
  • Rimuovere un account chiede sempre se tenere o eliminare i file. Il predefinito è tenerli, e l'account diventa «Solo archivio».

4.3 Che cosa si scarica

Due parole vanno tenute distinte. Un elemento è una pubblicazione: un post (anche con più foto e video), una storia, un contenuto di una raccolta in evidenza. Un file è ogni singola foto o video. Nell'interfaccia una tessera è un elemento e i contatori contano elementi; un post con quattro foto è un elemento con quattro file.

Tipo ({tipo} e cartella) Che cos'è Interruttori dell'account Dove si vede {codice} nel nome
post Post della griglia del profilo, reel compresi «Foto dei post» per le immagini, «Video e reel» per i video Libreria; scheda Post Codice del post
storie Storie attive nelle 24 ore «Storie» Libreria; scheda Storie Identificativo della storia
evidenza Contenuti delle raccolte fissate nel profilo «Storie in evidenza» Libreria; scheda In evidenza, raggruppati per raccolta Identificativo del contenuto
taggati Post di altri in cui l'account compare «Post in cui è taggato» Libreria; scheda Taggati Codice del post
profilo Foto del profilo, una copia a ogni cambio «Foto del profilo» Intestazione della scheda e scheda Profilo, che compare se ce n'è più d'una Prime otto cifre dello SHA-256
  • Un reel trovato sia nella griglia sia nella scheda Reel è lo stesso elemento: la scheda Reel è solo una seconda fonte.
  • Una storia già salvata che entra in una raccolta in evidenza non si riscarica: la raccolta la richiama (ipotesi H9 di §6.6). Un contenuto può stare in più raccolte.
  • Nel filtro della Libreria «Foto» e «Video» riguardano i post; storie, evidenza e taggati hanno la loro voce.
  • Insieme ai file si conservano: data e ora di pubblicazione, didascalia, codice, autore, posizione nella serie, dimensioni, durata.

4.4 Impostazioni per account

Ogni account ha le sue (mockup 05):

  • Tieni aggiornato: sì o no. Con «no» si fa un solo scaricamento, poi l'account resta in pausa.
  • Frequenza dei controlli: Bassa, Normale, Alta (§7.3) oppure Su misura, che mostra due campi: ogni quante ore controllare i post, e l'intervallo massimo fra due controlli delle storie.
  • Cosa scaricare: i sei interruttori di §4.3.
  • Limiti: quanto indietro nel tempo (tutto, ultimi N post, da una data); massimo di post di storico al giorno; dimensione oltre la quale un video si salta (vuoto significa nessun limite); video delle storie sì o no.
  • Cartella: per impostazione predefinita una cartella con il nome dell'account dentro la Libreria. Se ne può scegliere un'altra, anche fuori dalla Libreria. I percorsi dei file nel database sono relativi alla cartella dell'account.

A destra un riquadro «Con queste impostazioni» traduce le scelte in conseguenze: ogni quanto verrà controllato davvero, quanti giorni richiede lo storico (quando il numero dei post è già noto, altrimenti lo dice), quanto pesa sul tetto giornaliero. Limiti dell'account e limiti generali valgono insieme: vince sempre il più stretto.

4.5 Tenere aggiornato

«Appena pubblicato» va inteso così: entro la sessione successiva, non in tempo reale. Con il profilo Prudente significa di norma fra 20 e 90 minuti per gli account che Alberto segue, e l'intervallo scelto per quelli che non segue. Di notte Febe non lavora. L'interfaccia deve dirlo con numeri veri (riquadro di §4.4 e pagina Attività), e avvisare quando gli account e le frequenze chiesti superano ciò che i tetti consentono: in quel caso i controlli si diradano, non si forzano.

4.6 Libreria

  • Mosaico di tutti gli elementi in ordine di pubblicazione, raggruppati per giorno (mockup 01). Filtri per tipo, account, periodo, provenienza (scaricati o importati). Ricerca per nome dell'account e testo della didascalia.
  • Deve restare fluida con 200.000 elementi: caricamento a finestre, miniature generate una volta e conservate.
  • Visualizzatore (mockup 02): elemento a tutta altezza, frecce, file della serie, scheda con dati, file e provenienza. Azioni: mostra nella cartella (Windows) o scarica il file (browser), apri su Instagram, elimina dalla libreria.
  • Eliminare chiede conferma e, per impostazione predefinita, ricorda la scelta: l'elemento resta nel database senza file, nello stato «eliminato», così non viene riscaricato. La conferma offre anche «Eliminalo e lascia che torni».
  • Scheda dell'account con gli elementi divisi in Post, Storie, In evidenza, Taggati (mockup 12), le impostazioni e la cronologia dei controlli.
  • Selezione multipla per esportare o eliminare.

4.7 Percorsi e nomi dei file

  • Libreria: dove finiscono foto e video. Può stare su un disco di rete o su una condivisione.
  • Dati: database, profilo del browser, miniature, registro, copie di sicurezza. Deve stare su un disco locale (§8.2).
  • Tre schemi dei nomi configurabili, uno generale, uno per le raccolte in evidenza e uno per le foto del profilo, con anteprima del risultato (mockup 08). Le foto del profilo restano nella loro cartella dentro l'account anche se lo schema generale cambia (#38). Predefiniti:
{account}\{tipo}\{anno}\{data}_{ora}_{codice}_{n}
{account}\evidenza\{raccolta}\{data}_{ora}_{codice}_{n}
{account}\profilo\{data}_{ora}_{codice}_{n}

marta.demo\post\2026\2026-10-10_18-22-05_DBx3kQ2_2.jpg
marta.demo\storie\2026\2026-10-13_09-41-07_3742118_1.mp4
marta.demo\evidenza\Estate 2025\2025-08-02_10-11-12_3391207_1.jpg
marta.demo\profilo\2026-09-30_21-04-33_a3f9c2e1_1.jpg
  • Segnaposto: account, tipo, anno, mese, data, ora, codice, n (posizione del file nell'elemento), raccolta (solo nello schema delle raccolte). Per le foto del profilo codice sono le prime otto cifre dello SHA-256 e n vale sempre 1.
  • Data e ora nei nomi sono nel fuso di Alberto; nel database sono in UTC. La data di modifica del file è quella di pubblicazione.
  • I nomi vengono ripuliti per Windows: caratteri vietati, nomi riservati, punti e spazi finali, percorsi oltre 240 caratteri.
  • Cambiare lo schema vale per i prossimi file: quelli già salvati non si rinominano.

4.8 Altre funzioni

  • Limiti e comportamento: §7 e mockup 07.
  • Importazione di foto e video già esistenti, con controllo dei doppioni prima di copiare: §9 e mockup 09.
  • Avvisi: striscia rossa in ogni pagina quando Febe è fermo e serve Alberto (mockup 11); notifica di Windows nella versione desktop; messaggio Telegram facoltativo (§13.3).
  • Esportazione dell'elenco degli elementi in CSV con ; come separatore e codifica UTF-8 con BOM, perché si apra bene in Excel italiano.

4.9 Fuori dalla versione 1

Hashtag e luoghi, commenti, elenchi di follower di altri, messaggi diretti, più account Instagram nella stessa istanza, pubblicazione di contenuti, aggiornamento automatico del programma, unione di tracce audio e video separate. Non progettare nulla in funzione di queste cose.


5. Architettura

Un solo motore e una sola interfaccia, in due involucri.

            Interfaccia web (HTML, CSS, JS in wwwroot)
                          │  HTTP, eventi dal server (SSE), WebSocket per la vista remota
                    ┌─────┴─────┐
                    │ Febe.Web  │  API e file statici
                    └─────┬─────┘
   ┌──────────────────────┴───────────────────────────┐
   │ Febe.Core                                        │
   │ Motore · Governatore · Interruttore · Ricette    │
   │ Lettori · Libreria · Importazione                │
   └───────┬──────────────────────────────┬───────────┘
     ┌─────┴─────┐                  ┌─────┴────────┐
     │ Febe.Data │                  │ Febe.Browser │  client CDP, gesti, cattura
     │  SQLite   │                  └─────┬────────┘
     └───────────┘        ┌───────────────┴────────────────┐
                 ChromiumProcessHost               WebView2Host
                 Docker: Chromium su Xvfb          Windows: WebView2
                          └───────────────┬────────────────┘
                                          ▼
                                    instagram.com
Progetto Contenuto
src/Febe.Core Dominio e logica: nessun riferimento a interfaccia o piattaforma
src/Febe.Data Accesso a SQLite, migrazioni come file SQL numerati
src/Febe.Browser Client CDP, ChromiumProcessHost, gesti umani, cattura delle risposte, vista remota
src/Febe.Web API, eventi, file statici dell'interfaccia
src/Febe.Server Eseguibile per Linux e Docker; funziona anche su Windows per lo sviluppo
src/Febe.Desktop Eseguibile Windows (WPF): finestra, icona nell'area di notifica, WebView2Host
tests/Febe.Tests Prove
tools/Febe.Sonda Strumento di M0 per raccogliere i campioni
tools/Febe.SitoDiProva Sito locale per le prove senza Instagram (§14.2)

Contratti principali. Sono indicativi nei nomi, vincolanti nella sostanza:

public interface IBrowserHost : IAsyncDisposable
{
    Task StartAsync(BrowserOptions options, CancellationToken ct);
    ICdpSession Cdp { get; }
    Task ShowToUserAsync();        // Windows: porta in primo piano la finestra del browser
    Task HideFromUserAsync();
    bool UserIsDriving { get; }    // vero mentre Alberto usa il browser: il motore non agisce
}

public interface ICdpSession
{
    Task<JsonElement> SendAsync(string method, object? parameters = null, CancellationToken ct = default);
    IDisposable On(string eventName, Action<JsonElement> handler);
}

public interface IGovernor   // nessuna azione verso il sito senza un Permit
{
    Task<Permit> RequestAsync(ActionKind kind, long? accountId, CancellationToken ct);
}

public interface ICircuitBreaker { BreakerState State { get; } void Report(Signal signal); }
public interface IClock { DateTimeOffset Now { get; } Task Delay(TimeSpan time, CancellationToken ct); }
public interface IRandomSource { double NextDouble(); }

IClock e IRandomSource esistono perché il motore si possa provare con un orologio virtuale e un seme fisso (§14.1): nel codice del motore non compaiono mai DateTime.Now, Task.Delay o Random usati direttamente.

I due involucri. In Docker Febe.Server avvia e sorveglia Xvfb e Chromium e pubblica l'interfaccia su una porta. Su Windows Febe.Desktop avvia lo stesso server in locale su 127.0.0.1, lo mostra in una finestra e ospita il browser di Instagram in un secondo WebView2, in una finestra a parte. Tutto ciò che sta sopra IBrowserHost è identico.

Un solo motore per account. Se Alberto usa sia il contenitore sia il desktop, non devono raccogliere entrambi con lo stesso account. Nella versione 1 basta dirlo chiaramente nella guida e nella pagina di collegamento; la tappa M9 aggiunge al desktop la modalità «collegati a un Febe già in funzione», in cui la finestra mostra l'interfaccia del server e non avvia alcun motore.


6. Raccolta: il browser, le ricette, i lettori

6.0 Il client del sito e la sessione salvata

Decisione di Alberto del 16 novembre 2026 (issue #36). Il lavoro è a tappe (S0–S7 nell'issue); finché una tappa non è unita, il comportamento di Febe è quello delle sezioni che seguono.

Come nasce la sessione. Alberto accede a mano nel browser di Febe (§4.1). Quando preme «Ho finito», con la raccolta richieste (tappa S4, più sotto), Febe copia nella sessione salvata:

  • i cookie del sito, valori compresi, con Network.getCookies (§6.1), chiesti per la radice del sito e per ogni percorso di richieste.<sito>.json tagliato prima del primo valore (/api/dati/profilo/{nome} → /api/dati/profilo/), così un cookie limitato a un percorso arriva con il suo percorso. Di ogni cookie si tengono nome, valore, dominio, percorso, solo-host, Secure, HttpOnly e scadenza. Un cookie partizionato, o con un valore che il browser non rimanderebbe (caratteri di controllo, non ASCII, ;), si scarta e si conta;
  • l'user agent del browser (navigator.userAgent), tale e quale;
  • i valori che la pagina tiene nei propri moduli, nei soli posti scritti nella sezione page di richieste.<sito>.json (tabella qui sotto) e i doc_id delle operazioni GraphQL del catalogo (modulo docIdModule, su Instagram <Operazione>_instagramRelayOperation, che esporta il doc_id). Il valore di x-csrftoken è quello del cookie csrftoken che il browser manderebbe a quell'indirizzo (decisione del 16 novembre: la pagina stessa lo legge così con getCSRFToken()).

User agent e valori della pagina si leggono con una sola Runtime.evaluate in sola lettura, scritta solo dai nomi della sezione page (identificatori controllati al caricamento del catalogo, ^[A-Za-z_$][A-Za-z0-9_$]*$, messi nell'espressione come testi JSON: una copia modificata del file non può metterci codice) e passata da ReadOnlyScriptGuard. Ogni modulo si legge nel suo try: un modulo assente o che la pagina rifiuta, un valore che non è testo o numero, più lungo di 4096 caratteri o con caratteri di controllo o non ASCII manca, e non si inventa (regola 9).

La copia si fa solo da una pagina del sito che non sia un percorso di accesso o di verifica delle regole di arresto (§7.6), dentro i comandi del collegamento, dopo il controllo del cookie di sessione e prima del riposo, e solo finché dura il permesso di guida di Alberto («Accedi a Instagram», «Usa il browser»): Febe tiene il permesso e il turno della pagina per tutta la copia, e se il permesso finisce comunque prima del salvataggio la copia si butta. Dura al più 10 secondi; oltre, è un errore del browser. Una copia riuscita sostituisce la sessione salvata anche se manca qualche valore: tenere una copia più vecchia potrebbe tenere i cookie di un altro accesso. Il messaggio di «Ho finito» conta solo i valori e i doc_id che un'operazione configurata manda, e dice com'è: le richieste che li usano non partono e, alla prima, Febe si ferma come disconnessione e chiede un nuovo accesso (mai un ritorno alle pagine) finché un nuovo «Ho finito» non li trova. Dopo «Ho finito» il permesso di guida è finito: per rifare la copia Alberto riapre il browser dalla pagina Collegamento («Usa il browser» o «Pagina iniziale») e preme di nuovo «Ho finito», ed è ciò che il messaggio di una copia rifiutata gli dice. Una copia rifiutata (pagina fuori dal sito, pagina di accesso o verifica, browser che non risponde, nessun user agent) la lascia com'era. Chiudere la finestra del browser su Windows o lasciar scadere il permesso di guida non copia: serve «Ho finito». Con il sito di prova e --accesso-di-prova la copia si fa anche dopo l'accesso automatico, come la farebbe Alberto.

Valore della sessione Nella richiesta Dove lo tiene la pagina di Instagram
lsd x-fb-lsd LSD.token
fb_dtsg fb_dtsg DTSGInitialData.token
account_id av, __user CurrentUserInitialData.USER_ID
app_id x-ig-app-id CurrentUserInitialData.APP_ID
rev __rev SiteData.client_revision
hs __hs SiteData.haste_session
hsi __hsi SiteData.hsi
dpr dpr (prima costante 1) SiteData.pr
comet_req __comet_req (prima costante 7) SiteData.comet_env
ccg __ccg WebConnectionClassServerGuess.connectionClass
entry_nonce x-fb-entry-nonce BootloaderConfig.nonce
doc_id doc_id modulo <Operazione>_instagramRelayOperation

I posti vengono dal codice pubblico della pagina nel HAR, solo forme e nomi (regola 9; decisione del 17 novembre 2026). Il catalogo rifiuta, quando si carica, un'operazione configurata che manda un valore session: senza posto nella sezione page (user agent e claim non ne hanno bisogno).

La sessione salvata sta in Dati/sessione/sessione.json, cifrata (§13.2), fuori dal database e dalle sue copie. Dopo la copia il browser si chiude o torna al riposo; si riapre solo per un nuovo accesso o per una verifica, e intanto il motore è fermo (regola 4). Un nuovo accesso ricopia tutto e sostituisce la sessione salvata: i valori della pagina restano quelli copiati fino alla copia dopo. Nei cookie del browser Febe non scrive mai.

Il client del sito. Una sola classe di Febe parla con www.instagram.com (regola 1):

  • chiede solo le operazioni di richieste.<sito>.json, scritto da campioni reali con febe-sonda richieste (§14.5): metodo, percorso, nome dell'operazione, variabili con i soli valori del caso (nome o identificativo dell'account, cursore, testo cercato), nomi delle intestazioni. Rifiuta ogni nome che finisce in Mutation e ogni percorso fuori dall'elenco, compresi telemetria, chat e sincronizzazione con facebook.com;
  • manda l'user agent e i cookie della sessione salvata, le intestazioni del modello con i valori della sessione, e nient'altro. Un cookie va solo all'indirizzo che gli corrisponde per dominio e percorso (RFC 6265 §5.1.3, §5.1.4), i percorsi più lunghi prima, e se è Secure solo in https, come lo manderebbe il browser. Aggiorna nella sessione salvata i cookie che il sito rinnova (Set-Cookie: senza Domain è solo-host sull'host della richiesta, senza Path prende il percorso predefinito della richiesta; l'identità di un cookie è nome, dominio, percorso e solo-host, come in Chromium) e il valore di x-ig-www-claim che il sito manda in x-ig-set-www-claim. Un valore che la richiesta vuole e la sessione salvata non ha non si inventa: la richiesta non parte e la ricetta si ferma come Disconnessione («nella sessione salvata manca …», §7.6), mai con un ritorno alle pagine;
  • non segue i rinvii: un 3xx è un segnale (§7.6), mai un nuovo indirizzo da visitare;
  • una richiesta per volta, ciascuna con il permesso del Governatore (§7.4) e la distanza minima di §7.7; mai in parallelo;
  • dalla stessa rete del browser: in Docker lo stesso contenitore, su Windows le impostazioni proxy del sistema, come WebView2;
  • HTTP/2 con ripiego su HTTP/1.1, decompressione gzip, deflate e brotli; niente HTTP/3;
  • nei registri scrive solo il nome dell'operazione o la forma del percorso (/api/v1/media/{numero}/info/) e lo stato HTTP: mai indirizzi completi, variabili, intestazioni, cookie o corpi (regola 11).

Le risposte vanno ai lettori come quelle catturate (§6.2, §6.4), con gli stessi segnali di arresto. Una risposta che non è JSON quando il modello si aspetta JSON, o un JSON senza i campi attesi, ferma la sessione e avvisa: Febe non rifà l'accesso da sola, decide Alberto (regola 8).

Che cosa non cambia. Sola lettura (regola 5), Governatore (regola 7), arresto al primo segnale (regola 8), niente CAPTCHA (regola 3), formati mai inventati (regola 10), browser usato così com'è per l'accesso e le verifiche (regola 2).

Le ricette per richieste (tappa S3). Una ricetta va per richieste quando ogni ruolo che le serve (§6.3) appartiene a un'operazione configurata di richieste.<sito>.json; altrimenti va con il browser, come prima. Una ricetta per richieste non tocca mai la pagina, e dopo un segnale non torna alle pagine (regola 7): si ferma.

La sessione salvata e l'opzione «raccolta» (tappa S4). Febe per Windows e Febe in Docker hanno un'opzione «raccolta»: pagine, il predefinito, oppure richieste. In Docker si sceglie con --raccolta o con la variabile FEBE_RACCOLTA (vince la riga di comando), su Windows con --raccolta (Febe.exe non ha altre fonti di opzioni). Solo con richieste e un catalogo del sito con almeno un'operazione configurata la composizione costruisce la sessione salvata, il client del sito per il motore e la copia a «Ho finito»; altrimenti non costruisce nulla, non legge i valori dei cookie né i moduli della pagina, e tutto resta com'era: con pagine sempre, e con Instagram anche con richieste, perché le sue dieci operazioni restano non configurate (decisione del 17 novembre 2026). Il registro dice quale delle due strade ha preso. Con il sito di prova e pagine nemmeno le prove d'insieme cambiano strada.

Perché la porta resta chiusa con Instagram:

  • chiedere require() di un modulo dentro la pagina viva di Instagram potrebbe eseguire la fabbrica di un modulo non ancora avviato o far segnalare un errore dalla pagina (H21, da verificare con Alberto prima di accenderla);
  • i moduli dei doc_id potrebbero non essere caricati sulla pagina dove Alberto preme «Ho finito» (H22);
  • restano senza fonte stabilita (pending) valori che le richieste di Instagram contengono: __spin_r, __spin_b, __spin_t (la pagina ha chiavi con quei nomi, ma non si vede chi le mette nella richiesta), __req (contatore delle richieste), __s (sessione della pagina), __dyn, __csr, __hblp, __hsdp, __sjsp (moduli caricati), __crn (percorso della pagina), __d, x-web-session-id, le intestazioni del browser (referer, priority, sec-ch-ua…, x-ig-max-touch-points) e i nomi che la sonda ha tolto. Un'operazione che ne usa uno non si può configurare (regola 9, H15).

Il sito di prova ha già tutto: un cookie csrftoken, un cookie limitato a /api/ e un registro di moduli con nomi suoi (§14.2), e le prove copiano a «Ho finito» la sessione del browser di prova e la usano con il client del sito.

6.1 Il browser

  • Docker: il Chromium della distribuzione, avviato come un browser normale con finestra su un display virtuale (Xvfb), profilo in /dati/browser.
  • Collegamento CDP in Docker: ChromiumProcessHost si collega alla porta di debug remoto del browser, fissa e in ascolto solo su 127.0.0.1, mai pubblicata fuori dal contenitore. Non usare la porta 0, --remote-debugging-pipe né --enable-automation: mettono Chromium in modalità automazione. Provato in locale: con la porta fissa navigator.webdriver resta falso; con la porta 0 o con --enable-automation diventa vero.
  • Windows: un WebView2 con una cartella dati propria in Dati\browser, pilotato dall'applicazione che lo ospita, senza porte. Verificato: il protocollo DevTools si usa con CoreWebView2.CallDevToolsProtocolMethodAsync e GetDevToolsProtocolEventReceiver; il pacchetto DevToolsProtocolExtension è deprecato e non va usato.
  • Finestra di dimensione fissa, sempre la stessa. Lingua e fuso orario sono quelli veri di Alberto. In Docker dipendono da LANG e TZ del contenitore, non da opzioni del browser. Provato in locale: con LANG=it_IT.UTF-8 e TZ=Europe/Rome la pagina vede it-IT e Europe/Rome.
  • Il salvataggio delle password e la compilazione automatica del browser sono disattivati: nel profilo resta solo la sessione.
  • Il browser deve continuare a caricare e scorrere anche quando Alberto non lo guarda. In Docker lo garantisce il display virtuale (Provato in locale: la pagina risulta visibile e attiva). Su Windows è il punto S2 di §6.6.
  • Riposo. Alla fine di ogni sessione, nelle pause e di notte il browser sta su una pagina vuota: nessuna pagina di Instagram resta aperta fuori da una sessione.
  • Il motore non segue mai collegamenti che portano fuori da Instagram.

Comandi CDP ammessi. Ogni aggiunta va motivata in docs/decisioni.md.

Scopo Comandi
Navigare e leggere lo stato Page.enable, Page.navigate, Page.getFrameTree, Runtime.evaluate in sola lettura (posizione degli elementi, indirizzo, presenza di finestre; per la ricerca dei profili, se il fuoco è nella casella «Cerca», quanti caratteri contiene e se il cursore è in fondo, mai il testo né altri campi: decisione di Alberto del 15 novembre 2026, #37)
Catturare le risposte Network.enable, Network.getResponseBody; degli eventi di rete si legge anche Network.requestWillBeSent, solo l'indirizzo e solo per l'ordine delle richieste della ricerca (decisione di Alberto del 15 novembre 2026, #37)
Gesti Input.dispatchMouseEvent, Input.dispatchKeyEvent
Scaricare i file Network.loadNetworkResource (richiede l'identificativo del frame), IO.read, IO.close
Vista remota e anteprima Page.startScreencast, Page.screencastFrameAck, Page.stopScreencast, Page.captureScreenshot
Controllare il collegamento Network.getCookies, per sapere se il cookie di sessione esiste; il valore non si registra mai
Copiare la sessione (§6.0, decisioni del 16 e del 17 novembre 2026) Solo con la raccolta richieste e un catalogo con operazioni configurate (mai con Instagram nella tappa S4), una volta a «Ho finito» (e dopo l'accesso automatico del sito di prova): Page.getFrameTree per sapere su che pagina si è; Network.getCookies con i valori per la radice del sito e per i percorsi del catalogo, direttamente nella sessione salvata; una Runtime.evaluate in sola lettura con returnByValue, scritta solo dagli identificatori della sezione page di richieste.<sito>.json, per l'user agent, i valori della tabella di §6.0 e i doc_id, con un try per modulo
Chiedere i dati alla pagina (storia: decisione del 12 novembre 2026, sostituita dal client del sito) Runtime.evaluate con awaitPromise, che esegue nella pagina un fetch verso un indirizzo di richieste.<sito>.json e ne restituisce il corpo

Provato in locale: gli eventi della rotella inviati con Input.dispatchMouseEvent sono eventi veri e fanno scorrere la pagina; Page.startScreencast consegna i fotogrammi; Network.loadNetworkResource con IO.read ha scaricato integro un file di 40 MB.

Richieste della pagina (strada del 12 novembre, sostituita dal client del sito di §6.0; resta descritta finché il codice non è riscritto). Le regole del fetch della riga «Chiedere i dati alla pagina»:

  • l'indirizzo, il metodo, i nomi dei parametri e delle intestazioni vengono da un modello di richieste.<sito>.json; Febe vi mette solo i valori del caso (nome o identificativo dell'account, cursore della pagina successiva, testo cercato). Un indirizzo che non è nel file non si chiede, e il file si scrive solo da campioni reali (regola 10), ricavati con febe-sonda richieste (§14.5);
  • i valori delle intestazioni che servono al sito (per esempio il gettone contro le richieste contraffatte) si leggono nella pagina, dove la pagina stessa li tiene, al momento della richiesta, e non escono dalla pagina: allo script torna solo il corpo della risposta;
  • solo richieste di lettura: nessuna operazione che cambi qualcosa, anche se il sito la chiamasse con lo stesso metodo;
  • una richiesta per volta, ciascuna un'azione del motore con il permesso del Governatore e il suo tetto (§7.4); la risposta passa ai lettori come quelle catturate (§6.2) e porta gli stessi segnali di arresto (§7.6);
  • il testo dello script, i valori e la risposta non si registrano mai: il client CDP scrive solo «Runtime.evaluate».

Vietati, in coerenza con la regola 2: Network.setUserAgentOverride, tutto il dominio Emulation, Network.setExtraHTTPHeaders, Page.addScriptToEvaluateOnNewDocument, il dominio Fetch, Runtime.evaluate usato per scorrere, cliccare o modificare la pagina, o per richieste diverse da quelle descritte qui sopra. I gesti passano sempre da Input. Se una voce di §6.6 non si risolve senza uno di questi, non aggiungerlo da solo: scrivi l'esito e chiedi ad Alberto.

Il client CDP registra solo i nomi dei comandi e degli eventi, mai parametri e risultati: lì dentro passano tasti, cookie e contenuti.

6.2 Cattura

Un componente ResponseTap ascolta le risposte JSON che la pagina riceve dal sito e le passa ai lettori. Non filtra per indirizzo: riconosce le risposte dalla forma del contenuto (§6.4). Il corpo vive in memoria per il tempo della lettura e non si scrive su disco, tranne in modalità sonda (§14.5).

6.3 Ricette

Una ricetta è una sequenza di azioni con uno scopo. Sono poche e fisse. I passi qui sotto descrivono l'intenzione; i dettagli concreti si definiscono sui campioni.

Per richieste (issue #36, tappa S3). Una ricetta può essere una sequenza di richieste del client del sito (§6.0) invece che di gesti. Ogni operazione di richieste.<sito>.json dice con roles a che cosa serve; un ruolo appartiene a una sola operazione, una ricerca non ne ha, e un ruolo di «pagina successiva» (posts-next, tagged-next, reels-next, highlight-next, following-next) vuole un'operazione con il cursore. La ricetta va per richieste solo se tutti i ruoli della colonna «Per richieste» sono di operazioni configurate; il ruolo fra parentesi serve alle pagine successive e, se manca, la ricetta legge la prima pagina, tiene il punto e lo dice («le pagine successive non sono ancora configurate»); la Raccolta in evidenza non ha punto e la volta dopo ricomincia dalla prima pagina. Ogni richiesta è un'azione con il suo permesso nella categoria di ciò che chiede: la prima pagina dei post conta come profilo (firstPageCategory), le successive come storico. Fra una risposta e la richiesta successiva della stessa ricetta c'è un'attesa di 1–6 s (mediana 2,2 s), fra due pagine di 2–8 s (mediana 3,5 s), con l'8% di probabilità di 15–90 s in più; la prima richiesta della ricetta non aspetta, perché la distanza dal resto la tiene il Governatore (§7.7). Le storie di un account si leggono con una sola richiesta e non risultano viste (§3, decisione del 16 novembre 2026): una richiesta, una «storia vista», senza il controllo del minimo di storie. Mancano ancora i campioni (regola 10) per l'elenco dei seguiti, le pagine successive dei post e le pagine della home: il Giro dei seguiti resta sulle pagine.

Ricetta Che cosa fa Azioni contate Per richieste
Giro dei seguiti Apre la home, legge la barra delle storie e scorre i post recenti dei profili seguiti finché incontra contenuti già noti, con un massimo di 8 raffiche di scorrimento. I post che arrivano con i dati completi si salvano subito 1 home sempre con le pagine
Storie di un account Apre il visualizzatore dal profilo o dalla barra, guarda le storie di quell'account una a una e salva quelle mostrate 1 storia per storia mostrata stories: 1 storia vista per account
Controllo del profilo Apre la pagina del profilo; legge stato, prima pagina dei post, elenco delle raccolte in evidenza; si ferma ai contenuti già noti 1 profilo profile, posts, highlights (posts-next): un profilo per richiesta (sul sito di prova una sola richiesta; con le operazioni separate di Instagram 2, più 1 per l'elenco delle raccolte una volta al giorno), le pagine che colmano il vuoto come storico
Storico Dal profilo scorre all'indietro una pagina per volta e riprende dal punto in cui si era fermato 1 pagina di storico per caricamento posts, posts-next: 1 pagina di storico per pagina, la prima come profilo
Raccolta in evidenza Apre una raccolta e ne guarda i contenuti nuovi 1 storia per contenuto mostrato highlight (highlight-next): 1 storia vista per pagina
Taggati e Reel Come Controllo e Storico, sulle rispettive schede del profilo come sopra tagged (tagged-next), reels (reels-next): 1 azione per pagina nella categoria dell'operazione (sul sito di prova: storico)
Post singolo Apre la pagina di un post: quando la griglia non ha dato tutti i dati, o per recuperare un indirizzo scaduto (§6.5) 1 post post: 1 post
Elenco dei seguiti Apre l'elenco dei profili seguiti da Alberto e lo scorre. Solo su richiesta 1 pagina di elenco per caricamento following (following-next): 1 pagina di elenco per pagina
Ricerca dei profili Solo mentre Alberto scrive nella finestra «Aggiungi account» (§4.2), anche durante una sessione, a turno con il motore fra un'azione e l'altra. Apre «Cerca» e fa clic nella casella; prima di scrivere controlla che il fuoco sia nella casella; scrive con Input.dispatchKeyEvent a ritmo umano solo lettere, numeri, «.», «_» e spazi, e cancella con il tasto di cancellazione; non preme mai Invio, Tab o Esc. Legge la risposta che la pagina riceve (PolarisSearchBoxRefetchableQuery, riconosciuta dalla forma) e non fa mai clic su un risultato, che finirebbe fra le ricerche recenti di Alberto (una scrittura). Fuori sessione, a finestra chiusa o dopo qualche minuto senza lettere nuove, torna alla pagina di riposo 1 ricerca di profili per apertura, clic nella casella e raffica di tasti sempre con le pagine

Regole comuni:

  • Una ricetta chiede il permesso al Governatore prima di ogni azione contata e si interrompe con ordine se non lo ottiene.
  • I contenuti fissati in cima a un profilo non sono «già noti» ai fini dell'arresto: vanno riconosciuti e saltati.
  • Le storie si salvano solo se mostrate nel visualizzatore. Anche quando la pagina riceve in anticipo l'elenco completo, Febe salva quelle che ha effettivamente fatto scorrere. Aprire una storia la segna come vista: è il comportamento voluto (§3). Prima di aprire le storie di un account la ricetta verifica che il tetto ne consenta almeno dieci.
  • Le storie di un account finiscono con quell'account. Dopo l'ultima storia la ricetta chiude il visualizzatore, prima che passi da solo all'account successivo. Se compare comunque una storia di un altro account, non si salva, si chiude e si registra l'accaduto.
  • Lo storico non corre più veloce dei download. Lo storico di un account si sospende finché quell'account ha più di 60 file in attesa di essere scaricati o il tetto dei dati è raggiunto: gli indirizzi scadono, e accumularli non serve.
  • Se a metà ricetta compare un segnale di §7.6, la ricetta si ferma dov'è e lascia la pagina com'è, così Alberto vede che cosa è successo.
  • Per richieste, una risposta 404 con JSON è un «non trovato» per la ricetta (profilo non raggiungibile, raccolta non più nel profilo, post sparito), mai un segnale. Per le storie di un account il «non trovato» non basta a dire «nessuna storia»: la ricetta chiede il profilo (un profilo aperto), come le pagine lo aprono prima del visualizzatore, e un profilo sparito o privato che Alberto non segue rende l'account non raggiungibile (regola 6); altrimenti è un giorno senza storie. Quel 404 non conta come pagina vuota, e una risposta delle storie riconosciuta conta come dati. Un 5xx con JSON, una risposta che non arriva, troppo grande o rovinata fanno fallire la ricetta, che non riprova da sola (H19, da confermare), e contano come pagina vuota: tre di fila sono un Rallentamento. L'elenco delle raccolte in evidenza, quando ha un'operazione sua, si chiede per ultimo (dopo la prima pagina salvata e il vuoto colmato), al più una volta ogni 24 ore per account, sempre in un controllo a mano, mai per un account con «Storie in evidenza» spento; un permesso negato lo rimanda al controllo successivo (da confermare). Una raccolta in evidenza si legge al più per le pagine di una ricetta (3), e i contenuti di ogni pagina si collegano appena letti; l'ordine della raccolta si salva solo letta fino in fondo. Con un punto salvato e senza l'operazione della pagina successiva, Taggati, Reel ed Elenco dei seguiti vanno con le pagine, se le pagine li sanno fare; altrimenti Taggati e Reel leggono la prima pagina per le novità in cima e il punto resta com'è. Il motore, prima di far partire una ricetta, guarda il tetto della sua prima azione su quella strada: per richieste Taggati e Reel cominciano con una pagina di storico, non con un profilo aperto. Il cursore salvato si riprende così com'è (H18): un cursore rifiutato ferma la ricetta per la sua regola, e il punto non si cancella da solo. Un valore che la richiesta vuole e Febe non ha (l'identificativo dell'account, il codice del post) rimanda la ricetta alle pagine, se le pagine la sanno fare, e lo scrive fra gli eventi.

Mappa dei bersagli. Per agire, una ricetta deve trovare poche cose nella pagina: l'immagine del profilo con l'anello delle storie, il comando per chiudere il visualizzatore, la zona per andare avanti, le schede del profilo, l'elenco dei seguiti, il comando «Cerca» e la sua casella (search-open, search-box). Come trovarle sta in un file di configurazione per sito (bersagli.instagram.json, bersagli.prova.json), non nel codice: ruolo dell'elemento, nome accessibile, forma del collegamento. Mai coordinate fisse, mai nomi di classi generate. Il file si aggiorna senza ricompilare, ed è la seconda cosa da ritoccare, dopo i lettori, quando Instagram cambia.

6.4 Lettori

Un lettore trasforma una risposta in oggetti del dominio (Entry, Media, Account, Highlight).

  • Riconosce i dati dalla forma, non dall'indirizzo né da percorsi fissi: cerca nell'albero JSON i nodi che hanno l'aspetto di un contenuto (identificativo, data, versioni dell'immagine o del video, eventuali figli) ovunque si trovino. In passato le risposte del sito hanno usato chiavi come pk, code, taken_at, image_versions2.candidates, video_versions, carousel_media: prendilo come indizio su che cosa cercare, non come schema. Vale la regola 10.
  • Ogni lettore ha le sue prove su campioni ripuliti in tests/campioni/.
  • Davanti a una forma sconosciuta un lettore non fallisce in silenzio: registra un evento «formato non riconosciuto» con la sola struttura delle chiavi, senza valori. Dopo tre casi consecutivi per la stessa ricetta, quella ricetta si sospende e l'interfaccia lo dice. È il modo in cui Febe si accorge che Instagram è cambiato.
  • Quando succede, il rimedio è: Alberto riattiva la modalità sonda, raccoglie un campione nuovo, tu aggiorni il lettore e le sue prove sulla copia ripulita.

6.5 Scaricare i file

La pagina mostra versioni ridotte; gli indirizzi delle versioni migliori sono nelle risposte e scadono dopo qualche tempo.

  1. Si sceglie la versione più grande per le immagini e, per i video, la migliore fra quelle complete di audio.
  2. Con il browser aperto: il browser stesso, con Network.loadNetworkResource e lettura a blocchi con IO.read.
  3. Senza browser, la via principale dal 16 novembre 2026 (§6.0, tappa S5 di #36): HttpClient verso i soli domini del CDN presenti nell'indirizzo ricevuto, mai verso instagram.com, senza seguire rinvii fuori dal CDN. Senza cookie, con l'user agent della sessione salvata. Se il CDN la rifiuta, il file resta in attesa e l'interfaccia lo dice.
  4. Il file si scrive con un nome temporaneo, se ne calcola lo SHA-256 e lo si rinomina. Uno scaricamento interrotto non lascia mai un file con il nome definitivo.
  5. Se l'indirizzo è scaduto, il file torna «da scaricare». Il recupero passa dalla ricetta Post singolo, che rilegge il post e ne ottiene uno nuovo, dentro il suo tetto. Per le storie non c'è recupero dopo la scadenza.
  6. Coda dedicata, al massimo due scaricamenti insieme, piccole pause casuali, tetto giornaliero sui dati. Le storie hanno la precedenza, perché scadono.

6.6 Ipotesi da provare in M0

Finché una voce non ha un esito scritto in docs/sonda/esito.md, non costruirci sopra. Le voci H riguardano Instagram e si provano con la sonda passiva (§14.5): Alberto naviga a mano, la sonda guarda. Le voci S riguardano i due browser e si provano con prove usa e getta sulla pagina locale del sito di prova, più l'accesso fatto a mano da Alberto.

Ipotesi
H1 La home, ed eventualmente la vista dei soli seguiti in ordine di tempo, consegna i post recenti dei profili seguiti con i dati completi dei file
H2 La barra delle storie dice quali profili seguiti hanno storie attive e a quando risale l'ultima
H3 La pagina di un profilo consegna identificativo, pubblico o privato, se Alberto lo segue, prima pagina dei post con i file delle serie e le versioni video, elenco delle raccolte; lo scorrimento carica le pagine successive
H4 Aprendo il visualizzatore arriva l'elenco delle storie dell'account con gli indirizzi dei file, e si capisce qual è l'ultima
H5 Per i video arriva almeno un indirizzo unico con audio e video insieme
H6 Le schede «taggati» e «reel» si comportano come la griglia principale
H7 I file del CDN si scaricano con Network.loadNetworkResource; se no, con la via di riserva di §6.5
H8 I segnali di arresto di §7.6 si riconoscono da indirizzo e stato HTTP
H9 Un contenuto di una raccolta in evidenza ha lo stesso identificativo che aveva come storia
H10 Identificativo e nome dell'account collegato si ricavano dai dati che la pagina riceve, senza leggere i cookie
H11 I bersagli delle ricette si trovano con attributi stabili: ruolo, nome accessibile, forma del collegamento (superata dal client del sito, §6.0)
H12 Una sessione copiata dal browser e usata dal client HTTP di .NET, dalla stessa rete, è accettata senza verifiche
H13 Quanto durano fb_dtsg, lsd e x-ig-www-claim, e se il sito rinnova i cookie con Set-Cookie
H14 I doc_id restano uguali fra una versione e l'altra dell'applicazione web: uguali dal 12 al 16 novembre 2026 per 17 operazioni (#35)
H15 Le richieste sono accettate con i soli campi di versione letti all'accesso, senza i campi che la pagina calcola a ogni richiesta (__req, __csr, __dyn, __s)
H16 Che cosa risponde il sito a una sessione scaduta o da verificare: rinvio, stato, campi del JSON (la ricerca su internet indica login_required, checkpoint_required e require_login, non verificati)
H17 Il CDN dà i file a una richiesta senza cookie con l'user agent della sessione
H18 I cursori sono gli stessi per pagine e richieste: un punto salvato dalle pagine si riprende con una richiesta, e viceversa
H19 Un 404 con JSON vuol dire risorsa assente, un 5xx errore temporaneo: la ricetta non insiste e si riprova al giro dopo (da confermare, Alberto)
H20 Una raccolta in evidenza si chiede con l'identificativo che il profilo dà nell'elenco delle raccolte, così com'è (sul sito di prova sì; su Instagram potrebbe servire il prefisso highlight:)
H21 Su Instagram require() dei moduli della sezione page (§6.0), chiesto dalla copia a «Ho finito», non ha effetti: non esegue la fabbrica di un modulo non ancora avviato che faccia qualcosa, e un modulo assente non fa partire dalla pagina una segnalazione d'errore verso il sito. Finché non è verificata (con Alberto), con Instagram la copia non si accende (§6.0, «raccolta»)
H22 Sulla pagina dove Alberto preme «Ho finito» (di solito la pagina iniziale) i moduli dei doc_id delle operazioni del catalogo (<Operazione>_instagramRelayOperation) e i moduli dei valori sono già caricati; se no, quali pagine li caricano. Un doc_id assente manca nella sessione salvata e la richiesta che lo vuole non parte
S1 In WebView2 funzionano attraverso CDP il corpo delle risposte, i gesti e i fotogrammi della pagina
S2 Su Windows la pagina continua a caricare e a rispondere allo scorrimento quando la finestra del browser non è in vista
S3 L'accesso fatto a mano sopravvive al riavvio del programma, in Docker e su Windows
S4 In Docker, con la vista remota, si riesce a scrivere in un modulo e a navigare con un ritardo sopportabile
S5 Chromium in Docker parte con la sua sandbox attiva; altrimenti quale compromesso serve (§11)
S6 Che cosa vede una pagina nei due browser: navigator.webdriver, visibilità, fuoco, lingua, fuso orario. Va scritto nell'esito, per sapere che cosa il browser dichiara

Per S2 prova nell'ordine: finestra del browser separata, tenuta aperta ma fuori vista, con il rilevamento dell'occlusione disattivato dagli argomenti del browser; poi l'ospitalità a composizione di WebView2; infine il ripiego di avviare Edge come processo con ChromiumProcessHost anche su Windows. Verificato: se IsVisible del controllo va a falso, WebView2 smette di disegnare e rallenta la pagina, quindi quella proprietà deve restare vera.


7. Il motore: ritmo umano, tetti, arresti

7.1 Principio

Febe non cerca di sembrare un utente qualsiasi: cerca di comportarsi come Alberto che usa Instagram dal suo computer. Stesso dispositivo, stessa rete, stessi orari plausibili, poche visite brevi, pause lunghe, nessuna fretta. La casualità riguarda il comportamento (quando, quanto, in che ordine, a che velocità); l'identità del browser non cambia mai.

Nessuno può garantire che basti. Per questo il motore ha tre livelli indipendenti: un ritmo credibile (§7.2, §7.7), tetti rigidi che valgono anche quando il ritmo sbaglia (§7.4), e un interruttore che ferma tutto al primo segnale (§7.6).

7.2 Giornata, sessioni, pause

  • Fascia oraria e giorni. Febe lavora solo dentro una fascia giornaliera, con inizio e fine spostati ogni giorno di una quantità casuale, e solo nei giorni della settimana attivi (tutti, per impostazione predefinita). Fuori fascia il motore non apre nulla di sua iniziativa; l'unica eccezione è un comando manuale confermato da Alberto (§7.8).
  • Sessioni. Dentro la fascia l'attività è fatta di sessioni brevi separate da pause. Durata della sessione e lunghezza della pausa si estraggono ogni volta da una distribuzione log-normale tagliata sugli estremi del profilo. Mai una distribuzione uniforme, mai intervalli fissi.
  • Pavimento. La pausa minima vale sempre, anche con molto lavoro arretrato. L'arretrato si smaltisce nei giorni, non stringendo le pause.
  • Avvio. Dopo l'avvio del programma la prima sessione parte dopo un'attesa casuale fra 2 e 10 minuti. Tetti e registro delle azioni sono su disco: un riavvio non azzera nulla. Un programma che riparte più volte non deve produrre più traffico di uno che resta acceso.
  • Composizione. Una sessione comincia di norma con il Giro dei seguiti, prosegue con le storie segnalate, poi con i controlli di profilo scaduti, infine con qualche pagina di storico. Non tutte le sessioni fanno tutto: circa una su tre si limita al giro e alle storie. L'ordine degli account è estratto a caso con pesi, mai lo stesso.
  • Umore della sessione. Ogni sessione ha un fattore di velocità estratto una volta, che moltiplica tutte le attese: alcune sessioni sono svelte, altre lente.
  • Riposo. A fine sessione il browser torna alla pagina vuota (§6.1).
  • Avvio graduale. Se attivo (lo è per impostazione predefinita), nei primi giorni dopo il collegamento e dopo ogni verifica risolta i tetti partono dalla metà e risalgono in modo lineare fino al valore pieno, nel numero di giorni previsto dal profilo.

Parametri delle estrazioni:

Che cosa Distribuzione
Un intervallo «da a a b» (durate, pause, attese) Log-normale con mediana √(a·b) e σ = ln(b/a)/4, tagliata su [a, b]. Dove è indicata una mediana si usa quella
Umore della sessione Log-normale, mediana 1, σ 0,2, tagliata fra 0,7 e 1,5
Scostamento del prossimo controllo Intervallo × log-normale con mediana 1, σ 0,25, tagliata fra 0,6 e 1,8
Peso di un account nella scelta (Alta 3, Normale 2, Bassa 1) × (1 + ritardo ÷ intervallo), con il rapporto limitato a 3
Distanza minima fra due azioni contate 4 secondi con il ritmo «naturale»

7.3 Frequenze

La frequenza di un account esprime un desiderio; il Governatore decide che cosa è possibile.

Frequenza Profilo non seguito: controllo Profilo seguito: riconciliazione Storie: intervallo massimo
Bassa ogni 12 ore circa ogni 24 ore 8 ore
Normale ogni 3 ore circa ogni 12 ore 6 ore
Alta ogni 75 minuti circa ogni 6 ore 3 ore
  • I profili seguiti si scoprono con il Giro: il controllo diretto del profilo serve solo come riconciliazione, per ciò che il giro può aver perso.
  • Le storie durano 24 ore: con «Storie» attivo ogni account riceve almeno tre controlli al giorno dentro la fascia, qualunque sia la frequenza.
  • Lo storico avanza su un solo account per sessione. Più account possono essere «Storico in corso» nello stesso periodo: si alternano, ciascuno fino al suo massimo giornaliero.

7.4 Governatore e tetti

Il Governatore è l'unico punto da cui passa un'azione del motore verso il sito. Per ogni richiesta controlla, nell'ordine: stato dell'interruttore, fascia oraria, sessione in corso, tetto orario e giornaliero della categoria, distanza minima dall'azione precedente, limiti propri dell'account. Risponde con un permesso o con un rifiuto motivato, che finisce nell'interfaccia.

  • I tetti orari valgono su una finestra mobile di 60 minuti; quelli giornalieri sul giorno di calendario nel fuso di Alberto.
  • Il conteggio sta nella tabella action_log, non in memoria.
  • Categorie: home, profili aperti, storie viste, pagine di storico, post singoli, pagine dell'elenco dei seguiti, dati scaricati, ricerche di profili. Ogni richiesta del client del sito (§6.0) è un'azione e conta nella categoria di ciò che chiede: un permesso per richiesta, mai uno per più richieste. Ricalcolati con la tappa S3 di #36: una richiesta delle storie è una sola «storia vista» per tutte le storie dell'account (§7.5); le altre categorie contavano già una pagina per caricamento. Nessun tetto cambia con S3.
  • Ricerche di profili (issue #37) hanno tetti propri e larghi (§7.5), che fanno da guardia e non devono mai fermare l'uso normale, e non consumano i tetti della raccolta. Non chiedono una sessione e non contano fra le azioni della sessione. L'ordine dei controlli: interruttore (ogni segnale di §7.6 ferma anche la ricerca), browser in uso da Alberto, pausa, fascia oraria, tetto orario e giornaliero proprio, distanza propria fra due passi della ricerca (1,2 s per il ritmo), 1,2 s di distanza dalle azioni del motore in entrambi i versi. Le riduzioni (avvio graduale, tetti dimezzati) valgono anche qui. Le foto dei risultati contano fra i dati scaricati.
  • Sopra l'80% di un tetto l'interfaccia lo segnala in ambra. Raggiunto il tetto, quella categoria si ferma fino all'ora o al giorno dopo; le altre proseguono, salvo la regola sullo storico di §6.3.
  • Quando valgono insieme più riduzioni (avvio graduale, tetti dimezzati dopo un rallentamento) si applica la più forte, non il loro prodotto.

7.5 Profili di prudenza

I valori sono stime di partenza scelte con prudenza. Non sono limiti ufficiali, che Instagram non pubblica, e non sono misure. Vanno ritoccati guardando che cosa succede, e l'interfaccia deve dirlo con le stesse parole (mockup 07).

Prudente Equilibrato Rapido
Fascia oraria 07:30–23:30, ± 40 min 07:00–24:00, ± 30 min 06:30–00:30, ± 30 min
Durata di una sessione 2–10 min 3–14 min 4–18 min
Pausa tra le sessioni 20–90 min 12–60 min 8–40 min
Home, all'ora / al giorno 4 / 30 5 / 45 6 / 60
Profili aperti 12 / 100 20 / 180 30 / 300
Storie viste 50 / 300 80 / 500 120 / 800
Pagine di storico 20 / 100 30 / 180 45 / 300
Post singoli 10 / 60 15 / 100 20 / 160
Pagine dell'elenco dei seguiti 15 / 60 20 / 90 30 / 150
Ricerche di profili 240 / 1200 300 / 1500 360 / 1800
Dati scaricati al giorno 4 GB 8 GB 16 GB
Storico per account al giorno 300 post 500 post 800 post
Avvio graduale 7 giorni 5 giorni 3 giorni
  • «Prudente» è il predefinito. «Rapido» chiede conferma e mostra l'etichetta «Più rischio». Se Alberto modifica un valore, il profilo diventa «Su misura».
  • «Storie viste» conta una storia mostrata con il browser o una richiesta del client del sito (una per account, §6.3). Con la tappa S3 di #36 i valori non cambiano, perché valgono anche per le storie mostrate con il browser e per un «Su misura» già salvato: con Instagram Febe va ancora per pagine. Da decidere (Alberto) prima che Instagram passi alle richieste (S4): se dimezzarli (25 / 150, 40 / 250, 60 / 400), dato che una richiesta porta tutte le storie di un account, e il nome («storie viste» o «richieste di storie»). Le simulazioni di 30 giorni non superano mai i tetti, per pagine e per richieste (§14.3). Quando Instagram passerà alle richieste (S4) un controllo del profilo costerà due profili aperti (profilo e griglia sono due operazioni), più l'elenco delle raccolte una volta al giorno: da confermare se raddoppiare «Profili aperti» o accettare meno controlli. La simulazione di 30 giorni con quel costo (--raccolta richieste, §14.3), con «Prudente»: profili aperti sempre al tetto (100 al giorno, 12 all'ora), storico di 2.000 post in 27 giorni invece di 10, post dei non seguiti scoperti in 7 ore e mezza invece di 4 e un quarto, 11 storie su 1.472 scadute senza essere viste (nessuna per pagine); nessun superamento dei tetti.
  • «Storico per account al giorno» è il valore di partenza del limite che ogni account ha nelle proprie impostazioni (§4.4).
  • Limiti di ciò che l'interfaccia accetta: pausa minima non sotto i 5 minuti; sessione non oltre i 30; fascia non oltre le 20 ore; nessun tetto oltre il doppio di «Rapido».

7.6 Segnali e arresti

L'interruttore riceve segnali dalle ricette, dalla cattura e dal client del sito. L'elenco di partenza sta in un file di configurazione (segnali.json), così si aggiorna senza ricompilare; va completato dopo M0 (H8, H16).

Per il client del sito (§6.0) sono segnali anche: un rinvio (3xx) verso le pagine d'accesso, di verifica, di controllo o di sospensione, che non si segue mai; gli stati 401 e 403; un documento HTML dove il modello aspetta JSON; un JSON senza i campi attesi; un Set-Cookie che cancella il cookie di sessione. Finché le forme vere delle risposte di sessione scaduta o da verificare non sono note (H16), questi casi valgono come Verifica: Febe si ferma, avvisa, e decide Alberto se rifare l'accesso. Un 404 o un 5xx con un JSON non è un segnale: lo legge la ricetta (§6.3). Il segnale ferma la ricetta prima di qualunque altra richiesta, e la risposta che l'ha portato non va ai lettori.

Livello Segnali Che cosa fa Febe
Rallentamento Risposta con stato 429; risposta che chiede di attendere qualche minuto; pagine o risposte vuote ripetute Chiude subito la sessione. Fermo 1 ora la prima volta, 6 ore la seconda nelle 24 ore, 24 ore la terza. Poi tetti dimezzati per 48 ore
Verifica Navigazione verso pagine di verifica, controllo o sospensione; avviso di comportamento automatico; richiesta di confermare l'identità Ferma tutto e non riparte da solo. Striscia rossa, notifica, pagina lasciata com'è
Disconnessione La pagina torna all'accesso; il cookie di sessione non c'è più; la sessione salvata manca o il sito la rifiuta Come Verifica. Non tenta mai di rientrare
  • Le durate dei fermi sono fisse: nella versione 1 non si modificano dall'interfaccia.
  • Dopo Verifica o Disconnessione riparte solo quando Alberto ha sistemato a mano nel browser e ha premuto «Riprendi». La ripresa comincia con l'avvio graduale.
  • Durante un fermo gli scaricamenti già in coda dal CDN si completano; verso il sito non parte nulla.
  • Ogni arresto finisce nella tabella incident con data, livello, segnale e indirizzo, e nella cronologia della pagina Attività.
  • Tre rallentamenti in sette giorni: Febe propone di passare al profilo più prudente o di ridurre gli account.

7.7 Il ritmo dei gesti

Tutte le attese seguono le distribuzioni di §7.2, moltiplicate per l'umore della sessione e per il cursore «Ritmo dei gesti» (lento, naturale, svelto). I numeri che seguono sono il punto di partenza per «naturale».

Gesto Come
Dopo il caricamento di una pagina Attesa con mediana di 2,2 s (da 1 a 6) prima del primo gesto
Scorrimento Raffiche di 3–8 eventi della rotella da 80–140 pixel, a 12–40 ms l'uno dall'altro, con velocità che cala. Fra una raffica e l'altra mediana di 1,1 s (da 0,4 a 4). Ogni 6–10 raffiche una sosta di lettura con mediana di 6 s (da 3 a 20). Ogni tanto un piccolo ritorno indietro
Puntatore Dal punto in cui si trova al bersaglio lungo una traiettoria leggermente curva, in 250–900 ms, con partenza e arrivo morbidi. Arrivo in un punto casuale dentro la parte centrale dell'elemento, mai al centro esatto
Clic Sosta di 80–300 ms sul bersaglio, pressione e rilascio a 50–140 ms di distanza
Storie Foto: da 1,8 a 5 s, poi avanti con un clic o lasciando scorrere. Video: dal 40 al 100% della durata, con un massimo di 15 s. Fra un account e l'altro da 1 a 4 s
Distrazioni Con probabilità dell'8% dopo un'azione, un'attesa in più fra 15 e 90 s

Regole: il puntatore non salta mai da un punto all'altro; non si clicca nulla che non sia il bersaglio di una ricetta; se il bersaglio non si trova con la mappa di §6.3, la ricetta si ferma e segnala, non tenta coordinate a caso.

7.8 Comandi manuali

«Controlla ora» su un account mette quel controllo in cima alla coda. Passa comunque dal Governatore: se il tetto è esaurito Febe lo dice e non lo fa. Se si è fuori fascia chiede conferma e, avutala, esegue quel solo controllo: è l'unico caso in cui il motore agisce fuori fascia, perché in quel momento Alberto è presente. «Metti in pausa» ferma il motore finché non si preme «Riprendi».

7.9 Che cosa deve vedere Alberto

La pagina Attività (mockup 06 e 11) è il cruscotto del motore: che cosa sta facendo adesso, la striscia della giornata con sessioni, riposo, rallentamenti e arresti, i quattro tetti principali con i numeri (profili aperti, storie viste, pagine di storico, dati scaricati) e, da «Tutti i tetti», anche gli altri; la coda con orari indicativi, le ultime azioni con l'esito. Gli orari futuri si scrivono sempre come «verso le», perché sono estratti a caso.

Rapporto di diagnostica. Dopo una prova dal vivo andata storta, Alberto deve poter mandare un solo file che spieghi perché, senza che nessuno apra i dati di altre persone. «Esporta il rapporto di diagnostica» (pulsante «Diagnostica» nella riga del titolo di Attività) scarica febe-diagnostica-aaaa-mm-gg.json: per ogni sessione del motore delle ultime due settimane, e per ogni giorno fuori dalle sessioni, le pagine aperte (il nome della pagina nella mappa del sito e la sua forma, mai l'indirizzo), le risposte ricevute per tipo con numero e misure, che cosa ne hanno fatto i lettori (riconosciute, vuote, ignorate, forma sconosciuta con la sola struttura delle chiavi, in cui resta solo una chiave fatta di parole di un elenco chiuso, preso dai campioni ripuliti e dai vocabolari dei lettori, mai di sole parole che sono anche nomi come «max_mark», e ogni altra diventa #; diventano # anche le voci di una mappa, cioè le chiavi sorelle con valori della stessa forma, salvo quelle che i lettori conoscono come user e owner), i bersagli cliccati, le ricette con l'esito (e, per un errore imprevisto, il solo tipo dell'eccezione), i segnali di §7.6 per livello e codice, i rifiuti del Governatore, i file messi in coda e scaricati (per un file fallito o da riprovare, la causa da un elenco chiuso, come http-404), e la causa di ogni fine (fine prevista, lavoro finito, tetti esauriti, ricetta che ferma, interruttore aperto, pausa, Alberto al browser, chiusura di Febe, errore). Mai cookie, password, gettoni, corpi delle risposte, nomi utente, didascalie, codici dei post, identificativi, indirizzi interi o testi liberi (messaggi, note, eccezioni): solo valori di elenchi chiusi, conteggi, misure, orari e forme degli indirizzi in cui ogni parte che non è una parola fissa del sito è {numero} o {testo}; per il CDN solo «cdn» e l'estensione del file. Le tracce finite stanno in Dati/diagnostica/sessioni-aaaa-mm-gg.jsonl, una riga per sessione, e si tengono 14 giorni (Febe cancella da sé solo i file più vecchi di quella cartella); le sessioni in corso entrano nel rapporto come «in corso». Una sessione scrive una riga «in corso» quando parte e poi al più ogni 5 minuti alla fine di una ricetta, così una chiusura brusca di Febe non la cancella; leggendo, di una sessione resta la riga finita, altrimenti l'ultima. I segnali entrano anche quando arrivano all'interruttore senza passare dal rilevatore (il cookie di sessione perso), e i file in attesa perché manca la connessione hanno la causa connessione. La testa del file dice che cosa sicuramente manca: righe del registro rovinate (righeRovinate), errori del registratore, scritture non riuscite comprese (erroriRegistratore), file di un giorno che non si sono potuti leggere (fileIlleggibili) e sessioni rimaste senza fine per una chiusura brusca (sessioniSenzaFine). Anche a zero il rapporto non promette di essere intero: gli ultimi minuti di una chiusura brusca, le ore fuori dalle sessioni del giorno e quello che supera i tetti (contato in overflow) possono mancare. Le forme delle pagine della mappa del sito passano per la stessa riduzione degli indirizzi, perché la mappa può venire dalla cartella dei dati. Con un problema di configurazione il motore non parte: l'indirizzo del rapporto risponde lo stesso, con gli elenchi vuoti. Una prova dimostra che nessun valore dei dati arriva nel file.


8. Dati: database e file

8.1 File o database: la valutazione

Solo file (JSON) SQLite più file PostgreSQL più file
«C'è già questo contenuto?» su 200.000 elementi Lento, tutto in memoria Immediato, con indici Immediato
Coda, tetti e registro che sopravvivono a un'interruzione Fragile Transazioni Transazioni
Filtri e ricerca nell'interfaccia Da scrivere a mano SQL SQL
Installazione Nulla Nulla: un file Un servizio in più, anche sul desktop
Uguale in Docker e su Windows Sì Sì No
Libreria leggibile senza il programma Sì Sì: i file restano file Sì

Scelta: SQLite per l'indice e lo stato, file normali per i contenuti. Il database non contiene immagini. La libreria resta una cartella di file con nomi parlanti, utilizzabile anche senza Febe, e ogni cartella di account porta con sé i propri metadati (§8.5), così il database si può ricostruire. PostgreSQL servirebbe solo con più utenti o più istanze sugli stessi dati, che non è il caso.

8.2 Dove stanno le cose

Dati\
  febe.sqlite            database (modalità WAL)
  browser\               profilo del browser: contiene la sessione di Instagram
  miniature\             anteprime ridotte
  copie\                 copie giornaliere del database
  registro\              log a rotazione
  segnali.json           segnali di arresto
  bersagli.*.json        mappa dei bersagli
Libreria\
  <account>\ ...         foto e video
  <account>\_febe.jsonl  metadati dell'account, una riga per elemento

La cartella dei dati deve stare su un disco locale: SQLite in modalità WAL e il profilo del browser non reggono le condivisioni di rete (Verificato per WebView2 nella documentazione Microsoft). All'avvio Febe controlla: se trova un percorso di rete il motore non parte, e l'interfaccia mostra solo la pagina che spiega il problema. Chi ha accesso alla cartella dei dati ha accesso alla sessione di Instagram: va detto nella guida e vale anche per le copie.

8.3 Schema

Tabelle principali. Completa colonne e indici dove serve, ma non cambiare i concetti.

Tabella Contenuto
setting Chiave e valore
account Identificativo Instagram, nome utente, nome visibile, privato, seguito, è il mio, stato, tieni aggiornato, frequenza, tipi da scaricare, limiti, cartella, punto di ripresa dello storico, ultimi e prossimi controlli
entry Un elemento: account, tipo (§4.3), identificativo e codice Instagram, data di pubblicazione in UTC, didascalia, autore (per i taggati), stato, provenienza, date di scoperta e di scaricamento
media Un file di un elemento: posizione, foto o video, dimensioni, durata, stato, percorso relativo, byte, SHA-256, impronta visiva, tentativi, ultimo errore
highlight, highlight_entry Raccolte in evidenza di un account e loro contenuti, in ordine. Un elemento può stare in più raccolte
duplicate_pair Coppie di file «doppione probabile» in attesa della decisione di Alberto, da importazione o da scaricamento
task Coda del motore: tipo, account, scadenza, priorità, stato
action_log Una riga per azione verso il sito: quando, categoria, account, sessione. È la base dei tetti
session Inizio, fine, numero di azioni, esito. Alimenta la striscia della giornata
incident Arresti: quando, livello, segnale, indirizzo, fermo fino a, risolto il
event Cronologia leggibile per l'interfaccia
following Copia locale dell'elenco dei profili seguiti, con data di lettura
import_run, import_file Importazioni e loro file, con esito e decisione

Vincoli che contano:

  • entry è unico per (account, tipo, identificativo Instagram); media per (elemento, posizione). Lo stesso post può comparire sotto due account, come post di uno e come taggato di un altro: sono due elementi e due copie dei file.
  • Stati di un elemento: da scaricare, scaricato, parziale, fallito, saltato, importato, eliminato. «Eliminato» resta nel database senza file, perché non venga riscaricato (§4.6).
  • Indici su (account, data di pubblicazione), SHA-256, impronta, stato.
  • Versione dello schema in PRAGMA user_version, migrazioni come file SQL numerati eseguiti all'avvio dentro una transazione. Un solo scrittore: le scritture passano da una coda.

8.4 Miniature e impronte

  • Miniatura di 480 pixel sul lato lungo per ogni immagine; per i video si usa la copertina che arriva dalla pagina e, per quelli importati, un fotogramma estratto con ffmpeg se presente, altrimenti una tessera neutra.
  • SHA-256 del file per i doppioni esatti.
  • Impronta visiva a 64 bit per le immagini, per riconoscere la stessa foto salvata a risoluzione o compressione diversa. Le impronte stanno in memoria: il confronto di una foto con 200.000 è questione di millisecondi.

8.5 Copie e ricostruzione

  • Copia giornaliera del database con VACUUM INTO verso un file nuovo con la data nel nome, in Dati\copie; si tengono sette giorni.
  • In ogni cartella di account il file _febe.jsonl riceve una riga per ogni elemento salvato (identificativi, date, didascalia, nomi dei file) e una riga per ogni eliminazione. Si aggiunge in coda e non si riscrive.
  • Comando di manutenzione «Ricostruisci il database dalla libreria»: rilegge cartelle e file _febe.jsonl, ricalcola hash e impronte, rispetta le eliminazioni. Deve bastare a ripartire dopo la perdita del database, senza riscaricare nulla.

9. Importazione

Serve a portare in libreria foto e video che Alberto ha già, anche di contenuti che su Instagram non esistono più, senza creare doppioni e senza toccare gli originali finché lui non decide.

9.1 Flusso

Quattro passi, mostrati in alto nella pagina (mockup 09):

  1. Sorgente. Su Windows si sceglie una cartella; in Docker una sottocartella del volume /importa.
  2. Analisi. Sola lettura: nessun file viene copiato o spostato. Si può interrompere e riprendere.
  3. Revisione. Alberto vede il riepilogo, associa le cartelle agli account, decide sui doppioni probabili.
  4. Copia. Copia o spostamento con verifica, poi resoconto.

9.2 Analisi

Per ogni file: tipo dal contenuto e non solo dall'estensione; byte; SHA-256; dimensioni; impronta visiva per le immagini; data, cercata nell'ordine nel nome del file, nei metadati del file (data di scatto delle foto, data di creazione dei video), nella data di modifica; identificativo o codice Instagram, se il nome lo contiene; account probabile, dal nome della cartella; tipo probabile (storia, evidenza, taggato) dalle sottocartelle. La lettura dei metadati si scrive a mano per i pochi campi che servono, oppure si usa ffprobe dove è presente.

9.3 Confronto con la libreria

Esito Criterio Che cosa succede
Già in libreria Stesso SHA-256 di un file presente in qualunque account Saltato. Il resoconto dice in quale account si trova
Doppione probabile Stesso identificativo Instagram con file diverso, oppure impronta visiva molto vicina. Si cerca prima nell'account di destinazione, poi nel resto della libreria Alberto decide: tenere il più grande, tenere quello in libreria, tenerli entrambi. Può applicare la scelta a tutti i casi simili
Nuovo Nessuna corrispondenza Verrà copiato
Non riconosciuto Né foto né video Ignorato ed elencato

I doppioni si cercano anche dentro la sorgente stessa. Le soglie dell'impronta si tarano con le prove di §14.1 su varianti costruite apposta: ridimensionata e ricompressa deve risultare doppione, ritagliata no. Per i video vale solo lo SHA-256. «Tenere il più grande», quando il più grande è quello importato, sostituisce un file della libreria: è una scelta esplicita di Alberto, come chiede la regola 12.

9.4 Associazione e copia

  • Una tabella lega ogni cartella sorgente a un account: uno esistente, oppure uno nuovo «Solo archivio». Una cartella senza account blocca solo i propri file: il pulsante finale dice quanti ne importa e quanti restano fuori.
  • Predefinito Copia. Con Sposta l'originale si elimina solo dopo che la copia è stata verificata con lo SHA-256. Se la sorgente è in sola lettura, come il volume /importa di Docker, «Sposta» non compare.
  • Mai sovrascrivere. I file con data e codice noti prendono il nome secondo lo schema della libreria; gli altri vanno in {account}\importati\ con il nome originale.
  • Ogni file ha il suo esito nel database: un'importazione interrotta riprende da dove era.
  • Alla fine: resoconto a schermo ed esportazione CSV.

9.5 Dopo l'importazione

Gli elementi importati contano come presenti. Quando Febe tiene aggiornato quell'account non li riscarica se li riconosce dall'identificativo, oppure da account, tipo e data di pubblicazione entro due secondi. Se non li riconosce prima, li riconosce dopo lo scaricamento:

  • file appena scaricato identico (stesso SHA-256) a uno già presente nello stesso account: il nuovo file si scarta prima di entrare in libreria, e i dati di Instagram (identificativo, didascalia) si aggiungono all'elemento esistente;
  • file visivamente uguale ma diverso: restano entrambi, e la coppia va in duplicate_pair per la decisione di Alberto. Nessuna sostituzione automatica.

9.6 Librerie di 4K Stogram

È probabile che la sorgente principale sia una libreria di 4K Stogram. Verificato: nella cartella di uscita di 4K Stogram ci sono i file stogram.sqlite, stogram.app.sqlite e stogram.sqlite.backup. Ipotesi, da un ricordo non verificato: una sottocartella per account e nomi del tipo AAAA-MM-GG HH.MM.SS <id contenuto>_<id utente>.jpg, con sottocartelle per storie, evidenza e taggati.

Prima di scrivere il riconoscitore chiedi ad Alberto una ventina di righe dell'elenco dei file di una cartella vera, con i nomi degli account sostituiti (domanda 4 di §16), e, se è d'accordo, il solo schema di stogram.sqlite, senza dati. Se quel database lega i file ai post, usalo in sola lettura per recuperare didascalie e identificativi. Scrivi il riconoscitore sui dati veri, con prove.


10. Interfaccia e grafica

10.1 Direzione

Semplice e moderna, con una ragione dietro ogni scelta:

  • Le foto portano il colore, l'interfaccia resta in grigio neutro. Come nei programmi di fotoritocco, i grigi non hanno dominante, così i colori delle immagini non vengono falsati. Niente sfumature decorative, niente richiami alla grafica di Instagram.
  • Un solo accento, un blu cianotipo, per l'azione principale, la selezione e le sessioni del motore. Verde, ambra e rosso servono solo a dire uno stato, sempre accompagnati da testo o numero.
  • Un solo carattere, Archivo, in due larghezze: normale per l'interfaccia, più stretta con cifre tabellari per i dati (date, numeri, nomi di file).
  • Raggi che crescono con l'importanza: 3 per le tessere, 7 per i controlli, 10 per i pannelli, 14 per le finestre di dialogo. Ombre solo su menu e dialoghi; il resto si separa con linee sottili.
  • Elenchi e tabelle, non mosaici di riquadri uguali. Un pannello si usa quando raggruppa davvero qualcosa.
  • La striscia della giornata è l'elemento che distingue Febe: una barra di 24 ore con le sessioni come tratti irregolari. Il resto le sta intorno in silenzio.

Token di colore, misure e CSS di partenza sono nell'appendice B e nel mockup 13. I nomi dei token restano quelli.

10.2 Ossatura

Barra laterale fissa di 228 pixel: marchio, quattro voci (Libreria, Account, Attività, Importa), separatore, Impostazioni. In fondo il riquadro di stato, sempre visibile: stato del motore, una riga su che cosa sta facendo o quando riprende, misuratore dei profili aperti oggi, account collegato. A destra la pagina: titolo, eventuale riga di strumenti, contenuto che scorre. Le azioni che salvano stanno in una barra fissa in basso.

10.3 Schermate

Ogni riga è un file in docs/mockup/. I dati sono inventati: gli account che finiscono in .demo non esistono e le fotografie sono disegni generati. Segui le immagini per disposizione, proporzioni e gerarchia. I loro contenuti non vanno nel codice dell'interfaccia: stanno solo nei dati della modalità dimostrativa (§10.6).

File Schermata Ciò che l'immagine non dice
00-panoramica.png Tutte le schermate insieme Serve a orientarsi
01-libreria.png Libreria Righe giustificate che rispettano le proporzioni delle foto, 4 px fra le tessere. Segni in alto a destra: durata per i video, numero dei file per i post con più file, anello tratteggiato per le storie. I menu Account, Periodo e Provenienza mostrano il nome del filtro finché non si sceglie un valore. Il cursore accanto a «Seleziona» regola la grandezza delle tessere. Al passaggio del mouse: account, ora, cerchio di selezione. I nuovi elementi compaiono in cima senza spostare ciò che si sta guardando
02-visualizzatore.png Visualizzatore Copre tutta la finestra. Frecce e tasti freccia; Esc chiude. I video partono senza audio. Nel browser «Mostra nella cartella» diventa «Scarica»
03-account.png Account Le cinque icone di «Raccoglie» sono nell'ordine: foto, video, storie, evidenza, taggati; spente se non attive. L'interruttore agisce subito. Un clic sulla riga apre la scheda
04-aggiungi-account.png Aggiungi account I tre punti di partenza sono quelli di §4.2. Superato da #37: niente linguette, una sola casella con l'elenco dei suggerimenti sotto (profili seguiti, poi Instagram, con foto ed etichette), «Da aggiungere» al posto dell'elenco a spunte, che si apre con «Scegli fra tutti i profili che segui». I profili già presenti sono attenuati. Durante la lettura dell'elenco compare l'avanzamento di §4.2. Finché non c'è un mockup nuovo, il riferimento è la schermata docs/schermate/04-aggiungi-account.png
05-account-impostazioni.png Scheda account, impostazioni Il riquadro a destra si ricalcola a ogni modifica. «Controlla ora» segue §7.8. Con «Su misura» compaiono i due campi di §4.4
06-attivita.png Attività Si aggiorna da sola con gli eventi del server. L'anteprima del browser è un fotogramma ogni pochi secondi, non un video. «Tutti i tetti» apre l'elenco completo di §7.4
07-limiti-e-comportamento.png Impostazioni, limiti Modificare un valore cambia il profilo in «Su misura». I cerchi con le iniziali sono i giorni attivi. Nel programma la tabella dei tetti ha anche le righe Home, Post singoli ed Elenco dei seguiti di §7.5, e «Ricerche di profili» (#37). La riga degli arresti è informativa: non si modifica
08-impostazioni-generali.png Impostazioni, generali In Docker le due cartelle sono in sola lettura, con la nota che si cambiano dal contenitore. Il blocco «Avvio» esiste solo su Windows
09-importa-revisione.png Importa, passo 3 I passi 1, 2 e 4 usano la stessa intestazione: scelta della cartella, barra di avanzamento con possibilità di interrompere, resoconto finale. Nel confronto dei doppioni nessuna scelta è già fatta in partenza: l'immagine mostra una decisione presa da Alberto. «Sposta» non compare se la sorgente è in sola lettura
10-collegamento-instagram.png Collegamento, versione Docker Il riquadro grande è la vista remota del browser del server. Il rettangolo tratteggiato dell'immagine è un segnaposto: la pagina di Instagram non si ridisegna. Versione Windows qui sotto
11-attivita-fermo-tema-scuro.png Attività durante un arresto, tema scuro La striscia rossa compare in cima a tutte le pagine, non solo qui. «Riprendi» si attiva dopo che Alberto ha usato il browser
12-account-storie-tema-scuro.png Scheda account, storie, tema scuro Griglia regolare con proporzione 9:16. Post, In evidenza e Taggati usano il mosaico della Libreria; le raccolte in evidenza sono intestazioni di gruppo
13-foglio-di-stile.png Colori, caratteri, misure, componenti È il riferimento per qualunque elemento non disegnato altrove. Non è una schermata del programma
14-finestra-stretta-e-telefono.png Finestra stretta su Windows, telefono nel browser Sotto i 1000 px la barra laterale si riduce alle icone; sotto i 560 px una colonna e navigazione in basso

Collegamento su Windows. La pagina è la stessa del mockup 10, ma il browser è la finestra «Browser di Febe». Nel riquadro grande compare la frase «Il browser di Febe è aperto in un'altra finestra» con il pulsante «Portalo in primo piano». Il testo accanto dice: «La password va solo a Instagram. La scrivi direttamente nella sua pagina: Febe non la riceve e non la salva. Resta solo la sessione del browser, nella cartella dei dati.»

«Apri il browser», da Attività e dalla striscia rossa: su Windows porta in primo piano la finestra del browser; in Docker apre la pagina «Browser», che è il mockup 10 senza la colonna dei passi, con la vista remota e il pulsante «Ho finito». Finché Alberto usa il browser il motore resta fermo.

Schermate senza mockup, da comporre con gli elementi del foglio di stile: Scheda account → Cronologia (elenco dei controlli con esito); Impostazioni → Notifiche, Dati e copie di sicurezza, Informazioni; revisione dei doppioni dopo uno scaricamento (lo stesso confronto del mockup 09); primo avvio (la schermata vuota del mockup 13 con i due pulsanti); pagina di errore di configurazione (§8.2, §11).

10.4 Testi

  • Frasi in italiano corrente, iniziale maiuscola solo alla prima parola. Niente etichette in tutto maiuscolo.
  • I nomi sono quelli che usa Alberto, non quelli del codice: «storico» e non «backfill», «tetto» e non «rate limit», «verifica» e non «challenge».
  • Un pulsante dice che cosa succede: «Importa 7.682 file», non «Conferma». La stessa azione ha lo stesso nome ovunque.
  • Un errore dice che cosa è successo, che cosa ha fatto Febe e che cosa deve fare Alberto. Non si scusa e non resta vago.
  • Gli orari futuri del motore sono sempre «verso le».
  • I numeri usano il punto per le migliaia e la virgola per i decimali.

10.5 Requisiti di base

Fuoco da tastiera sempre visibile; contrasto del testo almeno 4,5 a 1 in entrambi i temi (i token dell'appendice B lo rispettano su tutti gli sfondi); nessuna informazione affidata al solo colore; rispetto dell'impostazione di sistema per le animazioni ridotte; tema chiaro, scuro o come il sistema. Le uniche animazioni sono quelle che rispondono a un gesto (apertura di un dialogo, comparsa di una riga).

10.6 Modalità dimostrativa

Con --demo il programma parte senza browser e senza rete, in ascolto solo su 127.0.0.1 e senza password, con una libreria temporanea di account .demo, immagini generate e uno stato del motore finto. Non deve poter scrivere nella libreria vera.

  • Lo stato si sceglie dall'indirizzo: ?scena=normale, sessione, fermo, scollegato, alvolante (Alberto usa il browser); il tema con ?tema=chiaro o scuro. Ci sono indirizzi che aprono direttamente il dialogo «Aggiungi account» e il passo 3 dell'importazione.
  • La ricerca dei profili del dialogo risponde con dati finti, senza browser: account e profili seguiti dimostrativi il cui nome contiene il testo, più qualche nome inventato, con foto disegnate che arrivano un attimo dopo. Con fermo, scollegato e alvolante dice perché non cerca.
  • I dati dimostrativi devono essere coerenti fra loro (i conteggi tornano, gli orari sono plausibili). Non serve che ricalchino i numeri dei mockup.

10.7 Come si verifica una schermata

Avvia con --demo, fai uno screenshot nelle condizioni della tabella e confrontalo con il mockup; elenca le differenze di disposizione, misure, colori e testi; correggi; ripeti finché restano solo differenze di contenuto.

Mockup Finestra in pixel CSS Tema e scena
01, 02, 03, 08 1440 × 900 chiaro, normale
04 1440 × 900 chiaro, dialogo aperto con «gaia» scritto e l'elenco dei suggerimenti aperto
05 1440 × 1000 chiaro, normale
06 1440 × 900 chiaro, sessione
07 1440 × 1470 chiaro, normale
09 1440 × 900 chiaro, passo 3
10 1440 × 900 chiaro, scollegato
11 1440 × 900 scuro, fermo
12 1440 × 900 scuro, normale
14 860 × 900 e 390 × 844 chiaro, normale e sessione

Le immagini sono in scala 1,25 (1800 pixel di larghezza). Se non hai uno strumento per il browser, su Windows basta Edge da riga di comando, con un profilo temporaneo suo. Per esempio, adattando il percorso:

"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --headless --user-data-dir=%TEMP%\febe-schermate
  --window-size=1440,900 --force-device-scale-factor=1.25 --virtual-time-budget=5000
  --screenshot=uscita.png "http://127.0.0.1:8480/attivita?scena=sessione"

Il divieto di modalità headless della regola 2 riguarda il browser che visita Instagram, non questi screenshot dell'interfaccia.


11. Docker e Unraid

  • Immagine. Base Debian stabile in versione ridotta. Su Ubuntu il pacchetto Chromium è uno snap e nei contenitori non funziona. Febe si pubblica autosufficiente per linux-x64, quindi nell'immagine non serve il runtime .NET. Pacchetti: chromium, chromium-l10n (le lingue del browser sono a parte), xvfb, ffmpeg, la libreria ICU, caratteri di sistema compresi quelli per le emoji, certificati, tzdata, locales con la lingua italiana generata.
  • Processi. Febe.Server è il processo principale: avvia Xvfb, poi Chromium, e li riavvia se cadono. Niente script di shell che facciano da supervisore.
  • Utente. Non root, con PUID e PGID configurabili (su Unraid 99 e 100).
  • Avvio di Chromium. Come un browser normale, con finestra, sul display virtuale, con: porta di debug fissa su 127.0.0.1 (§6.1), cartella del profilo, nessuna procedura di primo avvio, dimensione della finestra, archivio delle password di base, uso di /tmp al posto della memoria condivisa. La lingua viene da LANG. Mai --headless, --enable-automation, opzioni che cambiano lo user agent o che intervengono su ciò che il browser dichiara.
  • Password del browser. Un file di criteri nell'immagine disattiva il salvataggio delle password e la compilazione automatica di Chromium: con l'archivio di base finirebbero in chiaro nel profilo.
  • Sandbox. Esito di S5. Se la sandbox di Chromium non parte con le impostazioni normali di Docker, le alternative sono un profilo seccomp dedicato oppure --no-sandbox. La seconda si accetta solo perché quel browser visita esclusivamente Instagram, e va scritta nella guida come compromesso.
  • Porte. Si pubblica solo la porta dell'interfaccia. La porta di debug del browser non esce mai dal contenitore.
Volume Uso
/dati Database, profilo del browser, miniature, copie. Su un disco locale del server
/libreria Foto e video
/importa Sorgenti da importare, in sola lettura
Variabile Significato Predefinito
FEBE_PASSWORD Password dell'interfaccia. Obbligatoria nessuno
FEBE_PORTA Porta dell'interfaccia 8480
TZ Fuso orario Europe/Rome
LANG Lingua del contenitore e del browser it_IT.UTF-8
PUID, PGID Utente e gruppo dei file 99, 100
FEBE_RACCOLTA Opzione «raccolta» di §6.0: pagine o richieste (--raccolta sulla riga di comando vince) pagine
FEBE_CHIAVE_SESSIONE Chiave AES-256 della sessione salvata (§13.2), 32 byte in base64; facoltativa, serve a tenerla fuori da /dati Dati/sessione/chiave.bin
  • Se FEBE_PASSWORD manca, o /dati non è scrivibile o è una condivisione di rete, il motore non parte e l'interfaccia mostra una sola pagina che spiega che cosa non va e come rimediare. Vale dal primo contenitore che costruisci, compreso quello di prova di M0: la vista remota non deve mai essere raggiungibile senza password.
  • Accesso a Instagram. Solo dalla pagina Collegamento, con la vista remota: i fotogrammi del browser arrivano all'interfaccia e i gesti di Alberto tornano al browser. Ciò che scrive, password compresa, attraversa la rete di casa e la memoria del server senza essere registrato: la pagina lo dice (mockup 10). Per questo l'interfaccia non va mai esposta su Internet senza una VPN o un proxy con HTTPS: scrivilo nella guida.
  • Consegna. docker/Dockerfile, docker/compose.yml di esempio, modello per Unraid docker/unraid/febe.xml con icona, punto di controllo /salute.

12. Windows

  • Applicazione WPF su .NET 10, una sola istanza alla volta, icona nell'area di notifica.
  • La finestra principale è un WebView2 che mostra l'interfaccia servita in locale su 127.0.0.1, porta scelta all'avvio.
  • Il browser di Instagram è un secondo WebView2, con una sua cartella dati, in una finestra separata «Browser di Febe». Alberto la apre da Collegamento e da Attività; quando non serve resta fuori vista ma attiva (S2). Salvataggio delle password e compilazione automatica sono disattivati nelle impostazioni del controllo.
  • Funzioni native offerte all'interfaccia: scelta di una cartella, «Mostra nella cartella», apertura di un indirizzo nel browser predefinito, notifiche di Windows, avvio con il sistema.
  • Chiudendo la finestra Febe resta nell'area di notifica e continua a lavorare; dal menu dell'icona: apri, metti in pausa, esci.
  • Cartelle predefinite: dati in %LOCALAPPDATA%\Febe, libreria in Immagini\Febe.
  • Verificato: il runtime WebView2 è già presente in Windows 11 e in quasi tutti i Windows 10. Se manca, Febe lo dice con il collegamento per installarlo.
  • Pubblicazione autosufficiente in un unico eseguibile; programma di installazione secondo la domanda 6 di §16.

13. Sicurezza, riservatezza, avvisi

13.1 Accesso all'interfaccia

  • Docker: password obbligatoria; sessione con un cookie non leggibile dagli script e limitato allo stesso sito (HttpOnly, SameSite=Strict); blocco dopo tentativi ripetuti. Su ogni richiesta che modifica qualcosa, e all'apertura di WebSocket ed eventi dal server, si controlla che l'intestazione Origin sia quella dell'interfaccia. Un'altra pagina aperta nel browser di Alberto non deve poter comandare Febe né la vista remota.
  • Windows: il server ascolta solo su 127.0.0.1 e accetta richieste solo con un gettone generato a ogni avvio, che la finestra conosce. Si controllano anche Host e Origin.

13.2 Dati riservati

  • La sessione di Instagram vive nel profilo del browser dentro la cartella dei dati e, dal 16 novembre 2026 (§6.0), nella sessione salvata Dati/sessione/sessione.json: cookie, user agent, gettoni e doc_id. Esiste solo con la raccolta richieste e un catalogo con operazioni configurate (§6.0); con Instagram, nella tappa S4, non si crea. Il file è cifrato e porta un'intestazione FEBS con versione e schema:

    • su Windows con DPAPI dell'utente corrente (ProtectedData, nella libreria del desktop di .NET, nessun pacchetto nuovo): solo quell'utente di Windows, su quel computer, lo apre; non c'è file della chiave;
    • in Docker con AES-256-GCM, un nonce nuovo a ogni scrittura e l'intestazione come dati associati, e una chiave a 256 bit presa dalla variabile FEBE_CHIAVE_SESSIONE (32 byte in base64, per esempio openssl rand -base64 32, o 64 cifre esadecimali) o, se manca, dal file Dati/sessione/chiave.bin, creato una volta con RandomNumberGenerator e mai rigenerato. Una FEBE_CHIAVE_SESSIONE sbagliata è sempre un problema di configurazione all'avvio (motore e browser non partono, la pagina d'errore lo spiega senza ripetere il valore); un chiave.bin che non è una chiave lo è solo con richieste. Con la variabile impostata un chiave.bin rimasto non si usa e il registro lo dice.

    Su Unix la cartella Dati/sessione è 0700 e i suoi file 0600 dalla creazione (File.SetUnixFileMode); un chiave.bin più aperto si restringe e il registro lo dice. Si scrive in modo atomico: un file .part nella stessa cartella, scritto fino al disco, poi rinominato sul vecchio. Sostituire, aggiornare e cancellare passano da un solo semaforo; un aggiornamento ricontrolla sessione e copia dopo averlo preso, così una risposta tardiva non riporta in vita una sessione cancellata né tocca quella di un accesso nuovo. Una scrittura che il disco rifiuta tiene i valori nuovi in memoria (il sito ha già cambiato i cookie), scrive nel registro una riga con il solo tipo d'errore e si riprova alla scrittura dopo. Un file che non si legge (altra chiave o altro utente, rovinato, altro formato) è nessuna sessione, detto nel registro e lasciato com'è finché una copia nuova non lo sostituisce: mai un arresto del programma.

    Non va nel database, nelle copie giornaliere, nel rapporto di diagnostica né nell'interfaccia; Febe non lo esporta e non accetta sessioni incollate da fuori. «Scollega» cancella la sessione salvata prima del profilo del browser: prima in memoria, poi il file (e i .part rimasti), senza annullamento; con pagine cancella comunque un sessione.json lasciato da un avvio con richieste. chiave.bin resta. Un file che non si cancella è un fallimento parziale detto ad Alberto: Febe non lo usa più finché resta acceso, ma al prossimo avvio con richieste lo rileggerebbe, quindi il messaggio chiede di riprovare «Scollega» o di cancellare a mano la cartella sessione prima di riavviare. Chi ha accesso alla cartella dei dati e alla chiave (in Docker), o all'utente di Windows, ha accesso alla sessione.

  • FEBE_PASSWORD e FEBE_CHIAVE_SESSIONE si tolgono dall'ambiente di ogni processo che Febe avvia (Chromium o Edge, Xvfb, ffmpeg, ffprobe): un figlio eredita l'ambiente del padre, e Chromium esegue il codice del sito. La password e la chiave non si passano mai sulla riga di comando e non compaiono in nessun testo di Febe (registri, problemi, descrizione delle opzioni: solo «impostata», «assente» o «non valida»).

  • Password e codici non entrano mai nei registri. Nella vista remota i tasti vanno al browser e non si conservano.

  • I registri contengono azioni ed esiti, non contenuti: nomi utente sì, didascalie e corpi delle risposte no. Il client CDP registra solo nomi di comandi (§6.1); il client del sito solo operazione o forma del percorso e stato (§6.0). Il rapporto di diagnostica (§7.9) è più severo dei registri: nemmeno i nomi utente, né indirizzi interi, solo forme, conteggi e codici di elenchi chiusi, perché è fatto per uscire dalla macchina di Alberto. Per le richieste verso Telegram e verso il CDN non si registrano gli indirizzi: contengono il gettone del bot e le firme dei file.

  • I campioni grezzi della sonda stanno fuori dal repository e si cancellano a fine M0 (§14.5).

13.3 Avvisi

Eventi che meritano un avviso: verifica richiesta, disconnessione, fermo per rallentamento e ripresa, storico di un account completato, disco quasi pieno, formato non riconosciuto. Canali: striscia nell'interfaccia sempre; notifica di Windows nella versione desktop; Telegram se Alberto inserisce gettone del bot e identificativo della chat nelle impostazioni. Per Telegram basta una chiamata HTTPS con HttpClient: nessuna libreria.


14. Prove e verifiche

14.1 Prove automatiche

  • Lettori: ogni lettore sui campioni ripuliti, compresi i casi di post con più file, video, profilo privato, risposta vuota, forma sconosciuta.
  • Motore, con orologio virtuale e seme fisso: non supera mai un tetto; non agisce mai fuori fascia, salvo il comando manuale confermato di §7.8; rispetta sempre la pausa minima; un riavvio non azzera i conteggi; gli intervalli fra gli inizi delle sessioni non sono regolari (coefficiente di variazione almeno 0,35).
  • Interruttore: ogni segnale porta allo stato giusto; dopo una verifica non parte nulla finché non arriva la ripresa manuale.
  • Libreria: nomi ripuliti, percorsi lunghi, scrittura con nome temporaneo, eliminazione che non torna, ricostruzione del database dai file.
  • Doppioni: immagini di prova generate e le loro varianti ridimensionate, ricompresse e ritagliate.
  • Importazione: interruzione e ripresa; «Sposta» non elimina mai un originale non verificato.
  • Ripulitura dei campioni: nessun valore dei campioni grezzi sopravvive in quelli ripuliti (§14.5).

14.2 Sito di prova

tools/Febe.SitoDiProva è un piccolo sito locale che espone gli stessi dati dei campioni attraverso pagine spoglie: una griglia che carica altre pagine scorrendo, un visualizzatore, un elenco, e i casi di arresto (stato 429, rinvio a una pagina di verifica, uscita dalla sessione). Non ha marchi né grafica di Instagram e non ha un vero modulo d'accesso: non deve somigliargli, deve solo far girare ricette, cattura e motore senza toccare Instagram. Per il client del sito (§6.0) risponde alle stesse forme di richiesta e di risposta dei campioni ripuliti (per esempio POST /api/graphql con doc_id e le risposte dei campioni), controlla il cookie di sessione di prova e le intestazioni attese, e simula i casi d'arresto: 429, rinvio all'accesso o a una verifica, HTML al posto del JSON, JSON senza i campi attesi, cookie rinnovati o cancellati. Le forme dei casi d'arresto non note da campioni sono generiche e marcate H16. Per la copia a «Ho finito» (tappa S4) le sue pagine danno ciò che darebbe un sito vero: un cookie csrftoken, un cookie limitato a /api/ e un piccolo registro di moduli (__d, require) con nomi suoi, mai quelli di Instagram, scritti nella sezione page di richieste.prova.json; un valore mancante o diverso riceve lo stesso 400 generico. Ha la sua mappa dei bersagli (bersagli.prova.json): le ricette sono le stesse, cambia solo dove trovano le cose. Tutte le prove d'insieme passano da qui.

14.3 Simulazione

--simula 30g --profilo prudente fa girare il motore con l'orologio virtuale contro un mondo finto e produce un resoconto, anche in CSV.

  • Il mondo: 40 account, 25 seguiti e 15 no, con frequenze di pubblicazione diverse (in media un post ogni tre giorni; storie quotidiane per metà degli account); un account con uno storico di 2.000 post; qualche rallentamento inserito a caso. Per la simulazione si può usare un IBrowserHost finto che risponde con i dati dei campioni, senza avviare un browser.
  • --raccolta richieste simula le ricette per richieste (§6.3): nessuna raffica di scorrimento, le attese fra una richiesta e l'altra, una sola storia vista per le storie di un account. Un controllo del profilo costa come con le operazioni separate di Instagram, il caso prudente: due profili aperti (profilo e prima pagina dei post), più uno per l'elenco delle raccolte se non è stato chiesto nelle ultime 24 ore; la prima pagina dello storico di un account mai controllato conta come profilo. Sul sito di prova una sola richiesta porta tutto: la simulazione misura il costo che avrà Instagram con la tappa S4. --raccolta pagine, il predefinito, i gesti del browser. Il resoconto dice quale delle due.
  • Il resoconto: sessioni al giorno; azioni per categoria al giorno e nell'ora peggiore; tempo medio e massimo tra la pubblicazione di un contenuto e la sua scoperta; giorni necessari per lo storico di 2.000 post; numero di superamenti dei tetti, che deve essere zero.

È il modo in cui Alberto giudica un profilo prima di usarlo, e il controllo principale della tappa M3.

14.4 Prove dal vivo

Le esegue solo Alberto, con l'account di prova, seguendo un elenco di passi che gli prepari tappa per tappa in docs/prove-dal-vivo.md. Ogni elenco dice che cosa fare, che cosa aspettarsi e che cosa riferirti. Prima della fine di M3 il programma non compie alcun gesto su Instagram: nella sonda di M0 naviga Alberto. Il passaggio all'account principale lo decide lui, non prima della fine di M3, e sempre con il profilo Prudente.

14.5 Sonda e campioni

  • La sonda è passiva. Avvia il browser, Alberto accede e naviga a mano seguendo un elenco di cose da aprire (la home, un profilo pubblico, uno privato che segue, una storia, una raccolta, la scheda taggati, l'elenco dei seguiti), e la sonda registra ciò che la pagina riceve. Registra anche, per gli elementi che Alberto clicca, gli attributi utili alla mappa dei bersagli. Non compie gesti.
  • I campioni grezzi stanno fuori dal repository, in una cartella che Alberto sceglie, e si cancellano a fine M0. Tu non li apri: contengono nomi, testi, indirizzi firmati e dati dell'account di Alberto e di altre persone.
  • La ripulitura lavora per elenco di ciò che è ammesso, non di ciò che è vietato. Conserva struttura e chiavi. Sostituisce ogni stringa e ogni numero lungo con un valore finto della stessa forma, tranne i campi di un breve elenco che non dicono nulla di una persona (dimensioni, durate, conteggi, valori vero o falso, codici di tipo, date). Sostituisce anche le chiavi che hanno l'aspetto di un identificativo. Degli indirizzi tiene solo la distinzione fra sito e CDN e l'estensione del file.
  • Una prova automatica confronta grezzi e ripuliti, sulla macchina di Alberto, e fallisce se una stringa di quattro o più caratteri sopravvive fuori dall'elenco ammesso.
  • In tests/campioni/ e in docs/sonda/esito.md entrano solo campioni ripuliti e descrizioni di forma.
  • Forma delle richieste (per la regola 2, eccezione). febe-sonda richieste --har <file> --a <file .json> descrive le richieste che la pagina fa al sito: metodo, percorso con ogni parte che non è una parola fissa del sito sostituita da {numero} o {testo}, nomi dei parametri, delle intestazioni e dei campi del corpo, struttura delle variabili GraphQL. Dei valori scrive solo il tipo («numero», «testo», «vuoto»), tranne quelli di un elenco chiuso uguali per tutti (identificativo dell'applicazione, nomi e identificativi delle operazioni, grandezza delle pagine, vero/falso): mai cookie, gettoni, nomi, identificativi o cursori. Dei nomi tiene quelli di un elenco chiuso e quelli che hanno la forma di un nome del codice (senza punto, senza tre cifre di fila) e non compaiono da nessuna parte nel HAR come valore; gli altri diventano «(nome tolto)». Alberto lo legge e lo invia; da lì si scrive richieste.<sito>.json.

15. Tappe

Ogni tappa finisce con i controlli «Fatto quando» eseguiti e mostrati, docs/stato.md aggiornato e un commit. Dove c'è un arresto, fermati e aspetta Alberto.

Tappa Contenuto Leggi Fatto quando
M0 Sonda Struttura del repository, CLAUDE.md, client CDP, ChromiumProcessHost, sonda passiva con ripulitura, sito di prova minimo. Prove usa e getta: una finestra WPF con un WebView2 (S1, S2, S6); un contenitore con Chromium, Xvfb, password e vista remota minima (S3, S4, S5, S6) §2, §5, §6, §7.6, §11, §12, §13, §14.2, §14.5 docs/sonda/esito.md riporta un esito con prove per ogni voce di §6.6; campioni ripuliti presenti e prova della ripulitura verde; prima mappa dei bersagli; decisioni scritte. Arresto: se H1–H4 non reggono, si rivede §6.3 con Alberto prima di proseguire
M1 Dati e libreria Schema e migrazioni, modello, percorsi e nomi, hash, impronte, miniature, _febe.jsonl, copie, eliminazione, ricostruzione §4.3, §4.6, §4.7, §8 Prove di libreria e doppioni verdi; ricostruzione del database riuscita su una libreria di prova
M2 Raccolta Lettori, cattura, gesti, ricette, mappa dei bersagli, scaricamento, sito di prova completo. Nessuna prova dal vivo §2, §4.2, §4.3, §6, §7.7, §14.1, §14.2 Prove dei lettori verdi; ogni ricetta verde contro il sito di prova, casi di arresto compresi
M3 Motore Pianificazione, sessioni, Governatore, interruttore, avvio graduale, simulazione. Poi la prima prova dal vivo §4.4, §4.5, §7, §14.1, §14.3, §14.4 Prove del motore verdi; simulazione di 30 giorni per i tre profili senza superamenti. Arresto: Alberto legge i numeri. Poi, dal vivo: una sessione con l'account di prova e il profilo Prudente su un profilo pubblico, con i file arrivati in libreria
M4 Interfaccia API, eventi, ossatura, tutte le schermate, tema scuro, finestra stretta, modalità dimostrativa §4, §7.5, §7.9, §9.1, §10, §13.1, mockup 01–14 Ogni schermata confrontata con il suo mockup secondo §10.7, con l'elenco delle differenze rimaste
M5 Docker Immagine, Xvfb, vista remota, password, pagina di errore, modello Unraid §4.1, §6.1, §11, §13 Il contenitore parte su Unraid; Alberto accede dalla vista remota; un riavvio conserva la sessione
M6 Windows Finestra, WebView2Host, area di notifica, funzioni native, installazione §4.1, §6.1, §6.6, §12, §13 Installazione su un Windows pulito; accesso, raccolta con la finestra del browser fuori vista, chiusura nell'area di notifica
M7 Importazione I quattro passi, riconoscitori, revisione dei doppioni, copia verificata §8.3, §9, mockup 09 Prove di importazione verdi; una cartella vera di Alberto importata senza doppioni e senza toccare gli originali
M8 Rifiniture Avvisi e Telegram, esportazione CSV, guida per l'uso, pagina sui problemi comuni §4.8, §13.3, elenco qui sotto Guida completa; un arresto simulato produce striscia, notifica e messaggio
M9 Facoltative Desktop collegato a un Febe remoto; seconda lingua §5 Da definire con Alberto

docs/stato.md è il filo fra le sessioni: che cosa è fatto, che cosa è in corso, che cosa è stato rimandato e perché. docs/decisioni.md raccoglie ogni scelta tecnica presa strada facendo, con data e motivo.

Che cosa la guida deve dire per forza:

  • il rischio per l'account e le condizioni d'uso di Instagram; che cosa fa Febe per ridurlo e che cosa non fa;
  • che le storie aperte da Febe risultano viste;
  • che contenitore e desktop non vanno usati insieme sullo stesso account;
  • che chi ha la cartella dei dati, o una sua copia, ha la sessione di Instagram;
  • che l'interfaccia Docker non va esposta su Internet, e che in Docker la password di Instagram passa dal server;
  • l'eventuale compromesso sulla sandbox di Chromium;
  • che cosa fare dopo una verifica o un rallentamento;
  • dove sono le copie del database e come si ricostruisce.

16. Domande aperte per Alberto

Falle quando arrivi al punto indicato, una per volta, proponendo la risposta della terza colonna. Non fermarti per dubbi che puoi risolvere da solo.

Domanda Quando Proposta
1 Dove sta il repository e chi compila l'immagine: Gitea di casa o GitHub? M0 Solo git locale finché non decide
2 Quale account di prova si usa per la sonda e per le prove dal vivo? M0 Obbligatorio prima di qualunque prova
3 La richiesta diceva «un percorso generale per le immagini e un percorso generale…» e si interrompeva. Vanno bene Libreria e Dati? M1 Sì; in alternativa una cartella separata per i video
4 Com'è fatta la libreria di 4K Stogram da importare? M1, per usarla in M7 Una ventina di righe dell'elenco dei file, con i nomi degli account sostituiti
5 Va bene che Febe apra le storie e che quindi Alberto risulti tra gli spettatori, per tutti gli account? M2 Sì, con l'interruttore «Storie» per escludere chi vuole
6 Su Windows serve un programma di installazione o basta una cartella da copiare? M6 Programma di installazione
7 Avvisi su Telegram? M8 Sì, facoltativi
8 Il nome «Febe» resta? Prima di M0 —
9 Solo italiano, o anche inglese? M4 Solo italiano, testi già separati
10 Su Unraid: porta, cartella della libreria, disco per i dati M5 Porta 8480, dati nella cartella delle applicazioni sul disco di cache
11 Risposta di Alberto del 16 novembre 2026: con una richiesta, non risultano viste (§3). Domanda di allora: con la pagina che chiede i dati, le storie si chiedono con una richiesta (non risultano viste) o si continuano ad aprire nel visualizzatore (Alberto tra gli spettatori, come oggi)? #36, sui campioni del nuovo HAR Restare al visualizzatore, che è la scelta di §3; la richiesta solo se il visualizzatore non si può guidare in modo affidabile

Appendice A — Contenuto di CLAUDE.md

Copialo così com'è nella radice del repository. Deve restare corto: le regole complete sono in questa specifica.

# Febe

Archivio personale di foto, video e storie da Instagram, in due vesti: Docker e Windows.
La specifica è docs/SPECIFICA.md. Non rileggerla tutta ogni volta: apri la sezione che riguarda il lavoro in corso.
All'inizio di ogni sessione leggi docs/stato.md.

## Comandi
- Compilare: `dotnet build -warnaserror`
- Prove: `dotnet test` (una sola: `dotnet test --filter "FullyQualifiedName~Nome"`)
- Avviare in modalità dimostrativa: `dotnet run --project src/Febe.Server -- --demo`
- Simulare il motore: `dotnet run --project src/Febe.Server -- --simula 30g --profilo prudente`
- Immagine Docker: `docker build -f docker/Dockerfile -t febe .`

## Regole che non si discutono (specifica §2)
1. IMPORTANTE: non contattare mai Instagram da prove, script o verifiche tue. Si usa solo tools/Febe.SitoDiProva. Le prove dal vivo le lancia Alberto.
2. Non aprire i campioni grezzi della sonda: stanno fuori dal repository e contengono dati di altre persone. Si lavora sulle copie ripulite di tests/campioni.
3. Verso Instagram parlano solo il browser di Febe (accesso e verifiche) e il suo unico client del sito (§6.0), solo verso le operazioni di `richieste.<sito>.json`, più il CDN alle condizioni di §6.5. Nessun altro HttpClient verso domini di Instagram o Meta. Decisione di Alberto del 16 novembre 2026 (#36).
4. Il browser si usa così com'è: nessuna modifica di user agent, impronta, intestazioni; niente headless, stealth, proxy, più account. Comandi CDP solo dall'elenco di §6.1. Il client del sito: user agent copiato tale e quale dal browser, intestazioni solo dal modello, nessun rinvio seguito, una richiesta per volta con il permesso del Governatore, mai scritture (§2 regola 2, §6.0).
5. CAPTCHA, verifiche e codici non si risolvono mai in automatico: Febe si ferma e avvisa.
6. Sola lettura (niente mi piace, segui, commenti, messaggi) e solo ciò che l'account di Alberto vede già.
7. Un account, un motore. La sessione si copia solo dal browser di Febe nella sessione salvata cifrata della stessa istanza: mai su un'altra macchina, mai esportata, mai incollata da fuori. Browser e client del sito non la usano insieme.
8. Ogni azione del motore verso il sito passa da IGovernor. Al primo segnale di §7.6 ci si ferma.
9. I lettori si scrivono solo su campioni reali ripuliti. Il formato delle risposte non si inventa.
10. Mai password, cookie, gettoni, tasti, variabili o corpi di richieste e risposte nei log. Il client CDP registra solo nomi di comandi; il client del sito solo operazione o forma del percorso e stato.
11. La libreria non cancella e non sostituisce file da sola.
12. Dipendenze a elenco chiuso (§3): prima di aggiungerne una, chiedi.

## Convenzioni
- Codice e commenti in inglese; interfaccia, documenti e messaggi in italiano (glossario: appendice D).
- Nel motore mai DateTime.Now, Task.Delay o Random diretti: si usano IClock e IRandomSource.
- Interfaccia senza framework né build: file in src/Febe.Web/wwwroot. Token e classi di base: appendice B.
- Una schermata è finita quando è stata confrontata con il suo mockup (§10.7).
- Scelte tecniche nuove: una riga in docs/decisioni.md con data e motivo.
- A fine lavoro aggiorna docs/stato.md e mostra comandi e risultati dei controlli. Se qualcosa non è verificato, dillo.

## Quando compatti la conversazione
Conserva: tappa in corso, file modificati, controlli ancora da eseguire, domande aperte per Alberto.

Appendice B — Token e CSS di partenza

È il foglio che ha generato i mockup, con una sola differenza: qui il contenuto della pagina scorre (.corpo ha overflow:auto), mentre nelle immagini è tagliato al bordo. Usalo come base di src/Febe.Web/wwwroot/css/febe.css e completalo; i nomi delle classi puoi tenerli. Il tema scuro si attiva con data-tema="scuro" sull'elemento radice.

Il carattere Archivo variabile (licenza OFL) si prende dal pacchetto npm @fontsource-variable/archivo, cartella files: servono archivo-latin-standard-normal.woff2 e archivo-latin-ext-standard-normal.woff2. Copiali in wwwroot/caratteri/ con il file della licenza: il pacchetto non diventa una dipendenza.

/* Febe — token e componenti di base */
@font-face{
  font-family:"Archivo";
  src:url(../caratteri/archivo-latin-standard-normal.woff2) format("woff2");
  font-weight:100 900; font-stretch:62% 125%; font-display:block;
}
@font-face{
  font-family:"Archivo";
  src:url(../caratteri/archivo-latin-ext-standard-normal.woff2) format("woff2");
  font-weight:100 900; font-stretch:62% 125%; font-display:block;
  unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF;
}

:root{
  --fondo:#F4F4F4;
  --superficie:#FFFFFF;
  --rialzo:#FAFAFA;
  --barra:#ECECEC;
  --bordo:#E1E1E1;
  --bordo-forte:#CCCCCC;
  --testo:#1A1A1A;
  --testo-2:#555555;
  --testo-3:#6A6A6A;
  --accento:#0F5C8C;
  --accento-scuro:#0B4A72;
  --accento-tinta:#E3EEF5;
  --accento-bordo:#B5D0E2;
  --su-accento:#FFFFFF;
  --verde:#1E7B4F;
  --verde-tinta:#E3F2EA;
  --ambra:#9A5B00;
  --ambra-pieno:#E0A021;
  --ambra-tinta:#FBF0DA;
  --rosso:#B42318;
  --rosso-tinta:#FBE9E7;
  --velo:rgba(20,20,20,.46);
  --ombra-menu:0 10px 30px rgba(0,0,0,.16),0 1px 3px rgba(0,0,0,.10);
  --ombra-dialogo:0 24px 70px rgba(0,0,0,.28),0 2px 8px rgba(0,0,0,.12);
  --r-tessera:3px;
  --r-controllo:7px;
  --r-pannello:10px;
  --r-dialogo:14px;
  --tratteggio:rgba(0,0,0,.075);
}
[data-tema="scuro"]{
  --fondo:#1B1B1B;
  --superficie:#242424;
  --rialzo:#2B2B2B;
  --barra:#151515;
  --bordo:#363636;
  --bordo-forte:#4A4A4A;
  --testo:#EDEDED;
  --testo-2:#B0B0B0;
  --testo-3:#959595;
  --accento:#62B1E0;
  --accento-scuro:#8AC6EA;
  --accento-tinta:#1B3342;
  --accento-bordo:#2C5068;
  --su-accento:#0C2230;
  --verde:#5CC08D;
  --verde-tinta:#1A3326;
  --ambra:#E7B04C;
  --ambra-pieno:#E0A021;
  --ambra-tinta:#3A2E14;
  --rosso:#F0776C;
  --rosso-tinta:#3F1E1B;
  --velo:rgba(0,0,0,.62);
  --ombra-menu:0 10px 30px rgba(0,0,0,.5),0 1px 3px rgba(0,0,0,.4);
  --ombra-dialogo:0 24px 70px rgba(0,0,0,.6),0 2px 8px rgba(0,0,0,.4);
  --tratteggio:rgba(255,255,255,.07);
}

*{box-sizing:border-box}
html,body{margin:0;height:100%}
body{
  font-family:"Archivo",system-ui,sans-serif; font-stretch:100%;
  font-size:14px; line-height:1.45; color:var(--testo); background:var(--fondo);
  -webkit-font-smoothing:antialiased; text-rendering:optimizeLegibility;
}
.dati{font-stretch:88%;font-variant-numeric:tabular-nums}
.muto{color:var(--testo-2)}
.tenue{color:var(--testo-3)}
svg.ic{width:18px;height:18px;flex:none;stroke-width:1.75}
svg.ic.s{width:15px;height:15px}
svg.ic.l{width:22px;height:22px}

/* ---------- ossatura ---------- */
.app{display:grid;grid-template-columns:228px 1fr;height:100vh}
.barra{background:var(--barra);border-right:1px solid var(--bordo);display:flex;flex-direction:column;padding:16px 12px 12px;min-width:0}
.marchio{display:flex;align-items:center;gap:10px;padding:2px 8px 18px}
.marchio svg{width:26px;height:26px}
.marchio b{font-size:17px;font-weight:650;font-stretch:108%;letter-spacing:.005em}
.nav{display:flex;flex-direction:column;gap:2px}
.nav a{display:flex;align-items:center;gap:11px;height:36px;padding:0 10px;border-radius:var(--r-controllo);color:var(--testo-2);text-decoration:none;font-weight:500;border:1px solid transparent}
.nav a.qui{background:var(--superficie);border-color:var(--bordo);color:var(--testo);font-weight:600}
.nav a.qui svg{color:var(--accento)}
.nav a .conta{margin-left:auto;font-size:12px;color:var(--testo-3)}
.nav a .punto{margin-left:auto;width:8px;height:8px;border-radius:50%;background:var(--rosso)}
.nav .stacco{height:1px;background:var(--bordo);margin:10px 8px}
.barra .molla{flex:1}
.stato{border:1px solid var(--bordo);background:var(--superficie);border-radius:var(--r-pannello);padding:12px}
.stato .riga{display:flex;align-items:center;gap:8px;font-weight:600}
.stato .sotto{font-size:12.5px;color:var(--testo-2);margin:3px 0 10px 16px}
.stato .conto{display:flex;justify-content:space-between;font-size:12px;color:var(--testo-2);margin-top:6px}
.stato .chi{display:flex;align-items:center;gap:9px;margin-top:12px;padding-top:11px;border-top:1px solid var(--bordo)}
.stato .chi div{min-width:0}
.stato .chi b{display:block;font-size:13px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.stato .chi span{font-size:12px;color:var(--testo-2)}
.spia{width:8px;height:8px;border-radius:50%;flex:none;background:var(--testo-3)}
.spia.verde{background:var(--verde)} .spia.accento{background:var(--accento);box-shadow:0 0 0 4px var(--accento-tinta)}
.spia.ambra{background:var(--ambra-pieno)} .spia.rosso{background:var(--rosso);box-shadow:0 0 0 4px var(--rosso-tinta)}

.pagina{display:flex;flex-direction:column;min-width:0;height:100vh;position:relative}
.testa{display:flex;align-items:center;gap:14px;padding:20px 28px 14px;flex:none}
.testa h1{margin:0;font-size:22px;font-weight:650;font-stretch:104%;letter-spacing:-.005em;line-height:1.2}
.testa .quanti{color:var(--testo-2);font-size:13.5px;padding-top:5px}
.testa .destra{margin-left:auto;display:flex;align-items:center;gap:10px}
.corpo{flex:1;overflow:auto;padding:0 28px 24px;min-height:0}
.strumenti{display:flex;align-items:center;gap:10px;padding:0 28px 14px;flex:none}
.strumenti .destra{margin-left:auto;display:flex;align-items:center;gap:10px}

/* ---------- controlli ---------- */
.btn{display:inline-flex;align-items:center;gap:8px;height:34px;padding:0 13px;border-radius:var(--r-controllo);border:1px solid var(--bordo-forte);background:var(--superficie);color:var(--testo);font:inherit;font-weight:550;font-size:13.5px;white-space:nowrap}
.btn.primo{background:var(--accento);border-color:var(--accento);color:var(--su-accento);font-weight:600}
.btn.nudo{border-color:transparent;background:transparent;color:var(--testo-2)}
.btn.pericolo{color:var(--rosso);border-color:var(--bordo-forte)}
.btn.spento{opacity:.45}
.btn.solo{width:34px;padding:0;justify-content:center}
.btn.grande{height:40px;padding:0 18px;font-size:14px}
.campo{display:flex;align-items:center;gap:8px;height:34px;padding:0 11px;border-radius:var(--r-controllo);border:1px solid var(--bordo-forte);background:var(--superficie);color:var(--testo);min-width:0}
.campo.cerca{width:280px;color:var(--testo-3)}
.campo.errore{border-color:var(--rosso);box-shadow:0 0 0 3px var(--rosso-tinta)}
.campo.fuoco{border-color:var(--accento);box-shadow:0 0 0 3px var(--accento-tinta)}
.campo .segna{color:var(--testo-3)}
.campo .val{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.campo svg{color:var(--testo-3)}
.campo.scelta{justify-content:space-between;font-weight:500}
.campo.sola{background:var(--rialzo);color:var(--testo-2)}
.gruppo{display:inline-flex;border:1px solid var(--bordo-forte);border-radius:var(--r-controllo);background:var(--superficie);padding:2px;gap:2px}
.gruppo span{height:28px;padding:0 12px;border-radius:5px;display:inline-flex;align-items:center;gap:6px;font-weight:500;font-size:13.5px;color:var(--testo-2);white-space:nowrap}
.gruppo span.qui{background:var(--accento-tinta);color:var(--accento-scuro);font-weight:600}
[data-tema="scuro"] .gruppo span.qui{color:var(--accento-scuro)}
.filtri{display:flex;gap:6px}
.filtri span{height:30px;padding:0 12px;border-radius:15px;display:inline-flex;align-items:center;gap:6px;font-weight:500;font-size:13.5px;color:var(--testo-2);border:1px solid var(--bordo);background:var(--superficie)}
.filtri span.qui{background:var(--testo);border-color:var(--testo);color:var(--superficie);font-weight:600}
.filtri span i{font-style:normal;font-size:12px;opacity:.7}
.int{width:36px;height:20px;border-radius:10px;background:var(--bordo-forte);position:relative;flex:none;display:inline-block}
.int::after{content:"";position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.25)}
.int.si{background:var(--accento)} .int.si::after{left:18px}
[data-tema="scuro"] .int.si::after{background:#0C2230}
.int.fermo{opacity:.4}
.spunta{width:17px;height:17px;border-radius:4px;border:1.5px solid var(--bordo-forte);background:var(--superficie);flex:none;display:inline-flex;align-items:center;justify-content:center}
.spunta.si{background:var(--accento);border-color:var(--accento);color:var(--su-accento)}
.spunta svg{width:12px;height:12px;stroke-width:3}
.tondo{width:17px;height:17px;border-radius:50%;border:1.5px solid var(--bordo-forte);background:var(--superficie);flex:none;display:inline-block;position:relative}
.tondo.si{border-color:var(--accento)} .tondo.si::after{content:"";position:absolute;inset:3px;border-radius:50%;background:var(--accento)}
.et{display:inline-flex;align-items:center;gap:4px;height:20px;padding:0 7px;border-radius:4px;font-size:11.5px;font-weight:600;background:var(--fondo);color:var(--testo-2);border:1px solid var(--bordo);white-space:nowrap}
.et svg{width:11px;height:11px;stroke-width:2.2}
.et.accento{background:var(--accento-tinta);color:var(--accento-scuro);border-color:var(--accento-bordo)}
.et.verde{background:var(--verde-tinta);color:var(--verde);border-color:transparent}
.et.ambra{background:var(--ambra-tinta);color:var(--ambra);border-color:transparent}
.et.rosso{background:var(--rosso-tinta);color:var(--rosso);border-color:transparent}
.misura{height:6px;border-radius:3px;background:var(--bordo);overflow:hidden;position:relative}
.misura i{position:absolute;inset:0 auto 0 0;border-radius:3px;background:var(--accento)}
.misura.ambra i{background:var(--ambra-pieno)} .misura.rosso i{background:var(--rosso)} .misura.grigio i{background:var(--testo-3)}
.misura.fine{height:4px}

/* ---------- avatar ---------- */
.av{width:32px;height:32px;border-radius:50%;flex:none;display:inline-flex;align-items:center;justify-content:center;font-weight:650;font-size:12px;color:#fff;font-stretch:92%;letter-spacing:.02em;overflow:hidden}
.av.p{width:24px;height:24px;font-size:10px} .av.g{width:56px;height:56px;font-size:19px} .av.m{width:40px;height:40px;font-size:14px}

/* ---------- pannelli e tabelle ---------- */
.pannello{background:var(--superficie);border:1px solid var(--bordo);border-radius:var(--r-pannello)}
.tab{width:100%;border-collapse:collapse}
.tab th{font-size:12.5px;font-weight:550;color:var(--testo-2);text-align:left;padding:10px 14px;border-bottom:1px solid var(--bordo);white-space:nowrap}
.tab td{padding:11px 14px;border-bottom:1px solid var(--bordo);vertical-align:middle}
.tab tr:last-child td{border-bottom:0}
.tab tr.sopra td{background:var(--rialzo)}
.tab tr.scelto td{background:var(--accento-tinta)}
.linguette{display:flex;gap:22px;border-bottom:1px solid var(--bordo);padding:0 28px;flex:none}
.linguette span{padding:10px 0 11px;font-weight:500;color:var(--testo-2);border-bottom:2px solid transparent;margin-bottom:-1px;display:flex;gap:7px;align-items:baseline}
.linguette span.qui{color:var(--testo);font-weight:650;border-bottom-color:var(--accento)}
.linguette span i{font-style:normal;font-size:12px;color:var(--testo-3)}

/* ---------- tessere (foto) ---------- */
.tess{position:relative;border-radius:var(--r-tessera);overflow:hidden;background:var(--bordo);flex:none}
.tess svg.foto{display:block;width:100%;height:100%}
.tess .segno{position:absolute;top:6px;right:6px;display:flex;gap:4px}
.tess .segno span{display:inline-flex;align-items:center;gap:3px;height:19px;padding:0 6px;border-radius:4px;background:rgba(0,0,0,.58);color:#fff;font-size:11px;font-weight:600;font-stretch:88%}
.tess .segno svg{width:11px;height:11px;stroke-width:2.4}
.tess.sopra::after{content:"";position:absolute;inset:0;background:linear-gradient(180deg,rgba(0,0,0,.42) 0,rgba(0,0,0,0) 34%,rgba(0,0,0,0) 54%,rgba(0,0,0,.62) 100%)}
.tess .chi{position:absolute;left:8px;bottom:7px;right:8px;z-index:2;display:flex;align-items:center;gap:7px;color:#fff;font-size:12.5px;font-weight:600}
.tess .chi span:not(.av){white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-width:0}
.tess .chi small{flex:none;font-weight:400;opacity:.85;margin-left:auto;font-size:11.5px}
.tess .sel{position:absolute;left:7px;top:7px;z-index:2;width:20px;height:20px;border-radius:50%;border:2px solid #fff;background:rgba(0,0,0,.2);display:flex;align-items:center;justify-content:center;color:#fff}
.tess.scelta{outline:3px solid var(--accento);outline-offset:-3px}
.tess.scelta .sel{background:var(--accento);border-color:var(--accento)}
.tess .sel svg{width:12px;height:12px;stroke-width:3.2}
.giorno{display:flex;align-items:baseline;gap:10px;margin:18px 0 8px}
.giorno:first-child{margin-top:2px}
.giorno b{font-size:15px;font-weight:650}
.giorno span{color:var(--testo-2);font-size:13px}
.fila{display:flex;gap:4px;margin-bottom:4px}

/* ---------- striscia della giornata ---------- */
.striscia{position:relative;height:44px;border-radius:6px;background:var(--fondo);border:1px solid var(--bordo);overflow:hidden}
.striscia .notte{position:absolute;top:0;bottom:0;background:repeating-linear-gradient(135deg,var(--tratteggio) 0 2px,transparent 2px 7px)}
.striscia .sess{position:absolute;top:7px;bottom:7px;border-radius:2px;background:var(--accento);min-width:3px}
.striscia .sess.ora{box-shadow:0 0 0 3px var(--accento-tinta)}
.striscia .sess.prev{background:transparent;border:1.5px dashed var(--accento);opacity:.75}
.striscia .freno{position:absolute;top:7px;bottom:7px;border-radius:2px;background:var(--ambra-pieno)}
.striscia .fermo{position:absolute;top:0;bottom:0;background:repeating-linear-gradient(135deg,var(--rosso-tinta) 0 6px,transparent 6px 12px);border-left:2px solid var(--rosso)}
.striscia .adesso{position:absolute;top:0;bottom:0;width:2px;background:var(--testo)}
.striscia .tacca{position:absolute;top:0;bottom:0;width:1px;background:var(--bordo)}
.ore{position:relative;height:18px;margin-top:5px;font-size:11.5px;color:var(--testo-3)}
.ore span{position:absolute;transform:translateX(-50%)}
.ore span:first-child{transform:none} .ore span:last-child{transform:translateX(-100%)}
.legenda{display:flex;gap:18px;font-size:12.5px;color:var(--testo-2);align-items:center}
.legenda span{display:inline-flex;align-items:center;gap:7px}
.legenda i{width:14px;height:10px;border-radius:2px;display:inline-block}

/* ---------- avvisi, dialoghi ---------- */
.avviso{display:flex;gap:11px;align-items:flex-start;padding:11px 13px;border-radius:var(--r-controllo);font-size:13.5px;background:var(--accento-tinta);color:var(--testo)}
.avviso svg{color:var(--accento);margin-top:1px}
.avviso.ambra{background:var(--ambra-tinta)} .avviso.ambra svg{color:var(--ambra)}
.avviso.rosso{background:var(--rosso-tinta)} .avviso.rosso svg{color:var(--rosso)}
.avviso b{font-weight:650}
.velo{position:absolute;inset:0;background:var(--velo);z-index:20;display:flex;align-items:center;justify-content:center}
.dialogo{background:var(--superficie);border-radius:var(--r-dialogo);box-shadow:var(--ombra-dialogo);display:flex;flex-direction:column;overflow:hidden;border:1px solid var(--bordo)}
.dialogo header{display:flex;align-items:center;padding:18px 22px 6px}
.dialogo header h2{margin:0;font-size:18px;font-weight:650}
.dialogo footer{display:flex;align-items:center;gap:10px;padding:14px 22px;border-top:1px solid var(--bordo);background:var(--rialzo)}
.dialogo footer .destra{margin-left:auto;display:flex;gap:10px}
h2.sez{font-size:15px;font-weight:650;margin:0 0 3px}
p.aiuto{margin:0;color:var(--testo-2);font-size:13px}
.etichetta{font-size:13px;font-weight:550;margin-bottom:6px;display:block}
.voce{display:flex;align-items:center;gap:10px}
.sezione{padding:20px 0;border-bottom:1px solid var(--bordo)}
.sezione:first-child{padding-top:4px}
.sezione:last-child{border-bottom:0}

/* ---------- impostazioni: sotto-menu ---------- */
.imp{display:grid;grid-template-columns:238px 1fr;gap:28px;height:100%}
.imp nav{display:flex;flex-direction:column;gap:2px;padding-top:4px}
.imp nav span{white-space:nowrap;display:flex;align-items:center;gap:10px;height:34px;padding:0 10px;border-radius:var(--r-controllo);color:var(--testo-2);font-weight:500}
.imp nav span.qui{background:var(--superficie);border:1px solid var(--bordo);color:var(--testo);font-weight:600}
.imp .cont{max-width:820px;min-width:0}

/* ---------- finestra stretta e telefono ---------- */
@media (max-width:1000px){
  .app{grid-template-columns:64px 1fr}
  .barra{padding:14px 10px;align-items:center}
  .marchio{padding:2px 0 16px} .marchio b{display:none}
  .nav{width:100%} .nav a{justify-content:center;padding:0} .nav a span,.nav a .conta{display:none}
  .stato{padding:10px 0;width:44px;display:flex;flex-direction:column;align-items:center;gap:10px}
  .stato .riga span:not(.spia),.stato .sotto,.stato .conto,.stato .misura,.stato .chi div{display:none}
  .stato .chi{margin:0;padding:0;border:0}
  .testa,.strumenti{padding-left:20px;padding-right:20px} .corpo{padding:0 20px 20px}
  .campo.cerca{width:200px}
}
@media (max-width:560px){
  .app{grid-template-columns:1fr;grid-template-rows:1fr 58px}
  .barra{order:2;flex-direction:row;border-right:0;border-top:1px solid var(--bordo);padding:0 6px;align-items:stretch}
  .marchio,.barra .molla,.stato,.nav .stacco{display:none}
  .nav{flex-direction:row;justify-content:space-around;align-items:center;width:100%}
  .nav a{flex-direction:column;gap:3px;height:48px;width:68px;font-size:10.5px;border:0;background:transparent!important}
  .nav a span{display:block}
  .pagina{height:auto;min-height:0;overflow:hidden}
  .testa{padding:16px 16px 10px} .testa h1{font-size:20px} .corpo{padding:0 16px 16px} .strumenti{padding:0 16px 12px}
}

Appendice C — Marchio e icone

Marchio: quadrato arrotondato nel colore d'accento con un anello e un punto, cioè un corpo e la sua luna. Da questo SVG si ricavano l'icona dell'applicazione, quella dell'area di notifica e quella del modello Unraid.

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
  <rect width="32" height="32" rx="8" fill="#0F5C8C"/>
  <circle cx="14.5" cy="17.5" r="7.4" fill="none" stroke="#FFFFFF" stroke-width="2.6"/>
  <circle cx="23.2" cy="8.8" r="3.1" fill="#FFFFFF"/>
</svg>

Icone: Lucide (licenza ISC), dal pacchetto npm lucide-static, cartella icons. Copia nel repository solo quelle usate e inseriscile come SVG in linea, con tratto 1,75. Elenco di partenza:

Uso Icone
Navigazione layout-grid, users, activity, folder-input, settings
Tipi di contenuto image, clapperboard, circle-dashed, star, square-user, circle-user, layers, play
Stato e avvisi lock, user-check, user, info, triangle-alert, octagon-alert, shield-check, shield-alert, hourglass, gauge, clock, history
Azioni plus, search, x, check, circle-check, refresh-cw, rotate-ccw, rotate-cw, pause, external-link, folder-open, folder, app-window, trash-2, archive, file-down, list-filter, ellipsis, zoom-in, maximize, grid-3x3, square
Frecce arrow-left, chevron-left, chevron-right, chevron-down
Impostazioni sliders-horizontal, key-round, bell, database, sun, moon, monitor, hard-drive

Appendice D — Glossario

Nell'interfaccia Nel codice Significato
Libreria Library L'insieme dei file salvati e il loro indice
Elemento Entry Una pubblicazione: un post, una storia, un contenuto in evidenza
File Media Una singola foto o un singolo video di un elemento
Storia Story Elemento che dura 24 ore
Raccolta in evidenza Highlight Gruppo di storie fissato nel profilo
Taggati Tagged Post di altri in cui l'account compare
Storico Backfill Scaricamento dei contenuti passati
Tieni aggiornato KeepUpdated Controllo ricorrente dei contenuti nuovi
Solo archivio ArchiveOnly Account presente in libreria e mai contattato
Giro dei profili che segui (nel testo: Giro dei seguiti) FollowingSweep Lettura di home e barra delle storie
Sessione Session Un periodo breve di attività del motore
Fascia oraria ActiveWindow Le ore del giorno in cui Febe lavora
Tetto Budget Massimo di azioni per ora o per giorno
Governatore Governor Chi concede o nega ogni azione
Interruttore CircuitBreaker Chi ferma tutto ai segnali di arresto
Rallentamento Throttle Segnale lieve: fermo a tempo
Verifica Challenge Segnale grave: fermo fino all'intervento di Alberto
Profilo di prudenza CautionProfile Prudente, Equilibrato, Rapido, Su misura
Ricetta Recipe Sequenza di gesti con uno scopo
Mappa dei bersagli TargetMap Come una ricetta trova nella pagina ciò su cui agire
Lettore Reader Chi trasforma una risposta in elementi
Sonda Probe Strumento passivo di M0 che registra ciò che la pagina riceve
Impronta visiva PerceptualHash Numero che riconosce la stessa immagine in file diversi
Vista remota RemoteView Il browser del server mostrato nell'interfaccia

Appendice E — Fonti e prove del 13 ottobre 2026

Fonti:

Prove in locale, con Chromium 141 su Xvfb e una pagina servita da 127.0.0.1:

  • porta di debug fissa: navigator.webdriver falso; porta 0 oppure --enable-automation: vero;
  • sul display virtuale la pagina risulta visibile e attiva; con LANG=it_IT.UTF-8 e TZ=Europe/Rome vede lingua it-IT e fuso Europe/Rome;
  • Input.dispatchMouseEvent di tipo rotella: eventi veri, la pagina scorre;
  • Page.startScreencast: fotogrammi consegnati;
  • Network.loadNetworkResource con IO.read: file di 40 MB scaricato integro; senza l'identificativo del frame il comando viene rifiutato.

Non controllabile senza un accesso a Instagram, e quindi lasciato come ipotesi: tutto ciò che riguarda il comportamento attuale del sito (voci H di §6.6) e i tetti di §7.5. Le prove in locale non dicono nulla su WebView2: per quello valgono le voci S.