Aller au contenu

Votre première session dans VS Code

De l'archive reçue à une première réponse sur votre propre code, par la passerelle de votre organisation.

À la fin de ce tutoriel, l’extension Lemniscate est installée dans votre VS Code, raccordée à la passerelle de votre organisation, et vous avez obtenu une réponse portant sur du code à vous.

Ce tutoriel est l’étape du poste dans le parcours Installer l’assistant de code complet. Il suppose que les services de la passerelle répondent déjà. Le poste ne porte que l’extension, et elle ne connaît que l’adresse de la passerelle : le moteur d’inférence n’est joint que par la passerelle (livre blanc sécurité V3, section 3.1).

Lemniscate n’est publié sur aucune place de marché et sur aucun registre de paquets. Vous l’installez depuis l’archive signée que vous a remise l’éditeur.

Vous avez reçu de votre interlocuteur une archive et le fichier d’empreintes qui l’accompagne. Le nom exact de ces deux fichiers vous est indiqué à la livraison ; les commandes ci-dessous les désignent par ARCHIVE et EMPREINTES, à remplacer par ce que vous avez reçu.

Placez-vous dans le répertoire où vous les avez déposés, puis :

Fenêtre de terminal
sha256sum -c EMPREINTES

Résultat attendu : une ligne par fichier vérifié, chacune terminée par Réussi (OK en anglais). Si une ligne indique ÉCHEC, arrêtez-vous ici : l’archive est incomplète ou altérée. Demandez-en une autre à votre interlocuteur avant d’aller plus loin.

2. Extraire l’archive et localiser l’extension

Section intitulée « 2. Extraire l’archive et localiser l’extension »
Fenêtre de terminal
mkdir -p ~/lemniscate
tar -xzf ARCHIVE -C ~/lemniscate
find ~/lemniscate -name 'lemniscate-*.vsix'

Résultat attendu : la dernière commande affiche un seul chemin, celui du paquet de l’extension VS Code. L’archive contient aussi le greffon JetBrains et le terminal ; ce tutoriel ne s’en sert pas.

Fenêtre de terminal
VSIX=$(find ~/lemniscate -name 'lemniscate-*.vsix' | head -n 1)
code --install-extension "$VSIX"

Résultat attendu : le terminal affiche Extension 'lemniscate-<version>.vsix' was successfully installed. Rouvrez VS Code : une icône Lemniscate apparaît dans la barre d’activité, sur le côté.

VS Code met à jour les extensions de lui-même. Cette extension vient d’un fichier et non d’une place de marché : ce mécanisme, laissé actif, peut remplacer la version posée. Coupez-le.

Ouvrez la palette de commandes, lancez Preferences: Open User Settings (JSON), et ajoutez cette entrée :

{
"extensions.autoUpdate": false
}

Résultat attendu : l’entrée figure dans votre settings.json et VS Code l’accepte sans la souligner. La version installée reste en place jusqu’à ce que vous installiez vous-même l’archive suivante.

Ouvrez le panneau Lemniscate : l’icône dans la barre d’activité de VS Code. Comme aucun modèle n’est encore déclaré, le panneau affiche l’écran d’accueil, ouvert sur l’onglet Gateway.

Saisissez dans Gateway address l’adresse qui vous a été remise, telle quelle, et dans Account key la clé de votre compte. Cliquez sur Test.

Résultat attendu : une ligne indique le nombre de modèles trouvés et leurs noms. Ce sont les modèles que la passerelle sert. Si la passerelle ne répond pas ou refuse la clé, la ligne dit quoi corriger : l’essai n’écrit rien, vous pouvez le relancer après chaque correction.

Validez avec Use.

Résultat attendu : sous la zone de saisie, le sélecteur de modèle propose les modèles que la passerelle sert.

Ouvrez un de vos projets dans VS Code, puis un fichier que vous connaissez bien. Sélectionnez-y une trentaine de lignes, une fonction entière plutôt qu’un fragment. Appuyez sur Ctrl+L (Cmd+L sur macOS), écrivez votre question dans la zone de saisie, et validez :

Que fait ce code, et quels cas d'entrée ne sont pas traités ?

Résultat attendu : le code sélectionné apparaît en bloc de contexte au-dessus de votre question, et la réponse nomme vos propres fonctions, variables et fichiers. Le modèle a lu votre code, et non produit une généralité.

Une extension installée depuis un fichier que vous avez vérifié vous-même, des échanges avec le modèle qui passent tous par la passerelle de votre organisation, et une conversation dont le contexte est le code que vous avez sélectionné.

Lemniscate ne construit aucun index du code source. Le dépôt est exploré à la demande, et il n’existe aucune copie dérivée et persistante de votre code (livre blanc sécurité V3, sections 3.2 et 11.3).

L’écran d’accueil de VS Code propose aussi un parcours guidé en quatre étapes, Get started with Lemniscate, livré avec l’extension et utilisable sans Internet : il reprend ce que vous venez de faire et enchaîne sur la complétion, la modification de code et la conversation. Ses étapes se cochent quand vous les avez accomplies.