Aller au contenu principal

Dépannage

Problèmes courants et comment les résoudre.

Problèmes de fournisseur​

« Erreur : 401 non autorisé »​

  • Cause : clé API invalide.
  • Solution : allez dans Settings > Providers. Ressaisissez votre clé API. Vérifiez qu'il n'y a pas d'espaces ou de sauts de ligne superflus.

« Erreur : 403 accès interdit »​

  • Cause : votre clé API n'a pas accès au modèle demandé.
  • Solution :
    • Pour OpenAI : certains modèles nécessitent un palier payant. Vérifiez votre accès sur platform.openai.com.
    • Pour Anthropic : assurez-vous que votre compte a accès au modèle Claude demandé.

« Erreur : 429 trop de requêtes »​

  • Cause : vous avez atteint la limite de débit ou vous n'avez plus de credit.
  • Solution :
    • Patientez quelques minutes puis réessayez (limite de débit).
    • Vérifiez votre statut de facturation et ajoutez du credit sur le site du fournisseur.
    • Envisagez de passer temporairement à un autre fournisseur.

« Erreur : 500 erreur interne du serveur »​

  • Cause : les serveurs du fournisseur rencontrent des problèmes.
  • Solution : patientez quelques minutes puis réessayez. Consultez la page de statut du fournisseur.

« Connexion refusée » (Ollama)​

  • Cause : Rephlo ne parvient pas à communiquer avec le serveur IA local.
  • Solution :
    1. Ouvrez un terminal et exécutez ollama serve.
    2. Vérifiez qu'il est bien lancé : visitez http://localhost:11434 dans un navigateur.
    3. Vérifiez qu'aucune autre application n'utilise le port 11434.

« Modèle introuvable » (Ollama)​

  • Cause : le modèle demandé n'est pas téléchargé.
  • Solution : exécutez ollama pull [model-name] dans votre terminal (par exemple, ollama pull llama3).

Problèmes d'interface​

« Les raccourcis clavier ne fonctionnent pas »​

  • Cause (Windows/Linux) : une autre application (comme PowerToys ou un jeu) a peut-être accaparé le raccourci.
  • Solution : allez dans Settings > Hotkeys et changez le déclencheur pour autre chose (par exemple, Ctrl + Shift + Alt + Z).

Utilisateurs macOS : consultez Problèmes spécifiques à macOS ci-dessous pour le dépannage des raccourcis clavier sur macOS.

« L'icône de la barre d'état système est manquante »​

  • Cause : Windows l'a peut-être masquée dans le menu « overflow » (débordement).
  • Solution : cliquez sur la flèche ^ près de l'horloge. Faites glisser l'icône Rephlo vers la zone principale de la barre des tâches.

Problèmes de fonctionnalités​

« Vision/Capture d'écran ne fonctionne pas »​

  • Cause (Windows) : les autorisations d'enregistrement d'écran sont peut-être refusées dans les paramètres de confidentialité de Windows.
  • Solution (Windows) : exécutez Rephlo en tant qu'administrateur, ou vérifiez Paramètres de confidentialité Windows > Caméra / Capture d'écran.
  • Cause (macOS) : Rephlo nécessite l'autorisation d'enregistrement de l'écran (Screen Recording).
  • Solution (macOS) : consultez Problèmes spécifiques à macOS ci-dessous pour les étapes détaillées.

« Le Space ne répond pas aux questions »​

  • Cause : le Space est peut-être vide, ou son ingestion a échoué.
  • Solution : vérifiez les détails du Space. Assurez-vous que les fichiers sont listés et que le statut indique Ready (prêt). Essayez de vider le cache dans Advanced Settings.

« Variable introuvable dans le Space »​

  • Cause : vous utilisez une variable {{filename}}, mais le fichier ne se trouve pas dans le Space actif.
  • Solution :
    1. Vérifiez que le Space contient le fichier référencé.
    2. Vérifiez que le nom de la variable correspond au nom du fichier (converti en snake_case, par exemple « Style Guide.pdf » -> {{style_guide_pdf}}).
    3. Assurez-vous que le bon Space est actif.

