DeepSeek Harness: instalación, perfiles y primera ejecución
Updated August 16, 2026 · first published August 16, 2026
Esta es la mitad práctica de nuestra cobertura de DeepSeek Harness: cómo poner dsh en marcha, qué espera de usted el modelo de composición y qué demos merecen diez minutos.
La vía más rápida
npx @deepseek-ai/dsh webEso inicia la interfaz web en http://127.0.0.1:3080. A partir de ahí deben ocurrir dos cosas antes de que el compositor de sesión sea utilizable:
- Ajustes → Modelos, e introducir su clave de API de DeepSeek. La ruta se habilita al momento, sin reiniciar.
- Elegir espacio de trabajo, para añadir y activar el directorio del proyecto. Hasta que haya un espacio activo, el compositor permanece deshabilitado.
Una vez en marcha, el agente puede leer y editar archivos, ejecutar comandos, delegar tareas en subagentes y planificar. Pide confirmación según la política de permisos activa.
Desde el código fuente
git clone https://github.com/deepseek-ai/deepseek-harness
pnpm install
pnpm run build
pnpm dsh webMínimos a tener en cuenta: Node 22.19 o superior (la CI cubre 22.19, 24 y 26), Git 2.26 o superior, y Corepack con pnpm fijado en pnpm@11.7.0. Una DEEPSEEK_API_KEY es opcional y se lee del entorno o de un .env ignorado por git en la raíz del repositorio; junto a ella, DEEPSEEK_BASE_URL puede apuntar a otro endpoint. Las suites de extremo a extremo contra la API real se autoexcluyen cuando falta la clave, así que un checkout sin clave compila y pasa pruebas sin problemas.
Perfiles y bundles: el modelo de composición
Como cada parte del harness es un plugin, algo tiene que decir qué plugins se cargan. Eso es un perfil: una composición con nombre que guarda una lista ordenada de bundles más los parches del usuario. Un bundle distribuye filas de configuración de Cordis y código.
Se incluyen tres perfiles plantilla:
| Perfil | Qué compone |
|---|---|
dsh-base | Adaptadores de modelo, herramientas, persistencia |
dsh-web-app | La interfaz de navegador |
dsh-headless | Ejecutor de una sola pasada |
El orden de sobreescritura en cuatro capas
La configuración se resuelve en un orden fijo, ganando las capas posteriores:
- Bundles del perfil
- Parches del perfil
- Parches a nivel de home
- Overlays de línea de comandos
Aprenda este orden antes de empezar a depurar. Casi toda pregunta del tipo «por qué está usando ese modelo» en un sistema de configuración por capas se responde encontrando qué capa tocó el valor en último lugar, y un overlay de línea de comandos gana a todo lo que tiene debajo.
Los subsistemas que va a encontrar
Seis claves de registro cargan con la mayor parte del comportamiento: ctx.sessions (el registro de eventos solo-anexado), ctx.systemPrompt, ctx.tools (un registro con scope y ejecución vigilada), ctx.agents, ctx.agentLoop y ctx.llm. Si va a extender el harness, esos son los nombres que buscar primero.
Tres demos que vale la pena ejecutar
- Headless de una pasada:
pnpm dsh --profile headless "summarize this workspace". La forma que cablearía en CI o en un cron. - Introspección de Cordis:
pnpm run demo:cordis. Autorreferencial: inspecciona y modifica su propio runtime de plugins en caliente. Es la demostración más clara de que la afirmación sobre plugins es estructural y no publicitaria. - Automatización ACP:
pnpm run demo:acp. Un servidor de automatización que habla JSON-RPC sobre stdio, que es la superficie de integración para gobernar el harness desde otro sistema.
Si piensa contribuir
Unas cuantas convenciones ahorran tiempo. Las marcas TODO están graduadas por urgencia: FIXME bloquea la release, TODO es pronto, XXX es algún día. Lefthook ejecuta pre-commit (registros de pairing en staged, .oxlintrc.staged.json, regeneración de avisos de terceros, espacios en blanco, guardián del manifiesto de vendor), pre-merge-commit y pre-push (pnpm run typecheck). Los hooks se saltan tests y builds deliberadamente: la CI es dueña de la cobertura exhaustiva, y pnpm run check:all es la puerta local completa y opcional.
Dos rarezas explican una estructura que si no resultaría confusa. El build se divide en agregados tsconfig de Host y Client porque ambos lados fusionan por declaración la interfaz Context de Cordis bajo las mismas claves, y un único programa de TypeScript que vea ambas fusiones reporta una colisión. Y los ejemplos de código de la documentación se mantienen honestos con bloques ts type-equiv más pnpm run verify-type-equiv, de modo que las declaraciones pegadas no puedan divergir en silencio del código fuente.
Fijar expectativas
El README lo dice sin rodeos: esto es un developer preview y habrá cambios que rompan compatibilidad. El descubrimiento de plugins pasa por el topic de GitHub dsh-plugin, el proyecto tiene licencia MIT y las dependencias de terceros están listadas en THIRD_PARTY_NOTICES.md. Evalúelo ahora; estandarice más tarde.
Related
- ¿Qué es DeepSeek Harness? Guía completa
- Qué aporta de verdad «todo es un plugin» (EN)
- Dónde poner los límites de gasto (EN)
- El registro de sesión como registro de costes (EN)
Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →