Branch Diff Explorer

English | 简体中文

Una extensión de VS Code totalmente local para revisar únicamente los cambios relacionados con tu rama Git actual. No tiene comprobaciones de licencia, límites de uso, telemetría ni funciones de pago.

Características

• Busca adiciones y eliminaciones en cambios confirmados, en el área de preparación y sin preparar.

• Muestra cada ruta modificada una sola vez en el árbol de directorios, incluso cuando se modificó en varios commits o estados de Git; sus totales de líneas reflejan solo el diff final.

• Mantiene los archivos eliminados fuera del árbol de directorios y de sus totales visibles. El alcance completo de la comparación, incluidas las eliminaciones, sigue disponible a través de MCP scopeTotals.

• El resumen + / − de la barra lateral siempre totaliza los archivos que se muestran actualmente en el árbol de directorios, de modo que la búsqueda, los globs, los tipos de archivo y los cambios de rutas excluidas lo actualizan de inmediato.

• Compara tu rama con cualquier rama base local o remota.

• Filtra por tipo de cambio de archivo, estado de Git, extensión y patrones glob.

• Abre cambios normales, cambios filtrados por autor y commits individuales en el editor de diff lado a lado nativo de VS Code.

• Las filas de archivos abren el diff completo de la rama base al árbol de trabajo; cuando se selecciona un commit individual, abren el diff de padre a commit de ese commit.

• El árbol de directorios y el editor de diff usan la misma base de fusión de Git, por lo que los cambios añadidos de forma independiente a la rama base después de la divergencia no se filtran en el lado izquierdo de un diff de rama.

• Al filtrar por autor del commit, los diffs de archivos incluyen solo los cambios resaltados de los autores coincidentes, manteniendo visible el resto del archivo actual.

• Los resaltados de autor siguen siendo precisos cuando otro commit cambia el contexto circundante, inserta dentro de adiciones puras o bloques de reemplazo mixtos, o renombra el archivo más tarde. Los bloques editados grandes usan líneas únicas, como firmas de funciones, como anclas antes de comparar llaves y espacios en blanco comunes. Si una edición de autor se ha sobrescrito o movido más allá de una coincidencia segura, el título del diff lo indica en lugar de ocultarlo silenciosamente.

• Las filas filtradas por autor usan los totales de líneas finales de autor-antes → árbol de trabajo que muestra el editor, en lugar de sumar cada commit coincidente o incluir cambios de otros autores.

• Para un archivo ausente de la rama base, el archivo actual completo permanece visible, mientras que solo se resaltan las líneas del autor seleccionado.

• Ir a Definición, Declaración, Definición de Tipo e Implementación desde un panel de diff virtual de Git; el destino se abre en el código fuente del espacio de trabajo activo.

• Inspecciona un commit a la vez.

• Filtra los diffs de rama por autor de commit. Selecciona uno o más autores y la vista muestra solo los parches producidos por sus commits después de la base seleccionada. El campo Autor contiene también filtra por una palabra clave de nombre o correo electrónico.

• El filtrado por autor escanea el rango completo de la rama en lugar de detenerse silenciosamente en 250 commits. Los parches coincidentes se cargan en lotes limitados para historias grandes.

