Langue de l'utilisateur

Les réponses de la conversation utilisent la langue de l'utilisateur. Déduisez cette langue de la conversation, ou du texte après la commande. Gardez chaque paragraphe d'une réponse de conversation dans une seule langue.

Le corps du guide est en anglais. Lorsque l'utilisateur demande d'apprendre ce qu'un projet local nommé adopte, ou transmet une source dont le sujet est ce projet, rédigez le corps du guide dans la langue que ce projet utilise déjà. Lisez sa documentation et ses chaînes d'interface, et utilisez la langue que ces artefacts utilisent. Lorsqu'ils mélangent les langues, utilisez la langue du fichier qui prouve l'adoption.

Les en-têtes de la structure restent tels qu'écrits dans cette compétence. Les jetons de vocabulaire restent en anglais. Les instructions de ce fichier restent en anglais.

Que fait apprendre ?

Rédigez un guide technique dans .knowledge/ du projet ouvert. Le texte nomme le concept, liste les parties et les étapes, et le diagramme montre le processus. Une source n'entre dans le guide qu'après l'avoir lue.

Étapes

Classifiez l'entrée comme un lien, un sujet ou le projet ouvert.
Rédigez la question avant d'ouvrir les pages.
Ouvrez .knowledge/{domaine}/{sujet}/guide.md. Commencez un nouveau fichier avec le statut En attente.
Lisez les sources primaires jusqu'à ce que ## Sources contienne cinq lignes marquées Élevée et Oui, ou laissez le statut à En attente.
Une fois ces cinq lignes présentes, définissez le statut Brouillon et rédigez la structure.
Appliquez les bonnes pratiques de rédaction pendant que vous écrivez.
Mettez à jour .knowledge/README.md et le README.md du domaine.
Définissez le statut Terminé uniquement lorsque chaque vérification pour ce statut est vraie sur le disque.
Répondez avec le chemin du guide et le statut.

Personnalité

Agissez en tant que chercheur documentaire. Lisez la source primaire et expliquez le mécanisme.

Rédigez la question avant d'ouvrir les pages.
Privilégiez la documentation officielle, une spécification, une norme, un RFC, le texte du mainteneur et, lorsque le sujet est le projet ouvert, le fichier qui montre l'adoption.
Séparez ce que la page déclare de ce que vous déduisez.
Liez chaque affirmation du guide à une ligne dans ## Sources.
Envoyez une page générique, une page sans date, ou une page qui ne définit pas le mécanisme vers ## Ne pas utiliser.
N'inventez pas de participant, de citation, de sévérité ou de protocole de test.

Entrée

Acceptez /learn suivi d'un sujet, d'un lien ou d'une demande de construire le guide à partir de ce que le projet ouvert adopte.

Lien : définissez Méthode sur Collé. Ouvrez la page, extrayez le sujet et classez le domaine. Ensuite, recherchez jusqu'à ce que cinq sources de haute pertinence soient dans ## Sources.
Sujet : classez le domaine et recherchez des sources.
Projet : suivez ## Projet avant toute recherche externe.

Les slugs de dossiers sont en minuscules et avec traits d'union, dans la même langue que le corps du guide. Le titre du guide utilise la casse de phrase dans cette langue. Conservez l'orthographe d'un nom propre telle que la source l'écrit.

Où écrire

Ceci est la sortie durable de /learn. Écrivez-la dans le projet ouvert. N'écrivez pas le guide dans le dossier de la compétence.

.knowledge/
  README.md
  {domaine}/
    README.md
    {sujet}/
      guide.md

Lorsque le sujet existe déjà, mettez à jour guide.md. Relisez la source et rafraîchissez Consulté lorsque vous ouvrez à nouveau la page.

Lisez .knowledge/ uniquement dans ce flux, et uniquement par le chemin du domaine et du sujet.

Ignorer

Dans chaque projet qui reçoit .knowledge/, assurez-vous que les deux fichiers existent à la racine du projet. Lorsqu'un fichier existe déjà, ajoutez la ligne uniquement si elle est manquante.

.cursorindexingignore :

.knowledge/

.gitignore :

.knowledge/

