Files
openchamber/packages/docs/content/docs/fr/walkthrough.mdx
T

72 lines
5.6 KiB
Plaintext
Raw Normal View History

---
title: Parcours des modifications
description: Lisez un diff dans lordre qui a du sens, pas dans lordre alphabétique.
---
# Parcours des modifications
Un diff est trié par chemin de fichier, ce qui nest presque jamais lordre dans lequel la modification prend son sens. Le parcours le réorganise : les changements liés sont regroupés en **étapes**, chaque étape explique ce que le code fait désormais différemment, et les étapes senchaînent pour que chacune sappuie sur la précédente.
Il explique et ordonne. Il ne juge pas votre code et ne rend aucun verdict — cest le rôle de [Review](/git/).
Ouvrez-le par licône **Parcours** dans la barre de droite, ou par le bouton **Parcours IA** dans les panneaux des modifications et de la pull request. Les deux se contentent douvrir le panneau ; rien nest généré tant que vous nappuyez pas sur **Générer le parcours**.
## Ce quil peut parcourir
| Portée | Ce quelle couvre |
| --- | --- |
| Tout non validé | Tout ce qui nest pas encore dans un commit : indexé, non indexé et nouveaux fichiers |
| Indexées | Uniquement ce qui partirait dans un commit maintenant |
| Non indexées | Copie de travail et nouveaux fichiers |
| Cette branche | Tous les commits de la branche absents de sa base |
| Pull request | La modification telle quelle existe sur GitHub |
**Cette branche** ne veut pas dire « commits non poussés » : cest tout ce que la branche ajoute à sa base, poussé ou non. Après un commit mais avant un push, elle et la pull request diffèrent donc volontairement : lune montre ce que vous avez fait, lautre ce que voient les relecteurs.
Chaque portée est stockée séparément : passer de lune à lautre ne perd jamais rien.
## Choisir le modèle
Les parcours utilisent votre petit modèle par défaut. Choisissez-en un autre dans **Paramètres → Sessions → Modèle du parcours des modifications**, ou pour une seule relecture depuis len-tête du panneau — utile quand une modification est assez risquée pour mériter un modèle plus solide.
Le sélecteur ne propose que des modèles capables de sortie structurée, sans laquelle le parcours ne peut pas être assemblé. Si un modèle est trop petit pour le diff, la génération est refusée avec une explication plutôt que de tronquer lentrée en silence : un parcours écrit sur la moitié dun diff sonne assuré et se trompe.
En rouvrant le panneau, vous voyez le modèle qui a produit ce que vous avez sous les yeux ; **Régénérer** reprend donc le même tant que vous nen changez pas.
## Choisir la langue
Les parcours sont rédigés dans la langue de votre interface par défaut. Le sélecteur de langue dans len-tête du panneau démarre là, et vous pouvez choisir nimporte quelle autre langue dans laquelle OpenChamber est traduit pour une seule relecture : une explication guidée ne sert que dans une langue que vous lisez à laise.
Seule la prose est traduite. Les identifiants, les chemins de fichiers et les noms dAPI restent exactement tels quils apparaissent dans votre code, si bien que ce quune étape nomme reste ce que vous pouvez rechercher.
Si rien na encore été généré dans la langue choisie, le panneau ne se vide pas : il continue dafficher le parcours quil a et le signale. Appuyez sur **Générer le parcours** pour lobtenir dans la nouvelle langue.
## Coût et cache
Rien ne se génère tout seul. La génération ne démarre que sur votre demande, et la régénération est manuelle elle aussi.
Les résultats sont mis en cache daprès le contenu exact du diff. Ramenez la copie de travail à un état antérieur et le parcours dalors revient gratuitement, sans appel au modèle. La langue et le modèle font partie de cette clé, donc chaque combinaison est conservée séparément : dès quun diff a un parcours en deux langues, passer de lune à lautre est instantané et gratuit.
La génération tourne sur le serveur OpenChamber, pas dans votre onglet. Rechargez la page ou fermez le panneau : le travail continue et le résultat vous attend. Seul **Annuler** linterrompt.
## Rester honnête sur lobsolescence
Chaque étape est ancrée au contenu exact du code quelle décrit, ce qui permet au panneau de signaler quand ce code a bougé :
- **Étapes obsolètes** — le code décrit par une étape a changé ou disparu. Le parcours reste affiché, marqué, pour que vous décidiez sil faut régénérer.
- **Non traité** — des modifications du diff actuel quaucune étape ne décrit. On y trouve les changements faits après la génération, ceux que le parcours a jugés courants, ainsi que les fichiers de verrouillage et autres sorties générées, délibérément tenus hors du modèle. Tout est listé à la fin pour que rien ne disparaisse en silence.
Régénérer ne rapièce pas, cela réécrit : le parcours précédent est fourni au modèle comme contexte, ce qui reste vrai est conservé, et tout est réancré sur le code actuel.
## Notes
- Vous pouvez commenter nimporte quelle ligne comme dans la vue diff ; les commentaires se rattachent au champ du chat.
- Disponible sur ordinateur et sur les largeurs de tablette. Non proposé dans lextension VS Code ni dans lapplication mobile.
- Parcourir une pull request exige un compte GitHub connecté — voir [Issues et PR GitHub](/github/).
## Voir aussi
- [Git et GitHub](/git/) — le panneau des modifications quil lit, et laction Review qui, elle, juge le code
- [Issues et PR GitHub](/github/) — connectez GitHub pour parcourir les pull requests
- [Fournisseurs, modèles et agents](/providers/) — doù vient le petit modèle