Ejecutar un Agent de código en un repositorio
Necesita leer y editar archivos, ejecutar Shell, buscar en la web, y dejar que el modelo complete de forma continua tareas de ingeniería de varios pasos.
Vista previa para desarrolladores · MIT de código abierto · 2026-08
DeepSeek Harness: que el modelo trabaje de forma continua en un entorno real
DeepSeek Harness (dsh) no es un nuevo modelo de chat, sino una capa de ejecución Agent de código abierto. El modelo piensa; el Harness aporta las herramientas, las sesiones, el entorno aislado y los registros reproducibles. La fórmula es sencilla: Agent = modelo + Harness.
Página actualizada el 2026-08-18 · Elaborada a partir de la información pública de la vista previa para desarrolladores oficial
¿Qué es DeepSeek Harness?
Separe primero «modelo» y «Harness», y luego decida qué capa instalar.
Agent = modelo + Harness
El modelo es el alma: razona, divide las tareas y decide el siguiente paso.
El Harness es las manos y el terreno: entiende el entorno, llama a las herramientas y trabaja de forma continua en un repositorio real.
DeepSeek Harness es la infraestructura de ejecución Agent que DeepSeek publicó en agosto de 2026 para desarrolladores de todo el mundo (vista previa para desarrolladores). El código fuente se abre con licencia MIT, el paquete npm se llama @deepseek-ai/dsh, y el repositorio está en GitHub en deepseek-ai/deepseek-harness.
Lo que resuelve no es «lanzar otro modelo que sepa chatear», sino: el modelo ya sabe razonar; cómo editar archivos, ejecutar comandos, llamar herramientas, escribir registros en un directorio real, y reanudar tras un fallo. Sin Harness, lo más habitual es quedarse en el cuadro de diálogo; con Harness, el modelo puede ejecutarse de forma continua dentro de límites controlados.
El lema oficial es «todo es un plugin». La ruta predeterminada sigue exigiendo configurar una DeepSeek API Key. El Web UI se puede abrir gratis; ejecutar de verdad un Agent genera costes de llamadas al modelo. Actualmente pertenece a la serie de vista previa v0.1, y los plugins centrales y las API pueden sufrir cambios incompatibles.
¿Quién debería usar DeepSeek Harness?
No es el mismo tipo de entrada que el chat web de este sitio. Elija la herramienta según la tarea.
-
-
Crear plugins o presets personalizados
Quiere sustituir el modelo, las herramientas, el entorno aislado o la UI, y ensamblar su propio Agent, sin modificar el tronco del Harness.
-
Solo quiere abrir el navegador y chatear
No hace falta instalar Node.js. Use la entrada web DeepSeek de este sitio y converse directamente con DeepSeek-V4.
Puntos de arquitectura: todo es un plugin
DeepSeek Harness se basa en Cordis. El núcleo solo se ocupa de cargar y de las dependencias; todas las capacidades concretas las aportan los plugins.
-
01
Núcleo Cordis
Solo se encarga del montaje, desmontaje y las relaciones de dependencia de los plugins. No escribe la lógica de negocio del Agent en el tronco, para evitar tener que bifurcar todo el repositorio cada vez que se cambia una capacidad.
-
02
Todas las capacidades son plugins
Adaptadores de modelo, herramientas, Skills, sesiones, entornos aislados, almacenamiento, bucles, programación e interfaz pueden combinarse como plugins y colaborar mediante servicios y eventos.
-
03
Recomposición en la capa de configuración
Los desarrolladores no necesitan modificar el código fuente del Harness: pueden elegir, sustituir o ampliar cualquier capacidad en la capa de configuración, y ensamblar un Agent según el escenario.
Cuatro modos de ejecución
El mismo núcleo de plugins carga por defecto combinaciones distintas, cubriendo la codificación diaria, las llamadas programáticas a herramientas, las pruebas de referencia y los presets personalizados.
Modo estándar
Un Agent de código con funciones completas.
Admite edición de archivos, Shell, búsqueda de archivos y web, Skills, planificación, objetivos, subagentes y flujos de trabajo. Pensado para las tareas cotidianas del repositorio.
Modo PTC
Combinar varias rondas de llamadas a herramientas con un programa.
Incluye las capacidades del modo estándar y presenta las herramientas a través del Code Mode SDK, para que el modelo orqueste operaciones de varios pasos con un programa TypeScript.
Modo mínimo
La superficie de herramientas más pequeña, para pruebas de referencia.
Suele conservar solo bash persistente y edición de archivos (str_replace_editor), para observar el modelo en un entorno minimizado.
Modo creación
Inspeccionar el runtime y crear presets personalizados.
Sirve para ver los plugins actuales, probar plugins Cordis en memoria y componer nuevos modos de ejecución.
Cada ejecución deja rastro
Las sesiones se registran como un flujo de eventos de solo añadido. Reanudación, bifurcación, búsqueda y reproducción comparten el mismo registro.
-
Las indicaciones del sistema, la cadena de pensamiento, las llamadas a herramientas y los resultados se escriben en el registro de sesión
-
El despacho de sub-Agent y cada inyección de contexto se pueden consultar por origen
-
La vista Trajectory ayuda a auditar qué vio el modelo y qué hizo
-
Las operaciones de alto riesgo deben ir con permisos y aprobación, no entregar el repositorio desnudo al modelo
Empezar
Prueba rápida o instalación desde el código fuente
Hace falta tener Node.js instalado en el equipo. Los requisitos de versión siguen el README del repositorio oficial.
Prueba rápida
Tras instalar Node.js, puede iniciar el Web UI con npx. Por defecto se abre en el puerto local 3080: http://127.0.0.1:3080
$ npx @deepseek-ai/dsh webInstalación desde el código fuente
Obtenga el código fuente completo del proyecto y siga las instrucciones del repositorio para terminar la instalación (pnpm install, pnpm run build, pnpm dsh web).
$ git clone https://github.com/deepseek-ai/deepseek-harnessConfigurar API Key y modelo
En la interfaz, configure una DeepSeek API Key y elija DeepSeek-V4-Flash o DeepSeek-V4-Pro. Se recomienda probar primero con Flash.
Indicar el espacio de trabajo y los permisos
Elija el directorio del repositorio y restrinja los permisos de archivos y comandos antes de asignar tareas. En la fase de vista previa, comandos y configuración pueden cambiar: siga la documentación del repositorio.
¿En qué se diferencian el chat web y Harness?
El chat web DeepSeek de este sitio resuelve «abrir y hablar»; Harness resuelve «ejecutar de forma continua en un repositorio».
| Comparación | Chat web DeepSeek | DeepSeek Harness |
|---|---|---|
| Qué está buscando | Entrada de chat en línea sin instalar nada | Capa de ejecución Agent local / a nivel de código fuente |
| Usuarios típicos | Estudio, oficina, escritura, preguntas y respuestas | Desarrolladores y quienes crean Agent y plugins |
| ¿Puede modificar archivos del repositorio? | Principalmente conversación | Puede leer y escribir archivos y ejecutar comandos dentro de los permisos |
| Cómo empezar | Abrir la entrada de este sitio en el navegador | Iniciar el Web UI con npx o clonar el código fuente |
Preguntas frecuentes sobre DeepSeek Harness
Sobre la licencia de código abierto, los costes, la elección del modelo y las diferencias con el chat web.
¿DeepSeek Harness es un modelo oficial nuevo?
No. Es el framework de ejecución Agent de código abierto de DeepSeek (Harness), que conecta modelos, herramientas, sesiones e interfaz. El chat y el razonamiento siguen viniendo de modelos como DeepSeek-V4.
¿DeepSeek Harness es gratis?
El código fuente del framework se publica con licencia MIT y se puede obtener gratis. Ejecutar un Agent suele llamar a la API de DeepSeek y genera costes de tokens. Siga los precios oficiales y el saldo de su clave.
¿Es lo mismo que el chat web DeepSeek de este sitio?
No. El chat web está pensado para abrir el navegador y hablar; Harness está pensado para que los desarrolladores ejecuten un Agent de código en un entorno real. Si necesita chatear, use la entrada de este sitio; si necesita modificar código y ejecutar herramientas, use Harness.
¿Hay que desplegar un modelo grande en local para usar Harness?
No. La ruta habitual en la documentación pública es usar la API en la nube de DeepSeek. Necesita Node.js, una API Key y un navegador; no es obligatorio disponer de GPU propia.
¿Se puede usar ya en producción?
La documentación oficial lo marca como vista previa para desarrolladores e indica que habrá cambios incompatibles. Sirve para aprender, experimentar y desarrollar plugins. Evalúe usted mismo la estabilidad antes de producción y fije una versión que haya verificado.
¿Qué es dsh y cómo se inicia?
dsh es la abreviatura habitual y el nombre CLI de DeepSeek Harness. Tras instalar Node.js, ejecute npx @deepseek-ai/dsh web. El Web UI se abre por defecto en http://127.0.0.1:3080.
Separe primero el escenario, luego elija la entrada
Si quiere conversar ahora, abra el chat web DeepSeek; si quiere ejecutar un Agent en un repositorio, use el DeepSeek Harness oficial.
Esta página la elabora el sitio DeepSeek-V4 a partir de la página oficial de Harness de DeepSeek y del repositorio de GitHub, para facilitar la búsqueda y la comparación. No es un sitio oficial de DeepSeek. Instalación, configuración y compatibilidad se rigen por la documentación oficial y el README del repositorio.