Guía · Actualizado el 10 de noviembre de 2026 · Por Cameron Voss y West Mao

DeepSeek SuperAgent en Windows: configuración WSL vs nativa de Windows (noviembre de 2026)

Elija una ruta de Windows, comprenda los límites y verifique su entorno antes de instalar.

Respuesta rápida

Para una máquina Windows, WSL 2 le da al prototipo un entorno Linux más cercano a la configuración publicada orientada a Unix. Windows nativo tiene problemas de compatibilidad informados por la comunidad; Los puertos de terceros son proyectos separados. WSL ayuda con la compatibilidad, pero no es un límite de seguridad para el trabajo de agentes que no son de confianza.

DeepSeek SuperAgent es un prototipo de investigación creado en DeepSeek Harness, no un producto oficial de DeepSeek ni un software listo para producción. Necesita un proveedor de modelo configurado por separado. Esta guía sigue la documentación publicada; No hemos ejecutado una implementación de un extremo a otro para este artículo.

La ejecución de DeepSeek Harness en Windows no establece por sí solo que todos los scripts de servicio y flujos de trabajo de SuperAgent se ejecuten allí. Elija el entorno para todo el flujo de trabajo: instalación, credenciales de GitHub, árboles de trabajo por ticket, supervisión y revisión del servicio.

¿Debería elegir WSL 2, Windows nativo o un host Linux independiente?

Ruta	Qué ofrece	Qué comprobar
WSL 2	Herramientas y sistema de archivos Linux en una máquina Windows; más cerca del flujo de trabajo publicado de tmux y Python.	Los montajes, la interoperabilidad, las credenciales y las redes de Windows aún pueden exponer los recursos del host. No hemos probado esta implementación de principio a fin.
Windows nativo	Herramientas nativas de Windows y flujo de trabajo de escritorio.	Los informes de la comunidad describen problemas con scripts de servicio, rutas y herramientas de trabajo en versiones particulares. No asuma que una configuración parcheada se aplica a su versión.
Host Linux o VM independiente	Un lugar más distinto para administrar el tiempo de ejecución y las credenciales.	El aislamiento depende de la configuración de la VM, las carpetas compartidas, el acceso a la red y las credenciales. Una máquina virtual no es automáticamente segura.

¿Por qué la configuración original es incómoda en Windows nativo?

El flujo de trabajo del servicio publicado utiliza Python y tmux. Un usuario de Windows informó que el script de servicio importa el módulo fcntl exclusivo de Unix, que algunas validaciones de directorio rechazaron rutas de letras de unidad de Windows y que las sesiones de trabajo carecían de las herramientas esperadas en su configuración particular. Ese informe utilizó Windows 11 y DSH CLI 0.2.1-rc.3; no prueba que todas las versiones tengan las mismas fallas o que sus parches locales sean correcciones mantenidas.

Los puertos y contenedores comunitarios de Windows pueden cambiar esas suposiciones. Trátelos como implementaciones de terceros, revise su código y permisos, y verifique su versión y estado de mantenimiento antes de ejecutarlos. No hemos probado de forma independiente un puerto nativo para esta guía.

¿Cómo se prepara WSL 2?

En una instalación de Windows compatible, abra PowerShell como administrador y use el comando de instalación de Microsoft:

wsl --install

Completa cualquier reinicio solicitado y termina de crear el usuario de Linux. Desde PowerShell, wsl --list --verbose muestra las distribuciones instaladas y su versión WSL. Si WSL ya está instalado, primero inspeccione su estado actual en lugar de asumir que el comando crea un entorno nuevo y aislado.

Dentro de la distribución de Linux, utilice las versiones de Linux de Node.js, pnpm, Git, Python, tmux, GitHub CLI y DeepSeek Harness. Mantenga el clon funcional en el sistema de archivos de Linux cuando ejecute herramientas de Linux; el acceso entre sistemas de archivos puede ser más lento. No coloque tokens personales ni secretos de producción en el directorio de inicio del usuario del servicio.

¿Cómo se mantienen separados el host de Windows y los datos de prueba?

WSL puede interactuar con Windows y acceder a las unidades de Windows montadas. Un nombre de usuario de Linux separado o un repositorio en el directorio de inicio de Linux reduce la mezcla accidental pero, por sí solo, no detiene el acceso al host. Para código que no sea de confianza, utilice un entorno administrado por separado con aislamiento deliberado, redes limitadas y credenciales que sean seguras de revocar. Verifique las carpetas compartidas y los montajes antes de otorgar acceso a un trabajador.

Dentro de ese entorno, cree un usuario de GitHub dedicado para el agente y una configuración CLI separada. Comience con un repositorio de prueba, un solicitante permitido y protección de ramas. El trabajador se ejecuta con los permisos del sistema operativo del usuario del servicio, por lo que el acceso también debe limitarse a nivel del sistema operativo y de la infraestructura.

¿Cuál es la secuencia de configuración de WSL?

Abra el shell de Linux y verifique node -v, pnpm -v, git --version, python3 --version, tmux -V, gh --version y dsh --version.
Verifique los requisitos previos actuales del prototipo y el rango de versiones del arnés. Configure un proveedor de modelo y una cuenta CLI de GitHub de agente dedicado dentro del entorno.
Clone y cree el prototipo, cree el perfil dedicado para una nueva instalación e instale el paquete. No ejecute el comando de creación de perfil en un perfil existente porque reemplaza su configuración.
Configure el panel local, GitHub Source, el solicitante permitido y la preparación del árbol de trabajo del ejecutor. Comience en observe para candidatos inferidos, con la revisión humana y la combinación automática deshabilitadas.
Marque scripts/dsh-superagent status, luego use una pequeña solicitud explícita en el repositorio de pruebas. Las solicitudes explícitas pueden ejecutarse en modo de observación.

Para ver el flujo completo desde el problema hasta la revisión, utilice la guía de costos y configuración de SuperAgent existente. Una verificación de dependencia exitosa es sólo un punto de partida; verifique la creación del ticket, el espacio de trabajo, los permisos y la diferencia resultante por separado.

¿Qué debes comprobar cuando algo falla?

Síntoma	Qué inspeccionar
`tmux` o error de Python	Confirme que está ejecutando el script de servicio de Linux dentro de WSL, con las herramientas de Linux requeridas instaladas.
No GitHub respuesta	Verifique el inicio de sesión del agente, el acceso al repositorio, el solicitante permitido y el estado de la fuente.
El ticket no puede preparar el pago	Verifique que exista la ruta del clon de Linux y que el comando de preparación utilice el sistema de archivos y las credenciales correctos.
El trabajador carece de las herramientas esperadas	Registre las versiones de DSH y del paquete e inspeccione la configuración preestablecida del trabajador. Un informe de Windows observó esto en una versión; no es un diagnóstico universal.
El panel no puede comunicarse con el servicio	Compruebe si el proceso se está ejecutando y hacia dónde está vinculado el panel. Evite exponer un panel de administración local a una red sin los controles adecuados.

Preguntas frecuentes

¿WSL es un sandbox?

No. WSL y Windows pueden interoperar; configure el aislamiento real por separado para trabajos que no sean de confianza.

¿Esta guía demuestra la compatibilidad nativa con Windows?

No. Describe los requisitos publicados y los informes comunitarios individuales, no una prueba nativa de Windows de un extremo a otro.

¿Puedo usar mi cuenta diaria de GitHub como agente?

El proyecto recomienda una cuenta de agente dedicada. Sepárelo de su identidad normal y otorgue solo el acceso necesario para la prueba.

Ver precios de los Coding Plans