Guide · Mis à jour le 10 novembre 2026 · Par Cameron Voss et West Mao

DeepSeek SuperAgent sous Windows : configuration WSL vs Windows native (novembre 2026)

Choisissez un itinéraire Windows, comprenez les limites et vérifiez votre environnement avant l'installation.

Réponse rapide

Pour une machine Windows, WSL 2 donne au prototype un environnement Linux plus proche de la configuration orientée Unix publiée. Windows natif présente des problèmes de compatibilité signalés par la communauté ; les ports tiers sont des projets distincts. WSL contribue à la compatibilité, mais il ne constitue pas une limite de sécurité pour le travail d'agent non fiable.

DeepSeek SuperAgent est un prototype de recherche construit sur DeepSeek Harness, et non un produit DeepSeek officiel ou un logiciel prêt pour la production. Il nécessite un fournisseur de modèles configuré séparément. Ce guide suit la documentation publiée ; nous n'avons pas exécuté de déploiement de bout en bout pour cet article.

DeepSeek Harness exécuté sous Windows n'établit pas en soi que tous les scripts de service SuperAgent et flux de travail s'y exécutent. Choisissez l'environnement pour l'ensemble du flux de travail : installation, informations d'identification GitHub, arborescences de travail par ticket, supervision et révision du service.

Devriez-vous choisir WSL 2, Windows natif ou un hôte Linux distinct ?

Route	Ce qu'il offre	Ce qu'il faut vérifier
WSL 2	Outils Linux et système de fichiers sur une machine Windows ; plus proche du workflow tmux et Python publié.	Les montages Windows, l'interopérabilité, les informations d'identification et la mise en réseau peuvent toujours exposer les ressources de l'hôte. Nous n'avons pas testé ce déploiement de bout en bout.
Windows natif	Outils natifs Windows et flux de travail de bureau.	Les rapports de la communauté décrivent les problèmes de script de service, de chemin et d'outil de travail dans des versions particulières. Ne présumez pas qu'une configuration corrigée s'applique à votre version.
Hôte Linux ou VM séparé	Un endroit plus distinct pour gérer le runtime et les informations d'identification.	L'isolement dépend de la configuration de la VM, des dossiers partagés, de l'accès au réseau et des informations d'identification. Une VM n'est pas automatiquement sécurisée.

Pourquoi la configuration d'origine est-elle délicate sur Windows natif ?

Le workflow du service publié utilise Python et tmux. Un utilisateur Windows a signalé que le script de service importe le module Unix uniquement fcntl, que certaines validations de répertoire rejetaient les chemins de lettre de lecteur Windows et que les sessions de travail ne disposaient pas des outils attendus dans leur configuration particulière. Ce rapport utilisait Windows 11 et DSH CLI 0.2.1-rc.3 ; cela ne prouve pas que chaque version présente les mêmes échecs ou que ses correctifs locaux sont des correctifs maintenus.

Les ports et wrappers Windows communautaires peuvent modifier ces hypothèses. Traitez-les comme des implémentations tierces, examinez leur code et leurs autorisations, et vérifiez leur version et leur état de maintenance avant de les exécuter. Nous n'avons pas testé de manière indépendante un port natif pour ce guide.

Comment préparer WSL 2 ?

Sur une installation Windows prise en charge, ouvrez PowerShell en tant qu'administrateur et utilisez la commande d'installation de Microsoft :

wsl --install

Terminez tout redémarrage demandé et terminez la création de l'utilisateur Linux. Depuis PowerShell, wsl --list --verbose affiche les distributions installées et leur version WSL. Si WSL est déjà installé, inspectez d'abord son état actuel plutôt que de supposer que la commande crée un nouvel environnement isolé.

Dans la distribution Linux, utilisez les versions Linux de Node.js, pnpm, Git, Python, tmux, la CLI GitHub et DeepSeek Harness. Conservez le clone fonctionnel sur le système de fichiers Linux lors de l'exécution des outils Linux ; l'accès entre systèmes de fichiers peut être plus lent. Ne placez pas de jetons personnels ou de secrets de production dans le répertoire personnel de l'utilisateur du service.

