Wat is diff-bereik?

Diff-bereik bepaalt hoeveel context de AI overweegt bij het analyseren van uw wijzigingen. Standaard richt AI Diff Review zich op de regels die u daadwerkelijk heeft gewijzigd, maar u kunt dit bereik uitbreiden om nabijgelegen regels of zelfs het hele bestand op te nemen. Deze instelling beïnvloedt zowel de analysekwaliteit als de commit gate-scoring.

Bereikmodi

STRICT-modus

In STRICT-modus overweegt de AI alleen bevindingen die direct op gewijzigde regels staan. Dit is de meest gefocuste aanpak en zorgt ervoor dat commit gate-scoring alleen problemen weerspiegelt die u daadwerkelijk heeft geïntroduceerd.

Beste voor:

  • Nauwkeurige commit gate-scoring
  • Alleen focussen op nieuwe problemen
  • Kleine, gefocuste commits
  • Wanneer u bestaande problemen wilt negeren

Overwegingen:

  • Kan problemen missen die verband houden met uw wijzigingen maar niet direct op gewijzigde regels staan
  • Minder context voor de AI om uw wijzigingen te begrijpen
  • Kan over het algemeen minder bevindingen produceren

NEARBY-modus

NEARBY-modus bevat een configureerbaar venster van regels rond uw wijzigingen (standaard: ±N regels). Dit biedt meer context terwijl u zich nog steeds richt op het gebied dat u heeft gewijzigd.

Beste voor:

  • Gebalanceerde analyse met context
  • Begrijpen van de impact van wijzigingen op omliggende code
  • De meeste algemene gebruikssituaties
  • Wanneer u wat context wilt zonder hele bestanden te analyseren

Overwegingen:

  • Venstergrootte beïnvloedt analysebereik—grotere vensters bevatten meer context
  • Kan problemen markeren in nabijgelegen code die u niet heeft gewijzigd
  • Commit gate-scoring omvat nabijgelegen bevindingen

RELAXED-modus

RELAXED-modus overweegt het hele bestand bij het analyseren van wijzigingen. Dit biedt maximale context en helpt de AI de volledige impact van uw wijzigingen te begrijpen.

Beste voor:

  • Uitgebreide analyse
  • Begrijpen hoe wijzigingen het hele bestand beïnvloeden
  • Refactoring-inspanningen
  • Wanneer u maximale AI-inzichten wilt

Overwegingen:

  • Kan veel bestaande problemen markeren
  • Commit gate-scoring omvat alle bestandsbevindingen
  • Groter analysebereik betekent meer verwerkingstijd
  • Kan overweldigend zijn voor grote bestanden

Bereik configureren

Om diff-bereik te configureren:

  1. Ga naar Instellingen → Tools → AI Diff Review
  2. Navigeer naar de sectie Diff-bereikbesturing
  3. Selecteer uw voorkeursmodus (STRICT, NEARBY of RELAXED)
  4. Als u NEARBY gebruikt, stelt u de venstergrootte in (aantal regels dat aan elke kant moet worden opgenomen)

Impact op commit gate

Diff-bereik beïnvloedt direct commit gate-scoring:

  • STRICT: Alleen bevindingen op gewijzigde regels dragen bij aan scoring
  • NEARBY: Bevindingen binnen het venster dragen bij aan scoring
  • RELAXED: Alle bevindingen in gewijzigde bestanden dragen bij aan scoring

Standaard worden globale of niet-gerichte INFO-items genegeerd voor gating, ongeacht de bereikmodus. Dit zorgt ervoor dat het gate zich richt op problemen die verband houden met uw wijzigingen.

De juiste modus kiezen

Voor beveiligingsgevoelige projecten

Gebruik STRICT of NEARBY met een klein venster. Dit zorgt ervoor dat de commit gate alleen blokkeert op basis van problemen die u daadwerkelijk heeft geïntroduceerd, niet bestaande problemen.

Voor codekwaliteitsverbetering

Gebruik RELAXED-modus om uitgebreide feedback op hele bestanden te krijgen. Dit helpt gebieden voor verbetering te identificeren die verder gaan dan alleen uw wijzigingen.

Voor grote teams

Gebruik STRICT-modus om ervoor te zorgen dat commit gates eerlijk zijn en alleen blokkeren op basis van nieuwe problemen. Dit voorkomt frustratie door te worden geblokkeerd door bestaande code-problemen.

Voor refactoring

Gebruik RELAXED-modus om te begrijpen hoe uw refactoring het hele bestand beïnvloedt. Dit biedt betere context voor het nemen van geïnformeerde beslissingen.

Best practices

Beginnen met standaard

De standaard RELAXED-modus werkt goed voor de meeste gebruikssituaties. Begin daar en pas aan op basis van uw behoeften.

Afstemmen op uw workflow

Kies een bereikmodus die overeenkomt met hoe uw team werkt. Als u gefocuste commits prefereert, gebruik STRICT. Als u uitgebreide reviews doet, gebruik RELAXED.

Bestandsgrootte overwegen

Voor zeer grote bestanden kan RELAXED-modus overweldigend zijn. Overweeg in plaats daarvan NEARBY te gebruiken met een redelijke venstergrootte.

Bevindingen bekijken

Ongeacht de bereikmodus, bekijk bevindingen zorgvuldig. Zelfs in RELAXED-modus, richt u zich eerst op het aanpakken van problemen die verband houden met uw wijzigingen.

Combineren met andere instellingen

Diff-bereik werkt samen met andere instellingen:

  • Volledige inhoudsopname: Wanneer ingeschakeld, heeft RELAXED-modus meer context om mee te werken
  • Gerelateerde contextlimiet: Beperkt hoeveel gerelateerde code wordt opgenomen, werkt samen met bereikbesturingen
  • Commit gate-niveau: Bereik beïnvloedt wat bijdraagt aan gate-scoring

Conclusie

Diff-bereikbesturingen geven u fijne controle over hoe AI Diff Review uw code analyseert. Door de juiste modus voor uw behoeften te kiezen, kunt u uitgebreide analyse balanceren met gefocuste feedback.

STRICT-modus zorgt voor precisie, NEARBY biedt gebalanceerde context, en RELAXED biedt uitgebreide inzichten. Experimenteer met verschillende modi om te vinden wat het beste werkt voor uw workflow.

Onthoud dat u de bereikmodus op elk moment in instellingen kunt wijzigen, dus voel u niet opgesloten in uw initiële keuze. Pas aan indien nodig op basis van het type werk dat u doet.

Klaar om uw analysebereik te configureren? Installeer AI Diff Review en verken de verschillende beschikbare bereikmodi.