Vad är diff-omfattning?

Diff-omfattning styr hur mycket kontext AI:n överväger när den analyserar dina ändringar. Som standard fokuserar AI Diff Review på raderna du faktiskt ändrade, men du kan utöka denna omfattning för att inkludera närliggande rader eller till och med hela filen. Denna inställning påverkar både analyskvaliteten och commit-grindpoängsättningen.

Omfattningslägen

STRICT-läge

I STRICT-läge överväger AI:n endast resultat som är direkt på ändrade rader. Detta är det mest fokuserade tillvägagångssättet och säkerställer att commit-grindpoängsättningen endast återspeglar problem som du faktiskt introducerade.

Bäst för:

  • Exakt commit-grindpoängsättning
  • Fokusera endast på nya problem
  • Små, fokuserade commits
  • När du vill ignorera befintliga problem

Överväganden:

  • Kan missa problem relaterade till dina ändringar men inte direkt på ändrade rader
  • Mindre kontext för AI:n att förstå dina ändringar
  • Kan producera färre resultat totalt

NEARBY-läge

NEARBY-läge inkluderar ett konfigurerbart fönster av rader runt dina ändringar (standard: ±N rader). Detta ger mer kontext samtidigt som fokus fortfarande ligger på området du modifierade.

Bäst för:

  • Balanserad analys med kontext
  • Förstå effekten av ändringar på omgivande kod
  • De flesta allmänna användningsfall
  • När du vill ha lite kontext utan att analysera hela filer

Överväganden:

  • Fönsterstorlek påverkar analysomfattning—större fönster inkluderar mer kontext
  • Kan flagga problem i närliggande kod som du inte ändrade
  • Commit-grindpoängsättning inkluderar närliggande resultat

RELAXED-läge

RELAXED-läge överväger hela filen när den analyserar ändringar. Detta ger maximal kontext och hjälper AI:n att förstå den fullständiga effekten av dina modifieringar.

Bäst för:

  • Omfattande analys
  • Förstå hur ändringar påverkar hela filen
  • Refaktoreringsinsatser
  • När du vill ha maximal AI-insikt

Överväganden:

  • Kan flagga många befintliga problem
  • Commit-grindpoängsättning inkluderar alla filresultat
  • Större analysomfattning betyder mer bearbetningstid
  • Kan vara överväldigande för stora filer

Konfigurera omfattning

För att konfigurera diff-omfattning:

  1. Gå till Inställningar → Verktyg → AI Diff Review
  2. Navigera till avsnittet Diff-omfattningskontroller
  3. Välj ditt föredragna läge (STRICT, NEARBY eller RELAXED)
  4. Om du använder NEARBY, ange fönsterstorleken (antal rader att inkludera på varje sida)

Påverkan på commit-grind

Diff-omfattning påverkar direkt commit-grindpoängsättning:

  • STRICT: Endast resultat på ändrade rader bidrar till poängsättning
  • NEARBY: Resultat inom fönstret bidrar till poängsättning
  • RELAXED: Alla resultat i ändrade filer bidrar till poängsättning

Som standard ignoreras globala eller icke-målade INFO-objekt för grindning, oavsett omfattningsläge. Detta säkerställer att grinden fokuserar på problem relaterade till dina ändringar.

Välja rätt läge

För säkerhetskänsliga projekt

Använd STRICT eller NEARBY med ett litet fönster. Detta säkerställer att commit-grinden endast blockeras baserat på problem som du faktiskt introducerade, inte befintliga problem.

För kodkvalitetsförbättring

Använd RELAXED-läge för att få omfattande feedback på hela filer. Detta hjälper till att identifiera områden för förbättring utöver bara dina ändringar.

För stora team

Använd STRICT-läge för att säkerställa att commit-grindar är rättvisa och endast blockeras baserat på nya problem. Detta förhindrar frustration från att blockeras av befintliga kodproblem.

För refaktoring

Använd RELAXED-läge för att förstå hur din refaktoring påverkar hela filen. Detta ger bättre kontext för att fatta informerade beslut.

Bästa praxis

Börja med standard

Standard RELAXED-läget fungerar bra för de flesta användningsfall. Börja där och justera baserat på dina behov.

Matcha din arbetsflöde

Välj ett omfattningsläge som matchar hur ditt team arbetar. Om du föredrar fokuserade commits, använd STRICT. Om du gör omfattande granskningar, använd RELAXED.

Överväg filstorlek

För mycket stora filer kan RELAXED-läge vara överväldigande. Överväg att använda NEARBY med en rimlig fönsterstorlek istället.

Granska resultat

Oavsett omfattningsläge, granska resultat noggrant. Även i RELAXED-läge, fokusera på att adressera problem relaterade till dina ändringar först.

Kombinera med andra inställningar

Diff-omfattning fungerar tillsammans med andra inställningar:

  • Fullständig innehållsinkludering: När aktiverad har RELAXED-läge mer kontext att arbeta med
  • Relaterad kontextbegränsning: Begränsar hur mycket relaterad kod som inkluderas, fungerar tillsammans med omfattningskontroller
  • Commit-grindnivå: Omfattning påverkar vad som bidrar till grindpoängsättning

Slutsats

Diff-omfattningskontroller ger dig fin kontroll över hur AI Diff Review analyserar din kod. Genom att välja rätt läge för dina behov kan du balansera omfattande analys med fokuserad feedback.

STRICT-läge säkerställer precision, NEARBY ger balanserad kontext, och RELAXED erbjuder omfattande insikter. Experimentera med olika lägen för att hitta vad som fungerar bäst för ditt arbetsflöde.

Kom ihåg att du kan ändra omfattningsläget när som helst i inställningar, så känn dig inte låst i ditt initiala val. Justera efter behov baserat på vilken typ av arbete du gör.

Redo att konfigurera din analysomfattning? Installera AI Diff Review och utforska de olika tillgängliga omfattningslägena.