enne2
e1acad4a27
Esc è riservato alla built-in app.interrupt di pi: la shortcut veniva scartata con warning 'conflicts with built-in shortcut'. Rimossa anche la registrazione ridondante 'esc' (stesso tasto fisico). Aggiornati messaggi di stato e documentazione.
5.0 KiB
5.0 KiB
Comandi Slash & Scorciatoie da Tastiera
agy-pi mette a disposizione un ricco set di comandi slash interattivi e scorciatoie globali per interagire con l'estensione direttamente dal terminale di pi.
Comandi Slash (Slash Commands)
Gestione Conversazione agy
| Comando | Descrizione | Sintassi / Esempio |
|---|---|---|
/agy |
Invia un prompt diretto al subagent agy |
/agy Spiega la teoria della relatività |
/agy:new |
Forza la creazione di una nuova conversazione pulita | /agy:new |
/agy:list |
Mostra l'ID della conversazione agy attiva | /agy:list |
/agy:reset |
Azzera l'ID conversazione salvato in locale | /agy:reset |
Configurazione & Diagnostica TUI
/agy:config
Gestisce le opzioni di configurazione salvate in ~/.config/agy-pi/config.json.
/agy:config: Mostra l'elenco completo di tutte le opzioni con i valori attuali e le descrizioni./agy:config get <chiave>: Stampa il valore di una singola chiave./agy:config set <chiave> <valore>: Modifica il valore di una chiave e salva su disco./agy:config reset: Ripristina le impostazioni predefinite di fabbrica.
/agy:key (Dialog TUI Overlay)
Apre una finestra di dialogo grafica in sovrimpressione nel terminale (pi-tui overlay) per inserire o modificare la chiave API Gemini:
┌────────────────────────────────────────────────────────┐
│ 🔑 Chiave API Gemini │
│ Attuale: AIza...yfDY │
│ │
│ Nuova chiave: ••••••••••••••••••••••••••••••••••••• │
│ │
│ Digita la chiave • Enter conferma • Esc annulla │
└────────────────────────────────────────────────────────┘
- Input mascherato per prevenire il leak della chiave sul terminale o nella cronologia.
- Salva contemporaneamente la chiave in
~/.config/agy-pi/config.jsone in~/.agy-chat/gemini-key(permessi0600).
/agy:status (Diagnostica TUI Overlay)
Mostra una dashboard grafica centrata con lo stato di salute dell'estensione:
┌────────────────────────────────────────────────────────┐
│ 📊 Stato agy-pi │
│ │
│ Binario agy: trovato /home/enne2/.local/bin/agy │
│ Versione: agy version 1.4.2 │
│ Chiave Gemini: ✅ valida │
│ Chiave (mask): AIza...yfDY │
│ Modello attivo: Gemini 3.1 Pro (High) │
│ Backend STT: gemini │
│ Notifiche TTS: true │
│ │
│ Ultimo errore: (nessuno) │
│ │
│ Enter o Esc per chiudere │
└────────────────────────────────────────────────────────┘
Registrazione Vocale & TTS
| Comando | Descrizione |
|---|---|
/agy:record |
Avvia o ferma la registrazione vocale (equivalente al tasto F12). |
/agy:record:stop |
Ferma la registrazione attiva ed elabora l'audio. |
/agy:record:cancel |
Annulla la registrazione corrente senza inviare prompt. |
/agy:speak <testo> |
Sintetizza ed esegue l'audio del testo specificato via Gemini TTS. |
/agy:vocal [on|off|status] |
Attiva (on), disattiva (off) o mostra lo stato (status) del feedback vocale automatico TTS. |
Scorciatoie da Tastiera (Keybindings)
Tasto F12 — Registrazione Vocale Toggle
- Primo tocco (
F12): Avvia la registrazione audio tramiteffmpeg, riproduce il suono sci-fi Power Up e mostra la barra di stato live🔴 REGISTRAZIONE... MM:SS / MM:SS. - Secondo tocco (
F12): Interrompe la registrazione, riproduce il suono Deactivate, ottimizza l'audio (soppressione silenzio), invia la traccia a Gemini per la trascrizione e trasmette il prompt risultante api.
Tasto Ctrl+Esc — Annullamento Registrazione
- Durante una registrazione audio attiva, premere
Ctrl+Escabortisce immediatamente il processoffmpeg, rimuove il file temporaneo, riproduce il tono acustico di cancellazione e cancella l'indicatore di stato. Escda solo è riservato alla combinazione built-in di pi (app.interrupt), quindi l'estensione usaCtrl+Escper evitare il conflitto.