Cómo instalar DeepSeek Harness (dsh): aplicación de escritorio, npx en una sola línea, compilación desde el código fuente y complementos

DeepSeek Harness (dsh) —el runtime de agentes de código abierto que DeepSeek lanzó el 13 de agosto de 2026— obtuvo un cliente de escritorio oficial el 24 de septiembre de 2026. Es una aplicación empaquetada para Windows y macOS con silicio de Apple, publicada desde el propio servidor de descargas de DeepSeek con el runtime del harness incluido: sin instalar Node.js, sin npx, sin terminal. La línea de comandos no ha desaparecido —npx @deepseek-ai/dsh web sigue siendo la ruta más rápida en Linux, que la versión de escritorio no cubre. Dos cosas que conviene saber antes de empezar: dsh no es un modelo —es la capa de harness que conecta un modelo como DeepSeek V4 Flash 0731 o DeepSeek V4 Pro 0813 con herramientas, archivos y una terminal— y cada canal sigue siendo una vista previa para desarrolladores, así que espera cambios que rompan la compatibilidad entre versiones. Esta guía cubre la aplicación de escritorio, el one-liner de npx, la compilación desde el código fuente, el modo headless, los plugins, MCP y las asperezas que se reconocen con honestidad.

Qué es Deep​Seek Harness — y qué no es

La fórmula interna de Deep​Seek, confirmada por el investigador sénior Chen Deli, es Modelo + Harness = Agente. El modelo es el cerebro; el harness es todo lo que lo convierte en algo que realiza trabajo: gestión de contexto y memoria, llamada de herramientas, planificación de tareas, lectura y escritura de archivos, ejecución de terminal, retroalimentación de errores y decidir cuándo una tarea está completa. Deep​Seek Harness es esa capa, publicada como código abierto bajo la licencia MIT el 13 de agosto de 2026 — el mismo día en que la compilación DeepSeek V4 Pro 0813 llegó a la API de Deep​Seek.

Dos hechos definen la experiencia de instalación. Primero, la arquitectura es «todo es un plugin», construida sobre Cordis, un contenedor de plugins de TypeScript, así que lo que instalas es un núcleo pequeño más un conjunto de plugins que proporcionan adaptadores de modelos, herramientas, sesiones e interfaz de usuario. Segundo, los canales de npm hoy son 0.1.5-rc.3 en latest y 0.1.7-rc.2 en next, ambos candidatos a versión que el propio proyecto señala como una vista previa para desarrolladores: el README advierte, en mayúsculas, que se avecinan cambios que rompen la compatibilidad. La popularidad es real —50.000 estrellas en GitHub en sus primeras 12 horas y 235.000 a finales de septiembre de 2026—, pero las estrellas miden el interés, no la estabilidad. Planifica tu instalación como planificas una vista previa: rápida de probar, barata de desechar.

Antes de empezar: los requisitos reales del sistema

Para las instalaciones desde la línea de comandos, el único requisito indispensable es Node.js. El proyecto está destinado al rango de motor ^22.19.0 || >=24.0.0; en términos sencillos, Node 22.19 o posterior, o cualquier Node 24.x. Comprueba tu versión con node --version. Si tienes una versión anterior de Node, la instalación con npx fallará o dará problemas, no se degradará de forma controlada. La aplicación de escritorio que aparece a continuación es la excepción: incluye su propio entorno de ejecución, así que no necesita Node.js en absoluto.

Todo lo demás es más ligero de lo que asume la multitud que prioriza el modelo:

• Una clave de API del modelo. dsh ejecuta un modelo real; necesita una clave para la API de DeepSeek o cualquier proveedor compatible con OpenAI que configures. Puedes añadir una en la interfaz web después del primer inicio.

• pnpm — solo para la compilación desde el código fuente. Instale una vez con npm install -g pnpm.

• ~1 GB de disco libre para el paquete npm, el espacio de trabajo y los registros de sesión, además de lo que necesitaría un modelo local (dsh en sí no ejecuta los pesos). El instalador de escritorio es más pesado —288 MB para el .exe de Windows, una imagen de disco de 368 MB en macOS— porque lleva ese entorno de ejecución dentro.

• SO: la ruta de npm funciona en Windows, macOS y Linux. La aplicación de escritorio es más limitada: solo Windows x64 y macOS con Apple silicon; no hay compilación para Mac con Intel ni destino para Linux. El SDK de Python es aún más limitado (Linux x64/arm64, macOS 14+ arm64 — sin Windows nativo), como se explica a continuación.

