Was ist Diff-Bereich?

Der Diff-Bereich steuert, wie viel Kontext die KI bei der Analyse Ihrer Änderungen berücksichtigt. Standardmäßig konzentriert sich AI Diff Review auf die Zeilen, die Sie tatsächlich geändert haben, aber Sie können diesen Bereich erweitern, um nahegelegene Zeilen oder sogar die gesamte Datei einzuschließen. Diese Einstellung beeinflusst sowohl die Analysequalität als auch die Commit-Gate-Bewertung.

Bereichsmodi

STRICT-Modus

Im STRICT-Modus berücksichtigt die KI nur Befunde, die direkt auf geänderten Zeilen liegen. Dies ist der fokussierteste Ansatz und stellt sicher, dass die Commit-Gate-Bewertung nur Probleme widerspiegelt, die Sie tatsächlich eingeführt haben.

Am besten für:

  • Präzise Commit-Gate-Bewertung
  • Fokussierung nur auf neue Probleme
  • Kleine, fokussierte Commits
  • Wenn Sie bereits bestehende Probleme ignorieren möchten

Überlegungen:

  • Kann Probleme verpassen, die mit Ihren Änderungen zusammenhängen, aber nicht direkt auf geänderten Zeilen liegen
  • Weniger Kontext für die KI, um Ihre Änderungen zu verstehen
  • Kann insgesamt weniger Befunde produzieren

NEARBY-Modus

Der NEARBY-Modus enthält ein konfigurierbares Fenster von Zeilen um Ihre Änderungen (Standard: ±N Zeilen). Dies bietet mehr Kontext, während der Fokus weiterhin auf dem von Ihnen geänderten Bereich liegt.

Am besten für:

  • Ausgewogene Analyse mit Kontext
  • Verstehen der Auswirkungen von Änderungen auf umgebenden Code
  • Die meisten allgemeinen Anwendungsfälle
  • Wenn Sie etwas Kontext möchten, ohne ganze Dateien zu analysieren

Überlegungen:

  • Fenstergröße beeinflusst den Analysebereich—größere Fenster enthalten mehr Kontext
  • Kann Probleme im nahegelegenen Code markieren, den Sie nicht geändert haben
  • Commit-Gate-Bewertung enthält nahegelegene Befunde

RELAXED-Modus

Der RELAXED-Modus berücksichtigt die gesamte Datei bei der Analyse von Änderungen. Dies bietet maximalen Kontext und hilft der KI, die vollständige Auswirkung Ihrer Änderungen zu verstehen.

Am besten für:

  • Umfassende Analyse
  • Verstehen, wie Änderungen die gesamte Datei beeinflussen
  • Refaktorisierungsbemühungen
  • Wenn Sie maximale KI-Erkenntnisse möchten

Überlegungen:

  • Kann viele bereits bestehende Probleme markieren
  • Commit-Gate-Bewertung enthält alle Dateibefunde
  • Größerer Analysebereich bedeutet mehr Verarbeitungszeit
  • Kann für große Dateien überwältigend sein

Bereich konfigurieren

Um den Diff-Bereich zu konfigurieren:

  1. Gehen Sie zu Einstellungen → Tools → AI Diff Review
  2. Navigieren Sie zum Abschnitt Diff-Bereichssteuerung
  3. Wählen Sie Ihren bevorzugten Modus (STRICT, NEARBY oder RELAXED)
  4. Wenn Sie NEARBY verwenden, setzen Sie die Fenstergröße (Anzahl der Zeilen, die auf jeder Seite einbezogen werden sollen)

Auswirkung auf Commit-Gate

Der Diff-Bereich beeinflusst direkt die Commit-Gate-Bewertung:

  • STRICT: Nur Befunde auf geänderten Zeilen tragen zur Bewertung bei
  • NEARBY: Befunde innerhalb des Fensters tragen zur Bewertung bei
  • RELAXED: Alle Befunde in geänderten Dateien tragen zur Bewertung bei