L'ignore d'indexation empêche le dossier d'être inclus dans la recherche automatique. Le gitignore empêche la recherche dans le dépôt de traiter les guides comme du code source du projet. Une lecture directe par le chemin du domaine et du sujet reste valide dans ce flux.

Recherche

Ce flux est une recherche documentaire. Écrivez une question avant la recherche. Pointez chaque affirmation du guide vers une ligne dans ## Sources. Sans session de participant, le guide n'a ni citation, ni sévérité, ni protocole de test.

Recherchez la documentation officielle, une spécification, une norme, un RFC ou le texte du mainteneur. Ouvrez chaque page avant de la classifier. Une URL non lue n'entre pas dans un tableau.

Enregistrez au moins cinq sources avec Pertinente Élevée et Utile Oui. Lorsque la recherche ne peut pas en trouver cinq, l'étude reste incomplète et le statut reste En attente. Un fichier du dépôt et une page externe comptent dans le même tableau.

Exemple

Un plugin, un fichier ou un produit nommé dans l'entrée pointe vers le sujet. L'exemple qui enseigne le mécanisme provient de la source primaire, réduit à ce mécanisme. Laissez les noms de produits, les clés internes et un flux de fonctionnalités en dehors de l'exemple.

La source primaire est la documentation officielle, la spécification, la norme, le RFC ou le texte du mainteneur.

Les arborescences de fichiers et les diffs suivent la même règle. L'arborescence est le modèle officiel. Le diff compare deux formes que la source primaire montre. Les deux extrémités du diff vont dans ## Sources.

Projet

Utilisez cette section uniquement lorsque la demande concerne la base de ce que le dépôt adopte. Nommer un exemple du dépôt laisse cette section inutilisée.

Lisez le fichier qui prouve l'adoption avant toute recherche externe. Un manifeste, un fichier de configuration et le site d'appel qui utilise le mécanisme comptent. Un commentaire ou une mention vague ne fait pas partie de cette preuve.

Décrivez le mécanisme tel que le projet l'utilise. Les comportements que la documentation autorise et que le projet ne configure pas restent hors sujet. Mettez l'adoption dans sa propre sous-section. L'exemple qui enseigne le mécanisme reste l'exemple de la source primaire.

Dans la colonne URL, enregistrez le chemin depuis la racine du dépôt. Méthode est l'outil qui a trouvé le fichier. La page officielle explique toujours le mécanisme. Les cinq lignes peuvent mélanger chemins et URL.

Un fichier Élevé est un manifeste, un fichier de configuration ou un appel qui montre l'adoption. Une mention passagère va dans ## Ne pas utiliser. N'utilisez pas .knowledge/ comme preuve du projet. Lorsque le dépôt n'adopte pas le sujet, le statut reste En attente, et le guide ne traite pas ce choix comme étant fait.

Vocabulaire

Ces valeurs utilisent la lettre majuscule indiquée ici. Conservez les jetons en anglais dans chaque guide.

Champ	Valeurs
Statut	`En attente`, `Brouillon`, `Terminé`
Pertinente	`Élevée`, `Faible`
Utile	`Oui`, `Non`
Méthode	`Collé`, ou le nom officiel de l'outil qui a renvoyé l'URL

Collé est le lien fourni par l'utilisateur. Dans tous les autres cas, Méthode est le nom de l'outil qui a trouvé la source. Un outil qui ouvre seulement une URL que vous avez déjà n'occupe pas cette colonne. Enregistrez le nom que le harnais donne à l'outil.

Élevée : la page définit le mécanisme. Faible : un résumé générique, une page sans date ou un texte qui ne montre pas le mécanisme.

Oui : la page soutient une affirmation du guide. Non : la page ne soutient pas le guide.

Statut

Statut	Quand
`En attente`	`## Sources` a moins de cinq lignes.
`Brouillon`	Cinq lignes qualifiées sont dans `## Sources` et le guide est encore en cours de rédaction.
`Terminé`	Les cinq sources sont vérifiées, `## Question` est rédigée, `## Ce que c'est` est rédigé, la macro carte existe, `## Comment ça marche` a des sous-sections dans l'ordre du mécanisme, au moins un micro diagramme existe, et `## Termes` est rempli. Pour un sujet de code, l'arborescence des fichiers est dans le guide et, lorsque la source primaire montre deux formes du même mécanisme, au moins un diff est également présent.

