Qu'est-ce que la portée de diff ?

La portée de diff contrôle la quantité de contexte que l'IA considère lors de l'analyse de vos modifications. Par défaut, AI Diff Review se concentre sur les lignes que vous avez réellement modifiées, mais vous pouvez étendre cette portée pour inclure les lignes proches ou même le fichier entier. Ce paramètre affecte à la fois la qualité de l'analyse et la notation de la porte de commit.

Modes de portée

Mode STRICT

En mode STRICT, l'IA ne considère que les résultats qui sont directement sur les lignes modifiées. C'est l'approche la plus focalisée et garantit que la notation de la porte de commit ne reflète que les problèmes que vous avez réellement introduits.

Idéal pour :

  • Notation précise de la porte de commit
  • Se concentrer uniquement sur les nouveaux problèmes
  • Petits commits ciblés
  • Lorsque vous voulez ignorer les problèmes préexistants

Considérations :

  • Peut manquer des problèmes liés à vos modifications mais pas directement sur les lignes modifiées
  • Moins de contexte pour l'IA pour comprendre vos modifications
  • Peut produire moins de résultats globalement

Mode NEARBY

Le mode NEARBY inclut une fenêtre configurable de lignes autour de vos modifications (par défaut : ±N lignes). Cela fournit plus de contexte tout en se concentrant toujours sur la zone que vous avez modifiée.

Idéal pour :

  • Analyse équilibrée avec contexte
  • Comprendre l'impact des modifications sur le code environnant
  • La plupart des cas d'utilisation généralistes
  • Lorsque vous voulez un certain contexte sans analyser les fichiers entiers

Considérations :

  • La taille de la fenêtre affecte la portée de l'analyse—les fenêtres plus grandes incluent plus de contexte
  • Peut signaler des problèmes dans le code proche que vous n'avez pas modifié
  • La notation de la porte de commit inclut les résultats proches

Mode RELAXED

Le mode RELAXED considère le fichier entier lors de l'analyse des modifications. Cela fournit un contexte maximum et aide l'IA à comprendre l'impact complet de vos modifications.

Idéal pour :

  • Analyse complète
  • Comprendre comment les modifications affectent le fichier entier
  • Efforts de refactorisation
  • Lorsque vous voulez un insight IA maximum

Considérations :

  • Peut signaler de nombreux problèmes préexistants
  • La notation de la porte de commit inclut tous les résultats du fichier
  • Une portée d'analyse plus large signifie plus de temps de traitement
  • Peut être accablant pour les grands fichiers

Configurer la portée

Pour configurer la portée de diff :

  1. Allez dans Paramètres → Outils → AI Diff Review
  2. Naviguez vers la section Contrôles de portée de diff
  3. Sélectionnez votre mode préféré (STRICT, NEARBY ou RELAXED)
  4. Si vous utilisez NEARBY, définissez la taille de la fenêtre (nombre de lignes à inclure de chaque côté)

Impact sur la porte de commit

La portée de diff affecte directement la notation de la porte de commit :

  • STRICT : Seuls les résultats sur les lignes modifiées contribuent à la notation
  • NEARBY : Les résultats dans la fenêtre contribuent à la notation
  • RELAXED : Tous les résultats dans les fichiers modifiés contribuent à la notation

Par défaut, les éléments INFO globaux ou non ciblés sont ignorés pour la porte, indépendamment du mode de portée. Cela garantit que la porte se concentre sur les problèmes liés à vos modifications.

Choisir le bon mode

Pour les projets sensibles à la sécurité

Utilisez STRICT ou NEARBY avec une petite fenêtre. Cela garantit que la porte de commit ne bloque que sur la base des problèmes que vous avez réellement introduits, pas des problèmes préexistants.

Pour l'amélioration de la qualité du code

Utilisez le mode RELAXED pour obtenir des commentaires complets sur les fichiers entiers. Cela aide à identifier les domaines d'amélioration au-delà de vos modifications.

Pour les grandes équipes

Utilisez le mode STRICT pour garantir que les portes de commit sont équitables et ne bloquent que sur la base de nouveaux problèmes. Cela évite la frustration d'être bloqué par des problèmes de code préexistants.

Pour la refactorisation

Utilisez le mode RELAXED pour comprendre comment votre refactorisation affecte le fichier entier. Cela fournit un meilleur contexte pour prendre des décisions éclairées.

Meilleures pratiques

Commencer avec la valeur par défaut

Le mode RELAXED par défaut fonctionne bien pour la plupart des cas d'utilisation. Commencez là et ajustez selon vos besoins.

Correspondre à votre workflow

Choisissez un mode de portée qui correspond à la façon dont votre équipe travaille. Si vous préférez des commits ciblés, utilisez STRICT. Si vous faites des révisions complètes, utilisez RELAXED.

Considérer la taille du fichier

Pour les très grands fichiers, le mode RELAXED peut être accablant. Envisagez d'utiliser NEARBY avec une taille de fenêtre raisonnable à la place.

Réviser les résultats

Indépendamment du mode de portée, révisez les résultats attentivement. Même en mode RELAXED, concentrez-vous d'abord sur la résolution des problèmes liés à vos modifications.

Combiner avec d'autres paramètres

La portée de diff fonctionne avec d'autres paramètres :

  • Inclusion de contenu complet : Lorsqu'elle est activée, le mode RELAXED a plus de contexte avec lequel travailler
  • Limite de contexte lié : Limite la quantité de code lié inclus, fonctionnant aux côtés des contrôles de portée
  • Niveau de porte de commit : La portée affecte ce qui contribue à la notation de la porte

Conclusion

Les contrôles de portée de diff vous donnent un contrôle précis sur la façon dont AI Diff Review analyse votre code. En choisissant le bon mode pour vos besoins, vous pouvez équilibrer une analyse complète avec des commentaires ciblés.

Le mode STRICT assure la précision, NEARBY fournit un contexte équilibré, et RELAXED offre des insights complets. Expérimentez avec différents modes pour trouver ce qui fonctionne le mieux pour votre workflow.

N'oubliez pas que vous pouvez changer le mode de portée à tout moment dans les paramètres, alors ne vous sentez pas enfermé dans votre choix initial. Ajustez selon les besoins en fonction du type de travail que vous faites.

Prêt à configurer votre portée d'analyse ? Installez AI Diff Review et explorez les différents modes de portée disponibles.