Branch Diff Explorer

English | 简体中文

Eine vollständig lokale VS Code-Erweiterung zum Überprüfen nur der Änderungen, die mit Ihrem aktuellen Git-Zweig zusammenhängen. Sie hat keine Lizenzprüfungen, Nutzungsbeschränkungen, Telemetrie oder kostenpflichtige Funktionen.

Funktionen

• Durchsuchen Sie Hinzufügungen und Löschungen in committeten, gestageten und ungestageten Änderungen.

• Zeigt jeden geänderten Pfad nur einmal im Verzeichnisbaum, auch wenn er in mehreren Commits oder Git-Zuständen geändert wurde; seine Zeilensummen spiegeln nur den endgültigen Diff wider.

• Hält gelöschte Dateien aus dem Verzeichnisbaum und seinen sichtbaren Summen heraus. Der vollständige Vergleichsumfang, einschließlich Löschungen, bleibt über MCP scopeTotals verfügbar.

• Die + / −-Zusammenfassung in der Seitenleiste summiert immer die Dateien, die derzeit im Verzeichnisbaum angezeigt werden, sodass Such-, Glob-, Dateityp- und ausgeschlossene Pfadänderungen sie sofort aktualisieren.

• Vergleichen Sie Ihren Zweig mit einem beliebigen lokalen oder entfernten Basis-Zweig.

• Filtern Sie nach Art der Dateiänderung, Git-Zustand, Erweiterung und Glob-Mustern.

• Öffnen Sie normale Änderungen, nach Autor gefilterte Änderungen und einzelne Commits im nativen Side-by-Side-Diff-Editor von VS Code.

• Dateizeilen öffnen den vollständigen Diff vom Basis-Zweig zum Arbeitsbaum; wenn ein einzelner Commit ausgewählt ist, öffnen sie stattdessen den Diff vom übergeordneten Commit zu diesem Commit.

• Der Verzeichnisbaum und der Diff-Editor verwenden dieselbe Git-Merge-Basis, sodass Änderungen, die nach der Abweichung unabhängig zum Basis-Zweig hinzugefügt wurden, nicht in die linke Seite eines Zweig-Diffs gelangen.

• Beim Filtern nach Commit-Autor enthalten Datei-Diffs nur die hervorgehobenen Änderungen der übereinstimmenden Autoren, während der Rest der aktuellen Datei sichtbar bleibt.

• Autor-Hervorhebungen bleiben genau, wenn ein anderer Commit den umgebenden Kontext ändert, in reine Hinzufügungen oder gemischte Ersetzungsblöcke einfügt oder die Datei später umbenennt. Große bearbeitete Blöcke verwenden eindeutige Zeilen wie Funktionssignaturen als Anker, bevor sie gemeinsame Klammern und Leerzeichen abgleichen. Wenn eine Autor-Bearbeitung überschrieben oder über einen sicheren Abgleich hinaus verschoben wurde, weist der Diff-Titel darauf hin, anstatt sie stillschweigend zu verbergen.

• Nach Autor gefilterte Zeilen verwenden die endgültigen Autor-vorher → Arbeitsbaum-Zeilensummen, die vom Editor angezeigt werden, anstatt jeden übereinstimmenden Commit zu addieren oder Änderungen anderer Autoren einzuschließen.

• Für eine Datei, die im Basis-Zweig fehlt, bleibt die vollständige aktuelle Datei sichtbar, während nur Zeilen des ausgewählten Autors hervorgehoben werden.

• Gehen Sie von einem virtuellen Git-Diff-Bereich zu Definition, Deklaration, Typdefinition und Implementierung; das Ziel öffnet sich in der aktiven Workspace-Quelle.

• Untersuchen Sie jeweils einen Commit.

• Filtern Sie Zweig-Diffs nach Commit-Autor. Wählen Sie einen oder mehrere Autoren aus, und die Ansicht zeigt nur Patches, die von ihren Commits nach der ausgewählten Basis erzeugt wurden. Das Feld Autor enthält filtert auch nach einem Namen oder E-Mail-Schlüsselwort.

