Riferimento
File e ambiente
Dove Ferret conserva i propri file, e le variabili d'ambiente che legge o imposta.
#Cartella userData
I dati dell'app si trovano nella cartella userData di Electron. Il suo nome è fissato su ade-movie (non sul nome del prodotto), così i dati sopravvivono ai cambi di nome. Puoi sovrascriverla con --user-data-dir=<path>.
| Sistema operativo | Percorso |
|---|---|
| macOS | ~/Library/Application Support/ade-movie/ |
| Windows | %APPDATA%\ade-movie\ |
| Linux | ~/.config/ade-movie/ (oppure $XDG_CONFIG_HOME/ade-movie/) |
settings.json # settings before 0.1.1, kept as a backup (now ~/.ferret/settings.json)
stt-keys.bin # API keys, encrypted with safeStorage
models/ # downloaded whisper models (ggml-*.bin)
accounts/claude/<id>/ # CLAUDE_CONFIG_DIR for added accounts
accounts/codex/<id>/ # CODEX_HOME for added accounts
Le tue impostazioni non sono in questa cartella: si trovano in ~/.ferret/ (vedi Configurare con settings.json).
Un modello scelto da te può trovarsi ovunque. Viene ancora controllato il vecchio percorso predefinito ~/.cache/ade-movie/models/ggml-small.bin.
#Variabili d'ambiente
| Variabile | Effetto |
|---|---|
CLAUDE_CONFIG_DIR, CODEX_HOME | Impostate da Ferret per le schede degli agent quando è selezionato un account aggiunto |
GH_TOKEN, GITHUB_TOKEN | Usate da gh prima del proprio accesso. Ferret avvisa quando una delle due è impostata |
FERRET_CONFIG_DIR (o il vecchio MOVIE_ADE_CONFIG_DIR) | Cartella per settings.json, state.json e settings.schema.json al posto di ~/.ferret |
Nomi indicati in apiKeyEnv | Chiavi API a cui fai riferimento da settings.json. Vengono lette anche dal .env del progetto e da ~/.ferret/.env |
ADE_PROJECT_DIR | Apre (e registra) questa cartella come progetto all'avvio |
ADE_INITIAL_URL | Carica questo URL nel browser integrato all'avvio |
ADE_WHISPER_MODEL | Percorso assoluto di un modello GGML da usare per la trascrizione sul dispositivo, al posto di quello predefinito scaricato |
FERRET_SENTRY_DSN (o il vecchio MOVIE_ADE_SENTRY_DSN) | Dove vanno i report sugli arresti anomali. Se è vuota non viene inviato nulla (vedi Report sugli arresti anomali) |
OPENAI_API_KEY | Letta da .env solo in sviluppo (pnpm dev), mai nelle build pacchettizzate |
PATH | Usata per trovare i comandi dei tuoi agent (claude, codex, gemini…), gh, git, whisper-cli. Su macOS e Linux vengono aggiunti i percorsi di Homebrew, linuxbrew e snap |
#Dentro il tuo progetto
.ferret/reviews/<id>/: le revisioni (vedi Dati e privacy). Le revisioni precedenti in.ade-movie/reviews/vengono ancora lette.git/info/exclude: una riga,.ferret/, aggiunta alla prima registrazione
Aiuta a tradurre questa pagina su GitHub (si apre in una nuova scheda)