DeepSeek-TUI/README.fr.md

Codewhale

Un agent de programmation open source pour votre terminal — apportez votre propre modèle.

Codewhale a commencé comme une expérience native pour DeepSeek. Il est depuis devenu un projet porté par la communauté : un harness de programmation qui convient à une communauté internationale en croissance et prend en charge autant de modèles et de fournisseurs que possible — les modèles ouverts d'abord, hébergés ou locaux, sans en privilégier aucun.

Donnez-lui un fournisseur, un modèle et une tâche. Il lit votre code, modifie des fichiers, exécute des commandes et vérifie son propre travail, puis s'arrête quand la tâche est terminée ou qu'il a besoin de vous. Changez de modèle en cours de tâche avec /model. Travaillez de façon interactive dans la TUI, ou lancez codewhale exec dans des scripts et en CI. Écrit en Rust, sous licence MIT, il tourne sur votre machine.

Ce qui ne ressemble pas aux autres harnesses : vous choisissez le modèle de chaque rôle, et ils n'ont pas à correspondre. Une fleet fige un fournisseur, un modèle et un niveau de raisonnement par rôle — ainsi un modèle rapide et bon marché peut diriger un modèle de raisonnement coûteux, ou un builder GLM peut travailler sur la même tâche qu'un reviewer Kimi. Écrivez vos propres rôles et votre propre constitution, et le harness devient le vôtre plutôt que le nôtre.

Nous cherchons toujours des contributeurs et des façons de nous améliorer. Si un modèle ou un fournisseur que vous utilisez manque, ou si quelque chose casse, nous le dire est l'une des choses les plus utiles que vous puissiez faire — voir Contribuer.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català · codewhale.net · Docs · Changelog · Discord

Installation

npm install -g codewhale

Cargo, Docker, Nix, Scoop, les archives précompilées, Android/Termux et un miroir CNB pour ceux qui n'atteignent pas GitHub sont documentés dans docs/INSTALL.md. Vous venez de deepseek-tui ? Votre configuration et vos sessions sont reprises — voir docs/REBRAND.md.

Utilisation

codewhale auth set --provider deepseek   # or export ANTHROPIC_API_KEY, etc.
codewhale                                # open the TUI
codewhale exec "fix the failing test"    # headless
codewhale web                            # local browser client on 127.0.0.1

Dans la TUI : /model change fournisseur et modèle ensemble, /fleet constitue et lance l'équipe — un rôle à la fois, chacun avec son propre modèle —, /undo annule le dernier tour, et /restore <N> ramène l'espace de travail à un instantané antérieur (/restore seul les liste). Tab fait défiler Plan / Work / Operate quand le compositeur est vide — s'il contient du texte, Tab complète les commandes slash et les mentions @. Shift+Tab fait défiler à tout moment la posture de permission Ask / Auto-Review / Full Access. ! exécute une commande shell par le chemin d'approbation habituel.

Ce qu'il fait

