Identifiez votre problème
Commencez par le message affiché dans Panolayer. Utilisez le tableau pour accéder directement à la correction correspondante, puis vérifiez le résultat avant de passer à l’étape suivante.
| Que se passe-t-il ? | Commencez ici |
|---|---|
| L’installation ou la vérification du système ne se termine pas | Installation et vérification du système |
| Le navigateur se connecte, mais l’application attend toujours | Terminer la connexion |
| Votre repository ne s’ouvre pas ou semble incomplet | Ouvrir le bon repository |
| Un agent est absent, ne se lance pas ou signale une erreur de moteur | Démarrer un agent |
| Un agent ne peut pas lire ou modifier un fichier | Vérifier l’accès aux fichiers |
| La vérification est interrompue, indisponible ou non conclue | Récupérer la vérification |
| Une règle décrit un comportement incorrect | Inspecter la règle et ses preuves |
| Un agent s’arrête ou vous ne trouvez pas ses modifications | Inspecter le travail de l’agent |
| Un graphe échoue ou renvoie une réponse incomplète | Vérifier l’étape du graphe |
| Une fusion entre en conflit ou un push échoue | Résoudre les problèmes de fusion et de push |
| Vous avez encore besoin d’aide | Signaler un bug reproductible |
Conservez l’erreur et le travail. Notez le message exact et l’endroit où il est apparu. Inspectez l’exécution ou le worktree existant avant de démarrer une autre tâche. Vous n’avez pas besoin de supprimer votre repository, le worktree de l’agent ou vos réglages pour suivre ce guide.
Aide à la configuration
Vous attendez toujours la connexion via le navigateur ?
Choisissez Rouvrir le navigateur dans Panolayer et terminez l’approbation de la connexion. Si la demande a expiré, choisissez Réessayer pour en démarrer une nouvelle.
Le navigateur utilise le mauvais compte ?
Choisissez Changer de compte sur la page d’approbation du navigateur, puis connectez-vous avec le compte souhaité.
L’installateur système n’est plus ouvert ?
Choisissez Rouvrir l’installateur sur l’écran de vérification du système de Panolayer, puis terminez l’installation d’Apple Command Line Tools. Panolayer effectue la vérification automatiquement pendant l’exécution de l’installateur.
Pour les problèmes d’installation, de vérification ou d’agent, consultez Dépannage.
L’installation ou la vérification du système ne se termine pas
Vérifiez d’abord votre Mac. L’application de bureau Panolayer nécessite un Mac avec puce Apple silicon sous macOS 15 Sequoia ou version ultérieure. Consultez menu Apple → À propos de ce Mac pour connaître votre puce et votre version de macOS. Les Mac Intel ne sont pas pris en charge.
Si vous avez téléchargé Panolayer mais qu’il n’est pas installé : ouvrez le fichier .dmg, faites glisser Panolayer dans Applications, puis ouvrez-le depuis Applications. Suivez Installer et configurer Panolayer pour la séquence complète.
Si vous êtes bloqué sur l’écran Une vérification rapide du système :
- Choisissez Installer à côté de Git — Apple Command Line Tools et terminez l’installateur d’Apple.
- Si vous avez fermé l’installateur, choisissez Rouvrir l’installateur dans Panolayer.
- Revenez à Panolayer après l’installation. Il détecte les outils automatiquement ; choisissez Choisir un projet lorsque la vérification est prête.
Vous pouvez continuer dès que Panolayer vous permet de choisir un projet. Si l’installateur d’Apple signale une erreur, incluez cette erreur exacte lorsque vous demandez de l’aide.
La connexion ne se termine pas
La connexion comporte deux étapes : authentifiez-vous dans votre navigateur, puis approuvez ce Mac pour l’application Panolayer. Un site web connecté seul ne suffit pas à valider l’approbation de l’application.
| Ce que vous voyez | Ce qu’il faut faire |
|---|---|
| L’application attend et aucune page de navigateur n’est ouverte | Choisissez Rouvrir le navigateur dans Panolayer. |
| Le navigateur affiche un autre compte | Choisissez Changer de compte, puis connectez-vous avec le compte que vous souhaitez utiliser dans l’application. |
| Le navigateur vous demande d’approuver cet ordinateur | Comparez son code avec Votre code dans l’application. S’ils correspondent, choisissez Oui, se connecter sur cet ordinateur. |
| La demande a expiré | Choisissez Réessayer dans Panolayer et terminez la nouvelle demande dans le navigateur. |
| Le navigateur confirme l’approbation | Revenez à Panolayer pour poursuivre la configuration. |
Utilisez le même compte dans l’application et sur le site web. Consultez Connexion pour la procédure complète.
Un agent tiers vous demande de vous connecter séparément ? Il s’agit de la connexion du fournisseur de l’agent. Votre compte Panolayer ne le remplace pas. Suivez les instructions de cet agent et consultez Agents pris en charge.
Votre repository ne s’ouvre pas ou semble incomplet
Votre projet ne s’ouvre pas ?
Vérifiez que vous avez sélectionné le dossier racine d’un repository Git local. Si votre repository est hébergé en ligne, clonez-le d’abord sur votre Mac, puis ouvrez ce dossier dans Panolayer.
Choisissez Ouvrir un projet… sur l’écran d’ouverture de Panolayer, puis sélectionnez le dossier racine de votre repository Git local. Une URL GitHub n’est pas un dossier local ; clonez d’abord le repository sur votre Mac à l’aide de vos outils Git habituels.
Si la carte semble incomplète :
- Vérifiez que vous avez ouvert la racine du repository voulue, et non un fichier individuel ou le mauvais sous-dossier.
- Vérifiez si Panolayer analyse encore le code ou signale une erreur d’indexation. Voir Rétablir la vérification.
- Consultez les langages pris en charge pour votre base de code. Inspectez les applications et les relations affichées dans Architecture, en particulier dans un monorepo.
Un framework détecté ou un fichier visible ne signifie pas que chaque relation dynamique peut être résolue. Voir Explorer l’architecture et les dépendances.
Utilisez l’exemple pour comparer le workflow. La documentation utilise Twitter Clone, qui s’ouvre sous le nom twitter-starter. Votre propre repository aura des fichiers, des nombres de tickets et des dépendances différents. Vous n’avez pas besoin de passer à l’exemple pour utiliser Panolayer.
Un agent ne démarre pas
Panolayer Agent est intégré. Ouvrez Mes agents, choisissez le bouton + à côté de Surveiller les agents, puis sélectionnez Panolayer Agent. Il ne nécessite pas de connexion distincte auprès d’un fournisseur. Voir Exécuter un agent sur votre repository.
Pour un autre agent : installez-le depuis la Place de marché, revenez à Mes agents et choisissez-le dans le même menu. Effectuez la connexion du fournisseur lorsqu’elle est demandée. L’accès à son modèle et sa facturation relèvent de ce fournisseur ; consultez Agents pris en charge pour la configuration correspondante.
Si vous voyez une carte d’échec d’agent :
- Ouvrez Détails techniques et lisez l’erreur de lancement.
- Si le moteur de conteneur n’a pas pu démarrer, vérifiez la configuration Mac ci-dessus, puis utilisez Réessayer sur la carte d’échec.
- Si le message mentionne des identifiants manquants ou un problème de compte, terminez la connexion de cet agent avant de réessayer.
- S’il échoue à nouveau avec le même message, choisissez Signaler un bug sur la carte d’échec. Cette voie inclut les diagnostics de l’agent. Relisez le rapport avant de l’envoyer.
Un lancement réussi ouvre la conversation de l’agent afin que vous puissiez envoyer une demande. Le démarrage répété de nouvelles sessions ne résout pas une erreur d’installation ou de compte inchangée.
Une demande est rejetée ou votre utilisation est épuisée
Si Panolayer indique Vous avez épuisé votre utilisation pour ce mois-ci, ouvrez Réglages → Forfait et utilisation pour vérifier l’utilisation du compte et sa date de réinitialisation. Réessayer la même demande ne restaure pas l’utilisation épuisée.
Pour un agent tiers, vérifiez le compte fournisseur nommé dans son erreur. Se connecter à Panolayer ne modifie pas le quota ni la facturation de ce fournisseur. Résolvez le problème de compte signalé avant de réessayer.
Un agent ne peut ni lire ni modifier un fichier
Vérifiez les contrôles du fichier dans Architecture. Ouvrez la source du fichier et faites défiler vers le bas dans son panneau de détails.
| Contrôle | Ce qu’il modifie |
|---|---|
| Verrouiller le fichier, sous Verrou d’implémentation | Empêche les agents IA de modifier le fichier. |
| Masquer aux agents, sous Accès des agents de conteneur | Empêche les nouveaux agents de conteneur de lire le fichier. Les sessions d’agent existantes ne sont pas modifiées. |
Si la restriction est intentionnelle, conservez-la et demandez à l’agent de travailler dans ce cadre. Si vous voulez que l’agent accède à ce fichier, modifiez délibérément le contrôle concerné. Une modification de visibilité s’applique aux nouvelles sessions d’agent de conteneur ; l’accès d’une session existante ne change pas.
Si aucun des deux contrôles n’explique le problème, examinez l’erreur de l’agent et l’espace de travail qu’il utilise. Voir Inspecter le travail de l’agent.
La vérification n’a aucun résultat exploitable
Ouvrez Problèmes et consultez l’état de la vérification avant de décider quoi faire. Une vérification qui n’a pas pu aboutir n’est pas un résultat positif, et elle diffère d’une règle qui a échoué sur votre code.
| État ou message | Que faire ensuite |
|---|---|
| Analyse du code ou Vérification des règles | Suivez l’étape en cours. Attendez qu’elle se termine avant d’interpréter le résultat. |
| Pas encore indexé ou Impossible d’indexer ce projet | Suivez l’action indiquée sur la carte pour lancer l’indexation ou Réessayer. Panolayer doit lire les sources avant de pouvoir les vérifier. |
| La vérification a été interrompue ou La vérification nécessite votre attention | Lisez l’erreur associée, corrigez sa cause, puis choisissez Réessayer sur la carte d’état. |
| Impossible de lire l’état de la vérification | Choisissez Réessayer pour relire l’état. Le message ne permet pas de déterminer si le code a réussi ou échoué. |
| Résultats indéterminés | Ouvrez le motif enregistré pour chaque élément. Ces vérifications ne sont ni validées ni en échec. |
| Entrée trop volumineuse | Réessayer avec des entrées inchangées ne servira à rien. Indiquez le fichier concerné et le message visible dans un rapport afin que l’équipe puisse enquêter. |
| L’évaluation n’a pas pu se terminer | Corrigez la cause enregistrée, puis utilisez Réessayer la vérification lorsque l’option est proposée. |
| Rien à vérifier — aucune modification pour l’instant | L’agent n’a aucune modification à vérifier. Inspectez sa tâche et son espace de travail avant d’attendre un résultat de fusion. |
Si l’application indique qu’un espace de travail d’agent a été supprimé ou n’est plus suivi, choisissez Revenir à l’espace principal pour continuer à travailler dans l’espace de travail principal. Un ancien résultat ne permet pas d’établir l’état de fichiers qui ne sont plus vérifiés.
Après une nouvelle tentative, consultez le nouvel état. Ne considérez pas une erreur disparue, une liste de problèmes vide ou une vérification inachevée comme la preuve que le code a réussi. Voir Comprendre un résultat de vérification.
Une règle semble incorrecte
Ouvrez Détails à côté du problème et comparez l'exigence, l'explication et la source. Dans l'exemple Twitter, clearSaved est censé ne se terminer qu'après la fin des suppressions de signets ; les détails montrent pourquoi son code actuel renvoie trop tôt.
- L'exigence est correcte et le code la viole : choisissez Corriger et sélectionnez Panolayer Agent ou un autre agent installé. Suivez Corriger votre premier bug.
- L'exigence décrit le mauvais comportement : corrigez la règle pour qu'elle corresponde à ce que la fonction doit faire, puis relancez la vérification et examinez le nouveau résultat.
- L'exigence est correcte, mais l'échec signalé semble incorrect : signalez la règle, l'explication affichée et un exemple minimal qui reproduit le problème.
Modifier une exigence diffère de corriger le code. N'affaiblissez pas une règle correcte simplement pour transformer un échec en réussite.
Un agent s’arrête, ou vous ne trouvez pas ses modifications
Ouvrez Mes agents et revenez à la conversation associée à cette tâche. Choisissez Ouvrir sur sa carte d’exécution. Dans Flux, sélectionnez l’activité pertinente pour inspecter la commande et sa sortie dans le panneau de droite. Lisez l’erreur avant d’envoyer une autre tâche.
Une commande ou un test a échoué ? Vérifiez ce que dit réellement la sortie. Une dépendance manquante, un identifiant refusé et un test d’application en échec nécessitent des corrections différentes. Indiquez à l’agent la commande en échec et le résultat attendu, en rattachant le suivi à la même tâche. Si l’application affiche une carte d’échec, utilisez ses contrôles Détails techniques, Réessayer ou Signaler un bug.
L’agent a terminé, mais votre copie de travail semble inchangée ? Le travail de code s’effectue dans le worktree de l’agent, séparé de votre espace de travail principal. Ouvrez Modifications et sélectionnez le worktree de cet agent à droite pour voir son code non commité. Vous pouvez examiner les worktrees, inspecter les modifications par risque et effectuer un commit depuis Modifications.
L’exécution indique Terminé, mais le travail n’est pas fusionné ? La fin de l’exécution et l’approbation de la fusion sont distinctes. Examinez le résumé de vérification et les fichiers modifiés, puis décidez si vous devez fusionner. Une fusion dans votre branche enregistre la modification localement ; le push vers votre dépôt distant est une étape distincte.
Voir Suivre le travail de l’agent et Examiner les modifications et effectuer un commit.
Une étape du graphe échoue ou la réponse est incomplète
Inspectez l’étape qui a échoué et sa sortie avant de modifier l’ensemble du graphe.
| Ce que vous voyez | Ce qu’il faut vérifier |
|---|---|
| Le graphe est en lecture seule | Dupliquez le graphe intégré pour modifier votre propre copie. |
| Une étape agent nécessite une classification | Sélectionnez l’étape et choisissez sa classification d’agent dans le panneau de droite. |
| Un script échoue immédiatement | Vérifiez Programme, un argument par ligne, et Code de sortie de réussite. Le programme doit être disponible là où l’étape s’exécute. |
| L’agent n’utilise pas la question de cette exécution | Vérifiez que Instructions personnalisées inclut la variable Objectif insérée avec @. |
| Un échec n’a nulle part où aller | Inspectez la route d’échec rouge et connectez un gestionnaire explicite ou une destination Échec. |
| Le graphe réussit mais la réponse est incomplète | Lisez la sortie de l’étape agent, clarifiez ses instructions et testez à nouveau le même objectif. |
Une étape de script réussie signifie qu’elle a atteint son code de sortie de réussite configuré. Vérifiez aussi la sortie réelle et le résultat visé. Après avoir modifié une route d’échec, testez délibérément ce chemin.
Suivez Créer votre premier graphe d’agent IA pour l’exemple fonctionnel et les captures d’écran de configuration.
Un merge est en conflit, ou un push échoue
Commencez par Modifications. Sélectionnez le worktree concerné et examinez ce qui attend d’être commité ou fusionné. Si vous avez déjà approuvé une fusion d’agent, retrouvez son commit dans Historique avant de tenter de commiter à nouveau le même travail.
Si la fusion signale des conflits :
- Lisez la boîte de dialogue de conflit. Le travail de l’agent n’a pas encore été fusionné et son worktree reste disponible.
- Résolvez chaque fichier en conflit dans le worktree de l’agent, enregistrez-le, puis indexez cette résolution avec
git adddans ce worktree. Vous pouvez aussi utiliser l’action de la boîte de dialogue pour demander à l’agent de résoudre les conflits, puis relire ses modifications. - Choisissez Actualiser l’état. Si le rebase est en pause et que les conflits sont indexés, choisissez Poursuivre le rebase.
- Examinez les modifications obtenues, puis utilisez Vérifier et relancer la fusion lorsque l’option est proposée.
Ne résolvez pas un conflit dans un autre checkout en espérant que le worktree de l’agent change en conséquence.
Si un push échoue : lisez l’erreur Git et vérifiez le remote configuré ainsi que votre droit d’y écrire. Si la branche distante a avancé, réconciliez les modifications avec votre workflow Git habituel avant de réessayer. Une fusion ou un commit local reste local tant que le push n’a pas réussi. L’exemple Twitter peut n’avoir aucun remote configuré ; un commit local suffit pour terminer sa visite guidée.
Voir Vérifier les modifications et commiter pour les commandes de commit, d’historique et de push.
Signaler un bug
Si le problème persiste, choisissez Signaler un bug dans Panolayer, ou contactez l’équipe. Lorsqu’un agent échoue, utilisez Signaler un bug sur sa carte d’échec pour que le rapport inclue les diagnostics de cet agent.
Vous pouvez utiliser ce modèle :
Ce que je cherchais à faire :
Étapes de reproduction :
1.
2.
3.
Résultat attendu :
Résultat obtenu :
Erreur ou statut exact :
Version de Panolayer :
Puce du Mac et version de macOS :
Nom de l’agent, le cas échéant :
Cela se produit-il aussi dans l’exemple Twitter Clone ?
Indiquez le nom du fichier ou de la fonction lorsque cela aide à localiser le problème, et précisez si cela s’est produit dans l’espace de travail principal ou dans un worktree d’agent. Un petit exemple partageable est plus utile qu’un repository privé entier. Vous n’êtes pas obligé de tester l’exemple si cela interrompt votre travail en cours.
La boîte de dialogue de rapport inclut les diagnostics et les journaux, et peut joindre l’écran actuel. Vérifiez le contrôle Capture d’écran jointe et les fichiers que vous ajoutez avant l’envoi. Omettez les identifiants, les clés API et le code source privé que vous ne souhaitez pas partager.
Après l’envoi, conservez la référence de suivi affichée dans la confirmation afin de pouvoir vous référer au même rapport lors de vos relances.