Cos'è l'ambito diff?

L'ambito diff controlla quanto contesto l'IA considera quando analizza le tue modifiche. Per impostazione predefinita, AI Diff Review si concentra sulle righe che hai effettivamente modificato, ma puoi espandere questo ambito per includere righe vicine o anche l'intero file. Questa impostazione influisce sia sulla qualità dell'analisi che sul punteggio del gate di commit.

Modalità di ambito

Modalità STRICT

In modalità STRICT, l'IA considera solo i risultati che sono direttamente sulle righe modificate. Questo è l'approccio più focalizzato e assicura che il punteggio del gate di commit rifletta solo problemi che hai effettivamente introdotto.

Migliore per:

  • Punteggio preciso del gate di commit
  • Concentrarsi solo su nuovi problemi
  • Commit piccoli e focalizzati
  • Quando vuoi ignorare problemi preesistenti

Considerazioni:

  • Può perdere problemi correlati alle tue modifiche ma non direttamente sulle righe modificate
  • Meno contesto per l'IA per capire le tue modifiche
  • Può produrre meno risultati complessivamente

Modalità NEARBY

La modalità NEARBY include una finestra configurabile di righe intorno alle tue modifiche (predefinito: ±N righe). Questo fornisce più contesto mantenendo ancora il focus sull'area che hai modificato.

Migliore per:

  • Analisi bilanciata con contesto
  • Capire l'impatto delle modifiche sul codice circostante
  • La maggior parte dei casi d'uso generici
  • Quando vuoi un po' di contesto senza analizzare interi file

Considerazioni:

  • La dimensione della finestra influisce sull'ambito dell'analisi—finestre più grandi includono più contesto
  • Può segnalare problemi nel codice vicino che non hai modificato
  • Il punteggio del gate di commit include risultati vicini

Modalità RELAXED

La modalità RELAXED considera l'intero file quando analizza le modifiche. Questo fornisce contesto massimo e aiuta l'IA a capire l'impatto completo delle tue modifiche.

Migliore per:

  • Analisi completa
  • Capire come le modifiche influenzano l'intero file
  • Sforzi di refactoring
  • Quando vuoi insight massimi dall'IA

Considerazioni:

  • Può segnalare molti problemi preesistenti
  • Il punteggio del gate di commit include tutti i risultati del file
  • Un ambito di analisi più grande significa più tempo di elaborazione
  • Può essere travolgente per file grandi

Configurare l'ambito

Per configurare l'ambito diff:

  1. Vai su Impostazioni → Strumenti → AI Diff Review
  2. Naviga alla sezione Controlli Ambito Diff
  3. Seleziona la tua modalità preferita (STRICT, NEARBY o RELAXED)
  4. Se usi NEARBY, imposta la dimensione della finestra (numero di righe da includere su ogni lato)

Impatto sul gate di commit

L'ambito diff influisce direttamente sul punteggio del gate di commit:

  • STRICT: Solo i risultati sulle righe modificate contribuiscono al punteggio
  • NEARBY: I risultati all'interno della finestra contribuiscono al punteggio
  • RELAXED: Tutti i risultati nei file modificati contribuiscono al punteggio

Per impostazione predefinita, gli elementi INFO globali o non mirati sono ignorati per il gate, indipendentemente dalla modalità di ambito. Questo assicura che il gate si concentri su problemi correlati alle tue modifiche.

Scegliere la modalità giusta

Per progetti sensibili alla sicurezza

Usa STRICT o NEARBY con una finestra piccola. Questo assicura che il gate di commit blocchi solo basandosi su problemi che hai effettivamente introdotto, non problemi preesistenti.

Per miglioramento della qualità del codice

Usa la modalità RELAXED per ottenere feedback completo su interi file. Questo aiuta a identificare aree di miglioramento oltre le tue modifiche.

Per team grandi

Usa la modalità STRICT per assicurare che i gate di commit siano equi e blocchino solo basandosi su nuovi problemi. Questo previene frustrazione dall'essere bloccati da problemi di codice preesistenti.

Per refactoring

Usa la modalità RELAXED per capire come il tuo refactoring influisce sull'intero file. Questo fornisce migliore contesto per prendere decisioni informate.

Migliori pratiche

Iniziare con il predefinito

La modalità RELAXED predefinita funziona bene per la maggior parte dei casi d'uso. Inizia lì e aggiusta in base alle tue esigenze.

Corrispondere al tuo workflow

Scegli una modalità di ambito che corrisponda a come lavora il tuo team. Se preferisci commit focalizzati, usa STRICT. Se fai revisioni complete, usa RELAXED.

Considerare la dimensione del file

Per file molto grandi, la modalità RELAXED può essere travolgente. Considera di usare NEARBY con una dimensione di finestra ragionevole invece.

Rivedere i risultati

Indipendentemente dalla modalità di ambito, rivedi i risultati attentamente. Anche in modalità RELAXED, concentrati prima sull'affrontare problemi correlati alle tue modifiche.

Combinare con altre impostazioni

L'ambito diff funziona insieme ad altre impostazioni:

  • Inclusione contenuto completo: Quando abilitata, la modalità RELAXED ha più contesto con cui lavorare
  • Limite contesto correlato: Limita quanto codice correlato è incluso, funzionando insieme ai controlli di ambito
  • Livello gate di commit: L'ambito influisce su cosa contribuisce al punteggio del gate

Conclusione

I controlli di ambito diff ti danno controllo preciso su come AI Diff Review analizza il tuo codice. Scegliendo la modalità giusta per le tue esigenze, puoi bilanciare analisi completa con feedback focalizzato.

La modalità STRICT assicura precisione, NEARBY fornisce contesto bilanciato, e RELAXED offre insight completi. Sperimenta con diverse modalità per trovare cosa funziona meglio per il tuo workflow.

Ricorda che puoi cambiare la modalità di ambito in qualsiasi momento nelle impostazioni, quindi non sentirti bloccato nella tua scelta iniziale. Aggiusta secondo necessità in base al tipo di lavoro che stai facendo.

Pronto a configurare il tuo ambito di analisi? Installa AI Diff Review ed esplora le diverse modalità di ambito disponibili.