OrbitWake for VS Code
Dépannage
Cette page regroupe les erreurs réellement émises par OrbitWake pour VS Code et le backend IDE actuel. Commencez par le symptôme visible, puis suivez l’action corrective correspondante.
Vérifications rapides
- Utilisez VS Code 1.106 ou plus récent.
- Vérifiez que l’extension OrbitWake est installée et activée.
- Rechargez la fenêtre VS Code après une installation ou une mise à jour.
- Pour Agent, ouvrez un folder ou workspace.
- Pour Ask, gardez un fichier code actif ou récemment actif.
- Si l’authentification semble incohérente, effectuez un nouveau pairing.
OrbitWake n’apparaît pas après installation
La version actuelle de l’extension exige VS Code 1.106+ parce qu’elle utilise la Secondary Side Bar native.
Vérifiez la version de VS Code, puis confirmez que OrbitWake apparaît comme extension installée. Si nécessaire, rechargez la fenêtre avec la commande standard Developer: Reload Window.
Le listing Marketplace public utilise l’identifiant orbitwake.orbitwake-vscode.
La vue OrbitWake n’est pas à droite
Depuis la version 0.1.3, OrbitWake contribue sa vue à la Secondary Side Bar.
VS Code peut toutefois conserver un emplacement de vue précédemment enregistré par l’utilisateur. La version 0.1.4 n’écrase pas cette préférence.
Utilisez les contrôles de layout natifs de VS Code pour replacer la vue si elle a été déplacée.
“Pairing code is invalid or expired.”
Cette erreur est retournée lorsque le code est incorrect, a dépassé ses 10 minutes de validité, a déjà été utilisé ou a été invalidé par la création d’un code plus récent.
Créez un nouveau code dans OrbitWake → Settings → IDEs, puis relancez :
OrbitWake: Connect IDE“Connect this IDE to OrbitWake first.”
Le panneau ne trouve aucun token OrbitWake dans SecretStorage.
Effectuez un pairing via OrbitWake: Connect IDE. Si vous aviez déjà pairé l’éditeur mais utilisé ensuite Disconnect IDE, un nouveau pairing est nécessaire.
“IDE authentication required.” — 401
Le backend n’a pas pu associer le Bearer token à une session IDE active et non révoquée.
Causes courantes : token local invalide, session révoquée depuis OrbitWake, session devenue non active ou ancien token conservé localement.
Solution recommandée : déconnectez localement l’IDE, créez un nouveau code de pairing et reconnectez.
“OrbitWake IDE AI is not available for this account.” — 403
L’authentification IDE est valide, mais le compte n’a pas accès aux fonctions AI IDE dans cette build.
Le contrôle d’accès beta est séparé du pairing. Un éditeur peut donc être correctement connecté et recevoir tout de même un 403.
Le mode Agent peut retourner la variante OrbitWake IDE Agent is not available for this account.
“OrbitWake took too long to respond. Try again.”
L’extension arrête une requête après 120 secondes.
Réessayez la requête. Pour Agent, réduisez la portée de la demande si elle est très large. Le timeout n’est pas configurable dans la version actuelle.
“Could not reach OrbitWake. Check your connection and try again.”
La requête n’a pas atteint correctement https://orbitwake.com.
Vérifiez la connexion réseau, un éventuel proxy/VPN, puis confirmez que le site OrbitWake est accessible depuis la même machine.
“OrbitWake AI daily provider budget has been reached.”
Le gateway OrbitWake a atteint sa limite provider quotidienne globale configurée côté serveur.
Il ne s’agit pas d’un problème de VS Code, du pairing ou du fichier actif. La requête ne peut pas être résolue tant que la politique de budget côté service ne l’autorise pas de nouveau.
“OrbitWake IDE is temporarily unavailable.”
Ask a rencontré une erreur serveur inattendue qui n’est pas une erreur AI gateway explicitement classée.
Réessayez après avoir confirmé que la session IDE est toujours valide. Si le problème persiste, notez la version de l’extension, le modèle choisi et l’action qui déclenche l’erreur.
Ask affiche “No code context”
Ask conserve le dernier éditeur code utile lorsque le panneau prend le focus. Si aucun fichier code n’a été ouvert ou si le dernier document n’est plus disponible, le résumé de contexte peut être vide.
Ouvrez un fichier code, cliquez dans l’éditeur, puis revenez au panneau OrbitWake.
“OrbitWake will not send sensitive files…”
Le fichier actif correspond à une catégorie bloquée, par exemple .env, credentials, certificats ou clés privées.
Cette protection est volontaire et n’est pas désactivable via Settings dans la version actuelle. Utilisez un fichier non sensible ou reformulez la question sans transmettre le secret.
Ask About Selection ne fonctionne pas
Deux messages peuvent apparaître :
Open a code file and select text before using Ask About Selection.
Select some code before using Ask About Selection.Ouvrez un fichier code normal, sélectionnez du texte puis relancez la commande. Les fichiers sensibles restent bloqués même avec une sélection.
“Open a folder or workspace before using Agent mode.”
Agent a besoin d’un workspace pour sélectionner les fichiers pertinents et préparer une proposition multi-fichiers.
Ouvrez un dossier avec File → Open Folder… ou un workspace VS Code, puis réactivez Agent.
Le bouton Agent est désactivé
Le panneau désactive Agent lorsque l’extension indique qu’aucun workspace n’est ouvert.
Si vous venez d’ouvrir un dossier et que l’état ne s’est pas rafraîchi, masquez puis rouvrez la vue OrbitWake ou rechargez la fenêtre.
Agent revient sur Ask après réouverture
La version 0.1.4 corrige un problème où Agent pouvait revenir à Ask pendant que le webview attendait l’état du workspace.
Si ce comportement apparaît sur une version antérieure, mettez l’extension à jour.
“OrbitWake could not find readable files in this workspace.”
L’extension n’a trouvé aucun fichier texte admissible parmi les candidats du workspace.
Les répertoires générés courants sont exclus, les fichiers trop volumineux ne sont pas lus et les fichiers sensibles sont ignorés.
Ouvrez un fichier source pertinent ou reformulez la demande avec un nom de fichier ou composant présent dans le projet.
“No readable workspace files were supplied.”
Le backend Agent n’a reçu aucun fichier de contexte valide.
Cette erreur peut suivre un workspace vide, uniquement binaire, trop volumineux ou entièrement exclu par les règles de sécurité/scanning.
“OrbitWake did not return a valid patch proposal.”
Le modèle n’a pas produit une structure JSON Agent exploitable, même après les stratégies de récupération prévues par le backend.
Relancez la demande avec une instruction plus précise et un périmètre plus petit. Aucun fichier local n’est modifié lorsque la proposition n’est pas valide.
“OrbitWake did not propose any applicable file changes.”
Le backend a pu lire la réponse Agent, mais aucune modification valide n’a survécu aux règles de validation.
Les chemins absolus, les chemins contenant .., les changements sans contenu et certains fichiers existants non fournis dans le contexte sont rejetés.
“OrbitWake returned no safe local changes.”
La proposition serveur existe, mais aucune modification ne peut être transformée en chemin local sûr dans le workspace courant.
Régénérez la proposition depuis le bon workspace. N’essayez pas de contourner les validations de chemin.
“No patch proposal is waiting for review/approval.”
Preview ou Apply a été déclenché alors que l’extension ne possède plus de proposition Agent en mémoire.
Une proposition en attente n’est pas persistée comme état permanent. Après reload ou redémarrage de l’Extension Host, générez une nouvelle proposition.
“The paired workspace is no longer open.”
Preview ne retrouve plus le workspace utilisé pour préparer la proposition.
Rouvrez le projet concerné. Si vous avez changé de workspace, générez plutôt une nouvelle proposition dans le workspace actuel.
“Reopen the workspace where this patch was prepared.”
Apply détecte que le workspace actif n’est pas celui associé à la proposition.
OrbitWake bloque l’écriture pour éviter d’appliquer des changements au mauvais projet.
“Save your local changes in … before applying this patch.”
Un fichier ciblé est ouvert avec des modifications non sauvegardées.
Sauvegardez le fichier, puis comparez de nouveau la proposition. Si la sauvegarde a modifié son contenu par rapport au moment de génération, OrbitWake demandera de régénérer le patch.
“The file changed after OrbitWake prepared the patch…”
Le hash du fichier local ne correspond plus au hash enregistré lorsque la proposition a été préparée.
Cette protection évite d’écraser des changements intervenus entre génération et application.
Générez une nouvelle proposition à partir de l’état actuel du workspace.
“Unsafe patch path”
La proposition contient un chemin qui ne respecte pas les règles de sécurité locales.
Les chemins absolus, sorties de workspace et segments .. sont refusés. Régénérez la proposition ; ne modifiez pas manuellement les protections de chemin.
“VS Code could not apply the OrbitWake patch.”
L’appel vscode.workspace.applyEdit() a échoué.
Vérifiez les permissions d’écriture du projet, l’état des fichiers et la présence du workspace. Aucun succès ne doit être supposé si ce message apparaît.
Problèmes corrigés dans les versions récentes
| Version | Correction |
|---|---|
| 0.1.1 | Boutons du webview qui ne répondaient pas après installation. |
| 0.1.2 | Pairing production restauré, timeouts réseau et erreurs de connexion améliorés. |
| 0.1.3 | Contexte Ask conservé, fichiers sensibles bloqués, Agent désactivé sans workspace, sélection correctement transférée. |
| 0.1.4 | Agent ne revient plus incorrectement à Ask pendant la restauration du workspace. |
Avant d’investiguer un problème déjà corrigé, vérifiez que vous utilisez la version actuelle disponible.
Informations utiles pour diagnostiquer un bug
Sans exposer de secrets, relevez :
- la version de l’extension OrbitWake ;
- la version de VS Code ;
- le mode Ask ou Agent ;
- le modèle sélectionné ;
- le message d’erreur exact ;
- si un folder/workspace est ouvert ;
- si la session IDE a été récemment révoquée ou re-pairée.
.env ou des credentials pour demander de l’aide.Limites actuelles
Le panneau n’effectue pas une validation serveur continue de la session : un token révoqué peut encore donner l’impression locale d’être connecté jusqu’à la prochaine requête.
Le timeout, la base URL, les limites de scanning et la liste des fichiers sensibles ne sont pas configurables dans VS Code Settings.
Une proposition Agent en attente n’est pas destinée à survivre à un reload complet du runtime de l’extension.
Suite de la documentation
La section VS Code est maintenant documentée de bout en bout : vue d’ensemble, installation, authentification, commandes, réglages et dépannage.