Panoramica dell'interfaccia utente

Accesso rapido alle funzionalità chiave:

L'area di conversazione principale mostra:

• Risposte dell'AI - Testo formattato con blocchi di codice con evidenziazione della sintassi
• Diff del codice - Confronti interattivi prima/dopo per le modifiche ai file
• Piani - Suddivisioni strutturate delle attività quando usi Plan Mode
• Risultati di verifica - Output dell'esecuzione dei test e informazioni di debug
• Operazioni sui file - Conferma di creazioni, modifiche o eliminazioni di file
• Output dei sottoagenti - Risultati delle attività delegate

La vista chat conserva l'intera cronologia della conversazione, permettendoti di scorrere all'indietro tra le interazioni precedenti.

L'area di input in basso, con i controlli per comporre le richieste:

Area di input di testo: Campo di testo principale per digitare prompt in linguaggio naturale

Pulsanti di azione:

La vista chat comunica lo stato attraverso segnali visivi piuttosto che etichette esplicite:

• Indicatore di elaborazione - Un indicatore visivo appare quando Verdent sta lavorando attivamente. Compare quando l'AI legge i file, analizza il codice o si prepara a rispondere.
• Testo in generazione - Vedrai la risposta di Verdent apparire in tempo reale mentre l'AI compone spiegazioni, suggerimenti di codice o piani. Il testo in streaming indica che il modello sta generando attivamente l'output.
• Nessuna attività - Quando la vista chat è statica senza attività, Verdent è in attesa. Significa che devi approvare modifiche ai file, rispondere a domande di chiarimento o fornire la richiesta successiva.

Il cursore di testo nella casella di input indica se Verdent è pronto ad accettare nuove richieste:

• Cursore lampeggiante - La casella di input è attiva e pronta per l'inserimento del testo. Puoi digitare la tua richiesta e premere Invia. Compare quando Verdent ha completato l'elaborazione ed è in attesa del prossimo prompt.
• Nessun cursore/Disabilitato - La casella di input è disabilitata mentre Verdent sta elaborando una richiesta. Questo previene interruzioni all'attività in corso e garantisce che ogni richiesta si completi prima di avviarne un'altra.