• Die Autor-Filterung durchsucht den gesamten Zweigbereich, anstatt stillschweigend bei 250 Commits zu stoppen. Übereinstimmende Patches werden für große Verläufe in begrenzten Stapeln geladen.

• Schließen Sie Dateien, Verzeichnisse oder Globs (src/generated, src/legacy.c, **/test/**) aus, ohne den Basis-Git-Diff zu ändern. Ausschlüsse verwenden einen kompakten, scrollbaren Editor, in dem jeder Eintrag unabhängig geändert oder entfernt werden kann.

• Exportieren Sie jede Datei, die nach dem Filtern sichtbar ist, in ein ausgewähltes Verzeichnis. Exporte bewahren den Repository-Verzeichnisbaum, hängen .diff an jeden Quelldateinamen an und enthalten standardmäßige Unified-Diff-Marker und Hunks.

• Stellen Sie gespeicherte Sitzungen und ihre live gefilterten Git-Daten lokalen KI-Clients über einen gebündelten, schreibgeschützten STDIO-MCP-Server bereit. MCP verwendet dieselben Regeln für Autor, Suche, Status, Erweiterung, Glob, ausgeschlossene Pfade und gelöschte Dateien wie die Baum- und Exportaktion.

• Klicken Sie mit der rechten Maustaste auf eine geänderte Datei, um sie zu öffnen, ihren Diff zu öffnen, sie auszuschließen, sie im OS-Dateimanager anzuzeigen oder ihren relativen Pfad, absoluten Pfad, Dateinamen oder URI zu kopieren. Klicken Sie mit der rechten Maustaste auf ein Verzeichnis, um das gesamte Verzeichnis auszuschließen, es im Explorer oder im OS anzuzeigen, darin zu suchen oder seinen Pfad, Namen oder URI zu kopieren.

• Kompatibilität mit dem Reviewer-Cockpit: liest .diffly/findings.json, zeigt Briefing, Befunde und fehlende Arbeitselemente, unterstützt Agree/Skip-Triage und dekoriert markierte Zeilen in geöffneten Editoren.

• Zeigt an, wenn der ausgewählte Basis-Zweig dem aktuellen Zweig voraus ist, und aktualisiert sich, wenn sich der Git-Zustand oder .diffly/findings.json ändert.

• Unterstützt Multi-Root-Workspaces und merkt sich das ausgewählte Repository während einer Sitzung.

• Erstellen Sie unbegrenzt benannte Sitzungen. Jede Sitzung speichert ihren Workspace-Ordner, Basis-Zweig, Autor/Commit-Bereich, Suchoptionen, Dateifilter und ausgeschlossene Pfade unabhängig im VS-Code-Workspace-Speicher.

Related MCP server: GitPilot MCP

Verwendung

1. Öffnen Sie ein Git-Repository in VS Code.

2. Öffnen Sie Branch Diff über die Aktivitätsleiste oder führen Sie Branch Diff Explorer: Open Sidebar aus.

3. Wählen Sie einen Basis-Zweig. Der Standard wird automatisch aus origin/HEAD, dann main, dann master erkannt.

4. Wählen Sie optional einen Autor oder einen Commit; der Autorenmodus blendet nicht committete Arbeit absichtlich aus, da sie noch keinen Commit-Autor haben kann.

5. Wählen Sie in einem Multi-Root-Workspace den Workspace-Ordner. Verwenden Sie die +-, Umbenennen- und Löschen-Steuerelemente des Sitzungs-Auswahlfelds, um unabhängige Diff-Einrichtungen zu verwalten.

6. Öffnen Sie Branch Diff Explorer: Open Settings, um den Basis-Zweig, das Vorschauzeilenlimit, den Git-Ausgabepuffer oder das Git-Befehls-Timeout zu konfigurieren. Die Fehleroberfläche verlinkt auch auf diese Einstellungen.

7. Verwenden Sie die Schaltfläche Export filtered diffs (⇩) im Kopfbereich, wählen Sie ein Zielverzeichnis und bestätigen Sie, bevor Sie vorhandene exportierte .diff-Dateien überschreiben.

8. Verwenden Sie MCP im Kopfbereich, um eine Codex- oder Claude-Code-Konfiguration zu kopieren oder den lokalen MCP-Selbsttest auszuführen. Der Server erfordert Node.js 18 oder neuer; setzen Sie MCP: Node Command, wenn node nicht im PATH ist.

KI-Zugriff über MCP

Die Erweiterung kopiert ihre gebündelte MCP-Laufzeit in den stabilen VS-Code-Speicher und hält eine workspacespezifische Zustandsdatei mit allen gespeicherten Sitzungen synchron. Der Server berechnet Git-Änderungen neu, wenn ein KI-Client ihn aufruft; exportierte Diff-Dateien und ein geöffnetes VS-Code-Fenster sind nach der Konfiguration nicht erforderlich.

Kopieren Sie für Codex das generierte TOML in ~/.codex/config.toml oder in das .codex/config.toml eines vertrauenswürdigen Projekts und starten Sie dann den lokalen Codex-Client neu. Codex-Desktop-, CLI- und IDE-Clients unterstützen lokale STDIO-MCP-Server und teilen diese Konfiguration. Siehe die offizielle Codex-MCP-Dokumentation.

Fügen Sie für Claude Code das generierte JSON-Objekt in die .mcp.json des Projekts ein und verbinden Sie den Client erneut. Die generierte Konfiguration enthält nur einen lokalen Node-Befehl, den gebündelten Serverpfad und den Pfad zur Workspace-Zustandsdatei.

Empfohlener MCP-Workflow

MCP-Clients können Tools aus einer natürlichsprachigen Anfrage auswählen. Für zuverlässige, token-effiziente Überprüfungen bitten Sie den Client, dieser Reihenfolge zu folgen:

1. Rufen Sie list_diff_sessions auf, um die aktive oder angeforderte Sitzung zu finden.

2. Rufen Sie get_diff_summary auf, um Repository, Zweig, Vergleichsbasis, Autor- oder Commit-Bereich, Filter und sichtbare Summen zu bestätigen.

3. Blättern Sie durch list_diff_files, um die genaue Menge der im Verzeichnisbaum angezeigten Dateien zu erhalten.

4. Lesen Sie get_filtered_diff für jede zu überprüfende Datei.

5. Verwenden Sie read_file_context, wenn ein Patch nicht genügend umgebenden Quellcode enthält.

6. Verwenden Sie get_branch_diff nur, wenn die vollständige All-Author-Zweigänderung für den Vergleich erforderlich ist.

MCP-Tool-Referenz

Alle Tools sind schreibgeschützt und akzeptieren eine optionale sessionId. Wenn sie weggelassen wird, wird die aktive Branch-Diff-Explorer-Sitzung verwendet.

get_diff_summary meldet zwei absichtlich unterschiedliche Summen:

• scopeTotals beschreibt den vollständigen Autor- oder Commit-Bereich vor UI-Dateifiltern.

• visibleTotals beschreibt genau die nicht gelöschten Dateien, die über list_diff_files, Export und den Verzeichnisbaum nach allen UI-Filtern verfügbar sind.

Mit Autor enthält enthält get_filtered_diff.text nur Patches des übereinstimmenden Autors. Seine additions und deletions pro Datei entsprechen dem endgültigen sichtbaren Diff von Autor-vorher zu Arbeitsbaum; sie akkumulieren weder wiederholte Commits noch schließen sie andere Autoren ein. get_branch_diff enthält absichtlich Änderungen anderer Autoren, daher darf es get_filtered_diff während einer auf den Autor beschränkten Überprüfung nicht ersetzen.

read_file_context.side akzeptiert:

• current (Standard): aktueller Arbeitsbaum-Inhalt.

• head: die Datei bei HEAD.

• base: die Datei an der für den Vergleich verwendeten Git-Merge-Basis.

• author_before: aktueller Inhalt mit zurückgesetztem Patch des ausgewählten Autors, entsprechend der linken Seite des nach Autor gefilterten Diffs in VS Code. Diese Seite ist nur in nach Autor gefilterten Sitzungen verfügbar.

Paginierungsbeispiele

Datei- und Commit-Listen geben nextCursor zurück. Geben Sie es zurück, bis es fehlt:

{
  "sessionId": "session-id",
  "pathPrefix": "src/services",
  "cursor": 0,
  "limit": 100
}

Diff- und Quell-Tools geben nextStartLine zurück. Textseiten sind standardmäßig 800 Zeilen lang und unterstützen bis zu 5.000 Zeilen pro Aufruf:

{
  "sessionId": "session-id",
  "path": "src/services/example.ts",
  "startLine": 1,
  "maxLines": 1000
}

Verwenden Sie immer den genauen repository-relativen Pfad, der von list_diff_files zurückgegeben wird.

Vorgeschlagener Überprüfungs-Prompt

Use the branch-diff-explorer MCP. First list the saved diff sessions and
summarize the active session. Page through every file returned by
list_diff_files. Review get_filtered_diff so the review remains limited to the
selected author or commit, and use read_file_context when full source context is
needed. Use get_branch_diff only to compare the selected-author patch with the
complete branch change. Report findings with severity, file path, relevant
lines, reasoning, and a suggested fix.

Nützliche fokussierte Anfragen umfassen:

Search the active filtered changes for glfs_bdev_get_route_stats, then read the
matching file's filtered diff and its current and author_before source context.

Review only files under source/services/spdk. Use pathPrefix when listing files,
follow every pagination cursor, and do not review changes from other authors.

MCP-Fehlerbehebung

• Wenn der Server fehlt, starten Sie den Codex- oder Claude-Client neu und überprüfen Sie seine MCP-Serverliste. In Codex verwenden Sie /mcp.

• Wenn Ergebnisse veraltet erscheinen, rufen Sie get_diff_summary mit refresh: true auf.

• Wenn ein Pfad abgelehnt wird, rufen Sie ihn erneut von list_diff_files ab und übergeben Sie den genauen zurückgegebenen Pfad.

• Wenn eine Antwort abgeschnitten ist, folgen Sie nextCursor oder nextStartLine, anstatt anzunehmen, dass das Ergebnis vollständig ist.

• author_before erfordert eine nach Autor gefilterte Sitzung.

• Binärdateien, Ziele symbolischer Links und Quelldateien größer als 32 MB werden nicht als Quellkontext zurückgegeben.

Die Erweiterung ruft ausschließlich Ihre lokale git-Programmierung auf und sendet weder Quellcode, Commit-Metadaten, Reviewer-Ergebnisse noch Suchanfragen über das Netzwerk. Der MCP-Server läuft lokal über STDIO und öffnet keinen lauschenden Netzwerkport.

Entwicklung

npm install
npm run check
npm test
npm run build

Drücken Sie in VS Code F5, um einen Extension Development Host zu starten. Bauen Sie eine VSIX-Datei mit npm run package.

Deutsch

Branch Diff Explorer ist eine vollständig lokal ausgeführte VS Code-Erweiterung, um ausschließlich die Änderungen im aktuellen Git-Zweig zu betrachten und zu prüfen. Die Erweiterung enthält weder eine Lizenzprüfung noch Nutzungsbegrenzungen, Telemetrie oder kostenpflichtige Funktionen.

Funktionen

• Durchsuchen Sie committete, stellvertretende und ungestellte Änderungen nach hinzugefügten und gelöschten Zeilen.

• Jeder Pfad im Verzeichnisbaum wird nur einmal angezeigt – auch wenn eine Datei durch mehrere Commits betroffen ist oder gleichzeitig in mehreren Git-Statussen vorhanden. Die Anzahl der hinzugefügten und gelöschten Zeilen einer Datei spiegelt nur den finalen Diff wider, nicht die Summe der Zwischen-Commits.

• Gelöschte Dateien werden nicht im Verzeichnisbaum und nicht in den sichtbaren Zusammenfassungen angezeigt; der vollständige Vergleichsumfang einschließlich gelöschter Dateien kann weiterhin über scopeTotals von MCP abgerufen werden.

• Das + / − oben in der Seitenleiste summiert stets nur die aktuell in der Datei sichtbaren Dateien auf. Nach Änderungen an Suche, Glob, Dateityp oder Ausschlüssen wird sofort neu berechnet.

• Ein Vergleich mit einem beliebigen lokalen oder Remote-Baseline-Branch ist möglich.

• Filterung nach Änderungstyp, Git-Status, Dateiendung und Glob-Ausdruck wird unterstützt.

• Normale Branch-Änderungen, nach dem Autor gefilterte Änderungen und einzelne Commits werden in VS Codes nativer Side-By-Side-Ansicht geöffnet.

• Beim Klick auf eine Datei wird der vollständige Diff zwischen dem basisBranch und dem aktuellen Arbeitsverzeichnis geöffnet. Bei Auswahl eines einzelnen Commits wird der Diff vom übergeordneten Commit bis zu diesem Commit geöffnet.

• Verzeichnisbaum und Diff-Editor Verwenden dieselbe Git-Merge-Basis. Dadurch erscheinen nicht zusammengehörige, nach dem Abzweigen neu im Baseline-Branch hinzugefügte Änderungen nicht auf der linken Diff-Seite.

• Beim Filtern nach Commit-Author zeigt der Diff weiterhin die komplett aktuelle Datei, hebt aber nur die Änderungen des passenden Autors hervor.

• Die Autor-Hervorhebung bleibt möglichst genau, auch wenn andere Commits den umgebenden Kontext geändert haben, in reinen Einfügungs- oder gemischten Ersetzungsblöcken weitergeschrieben wurde oder die Datei später umbenannt wurde. Größere Bearbeitungsblöcke bevorzugen eindeutige Codezeilen wie Funktionssignaturen als Anker und gleichen danach typische geschweifte Klammern und Leerzeilen ab. Wenn eine bestimmte Autoränderung überschrieben oder an eine nicht mehr sicher ermittelbare Stelle verschoben wurde, weist die Diff-Überschrift sichtbar darauf hin, statt die Datei stillschweigend zu unterschlagen.

• Im Autor-Modus klappen die Zeilenzahlen der Datei zur tatsächlichen Anzeige von Enddaten des finalen, sichtbaren autor-before → working tree Diff-Wertes; die mehrfachen Commits desselben Autors werden dabei weder doppelt gezählt noch aus anderen Autoren.

• Wenn die Datei im Baseline-Branch nicht existiert, zeigt der Diff die vollständige aktuelle Datei und markiert nur die des ausgewählten Autors.

• Aus dem virtuellen Git-Diff-Fenster können Go to Definition, Declaration, Type Definition und Implementation ausgeführt werden; das Ziel wird in „etriebenen Quellcode des aktuellen Workspace“ geöffnet.

• Es können mehrere Commits nacheinander angesehen und geprüft werden? Korrekt: „Es ist möglich, immer nur ein“ einzelnes Commit zu betrachten.

• Nach Commit-Author filtern Sie den Branch-Diff. Über Author contains filtert Filtern mit Name- oder E-Mail-Schlüsselwort.

• Die Autor-Filterung durchsucht den vollständigen Commit-Verlauf des Branches und stoppt nicht bei 250 Commits; bei großem Verlauf werden die entsprechenden Patches in begrenzten Batches gelesen.

• Unterstützt das Ausschließen von Dateien, Verzeichnissen oder Globs wie src/generated, src/legacy.c, **/test/**, ohne zugrunde den Baseline-Diff zu verändern. Die Ausschlüsse werden in einem kompakten scrollbaren Editor gepflegt; jeder Eintrag kann einzeln geändert oder entfernt werden.

• Alle nach den aktuellen Filtern sichtbaren Dateien lassen sich in ein Zielverzeichnis exportieren. Der Export erhält die Struktur des Repositorys, hängt an Quelldateinamen .diff an und enthält Standard-Unified-Diff-Marker und Hunks.

• Über einen integrierten, nur lesenden MCP-Server wird die gespeicherte Session samt gefilterten Git-Daten in Echtzeit für einen lokalen KI-Client bereitgestellt. Im von MCP die gleichen Autor-, Such-, Status-, Erweiterungs-, Glob-, Ausschlusspfad- und Deleting-Gelo-Regeln an die Verzeichnisbaum an, wie die Exportfunktion.

• Die Rechtsklick-Menü von Dateien bietet Datei öffnen, Diff öffnen, Ausnahme-Ausschluss, im System-Dateimanager anzeigen sowie Kopieren von Us-; Eintrag, absoluten Pfad, Dateinamen oder URI. Das Kontextmenü in Verzeichnisse unterstützt das Ausschließen des ganzen Oberverzeichnis, Anzeigen im Explorer oder FileManager, Suche im Ordner sowie Kopieren des Verzeichnispfads, Namen oder der URI.

• Kompatibel mit Reviewer Cockpit: Es wird .diffly/findings.json-Datei gelesen, die Zusammenfassungen von Beschreibungen, Hinweisen und fehlenden Punkten zeigt, Agree/Skip-Klassifizierung, und die Hinweiszeilen in geöffneten Editoren markiert.

• Meldet eine Warnung, wenn der Baseline-Branch dem aktuellen Branch voraus ist, und aktualisiert, wenn sich der Git-Status oder .diffly/findings.json ändert.

• Unterstützt mehrere Root-Workspaces und speichert das ausgewählte Repository in der Session.

• Die beliebig viele benannte Sessions angelegt werden. Jede Session speichert gleichermaßen Workspace-Ordner, Baseline-Branch, neue Author/Commit-Bereich, Suchoptionen, Dateifilter und Ausschlusspfade.

Verwendung

1. Öffnen Sie in VS Code ein Git-Repository.

2. Öffnen Sie Branch Diff über die Aktivität, oder führen Sie den Befehl Branch Diff Explorer: Open Sidebar aus.

3. Wählen Sie, ob Sie den Baseline-Branch auswählen möchten. Die Standarderkennung prüft der Reihe nach origin/HEAD, main, master.

4. Optional: Festlegen Author contains oder Auswahl Single commit. Im Author-Modus wird vorhandene uncommittete Dateien automatisch ausgeblendet, da sie keinen Commit-Author aufweisen.

5. Wählen Sie in einem Multi-Root-Workspace den Workspace-Folder. Verwenden Sie die Schaltflächen neben dem Dropdown Session, um neue, unbenutzte und zugewiesene Diff-Konfigurationen anzulegen oder zu löschen.

6. Führen Sie Branch Diff Explorer: Open Settings aus, um Startwerte für den Basisbuch-Branch, Zeilenvorschau, Git-Ausgabepuffer oder Git-Befehls-Timeout festzulegen. Auch die Fehleransicht bietet einen Weg zum Einstellungen.

7. Klicken Sie oben auf Export filtered diff (⇤), wählen Sie einen Zielordner und bestätigen Sie das Überschreiben bereits vorhandener .diff-Dateien.

8. Klicken Sie oben auf MCP, kopieren Sie die Codex-Konfiguration bzw. Claude-Code-Konfiguration oder führen Sie den lokalen MCP-„Selbstcheck“ aus. Für MCPServer ist Node.js 18 bzw. später erforderlich; falls node nicht in Ihrer PATH liegt, legen Sie MCP: Node Command fest.

Bereitstellung von Änderungen über MCP für KI

Die Erweiterung kopiert die integrierten MCP-Dateien in ein stabiles VS Code-Speicherverzeichnis und synchronisiert alle gespeicherten Sitzungen in eine für den Workspace weltweite Statusdatei. Wenn die KI die Werkzeuge aufruft, berechnet der MCP-Server die Git-Änderungen neu; nach Abschluss der Konfiguration ist weder ein Vorab-Export des Diffs noch ein dauerhaft geöffnetes VS Code-Fenster nötig.

Codex: MCP → Copy Codex MCP-Konfiguration klicken und die erzeugte TOML in ~/.codex/config.toml oder im vertrauenswürdigen .config.toml des Projekts einfügen; Codex anschließend neu starten. Codex Desktop, CLI und IDE-Plugin unterstützen laufenden STDIO MCP und teilen sich dieselbe Konfiguration. Siehe Codex MCP-Dokumentation.

Claude Code: Klicken Sie MCP → Copy Claude Code MCP configuration und fügen Sie die erzeugte JSON-Konfiguration in .mcp.json des beim Projekt ein; anschließend den Claude-Leuchten wieder verbinden. Die erzeugte Konfiguration darf nur die lokale Node-Anweisung, den Person-Laufpfad und den Zustandsdateipfad des Workspace enthalten.

Empfohlene MCP-Aufrufreihenfolge

MCP-Clients können die Werkzeuge anhand der natürlichen Sprachabfrage automatisch wählen. Für einen stabilen Review und einen höheren Material Kunst wird empfohlen, dass die KI die folgenden Aktionen in der Reihenfolge ausführt:

1. Rufen Sie list_diff_sessions auf, um die aktive oder die Sitzung Sitzung zu finden.

2. Rufen Sie get_same_Session auf get_diff_summary, um Repository, Basis-Branch, aktuelle Commit-Branch, Autor-/Commitbereich, Filterbedingungen und die sichtbare Dateiliste zu bestätigen.

3. Lesen Sie die Seitenweise list_diff_files, um die vollständige Menge der reell im Verzeichnisbaum sichtbaren Dateien zu erhalten.

4. Rufen Sie get_filtered_diff für die zu überprüfenden Dateien auf.

5. Reicht der Patch-Kontext nicht aus, lesen Sie mit read_file_context den vollständigen Quellcode.

6. Nur wenn der vollständige Branch- Vergleich aller Autoren erforderlich ist, rufen Sie get_branch_diff auf.

Beschreibung der MCP-Werkzeuge

Alle Werkzeuge sind schreibgeschützt und akzeptieren optional eine sessionId. Wenn keine Angabe gemacht wird, verwendet wird die der im Branch Diff Explorer so ausgewählt aktive Sitzung verwendet.

get_diff_summary liefert zwei verschiedener Bestandteile, die Bedeutung verschiedener Ergebnisse:

• scopeTotals: Die Summen über den vollständigen Autor- oder Commitbereich, bevor die Dateifilter der UI angewendet.

• visibleTotals: Die Summen, die nach Anwendung aller UI-Filtern und nach Entfernen gelöschter Dateien tatsächlich für list_diff_files, den Export und den Dateienbaum verfügbar sind.

Wenn Author-Verbindung nicht aktiv ist, enthält der Text von get_filtered_diff nur den Patch der passenden Autors; die Zahlen additions und deletions jeder Datei entsprechen dem final sichtbaren Diff von author-before → working tree, nicht der Semantically Kombination mehrerer Commits dieses Autors und enthält auch keine beiträge von anderen. get_branch_diff „enthält absichtlich auch Änderungen anderer Autoren; es für den Autor, die keinen Autor geprüft wird nicht „durch“ get_filtered_diff.

read_file_context.side unterstützt:

• current (Standard): Inhalt des aktuellen Arbeitsverzeichnisses.

• head: Inhalt der Datei in HEAD.

• base: Inhalt der Git-Merge-Basis, wird im Diff-Vergleich verwendet.

• author_before: die Inhalt der aktuellen Datei, nachdem wird der Patch des ausgewählten Autors zurückgenommen. Das entspricht der Linken Seite des Author-Diffs in VS Code. Wird nur die Sitzungen mit aktiviertem Autor-Filter unterstützt.

Beispiele für die Seitierung

Die Datei- und Commit-Listen geben nextCursor zurück. Geben Sie ihn bei jedem weiteren Aufruf weiter es zurück, bis das Feld in der Antwort nicht mehr vorhanden ist:

{
  "sessionId": "session-id",
  "pathPrefix": "src/services",
  "cursor": 0,
  "limit": 100
}

Diff- und Quellcode-Werkzeuge geben nextStartLine zurück. Seiten mit Text haben standardmäßig 800 Zeilen und unterstützen jeweils höchstens 5.000 Zeilen:

{
  "sessionId": "session-id",
  "path": "src/services/example.ts",
  "startLine": 1,
  "maxLines": 1000
}

Der Datei-Parameter muss den exakten Repository-Pfad verwenden, den list_diff_files zurückgibt.

Empfohlene Review-Prompts

使用 branch-diff-explorer MCP。先列出已保存的 Diff 会话并汇总当前活动会话，
然后分页读取 list_diff_files 返回的全部文件。使用 get_filtered_diff 审查文件，
确保范围只包含当前选择的 Author 或 Commit；需要完整源码上下文时调用
read_file_context。只有需要把作者补丁与完整分支改动比较时才调用
get_branch_diff。输出问题严重程度、文件路径、相关行、原因和修复建议。

Suche nach bestimmten Inhalten:

在当前过滤后的改动中搜索 glfs_bdev_get_route_stats，然后读取匹配文件的
filtered diff、current 源码和 author_before 源码上下文。

Prüfe nur einen bestimmten Ordner:

只审查 source/services/spdk 下的文件。调用 list_diff_files 时使用
pathPrefix，跟随所有分页 cursor，并且不要审查其他作者的改动。

MCP-Troubleshooting

• Wenn kein Server im Verzeichnis erscheint: Starten Sie Codex oder Claude Code neu und überprüfen Sie die Liste der MCP-Server. In Codex können Sie die Liste mit /mcp aufrufen.

• Wenn Ergebnisse veraltet wirken: Rufen Sie get_diff_summary mit refresh: true auf.

• Wenn ein Pfad abgelehnt wird: Rufen Sie list_diff_files erneut auf uns, an die genaue Pfad können Sie übernehmen.

• Wenn eine Antwort abgeschnitten wird: Folgern Sie weiterhin nextCursor bzw. nextStartLine uns richtig und seien Sie nicht die aktuelle Seite als vollständiges Ergebnis.

• author_before setzt voraus, dass die aktuelle Sitzung die Autor-Filterung aktiv hat.

• MCP verarbeitet keine Binärdateien, Symbolik (Basin) oder Dateien über 32 MB als Quell-Kontext zurück.

Das Addon verwendet ausschließlich den lokalen git-Befehl und sendet auch in keiner Netzwerk-Übersicht Quellcode, Commit-Metadaten, Reviewer-Probleme oder Suche. Der MCP-Server ist standardmäßig local STIO und öffnet keinen Netzwerk-Port.

Entwicklung

npm install
npm run check
npm test
npm run build

Drücken Sie in VS Code F5, um eine Extension Development zu starten. Verwenden Sie npm run package für die Konstruktion des VSIX.