Questa pagina descrive Calíope 1.5, la versione che stiamo costruendo adesso. La 1.4 è finita ed è in revisione sull'App Store, e il negozio serve oggi la 1.3 sul Mac e la 1.2 su iPad. Il changelog dice in quale versione è arrivata ogni funzione.
Aggiunge a ogni argomento un pulsante «Apri in Calíope». Funziona solo con l'app installata.
Calíope non registra nulla finché non lo attivi, e non lo invia mai.
Dove si trova: Calíope › Preferenze › Generale → Privacy e diagnostica
La registrazione è spenta di serie. Non viene registrato nulla finché non la attivi in Preferenze › Generali › Privacy e diagnostica › Tenere un rapporto d'uso su questo dispositivo. Finché è spenta, questo file non cresce.
Calíope conserva un registro di diagnostica esclusivamente sul tuo dispositivo, nel file:
Nessuno riceve questo file senza che tu lo invii esplicitamente. Il registro ha un limite di 500 eventi; i più vecchi vengono scartati automaticamente.
Parole chiave: privacy, telemetria, diagnostica, locale, dati, json
Elenco esatto degli eventi che Calíope memorizza localmente.
Il file di diagnostica contiene:
Informazioni del dispositivo (registrate una sola volta all'avvio):
- Versione dell'app
- Piattaforma (macOS / iPadOS / iOS)
- Versione del sistema operativo
- Modello del dispositivo (p. es. "MacBookPro18,1")
Eventi di connessione:
- connection.opened — connessione MySQL stabilita con successo
- connection.ssh.opened — tunnel SSH aperto con successo
- connection.error — errore di connessione (dominio e codice dell'errore; senza host né credenziali)
- ssh.error — errore nel tunnel SSH (tipo di errore; senza host né credenziali)
Non viene mai registrato: query SQL, nomi di database, host, IP, utenti, password né alcun dato di schema.
Parole chiave: dati, privacy, cosa si salva, eventi, registro, telemetria
Come visualizzare il JSON e inviarlo insieme ai tuoi commenti.
Dove si trova: Calíope › Preferenze › Generale → Privacy e diagnostica
Prima che ci sia qualcosa da vedere, la registrazione deve essere attiva in Preferenze › Generali › Privacy e diagnostica. Se è spenta, il rapporto sarà vuoto — non è un guasto.
Puoi vedere il contenuto completo della diagnostica in Preferenze › Generale › Privacy e diagnostica. Da lì puoi:
- Condividi — apre il pannello di condivisione del sistema per inviarlo via email, AirDrop o altre app.
- Copia JSON — copia il contenuto negli appunti per incollarlo manualmente.
- Pulisci — elimina tutti gli eventi registrati.
Se rilevi qualche problema o hai suggerimenti, invia il file insieme al tuo messaggio a support@caliope.org.
Cancella in modo permanente ciò che Calíope conserva su questo dispositivo e su iCloud, e ti dice cosa è stato eliminato in ogni posto.
Dove si trova: Calíope › Preferenze › Generale → Elimina i miei dati
La sezione Elimina i miei dati in Preferenze › Generali cancella ciò che Calíope conserva, nei sei posti in cui lascia qualcosa.
Cosa viene eliminato
Dove
Cosa
Questo dispositivo
Profili di connessione, cronologia delle query, registro degli errori, cronologia dell’Assistente IA, telemetria, cache degli schemi, file SQL recenti, frammenti e voci del monitor
Portachiavi
Password di connessione, passphrase delle chiavi SSH e chiavi API dei provider cloud
iCloud Drive
connections.json, lo stato dell’editor, la configurazione di monitoraggio e la cartella dei backup programmati
Preferenze su iCloud
L’intero archivio chiave-valore
Record su iCloud
Cronologia delle query, cronologia dell’Assistente IA e registro degli errori conservati in CloudKit
Widget
I dati con cui il widget si disegna
Riguarda tutti i tuoi dispositivi. Alla fine Calíope pubblica un avviso su iCloud; iPad e iPhone eliminano la loro copia alla prossima apertura. Senza quell’avviso, il dispositivo che continuava a sincronizzare ricaricava tutto e l’eliminazione si annullava da sola.
I record di iCloud vengono eliminati anche con la sincronizzazione spenta. L’interruttore dice se si carica d’ora in avanti, non se c’è già qualcosa lassù: chi l’ha attivato, ha caricato e poi l’ha spento ha i suoi dati su iCloud — ed è proprio quello che va cancellato.
Prima di eliminare viene salvato un punto di ripristino. È locale, contiene profili e preferenze e nessuna password — non c’è nessuno lì a digitare una chiave di cifratura. Lo trovi in Preferenze › Backup. Per conservare anche le password, esporta a mano prima, spuntando la casella dei segreti.
Alla fine ti viene mostrato cosa è successo in ogni posto, con il numero di elementi eliminati. Ciò che non si è potuto eliminare appare in rosso con il motivo: senza sessione iCloud o senza rete i record di CloudKit non sono raggiungibili da qui, e non è la stessa cosa che essere cancellati. Ripeti l’operazione quando torni online; ciò che è già stato eliminato non viene eliminato due volte.
Cosa non viene toccato: i file che hai esportato tu su disco (backup .sql, copie della configurazione, schermate), perché stanno fuori dall’app e sono tuoi.
Parole chiave: eliminare dati, cancellare, privacy, portachiavi, cronologia, profili, icloud, cloudkit, gdpr, punto di ripristino, rapporto, tutti i dispositivi
I quattro meccanismi iCloud usati da Calíope: cosa fa uscire ciascuno da questo dispositivo, chi lo legge e quale interruttore lo governa.
Dove si trova: Calíope › Preferenze › Generali → iCloud
Calíope non ha una sincronizzazione, ne ha quattro, e ognuna conserva cose diverse. Sapere quale è quale spiega perché ci sono più interruttori.
1. iCloud Drive — i file grandi: i tuoi profili di connessione, il contenuto delle schede dell'editor SQL e la configurazione del monitor di salute. Governato da Sincronizza Calíope con iCloud, in Preferenze › Generali › iCloud.
2. Archivio chiave-valore — le preferenze e la personalizzazione: dimensione del carattere, snippet salvati, soglie di allerta, ordine delle barre, disposizione dei pannelli. Stesso interruttore, e occupa molto poco.
3. CloudKit — cinque canali, e ognuno ha un interruttore proprio, spento di fabbrica. Stanno separati dall'interruttore generale perché fanno uscire da questo dispositivo dati che possono essere delicati, e quel permesso si chiede, non si eredita.
- Cronologia delle query — il testo letterale delle tue query, con nomi di tabelle e valori. Interruttore Sincronizza la cronologia con iCloud, dentro il Registro SQL stesso. La leggono i tuoi altri dispositivi con Calíope.
- Conversazioni con l'assistente IA — le tue domande e le risposte, così come sono. Interruttore Sincronizza la cronologia con iCloud, nel pannello della cronologia dell'assistente.
- Registro errori dell'app — gli alias dei tuoi profili e il dettaglio tecnico di ogni errore. Interruttore Sincronizza il registro errori con iCloud, in Preferenze › Generali › Registro errori dell'app. Lo leggono i tuoi altri dispositivi con Calíope, iPhone compreso.
- Messaggi di sistema — l'alias del profilo o del server, il nome del backup o del report, la macchina che l'ha prodotto e le cifre dell'avviso (secondi, righe, percentuale); mai l'host, la porta, l'utente né il testo delle tue query. Interruttore Sincronizza i messaggi con iCloud, in Preferenze › Generali › Messaggi di sistema. Li legge Calíope sull’orologio.
- Stato del parco server — di ogni server sorvegliato: l'alias, l'host, la porta, il motore, la versione e le sue metriche; e di ogni gruppo di replica che hai dichiarato, il suo nome più l'etichetta, il ritardo e lo stato di ciascun membro. Mai password, mai il contenuto delle tue query. Interruttore Pubblica lo stato dei server su iCloud, in Preferenze › Generali › Apple TV. Lo legge Calíope sull'Apple TV; spegnendolo si ritira da iCloud quanto era già pubblicato.
4. Portachiavi iCloud — solo le password e le chiavi SSH, con il proprio interruttore in Preferenze › Generali › iCloud. Apple lo cifra end-to-end.
Cosa non lascia mai questo dispositivo, qualunque cosa tu attivi:
- Il registro diagnostico (telemetry.json).
- La cache degli schemi che alimenta il completamento automatico.
- I permessi di accesso ai file che macOS ti concede (chiavi SSH, cartelle di destinazione dei backup). Tecnicamente sono bookmark, validi solo sulla macchina dove li hai concessi.
- Le schede aperte alla chiusura, deliberatamente diverse su ogni dispositivo.
Parole chiave: sincronizzazione, icloud, cosa si sincronizza, cloudkit, portachiavi, privacy, chiave-valore, dispositivi, interruttori, consenso, caliope tv, apple tv, televisore, watch, orologio, companion, iphone, parco server, fleet, messaggi di sistema
I widget leggono un file locale di metriche, mai le tue credenziali.
Per disegnare un widget, Calíope e il widget devono condividere dati. Lo fanno attraverso una cartella di sistema condivisa (un App Group), non via internet.
Cosa c'è in quella cartella:
- Le metriche del server che hai fissato: connessioni attive, query al secondo, tempo di attività, tasso di successo della cache.
- Un elenco minimo dei tuoi profili — nome e host — per poter scegliere un server quando configuri il widget.
Cosa non c'è, e non può esserci: password, chiavi API, chiavi SSH o risultati di query. Le credenziali risiedono nel Portachiavi e il widget non le chiede mai.
Quella cartella non si sincronizza con iCloud. È deliberato: contiene dati derivati che scadono in due minuti e che ogni dispositivo ricostruisce da sé. Viene svuotata completamente con Elimina tutti i miei dati.
Salva in un file le tue connessioni, preferenze e cronologia, e torna a esse quando vuoi.
Dove si trova: Calíope › Preferenze › Impostazioni › Generali
In Impostazioni › Generali › Backup della configurazione, «Esporta…» crea un file JSON con tutto ciò che Calíope conserva: connessioni e gruppi, stato dell'editor, preferenze e cronologia delle query. Scegli cosa includere, e ciò che resta fuori viene annotato nel file con il suo motivo — per esempio i permessi dei file recenti, che valgono solo sulla macchina dove sono stati concessi.
Le password sono a parte: escono solo se spunti la casella, e sempre cifrate con una chiave che scrivi tu. Senza quella chiave non c'è modo di recuperarle, nemmeno da Calíope.
Quando importi vedi prima un riepilogo di ciò che cambierà: quante connessioni si aggiungono, quante si aggiornano e — la cosa importante — quante esistono solo su questo dispositivo. In modalità «Unisci» queste si conservano; in «Sostituisci» si perdono. Prima di applicare qualsiasi cosa, l'app lascia il proprio punto di ripristino.
Anche senza le password, il file contiene nomi di server, utenti e il testo delle tue query: conservalo in un posto sicuro.
Parole chiave: backup, esportare, importare, ripristinare, configurazione, migrare, altra macchina, JSON
Calíope può salvare una copia della tua configurazione ogni giorno o ogni settimana, e tenerla su iCloud.
Dove si trova: Calíope › Preferenze › Impostazioni › Generali
In Impostazioni › Generali › Backup della configurazione puoi far sì che Calíope crei una copia ogni giorno o ogni settimana. Quelle copie vivono nel tuo iCloud, quindi sopravvivono alla perdita della macchina e puoi ripristinarle da qualsiasi tuo dispositivo.
Decidi tu quante conservarne; oltre quel numero vengono eliminate le più vecchie. Non includono mai le password, perché si creano da sole e non c'è nessuno davanti a scrivere la chiave di cifratura.
La frequenza appartiene a ogni dispositivo e non si sincronizza: se vuoi copie dal Mac, dall'iPad e dall'iPhone, attivala su ciascuno. E se iCloud non è disponibile, le copie restano solo su questa macchina e l'app te lo dice.
Prima di ogni operazione che può distruggere qualcosa, Calíope salva una copia per conto suo.
Dove si trova: Calíope › Preferenze › Impostazioni › Generali
Oltre ai backup che chiedi tu, Calíope lascia una copia automatica subito prima delle operazioni che possono portare via dei dati: attivare o disattivare la sincronizzazione con iCloud, cancellare tutti i tuoi dati, ripristinare un backup e la prima modifica salvata in ogni sessione.
Questi punti di ripristino restano su questa macchina e mai su iCloud, ed è voluto: il loro compito è salvarti proprio da ciò che può succedere a quello che sta su iCloud.
Si conservano i dieci più recenti e, in più, l'ultimo di ogni tipo — così quello di «prima di attivare iCloud» non viene spinto fuori da dieci copie di routine. Li vedi e li ripristini in Impostazioni › Generali › Backup della configurazione.
Parole chiave: punto di ripristino, annullare, prima di cancellare, automatico, locale, recuperare, sicurezza
Per quanto tempo si conserva il registro delle query
Le query registrate si cancellano da sole dopo il tempo che scegli, sul disco e su iCloud.
Dove si trova: Calíope › Preferenze › Impostazioni › Generali
In Impostazioni › Generali › Registro puoi scegliere per quanto tempo Calíope conserva le query che registra: 30, 90, 180 o 365 giorni, oppure senza limite.
La pulizia raggiunge entrambi i posti in cui vivono: il file di questa macchina e la copia su iCloud, se hai attivato la sincronizzazione del registro. Viene eseguita una volta al giorno, a lotti, quindi un registro molto grande può richiedere diversi giorni per essere ridotto del tutto.
«Senza limite» è una scelta legittima — c'è chi vuole lo storico completo — ma conviene sapere cosa comporta: il file cresce finché dura l'installazione, e la copia su iCloud occupa spazio del tuo account.
La cronologia che vedi nell'editor SQL è un'altra cosa: sono le ultime query di ogni connessione, conservate solo su questo dispositivo e mai sincronizzate.
Parole chiave: conservazione, registro, cronologia, eliminare, giorni, pulizia, iCloud, spazio