Guide de la version préliminaire · 0.1.0
Récupérer en préservant l’issue initiale
Identifiez la connexion, les droits, les sources, l’analyseur ou le job affecté et utilisez sa récupération sans remplacer l’identité d’installation.
La référence de l’API est en anglais.
Conserver l’identité du travail
Partez de l’erreur visible et de la ressource citée. Conservez état d’installation, endpoint, profil d’éditeur et identifiants de projet, analyse, job ou commande. Un nouveau répertoire d’état crée une autre installation ; il ne récupère ni membres ni résultats de l’ancienne.
Une lecture échouée diffère d’un résultat vide. Findings, Settings et Jobs préservent les informations déjà chargées lorsqu’une actualisation ultérieure échoue. Cette vue aide à comprendre le contexte, mais une lecture récente réussie est nécessaire pour établir l’issue actuelle.

Choisissez la suite selon la cause indiquée. Une opération incomplète n’est pas un résultat réussi.
Ouvrir l’image complète| Symptôme | Première action |
|---|---|
| L’éditeur ne joint pas le service | Confirmer endpoint loopback et backend prévus, puis utiliser Reconnect to Local Service. |
| L’éditeur demande approbation ou indique des droits révoqués | Utiliser Connect / Review IDE Access et examiner la demande exacte dans le navigateur du propriétaire. |
| Le dépôt est visible mais non analysable | Examiner autorisation des sources et disponibilité dans Projects > Scan setup. |
| Données absentes, expirées ou invalides | Examiner Tools et le job de préparation ; utiliser la maintenance proposée. |
| Le travail reste en attente | Vérifier santé du worker et job existant avant une nouvelle commande. |
| Une sauvegarde ou soumission expire | Réconcilier la ressource ou le job initial avant répétition. |
| Un push est bloqué | Lire la sortie Git et la vérification sortante du clone exact. |
Rétablir la connexion prévue
Vérifiez que lomoCodeSecurity.apiBaseUrl désigne l’installation voulue. Sa valeur par défaut est http://127.0.0.1:8080 ; un autre port représente une autre origine. La changer exige une nouvelle connexion à cette destination. L’extension ne transmet pas les droits de l’ancienne origine à la nouvelle.
Utilisez le démarrage depuis les sources pris en charge avec le même état d’installation. Lorsque le service répond, Reconnect to Local Service réessaie la connexion existante du profil. Si son appartenance a été révoquée ou n’est plus active, utilisez Connect / Review IDE Access. Reconnect n’approuve aucun membre et n’accorde aucun accès aux sources.
Pour un navigateur propriétaire indisponible, suivez la récupération d’authentification. Gardez les valeurs à usage unique privées. Une session manquante ne justifie ni copie des fichiers d’authentification de l’éditeur ni recréation de tous les clients.
Le démarrage automatique Windows natif présente dans la préversion publique un problème documenté de délai lors de la vérification du stockage privé. Une actualisation manuelle réussie ne prouve pas sa correction. Consultez l’état de version figé avant de considérer un contournement comme une acceptation de plateforme.
Réparer uniquement le droit endommagé
La réparation locale de l’extension confirme des fichiers de profil exacts, inchangés et dont la corruption est prouvée. Remove invalid record dans Settings vise une ligne d’appartenance serveur invalide. Ce sont deux opérations distinctes ; aucune n’exécute silencieusement l’autre.
Préservez les fichiers inconnus ou modifiés pour le diagnostic. Ne copiez pas les droits d’un autre profil, n’assouplissez pas les permissions des répertoires et ne supprimez pas tous les enregistrements pour contourner le problème. Une réinscription crée une nouvelle génération ; sa protection de clone doit être approuvée et appliquée à nouveau.
Réconcilier les sources et les éléments périmés de l’éditeur
Sélection des dépôts, enregistrement et autorisation hôte sont distincts. Examinez la racine précise proposée et appliquez seulement l’autorisation voulue. Ajouter un dossier à VS Code ou choisir un dépôt enfant n’autorise pas son parent plus vaste.
Après modification, renommage ou suppression des sources, les diagnostics précédents peuvent être marqués périmés ou retirés. Enregistrez le contenu prévu et réanalysez fichier, dossier ou dépôt exact. Refresh Findings recharge les résultats existants ; il n’analyse pas les changements. Les tampons non enregistrés ne sont pas des entrées d’analyse.
Si une réanalyse de fichier exact ne peut établir la cible canonique, résolvez le contexte plutôt que de substituer un fichier de nom voisin. Les constats historiques d’un arbre commité restent liés à cet arbre.
Rétablir la disponibilité des analyseurs
Ouvrez Tools et examinez chaque composant requis. Pendant Verifying, attendez la vérification du contenu. Avertissement et expiration stricte diffèrent : les données examinées avertissent après sept jours et expirent après quatorze. Les règles immuables gérées dans les sources suivent leur verrou examiné, pas une limite d’âge inventée.
Utilisez Prepare all scanners pour une préparation complète normale. Un composant requires_lock_refresh exige des sources examinées et un verrou de données renouvelés ; retélécharger sous la même autorité expirée ne le répare pas.
Choisissez l’action correspondant à l’échec :
- Retry verification répète une observation échouée admissible de la cible de cache inchangée. Rien n’est téléchargé et les octets invalides ne sont pas réparés.
- Check cache outcome examine une publication incertaine via un job distinct, borné et en lecture seule. La préparation initiale reste échouée.
- Roll back cache, sous Advanced scanner maintenance, sélectionne une précédente génération valide uniquement si contenu, autorité, compatibilité et fraîcheur passent encore. Cela ne contourne pas l’expiration et ne change pas les binaires des images.
Une préparation complète normale peut remplacer une unique génération sélectionnée endommagée si son pointeur reste valide, sans précédente génération valide, et si les six composants de données/règles sont demandés. Il faut assez d’espace pour le remplacement complet tout en gardant les anciennes données. Structures dangereuses, pointeurs invalides et réparations partielles sont refusés. Préservez les éléments plutôt que de modifier manuellement pointeurs, propriétaires ou permissions.
Le guide des analyses décrit préparation et couverture. Une analyse limitée reste partielle ; elle ne constitue pas un raccourci de récupération vers un contrôle complet réussi.
Rejoindre les jobs et sauvegardes incertains
Rouvrez Jobs, retrouvez la tâche initiale et actualisez-la. Si le traitement est indisponible, utilisez make up depuis les sources du produit, attendez la santé du worker et revérifiez le même job. Réessayez uniquement une tâche terminale admissible proposant Retry.
Pour Settings, rétablissez la connexion et utilisez Reload Settings. Les sections modifiées gardent leurs brouillons ; les autres chargent les valeurs actuelles. Une sauvegarde incertaine peut avoir atteint le backend : comparez l’état enregistré avant de soumettre à nouveau. Un conflit de révision exige une nouvelle décision sur les valeurs actuelles.
L’annulation a elle aussi une issue à réconcilier. Attendez le nettoyage terminal : fermer une page n’annule pas le travail, et annuler ne défait pas les données publiées ni ne rappelle le contenu Advisor distant. Le guide des jobs explique ces distinctions et l’idempotence API.
Interpréter une erreur API dans son contexte
Les erreurs de validation utilisent un tableau detail expurgé contenant type, loc et msg, sans les valeurs soumises. Les autres erreurs peuvent être une chaîne ou un problème structuré. Lisez le contrat de réponse de l’opération exacte.
| Statut | Vérifications |
|---|---|
400, 411, 413 |
Forme de requête, hôte, URL et limites de corps ou d’instantané. |
401, 403 |
Membre, origine, CSRF et droits propres à l’opération. |
404 |
Identité actuelle de ressource et collection. |
409 |
Révision, liaison ou état de commande actuel. |
422 |
Validation des champs et exigences sémantiques définies dans les sources. |
429 |
Capacité d’authentification, de streams ou de jobs et temporisation requise. |
500, 502, 503, 504 |
Disponibilité des services et issue potentiellement incertaine du job initial. |
La référence API relie les erreurs propres aux routes aux sources. Ce tableau aide à récupérer ; il ne prétend pas que chaque route retourne chaque statut.
Préserver les éléments pour l’assistance
Notez révision publique, plateforme, opération concernée, identité de ressource non secrète, comportement attendu et reproduction synthétique minimale. Examinez les diagnostics avant partage. Excluez secrets d’exécution, cookies, valeurs d’association, dépôts privés et logs non examinés.
L’installation sépare état durable de base et artefacts expurgés pris en charge des sorties temporaires et spools de récupération. Lisez le guide de persistance figé avant de récupérer le stockage. Utilisez l’assistance pour les questions produit et le canal de sécurité pour une vulnérabilité possible.