Hvad er diff-omfang?

Diff-omfang styr, hvor meget kontekst AI'en overvejer, når den analyserer dine ændringer. Som standard fokuserer AI Diff Review på linjerne, du faktisk ændrede, men du kan udvide dette omfang for at inkludere nærliggende linjer eller endda hele filen. Denne indstilling påvirker både analysekvaliteten og commit-portscoringen.

Omfangstilstande

STRICT-tilstand

I STRICT-tilstand overvejer AI'en kun resultater, der er direkte på ændrede linjer. Dette er den mest fokuserede tilgang og sikrer, at commit-portscoringen kun afspejler problemer, du faktisk introducerede.

Bedst til:

  • Præcis commit-portscoring
  • Fokusere kun på nye problemer
  • Små, fokuserede commits
  • Når du vil ignorere eksisterende problemer

Overvejelser:

  • Kan gå glip af problemer relateret til dine ændringer, men ikke direkte på ændrede linjer
  • Mindre kontekst for AI'en at forstå dine ændringer
  • Kan producere færre resultater i alt

NEARBY-tilstand

NEARBY-tilstand inkluderer et konfigurerbart vindue af linjer omkring dine ændringer (standard: ±N linjer). Dette giver mere kontekst, mens fokus stadig ligger på området, du modificerede.

Bedst til:

  • Balanceret analyse med kontekst
  • Forstå effekten af ændringer på omgivende kode
  • De fleste generelle brugstilfælde
  • Når du vil have lidt kontekst uden at analysere hele filer

Overvejelser:

  • Vinduesstørrelse påvirker analyseomfang—større vinduer inkluderer mere kontekst
  • Kan flagge problemer i nærliggende kode, du ikke ændrede
  • Commit-portscoring inkluderer nærliggende resultater

RELAXED-tilstand

RELAXED-tilstand overvejer hele filen, når den analyserer ændringer. Dette giver maksimal kontekst og hjælper AI'en med at forstå den fulde effekt af dine modificeringer.

Bedst til:

  • Omfattende analyse
  • Forstå, hvordan ændringer påvirker hele filen
  • Refaktoreringsindsatser
  • Når du vil have maksimal AI-indsigt

Overvejelser:

  • Kan flagge mange eksisterende problemer
  • Commit-portscoring inkluderer alle filresultater
  • Større analyseomfang betyder mere behandlingstid
  • Kan være overvældende for store filer

Konfigurere omfang

For at konfigurere diff-omfang:

  1. Gå til Indstillinger → Værktøjer → AI Diff Review
  2. Naviger til afsnittet Diff-omfangskontroller
  3. Vælg din foretrukne tilstand (STRICT, NEARBY eller RELAXED)
  4. Hvis du bruger NEARBY, indstil vinduesstørrelsen (antal linjer at inkludere på hver side)

Påvirkning på commit-port

Diff-omfang påvirker direkte commit-portscoring:

  • STRICT: Kun resultater på ændrede linjer bidrager til scoring
  • NEARBY: Resultater inden for vinduet bidrager til scoring
  • RELAXED: Alle resultater i ændrede filer bidrager til scoring

Som standard ignoreres globale eller ikke-målrettede INFO-elementer for portning, uanset omfangstilstand. Dette sikrer, at porten fokuserer på problemer relateret til dine ændringer.

Vælge den rigtige tilstand

Til sikkerhedsfølsomme projekter

Brug STRICT eller NEARBY med et lille vindue. Dette sikrer, at commit-porten kun blokerer baseret på problemer, du faktisk introducerede, ikke eksisterende problemer.

Til kodekvalitetsforbedring

Brug RELAXED-tilstand for at få omfattende feedback på hele filer. Dette hjælper med at identificere områder til forbedring ud over bare dine ændringer.

Til store teams

Brug STRICT-tilstand for at sikre, at commit-porter er retfærdige og kun blokerer baseret på nye problemer. Dette forhindrer frustration fra at blive blokeret af eksisterende kodeproblemer.

Til refaktoring

Brug RELAXED-tilstand for at forstå, hvordan din refaktoring påvirker hele filen. Dette giver bedre kontekst for at træffe informerede beslutninger.

Bedste praksis

Start med standard

Standard RELAXED-tilstanden fungerer godt til de fleste brugstilfælde. Start der og juster baseret på dine behov.

Match din arbejdsgang

Vælg en omfangstilstand, der matcher, hvordan dit team arbejder. Hvis du foretrækker fokuserede commits, brug STRICT. Hvis du laver omfattende gennemgange, brug RELAXED.

Overvej filstørrelse

For meget store filer kan RELAXED-tilstand være overvældende. Overvej at bruge NEARBY med en rimelig vinduesstørrelse i stedet.

Gennemgå resultater

Uanset omfangstilstand, gennemgå resultater omhyggeligt. Selv i RELAXED-tilstand, fokuser på at adressere problemer relateret til dine ændringer først.

Kombinere med andre indstillinger

Diff-omfang fungerer sammen med andre indstillinger:

  • Fuldt indholdsinkludering: Når aktiveret, har RELAXED-tilstand mere kontekst at arbejde med
  • Relateret kontekstbegrænsning: Begrænser, hvor meget relateret kode der inkluderes, fungerer sammen med omfangskontroller
  • Commit-portniveau: Omfang påvirker, hvad der bidrager til portscoring

Konklusion

Diff-omfangskontroller giver dig fin kontrol over, hvordan AI Diff Review analyserer din kode. Ved at vælge den rigtige tilstand til dine behov kan du balancere omfattende analyse med fokuseret feedback.

STRICT-tilstand sikrer præcision, NEARBY giver balanceret kontekst, og RELAXED tilbyder omfattende indsigter. Eksperimenter med forskellige tilstande for at finde, hvad der fungerer bedst for din arbejdsgang.

Husk, at du kan ændre omfangstilstanden når som helst i indstillinger, så føl dig ikke låst i dit oprindelige valg. Juster efter behov baseret på den type arbejde, du laver.

Klar til at konfigurere dit analyseomfang? Installer AI Diff Review og udforsk de forskellige tilgængelige omfangstilstande.