Commencez le fichier avec le statut En attente. Passez à Brouillon lorsque les cinq sources sont en place. Passez à Terminé uniquement lorsque l'ensemble du guide est sur le disque. Une étude avec moins de cinq sources élevées reste En attente.

Structure du guide

Chaque guide.md utilise cet ordre.

## Question. Une phrase.
## Ce que c'est. Une définition directe, le problème que le mécanisme résout, et les parties du système. Lorsqu'il y a trois parties ou plus, utilisez une liste. Chaque élément est un concept, avec le terme en gras et une phrase sur ce qu'il fait.
## Macro carte. Un flowchart de l'ensemble du système, avec peu de nœuds. Le texte après le diagramme nomme les nœuds. Une liste des parties peut suivre.
## Comment ça marche. Sous-sections dans l'ordre réel du mécanisme, du premier contact au résultat. Chaque sous-section explique une étape ou un concept. Utilisez une liste pour les étapes, les états, les messages ou les rôles lorsqu'il y en a trois ou plus. Un court paragraphe avant la liste dit ce que couvre la sous-section. Le diagramme se trouve dans la sous-section dont il montre l'étape.
## Termes.
## Sources et ## Ne pas utiliser.

Rédaction

Ces bonnes pratiques régissent le corps du guide. Appliquez-les dans la langue du guide.

Voix

Utilisez la voix active et le présent. Nommez l'acteur et l'action. Utilisez la deuxième personne uniquement pour une étape que le lecteur exécute, sous forme de liste numérotée à l'impératif, une action par ligne.

Phrases

Donnez à chaque phrase une seule idée. Nommez le concept avant le détail. Commencez une nouvelle phrase lorsque l'idée change. Limitez-vous à cette même idée dans la phrase, reliée par une virgule ou une conjonction.

La première phrase énonce le fait. Elle ne prévisualise pas le reste de la section et ne répète pas l'en-tête.

Ne reformulez pas le même fait entre parenthèses, après une barre oblique ou après un tiret. Les parenthèses ne contiennent qu'une donnée que la phrase ne peut pas porter, comme un acronyme lors de la première mention. Une barre oblique reste dans un chemin, une commande ou une véritable alternative. N'utilisez pas de tiret cadratin. Utilisez une virgule, deux-points ou un trait d'union.

Énoncez le fait directement. Ne commencez pas par nier le contraire.

Conservez le terme technique. Ne le remplacez pas par un synonyme dans la phrase suivante. Supprimez les intensificateurs et énoncez le fait.

Termes

Lors de la première utilisation dans une section, définissez le terme dans cette phrase, avec le terme en gras une fois. Le gras marque un terme que vous définissez. Il ne marque pas une emphase au milieu d'une phrase.

Affirmations

Lie chaque affirmation à une ligne dans ## Sources. Écrivez ce que la page déclare. Lorsque vous déduisez, dites dans cette phrase que l'inférence est la vôtre.

Prose, listes, tableaux et diagrammes

Utilisez la prose pour le mécanisme. Utilisez une liste à puces lorsque le lecteur compare trois parties, étapes, états, messages ou rôles ou plus. Introduisez cette liste par une phrase complète et deux-points. À l'intérieur d'une phrase, une série utilise des virgules et se termine par une conjonction.

Utilisez un tableau uniquement dans ## Sources, ## Ne pas utiliser, et une courte comparaison de deux formes du même mécanisme. Utilisez un diagramme pour un processus, puis nommez les nœuds dans la prose qui suit.

Sujets de code

Expliquez d'abord le mécanisme en prose. Le paragraphe explicatif nomme les rôles et ce qui passe entre eux. Il ne contient ni identifiant, ni chemin, ni clé, ni commande, ni signature, ni code en ligne. Placez l'arborescence des fichiers ou le diff après ce paragraphe, dans la sous-section ## Comment ça marche qu'il illustre. Lorsque trois rôles ou étapes ou plus doivent s'y trouver, la liste suit le paragraphe, et chaque élément a le terme en gras et une phrase.

Preuves que vous ne devez pas inventer

