Hva er diff-omfang?

Diff-omfang kontrollerer hvor mye kontekst AI-en vurderer når den analyserer endringene dine. Som standard fokuserer AI Diff Review på linjene du faktisk endret, men du kan utvide dette omfanget for å inkludere nærliggende linjer eller til og med hele filen. Denne innstillingen påvirker både analysekvaliteten og commit-portpoenggivningen.

Omfangmodi

STRICT-modus

I STRICT-modus vurderer AI-en kun funn som er direkte på endrede linjer. Dette er den mest fokuserte tilnærmingen og sikrer at commit-portpoenggivningen bare reflekterer problemer som du faktisk introduserte.

Best for:

  • Nøyaktig commit-portpoenggivning
  • Fokusere kun på nye problemer
  • Små, fokuserte commits
  • Når du vil ignorere eksisterende problemer

Betraktninger:

  • Kan gå glipp av problemer relatert til endringene dine men ikke direkte på endrede linjer
  • Mindre kontekst for AI-en å forstå endringene dine
  • Kan produsere færre funn totalt

NEARBY-modus

NEARBY-modus inkluderer et konfigurerbart vindu av linjer rundt endringene dine (standard: ±N linjer). Dette gir mer kontekst samtidig som fokus fortsatt ligger på området du modifiserte.

Best for:

  • Balansert analyse med kontekst
  • Forstå effekten av endringer på omgivende kode
  • De fleste generelle brukstilfeller
  • Når du vil ha litt kontekst uten å analysere hele filer

Betraktninger:

  • Vindusstørrelse påvirker analyseomfang—større vinduer inkluderer mer kontekst
  • Kan flagge problemer i nærliggende kode som du ikke endret
  • Commit-portpoenggivning inkluderer nærliggende funn

RELAXED-modus

RELAXED-modus vurderer hele filen når den analyserer endringer. Dette gir maksimal kontekst og hjelper AI-en med å forstå den fullstendige effekten av modifikasjonene dine.

Best for:

  • Omfattende analyse
  • Forstå hvordan endringer påvirker hele filen
  • Refaktoreringsinnsatser
  • Når du vil ha maksimal AI-innsikt

Betraktninger:

  • Kan flagge mange eksisterende problemer
  • Commit-portpoenggivning inkluderer alle filfunn
  • Større analyseomfang betyr mer behandlingstid
  • Kan være overveldende for store filer

Konfigurere omfang

For å konfigurere diff-omfang:

  1. Gå til Innstillinger → Verktøy → AI Diff Review
  2. Naviger til avsnittet Diff-omfangskontroller
  3. Velg din foretrukne modus (STRICT, NEARBY eller RELAXED)
  4. Hvis du bruker NEARBY, sett vindusstørrelsen (antall linjer å inkludere på hver side)

Påvirkning på commit-port

Diff-omfang påvirker direkte commit-portpoenggivning:

  • STRICT: Kun funn på endrede linjer bidrar til poenggivning
  • NEARBY: Funn innenfor vinduet bidrar til poenggivning
  • RELAXED: Alle funn i endrede filer bidrar til poenggivning

Som standard ignoreres globale eller ikke-målrettede INFO-elementer for porting, uavhengig av omfangmodus. Dette sikrer at porten fokuserer på problemer relatert til endringene dine.

Velge riktig modus

For sikkerhetsfølsomme prosjekter

Bruk STRICT eller NEARBY med et lite vindu. Dette sikrer at commit-porten bare blokkerer basert på problemer som du faktisk introduserte, ikke eksisterende problemer.

For kodekvalitetsforbedring

Bruk RELAXED-modus for å få omfattende tilbakemelding på hele filer. Dette hjelper med å identifisere områder for forbedring utover bare endringene dine.

For store team

Bruk STRICT-modus for å sikre at commit-porter er rettferdige og bare blokkerer basert på nye problemer. Dette forhindrer frustrasjon fra å bli blokkert av eksisterende kodeproblemer.

For refaktoring

Bruk RELAXED-modus for å forstå hvordan refaktoringen din påvirker hele filen. Dette gir bedre kontekst for å ta informerte beslutninger.

Beste praksis

Start med standard

Standard RELAXED-modus fungerer bra for de fleste brukstilfeller. Start der og juster basert på behovene dine.

Match arbeidsflyten din

Velg en omfangmodus som matcher hvordan teamet ditt arbeider. Hvis du foretrekker fokuserte commits, bruk STRICT. Hvis du gjør omfattende gjennomganger, bruk RELAXED.

Vurder filstørrelse

For veldig store filer kan RELAXED-modus være overveldende. Vurder å bruke NEARBY med en rimelig vindusstørrelse i stedet.

Gjennomgå funn

Uavhengig av omfangmodus, gjennomgå funn nøye. Selv i RELAXED-modus, fokuser på å adressere problemer relatert til endringene dine først.

Kombinere med andre innstillinger

Diff-omfang fungerer sammen med andre innstillinger:

  • Fullstendig innholdsinkludering: Når aktivert, har RELAXED-modus mer kontekst å arbeide med
  • Relatert kontekstbegrensning: Begrenser hvor mye relatert kode som inkluderes, fungerer sammen med omfangskontroller
  • Commit-portnivå: Omfang påvirker hva som bidrar til portpoenggivning

Konklusjon

Diff-omfangskontroller gir deg fin kontroll over hvordan AI Diff Review analyserer koden din. Ved å velge riktig modus for behovene dine kan du balansere omfattende analyse med fokusert tilbakemelding.

STRICT-modus sikrer presisjon, NEARBY gir balansert kontekst, og RELAXED tilbyr omfattende innsikter. Eksperimenter med forskjellige modi for å finne hva som fungerer best for arbeidsflyten din.

Husk at du kan endre omfangmodusen når som helst i innstillinger, så føl deg ikke låst i ditt første valg. Juster etter behov basert på hvilken type arbeid du gjør.

Klar til å konfigurere analyseomfanget ditt? Installer AI Diff Review og utforsk de forskjellige tilgjengelige omfangmodiene.