Comment séparer l'hôte Windows et les données de test ?

WSL peut interagir avec Windows et accéder aux lecteurs Windows montés. Un nom d'utilisateur Linux distinct ou un référentiel sous le répertoire personnel Linux réduit les mélanges accidentels mais n'arrête pas, à lui seul, l'accès à l'hôte. Pour le code non fiable, utilisez un environnement géré séparément avec une isolation délibérée, une mise en réseau limitée et des informations d'identification pouvant être révoquées en toute sécurité. Vérifiez tous les dossiers partagés et les montages avant d'accorder l'accès à un travailleur.

Dans cet environnement, créez un utilisateur GitHub dédié pour l'agent et une configuration CLI distincte. Commencez avec un référentiel de test, un demandeur autorisé et une protection de branche. Le travailleur s'exécute avec les autorisations du système d'exploitation de l'utilisateur du service. L'accès doit donc également être limité au niveau du système d'exploitation et de l'infrastructure.

Quelle est la séquence de configuration WSL ?

Ouvrez le shell Linux et vérifiez node -v, pnpm -v, git --version, python3 --version, tmux -V, gh --version et dsh --version.
Vérifiez les prérequis actuels du prototype et la gamme de versions du harnais. Configurez un fournisseur de modèles et un compte CLI GitHub d'agent dédié dans l'environnement.
Clonez et créez le prototype, créez le profil dédié pour une nouvelle installation et installez le bundle. N'exécutez pas la commande profile-creation sur un profil existant car elle remplace sa configuration.
Configurez le panneau local, GitHub Source, la préparation autorisée de l'arbre de travail du demandeur et de l'exécuteur. Commencez par observe pour les candidats déduits, avec l'examen humain et la fusion automatique désactivés.
Vérifiez scripts/dsh-superagent status, puis utilisez une petite requête explicite dans le référentiel de test. Les requêtes explicites peuvent s'exécuter en mode observation.

Pour le flux complet de problème à examiner, utilisez le guide de configuration et de coûts du SuperAgent existant. Une vérification de dépendance réussie n’est qu’un point de départ ; vérifiez séparément la création du ticket, l'espace de travail, les autorisations et la différence résultante.

Que devez-vous vérifier en cas d'échec ?

Symptôme	Ce qu'il faut inspecter
Erreur `tmux` ou Python	Confirmez que vous exécutez le script de service Linux dans WSL, avec les outils Linux requis installés.
Pas de GitHub réponse	Vérifiez la connexion du wrapper de l'agent, l'accès au référentiel, le demandeur autorisé et l'état de la source.
Le ticket ne peut pas préparer l'extraction	Vérifiez que le chemin de clonage Linux existe et que la commande de préparation utilise le système de fichiers et les informations d'identification corrects.
Le travailleur ne dispose pas des outils attendus	Enregistrez les versions DSH et bundle et inspectez le préréglage du travailleur. Un rapport Windows a observé cela dans une version ; ce n'est pas un diagnostic universel.
Le panneau ne peut pas atteindre le service	Vérifiez si le processus est en cours d'exécution et où le panneau est lié. Évitez d'exposer un panneau de gestion local à un réseau sans contrôles appropriés.

Questions fréquemment posées

WSL est-il un bac à sable ?

Non. WSL et Windows peuvent interagir ; configurez une véritable isolation séparément pour les travaux non fiables.

Ce guide prouve-t-il la prise en charge native de Windows ?

Non. Il décrit les exigences publiées et les rapports de communauté individuels, et non un test Windows natif de bout en bout.

Puis-je utiliser mon compte GitHub quotidien en tant qu'agent ?

Le projet recommande un compte d'agent dédié. Séparez-le de votre identité normale et accordez uniquement l'accès nécessaire au test.

Voir les tarifs des Coding Plans