Problèmes spécifiques à macOS​

« Les raccourcis clavier ne fonctionnent pas » (macOS)​

  • Cause : Rephlo nécessite l'autorisation Accessibility pour détecter les raccourcis clavier globaux.
  • Solution :
    1. Ouvrez System Settings > Privacy & Security > Accessibility.
    2. Trouvez Rephlo dans la liste et activez-le (ON).
    3. Si Rephlo n'apparaît pas dans la liste, quittez puis relancez l'application.
    4. Redémarrez Rephlo après avoir accordé l'autorisation.

Important : les raccourcis clavier globaux ne fonctionnent que lorsque Rephlo est exécuté en tant que bundle .app signé. Si vous êtes développeur et lancez dotnet run depuis un terminal, les raccourcis peuvent ne pas fonctionner. Consultez le tutoriel de configuration macOS pour créer et exécuter le bundle .app.

« Capture d'écran / Vision ne fonctionne pas » (macOS)​

  • Cause : Rephlo nécessite l'autorisation Screen Recording pour capturer le contenu de l'écran.
  • Solution :
    1. Ouvrez System Settings > Privacy & Security > Screen Recording.
    2. Trouvez Rephlo dans la liste et activez-le (ON).
    3. Redémarrez Rephlo.

« La boîte de dialogue d'autorisation réapparaît sans cesse »​

  • Cause : Rephlo s'exécutait sans signature de code stable. Chaque reconstruction modifie le hash du binaire, ce qui pousse macOS à le traiter comme une nouvelle application et à réinitialiser les autorisations.
  • Solution : utilisez une build de version signée de Rephlo provenant de la distribution officielle. Une fois les autorisations accordées à l'application signée, elles persistent d'une mise à jour à l'autre.

« La superposition n'apparaît pas même après avoir accordé les autorisations »​

  • Solution :
    1. Quittez complètement Rephlo (clic droit sur l'icône de la barre d'état système > Exit).
    2. Relancez depuis le bundle .app.
    3. Vérifiez que les autorisations Accessibility ET Screen Recording sont bien accordées.
    4. Essayez le bouton Test Overlay dans Settings > Hotkeys.

Problèmes de performance​

« Les réponses sont très lentes »​

  • Cause : plusieurs facteurs peuvent ralentir les réponses.
  • Solution :
    • Contexte de Space volumineux : envisagez de compacter votre Space.
    • Fournisseur lent : passez à un modèle plus rapide, comme GPT-5.4 Mini ou Gemini 3.5 Flash, pour des réponses plus rapides.
    • Modèle local (Ollama) : assurez-vous que votre GPU est bien utilisé. Consultez les journaux d'Ollama.

« L'application semble lente au démarrage »​

  • Cause : chargement de Spaces volumineux ou d'un grand nombre de commandes.
  • Solution : archivez les commandes inutilisées. Supprimez les anciens Spaces dont vous n'avez plus besoin.

Problèmes de chat​

« L'historique du chat a disparu »​

  • Cause : les conversations sont stockées localement et ont peut-être été effacées.
  • Solution : vérifiez les paramètres de rétention de l'historique dans Settings > Privacy. Si le réglage est sur Immediate (immédiat), l'historique n'est pas conservé.

« Le chat oublie constamment le contexte »​

  • Cause : vous avez dépassé la fenêtre de contexte du fournisseur.
  • Solution : démarrez une nouvelle conversation ou utilisez un fournisseur avec une fenêtre de contexte plus large. Consultez la documentation de votre fournisseur pour connaître les tailles exactes de fenêtre de contexte.

Problèmes de variables et de modèles​