Standardmäßig werden globale oder nicht zielgerichtete INFO-Elemente für das Gate ignoriert, unabhängig vom Bereichsmodus. Dies stellt sicher, dass das Gate sich auf Probleme konzentriert, die mit Ihren Änderungen zusammenhängen.

Den richtigen Modus wählen

Für sicherheitssensible Projekte

Verwenden Sie STRICT oder NEARBY mit einem kleinen Fenster. Dies stellt sicher, dass das Commit-Gate nur basierend auf Problemen blockiert, die Sie tatsächlich eingeführt haben, nicht auf bereits bestehenden Problemen.

Für Code-Qualitätsverbesserung

Verwenden Sie den RELAXED-Modus, um umfassendes Feedback zu gesamten Dateien zu erhalten. Dies hilft, Verbesserungsbereiche über Ihre Änderungen hinaus zu identifizieren.

Für große Teams

Verwenden Sie den STRICT-Modus, um sicherzustellen, dass Commit-Gates fair sind und nur basierend auf neuen Problemen blockieren. Dies verhindert Frustration durch Blockierung aufgrund bereits bestehender Code-Probleme.

Für Refaktorisierung

Verwenden Sie den RELAXED-Modus, um zu verstehen, wie sich Ihre Refaktorisierung auf die gesamte Datei auswirkt. Dies bietet besseren Kontext für fundierte Entscheidungen.

Best Practices

Mit Standard beginnen

Der Standard-RELAXED-Modus funktioniert gut für die meisten Anwendungsfälle. Beginnen Sie dort und passen Sie basierend auf Ihren Bedürfnissen an.

An Ihren Workflow anpassen

Wählen Sie einen Bereichsmodus, der zu Ihrer Team-Arbeitsweise passt. Wenn Sie fokussierte Commits bevorzugen, verwenden Sie STRICT. Wenn Sie umfassende Überprüfungen durchführen, verwenden Sie RELAXED.

Dateigröße berücksichtigen

Für sehr große Dateien kann der RELAXED-Modus überwältigend sein. Erwägen Sie stattdessen die Verwendung von NEARBY mit einer angemessenen Fenstergröße.

Befunde überprüfen

Unabhängig vom Bereichsmodus überprüfen Sie Befunde sorgfältig. Auch im RELAXED-Modus konzentrieren Sie sich zuerst auf die Behebung von Problemen, die mit Ihren Änderungen zusammenhängen.

Kombinieren mit anderen Einstellungen

Der Diff-Bereich funktioniert zusammen mit anderen Einstellungen:

  • Vollständige Inhaltsaufnahme: Wenn aktiviert, hat der RELAXED-Modus mehr Kontext zum Arbeiten
  • Verwandter Kontext-Deckel: Begrenzt, wie viel verwandter Code einbezogen wird, arbeitet zusammen mit Bereichssteuerungen
  • Commit-Gate-Level: Bereich beeinflusst, was zur Gate-Bewertung beiträgt

Fazit

Diff-Bereichssteuerungen geben Ihnen präzise Kontrolle darüber, wie AI Diff Review Ihren Code analysiert. Durch die Wahl des richtigen Modus für Ihre Bedürfnisse können Sie umfassende Analyse mit fokussiertem Feedback ausbalancieren.

Der STRICT-Modus gewährleistet Präzision, NEARBY bietet ausgewogenen Kontext, und RELAXED bietet umfassende Erkenntnisse. Experimentieren Sie mit verschiedenen Modi, um herauszufinden, was für Ihren Workflow am besten funktioniert.

Denken Sie daran, dass Sie den Bereichsmodus jederzeit in den Einstellungen ändern können, fühlen Sie sich also nicht in Ihrer anfänglichen Wahl eingeschränkt. Passen Sie nach Bedarf basierend auf der Art der Arbeit an, die Sie leisten.

Bereit, Ihren Analysebereich zu konfigurieren? Installieren Sie AI Diff Review und erkunden Sie die verschiedenen verfügbaren Bereichsmodi.