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

22 KiB
Raw Permalink Blame History

Febe per Windows

La veste Windows di Febe (specifica §12): lo stesso motore e la stessa interfaccia del contenitore Docker, in un'applicazione per Windows 10 e 11. La finestra di Febe mostra l'interfaccia; il browser con cui Febe visita Instagram è una seconda finestra, «Browser di Febe», che resta aperta ma fuori vista quando non ti serve.

Prima di tutto. Scaricare con un programma è contro le condizioni d'uso di Instagram. Febe va piano per ridurre il rischio per l'account (ritmo umano, tetti, fermo al primo segnale), ma non può azzerarlo. Le storie che Febe apre risultano viste da te.

Stato (20 ottobre 2026). Con la 0.1.0 il browser di Febe per Windows non diventava mai disponibile, e l'accesso a Instagram non poteva nemmeno cominciare: WebView2 partiva, ma subito dopo Febe ne leggeva la versione da un thread diverso da quello dell'interfaccia, WebView2 lo rifiutava e Febe, credendo fallito l'avvio, chiudeva il browser e riprovava per sempre (nel registro, a ogni tentativo: «WebView2 non parte (InvalidOperationException: CoreWebView2Environment members can only be accessed from the UI thread.)»). È corretto: su un Windows vero (Windows 11 Pro, runtime WebView2 155.0.4283.62) il browser di Febe parte al primo tentativo, in un paio di secondi.

Ora ci sono anche prove automatiche che girano su Windows, con WebView2 vero e il sito di prova (mai Instagram): S1 con la finestra fuori vista (navigazione, corpi delle risposte, lettura della pagina, scorrimento con la rotella, fotogrammi, scaricamenti dal CDN, comandi vietati rifiutati), la finestra che viene in primo piano e torna fuori vista con il motore fermo nel frattempo, «Scollega», la ripartenza da sola dopo l'arresto del processo del browser, la «composizione» di S2 e una sessione di raccolta intera, con i file che arrivano nella libreria. Vedi «Prove automatiche su Windows», più sotto.

Restano da provare a mano (parte C di docs/prove-dal-vivo.md): l'installazione su un Windows pulito, S2 con la finestra di Febe ridotta a icona e con lo schermo bloccato, S3 (il collegamento che sopravvive a «Esci» e al riavvio di Windows), area di notifica, notifiche, avvio con il computer, e l'accesso vero a Instagram.

Che cosa serve

  • Windows 10 o 11 a 64 bit.
  • Il runtime WebView2 di Microsoft: c'è già in Windows 11 e in quasi tutti i Windows 10. Se manca, sia il programma di installazione sia Febe lo dicono e offrono la pagina ufficiale: https://developer.microsoft.com/microsoft-edge/webview2/ (installazione «Evergreen», senza permessi di amministratore).
  • Nessun permesso di amministratore: Febe si installa solo per il tuo utente.

Installazione

  1. Scarica Febe-Setup-<versione>.exe dalla pagina delle release del repository e aprilo.
  2. Windows può avvisare che il programma non è firmato (SmartScreen): «Ulteriori informazioni» ▸ «Esegui comunque».
  3. Il programma di installazione mette Febe.exe in %LOCALAPPDATA%\Programs\Febe, crea il collegamento nel menu Start e, se lo lasci scelto, uno sul desktop. Febe compare in Impostazioni di Windows ▸ App installate (editore Alberto Balbo).
  4. Alla fine puoi aprire Febe subito.

Versione portabile. Febe-<versione>-portabile.zip contiene lo stesso Febe.exe (e un LEGGIMI.txt): si copia dove si vuole e si apre, senza installazione. Anche la versione portabile tiene i dati in %LOCALAPPDATA%\Febe e la libreria in Immagini\Febe, finché non scegli altre cartelle.

Febe.exe è un file solo (circa 86 MB): contiene il runtime .NET, l'interfaccia e le librerie native (SQLite, SkiaSharp, WebView2Loader). Al primo avvio Windows estrae le librerie native in %TEMP%\.net\Febe: è normale.

Il primo collegamento a Instagram

  1. Apri Febe: la finestra mostra l'interfaccia (la prima volta, la schermata di benvenuto).
  2. Vai in Impostazioni ▸ Collegamento (o «Collegati a Instagram» dal benvenuto). Si apre in primo piano la finestra «Browser di Febe» con la vera pagina di accesso di Instagram.
  3. Scrivi tu nome utente, password e l'eventuale codice della verifica in due passaggi in quella finestra: vanno direttamente alla pagina di Instagram. Febe non riceve e non salva la password; il salvataggio delle password e la compilazione automatica del browser sono spenti.
  4. Quando vedi la tua pagina iniziale di Instagram, torna alla finestra di Febe e premi «Ho finito»: Febe controlla che la sessione ci sia (guarda solo se il cookie esiste, mai il suo valore) e rimette il browser fuori vista.
  5. La prima sessione arriva qualche minuto dopo, con calma: nei primi giorni i tetti sono ridotti (avvio graduale).