Schema del flusso di lavoro: Quando invii una richiesta, il cursore scompare (l'input viene disabilitato). Una volta che Verdent completa l'attività, il cursore riappare, segnalando che puoi digitare la richiesta successiva.

La casella di input mostra indicatori che segnalano la configurazione corrente:

• Pulsante Cambia permesso - Mostra la modalità dei permessi corrente come etichetta sul pulsante stesso. Vedrai "Manual", "Auto", "Plan" o "Skip". Questo ti permette di confermare quale modalità di esecuzione è attiva prima di inviare la richiesta. Seleziona il pulsante per scorrere le modalità disponibili.
• Pulsante Cambia/personalizza modello AI - Mostra il modello o il preset attualmente selezionato. Vedrai "Performance", "Balance" o "Efficiency" per i preset, oppure nomi di modelli specifici come "Claude 4.5 Sonnet" se hai selezionato un singolo modello. Questo conferma quale modello AI elaborerà la richiesta successiva.

Questi indicatori offrono una conferma immediata delle impostazioni correnti, aiutandoti a verificare la configurazione giusta prima di inviare i prompt.

La barra superiore utilizza schemi di navigazione diversi a seconda della funzione:

Pulsanti:

• Nuova sessione - Selezionando questo pulsante cancelli immediatamente la conversazione corrente e torni a una vista chat nuova con contesto pulito. Non c'è una pagina o un popup separato; avviene istantaneamente nella stessa vista.

Pagine:

• Cronologia del progetto - Apre una vista dedicata a pagina intera dove puoi sfogliare tutte le sessioni e conversazioni precedenti. Questo ti allontana dalla vista chat per mostrare la cronologia delle sessioni. Seleziona il pulsante X per tornare alla vista chat.

Popup (finestre di dialogo sovrapposte):

• Centro utente - Apre un popup sovrapposto che mostra le informazioni dell'account, il saldo crediti e i dettagli sull'utilizzo. La vista chat resta visibile dietro il popup.
• Feedback - Apre un popup sovrapposto con un modulo per inviare feedback e segnalare problemi. La vista chat resta sullo sfondo.

Per chiudere i popup, seleziona un punto esterno all'area del popup oppure usa il pulsante X nell'angolo del popup.

Menu a discesa:

• Impostazioni - Apre un menu a discesa in linea con opzioni per server MCP, sottoagenti, regole e preset dei modelli. Quando selezioni un'opzione dal menu (ad esempio "Server MCP"), si apre una vista dedicata a pagina intera per quella configurazione. Seleziona il pulsante X per tornare alla vista chat.

Tutti i pulsanti della casella di input aprono menu a discesa per una configurazione rapida e in linea:

Schema del menu a discesa: Ogni pulsante nella casella di input (Aggiungi contesto, Aggiungi immagini o file, Aggiungi sottoagente, Cambia modalità, Cambia/personalizza modello AI, Think Hard Mode, Cambia permesso) apre un menu a discesa direttamente sotto il pulsante. Questi menu ti permettono di configurare la richiesta senza allontanarti dalla vista chat.

Perché i menu a discesa: Questo design ti mantiene ancorato alla vista chat per tutte le operazioni comuni. Puoi regolare le impostazioni, selezionare i modelli, cambiare modalità e aggiungere contesto senza perdere di vista la conversazione o interrompere il flusso di lavoro.

Chiusura dei menu a discesa: I menu a discesa si chiudono automaticamente quando effettui una selezione o selezioni un punto qualsiasi al di fuori del menu. Questo ti permette di configurare rapidamente le impostazioni e tornare a comporre la richiesta.

Elementi di navigazione diversi usano metodi diversi per tornare alla vista chat principale:

Dalle pagine (Cronologia del progetto, Impostazioni):

• Seleziona il pulsante X nell'angolo superiore della pagina
• Questo ti riporta alla vista chat da dove l'avevi lasciata

Dai popup (Centro utente, Feedback):

• Seleziona il pulsante X nell'angolo del popup, oppure
• Seleziona un punto qualsiasi al di fuori del popup sovrapposto
• La vista chat era sempre visibile dietro il popup, quindi chiudendolo l'attenzione torna immediatamente

Dai menu a discesa:

• I menu si chiudono automaticamente quando effettui una selezione
• Seleziona un punto qualsiasi al di fuori del menu per chiuderlo senza selezionare
• Non lasci mai la vista chat, quindi non c'è nulla da cui "tornare"

Filosofia di navigazione: La maggior parte delle interazioni avviene tramite menu a discesa che ti mantengono nella vista chat. Cronologia del progetto e le opzioni delle Impostazioni portano a pagine separate, mentre Centro utente e Feedback usano popup sovrapposti che non nascondono la conversazione.

File: VERDENT.md

Ambito: Preferenze globali applicate a tutti i progetti

Scopo: Imposta le tue preferenze d'uso personali che Verdent applicherà durante le chat in tutti i workspace. Sono impostazioni globali che persistono in tutte le sessioni, indipendentemente dal progetto su cui stai lavorando.

Casi d'uso comuni:

• Lingua di output predefinita (ad esempio "Rispondi sempre in spagnolo")
• Preferenze per i commenti del codice (ad esempio "Includi commenti dettagliati nel codice generato")
• Formattazione delle risposte (ad esempio "Usa TypeScript per tutti gli esempi JavaScript")
• Preferenze personali sullo stile di codifica

Come modificare:

File: AGENTS.md

Ambito: Regole specifiche del progetto, solo per il workspace corrente

Scopo: Definisci standard di codifica, pattern architetturali e flussi di lavoro di sviluppo che si applicano specificamente al progetto corrente. Queste regole hanno la precedenza sulle regole utente quando lavori in questo workspace e aiutano Verdent a comprendere i requisiti unici del tuo progetto.

Casi d'uso comuni:

• Standard di codifica specifici del progetto (ad esempio "Usa il kebab-case per tutti i nomi dei file")
• Pattern architetturali (ad esempio "Segui il repository pattern per l'accesso ai dati")
• Requisiti dello stack tecnologico (ad esempio "Usa gli Hook di React, non i componenti a classe")
• Convenzioni del team (ad esempio "Tutte le risposte di API devono includere i codici di errore")

Come modificare:

Questo file è specifico del progetto e in genere viene inserito nel controllo di versione.

File: Plan.md

Ambito: Controlla il formato e il contenuto dell'output di Plan Mode

Scopo: Personalizza quali informazioni appaiono nei piani, il loro livello di dettaglio e il formato che seguono quando usi Plan Mode. Queste regole determinano la struttura e il contenuto dei piani che Verdent genera prima di eseguire attività complesse.

Casi d'uso comuni:

• Livello di dettaglio del piano (ad esempio "Includi stime di tempo per ogni passaggio")
• Struttura del piano (ad esempio "Includi sempre una sezione 'Rischi'")
• Requisiti di contenuto (ad esempio "Elenca tutti i file che verranno modificati")
• Formato di output (ad esempio "Usa elenchi numerati per i passaggi sequenziali")

Come modificare: