Comparación de contenido
Compara dos versiones y consulta adiciones, eliminaciones y cambios por producto.
Compara los informes que cambiaron entre dos versiones. Acepta dos instantáneas de unidad totalmente reconstruidas y devuelve las diferencias semánticas en las celdas, párrafos, páginas o registros. Admite revisión de la historia, verificación de la salida del agente e inspección de un Worktree.
Objetos comparables
| Producto | Ejemplos |
|---|---|
| Sheet | Hojas, valores y fórmulas, filas, columnas, estilos y recursos registrados, como gráficos. |
| Doc | Párrafos, texto, estilos, tablas, bloques y dibujos. |
| Slide | Páginas, elementos, geometría, estilos, diseños y temas. |
| Relational Table | Tablas, campos, registros y vistas. |
| Canvases | Páginas, elementos y recursos asociados. |
Cada cambio es una adición, una eliminación, o una actualización. Estado UI temporal como el nivel de zoom y la selección no es un cambio de contenido. Lo que cubre las cubiertas de comparación depende del adaptador de producto, y PDF no está incluido.
Cómo intervienen Snapshot y changeset en la comparación
Un Snapshot almacena el estado de contenido completo en una revisión específica. Una mutación describe un único cambio de contenido, y una mutación de grupos de cambios en un commit ordenado. Historia almacena versiones y las reconstruye a la demanda. Compare describe las diferencias entre dos versiones que ya se han reconstruido.
Para comparar una entrada de historia o un Worktree, cargar la base Snapshot y aplicar los cambios posteriores en orden hasta que el contenido llegue a la revisión de destino. Realizar esta reconstrucción para cada lado, luego pasar ambos estados completos al adaptador de producto. Cuando los correspondientes cambios estén disponibles, Compare alinea cambios estructurales como filas y columnas insertadas o eliminadas con mayor precisión.
Los resultados siguen el modelo de contenido de cada producto: celdas y filas o columnas para hoja, párrafos para Doc, elementos para diapositivas y lienzos, y campos y registros para Tabla de Relación. Una selección temporal o nivel de zoom no es un cambio de contenido. Comparar es sólo lectura. Restaurar una versión y fusionar un Worktree son operaciones separadas.
Integración con Server SDK y AI SDK
Server SDK suministra las instantáneas, los cambios y los números de revisión, y reconstruye el contenido para comparar. Una aplicación pasa tanto los estados como la historia que tiene que comparar, recibe diferencias estructuradas, y presenta una interfaz de revisión en la web. Ver historia y extensions de servicios de colaboración.
AI SDK carga y edita contenido en un Worktree y compromete el resultado del Agente. Una aplicación puede utilizar las diferencias estructuradas para los controles del Agente y el procesamiento posterior, mientras que una persona revisa los mismos cambios visualmente y decide si se fusionan. Ver los Agente Worktree flujo de trabajo y operaciones de.
Ejemplos de comparación de cinco productos
Los cinco ejemplos utilizan el mismo plan de lanzamiento de Northstar. Creamos y presentamos una base de referencia completa, la editamos en un Worktree, y luego se abrió Compare para inspeccionar los cambios.
En la lista de cambios, azul marca modificaciones, adiciones verde y deleciones rojo. Los paneles de sólo lectura muestran el contenido antes y después del cambio. Haga clic en una imagen para ampliarla.
Sheet: presupuesto y estructura de filas
Actualizamos las previsiones de investigación y editor, removimos la herramienta Legacy, agregó Accesibilidad QA, y recalculamos los totales. Los valores modificados y los resultados de fórmula aparecen junto con la estructura de fila a la que pertenecen.
Doc: plan de lanzamiento y párrafos
Hemos cambiado la fecha de lanzamiento, el recuento de equipo piloto y el objetivo de finalización, eliminado el texto de aprobación del legado y añadido una puerta de calidad. El contexto preservado facilita el examen a nivel de párrafo.
Slide: métricas y elementos de página
Actualizamos tres tarjetas métricas, eliminamos el bloque de aprobación del legado, y agregamos una puerta de calidad. La comparación cubre texto y elementos en la misma página en lugar de tratar la página como una imagen nueva.
Relational Table: campos y registros de tareas
Actualizamos el progreso, el estado y las fechas, renombramos el campo de la fecha, eliminamos el historial de aprobación y agregamos una tarea de accesibilidad. Las diferencias pueden ser inspeccionadas por tabla, campo y registro.
Canvases: flujo y elementos del lienzo
Actualizamos el tamaño del piloto y la fecha de lanzamiento, movimos el nodo de revisión, y reemplazó la tarjeta de aprobación heredada con una puerta de calidad.
Consultar resultados
Registrar los plugins de comparación de historia y las extensiones de Facade del producto, a continuación, llame a compareUnitData(). Para el filtrado repetido y la paginación, cree una sesión con prepareUnitComparison() y llame al query() .
Mostrar un resumen primero, luego taladrar en hojas de trabajo, páginas, o tablas. Solicitar listas de cambios o completos antes/después de los valores según sea necesario. Los resultados de detalles predeterminados están ligados, por lo que la primera página no es necesariamente el problema completo. Consulte el estado de diagnóstico y cobertura antes de presentar los resultados.
¿Cómo es esta guía?