DeepSeek Harness en Windows: rutas, permisos y terminales

Windows no es otro producto

No hay instalador de escritorio oficial de DeepSeek Harness para Windows. DeepSeek Harness en Windows sigue siendo Node.js más npx @deepseek-ai/dsh web, y el navegador en http://127.0.0.1:3080/. El comando coincide con instalación y el inicio rápido npx. Lo que cambia es el entorno: qué shell posee el PATH, cómo se ven las rutas de Windows en Git Bash o WSL, y si Controlled Folder Access bloquea escrituras en silencio.

Este artículo es el complemento solo para Windows. Si el proceso no enlaza o el 3080 está ocupado, ve a la escalera npx / puerto 3080 en lugar de releer las notas de SO.

Los flags exactos siguen siendo de aguas arriba. Si el README oficial discrepa, gana el README.

Elige un shell y quédate con su PATH

En el mismo PC puedes abrir PowerShell, Windows Terminal (pestañas PowerShell o cmd), cmd clásico, Git Bash y WSL. Cada uno puede ver un node distinto — o ninguno.

1. Decide el shell de la primera hora. Prefiere PowerShell o una pestaña PowerShell de Windows Terminal.
2. Solo en esa ventana ejecuta node -v y npm -v. La preview pide Node ^22.19.0 o >=24.0.0.
3. Si aquí falta node pero otra app lo tiene, el PATH es por shell. Arreglar la otra ventana no arregla esta.
4. No mezcles: instala Node en PowerShell y lanza npx desde un Git Bash viejo que aún tenga Node 18.

Git Bash vale cuando el PATH es correcto, pero las comillas y letras de unidad cambian (D:\demo vs /d/demo). En la primera evaluación, un solo shell hasta que npx @deepseek-ai/dsh web imprima una URL local.

Instala Node para que la misma ventana lo vea

1. Instala Node LTS desde nodejs.org o winget install OpenJS.NodeJS.LTS (ver la línea de Windows en Instalación).
2. Cierra y reabre la terminal — el instalador actualiza el PATH de usuario; las pestañas abiertas conservan el entorno viejo.
3. Confirma node -v en el mismo shell que usarás para npx.
4. cd a una carpeta desechable (p. ej. D:\scratch\dsh-demo) y ejecuta:

npx @deepseek-ai/dsh web

Deja la terminal abierta. Cerrarla detiene el servidor local. Un proxy corporativo que hace MITM al registro npm parece un bug de producto; reintenta con el registry oficial si el espejo se atrasa — detalles en solución de problemas.

Rutas, workspaces y Controlled Folder Access

El agente solo ve la raíz de workspace que eliges en la UI. En Windows choca con hábitos cotidianos:

• Prefiere una ruta corta en un disco fijo (D:\scratch\...) frente a un árbol profundo de Documents sincronizado por OneDrive el día uno.
• No apuntes la primera sesión a todo el perfil de usuario. El home mezcla secretos, cachés de correo y sync en la nube.
• Controlled Folder Access (Seguridad de Windows → Protección frente a virus y amenazas → Protección contra ransomware) puede dejar abrir la UI mientras fallan o se cuelgan las escrituras. Si el agente “no puede escribir” con terminal sano, comprueba si el editor/Node está permitido, o mueve el repo desechable fuera de carpetas protegidas.
• Execution Policy afecta sobre todo a scripts PowerShell tuyos — rara vez bloquea npx. No pongas Bypass global “solo para probar DSH”.

Tras cargar la UI: pega una clave de la plataforma DeepSeek, elige el workspace desechable, envía un prompt de bajo riesgo (listar archivos de primer nivel). La UI local suele ser plano de control, no pesos offline.

Puerto 3080 y el navegador en localhost

La Web UI por defecto es loopback http://127.0.0.1:3080/. En Windows, busca al ocupante con:

netstat -ano | findstr :3080

Detén el PID en el Administrador de tareas o taskkill /PID <pid> /F, o arranca con el flag de puerto documentado aguas arriba. Las primeras pruebas en localhost — enlazar 0.0.0.0 es una decisión de seguridad. Página en blanco con terminal sano: prueba un perfil limpio del navegador; las extensiones a veces bloquean scripts locales.

WSL es otra máquina para PATH y archivos

WSL Ubuntu no es “Windows con un prompt más amable”. El Node de Windows no aparece solo dentro de WSL, ni al revés. Si ejecutas DSH dentro de WSL, deja el workspace en el sistema de archivos Linux — editar /mnt/c/... desde Linux suma trampas de permisos y rendimiento. Si te quedas en PowerShell nativo, no persigas versiones de Node de WSL en la misma depuración.

Qué no es este artículo

• No es un segundo inicio rápido completo — eso sigue en inicio rápido npx.
• No es el árbol de decisión de cada fallo de arranque — usa arreglar npx y el puerto 3080.
• No es un respaldo a wrappers no oficiales “DeepSeek Harness Desktop”. Existen lanzadores comunitarios; son pieles opcionales del mismo servidor Node.
• No es el artículo de macOS — DeepSeek Harness en macOS.

Adónde ir después

1. One-liners y verificación: Instalación.
2. Guion de la primera hora: inicio rápido npx.
3. Escalera de síntomas: solución de problemas y el artículo del puerto 3080.
4. Cuando corra, elige un modo antes de apilar plugins comunitarios.