« Variable introuvable » ou « Variable invalide »​

  • Cause : le nom de la variable ne correspond à aucune variable système valide ni à aucun fichier de votre Space.
  • Solution :
    • Utilisez la syntaxe exacte : {{input_content}}, {{space_data_all}} ou {{filename}}.
    • Pour les variables de fichier : convertissez le nom du fichier en snake_case (par exemple, « Style Guide.pdf » -> {{style_guide_pdf}}).
    • Vérifiez que le fichier existe dans votre Space actif.
    • Vérifiez l'absence de fautes de frappe — les noms de variables ne sont pas sensibles à la casse, mais doivent être orthographiés correctement.

« Les variables de Space sont ignorées en mode Standalone »​

  • Cause : les commandes Standalone n'injectent pas automatiquement les données du Space.
  • Explication : le mode Standalone vous donne un contrôle manuel complet. Les variables comme {{space_data_all}} ne seront pas remplacées automatiquement.
  • Solution : passez au mode Combination pour une injection automatique des données du Space, ou collez manuellement les données du Space dans votre prompt.

Problèmes de Space​

« Space plein » ou « Budget de tokens dépassé »​

  • Cause : votre Space a dépassé sa limite de tokens configurée.
  • Solution :
    1. Ouvrez la vue des données du Space et examinez l'utilisation actuelle.
    2. Supprimez les fichiers les moins importants du Space, ou augmentez le budget de tokens (max 1 000 000 tokens) — ces actions réduisent directement un Space dont le budget stocké est dépassé.
    3. Passez le mode de données en 🗜️ Compact pour stocker des résumés générés par l'IA au lieu du texte intégral — cela réduit les tokens comptabilisés du Space (vérifiez le coût en credit). Choisissez ensuite un niveau de compaction :
      • Conservative : résumé minimal (préserve le détail).
      • Balanced : résumé modéré (par défaut, recommandé).
      • Aggressive : résumé important (idéal pour les très grands Spaces).
      • Remarque : pour un Space très volumineux (≈128 000 tokens ou plus), Compact est désactivé par conception — supprimez des fichiers ou augmentez le budget à la place.
    4. Remarque : 🔍 Smart Search garde chaque requête légère en n'envoyant que les passages pertinents, mais elle comptabilise l'intégralité du texte brut dans le budget du Space — elle contrôle donc le coût par requête, pas un Space qui dépasse sa limite stockée.

« Échec de l'ingestion du Space » (erreur PDF/document)​

  • Cause : le fichier n'a pas pu être traité — il est peut-être corrompu, protégé par mot de passe, ou dans un format non pris en charge.
  • Solution :
    • Vérifiez que le PDF n'est pas protégé par mot de passe.
    • Essayez de réexporter le document depuis l'application source.
    • Pour les PDF scannés : Rephlo extrait uniquement le texte — les images à l'intérieur des PDF ne sont pas lues.
    • Vérifiez que le fichier n'est pas corrompu en l'ouvrant d'abord dans une autre application.

Problèmes de génération d'images​

« Ce prompt a été bloqué par notre politique de contenu »​

  • Cause : votre prompt d'image a été signalé par la modération de contenu et rejeté avant que la génération ne s'exécute.
  • Solution : réécrivez votre prompt pour retirer le contenu non autorisé, puis réessayez. Consultez la page Politique de contenu pour savoir ce qui n'est pas autorisé.

« La modération de contenu est temporairement indisponible »​

  • Cause : le service de modération de contenu est temporairement en panne (une interruption transitoire), donc votre prompt n'a pas pu être vérifié.
  • Solution : patientez un instant, puis réessayez.

Obtenir de l'aide​

Comment signaler un contenu IA nuisible ou inapproprié ?​

  • Solution :
    • Si vous êtes connecté : cliquez sur votre avatar en bas de la barre latérale > Help > Report inappropriate content.
    • À tout moment : ouvrez Settings > About > Contact & Support > Report inappropriate content.
    • Cela ouvre rephlo.app/contact dans votre navigateur, avec la catégorie de signalement présélectionnée.