DeepSeek Harness: arreglar npx y el puerto 3080

Esto no es otro inicio rápido

El inicio rápido con npx asume que npx @deepseek-ai/dsh web acaba imprimiendo una URL. Este artículo es para la otra mitad del tráfico de primer arranque: el terminal se cuelga, el 3080 no responde, o la UI carga y cada chat muere por errores de API. Úsalo junto al checklist buscable de solución de problemas — aquí explicamos el orden de comprobaciones para no mover tres variables a la vez.

Los flags exactos siguen siendo de aguas arriba. Si el README y esta página discrepan, gana el README.

Escalón 1 — Demuestra Node antes de tocar DSH

La preview pide Node.js ^22.19.0 o >=24.0.0. Ejecuta node -v y npm -v en el mismo intérprete donde harás npx. Las versiones de nvm/fnm de otra ventana no cuentan.

Síntomas de motor equivocado: la descarga empieza y falla el chequeo engines; o no hay node. Arregla el PATH, reabre la consola y solo entonces reintenta. No “actualices Node dentro del npx colgado”.

Escalón 2 — Que @deepseek-ai/dsh se pueda descargar

La primera vez baja un árbol grande. Los fallos parecen timeouts, 404 o un rc antiguo en caché.

1. Confirma el scope: @deepseek-ai/dsh — un typo te quema media tarde.
2. Si el mirror corporativo va tarde, reintenta con --registry=https://registry.npmjs.org.
3. Limpia una caché npx envenenada solo después de descartar red y typos de scope.

Deja el terminal abierto. Matar a mitad de descarga te deja depurando una caché a medias.

Escalón 3 — El puerto 3080 es un socket local

La Web UI suele enlazar http://127.0.0.1:3080/. Si otra cosa ocupa el 3080, el proceso puede arrancar y el navegador nunca muestra DSH.

• Localiza al ocupante (netstat / lsof / Monitor de recursos según el SO).
• Páralo, o arranca con el flag de puerto documentado aguas arriba (en la comunidad suele verse --port en dsh web).
• Las primeras pruebas se quedan en localhost. Enlazar 0.0.0.0 es una decisión de seguridad, no un tip de comodidad.

Terminal sano y página en blanco: prueba un perfil limpio del navegador — las extensiones a veces bloquean scripts locales.

Escalón 4 — UI arriba, chat muerto (claves y credenciales)

La UI local suele ser un plano de control, no pesos offline. Las llamadas enrutadas por DeepSeek necesitan una API key de plataforma. Revisa id del modelo, cuota y espacios accidentales al pegar.

Las rutas headless/CLI pueden leer $DSH_HOME/.credentials.yaml (a menudo ~/.dsh/.credentials.yaml). En Unix, modos de fichero demasiado abiertos hacen que el runtime rechace el archivo — chmod 600 es el arreglo habitual. Este portal independiente nunca emite claves.

Escalón 5 — Falta pnpm cuando entran los plugins

Aunque hayas arrancado con npx, dsh plugin add suele invocar pnpm. Un pnpm global ausente se ve como “la UI iba bien y el install falló”. Instala pnpm, asegúrate de que su bin está en el PATH y reintenta el add — ver la guía de plugins.

Qué no hacer

• No apuntes el primer workspace a todo tu directorio home mientras depuras puertos.
• No apiles tres plugins comunitarios nuevos con el 3080 aún inestable.
• No trates un blog de la semana pasada como ley de CLI — fija una versión de preview para evaluar.

A dónde ir después

1. Narrativa de instalación sana: inicio rápido npx.
2. Notas por SO: instalación.
3. Síntomas itemizados: solución de problemas.
4. Cuando corra, elige un modo antes de ahogarte en paquetes.