La sessione resta nel profilo del browser, in %LOCALAPPDATA%\Febe\browser, e sopravvive ai riavvii di Febe e di Windows (ipotesi S3, da confermare: vedi sotto).

La finestra «Browser di Febe»

  • Ha una dimensione fissa, sempre la stessa (la pagina è di 1280 × 900 punti), e sotto la pagina una barra con «Indietro», «Ricarica» e l'indirizzo (senza la parte dopo il ?).
  • Quando non ti serve non è chiusa né ridotta a icona: è aperta ma spostata fuori dallo schermo, perché il browser deve continuare a caricare e scorrere anche quando non lo guardi (ipotesi S2). Non ha un pulsante nella barra delle applicazioni.
  • La porti in primo piano dalla finestra di Febe: «Apri il browser» (Attività, striscia rossa di un arresto) o «Portalo in primo piano» (Collegamento).
  • Mentre la usi il motore resta fermo. Quando hai finito, chiudila (la X o «Ho finito» nel Collegamento): torna fuori vista e il motore può ripartire. Dopo una verifica, «Riprendi» si accende solo dopo che hai usato il browser. Con --raccolta richieste solo «Ho finito» copia la sessione per le richieste: chiudere con la X non la copia.
  • «Scollega» (Collegamento) chiede conferma, ferma il motore, cancella la sessione salvata per le richieste (Dati\sessione\sessione.json, se c'è), chiude il browser e cancella Dati\browser con la sessione. Per chiudere la sessione anche dal lato di Instagram, prima esci dal sito usando tu il browser.

Un account, un motore

Non usare insieme Febe per Windows e il contenitore Docker con lo stesso account Instagram. Due Febe che raccolgono con lo stesso account sommano le visite e raddoppiano il rischio. Lo dice anche la pagina Collegamento. Per un secondo account serve un secondo Febe con cartelle tutte sue (Febe.exe --dati D:\FebeSecondo --libreria D:\FotoSecondo). Febe impedisce due avvii sulla stessa cartella dei dati: un secondo avvio porta in primo piano quello già aperto. Vale anche subito dopo uno spostamento della cartella dei dati (il Febe che l'ha spostata tiene anche il nome della nuova) e con due modi di scrivere la stessa cartella (nome corto, subst, collegamenti): finché Febe è aperto tiene il file febe.lock nella cartella dei dati, e un secondo Febe che lo trova occupato si ferma e lo dice.

Area di notifica

L'icona di Febe (il marchio: un quadrato blu con un anello e una luna) sta nell'area di notifica, accanto all'orologio. Un clic apre la finestra; il menu ha Apri, Metti in pausa (o Riprendi, quando Febe è in pausa o fermo per una verifica) ed Esci. Il suggerimento dell'icona dice che cosa sta facendo Febe.

Chiudendo la finestra Febe resta attivo nell'area di notifica e continua a lavorare (Impostazioni ▸ Generali ▸ Avvio, «Chiudendo la finestra, Febe resta attivo nell'area di notifica», acceso di serie). Per fermarlo davvero: menu dell'icona ▸ Esci. Esci ferma tutto in ordine (motore, scaricamenti, browser): il browser si chiude in modo pulito e la sessione resta scritta nel profilo.

Notifiche di Windows

Gli avvisi di §13.3 (verifica richiesta, disconnessione, fermo per rallentamento e fine del fermo, storico completato, formato non riconosciuto e ricetta sospesa, disco quasi pieno) arrivano come notifiche di Windows, dall'icona di Febe. Si scelgono in Impostazioni ▸ Notifiche («Notifiche di Windows» e gli eventi), dove si può aggiungere anche Telegram: gli avvisi sono gli stessi della veste Docker (AlertService, nella composizione condivisa), e le notifiche passano dal guscio di Windows (NativeShellAlertChannel su WindowsShell.NotifyAsync). Un clic sulla notifica apre Febe. La prova dal vivo è la parte D4 di docs/prove-dal-vivo.md.

Avvio con il computer

Impostazioni ▸ Generali ▸ Avvio ▸ «Avvia Febe all'accensione del computer». Febe scrive il valore Febe in HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run (solo per il tuo utente) e all'accensione parte con --nascosto: solo l'icona nell'area di notifica, la finestra resta chiusa. Togliendo la spunta il valore sparisce; lo toglie anche la disinstallazione.

Un Febe avviato con --dati (un secondo account) ha un valore suo, Febe- seguito da sedici cifre esadecimali, con --nascosto --dati "<cartella>": all'accensione parte quella cartella, e l'interruttore di un Febe non accende, non mostra e non toglie l'avvio dell'altro. La disinstallazione toglie anche questi valori, se avviano il Febe.exe disinstallato.

Dove stanno le cose

Che cosa Dove Note
Programma %LOCALAPPDATA%\Programs\Febe\Febe.exe Dove l'hai copiato, per la versione portabile
Dati di Febe %LOCALAPPDATA%\Febe Database febe.sqlite, profilo del browser con la sessione di Instagram (browser\), dati della finestra dell'interfaccia (interfaccia\), miniature, copie del database (copie\, sette giorni), registro (registro\, quattordici giorni)
Libreria Immagini\Febe Foto e video, una cartella per account, con _febe.jsonl
  • Chi ha la cartella dei dati, o una sua copia, ha la sessione di Instagram. Trattala come una password: niente copie su chiavette, cartelle condivise o servizi di sincronizzazione (OneDrive, Dropbox…). %LOCALAPPDATA% non è sincronizzato da OneDrive: lasciala lì.
  • La cartella dei dati deve stare su un disco locale: su una cartella di rete Febe non parte e lo spiega.
  • Cambiare la libreria (Impostazioni ▸ Generali ▸ Libreria ▸ «Cambia…»): vale subito per i nuovi file; gli account che hanno già file restano nelle loro cartelle. Febe non sposta nessun file.
  • Cambiare la cartella dei dati (Impostazioni ▸ Generali ▸ Dati di Febe ▸ «Cambia…»): la nuova cartella deve essere vuota e su un disco locale. Lo spostamento avviene al prossimo avvio, prima che Febe apra qualunque cosa: copia ogni file, lo rilegge e ne confronta lo SHA-256 con l'originale; solo se tutte le copie sono uguali usa la nuova cartella e cancella la vecchia (che conteneva una copia della sessione). Se qualcosa va storto la vecchia cartella resta quella in uso, intatta, e la copia parziale viene tolta. Per farlo subito: Esci e riapri Febe. La cartella scelta è scritta in HKEY_CURRENT_USER\Software\Febe (CartellaDati); con --dati decide invece la riga di comando.

Riga di comando

Opzione Che cosa fa
--nascosto Parte con la sola icona nell'area di notifica (lo usa l'avvio con il computer)
--dati <cartella> Cartella dei dati diversa (un secondo account, le prove); «Cambia…» allora non c'è
--libreria <cartella> Libreria di partenza diversa (una cartella scelta poi nelle Impostazioni vince)
--browser finestra|composizione|edge Come è ospitato il browser di Instagram (prove di S2, sotto); la scelta resta per gli avvii successivi
--sviluppo Strumenti di sviluppo nella finestra dell'interfaccia (mai nel browser di Febe)
--sito-di-prova http://127.0.0.1:8481 Sviluppo e prove: il browser lavora sul sito di prova locale invece che su Instagram
--accesso-di-prova Solo con --sito-di-prova: apre il sito una volta, come dopo un accesso
--prima-sessione <secondi> La prima sessione dopo questi secondi invece che dopo 2–10 minuti
--raccolta pagine|richieste Come le ricette leggono il sito (specifica §6.0, #36): pagine, il predefinito, con il browser come sempre; richieste con il client del sito e la sessione salvata, copiata a «Ho finito» e cifrata con DPAPI per il tuo utente di Windows. Vale solo se il catalogo del sito ha operazioni configurate: con Instagram, per ora, non cambia nulla

Sicurezza dell'interfaccia

L'interfaccia è servita da Febe stesso su 127.0.0.1, su una porta scelta a ogni avvio, e risponde solo con il gettone di quell'avvio, che conosce solo la finestra di Febe: la finestra apre /?gettone=… una volta, il gettone diventa un cookie HttpOnly, SameSite=Strict e sparisce dall'indirizzo. Si controllano anche Host e Origin: un'altra pagina aperta nel tuo browser non può comandare Febe. Gli indirizzi esterni (guida, repository, «Apri su Instagram») si aprono nel tuo browser predefinito, mai nel browser di Febe.

Il browser di Febe e le ipotesi S1–S3

Su Windows il browser di Instagram è WebView2 (il motore di Edge), pilotato con il protocollo DevTools attraverso CallDevToolsProtocolMethodAsync e GetDevToolsProtocolEventReceiver (non il pacchetto DevToolsProtocolExtension, deprecato), con lo stesso elenco di comandi ammessi del Chromium di Docker e gli stessi rifiuti: nessun comando fuori elenco arriva al browser, Runtime.evaluate solo in lettura, nel registro solo i nomi dei comandi.

Per S2 (la pagina deve continuare a caricare e scorrere quando la finestra non è in vista) ci sono tre modi, nell'ordine della specifica (§6.6); si sceglie con --browser e la scelta resta:

  1. finestra (predefinito): la finestra «Browser di Febe» aperta ma fuori dallo schermo; il controllo WebView2 resta sempre «visibile» (IsVisible vero: se diventa falso WebView2 smette di disegnare) e il rilevamento dell'occlusione è spento dagli argomenti del browser: --disable-features=CalculateNativeWinOcclusion e --disable-backgrounding-occluded-windows. Non sono vietati dalla regola 2: cambiano come il browser organizza il proprio lavoro, non ciò che dichiara (user agent, client hints, navigator, lingua, fuso e intestazioni restano quelli di un Edge normale; nella pagina non entra nulla).
  2. composizione: lo stesso, con WebView2 ospitato come visual di DirectComposition invece che come finestra figlia; Febe passa al browser il mouse e il puntatore della zona della pagina.
  3. edge: Microsoft Edge avviato come processo e pilotato come il Chromium di Docker (ChromiumProcessHost, porta di debug fissa 9222 solo su 127.0.0.1), profilo in Dati\browser\edge; la sua finestra viene spostata fuori dallo schermo. Se Edge non c'è, Febe usa la finestra. Ogni Edge avviato da Febe sta in un job object di Windows che lo chiude insieme a Febe.exe, anche se Febe si chiude all'improvviso o da Gestione attività: un Edge rimasto aperto terrebbe la porta 9222 e il browser di Febe non ripartirebbe più.

Come tutti gli oggetti di WebView2, ambiente, controllo, pagina e ricevitori degli eventi DevTools vivono sul thread dell'interfaccia: Febe li tocca solo da lì (i comandi del motore arrivano da altri thread e ci passano attraverso il dispatcher di WPF), e il resto del programma legge solo valori semplici presi durante l'avvio, come la versione per il registro. Se il processo del browser si chiude da solo, Febe lo fa ripartire con lo stesso profilo e con gli stessi tentativi del primo avvio (5, 15, 30, 60 secondi, poi ogni 5 minuti), e lo stesso se dopo «Scollega» non ripartisse. Nella finestra c'è sempre un solo browser: se «Scollega» lo fa ripartire mentre il primo avvio aspetta il prossimo tentativo, quel tentativo lo trova già in funzione e non ne apre un secondo.

Le prove da fare su un Windows vero, con la procedura esatta, sono in docs/prove-dal-vivo.md, parte C. In breve:

  • S1 — con il sito di prova: una sessione intera (gesti, corpo delle risposte, scaricamenti) e l'anteprima di Attività. La parte che non dipende dall'installazione è già una prova automatica su Windows (sotto).
  • S2 — la stessa sessione con il browser fuori vista, con la finestra di Febe ridotta a icona e con lo schermo bloccato; poi, se serve, composizione e edge.
  • S3 — accesso a mano, «Esci», riapertura, riavvio di Windows: il collegamento deve restare.

Disinstallare

Impostazioni di Windows ▸ App ▸ App installate ▸ Febe ▸ Disinstalla (oppure «Disinstalla Febe.exe» nella cartella del programma). Prima esci da Febe (menu dell'icona ▸ Esci).

La disinstallazione toglie il programma, i collegamenti, la voce in App installate e l'avvio con il computer. Non cancella mai la cartella dei dati né la libreria e non chiede nulla su di loro: alla fine dice dove sono. Se non ti servono più, cancellale tu — la cartella dei dati contiene la sessione di Instagram.

Costruire il programma di installazione

Da Linux (CI, rilascio) o da Windows con bash, con il .NET SDK 10 e NSIS 3 (apt-get install nsis):

installer/costruisci.sh            # versione di Directory.Build.props
installer/costruisci.sh 0.2.0      # oppure una versione esplicita

Il risultato è in out/: Febe-Setup-<versione>.exe e Febe-<versione>-portabile.zip, ognuno sotto i 100 MB (limite degli allegati di Gitea; con la versione 0.1.0: Febe.exe 86 MB, installazione 80 MB, zip 81 MB). Lo script controlla che la pubblicazione abbia prodotto un solo file e che nulla superi il limite. Lo script NSIS è installer/febe.nsi (Unicode, testi in italiano, versione passata con /DVERSION=…).

L'icona src/Febe.Desktop/Febe.ico (16, 24, 32, 48, 64, 128 e 256 pixel) è disegnata dal marchio dell'appendice C con SkiaSharp e scritta a mano: per rigenerarla dopo un cambio del marchio, FEBE_RIGENERA_ICONA=1 dotnet test tests/Febe.Tests --filter IconTests.

Prove automatiche su Windows

tests/Febe.Tests.Windows contiene le prove che hanno bisogno di Windows e di WebView2 vero. Si compila anche da Linux (la CI compila tutta la soluzione), ma gira solo su Windows, con il .NET SDK 10 e il runtime WebView2; dove il runtime manca le prove risultano inconcludenti, non rosse:

dotnet test tests/Febe.Tests.Windows
dotnet test tests/Febe.Tests.Windows --filter "FullyQualifiedName~WebView2CdpTests"   # una classe sola

Ogni prova crea un thread dell'interfaccia di WPF vero (come quello di Febe.exe), il proprio sito di prova su porte libere di 127.0.0.1 (il suo «CDN» su 127.0.0.2) e cartelle temporanee in %TEMP%: niente tocca la cartella dei dati né la libreria vere. La finestra «Browser di Febe» resta fuori dallo schermo, tranne in due prove che la portano in primo piano per un attimo: una prova il primo piano da solo, l'altra il percorso intero di «Accedi a Instagram» e «Ho finito». Una prova chiude, con il suo numero di processo, il processo del browser che lei stessa ha avviato, per vedere Febe farlo ripartire. Tutte insieme durano due o tre minuti, quasi tutti della sessione di raccolta.

Classe Che cosa prova
WebView2BrowserStartTests Avviato da un thread del pool, come fa la composizione, il browser è pronto al primo tentativo e il registro dice «Browser di Febe pronto: WebView2 …» (l'errore del 14 ottobre)
WebView2LifecycleTests Un avvio che fallisce davvero si riprova e poi va; primo piano e fuori vista con il permesso di guida; «Scollega»; «Scollega» mentre il primo avvio aspetta di riprovare (un solo browser nella finestra, il «Scollega» dopo riesce subito); «Esci» mentre l'avvio non si completa (non lo aspetta); ripartenza dopo l'arresto del processo; «composizione» di S2
WebView2CdpTests S1: i comandi dell'elenco su WebView2 contro il sito di prova, con la finestra fuori vista, e i comandi vietati rifiutati
WebView2CollectionTests Una sessione vera della composizione (FebeApp con DesktopPlatform) su WebView2: i file arrivano nella libreria
WebView2ConnectionTests Il collegamento dal servizio vero della composizione: «Accedi a Instagram» porta in primo piano la finestra con la pagina di accesso (del sito di prova), «Ho finito» trova la sessione e la rimette fuori vista, «Scollega» cancella il profilo e il motore riparte

Quello che di WebView2CdpSession non chiede Windows (per esempio: un errore di chi ascolta la ripartenza non disfa l'avvio) si prova invece in tests/Febe.Tests/Desktop/WebView2CdpSessionTests.cs, con un finto WebView2: gira anche sulla CI per Linux.

Problemi comuni

Che cosa vedi Che cosa fare
All'avvio: «Manca il runtime WebView2 di Microsoft» Installa il runtime dalla pagina ufficiale (il messaggio offre di aprirla), poi riapri Febe
Nel registro, a ogni tentativo: «WebView2 non parte (InvalidOperationException: CoreWebView2Environment members can only be accessed from the UI thread.)»; «Accedi a Instagram» risponde che il browser di Febe non è in funzione È l'errore della 0.1.0: il browser di Febe non diventava mai disponibile. Installa una versione successiva alla 0.1.0
«La cartella dei dati è su un disco di rete» o «non può scrivere» Riapri Febe con una cartella dei dati su un disco locale (--dati), oppure libera la cartella
Aprendo Febe si porta solo in primo piano la finestra già aperta È voluto: un solo Febe per cartella dei dati. Per fermarlo: menu dell'icona ▸ Esci
Il collegamento risulta perso dopo un riavvio È l'ipotesi S3: riferiscilo (parte C di docs/prove-dal-vivo.md) con l'ora e il registro di quel giorno
Il browser sembra fermo mentre è fuori vista È l'ipotesi S2: prova Febe.exe --browser composizione, poi --browser edge, e riferisci
Il registro %LOCALAPPDATA%\Febe\registro\febe-AAAA-MM-GG.log: azioni ed esiti, mai password, cookie, tasti o contenuti