Files
Febe/docs/windows.md
T
2026-10-14 00:59:18 +00:00

220 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.** Questa versione è stata costruita e provata su Linux: tutto ciò che non dipende da Windows ha le sue prove
> automatiche, ma **nessuna parte che richiede Windows è ancora stata eseguita su un Windows vero** (finestre, WebView2,
> area di notifica, registro, programma di installazione). Le prove da fare sono in fondo a questa pagina e in
> `docs/prove-dal-vivo.md`, parte C.
## 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.
- «Scollega» (Collegamento) chiede conferma, ferma il motore, 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 |
## 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ù.
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à.
- **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`):
```sh
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`.
## 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 |
| «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 |