La sfida dei commit grandi

Lo sviluppo moderno spesso coinvolge commit che modificano molti file. Che si tratti di un'aggiunta di funzionalità importante, di uno sforzo di refactoring o di unire un branch di lunga durata, i commit grandi possono superare i limiti di dimensione dei provider IA. AI Diff Review risolve questo con un'elaborazione lotti intelligente che divide automaticamente i commit grandi in blocchi gestibili.

Come funziona l'elaborazione lotti

Quando un commit o un ambito selezionato supera il budget attivo (256 KB per provider cloud, 128 KB per locali), AI Diff Review divide automaticamente la richiesta in più lotti. Ma non divide semplicemente in modo casuale—usa una strategia sofisticata di relazione prima per mantenere i file correlati insieme, migliorando la qualità dell'analisi.

Strategia di relazione

Il sistema di elaborazione lotti usa euristiche leggere per determinare quali file sono correlati:

Riferimenti di importazione e package

I file che importano simboli definiti in altri file modificati sono considerati correlati. Ad esempio, se UserService.java importa User da User.java, e entrambi sono modificati, saranno raggruppati insieme.

Menzioni di simboli

I file che menzionano nomi di classi, oggetti o funzioni definiti in altri file modificati sono raggruppati insieme. Questo cattura le relazioni anche quando gli import espliciti non sono presenti.

Prossimità di directory

I file nello stesso package o directory sono considerati debolmente correlati, servendo come tie-breaker quando altre relazioni non sono chiare.

Algoritmo di clustering

Il sistema di elaborazione lotti costruisce un grafo non orientato di file connessi dalle relazioni sopra, poi calcola componenti connesse come gruppi iniziali. Questo assicura che i file che si riferiscono l'un l'altro rimangano insieme nello stesso lotto.

Strategia di impacchettamento

I gruppi sono posizionati in lotti usando un algoritmo first-fit-decreasing per dimensione richiesta stimata. Questo:

  • Preserva i gruppi quando possibile (mantiene i file correlati insieme)
  • Massimizza l'efficienza della dimensione del lotto
  • Assicura che ogni lotto rimanga sotto il limite di dimensione

Gestione di gruppi sovradimensionati

Se un singolo gruppo di file correlati supera il budget, viene diviso per ordine di ricerca in ampiezza (BFS) preservando archi ad alto peso. Questo significa che le relazioni più forti sono mantenute anche quando la divisione è necessaria.

Esperienza utente

Quando avviene l'elaborazione lotti, la finestra degli strumenti mostra il progresso come "Lotto X/Y", rendendo chiaro che più lotti sono in elaborazione. I risultati sono uniti senza soluzione di continuità tra i lotti, quindi vedi una vista unificata di tutti i risultati. Ordinamento, filtraggio e ricerca funzionano su tutti i risultati come se provenissero da una singola analisi.

Dimensioni lotti predefinite

Il sistema preferisce lotti di 3-7 file ciascuno quando sono presenti molti file, ma le dimensioni esatte variano in base a:

  • Dimensione diff e contenuto per file
  • Limiti di dimensione specifici del provider
  • Relazioni di relazione

Questo equilibrio assicura un'elaborazione efficiente mantenendo la qualità dell'analisi.

Vantaggi dell'elaborazione lotti intelligente

Migliore qualità di analisi

Mantenendo i file correlati insieme, l'IA può capire il contesto e le relazioni, portando a risultati più accurati. Ad esempio, se modifichi sia una classe modello che il suo servizio, analizzarli insieme aiuta l'IA a capire l'impatto completo delle tue modifiche.

Gestione automatica

Non devi dividere manualmente i commit o preoccuparti dei limiti di dimensione. Il plugin lo gestisce automaticamente, quindi puoi concentrarti sul tuo codice.

Esperienza senza soluzione di continuità

I risultati sono uniti automaticamente, quindi vedi una vista unificata indipendentemente da quanti lotti sono stati necessari. Non devi combinare manualmente i risultati o passare tra diverse analisi.

Quando avviene l'elaborazione lotti

L'elaborazione lotti è attivata quando:

  • Un commit modifica molti file (tipicamente 10+ file)
  • I file sono grandi (anche pochi file grandi possono attivare l'elaborazione lotti)
  • Il contenuto completo del file è incluso (aumenta significativamente la dimensione)
  • La dimensione combinata supera i limiti del provider

Migliori pratiche

Mantenere i commit focalizzati

Mentre l'elaborazione lotti gestisce bene i commit grandi, commit più piccoli e focalizzati sono ancora migliori per la revisione del codice e la comprensione. Considera di dividere grandi modifiche in commit logici quando possibile.

Fidarsi del sistema

L'algoritmo di elaborazione lotti è progettato per preservare le relazioni e mantenere la qualità dell'analisi. Fidati che i file correlati saranno analizzati insieme, anche attraverso i lotti se necessario.

Rivedere tutti i risultati

Poiché i risultati sono uniti, assicurati di rivedere i risultati da tutti i lotti. La vista unificata facilita questo, ma sii consapevole che i commit grandi possono avere molti risultati attraverso più lotti.

Dettagli tecnici

Il sistema di elaborazione lotti usa un estimatore rapido della dimensione della richiesta che approssima la dimensione del payload avvolto in JSON per rimanere sotto il limite per lotto. Questa stima avviene prima dell'invio, assicurando un uso efficiente dei limiti del provider.

Conclusione

L'elaborazione lotti intelligente rende possibile analizzare commit grandi senza intervento manuale. Mantenendo i file correlati insieme e gestendo automaticamente le dimensioni dei lotti, AI Diff Review assicura un'analisi completa indipendentemente dalla dimensione del commit.

La strategia di relazione prima mantiene la qualità dell'analisi mentre la divisione automatica assicura che puoi analizzare commit di qualsiasi dimensione. Combinato con l'unione senza soluzione di continuità dei risultati, l'elaborazione lotti fornisce un'esperienza fluida anche per le modifiche più grandi.

Pronto ad analizzare commit grandi? Installa AI Diff Review e vedi come gestisce le tue modifiche più grandi.