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.

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?

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.

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

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)

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

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

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.

• Gérer les requêtes - Les modèles de requêtes utilisent également la syntaxe @
• Gestion du contexte - Fichiers de contexte persistants