Comparaison de contenu

Compare reçoit deux snapshots Unit entièrement reconstruits et renvoie des différences sémantiques par cellule, paragraphe, page ou enregistrement. Il sert à relire l’historique, les résultats d’agents et les Worktrees.

Objets comparés

Les différences sont des ajouts, suppressions ou modifications. Le zoom et la sélection sont exclus. La couverture dépend de l’adaptateur ; PDF n’est pas inclus.

Le rôle de Snapshot et des changesets dans la comparaison

Un Snapshot conserve l’état complet du contenu à une révision donnée. Une mutation décrit un changement précis ; un changeset regroupe les mutations dans une soumission ordonnée. L’historique conserve et reconstruit les versions ; Compare explique les différences entre deux versions reconstruites.

Pour comparer un historique ou un Worktree, on charge un Snapshot de base et on applique les changesets suivants dans l’ordre pour reconstruire chaque révision cible. Les états complets sont transmis à l’adaptateur du produit. Les changesets disponibles peuvent aussi améliorer l’alignement des changements structurels, comme l’insertion ou la suppression de lignes et de colonnes. Deux états complets permettent également une comparaison par snapshots.

Les résultats suivent le modèle de chaque produit : cellules et lignes ou colonnes de Sheet, paragraphes de Doc, éléments de Slide et Canvases, champs et enregistrements de Relational Table. La sélection temporaire et le zoom ne sont pas des modifications du contenu. Compare est en lecture seule ; restaurer une version et fusionner un Worktree sont des opérations distinctes.

Associer Server SDK et AI SDK

Server SDK fournit les Snapshots, changesets et numéros de révision, puis reconstruit le contenu à comparer. L’application transmet les deux états et l’historique disponible à Compare, obtient des différences structurées et les affiche dans une interface web de revue. Voir l’historique et les extensions du service de collaboration.

AI SDK charge et modifie le contenu dans un Worktree et soumet le résultat de l’Agent. Les applications peuvent utiliser les différences structurées pour les vérifications de l’Agent et les traitements suivants ; les personnes examinent visuellement les mêmes changements avant de décider de la fusion. Voir le parcours Worktree de l’Agent et les opérations sur le contenu.

Exemples de comparaison pour cinq produits

Ces exemples partagent un plan de lancement Northstar : création et soumission d’une version de référence complète, modifications dans un Worktree, puis ouverture de Compare pour examiner les différences.

Dans la liste des différences, le bleu indique les modifications, le vert les ajouts et le rouge les suppressions. Les panneaux en lecture seule montrent le contenu avant et après. Cliquez sur une image pour l’agrandir.

Sheet : budget et structure des lignes

Modifier les prévisions de recherche et de l’éditeur, supprimer Legacy tooling, ajouter Accessibility QA et recalculer les totaux. Examiner les valeurs et résultats de formules avec les lignes correspondantes.

Doc : plan de lancement et paragraphes

Modifier la date, le nombre d’équipes pilotes et l’objectif de réalisation. Supprimer l’ancienne approbation et ajouter un contrôle qualité, en conservant le contexte des paragraphes.

Slide : indicateurs et éléments de page

Modifier trois cartes d’indicateurs, supprimer le bloc d’approbation et ajouter un contrôle qualité. Comparer le texte et les éléments d’une même page.

Relational Table : champs et enregistrements de tâches

Modifier l’avancement, les statuts et les dates ; renommer le champ de date ; supprimer l’ancienne approbation et ajouter une tâche d’accessibilité. Examiner par table, champ et enregistrement.

Canvases : parcours et éléments du canevas

Modifier le nombre d’équipes pilotes et la date, déplacer le nœud de revue et remplacer la carte d’approbation par un contrôle qualité. Examiner le contenu et la disposition dans leur contexte.

Interroger les résultats

Enregistrez les plugins de comparaison et extensions Facade du produit, puis appelez compareUnitData(). Pour filtrer et paginer plusieurs fois, utilisez prepareUnitComparison() et query().

Présentez un résumé puis les détails par feuille, page ou table. Demandez les changements ou les valeurs complètes selon le besoin. Le détail est limité par défaut : la première page ne constitue pas nécessairement tout le résultat. Vérifiez les diagnostics et la couverture.

Consultez l’API, l’historique et Worktree.

Retour à toutes les fonctionnalités