Introducción a DeepSeek Harness
Los modelos de IA ya pueden completar tareas de codificación complejas de forma independiente; el verdadero desafío ya no es hacer que los modelos sean más inteligentes, sinocómo organizar sus capacidades de manera estable, confiable y observable en un Agent realmente utilizable.。
En agosto de 2026, DeepSeek AI publicó como código abiertoDeepSeek Harness（dsh）—untodo es un pluginmarco de Agent, que responde a esta pregunta:Agent = Model + Harness. El modelo es el alma del Agent, y Harness le otorga al Agent la capacidad de entender el entorno, usar herramientas y trabajar de forma continua en escenarios reales.
¿Qué es DeepSeek Harness?
DeepSeek Harness（dsh）Es desarrollado por DeepSeek AIun Agent Harness de código abierto (marco de agente), con licencia MIT, escrito en TypeScript, publicado oficialmente como código abierto en agosto de 2026. Actualmente se encuentra en fase de vista previa para desarrolladores (el equipo oficial advierte que habrá cambios que romperán la compatibilidad en el futuro).
DeepSeek Harness no optimiza el modelo en sí, sino el entorno en el que se ejecuta el modelo,Todo es un plugin (Everything is a Plugin)。
Modelos, herramientas, habilidades, sesiones, sandbox, almacenamiento, bucle (agent loop), programación, UI, etc.Todas las capacidades del Agent son proporcionadas por plugins, que colaboran entre sí mediante los servicios (Service) y eventos (Event) del núcleo Cordis: los desarrolladores pueden seleccionar, reemplazar y ampliar cualquier capacidad en la capa de configuración sin modificar el código fuente.
La capa inferior está impulsada por el sistema de plugins de código abiertoCordis, cuyo diseño corresponde al artículo «A Programming Paradigm for Spatiotemporal Composability». En tiempo de ejecución no existe un kernel privilegiado que requiera parches: cada registro de capacidad es un efecto secundario reversible; al desinstalar un plugin, se revierte automáticamente. Por lo tanto, la forma de extender dsh es montar nuevos plugins junto a otros plugins.
"Everything is a Plugin." (Todo es un plugin) — Lema oficial de DeepSeek Harness
El modelo es el alma del Agent; Harness otorga al Agent la capacidad de entender el entorno, usar herramientas y trabajar de forma continua en escenarios reales.— Sitio web oficial de DeepSeek Harness
¿Por qué se necesita Harness?
La industria está llegando a un consenso cada vez mayor:El cuello de botella no está en la inteligencia del modelo, sino en la infraestructura.En el experimento de un millón de líneas de código del equipo de OpenAI, toda la producción de 5 meses fue realizada por el Agent, y los ingenieros no escribieron ni una línea de código.
LangChain, con solo optimizar el entorno de control externo (estructura de documentos, bucle de validación, sistema de seguimiento), hizo que el Agent de codificación pasara de 52.8% a 66.5% en Terminal Bench 2.0, y que su clasificación mundial saltara del puesto 30 al 5—Sin modificar ni un solo parámetro del modelo subyacente.
DeepSeek Harness es la materialización de este consenso en un producto: no busca modelos más potentes, sino convertir lo que el modelo necesita para ejecutarse—restricciones, retroalimentación, herramientas, memoria, observabilidad—en una infraestructura de plugins componible, para que cada equipo pueda controlar la IA a su manera.
Tres transiciones del paradigma de la ingeniería de IA
Para entender por qué Harness es importante, primero hay que ver claramente cómo hemos llegado hasta aquí, paso a paso:
| Paradigma | Problema central | Objeto de optimización | Modo de interacción |
|---|---|---|---|
| Ingeniería de prompts | Cómo expresarse con claridad | Redacción, formato y ejemplos del prompt | Pregunta y respuesta |
| Ingeniería de contexto | Cómo alimentar información a la IA | Documentos, fragmentos de código, historial de conversaciones | Inyección de información → generación |
| Ingeniería de conducción | Cómo hacer que el Agent funcione de manera confiable | Restricciones, bucles de retroalimentación, sistemas de control | El humano dirige, el Agent ejecuta |
DeepSeek Harness es la materialización completa de la filosofía de la ingeniería de conducciónen un producto completo: una implementación de código abierto que hace realidad restricciones, retroalimentación, observabilidad y sustituibilidad, logrando que la ingeniería de conducción no sea solo una metodología, sino una infraestructura lista para usar.
Arquitectura central: todo es un plugin
La arquitectura de DeepSeek Harness se puede explicar con un diagrama:El núcleo Cordis está en el centro, todas las capacidades lo rodean como plugins y colaboran mediante servicios y eventos.
El mecanismo clave de esta arquitectura en tiempo de ejecución esProfile + paquete combinado (Bundle): el dsh en ejecución es un árbol de plugins compuesto por capas que se superponen en orden durante el inicio: primero se aplica cada paquete según el orden listado en el profile, luego elcordis.patch.ymlpatch de nivel home, y finalmente cualquier--patchoverlay. Con un solo comando se puede ver el árbol de configuración completo realmente iniciado en la máquina:
dsh --profile web --dump-config # Cualquier entrada impresa puede ser reemplazada por tu propio patchCuatro modos de ejecución
DeepSeek Harness ofrece cuatro modos de ejecución listos para usar, que cubren todo el espectro desde un Agent de codificación completo hasta benchmarks mínimos:
| Modo | Posicionamiento | Composición de capacidades |
|---|---|---|
| Modo estándar | Agent de codificación funcionalmente completo | Edición de archivos, Shell, búsqueda de archivos y web, Skills, planificación, objetivos, subagents (subagent) y flujos de trabajo |
| Modo PTC | Composición de llamadas a herramientas mediante código | Posee todas las capacidades del modo estándar y expone las herramientas mediante el SDK de Code Mode, lo que permite al modelo combinar operaciones de varios pasos con un programa TypeScript. |
| Modo minimalista | Benchmark mínimo | Solo conserva bash persistente ystr_replace_editordos herramientas, para la evaluación del modelo en un entorno mínimo. |
| Modo creativo | Preset de Agent personalizado | Posee todas las capacidades del modo estándar y ofrece inspección en tiempo de ejecución, experimentación con plugins y guía para crear presets: combina y crea tu propio nuevo modo. |
Características principales
Característica 1: cada ejecución deja rastro
Todo lo que el modelo ve se escribe enun diseño de solo agregar (append-only)del registro de sesión: el prompt del sistema, la cadena de pensamiento, las llamadas a herramientas y sus resultados, la programación de subagents y cada inyección de contexto, todo se guarda en disco. En lavista Trajectoryse puede consultar por fuente; reanudar, bifurcar (fork), buscar y reproducir comparten el mismo flujo de eventos: cada paso del Agent es rastreable y reproducible.
Característica 2: uso multiforme, ejecución en cualquier lugar
Web UI(por defectohttp://127.0.0.1:3080) proporciona una interfaz gráfica completa;headlessEl modo ejecuta la tarea de una sola vez, imprime la respuesta final y sale; es adecuado para scripts y CI. También están la CLI y el oficialPython SDK（pip install deepseek-harness-sdk, con runtime propio, sin necesidad de Node.js del sistema) y el SDK de TypeScript, para integrar el Agent en cualquier flujo de trabajo.
Característica 3: abierto y controlable, sin kernel privilegiado
Código abierto bajo MIT, no existe un kernel privilegiado que requiera parches: todos los registros de capacidades son efectos secundarios reversibles; al desinstalar un plugin, se revierten automáticamente. La configuración se superpone en capas mediante Profile, paquetes combinados y patches.--dump-configPuedes revisar todo el árbol de configuración en cualquier momento—Tu agente es como tú decidas que sea.
Característica 4: independiente del modelo, plug-and-play
Basta con introducir la clave de API de DeepSeek para usarlo; también admite otros proveedores y endpoints personalizados compatibles con OpenAI. El enrutamiento de modelos no requiere reiniciar el servidor. El sistema de puntos de extensión basado en eventos (eventos de tres niveles: sesión / agente / capacidad) permite a los desarrolladores montar políticas y adaptadores, así como cambiar de modelo, herramientas o almacenamiento en cualquier momento.
Inicio rápido
Después de instalar Node.js, inicia la interfaz web con un solo comando:
npx @deepseek-ai/dsh web
También puedes instalarlo desde el código fuente:
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web
Usar la interfaz web solo requiere tres pasos:
| Paso | Acción | Descripción |
|---|---|---|
| 1 | Configurar el modelo | Abre Configuración → Modelo, introduce la clave de API de DeepSeek y guárdala. El enrutamiento de modelos estará disponible de inmediato, sin necesidad de reiniciar. |
| 2 | Seleccionar el espacio de trabajo | Añade el directorio del proyecto desde el que se inició dsh y selecciónalo (el campo de entrada de sesión no estará disponible hasta que lo selecciones). |
| 3 | Ejecutar tareas | Envía algo como "Summarize this repository": el agente lee y escribe archivos, ejecuta comandos y delega en subagentes; las operaciones que excedan la política de permisos solicitarán tu aprobación primero. |
Relación entre Harness y herramientas relacionadas
DeepSeek Harness no es otra «biblioteca para escribir agentes», sinouna capa completa que se sitúa sobre el SDK y los frameworks, y que resuelve «cómo lograr que los agentes se ejecuten de forma fiable».La diferencia de posicionamiento con las herramientas populares actuales:
| Proyecto | Posicionamiento | Relación con DeepSeek Harness |
|---|---|---|
| Claude Code | Asistente de codificación comercial de código cerrado | Funcionalidad equivalente, pero dsh es completamente de código abierto, se puede autoalojar y sus capacidades son reemplazables. |
| Hermes Agent | Agente personal auto-evolutivo (Nous Research) | Se centra en la memoria entre sesiones y la acumulación de habilidades; dsh se centra en la composición mediante plugins y la observabilidad total. Ambas filosofías son complementarias. |
| OpenClaw | Agente de mensajería local-first | Se centra en la integración multicanal y la soberanía digital; dsh ofrece múltiples formatos: Web UI / headless / SDK. |
| LangGraph / AutoGen / CrewAI | Framework de construcción de agentes (biblioteca de programación) | El framework resuelve «cómo construir»; dsh es un Harness completo: «cómo ejecutarse de forma estable + cómo reemplazar capacidades». |