Branch Diff Explorer

English | 简体中文

Локальное расширение VS Code для просмотра только тех изменений, которые относятся к вашей текущей ветке Git. Оно не имеет проверок лицензий, ограничений по использованию, телеметрии или платных функций.

Возможности

• Поиск добавлений и удалений среди закоммиченных, проиндексированных и неиндексированных изменений.

• Показывает каждый изменённый путь один раз в дереве каталогов, даже если он был изменён в нескольких коммитах или состояниях Git; его итоговые строки отражают только окончательный diff.

• Исключает удалённые файлы из дерева каталогов и его видимых итогов. Полный объём сравнения, включая удаления, остаётся доступным через MCP scopeTotals.

• Сводка + / − на боковой панели всегда суммирует файлы, отображаемые в данный момент в дереве каталогов, поэтому изменения поиска, глоба, типа файла и исключённых путей немедленно обновляют её.

• Сравнивайте свою ветку с любой локальной или удалённой базовой веткой.

• Фильтруйте по типу изменения файла, состоянию Git, расширению и шаблонам glob.

• Открывайте обычные изменения, изменения, отфильтрованные по автору, и отдельные коммиты во встроенном редакторе бокового сравнения VS Code.

• Строки файлов открывают полный diff от базовой ветки до рабочего дерева; при выборе одного коммита они открывают diff от родителя коммита до самого коммита.

• Дерево каталогов и редактор diff используют одну и ту же базу слияния Git, поэтому изменения, добавленные независимо в базовую ветку после расхождения, не просачиваются в левую часть diff ветки.

• При фильтрации по автору коммита файловые diff включают только выделенные изменения соответствующих авторов, сохраняя остальную часть текущего файла видимой.

• Выделение авторов остаётся точным, когда другой коммит изменяет окружающий контекст, вставляет изменения внутри чистых добавлений или смешанных блоков замены или переименовывает файл позже. Большие отредактированные блоки используют уникальные строки, такие как сигнатуры функций, в качестве якорей перед сопоставлением общих фигурных скобок и пробелов. Если правка автора была перезаписана или перемещена за пределы безопасного сопоставления, заголовок diff сообщает об этом, а не скрывает её молча.

• Строки, отфильтрованные по автору, используют итоговые значения author-before → working tree, показанные редактором, а не суммируют каждый соответствующий коммит или включают изменения других авторов.

• Для файла, отсутствующего в базовой ветке, полный текущий файл остаётся видимым, а выделяются только строки выбранного автора.

• Переход к определению, объявлению, определению типа и реализации из виртуальной панели Git diff; назначение открывается в исходном коде активного рабочего пространства.

• Просматривайте по одному коммиту за раз.

• Фильтруйте diff ветки по автору коммита. Выберите одного или нескольких авторов, и представление покажет только патчи, созданные их коммитами после выбранной базы. Поле Автор содержит также фильтрует по ключевому слову имени или электронной почты.

• Фильтрация по автору сканирует полный диапазон ветки, а не молча останавливается на 250 коммитах. Соответствующие патчи загружаются ограниченными пакетами для больших историй.