• Excluye archivos, directorios o globs (src/generated, src/legacy.c, **/test/**) sin cambiar el diff de Git base. Las exclusiones usan un editor compacto y desplazable donde cada entrada se puede cambiar o eliminar de forma independiente.

• Exporta cada archivo actualmente visible después del filtrado a un directorio seleccionado. Las exportaciones conservan el árbol de directorios del repositorio, añaden .diff a cada nombre de archivo fuente y contienen marcadores y hunks de diff unificado estándar.

• Expone las sesiones guardadas y sus datos de Git filtrados en vivo a clientes de IA locales a través de un servidor MCP STDIO de solo lectura incluido. MCP usa las mismas reglas de autor, búsqueda, estado, extensión, glob, rutas excluidas y archivos eliminados que el árbol y la acción de exportación.

• Haz clic derecho en cualquier archivo modificado para abrirlo, abrir su diff, excluirlo, revelarlo en el administrador de archivos del sistema operativo, o copiar su ruta relativa, ruta absoluta, nombre de archivo o URI. Haz clic derecho en un directorio para excluir el directorio completo, revelarlo en Explorer o en el sistema operativo, buscar dentro de él, o copiar su ruta, nombre o URI.

• Compatibilidad con la cabina de revisión: lee .diffly/findings.json, muestra el informe, los hallazgos y los elementos de trabajo pendientes, admite el triaje Aceptar/Omitir y decora las líneas marcadas en los editores abiertos.

• Muestra cuándo la rama base seleccionada está por delante de la rama actual y se actualiza cuando cambia el estado de Git o .diffly/findings.json.

• Admite espacios de trabajo de múltiples raíces y recuerda el repositorio seleccionado durante una sesión.

• Crea sesiones con nombre ilimitadas. Cada sesión guarda su carpeta de espacio de trabajo, rama base, alcance de autor/commit, opciones de búsqueda, filtros de archivos y rutas excluidas de forma independiente en el almacenamiento del espacio de trabajo de VS Code.

Related MCP server: GitPilot MCP

Uso

1. Abre un repositorio de Git en VS Code.

2. Abre Branch Diff desde la barra de actividades, o ejecuta Branch Diff Explorer: Open Sidebar.

3. Elige una rama base. La predeterminada se detecta automáticamente desde origin/HEAD, luego main, luego master.

4. Opcionalmente, elige un autor o un commit; el modo de autor oculta intencionalmente el trabajo no confirmado porque aún no puede tener un autor de commit.

5. En un espacio de trabajo de múltiples raíces, selecciona Carpeta del espacio de trabajo. Usa los controles +, de renombrado y de eliminación del selector de Sesión para gestionar configuraciones de diff independientes.

6. Abre Branch Diff Explorer: Open Settings para configurar la rama base, el límite de líneas de vista previa, el búfer de salida de Git o el tiempo de espera del comando de Git. La interfaz de error también enlaza a esta configuración.

7. Usa el botón Exportar diffs filtrados (⇩) en el encabezado, selecciona un directorio de destino y confirma antes de sobrescribir cualquier archivo .diff exportado existente.

8. Usa MCP en el encabezado para copiar una configuración de Codex o Claude Code, o para ejecutar la autoprueba local de MCP. El servidor requiere Node.js 18 o más reciente; establece MCP: Node Command si node no está en PATH.

Acceso a IA a través de MCP

La extensión copia su runtime MCP incluido al almacenamiento estable de VS Code y mantiene un archivo de estado específico del espacio de trabajo sincronizado con todas las sesiones guardadas. El servidor recalcula los cambios de Git cuando un cliente de IA lo llama; los archivos de diff exportados y una ventana de VS Code abierta no son necesarios después de la configuración.

Para Codex, copia el TOML generado en ~/.codex/config.toml o en el .codex/config.toml de un proyecto de confianza, y luego reinicia el cliente local de Codex. Los clientes de Codex de escritorio, CLI e IDE admiten servidores MCP STDIO locales y comparten esta configuración. Consulta la documentación oficial de MCP de Codex.

Para Claude Code, fusiona el objeto JSON generado en el .mcp.json del proyecto y vuelve a conectar el cliente. La configuración generada contiene solo un comando Node local, la ruta del servidor incluido y la ruta del archivo de estado del espacio de trabajo.

Flujo de trabajo MCP recomendado

Los clientes MCP pueden seleccionar herramientas a partir de una solicitud en lenguaje natural. Para revisiones fiables y eficientes en tokens, pide al cliente que siga esta secuencia:

1. Llama a list_diff_sessions para encontrar la sesión activa o solicitada.

2. Llama a get_diff_summary para confirmar el repositorio, la rama, la base de comparación, el alcance de autor o commit, los filtros y los totales visibles.

3. Recorre list_diff_files para obtener el conjunto exacto de archivos mostrados en el árbol de directorios.

4. Lee get_filtered_diff para cada archivo que se esté revisando.

5. Usa read_file_context cuando un parche no contenga suficiente código fuente circundante.

6. Usa get_branch_diff solo cuando se requiera el cambio completo de la rama de todos los autores para la comparación.

Referencia de herramientas MCP

Todas las herramientas son de solo lectura y aceptan un sessionId opcional. Cuando se omite, se usa la sesión activa de Branch Diff Explorer.

get_diff_summary informa dos totales intencionalmente diferentes:

• scopeTotals describe el alcance completo de autor o commit antes de los filtros de archivo de la interfaz.

• visibleTotals describe exactamente los archivos no eliminados disponibles a través de list_diff_files, la exportación y el árbol de directorios después de todos los filtros de la interfaz.

Con Autor contiene, get_filtered_diff.text contiene solo parches de autores coincidentes. Sus additions y deletions por archivo coinciden con el diff final visible de autor-antes a árbol de trabajo; no acumulan commits repetidos ni incluyen otros autores. get_branch_diff incluye deliberadamente los cambios de otros autores, por lo que no debe reemplazar a get_filtered_diff durante una revisión con alcance de autor.

read_file_context.side acepta:

• current (predeterminado): contenido actual del árbol de trabajo.

• head: el archivo en HEAD.

• base: el archivo en la base de fusión de Git utilizada por la comparación.

• author_before: contenido actual con el parche del autor seleccionado revertido, que coincide con el lado izquierdo del diff filtrado por autor de VS Code. Este lado solo está disponible en sesiones filtradas por autor.

Ejemplos de paginación

Las listas de archivos y commits devuelven nextCursor. Pásalo de vuelta hasta que no esté presente:

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

Las herramientas de diff y fuente devuelven nextStartLine. Las páginas de texto tienen como predeterminado 800 líneas y admiten hasta 5,000 líneas por llamada:

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

Usa siempre la ruta exacta relativa al repositorio devuelta por list_diff_files.

Prompt de revisión sugerido

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.

Las solicitudes enfocadas útiles incluyen:

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.

Solución de problemas de MCP

• Si el servidor falta, reinicia el cliente de Codex o Claude e inspecciona su lista de servidores MCP. En Codex, usa /mcp.

• Si los resultados parecen obsoletos, llama a get_diff_summary con refresh: true.

• Si se rechaza una ruta, recupérala de nuevo de list_diff_files y pasa la ruta exacta devuelta.

• Si una respuesta se trunca, sigue nextCursor o nextStartLine en lugar de asumir que el resultado está completo.

• author_before requiere una sesión filtrada por autor.

• Los archivos binarios, los destinos de enlaces simbólicos y los archivos fuente de más de 32 MB no se devuelven como contexto de fuente.

La extensión invoca únicamente tu ejecutable local git y no envía por la red código fuente, metadatos de commits, hallazgos de revisión ni consultas de búsqueda. El servidor MCP es STDIO local y no expone ningún puerto de red en escucha.

Desarrollo

npm install
npm run check
npm test
npm run build

Pulsa F5 en VS Code para iniciar un Host de desarrollo de extensiones. Comprueba un VSIX con npm run package.

Chino simplificado

Branch Diff Explorer es una extensión de VS Code que se ejecuta completamente en local y sirve únicamente para ver y revisar los cambios relacionados con la rama del proyecto Git actual. Esta extensión no tiene comprobación de licencia, límites de uso, telemetría ni funciones de pago.

Características

• Busca líneas añadidas y eliminadas en los cambios confirmados, en el área de preparación y sin confirmar.

• En el árbol de directorios cada ruta se muestra una sola vez, aunque el archivo haya pasado por varios confirmaciones o exista en varios estados de Git a la vez; el número de líneas añadidas y eliminadas del archivo refleja solo el Diff final, sin acumular confirmaciones intermedias.

• Los archivos eliminados no aparecen en el árbol de directorios ni en su resumen visible; el ámbito completo que incluye archivos eliminados puede obtenerse mediante MCP scopeTotals.

• El + / − de la parte superior de la barra lateral resume siempre los archivos que muestra actualmente el árbol de directorios, por lo que, al cambiar la búsqueda, el Glob, el tipo de archivo o las rutas excluidas, se vuelve a calcular inmediatamente.

• Puede compararse con cualquier rama de referencia local o remota.

• Admite filtrar por tipo de cambio, estado de Git, extensión y expresión Glob.

• Los cambios normales de la rama, los cambios filtrados por autor y una sola confirmación se abren con el editor de comparación izquierda-derecha nativo de VS Code.

• Al abrir un archivo, se muestra el Diff completo desde la rama columna hasta el espacio de trabajo actual; al elegir Single commit, se muestra el Diff desde la confirmación anterior hasta esa confirmación.

• El árbol de directorios y el editor Diff usan el mismo Merge base de Git, por lo que el cambios no relacionados agregados en la rama de referencia cuando se divide no se mezclan en el lado izquierdo del Diff.

• Al filtrar por autor del commit, el Diff sigue mostrando el archivo actual completo, pero solo resalta los cambios del autor que coincide.

• Aunque otros commits modifiquen el contexto cercano, sigan insertando bloques de inserción completa o de reemplazo mixto, o después se registrarn el archivo, el resaltado de autor distributorá en mayor medida posible. En bloques grandes de edición, se prefieren las líneas únicas de código, como las firmas de funciones, dentro de los que se alinean las llaves y líneas en común. Si un cambio del autor se ha desplazado o no se ha deslizado a una ubicación inalámbrica de forma segura, el título del Diff lo indica claramente, sin omitirlo en silencio.

• En el modo Author, la cantidad de líneas del archivo estándar la estadística final que ofrece el editor para el Diff author-before → working tree; no acumula los varios commits del autor ni añade cambios de otros autores.

• Si el archivo no existe en la rama de referencia, el Diff muestra todo el archivo actual, pero marca únicamente las líneas añadidas por el autor.

• Permite ejecutar Ir a la definición, declaración, tipo y edición desde la ventana Diff virtual de Git; el destino se abre en el archivo real del Workspace actual.

• Revisa y revisa una sola confirmación a la vez.

• Filtra los cambios de la rama por autor del commit. Utiliza Author contains para filtrar commits por nombre o correo.

• El filtro por autor recorre toda la alfombra de la planificación, y no se detiene silenciosamente en los 250 commits; un historial grande se lee en lotes acotados.

• Admite excluir archivos, directorios o Glob, como en los archivos src/generated, src/legacy.c y **/test/**, sin cambiar el Diff de referencia subyacente. La exclusión se edita en un editor compacto con barra de desplazamiento y cada elemento se puede modificar o quitar de forma independiente.

• Permite exportar todos los archivos visibles en ese momento, a un directorio destino. La exportación conserva la estructura de directorios del repositorio, añade .diff al nombre del archivo y del código, y contenido utiliza el Diff uniforme estándar de esos Hunk.

• Desde un servidor MCP STDIO local de solo lectura, se ofrecen las sesiones guardadas y sus datos Git filtrados en tiempo real. El MCP aplica las mismas reglas de skipp de archivos, Glob, extensión, ruta excluida y archivo eliminado que emplean el árbol de archivos y la exportación.

• El menú contextual de un archivo admite abrir el archivo, abrir el Diff, agregar a exclusiones, mostrar en el administrador de archivos del sistema, y copiar una ruta relativa, la ruta absoluta, el nombre del archivo o su URI. El menú contextual de una carpeta permite excluir el código completo, moverlo al Explorador o al administrador de archivos, buscarlo de desde su interior y copiar una ruta, el nombre de la carpeta o el URI.

• Compatible con Reviewer Cockpit: la extensión lee el archivo .diffly/findings.json, muestra resúmenes de revisión, puntos de problema y entrada omitidas, clasificaciones like Agree/Skip, y procesza las líneas problemáticas en los editores abiertos.

• Avisa cuando una rama de referencia que está por delante de la base actual, y se actualiza al cambiar el estado de Git o .diffly/findings.json.

• Admite Workspace de múltiples raíces y guarda el repositorio elegido dentro de la sesión.

• Permite crear varias sesiones con nombre. Cada sesión guarda Workspace folder, la rama de referencia, el rango Author/Commit, las opciones de búsqueda, los filtros de archivos y las exclusiones de la sesión.

Método de uso

1. Abre un repositorio Git en VS Code.

2. Desde la Activity Bar, abre Branch Diffoauth get_diff_summary de información resumida de Dif.

3. En la Workspace de múltiples raíces.

Necesita corregir:

2. En la barra lateral, ejecuta Branch Diff Explorer: Open Sidebar.

3. Selecciona la rama de referencia. takes no: origin/HEAD, main, master, en ese orden.

4. Opcional: configura Author contains o selecciona Single commit. El modo Author oculta, para no caer, los cambios sin confirmar, porque no tienen un Author. (esas no exceden 2)

5. En un Workspace multiroot, elige la Workspace folder. Usa las teclas see los botones de crear, renombrar y cambiar el nombre, borrar de junto a la lista desplegable Session, cambiar la configuración de Diff, de edición y demás.

6. Ejecuta Branch Diff Explorer: Open Settings para configurar la rama de referencia predeterminada, el número de líneas de la vista previa, el búfer de salida de Git o el límite de tiempo de comandos. También hay un acceso a esta configuración desde la pantalla de error.

7. Haz clic en Export filtered diffs (⇩), elige el directorio destino y confirma silenciosamente antes de sobrescribir las existentes del .diff.

8. Haz clic en MCP para copiar la configuración de Codex o Claude Code, o para importante ejecutar una autocrítica del MCP. El servidor MCP requiere Node.js 18 o superior; si node no está en el PATH, define MCP: Node Command.

Exponer los cambios a la IA mediante MCP

La extension en el archivo de ejecución del MCP integrado en directorio estable de almacenamiento de VS Code y sincroniza el resto de sus sesiones en un archivo de estado específico del Workspace actual. Cuando la IA llama a cualquier herramienta del servidor, el servidor MCP vuelve a calcular los cambios Git; una vezconfigurado no es necesario exportar previamente Diff ni dejar la ventana de VS Code abierta.

Codex: haz clic en MCP → Copy Codex MCP configuration, añade el TOML generado a ~/.codex/config.toml o al .codex/config.toml de un proyecto en el que confíes y reinicie el cliente Codex. Los clientes de Codex de escritorio, CLI y IDE admiten MCP STDIO local y comparten una misma configuración. Consulta Codex MCP 官方文档; consulta oficial es docs Codex MCP.

• 😊 Code: haz clic en MCP → Copy Claude Code MCP configuration, combina el archivo JSON generado en el .mcp.json del proyecto y vuelve a conectar el cliente. La configuración resultante solo incluye la ruta de ejecución local, la ruta del servidor integrado y la ruta del archivo de estado del Workspace.

Flujo de llamadas MCP recomendado

El cliente MCP puede elegir las herramientas automáticamente según las solicitudes de lenguaje natural. Para que la revisión sea constante y reducir el gasto de tokens, se sugiere que la IA las llame en este orden:

1. Llama a list_diff_sessions para localizar la sesión activa o una determinada.

2. Llama a get_diff_summary para saber el repositorio, la rama actual, la rama base, el rango Author/Commit, los filtros y el resumen de archivos visible.

3. Recorre list_diff_files con la paginación, hasta obtener la una lista real de archivos tal y como se muestra en el árbol.

4. Llama a get_filtered_diff para los archivos que quieras revisar.

5. Si el contexto del parche no parece suficiente, usa read_file_context para leer el contenido completo del fuente.

6. Llama a get_branch_diff solo cuando necesites comparar todos los cambios de la rama y todos los demás autores.

Notas sobre las herramientas MCP

Todas las herramientas son solo de lectura y aceptan sessionId opcional. Si no se indica, se usa la sesión activa en ONS de Branch Diff Explorer.

get_diff_summaryDevuelve dos tipos de total:

• scopeTotals: el resultado total de la gama Author/Commit en nombre de los filtros de archivo de la interfaz.

• visibleTotals: el resultado total accesible a través de list_diff_files, la exportación y el árbol, una vez aplicados todos los filtros y quién deleted los eliminados.

Cuando Author contains está activado, get_filtered_diff.text contiene solo el parche del autor que coincide. La additions y deletions de cada archivo coinciden con el campo del archivo visible final author-before → working tree, sin una vez acumulación de multicomando de un autor ni incluyen otros autores. get_branch_diff incluye intencionadamente los de otros, así que no lo uses como reemplazo para Author.

read_file_context.side acepta:

• current (opcional): el contenido current workspace.

• head: el contenido del archivo en HEAD.

• base: contenido delgit merge-base que se usa for esta comparación.

• author_before: el archivo actual con el cambio del autor deshecho (el lateral izquierdo de Author Diff VS Code). Solo funciona en sesiones con filtro Author.

Ejemplo de paginación

Las listas de archivos y confirmaciones devuelven nextCursor. Pásalo en la llamada siguiente hasta que el resultado ya no lo incluya:

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

Las herramientas de Diff y de fuente devuelven nextStartLine. El texto se pagina en 800 líneas por defecto y admite hasta 5 000 por llamada:

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

Los parámetros de archivo deben usar la exacta ruta relativa del repositorio devuelta por list_diff_files.

Sugerencias de revisión recomendadas

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

Búsqueda por contenido específico:

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

Revisar solo un directorio:

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

Solucione problemas de MCP

• Si el cliente no ve un servidor, reinicia el cliente de Codex o Claude y revisa la lista de servidores MCP; en Codex puedes usar /mcp.

• Si los resultados están caducados, llama a get_diff_summary con refresh: true.

• Si una ruta se rechaza, vuelve a obtenerla desde list_diff_files y pásala exactamente igual.

• Si una respuesta se interrumpe, continúa con nextCursor o nextStartLine; no la trates como if es el result adaptive.

• author_before requires Author filter enable.

• MCP no devuelve binarios, exclusión de seguir símbolos/publicación de enlace, ni archivos fuente mayores de 32 MB como contexto.

La extensión invoca en exclusiva tu propio git de local y no envía código por red, de metadatos de confirmación, de revisión ni búsquedas de la red. El servidor con MCP es STDIO local, por lo que no expone ningún puerto de escucha.

Desarrollo

npm install
npm run check
npm test
npm run build

Pulsa F5 en VS Code para lanzar el Host de desarrollo de la extensión. Compila el VSIX con npm run package.