#074Tutoriel4 min

Préparer son dossier de travail pour Hackaiz

Choisir le bon dossier, comprendre les exclusions et distinguer les sources locales de la plateforme sélectionnée.

Équipe Hackaiz · mis à jour le 21/11/2026

Illustration : une développeuse utilise un éditeur et un terminal.
Illustration : une développeuse utilise un éditeur et un terminal. Photo d’illustration, pas une capture d’écran.

01Ouvrir le dossier réellement concerné

L’analyse locale de l’extension commence par le premier dossier de travail ouvert. Dans une fenêtre contenant plusieurs racines, ne supposez pas que toutes les applications seront réunies dans le même examen. Ouvrez le dossier pertinent avant de lancer « Hackaiz: Scan this workspace ». Pour un dépôt regroupant plusieurs applications, choisir le sous-projet utile facilite la compréhension des fichiers proposés. Ce choix de périmètre ne dit rien de la sécurité des autres parties du dépôt.

L’examen du fichier courant suit un autre chemin : il lit le texte du document local actif dans l’éditeur. L’examen du dossier, lui, lit les fichiers sur le disque. Enregistrez donc les changements destinés à une analyse de dossier. Si vous examinez seulement un fichier, vérifiez l’onglet sélectionné et son emplacement. Un document sans nom ou une vue qui n’est pas un fichier local ne remplace pas un fichier source admissible. Cette vérification évite un résultat portant sur une version différente de celle que vous regardez.

02Comprendre les exclusions du collecteur

Le collecteur ignore notamment node_modules, .git, dist, build, coverage et .venv. Il filtre aussi les noms de fichiers secrets : variantes de .env, clés privées, conteneurs de certificats, .npmrc et .netrc. Les fichiers binaires, les fichiers JavaScript ou CSS minifiés et les cartes de sources générées sont écartés. Ces protections réduisent les envois inadaptés ; elles ne garantissent pas que toutes les autres sources sont dépourvues de données sensibles. Relisez le contenu dont vous autorisez la transmission.

Des limites portent également sur le nombre de fichiers, leur taille individuelle et le volume total. Un fichier écarté à cause de sa taille ou d’une limite reste hors de cette analyse. Installer les dépendances ne rend pas leur dossier admissible : un fichier de verrouillage peut décrire une bibliothèque alors que le contenu de node_modules demeure exclu. Les chemins ignorés sont une limite à consigner, pas une preuve d’absence de risque. Ne présentez donc pas le nombre de constats seul comme un bilan de tout le dépôt.

  1. 1Retirez du périmètre les éléments sans rapport avec votre examen.
  2. 2Lisez les informations d’envoi et les motifs d’exclusion.
  3. 3Préférez un dossier pertinent plus petit si la sélection initiale est trop large.

03Préparer séparément les accès du compte

La commande « Hackaiz: Connect personal key » associe l’extension à votre compte ; son libellé est actuellement en anglais. La clé reste dans le stockage sécurisé SecretStorage de VS Code et doit autoriser le lancement pour analyser. Ne créez pas un fichier .env contenant cette clé pour configurer l’extension. La commande « Hackaiz: Choose platform » renseigne hackaiz.projectId, l’identifiant de plateforme associé au travail. Ce réglage ne choisit pas les fichiers locaux et ne constitue pas un filtre de chemins.

Le choix d’une plateforme ne prouve pas non plus le contrôle d’un domaine. Pour analyser ensuite un site ou une API, effectuez la vérification dans Connecter : TXT DNS _hackaiz, fichier HTTPS /.well-known/hackaiz-verification.txt ou instruction demandant à l’IA du projet de créer ce fichier. Un dépôt ouvert et une plateforme sélectionnée apportent du contexte ; ils n’autorisent pas une cible non vérifiée et ne connectent pas une base de données absente.

04Confirmer un périmètre que vous pourrez expliquer

Chaque examen dans l’éditeur demande une confirmation et utilise les crédits du compte Hackaiz. Vérifiez l’envoi prévu, puis lisez le débit réel et l’état de fin du résultat. Si aucun fichier source lisible n’est disponible, regardez si le dossier ne contient que des éléments exclus ou si le document actif est inadmissible. Renommer une clé privée pour contourner le filtre n’est jamais une solution de dépannage. Choisissez plutôt le véritable fichier de code que vous souhaitez comprendre.

Conservez une note simple : dossier ou fichier examiné, sources enregistrées ou non, exclusions et traitement terminé ou incomplet. Lorsqu’une limite de temps interrompt l’examen, réduisez le périmètre au lieu de parler d’une analyse complète sans problème. Les constats peuvent ensuite être étudiés à leur emplacement dans le code. Préparer le dossier n’active aucune réparation automatique : l’extension ne modifie pas les fichiers, ne crée pas de commit et ne fusionne aucune proposition.

Questions fréquentes

Cet article vous a-t-il aidé ?

Articles liés