Tú no necesitas una GPU. El arnés solo orquesta; el modelo se ejecuta de forma remota a través de una API.

Método 1 — la aplicación oficial de escritorio (Windows y macOS)

El 24 de septiembre de 2026, Deep​Seek publicó la primera compilación de escritorio empaquetada de Deep​Seek Harness. Es un envoltorio de Electron alrededor de la misma interfaz web con el runtime de dsh incluido en su interior, así que no hay nada que instalar primero ni nada que iniciar a mano: ni Node.js, ni npx, ni terminal, ni una pestaña del navegador abierta en 127.0.0.1:3080. El código fuente se encuentra en el repositorio público bajo apps/desktop como el paquete @deepseek-ai/dsh-desktop, los artefactos se sirven desde el propio host de descargas de producción de Deep​Seek en download.deepseek.com/dsh-desk/, y la aplicación sigue exactamente la versión del harness: la compilación actual es 0.1.7-rc.2.

Lo que ese host estaba sirviendo el 25 de septiembre de 2026:

• Windows — deepseek-harness-0.1.7-rc.2-win-x64.exe, un instalador de 288 MB, con un archivo .blockmap junto a él para actualizaciones delta.

• macOS — deepseek-harness-0.1.7-rc.2-mac-arm64.dmg, una imagen de disco de 368 MB, o la misma compilación como un .zip de 373 MB. Solo para Apple silicon.

• Versión — 0.1.7-rc.2, con fecha de lanzamiento del 24 de septiembre de 2026, que coincide con la versión del harness en la etiqueta next de npm.

• Falta — no hay compilación para Intel-Mac (el feed de actualización mac-x64 devuelve 404) y ningún objetivo Linux de ningún tipo.

Cada destino también publica un feed de actualizaciones en download.deepseek.com/dsh-desk/feeds/, cuyo campo releaseDate es la fecha de compilación. Comprobar ese archivo es la forma más rápida de ver si existe una compilación más reciente sin esperar a que la aplicación ofrezca una.

Por qué el cliente oficial es algo distinto de los wrappers de la comunidad. Es de primera parte y se actualiza por sí solo, incluye el runtime en el instalador en lugar de descargarlo en el primer inicio, y no sirve la interfaz desde el 3080 del perfil web: el shell carga la aplicación mediante un esquema interno dsh-app:// y se comunica con un proceso host privado en su propio puerto, 19387 por defecto. También se comporta como una aplicación de escritorio: cerrar la ventana mantiene vivas las tareas en ejecución (Windows conserva un icono en la bandeja del sistema), salir pregunta primero cuando hay trabajo en curso, y las notas de la versión 0.1.7-rc.2 añaden una guía de incorporación en el primer inicio que presenta el crédito disponible y separa las tareas financiadas por la cuenta de las tareas con clave de API, para que puedas iniciar sesión con una cuenta de Deep​Seek en lugar de pegar una clave.

Dos advertencias, porque este cliente se distribuyó discretamente en lugar de anunciarse. El README del repositorio todavía documenta solo npx y la compilación desde el código fuente, y la página del proyecto en www.deepseek.com/harness no incluye ningún enlace de descarga —los binarios y su canal de actualizaciones están activos en el propio host de DeepSeek, que es lo que verificamos el 25 de septiembre de 2026, pero ninguna nota de versión los describe en ninguna parte—. Y no hemos ejecutado los instaladores, así que esta guía no se pronuncia sobre el estado de firma o notarización de los binarios publicados; el pipeline de empaquetado del repositorio sí incluye pasos de firma de código para Windows y de notarización de Apple, y eso es todo lo que se puede decir desde fuera.

Una consecuencia de que la compilación de escritorio siga la versión del harness: actualmente está por delante de una instalación predeterminada de línea de comandos. La etiqueta latest de npm todavía apunta a 0.1.5-rc.3, mientras que todos los artefactos de escritorio son 0.1.7-rc.2. Si quieres el harness más reciente en una plataforma que la aplicación de escritorio no cubre, instala la etiqueta explícitamente — npx @deepseek-ai/dsh@next web — en lugar de confiar en el valor predeterminado.

Método 2 — el one-liner de npx (todas las plataformas, incluida Linux)

