Passer au contenu principal
Afficher en Markdown

Références de fichiers

Les références de fichiers vous permettent d'inclure le contenu de fichiers ou des arborescences de répertoires directement dans vos messages de clavardage à l'aide de la syntaxe @path. Cela offre un contexte rapide sans copier manuellement le contenu, et comme le contenu est étendu en ligne avant l'envoi, cela évite les appels d'outils — ce qui économise des jetons.

Utilisation de base

Tapez @ suivi d'un chemin de fichier ou de répertoire :

@src/index.ts # Include file contents @src/ # Include directory tree @./relative/path # Relative paths @"path with spaces.txt" # Quoted paths (required for spaces)

Les références peuvent apparaître n'importe où dans votre message :

Review @src/auth.ts for security issues Compare @old.json with @new.json What's in @src/ that handles authentication?

Complétion par tabulation

Appuyez sur Tab après @ pour compléter automatiquement les chemins :

@src/<Tab> # Shows files in src/ @package<Tab> # Completes to @package.json @"Screenshot 2024<Tab> # Completes to @"Screenshot 2024-01.png"

La complétion fonctionne n'importe où dans la ligne de saisie. La complétion par tabulation ajoute automatiquement des guillemets lorsque cela est nécessaire pour les chemins contenant des espaces.

Comment les références sont résolues

Lorsqu'une référence pourrait correspondre à la fois à une requête et à un fichier :

  1. Requêtes d'abord : Si @name correspond à une requête de /prompts list, elle est traitée comme une requête
  2. Fichiers ensuite : Sinon, elle est vérifiée comme chemin de fichier
  3. Répertoires en troisième : Si ce n'est pas un fichier, elle est vérifiée comme répertoire

Pour forcer la résolution en fichier lorsqu'une requête porte le même nom, utilisez un chemin explicite : @./myfile

Gestion des fichiers

Prise en charge : Fichiers texte (code source, configuration, markdown) jusqu'à 250 Ko.

Non prise en charge : Les fichiers binaires (images, exécutables, archives) affichent une erreur.

Les fichiers volumineux sont tronqués à 250 Ko :

⚠ File 'large-file.json' was truncated (exceeds 250KB limit)

Arborescences de répertoires

Les références de répertoires s'étendent en une liste arborescente :

@src/

S'étend en :

src/ ├── lib/ │ ├── auth.ts │ └── utils.ts ├── index.ts └── config.json

Limites :

  • Profondeur maximale : 3 niveaux
  • Nombre maximal d'éléments par niveau : 10 (affiche « ... (N more items) » si dépassé)
  • Ignore les répertoires courants : node_modules, .git, target, dist, build

Exemples

Examiner un fichier :

> Review @src/auth.ts for security issues

Comparer des fichiers :

> What's different between @v1/handler.py and @v2/handler.py?

Explorer la structure :

> What's the structure of @infra/cdk/?

Contexte mixte :

> Using the config in @serverless.yml, update @src/lambda/index.ts

Dépannage

ProblèmeSolution
Référence traitée comme une requêteUne requête portant le même nom existe. Utilisez un chemin explicite : @./myfile
Fichier introuvableVérifiez que le chemin est relatif à votre répertoire actuel, ou utilisez un chemin absolu
Répertoire trop profondLes sous-répertoires au-delà de 3 niveaux ne sont pas affichés. Référencez un sous-répertoire spécifique : @src/deep/path/
Chemin avec espaces non reconnuUtilisez la syntaxe avec guillemets : @"path with spaces.txt"

Limitations actuelles

Les références de fichiers prennent actuellement en charge :

  • Les fichiers texte jusqu'à 250 Ko (les fichiers plus volumineux sont tronqués)
  • Les arborescences de répertoires jusqu'à 3 niveaux de profondeur, 10 éléments par niveau
  • Les chemins de fichiers explicites uniquement (pas de motifs génériques comme @*.ts)
  • Le contenu complet des fichiers (pas de plages de lignes comme @file.ts:10-20)
  • Les chemins relatifs et absolus (pas d'expansion du tilde comme @~/file)

Dans les sessions cloud, le sélecteur @ et la complétion par tabulation recherchent actuellement dans votre système de fichiers local, pas dans le bac à sable dans lequel la session s'exécute.

Les fichiers binaires (images, exécutables, archives) ne sont pas pris en charge.

Connexes

Page mise à jour : 19 août 2026