• Исключайте файлы, каталоги или glob-шаблоны (src/generated, src/legacy.c, **/test/**) без изменения базового Git diff. Исключения используют компактный прокручиваемый редактор, где каждая запись может быть изменена или удалена независимо.

• Экспортируйте каждый файл, видимый после фильтрации, в выбранный каталог. Экспорт сохраняет структуру каталогов репозитория, добавляет .diff к каждому имени исходного файла и содержит стандартные маркеры и фрагменты unified diff.

• Предоставляйте сохранённые сеансы и их живые отфильтрованные данные Git локальным AI-клиентам через встроенный, доступный только для чтения STDIO MCP-сервер. MCP использует те же правила автора, поиска, статуса, расширения, glob, исключённых путей и удалённых файлов, что и дерево и действие экспорта.

• Щёлкните правой кнопкой мыши по любому изменённому файлу, чтобы открыть его, открыть его diff, исключить его, показать в файловом менеджере ОС или скопировать его относительный путь, абсолютный путь, имя файла или URI. Щёлкните правой кнопкой мыши по каталогу, чтобы исключить весь каталог, показать его в Explorer или ОС, выполнить поиск внутри него или скопировать его путь, имя или URI.

• Совместимость с Reviewer cockpit: читает .diffly/findings.json, показывает брифинг, находки и элементы незавершённой работы, поддерживает сортировку Agree/Skip и украшает отмеченные строки в открытых редакторах.

• Показывает, когда выбранная базовая ветка опережает текущую ветку, и обновляется при изменении состояния Git или .diffly/findings.json.

• Поддерживает многокорневые рабочие пространства и запоминает выбранный репозиторий во время сеанса.

• Создавайте неограниченное количество именованных сеансов. Каждый сеанс сохраняет свою папку рабочего пространства, базовую ветку, область автора/коммита, параметры поиска, фильтры файлов и исключённые пути независимо в хранилище рабочего пространства VS Code.

Related MCP server: GitPilot MCP

Использование

1. Откройте Git-репозиторий в VS Code.

2. Откройте Branch Diff на панели действий или выполните команду Branch Diff Explorer: Open Sidebar.

3. Выберите базовую ветку. По умолчанию она автоматически определяется из origin/HEAD, затем main, затем master.

4. При желании выберите автора или коммит; режим автора намеренно скрывает незакоммиченную работу, поскольку у неё ещё не может быть автора коммита.

5. В многокорневом рабочем пространстве выберите Папка рабочего пространства. Используйте элементы управления +, переименование и удаление в выборе Сеанс, чтобы управлять независимыми настройками diff.

6. Откройте Branch Diff Explorer: Open Settings, чтобы настроить базовую ветку, лимит строк предпросмотра, буфер вывода Git или тайм-аут команды Git. Интерфейс ошибок также ссылается на эти настройки.

7. Используйте кнопку Экспорт отфильтрованных diff (⇩) в заголовке, выберите целевой каталог и подтвердите перед перезаписью любых существующих экспортированных файлов .diff.

8. Используйте MCP в заголовке, чтобы скопировать конфигурацию Codex или Claude Code или запустить локальный самотест MCP. Сервер требует Node.js 18 или новее; установите MCP: Node Command, если node не находится в PATH.

Доступ к AI через MCP

Расширение копирует свой встроенный MCP-рантайм в стабильное хранилище VS Code и поддерживает файл состояния, специфичный для рабочего пространства, синхронизированный со всеми сохранёнными сеансами. Сервер пересчитывает изменения Git, когда AI-клиент вызывает его; экспортированные файлы diff и открытое окно VS Code не требуются после настройки.

Для Codex скопируйте сгенерированный TOML в ~/.codex/config.toml или в доверенный проект .codex/config.toml, затем перезапустите локальный клиент Codex. Клиенты Codex desktop, CLI и IDE поддерживают локальные STDIO MCP-серверы и используют эту конфигурацию. См. официальную документацию Codex MCP.

Для Claude Code объедините сгенерированный JSON-объект в .mcp.json проекта и переподключите клиент. Сгенерированная конфигурация содержит только локальную команду Node, путь к встроенному серверу и путь к файлу состояния рабочего пространства.

Рекомендуемый рабочий процесс MCP

MCP-клиенты могут выбирать инструменты из запроса на естественном языке. Для надёжного и эффективного по токенам обзора попросите клиента следовать этой последовательности:

1. Вызовите list_diff_sessions, чтобы найти активный или запрошенный сеанс.

2. Вызовите get_diff_summary, чтобы подтвердить репозиторий, ветку, базу сравнения, область автора или коммита, фильтры и видимые итоги.

3. Пролистайте list_diff_files, чтобы получить точный набор файлов, показанных в дереве каталогов.

4. Прочитайте get_filtered_diff для каждого просматриваемого файла.

5. Используйте read_file_context, когда патч не содержит достаточного окружающего исходного кода.

6. Используйте get_branch_diff только тогда, когда требуется полное изменение ветки от всех авторов для сравнения.

Справочник инструментов MCP

Все инструменты доступны только для чтения и принимают необязательный sessionId. Если он опущен, используется активный сеанс Branch Diff Explorer.

get_diff_summary сообщает два намеренно разных итога:

• scopeTotals описывает полную область автора или коммита до применения фильтров файлов интерфейса.

• visibleTotals описывает точно не удалённые файлы, доступные через list_diff_files, экспорт и дерево каталогов после всех фильтров интерфейса.

С Автор содержит, get_filtered_diff.text содержит только патчи соответствующих авторов. Его построчные additions и deletions соответствуют окончательному видимому diff от автора до рабочего дерева; они не накапливают повторяющиеся коммиты и не включают других авторов. get_branch_diff намеренно включает изменения других авторов, поэтому он не должен заменять get_filtered_diff во время обзора, ограниченного автором.

read_file_context.side принимает:

• current (по умолчанию): текущее содержимое рабочего дерева.

• head: файл на HEAD.

• base: файл на базе слияния Git, используемой для сравнения.

• author_before: текущее содержимое с откатом патча выбранного автора, соответствующее левой стороне diff VS Code, отфильтрованного по автору. Эта сторона доступна только в сеансах, отфильтрованных по автору.

Примеры пагинации

Списки файлов и коммитов возвращают nextCursor. Передавайте его обратно, пока он не исчезнет:

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

Инструменты diff и исходного кода возвращают nextStartLine. Текстовые страницы по умолчанию содержат 800 строк и поддерживают до 5 000 строк за вызов:

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

Всегда используйте точный путь относительно репозитория, возвращённый list_diff_files.

Предлагаемый запрос для обзора

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.

Полезные целенаправленные запросы включают:

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

• Если сервер отсутствует, перезапустите клиент Codex или Claude и проверьте список его MCP-серверов. В Codex используйте /mcp.

• Если результаты кажутся устаревшими, вызовите get_diff_summary с refresh: true.

• Если путь отклонён, получите его снова из list_diff_files и передайте точный возвращённый путь.

• Если ответ обрезан, следуйте nextCursor или nextStartLine, а не предполагайте, что результат полный.

• author_before требует сеанса, отфильтрованного по автору.

• Бинарные файлы, цели символических ссылок и исходные файлы размером более 32 МБ не возвращаются как исходный контекст.

Расширение вызывает только ваш локальный исполняемый файл git и не отправляет исходный код, метаданные коммитов, результаты проверки или поисковые запросы по сети. MCP-сервер работает через локальный STDIO и не открывает сетевых портов.

Разработка

npm install
npm run check
npm test
npm run build

Нажмите F5 в VS Code, чтобы запустить хост разработки расширения. Соберите VSIX с помощью npm run package.

Русский

Branch Diff Explorer — это полностью локальное расширение VS Code для просмотра и проверки только изменений, связанных с текущей веткой Git. В расширении нет проверки лицензии, ограничений по количеству использований, телеметрии или платных функций.

Возможности

• Поиск добавленных и удалённых строк в закоммиченных, проиндексированных и незакоммиченных изменениях.

• Каждый путь в дереве каталогов отображается только один раз, даже если файл был изменён в нескольких коммитах или существует в нескольких состояниях Git; количество добавленных и удалённых строк отражает только итоговый Diff и не суммирует промежуточные коммиты.

• Удалённые файлы не отображаются в дереве каталогов и в видимых сводках; полный диапазон сравнения, включающий удалённые файлы, по-прежнему доступен через MCP scopeTotals.

• + / − в верхней части боковой панели всегда суммирует файлы, отображаемые в дереве каталогов, поэтому при изменении поиска, Glob, типа файла или исключённых путей статистика немедленно пересчитывается.

• Можно сравнивать с любой локальной или удалённой базовой веткой.

• Поддерживается фильтрация по типу изменения, статусу Git, расширению и Glob-выражениям.

• Обычные изменения ветки, изменения с фильтром по автору и отдельные коммиты открываются в нативном окне сравнения VS Code слева и справа.

• При клике на файл открывается полный Diff от базовой ветки до текущего рабочего каталога; при выборе Single commit открывается Diff от родительского коммита до этого коммита.

• Дерево каталогов и редактор Diff используют одну и ту же Git merge base, поэтому несвязанные изменения, добавленные в базовой ветке после расхождения веток, не попадают в левую часть Diff.

• При фильтрации по Commit Author Diff по-прежнему показывает полный текущий файл, но подсвечивает только изменения соответствующего автора.

• Даже если другие коммиты изменили окружающий контекст, продолжили вставку в чисто добавленных или смешанных блоках замены или переименовали файл позже, подсветка автора остаётся максимально точной. Для крупных блоков правок в качестве якорей в первую очередь используются уникальные строки кода, такие как сигнатуры функций, а затем сопоставляются распространённые фигурные скобки и пустые строки. Если изменение автора было перезаписано или перемещено в место, где его нельзя безопасно определить, заголовок Diff явно укажет на это, а не молча пропустит.

• В режиме Author количество строк в файле использует статистику итогового Diff author-before → working tree, который фактически отображается в редакторе; оно не суммирует несколько коммитов автора и не включает изменения других авторов.

• Если файл не существует в базовой ветке, Diff показывает полный текущий файл, но подсвечивает только строки кода, добавленные выбранным автором.

• Из виртуального окна Git Diff можно выполнять Go to Definition, Declaration, Type Definition и Implementation; цель открывается в реальном исходном коде текущего Workspace.

• Поддерживается просмотр и проверка только одного коммита за раз.

• Фильтрация Diff ветки по автору коммита. Можно фильтровать коммиты по имени или ключевым словам электронной почты с помощью Author contains.

• Фильтр автора сканирует полный диапазон коммитов ветки и не останавливается молча на 250 коммитах; большая история коммитов читает соответствующие патчи ограниченными пакетами.

• Поддерживается исключение файлов, каталогов или Glob, например src/generated, src/legacy.c, **/test/**, без изменения базового Diff. Исключения редактируются в компактном прокручиваемом редакторе, каждый элемент можно изменить или удалить отдельно.

• Можно экспортировать все видимые после фильтрации файлы в указанный каталог. Экспорт сохраняет структуру каталогов репозитория, добавляет .diff к имени исходного файла, а содержимое включает стандартные маркеры Unified Diff и Hunk.

• Встроенный read-only STDIO MCP Server предоставляет сохранённые сеансы и их Git-данные с фильтрацией в реальном времени локальным AI-клиентам. MCP использует те же правила автора, поиска, статуса, расширения, Glob, исключённых путей и удалённых файлов, что и дерево каталогов и экспорт.

• Контекстное меню файла поддерживает открытие файла, открытие Diff, добавление в исключения, показ в системном файловом менеджере, а также копирование относительного пути, абсолютного пути, имени файла или URI. Контекстное меню каталога поддерживает исключение всего каталога, показ в Explorer или системном файловом менеджере, поиск внутри каталога, а также копирование пути, имени каталога или URI.

• Совместимость с Reviewer Cockpit: читает .diffly/findings.json, отображает сводку проверки, проблемы и отсутствующие элементы, поддерживает классификацию Agree/Skip и подсвечивает проблемные строки в открытых редакторах.

• Показывает предупреждение, когда базовая ветка опережает текущую, и обновляется при изменении статуса Git или .diffly/findings.json.

• Поддерживает Multi-root Workspace и запоминает выбранный репозиторий в сеансе.

• Можно создавать любое количество именованных сеансов. Каждый сеанс сохраняет Workspace folder, базовую ветку, диапазон Author/Commit, параметры поиска, фильтры файлов и исключённые пути.

Использование

1. Откройте Git-репозиторий в VS Code.

2. Откройте Branch Diff на панели действий (Activity Bar) или выполните команду Branch Diff Explorer: Open Sidebar.

3. Выберите базовую ветку. По умолчанию она автоматически определяется из origin/HEAD, main, master.

4. Необязательно: задайте Author contains или выберите Single commit. Режим Author автоматически скрывает незакоммиченные изменения, так как у них нет Commit Author.

5. В Multi-root Workspace выберите Workspace folder. Используйте кнопки добавления, переименования и удаления рядом с раскрывающимся списком Session, чтобы управлять независимыми конфигурациями Diff.

6. Выполните Branch Diff Explorer: Open Settings, чтобы настроить базовую ветку по умолчанию, количество строк предпросмотра, буфер вывода Git или тайм-аут команд Git. Вход в настройки также доступен на экране ошибок.

7. Нажмите Export filtered diffs (⇩) в верхней части, выберите целевой каталог и подтвердите перезапись существующих файлов .diff.

8. Нажмите MCP в верхней части, скопируйте конфигурацию Codex или Claude Code или запустите локальную самопроверку MCP. MCP Server требует Node.js 18 или новее; если node отсутствует в PATH, задайте MCP: Node Command.

Предоставление изменений AI через MCP

Расширение копирует встроенные файлы запуска MCP в стабильный каталог хранения VS Code и синхронизирует все сохранённые сеансы в файл состояния, относящийся к текущему Workspace. Когда AI вызывает инструменты, MCP Server пересчитывает Git-изменения; после настройки не требуется предварительный экспорт Diff или постоянно открытое окно VS Code.

Codex: нажмите MCP → Copy Codex MCP configuration и добавьте сгенерированный TOML в ~/.codex/config.toml или в .codex/config.toml доверенного проекта, затем перезапустите клиент Codex. Codex Desktop, CLI и плагин IDE поддерживают локальный STDIO MCP и используют одну и ту же конфигурацию. См. официальную документацию Codex MCP.

Claude Code: нажмите MCP → Copy Claude Code MCP configuration и объедините сгенерированный JSON в .mcp.json проекта, затем переподключите клиент. Сгенерированная конфигурация содержит только локальную команду Node, путь встроенного Server и путь к файлу состояния Workspace.

Рекомендуемый порядок вызова MCP

MCP-клиент может автоматически выбирать инструменты на основе запросов на естественном языке. Для стабильной проверки и снижения расхода токенов рекомендуется, чтобы AI вызывал инструменты в следующем порядке:

1. Вызовите list_diff_sessions, чтобы найти активный или указанный сеанс.

2. Вызовите get_diff_summary, чтобы подтвердить репозиторий, текущую ветку, базовую ветку, диапазон Author/Commit, условия фильтрации и сводку видимых файлов.

3. Вызывайте list_diff_files постранично, чтобы получить полный набор файлов, фактически отображаемых в дереве каталогов.

4. Вызовите get_filtered_diff для файлов, которые нужно проверить.

5. Когда контекста патча недостаточно, используйте read_file_context, чтобы прочитать полный исходный код.

6. Вызывайте get_branch_diff только тогда, когда нужно сравнить полные изменения ветки всех авторов.

Описание инструментов MCP

Все инструменты доступны только для чтения и принимают необязательный sessionId. Если он не передан, используется текущий активный сеанс Branch Diff Explorer.

get_diff_summary возвращает две группы сводок с разным значением:

• scopeTotals: сводка полного диапазона Author или Commit до применения фильтров файлов UI.

• visibleTotals: сводка, фактически доступная через list_diff_files, экспорт и дерево каталогов после применения всех фильтров UI и удаления deleted-файлов.

При включённом Author contains get_filtered_diff.text содержит только патчи соответствующего автора; additions и deletions каждого файла соответствуют итоговому видимому Diff author-before → working tree и не суммируют несколько коммитов автора и не включают других авторов. get_branch_diff намеренно включает изменения других авторов, поэтому при проверке Author его нельзя использовать вместо get_filtered_diff.

read_file_context.side поддерживает:

• current (по умолчанию): содержимое текущего рабочего каталога.

• head: содержимое файла в HEAD.

• base: содержимое Git merge base, используемой для этого сравнения.

• author_before: содержимое текущего файла после отмены патча выбранного автора, соответствует левой части Author Diff в VS Code. Этот режим поддерживается только в сеансах с фильтром Author.

Примеры постраничной навигации

Списки файлов и коммитов возвращают nextCursor. Передавайте его в следующий вызов, пока поле не исчезнет из ответа:

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

Инструменты Diff и исходного кода возвращают nextStartLine. Текстовая страница по умолчанию возвращает 800 строк, максимум 5 000 строк за раз:

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

Параметр файла должен использовать точный относительный путь репозитория, возвращённый list_diff_files.

Рекомендуемые промпты для проверки

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

Поиск по конкретному содержимому:

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

Проверка только определённого каталога:

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

Устранение неполадок MCP

• Если Server отсутствует в клиенте, перезапустите клиент Codex или Claude и проверьте список MCP Server; в Codex можно использовать /mcp.

• Если результаты выглядят устаревшими, вызовите get_diff_summary с refresh: true.

• Если путь отклонён, получите его заново из list_diff_files и передайте точно такой же путь.

• Если ответ обрезан, продолжайте следовать за nextCursor или nextStartLine и не считайте текущую страницу полным результатом.

• author_before требует, чтобы в текущем сеансе был включён фильтр Author.

• MCP не возвращает бинарные файлы, цели символических ссылок или файлы размером более 32 МБ в качестве контекста исходного кода.

Расширение вызывает только локальные команды git и не отправляет по сети исходный код, метаданные коммитов, проблемы Reviewer или результаты поиска. MCP Server использует локальный STDIO и не прослушивает сетевые порты.

Разработка

npm install
npm run check
npm test
npm run build

Нажмите F5 в VS Code, чтобы запустить хост разработки расширения. Соберите VSIX с помощью npm run package.