La guía de inicio rápido oficial es un solo comando, y de verdad es un solo comando:

npx @deepseek-ai/dsh web

npx fetches the @deepseek-ai/dsh package (npm's latest tag currently resolves to 0.1.5-rc.3, not the newest harness), installs it into npm's cache, and starts the Web UI profile. Watch the output for the line that tells you it's listening — by default that is http://127.0.0.1:3080. Open it in your browser. Note the 127.0.0.1 loopback address: the UI binds to localhost only, which is the right default for a tool that can read and write files in your workspace — it also means you won't casually expose it on your network.

El primer inicio tiene exactamente dos pasos de configuración:

• Añade una clave de modelo. Configuración → Modelos → introduce tu clave de API. Se guarda en $DSH_HOME/.credentials.yaml y no se muestra en texto plano después. En una instalación estándar DSH_HOME se establece por defecto en ~/.dsh.

• Elija un espacio de trabajo. Agregue el directorio del proyecto en el que dsh puede trabajar. La entrada permanece bloqueada hasta que se completen ambos pasos.

Luego envía una primera tarea: una buena prueba de humo es "Resume este repositorio e identifica sus paquetes principales." Si el resumen regresa y las llamadas a herramientas aparecen en el rastro de ejecución, tu instalación funciona.

Método 3 — compilar desde el código fuente

¿Prefieres ejecutar desde el repositorio? La ruta oficial es:

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

Necesitas pnpm para esto (los contribuidores fijan pnpm 11.7.0). Elige la compilación desde el código fuente cuando quieras ejecutar la última main en lugar de la versión candidata publicada, cuando planees leer o modificar el harness, o cuando quieras construir un preset personalizado desde el directorio apps/cli/config/agent-presets/ del repositorio. Para todos los demás, la ruta de npx es el mismo software con menos ceremonia: la compilación desde el código fuente no desbloquea funciones que le falten al paquete npm.

Los tres perfiles: web, headless y tui.

dsh se distribuye como tres perfiles de ejecución, y cuál uses depende de dónde se realiza el trabajo:

• web (por defecto) — la interfaz completa del navegador en el puerto 3080. Esto es lo que npx @deepseek-ai/dsh web inicia, y es el perfil que la mayoría de la gente instalará primero.

• headless — una tarea y luego salir. dsh --profile headless "run the test suite and report failures" inicia una sesión, ejecuta la tarea, escribe sus resultados y finaliza. El runtime headless es explícitamente un proceso de una sola tarea: no puedes inyectar seguimientos a mitad de ejecución, y las correcciones son una nueva ejecución contra el mismo espacio de trabajo. Este es el perfil para integrar en scripts y CI.

• tui — una interfaz de terminal para sesiones controladas por teclado: dsh --profile tui.

Los tres comparten la misma configuración (~/.dsh/profiles/<name>/) y el mismo sistema de plugins, por lo que mover una tarea de la interfaz web a headless es un cambio de comando, no una reinstalación.

Añadiendo plugins

La gestión de plugins es un comando CLI de primera clase, no un asunto de edición en el lugar:

npx @deepseek-ai/dsh plugin --profile web add <source>

La fuente puede ser un nombre de paquete npm, un repositorio de GitHub (github:user/repo), un tarball, o una carpeta local. La primera instalación más útil es el mercado oficial de plugins, que convierte el descubrimiento de plugins en una interfaz de usuario:

npx @deepseek-ai/dsh plugin --profile web add dshmarket

Luego reinicia el servicio web y abre Configuración → Mercado de plugins para explorar e instalar con un clic desde el catálogo. Dos reglas que confunden a la gente: los paquetes de plugins se montan al inicio del perfil, por lo que un plugin recién añadido necesita un reinicio de dsh web; y un simple npm install no registra un plugin en un perfil — debes usar dsh plugin. El ecosistema es joven pero no está vacío: la lista awesome-dsh-plugin mantenida por la comunidad ya cataloga cientos de plugins en categorías como interfaz de usuario, habilidades, herramientas, proveedores y notificaciones.

MCP, los cuatro preajustes y la reproducción de trayectoria.

Tres características importan una vez que superas una instalación básica:

MCP. dsh habla con el Model Context Protocol a través de un @deepseek-ai/dsh-mcp-client plugin incorporado. Hoy eso se configura en archivos, no en la interfaz: editas ~/.dsh/profiles/web/cordis.patch.yml (o un parche local del proyecto) y declaras el transporte de cada servidor — stdio para comandos locales como npx @playwright/mcp@latest, streamable-http para URLs remotas. Funciona, pero es la superficie menos pulida en la vista previa; espera inestabilidad ocasional y no hay GUI para alternar servidores.

Preajustes. dsh carga uno de los cuatro preajustes de agente por sesión, y cada uno representa una compensación diferente:

• Standard — el conjunto completo de herramientas: edición de archivos, shell, recuperación de archivos y web, habilidades, planificación, subagentes, flujos de trabajo. El predeterminado de uso diario.

• PTC (Llamada Programática a Herramientas) — Estándar más un SDK de Code Mode que permite al modelo escribir programas en TypeScript para orquestar llamadas a herramientas en múltiples rondas. Más potente, con más efectos secundarios.

• Minimal — solo bash y un editor de archivos, nada más. Construido para benchmarking de modelos y reproducción mínima; el modo que los documentos de la API de DeepSeek V4 Flash referenciaron cuando revelaron que sus propias puntuaciones de agente se ejecutaron en "Deep​Seek Harness minimal mode."

• Creación — un entorno de pruebas en tiempo de ejecución: inspecciona y carga plugins de Cordis en memoria, experimenta y consolida una combinación funcional en un nuevo preset.

Reproducción de trayectoria.Cada ejecución escribe un registro de sesión de solo anexión — indicaciones del sistema, razonamiento, llamadas a herramientas y sus resultados, planificación de subagentes. La vista de Trayectoria te permite inspeccionar por fuente, reanudar, bifurcar, buscar y reproducir una ejecución. Ese es el depurador para el trabajo de agentes: cuando una tarea falla, no vuelves a ejecutar y esperas; reproduces la trayectoria fallida, la bifurcas en el paso incorrecto y pruebas una corrección sin descartar la original.

La opción del SDK de Python

Si prefieres manejar el harness desde Python en lugar de desde un navegador, hay un SDK oficial: pip install deepseek-harness-sdk. Incluye el runtime de dsh (la rueda de pip incluye el runtime de Node, por lo que no necesitas instalar Node por separado), y su uso es un administrador de contexto: construye una instancia de Deep​SeekHarness, llama a run("task"). Hereda variables de entorno estándar como DEEPSEEK_API_KEY y DEEPSEEK_BASE_URL, por lo que cambiar de proveedor es solo un cambio de configuración. La pega: es Python 3.10+ y solo admite Linux x64/arm64 y macOS 14+ arm64 — no hay rueda nativa para Windows, lo que es una carencia real si Windows es tu sistema. En Windows, quédate con la ruta de npm.

Apuntando dsh a los modelos que pagas

dsh necesita una clave de API de modelo, y es deliberadamente agnóstico respecto al proveedor: Configuración → Modelos acepta un proveedor personalizado con una URL base compatible con Open​AI (en settings.yaml es decir, api: openai-completions, baseURL, y una lista de models). El valor predeterminado es la API propia de Deep​Seek; un proveedor personalizado es donde un gateway de enrutamiento se vuelve útil.

OrcaRouter is an Open​AI-compatible endpoint that passes Deep​Seek's list price through with zero markup — https://api.orcarouter.ai/v1. The models dsh will actually call are all on it: DeepSeek V4 Flash 0731 (deepseek/deepseek-v4-flash-0731, $0.22 per million input tokens and $0.66 per million output), DeepSeek V4 Pro 0813 (deepseek/deepseek-v4-pro-0813, $0.66/$1.98) and DeepSeek V4.1 Flash (deepseek/deepseek-v4.1-flash, $0.15/$0.60), the model Deep​Seek's own rate card bills as deepseek-flash. Every rate doubles inside Deep​Seek's peak windows, 01:00-04:00 and 06:00-10:00 UTC on weekdays; the router passes that surcharge through rather than hiding it, and automatic failover moves a request to another provider if one wobbles. Figures checked against both rate cards on September 25, 2026. For dsh, the practical win is that you can keep the cheap tier for the bulk of everyday agent tasks and switch the same harness to V4 Pro for the hard passes — one key, one base URL, and the swap is a model name in the settings, not a reinstall.

Para que quede claro dónde están los límites: OrcaRouter aloja los modelos a los que llama dsh; no aloja dsh en sí, ni tampoco distribuye el cliente de escritorio — eso proviene del host de descargas propio de Deep​Seek. dsh es un entorno de ejecución de agente local, y lo ejecutas en tu propia máquina.

Dónde esta guía falla para ti — problemas honestos con la vista previa

Un tutorial de instalación que solo te dice qué escribir está haciendo la mitad del trabajo. Esto es lo que la vista previa hace mal hoy, para que no lo descubras a las 2 a.m.:

• Los cambios disruptivos son una promesa, no una advertencia. Estás en una release candidate: 0.1.5-rc.3 si tomaste el valor predeterminado de npm, 0.1.7-rc.2 si instalaste la aplicación de escritorio o la etiqueta next. Las claves de configuración, la API de plugins y los formatos de presets pueden cambiar sin previo aviso. Considera ~/.dsh como estado desechable: el costo de una mala actualización es una reinstalación, y eso es aceptable en esta etapa solo porque cada vía de instalación aquí es una descarga o un único comando.

• No necesitas dsh para usar los modelos Deep​Seek como agente. Si tu único objetivo hoy es DeepSeek V4 Flash o DeepSeek V4 Pro dentro de un agente, el endpoint compatible con Anthro​pic de Deep​Seek ya funciona en Claude Code y otras herramientas de agente sin necesidad de software nuevo. dsh es una opción de primera parte, no un requisito previo. Omite esta instalación hasta que quieras específicamente el harness nativo.

• MCP está configurado mediante archivos y a veces es inestable. No hay GUI, no hay interruptor de inicio/parada por servidor, y los informes de primera mano describen fallos intermitentes. Reserva tiempo para depurar YAML si tu flujo de trabajo depende de los servidores MCP.

• La confianza en los plugins es una decisión de seguridad.Los plugins de terceros se ejecutan dentro del proceso principal del harness, y no hay verificación de firma ni de origen en el momento de la instalación. Instala solo plugins que hayas leído o que provengan de una fuente de confianza, y pruébalos en un espacio de trabajo desechable antes de usarlos en trabajo real. El danger-full-access, que es un perfil de sandbox, puede modificar cualquier archivo visible: resérvalo para checkouts desechables.

• Existen errores conocidos en la vista previa. Un bucle bash colgado es un modo de fallo documentado (interrumpir y reintentar), y el comportamiento en torno a sesiones de larga duración todavía se está estabilizando.

• Las compilaciones de escritorio no oficiales ya no tienen razón de ser. Hasta el 24 de septiembre de 2026, las únicas aplicaciones de escritorio de dsh instalables con un clic eran envoltorios no firmados de la comunidad, y la elección era entre esos y la línea de comandos. El cliente oficial elimina la disyuntiva: es de primera parte, incluye el runtime y se actualiza por sí solo. No existe una ruta de migración real entre los dos tipos de shell —envuelven el mismo harness—, así que desinstala uno e instala el otro, y conserva el mismo directorio de espacio de trabajo.

• Si necesitas estabilidad en producción, espera a una versión que no sea rc. El harness es potente pero inmaduro. Para una pila de agentes de producción, un harness maduro y probado en batalla — o la ruta de endpoint compatible con Anthropic — es la opción defendible hasta que dsh alcance una etiqueta estable.

En resumidas cuentas

Instalar Deep​Seek Harness ahora son dos tareas distintas según tu plataforma. En Windows o en un Mac con Apple silicon, descarga la 0.1.7-rc.2 desde el host propio de Deep​Seek y ya está: sin Node.js, sin terminal y con la versión más reciente del harness en cualquier canal. En todos los demás casos sigue siendo un solo comando en Node 22.19+: npx @deepseek-ai/dsh@next web, luego añade una clave de modelo y un espacio de trabajo, y envía una tarea de prueba. Usa el modo headless para scripts, la compilación desde el código fuente solo si quieres modificar o seguir main, y considera MCP como algo en desarrollo. La advertencia honesta no ha cambiado: cada uno de estos canales es un release candidate 0.x y romperá cosas de camino a la versión estable; una buena contrapartida si quieres ver hacia dónde lleva Deep​Seek la capa de agentes. Los modelos que ejecuta —Deep​Seek V4 Flash 0731, Deep​Seek V4 Pro 0813 y Deep​Seek V4.1 Flash— están disponibles hoy a precio de tarifa a través de OrcaRouter, listos para impulsar el harness al otro lado de la instalación.