cx-viewer 1.0.0

package/concepts/fr/Tool-TaskStop.md

@@ -0,0 +1,32 @@
+# TaskStop
+
+## Définition
+
+Arrête une tâche en arrière-plan en cours d'exécution.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `task_id` | string | Non | ID de la tâche en arrière-plan à arrêter |
+| `shell_id` | string | Non | Obsolète, utiliser `task_id` à la place |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Terminer des tâches de longue durée qui ne sont plus nécessaires
+- Annuler des tâches en arrière-plan lancées par erreur
+
+## Notes
+
+- Renvoie un statut de succès ou d'échec
+- Le paramètre `shell_id` est obsolète, utiliser `task_id`
+
+## Texte original
+
+<textarea readonly>
+- Stops a running background task by its ID
+- Takes a task_id parameter identifying the task to stop
+- Returns a success or failure status
+- Use this tool when you need to terminate a long-running task
+</textarea>

package/concepts/fr/Tool-TaskUpdate.md

@@ -0,0 +1,123 @@
+# TaskUpdate
+
+## Définition
+
+Met à jour le statut, le contenu ou les relations de dépendance d'une tâche dans la liste de tâches.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `taskId` | string | Oui | ID de la tâche à mettre à jour |
+| `status` | enum | Non | Nouveau statut : `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Non | Nouveau titre |
+| `description` | string | Non | Nouvelle description |
+| `activeForm` | string | Non | Texte au participe présent affiché quand la tâche est en cours |
+| `owner` | string | Non | Nouveau responsable de la tâche (nom de l'agent) |
+| `metadata` | object | Non | Métadonnées à fusionner (définir à null pour supprimer une clé) |
+| `addBlocks` | string[] | Non | Liste des IDs de tâches bloquées par cette tâche |
+| `addBlockedBy` | string[] | Non | Liste des IDs de tâches préalables qui bloquent cette tâche |
+
+## Flux de statuts
+
+```
+pending → in_progress → completed
+```
+
+`deleted` peut être atteint depuis n'importe quel statut, supprime définitivement la tâche.
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Marquer une tâche comme `in_progress` au début du travail
+- Marquer une tâche comme `completed` à la fin du travail
+- Établir des relations de dépendance entre les tâches
+- Mettre à jour le contenu de la tâche quand les exigences changent
+
+**Règles importantes :**
+- Ne marquer comme `completed` que lorsque la tâche est entièrement terminée
+- Garder comme `in_progress` en cas d'erreurs ou de blocages
+- Ne pas marquer comme `completed` quand les tests échouent, l'implémentation est partielle ou des erreurs non résolues existent
+
+## Notes
+
+- Avant de mettre à jour, obtenir le statut le plus récent de la tâche via TaskGet pour éviter les données obsolètes
+- Après avoir terminé une tâche, appeler TaskList pour trouver la prochaine tâche disponible
+
+## Texte original
+
+<textarea readonly>Use this tool to update a task in the task list.
+
+## When to Use This Tool
+
+**Mark tasks as resolved:**
+- When you have completed the work described in a task
+- When a task is no longer needed or has been superseded
+- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
+- After resolving, call TaskList to find your next task
+
+- ONLY mark a task as completed when you have FULLY accomplished it
+- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
+- When blocked, create a new task describing what needs to be resolved
+- Never mark a task as completed if:
+  - Tests are failing
+  - Implementation is partial
+  - You encountered unresolved errors
+  - You couldn't find necessary files or dependencies
+
+**Delete tasks:**
+- When a task is no longer relevant or was created in error
+- Setting status to `deleted` permanently removes the task
+
+**Update task details:**
+- When requirements change or become clearer
+- When establishing dependencies between tasks
+
+## Fields You Can Update
+
+- **status**: The task status (see Status Workflow below)
+- **subject**: Change the task title (imperative form, e.g., "Run tests")
+- **description**: Change the task description
+- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
+- **owner**: Change the task owner (agent name)
+- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
+- **addBlocks**: Mark tasks that cannot start until this one completes
+- **addBlockedBy**: Mark tasks that must complete before this one can start
+
+## Status Workflow
+
+Status progresses: `pending` → `in_progress` → `completed`
+
+Use `deleted` to permanently remove a task.
+
+## Staleness
+
+Make sure to read a task's latest state using `TaskGet` before updating it.
+
+## Examples
+
+Mark task as in progress when starting work:
+```json
+{"taskId": "1", "status": "in_progress"}
+```
+
+Mark task as completed after finishing work:
+```json
+{"taskId": "1", "status": "completed"}
+```
+
+Delete a task:
+```json
+{"taskId": "1", "status": "deleted"}
+```
+
+Claim a task by setting owner:
+```json
+{"taskId": "1", "owner": "my-name"}
+```
+
+Set up task dependencies:
+```json
+{"taskId": "2", "addBlockedBy": ["1"]}
+```
+</textarea>

package/concepts/fr/Tool-TeamCreate.md

@@ -0,0 +1,38 @@
+# TeamCreate
+
+## Définition
+
+Crée une nouvelle équipe pour coordonner plusieurs agents travaillant sur un projet. Les équipes permettent l'exécution parallèle des tâches via une liste de tâches partagée et une messagerie inter-agents.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `team_name` | string | Oui | Nom de la nouvelle équipe |
+| `description` | string | Non | Description / objectif de l'équipe |
+| `agent_type` | string | Non | Type / rôle du responsable de l'équipe |
+
+## Ce qui est créé
+
+- **Fichier de configuration de l'équipe** : `~/.claude/teams/{team-name}/config.json` — stocke la liste des membres et les métadonnées
+- **Répertoire de liste de tâches** : `~/.claude/tasks/{team-name}/` — liste de tâches partagée pour tous les coéquipiers
+
+Les équipes ont une correspondance 1:1 avec les listes de tâches.
+
+## Flux de travail de l'équipe
+
+1. **TeamCreate** — créer l'équipe et sa liste de tâches
+2. **TaskCreate** — définir les tâches pour l'équipe
+3. **Agent** (avec `team_name` + `name`) — démarrer des coéquipiers qui rejoignent l'équipe
+4. **TaskUpdate** — attribuer des tâches aux coéquipiers via `owner`
+5. Les coéquipiers travaillent sur les tâches et communiquent via **SendMessage**
+6. Arrêter les coéquipiers une fois terminé, puis **TeamDelete** pour nettoyer
+
+## Outils associés
+
+| Outil | Rôle |
+|-------|------|
+| `TeamDelete` | Supprimer l'équipe et les répertoires de tâches |
+| `SendMessage` | Communication inter-agents au sein de l'équipe |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gérer la liste de tâches partagée |
+| `Agent` | Démarrer des coéquipiers qui rejoignent l'équipe |

package/concepts/fr/Tool-TeamDelete.md

@@ -0,0 +1,30 @@
+# TeamDelete
+
+## Définition
+
+Supprime une équipe et ses répertoires de tâches associés lorsque le travail de collaboration multi-agent est terminé. C'est le pendant de nettoyage de TeamCreate.
+
+## Comportement
+
+- Supprime le répertoire de l'équipe : `~/.claude/teams/{team-name}/`
+- Supprime le répertoire de liste de tâches : `~/.claude/tasks/{team-name}/`
+- Efface le contexte de l'équipe de la session courante
+
+**Important** : TeamDelete échouera si l'équipe a encore des membres actifs. Les coéquipiers doivent d'abord être arrêtés proprement via des demandes d'arrêt SendMessage.
+
+## Utilisation typique
+
+TeamDelete est appelé en fin de flux de travail d'équipe :
+
+1. Toutes les tâches sont terminées
+2. Les coéquipiers sont arrêtés via `SendMessage` avec `shutdown_request`
+3. **TeamDelete** supprime les répertoires de l'équipe et des tâches
+
+## Outils associés
+
+| Outil | Rôle |
+|-------|------|
+| `TeamCreate` | Créer une nouvelle équipe et sa liste de tâches |
+| `SendMessage` | Communiquer avec les coéquipiers / envoyer des demandes d'arrêt |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gérer la liste de tâches partagée |
+| `Agent` | Démarrer des coéquipiers qui rejoignent l'équipe |

package/concepts/fr/Tool-WebFetch.md

@@ -0,0 +1,55 @@
+# WebFetch
+
+## Définition
+
+Récupère le contenu d'une page web à partir d'une URL spécifiée, convertit le HTML en markdown et traite le contenu avec un modèle d'IA selon le prompt.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `url` | string (URI) | Oui | URL complète à récupérer |
+| `prompt` | string | Oui | Décrit quelles informations extraire de la page |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Récupérer le contenu de pages web publiques
+- Consulter la documentation en ligne
+- Extraire des informations spécifiques de pages web
+
+**Non adapté pour :**
+- URLs nécessitant une authentification (Google Docs, Confluence, Jira, GitHub, etc.) — chercher d'abord des outils MCP dédiés
+- URLs GitHub — préférer utiliser le CLI `gh`
+
+## Notes
+
+- L'URL doit être une URL valide complète
+- HTTP est automatiquement mis à niveau vers HTTPS
+- Les résultats peuvent être résumés si le contenu est trop volumineux
+- Inclut un cache auto-nettoyant de 15 minutes
+- Quand l'URL redirige vers un hôte différent, l'outil renvoie l'URL de redirection et il faut refaire la requête avec la nouvelle URL
+- Si un outil web fetch fourni par MCP est disponible, préférer l'utiliser
+
+## Texte original
+
+<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
+
+- Fetches content from a specified URL and processes it using an AI model
+- Takes a URL and a prompt as input
+- Fetches the URL content, converts HTML to markdown
+- Processes the content with the prompt using a small, fast model
+- Returns the model's response about the content
+- Use this tool when you need to retrieve and analyze web content
+
+Usage notes:
+  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
+  - The URL must be a fully-formed valid URL
+  - HTTP URLs will be automatically upgraded to HTTPS
+  - The prompt should describe what information you want to extract from the page
+  - This tool is read-only and does not modify any files
+  - Results may be summarized if the content is very large
+  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
+  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
+  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
+</textarea>

package/concepts/fr/Tool-WebSearch.md

@@ -0,0 +1,58 @@
+# WebSearch
+
+## Définition
+
+Exécute des requêtes sur les moteurs de recherche et renvoie des résultats de recherche pour obtenir des informations à jour.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `query` | string | Oui | Requête de recherche (minimum 2 caractères) |
+| `allowed_domains` | string[] | Non | N'inclure que les résultats de ces domaines |
+| `blocked_domains` | string[] | Non | Exclure les résultats de ces domaines |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Obtenir des informations à jour au-delà de la date de coupure des connaissances du modèle
+- Rechercher des événements actuels et des données récentes
+- Rechercher la documentation technique la plus récente
+
+## Notes
+
+- Les résultats de recherche sont renvoyés au format d'hyperliens markdown
+- Après utilisation, une section « Sources: » doit être incluse à la fin de la réponse, listant les URLs pertinentes
+- Supporte le filtrage de domaines (inclusion/exclusion)
+- L'année en cours doit être utilisée dans les requêtes de recherche
+- Disponible uniquement aux États-Unis
+
+## Texte original
+
+<textarea readonly>
+- Allows Claude to search the web and use the results to inform responses
+- Provides up-to-date information for current events and recent data
+- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
+- Use this tool for accessing information beyond Claude's knowledge cutoff
+- Searches are performed automatically within a single API call
+
+CRITICAL REQUIREMENT - You MUST follow this:
+  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
+  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
+  - This is MANDATORY - never skip including sources in your response
+  - Example format:
+
+    [Your answer here]
+
+    Sources:
+    - [Source Title 1](https://example.com/1)
+    - [Source Title 2](https://example.com/2)
+
+Usage notes:
+  - Domain filtering is supported to include or block specific websites
+  - Web search is only available in the US
+
+IMPORTANT - Use the correct year in search queries:
+  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
+  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
+</textarea>

package/concepts/fr/Tool-Write.md

@@ -0,0 +1,39 @@
+# Write
+
+## Définition
+
+Écrit du contenu dans le système de fichiers local. Si le fichier existe déjà, il est écrasé.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `file_path` | string | Oui | Chemin absolu du fichier (doit être un chemin absolu) |
+| `content` | string | Oui | Contenu à écrire |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Créer de nouveaux fichiers
+- Quand il faut réécrire complètement le contenu d'un fichier
+
+**Non adapté pour :**
+- Modifier du contenu partiel d'un fichier — utiliser Edit
+- Ne pas créer proactivement des fichiers de documentation (*.md) ou README, sauf si l'utilisateur le demande explicitement
+
+## Notes
+
+- Si le fichier cible existe déjà, il doit d'abord être lu avec Read, sinon l'opération échouera
+- Écrase tout le contenu du fichier existant
+- Préférer Edit pour éditer des fichiers existants, Write uniquement pour créer de nouveaux fichiers ou des réécritures complètes
+
+## Texte original
+
+<textarea readonly>Writes a file to the local filesystem.
+
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
+- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
+- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
+- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>

package/concepts/fr/Tool-executeCode.md

@@ -0,0 +1,41 @@
+# executeCode (mcp__ide__executeCode)
+
+## Définition
+
+Exécute du code Python dans le kernel Jupyter du fichier notebook actuel.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `code` | string | Oui | Code Python à exécuter |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Exécuter du code dans un environnement Jupyter notebook
+- Tester des extraits de code
+- Analyse de données et calculs
+
+**Non adapté pour :**
+- Exécution de code hors environnement Jupyter — utiliser Bash
+- Modifier des fichiers — utiliser Edit ou Write
+
+## Notes
+
+- C'est un outil MCP (Model Context Protocol), fourni par l'intégration IDE
+- Le code s'exécute dans le kernel Jupyter actuel, l'état persiste entre les appels
+- Sauf demande explicite de l'utilisateur, éviter de déclarer des variables ou de modifier l'état du kernel
+- L'état est perdu au redémarrage du kernel
+
+## Texte original
+
+<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
+    
+    All code will be executed in the current Jupyter kernel.
+    
+    Avoid declaring variables or modifying the state of the kernel unless the user
+    explicitly asks for it.
+    
+    Any code executed will persist across calls to this tool, unless the kernel
+    has been restarted.</textarea>

package/concepts/fr/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Définition
+
+Obtient les informations de diagnostic du langage depuis VS Code, incluant les erreurs de syntaxe, erreurs de type, avertissements de lint, etc.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `uri` | string | Non | URI du fichier. Si non fourni, obtient les informations de diagnostic de tous les fichiers |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Vérifier les problèmes sémantiques de syntaxe, types, lint, etc. du code
+- Vérifier si de nouvelles erreurs ont été introduites après l'édition du code
+- Remplacer les commandes Bash pour vérifier la qualité du code
+
+**Non adapté pour :**
+- Exécuter des tests — utiliser Bash
+- Vérifier les erreurs d'exécution — utiliser Bash pour exécuter le code
+
+## Notes
+
+- C'est un outil MCP (Model Context Protocol), fourni par l'intégration IDE
+- Disponible uniquement dans les environnements VS Code / IDE
+- Préférer cet outil aux commandes Bash pour vérifier les problèmes de code
+
+## Texte original
+
+<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/fr/Tools.md

@@ -0,0 +1,67 @@
+# Vue d'ensemble des outils Claude Code
+
+Claude Code fournit au modèle un ensemble d'outils intégrés via le mécanisme tool_use de l'API Anthropic. Chaque requête MainAgent inclut les définitions complètes en JSON Schema de ces outils dans le tableau `tools`, et le modèle les invoque via des content blocks `tool_use` dans la réponse.
+
+Voici l'index classifié de tous les outils.
+
+## Système d'Agents
+
+| Outil | Utilité |
+|-------|---------|
+| [Task](Tool-Task.md) | Lancer un sous-agent (SubAgent) pour gérer des tâches complexes multi-étapes |
+| [TaskOutput](Tool-TaskOutput.md) | Obtenir la sortie des tâches en arrière-plan |
+| [TaskStop](Tool-TaskStop.md) | Arrêter une tâche en arrière-plan en cours d'exécution |
+| [TaskCreate](Tool-TaskCreate.md) | Créer une entrée dans la liste de tâches structurée |
+| [TaskGet](Tool-TaskGet.md) | Obtenir les détails d'une tâche |
+| [TaskUpdate](Tool-TaskUpdate.md) | Mettre à jour le statut, les dépendances, etc. d'une tâche |
+| [TaskList](Tool-TaskList.md) | Lister toutes les tâches |
+
+## Opérations sur les fichiers
+
+| Outil | Utilité |
+|-------|---------|
+| [Read](Tool-Read.md) | Lire le contenu de fichiers (supporte texte, images, PDF, Jupyter notebook) |
+| [Edit](Tool-Edit.md) | Éditer des fichiers par remplacement exact de chaînes |
+| [Write](Tool-Write.md) | Écrire ou écraser des fichiers |
+| [NotebookEdit](Tool-NotebookEdit.md) | Éditer des cellules de Jupyter notebook |
+
+## Recherche
+
+| Outil | Utilité |
+|-------|---------|
+| [Glob](Tool-Glob.md) | Rechercher des fichiers par correspondance de motifs de noms |
+| [Grep](Tool-Grep.md) | Recherche de contenu de fichiers basée sur ripgrep |
+
+## Terminal
+
+| Outil | Utilité |
+|-------|---------|
+| [Bash](Tool-Bash.md) | Exécuter des commandes shell |
+
+## Web
+
+| Outil | Utilité |
+|-------|---------|
+| [WebFetch](Tool-WebFetch.md) | Récupérer du contenu web et le traiter avec l'IA |
+| [WebSearch](Tool-WebSearch.md) | Requêtes sur les moteurs de recherche |
+
+## Planification et interaction
+
+| Outil | Utilité |
+|-------|---------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Entrer en mode planification pour concevoir un plan d'implémentation |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Quitter le mode planification et soumettre le plan pour approbation de l'utilisateur |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Poser des questions à l'utilisateur pour obtenir des clarifications ou des décisions |
+
+## Extensions
+
+| Outil | Utilité |
+|-------|---------|
+| [Skill](Tool-Skill.md) | Exécuter une compétence (slash command) |
+
+## Intégration IDE
+
+| Outil | Utilité |
+|-------|---------|
+| [getDiagnostics](Tool-getDiagnostics.md) | Obtenir les informations de diagnostic du langage de VS Code |
+| [executeCode](Tool-executeCode.md) | Exécuter du code dans le kernel Jupyter |

package/concepts/fr/ToolsFirst.md

@@ -0,0 +1,77 @@
+# Pourquoi les Tools sont-ils listés en premier ?
+
+Dans le panneau Context de cc-viewer, **les Tools apparaissent avant le System Prompt et les Messages**. Cet ordre reflète précisément la **séquence de préfixe KV-Cache de l'API Anthropic**.
+
+## Séquence de préfixe KV-Cache
+
+Lorsque l'API Anthropic construit le KV-Cache, elle concatène le contexte en un préfixe dans cet **ordre fixe** :
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Cela signifie que **les Tools se trouvent avant le System Prompt, tout au début du préfixe de cache**.
+
+## Pourquoi les Tools ont-ils un poids de cache supérieur à System ?
+
+Dans la correspondance de préfixe KV-Cache, **le contenu en début de séquence est plus critique** — toute modification invalide tout ce qui suit :
+
+1. **La correspondance de préfixe commence par le début** : Le KV-Cache compare la requête actuelle au préfixe mis en cache token par token depuis le début. Dès qu'une divergence est détectée, tout le contenu suivant est invalidé.
+
+2. **Modification des Tools = tout le cache invalidé** : Les Tools étant en première position, toute modification des définitions de tool (même l'ajout ou la suppression d'un seul MCP tool) **brise le préfixe dès le tout début**, invalidant tous les System Prompt et Messages mis en cache.
+
+3. **Modification de System = cache des Messages invalidé** : Le System Prompt se trouve au milieu, donc ses modifications n'invalident que la portion Messages qui suit.
+
+4. **Modification des Messages = seule la fin est affectée** : Les Messages sont à la fin, donc l'ajout de nouveaux messages n'invalide qu'un petit segment final — les caches Tools et System restent intacts.
+
+## Impact pratique
+
+| Type de modification | Impact sur le cache | Scénario typique |
+|-------------|-------------|-----------------|
+| Tool ajouté/supprimé | **Invalidation complète** | Connexion/déconnexion d'un serveur MCP, activation/désactivation d'un plugin IDE |
+| Modification du System Prompt | Cache des Messages perdu | Édition de CLAUDE.md, injection de system reminder |
+| Nouveau message ajouté | Incrément de queue uniquement | Flux de conversation normal (le plus fréquent, le moins coûteux) |
+
+C'est pourquoi `tools_change` dans [CacheRebuild](CacheRebuild.md) tend à être la raison de reconstruction la plus coûteuse — elle brise la chaîne de préfixe dès le tout début.
+
+## Pourquoi les définitions d'outils sont-elles placées avant le « cerveau » ?
+
+Du point de vue du cache, le fait que les Tools soient en premier est un fait technique. Mais du point de vue de la conception cognitive, cet ordre est tout aussi logique — **les Tools sont les mains et les pieds, le System Prompt est le cerveau**.
+
+Avant d'agir, une personne doit percevoir quels membres et outils sont à sa disposition. Un nourrisson ne comprend pas d'abord les règles du monde (System) avant d'apprendre à saisir — il perçoit d'abord qu'il a des mains et des pieds, puis comprend progressivement les règles par l'interaction avec son environnement. De même, un LLM doit savoir quels outils il peut appeler (lire des fichiers, écrire du code, rechercher, exécuter des commandes) avant de recevoir les instructions de tâche (System Prompt), afin de pouvoir évaluer précisément « que puis-je faire » et « comment dois-je procéder » lors du traitement des instructions.
+
+Si l'ordre était inversé — dire d'abord au modèle « ta tâche est de refactoriser ce module », puis lui dire « tu disposes des outils Read, Edit, Bash » — le modèle manquerait d'informations cruciales sur les limites de ses capacités lors de la compréhension de la tâche, produisant potentiellement des plans irréalistes ou omettant des approches disponibles.
+
+**Connaître ses cartes avant de décider comment jouer.** Voilà la logique cognitive derrière le placement des Tools avant le System.
+
+## Pourquoi les outils MCP sont-ils aussi à cette position ?
+
+Les outils MCP (Model Context Protocol), comme les outils intégrés, sont placés tout au début de la zone Tools. Comprendre la position de MCP dans le contexte aide à évaluer ses véritables avantages et coûts.
+
+### Avantages de MCP
+
+- **Extension des capacités** : MCP permet aux modèles d'accéder à des services externes (requêtes base de données, appels API, opérations IDE, contrôle de navigateur, etc.), dépassant les limites des outils intégrés
+- **Écosystème ouvert** : N'importe qui peut implémenter un serveur MCP ; le modèle acquiert de nouvelles capacités sans réentraînement
+- **Chargement à la demande** : Les serveurs MCP peuvent être connectés/déconnectés sélectivement selon le scénario, composant des ensembles d'outils flexibles
+
+### Coûts de MCP
+
+- **Tueur de cache** : La définition JSON Schema de chaque outil MCP est concaténée au tout début du préfixe KV-Cache. Ajouter ou supprimer un seul outil MCP = **tout le cache est invalidé depuis le début**. Connecter/déconnecter fréquemment des serveurs MCP réduit considérablement le taux de succès du cache
+- **Gonflement du préfixe** : Les Schemas des outils MCP sont généralement plus volumineux que ceux des outils intégrés (descriptions détaillées des paramètres, énumérations, etc.). De nombreux outils MCP augmentent significativement le nombre de tokens de la zone Tools, réduisant l'espace de contexte disponible pour les Messages
+- **Surcoût de latence** : Les appels d'outils MCP nécessitent une communication inter-processus (JSON-RPC via stdio/SSE), un ordre de grandeur plus lent que les appels de fonctions intégrées
+- **Risque de stabilité** : Les serveurs MCP sont des processus externes qui peuvent planter, expirer ou retourner des formats inattendus, nécessitant une gestion d'erreurs supplémentaire
+
+### Recommandations pratiques
+
+| Scénario | Recommandation |
+|----------|---------------|
+| Conversations longues, interactions fréquentes | Minimiser le nombre d'outils MCP pour protéger la stabilité du préfixe de cache |
+| Tâches courtes, opérations ponctuelles | Utiliser librement les outils MCP ; l'impact sur le cache est limité |
+| Ajout/suppression fréquent de serveurs MCP | Chaque changement déclenche une reconstruction complète du cache ; envisager de fixer l'ensemble d'outils |
+| Schemas d'outils surdimensionnés | Réduire les descriptions et énumérations pour diminuer l'empreinte en tokens du préfixe |
+
+Dans le panneau Context de cc-viewer, les outils MCP sont affichés aux côtés des outils intégrés dans la zone Tools, offrant une vue claire de la taille du Schema de chaque outil et de sa contribution au préfixe de cache.

package/concepts/fr/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# Pollution de contexte de l'API de traduction
+
+## Contexte
+
+CC-Viewer intègre une fonctionnalité de traduction (`POST /api/translate`) alimentée par l'API Messages d'Anthropic. Dans l'implémentation initiale, les requêtes de traduction réutilisaient les identifiants d'authentification mis en cache de la session Claude Code — incluant les en-têtes `x-api-key` et `authorization`. Cela a provoqué un problème subtil mais grave : les résultats de traduction renvoyaient fréquemment du contenu sans rapport.
+
+## Cause profonde
+
+### Différence fondamentale entre les deux méthodes d'authentification
+
+L'API Anthropic prend en charge deux méthodes d'authentification :
+
+| Méthode | En-tête | Source typique | Caractéristiques |
+|---------|---------|----------------|------------------|
+| Clé API | `x-api-key: sk-ant-...` | Variable d'environnement / Console | Sans état, chaque requête est indépendante |
+| Jeton OAuth | `authorization: Bearer sessionToken` | Connexion par abonnement Claude Code | Lié à la session, le serveur maintient l'association de contexte |
+
+La différence clé : **les clés API sont sans état** — chaque requête est complètement indépendante ; tandis que **les jetons de session OAuth sont avec état** — le serveur Anthropic associe les requêtes utilisant le même jeton au même contexte de session.
+
+### Chaîne de pollution
+
+Lorsque Claude Code utilise la connexion OAuth par abonnement, le flux d'authentification se présente ainsi :
+
+```
+Conversation principale Claude Code ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                                ↑
+Requête de traduction CC-Viewer ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+Étant donné que les requêtes de traduction réutilisaient le même jeton de session, le serveur Anthropic pouvait associer les requêtes de traduction au contexte de la conversation principale de Claude Code. Cela entraîne :
+
+1. **Les résultats de traduction sont influencés par le contexte de la conversation principale** : Le prompt système de la requête de traduction est « vous êtes un traducteur », mais le contexte serveur contient toujours l'historique de conversation de Claude Code, ce qui peut interférer avec le modèle
+2. **La conversation principale est perturbée par les requêtes de traduction** : Le contenu des requêtes de traduction (fragments de texte d'interface) peut être injecté dans le contexte de la conversation principale, provoquant des déviations dans les réponses de Claude Code
+3. **Comportement imprévisible** : La pollution de contexte étant un comportement côté serveur, le client ne peut ni la détecter ni la contrôler
+
+## Leçons retenues
+
+- **Les jetons de session OAuth ne sont pas « juste une autre clé API »** — ils portent un état côté serveur, les réutiliser signifie partager le contexte
+- **Les appels de services internes doivent utiliser une authentification indépendante et sans état** pour éviter toute association avec les sessions utilisateur
+
+## Références
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)