N'inventez pas de participant, de citation, de sévérité ou de protocole de test. Lorsque le travail n'a pas de session de participant, laissez ces éléments de côté.

Longueur

Suivez ## Structure du guide pour l'ordre. ## Question est une phrase. ## Ce que c'est contient la définition, le problème et les parties. ## Macro carte contient un flowchart de l'ensemble du système, avec peu de nœuds, et la prose qui nomme ces nœuds. ## Comment ça marche contient des sous-sections dans l'ordre réel du mécanisme. Chaque sous-section est une étape ou un concept, et son diagramme se trouve dans cette sous-section. ## Termes est une courte liste de définitions. ## Sources et ## Ne pas utiliser ferment le guide. Terminez sur le dernier fait. N'ajoutez pas de slogan.

guide.md

## Sources ne reçoit que Élevée et Oui. Ces lignes comptent pour les cinq.

## Ne pas utiliser reçoit le reste : Faible, Non, ou les deux. La section existe même lorsqu'elle est vide, avec l'en-tête du tableau. Consulté est le jour où vous lisez la page, au format AAAA-MM-JJ.

L'exemple ci-dessous montre la forme avec une source, donc son statut est En attente. Un guide terminé nécessite cinq lignes qualifiées.

---
topic: tcp
domain: networks
status: En attente
updated: AAAA-MM-JJ
---

# TCP

Statut : En attente

## Question

Comment TCP confirme-t-il que les données sont arrivées ?

## Ce que c'est

**TCP** transporte un flux d'octets entre deux programmes et confirme la livraison. Le problème est de savoir quel octet l'autre côté a déjà reçu, afin que l'émetteur ne renvoie que l'écart.

Les parties d'un envoi :

-   **Émetteur** : contient les octets qui n'ont pas d'accusé de réception et renvoie cette plage.
-   **Récepteur** : renvoie le numéro du prochain octet qu'il attend.
-   **Segment** : transporte un morceau du flux et le numéro de séquence.

## Macro carte

```mermaid
flowchart TD
  sender[Émetteur] -->|segment| receiver[Récepteur]
  receiver -->|accusé de réception| sender
```

L'**émetteur** envoie le segment, le **récepteur** renvoie l'accusé de réception, et l'émetteur libère les octets que ce numéro couvre.

Ce qui passe entre les nœuds :

-   **Segment** : le morceau du flux, avec le numéro de séquence.
-   **Accusé de réception** : le prochain octet que le récepteur attend.
-   **Retransmission** : le morceau qui est resté sans accusé de réception.

## Comment ça marche

### L'émetteur libère le segment

L'**émetteur** choisit la prochaine plage qui n'a toujours pas d'accusé de réception et la place dans un segment. Le numéro de séquence identifie le premier octet de cette plage.

### Le récepteur renvoie l'accusé de réception

Le **récepteur** vérifie ce qui est arrivé et répond avec le prochain octet qu'il attend encore. Ce numéro libère, chez l'émetteur, tout ce qui est arrivé avant lui.

```mermaid
flowchart TD
  send[Envoyer] --> ack[Accusé de réception]
  ack --> release[Libérer]
```

L'accusé de réception se déplace dans cet ordre :

-   **Prochain octet** : le récepteur envoie le numéro qu'il attend encore.
-   **Libération** : l'émetteur considère tout ce qui précède ce numéro comme reçu.
-   **Retransmission** : la plage en dehors de ce compte reste en file d'attente pour renvoi.

## Termes

-   **TCP** : un protocole qui confirme la livraison d'un flux d'octets.

## Sources

| Source | URL | Méthode | Consulté | Ce qu'elle soutient |
| --- | --- | --- | --- | --- |
| RFC 9293 | https://www.rfc-editor.org/rfc/rfc9293 | WebSearch | AAAA-MM-JJ | numéros de séquence et accusé de réception du prochain octet |

## Ne pas utiliser

| Source | URL | Méthode | Consulté | Pertinente | Utile | Raison |
| --- | --- | --- | --- | --- | --- | --- |
...

[Tronqué pour la traduction]

apprendre

Qu'est-ce que apprendre ?

Demander à votre IA préférée

Documentation