Skip to content

Inicio rápido de DeepSeek Harness: npx @deepseek-ai/dsh web

Instalación

De una máquina limpia a :3080 sin tratar la preview como un producto de un clic.

La orden que de verdad ejecutas

Con Node en el PATH, el arranque público es:

npx @deepseek-ai/dsh web

Un typo en el scope de npm te quema la tarde. La UI suele estar en http://127.0.0.1:3080/. Si cierras el terminal, cae el servidor. Node ^22.19.0 o >=24. Comprueba node -v en el mismo intérprete. El checklist largo vive en Instalación.

Notas por sistema (no enviamos instaladores)

En Windows instala LTS y reabre la consola; cd al repo que te importa. Para PATH, PowerShell vs Git Bash, Controlled Folder Access y trampas de rutas en WSL, lee DeepSeek Harness en Windows. En macOS no regales Full Disk Access el primer día. En Linux/WSL no uses root; en WSL deja el workspace en el sistema de archivos Linux. Fallos de puerto, pnpm o registry: solución de problemas. El árbol de decisión de los mismos fallos (Node engines → descarga npx → puerto 3080 → claves) está en arreglar npx y el puerto 3080.

Cuando abre la UI

Pega la clave de la plataforma oficial (este sitio no la emite). Elige un workspace desechable. Todo el directorio home es el primer objetivo equivocado. Empieza listando archivos y citando el primer encabezado del README. Si pide borrar o un chmod amplio, para. La UI local no es inferencia local por defecto.

Un npm i -g global parece cómodo hasta que dos terminales resuelven majors distintos. En un informe de fallo escribe rc, Node, SO y ruta. El camino pnpm de código fuente es para autores de plugins; no lo mezcles en hilos de npx. Después, modos. Skins en Creative: skins de UI. Directorio: plugins.

Guion de la primera hora

Misma ventana para node -v y npx. Carpeta que puedas tirar. No hagas Ctrl+C “para ver si vive”. No abras un túnel a la nube si no sabes quién entra. Un prompt aburrido basta para decidir si merece la segunda hora. No basta para apuntar al monorepo que paga nóminas.

Para el compañero que mezcla npx y pnpm

El hilo que junta el arranque npx con el pnpm del código fuente es el caos más habitual. Si solo quieres ver la UI, npx. Si vas a tocar Cordis, clona. Equivocar la raíz del workspace sale más caro que un typo en el comando: cuando el home es la raíz, Trajectory enseña rutas que no reconoces. Para, cambia a un clon tirable, sigue. Las claves viven en el fichero que pida el runtime, no en el README “para que sea fácil”. Si el mirror corporativo va tarde respecto al rc, vuelve al registry oficial; no añadas tres tutoriales de aceleración. Tras el primer bucle, lanza el mismo prompt en Standard y mira la lista de tools antes de abrir plugins comunitarios. Los temas, por la página de skins y en Creative. Cerrar el terminal no es un crash: has matado el proceso. Si un install global descuadra majors entre consolas, el informe lleva rc, Node, SO y ruta.

Node y npx en la misma ventana. El copy de la UI de preview cambia; aunque el rótulo “modelo” se renombre, pegas la clave de plataforma. La interfaz local, por defecto, habla con un proveedor en la nube. Anota la raíz. Ante un fallo mira puerto, pnpm y mirror antes que el producto. Instalar desde fuente es oficio de quien escribe plugins. No abras un mercado de skins antes del primer bucle. Si el home es la raíz, Trajectory enseña rutas raras: para en seco. Cerrar el terminal mata el servidor; no es un cuelgue misterioso.

Seguir en el portal

Después de leer, pasa a instalación, tutoriales y el directorio de plugins.