• N'importe quel modèle, n'importe quel fournisseur — et n'importe quel mélange. DeepSeek, Claude, GPT, Kimi, GLM et plus de 30 fournisseurs, plus votre propre vLLM, SGLang ou Ollama sans clé, le tout via un seul runtime et un seul jeu d'outils. Le catalogue suit la gamme en direct de chaque fournisseur — le backend V4 Pro de DeepSeek (libellé DeepSeek-V4-Pro-0813) reste appelable en deepseek-v4-pro, Grok 4.6 est le défaut xAI direct, et OrcaRouter route via orcarouter/auto. Un rôle enregistré consigne explicitement son provider, son model et son niveau de raisonnement, donc une fleet peut traverser plusieurs éditeurs dans une même exécution, et la route d'un rôle ne dépend jamais du fournisseur qui se trouve actif. Limites de contexte et prix viennent de la vraie route ; un prix inconnu s'affiche comme inconnu, pas comme 0 $.
• Un harness que vous rédigez. Les rôles sont des fichiers que vous pouvez lire et modifier — un modèle, une posture d'outils et des consignes permanentes par rôle — gardés dans le projet pour que l'équipe les partage, ou à côté de vos autres réglages personnels pour qu'ils vous suivent d'un dépôt à l'autre. Une constitution consigne comment vous voulez que l'agent se comporte d'une session à l'autre, pour que le harness suive votre pratique plutôt que la nôtre.
• Lecture seule jusqu'à ce que vous autorisiez davantage. Le mode Plan ne peut pas modifier de fichiers, et les approbations filtrent les commandes risquées. Quand un sandbox OS enveloppe réellement une commande, Codewhale le dit : Seatbelt sur macOS lorsqu'il est disponible, bubblewrap en option sur Linux. Le constitution.json d'un dépôt se compile en verrous d'écriture que même Full Access ne peut contourner.
• Un travail que vous pouvez reprendre. Une fleet consigne chaque étape dans un registre en ajout seul, donc fleet resume reprend là où vous vous étiez arrêté.

Intégrations

• DeepSeek Harness (dsh) — connecté via Codewhale. codewhale integrations dsh connect relie une installation existante de @deepseek-ai/dsh à votre route de fournisseur Codewhale, vos permissions et votre espace de travail, et integrations dsh install-bundle ajoute le bundle de plugins DSH optionnel pour que dsh --profile codewhale porte cette identité tout seul. Codewhale détient les permissions et l'autorité de cycle de vie ; dsh garde ses propres sessions, profils et identifiants intacts. Voir docs/INTEGRATIONS_DSH.md.
• VS Code. Le scaffold officiel de l'extension (extensions/vscode) ouvre Codewhale dans un terminal intégré et expose une Agent View en lecture seule sur le runtime local. C'est une préversion de développement local, pas encore une publication marketplace.

En savoir plus

• docs/PROVIDERS.md — chaque route de fournisseur : hébergée, passerelle et locale
• docs/FLEET.md — les fleets, le registre et la reprise
• docs/WORKFLOW_EXPERIMENTAL_SEARCH.md — recherche expérimentale figée et neutre vis-à-vis des fournisseurs dans Workflow
• docs/CONFIGURATION.md — config.toml, les hooks et la constitution
• docs/AUTHORIZATION_ORDER.md — comment modes, hooks, règles de permission, planchers de sécurité, loi du dépôt, approbations et sandbox se composent
• docs/HOOKS.md — les onze événements de hook du cycle de vie TUI, leurs payloads, et lesquels parmi trois peuvent orienter un tour (codewhale exec et les sous-commandes CLI ne déclenchent pas de hooks)
• docs/WEB.md — le client navigateur en loopback uniquement et sa frontière d'authentification à usage unique

Tout le reste — modes, raccourcis, détails du sandbox, MCP, l'API runtime et l'architecture — vit dans docs et sur codewhale.net.

Contribuer

Issues, PR, étapes de reproduction, journaux et demandes de fonctionnalités sont tous du vrai travail de projet, et les premières contributions sont les bienvenues. Quand une PR ne peut pas être fusionnée telle quelle, les mainteneurs récoltent ce qui fonctionne et gardent l'auteur crédité — dans le commit, le changelog et docs/CONTRIBUTORS.md.

• Issues ouvertes — les bonnes premières contributions sont ici
• CONTRIBUTING.md — installation de dev et flux de PR
• docs/CONTRIBUTORS.md — toutes celles et ceux qui ont façonné le projet
• Offrez-moi un café

Merci à DeepSeek pour les modèles et le soutien qui ont lancé le projet, à DataWhale 🐋 de nous avoir accueillis dans la famille Whale Brother, et à OpenWarp et Open Design pour la collaboration sur l'expérience d'agent dans le terminal.

Licence

MIT. Projet communautaire indépendant, non affilié à aucun fournisseur de modèles.