Gids · Bijgewerkt op 10 november 2026 · Door Cameron Voss en West Mao
DeepSeek SuperAgent op Windows: WSL versus systeemeigen Windows-installatie (november 2026)
Kies een Windows-route, begrijp de limieten en controleer uw omgeving voordat u installeert.
Voor een Windows-machine geeft WSL 2 het prototype een Linux-omgeving die dichter bij de gepubliceerde Unix-georiënteerde opstelling ligt. Native Windows heeft door de community gemelde compatibiliteitsproblemen; poorten van derden zijn afzonderlijke projecten. WSL helpt bij de compatibiliteit, maar vormt geen veiligheidsgrens voor het werk van niet-vertrouwde agenten.
DeepSeek SuperAgent is een onderzoeksprototype gebouwd op DeepSeek Harness, geen officieel DeepSeek-product of productieklare software. Er is een afzonderlijk geconfigureerde modelprovider nodig. Deze handleiding volgt de gepubliceerde documentatie; we hebben voor dit artikel geen end-to-end implementatie uitgevoerd.
DeepSeek Harness die op Windows draait, zorgt er op zichzelf niet voor dat elk SuperAgent-servicescript en alle werkstromen daar worden uitgevoerd. Kies de omgeving voor de hele workflow: installatie, GitHub-inloggegevens, werkbomen per ticket, servicetoezicht en -beoordeling.
Moet je kiezen voor WSL 2, native Windows of een aparte Linux-host?
| Route | Wat het biedt | Wat te controleren |
|---|---|---|
| WSL 2 | Linux-tools en bestandssysteem op een Windows-computer; dichter bij de gepubliceerde tmux- en Python-workflow. | Windows-mounts, interoperabiliteit, inloggegevens en netwerken kunnen nog steeds hostbronnen blootleggen. We hebben deze implementatie niet van begin tot eind getest. |
| Native Windows | Windows-native tools en desktopworkflow. | Communityrapporten beschrijven servicescript-, pad- en werktoolproblemen in bepaalde versies. Ga er niet vanuit dat een gepatchte installatie van toepassing is op jouw versie. |
| Afzonderlijke Linux-host of VM | Een duidelijkere plek om de runtime en inloggegevens te beheren. | Isolatie hangt af van de VM-configuratie, gedeelde mappen, netwerktoegang en inloggegevens. Een VM is niet automatisch veilig. |
Waarom is de oorspronkelijke installatie onhandig op systeemeigen Windows?
De gepubliceerde serviceworkflow maakt gebruik van Python en tmux. Een Windows-gebruiker meldde dat het servicescript de fcntl-module, die alleen voor Unix beschikbaar is, importeert, dat sommige mapvalidatie Windows-stationletterpaden verwierp, en dat werksessies de verwachte tools in hun specifieke configuratie misten. Dat rapport gebruikte Windows 11 en DSH CLI 0.2.1-rc.3; het bewijst niet dat elke versie dezelfde fouten vertoont of dat de lokale patches onderhouden oplossingen zijn.
Community Windows-poorten en wrappers kunnen deze aannames veranderen. Behandel ze als implementaties van derden, controleer hun code en machtigingen en controleer hun versie- en onderhoudsstatus voordat u ze uitvoert. We hebben voor deze handleiding niet onafhankelijk een native port getest.
Hoe bereid je WSL 2 voor?
Op een ondersteunde Windows-installatie opent u PowerShell als beheerder en gebruikt u de installatieopdracht van Microsoft:
wsl --installVoltooi elke gevraagde herstart en voltooi het aanmaken van de Linux-gebruiker. Vanuit PowerShell toont wsl --list --verbose geïnstalleerde distributies en hun WSL-versie. Als WSL al is geïnstalleerd, inspecteer dan eerst de huidige status in plaats van aan te nemen dat de opdracht een nieuwe, geïsoleerde omgeving creëert.
Gebruik binnen de Linux-distributie Linux-versies van Node.js, pnpm, Git, Python, tmux, de GitHub CLI en DeepSeek Harness. Houd de werkende kloon op het Linux-bestandssysteem wanneer u Linux-tools gebruikt; toegang tussen bestandssystemen kan langzamer zijn. Plaats geen persoonlijke tokens of productiegeheimen in de thuismap van de servicegebruiker.
Hoe houd je de Windows-host- en testgegevens gescheiden?
WSL kan communiceren met Windows en heeft mogelijk toegang tot gekoppelde Windows-schijven. Een aparte Linux-gebruikersnaam of een repository onder de Linux-homedirectory vermindert het per ongeluk mixen, maar stopt op zichzelf niet de toegang tot de host. Gebruik voor niet-vertrouwde code een afzonderlijk beheerde omgeving met doelbewuste isolatie, beperkte netwerkmogelijkheden en inloggegevens die veilig kunnen worden ingetrokken. Controleer eventuele gedeelde mappen en koppelingen voordat u een medewerker toegang verleent.
Maak binnen die omgeving een speciale GitHub-gebruiker voor de agent en een afzonderlijke CLI-configuratie. Begin met een testrepository, één toegestane aanvrager en vertakkingsbescherming. De werker wordt uitgevoerd met de besturingssysteemrechten van de servicegebruiker, dus de toegang moet ook worden beperkt op besturingssysteem- en infrastructuurniveau.
Wat is de WSL-installatievolgorde?
- Open de Linux-shell en controleer
node -v,pnpm -v,git --version,python3 --version,tmux -V,gh --versionendsh --version. - Controleer de huidige vereisten van het prototype en het harnasversiebereik. Configureer een modelprovider en een speciaal GitHub CLI-account voor agenten binnen de omgeving.
- Kloon en bouw het prototype, maak het speciale profiel voor een nieuwe installatie en installeer de bundel. Voer de opdracht voor het maken van een profiel niet uit voor een bestaand profiel, omdat dit de configuratie ervan vervangt.
- Configureer het lokale paneel, GitHub Source, en toegestane voorbereiding van de werkboom van de aanvrager en de uitvoerder. Begin in
observevoor afgeleide kandidaten, waarbij menselijke beoordeling en automatisch samenvoegen zijn uitgeschakeld. - Controleer
scripts/dsh-superagent statusen gebruik vervolgens een klein expliciet verzoek in de testrepository. Expliciete verzoeken kunnen worden uitgevoerd in de observatiemodus.
Gebruik voor het volledige proces van probleem tot beoordeling de bestaande SuperAgent installatie- en kostengids. Een succesvolle afhankelijkheidscontrole is slechts een startpunt; verifieer het aanmaken van tickets, de werkruimte, de rechten en de resulterende diff afzonderlijk.
Wat moet je controleren als er iets mislukt?
| Symptoom | Wat te inspecteren |
|---|---|
tmux of Python-fout | Bevestig dat je het Linux-servicescript in WSL uitvoert, met de vereiste Linux-tools geïnstalleerd. |
| Geen GitHub reactie | Controleer de login van de agent-wrapper, toegang tot de repository, toegestane aanvrager en bronstatus. |
| Ticket kan het afrekenen niet voorbereiden | Controleer of het Linux-kloonpad bestaat en dat de opdracht prepare het juiste bestandssysteem en de juiste inloggegevens gebruikt. |
| Werknemer mist de verwachte tools | Neem DSH- en bundelversies op en inspecteer de werkvoorinstelling. Een Windows-rapport constateerde dit in één versie; het is geen universele diagnose. |
| Paneel kan de service niet bereiken | Controleer of het proces actief is en waar het paneel gebonden is. Vermijd het blootstellen van een lokaal beheerpaneel aan een netwerk zonder de juiste controles. |
Veelgestelde vragen
Is WSL een sandbox?
Nee. WSL en Windows kunnen samenwerken; configureer echte isolatie afzonderlijk voor niet-vertrouwd werk.
Bewijst deze handleiding dat native Windows-ondersteuning wordt geboden?
Nee. Het beschrijft gepubliceerde vereisten en individuele communityrapporten, en niet een end-to-end native Windows-test.
Kan ik mijn dagelijkse GitHub-account als agent gebruiken?
Het project beveelt een speciaal agentaccount aan. Scheid het van uw normale identiteit en verleen alleen toegang die nodig is voor de test.