DeepSeek Harness para diseño.
Un modelo puede escribir JSX, pero un agente de diseño útil necesita algo más que la salida de un modelo. Necesita reglas de marca, referencias, herramientas, permisos y un ciclo que renderice y compruebe el resultado. DeepSeek Harness expone todos esos elementos circundantes en lugar de ocultarlos.
Para trabajar con interfaces, define de forma explícita el encargo y el ciclo de aceptación. La ruta predeterminada de DeepSeek solo admite texto, así que el punto de partida más fiable es un flujo basado en código y especificaciones; adjunta capturas de pantalla solo después de seleccionar una ruta de modelo que declare la entrada de imágenes.
Esa flexibilidad resulta útil para el trabajo de diseño porque la calidad de la interfaz generada depende del entorno que rodea al modelo: reglas persistentes del proyecto, skills reutilizables, el proveedor adecuado para entradas de texto o imagen, herramientas de archivos y shell y un ciclo de verificación. Esta guía muestra la configuración funcional más rápida, las limitaciones relevantes para las tareas de interfaz y la relación real con Open Design: dsh todavía no dispone de un adaptador propio de Open Design, mientras que el adaptador actual de DeepSeek TUI corresponde a una CLI distinta.
Configurar DeepSeek Harness desde cero
La versión preliminar pública requiere Node.js `^22.19.0` o `>=24.0.0`. El comando npm inicializa el perfil web la primera vez que se usa, por lo que puedes acceder a una interfaz local funcional sin clonar el repositorio.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- Las credenciales permanecen referenciadas: La interfaz web almacena los secretos del proveedor en `$DSH_HOME/.credentials.yaml`; la configuración conserva una referencia a las credenciales y la interfaz recibe un descriptor censurado, no la clave literal.
- Trata la versión preliminar como infraestructura con versión fijada: Los responsables del mantenimiento advierten explícitamente de que habrá cambios que rompan la compatibilidad. Fija la versión para los flujos de trabajo del equipo y revisa los cambios de cada versión antes de actualizar.
Por qué un entorno basado en plugins encaja con el trabajo de diseño
Un modelo puede escribir JSX, pero un agente de diseño útil necesita algo más que la salida de un modelo. Necesita reglas de marca, referencias, herramientas, permisos y un ciclo que renderice y compruebe el resultado. DeepSeek Harness expone todos esos elementos circundantes en lugar de ocultarlos.
- Contexto de diseño persistente: El cargador de instrucciones predeterminado lee `AGENTS.md` y `CLAUDE.md` desde la jerarquía del proyecto. Coloca allí los tokens, las reglas de componentes, los puntos de ruptura adaptativos y los criterios de revisión para que estén disponibles en cada ejecución.
- Skills reutilizables: Las skills locales pueden residir en `.dsh/skills` o `.agents/skills`. Una skill de frontend puede reunir el encargo exacto, la lista de comprobación, los ejemplos y los scripts necesarios para que cada tarea de interfaz no empiece desde cero.
- Proveedor según la tarea: La interfaz web permite configurar DeepSeek, proveedores del catálogo como Anthropic u OpenAI y endpoints personalizados compatibles con OpenAI. Usa una ruta declarada con capacidad de imagen para introducir capturas de pantalla; utiliza la ruta nativa de DeepSeek para trabajos basados en texto, código, DOM y especificaciones.
La limitación importante es la misma para cualquier agente: la capacidad de composición no equivale a criterio visual. Sin restricciones deliberadas de tipografía, espaciado, componentes e interacción, el runtime automatizará fielmente un resultado genérico. La función de Open Design es proporcionar y organizar esas entradas de diseño.
Un flujo de trabajo práctico con DeepSeek Harness para interfaces y frontend
Para trabajar con interfaces, define de forma explícita el encargo y el ciclo de aceptación. La ruta predeterminada de DeepSeek solo admite texto, así que el punto de partida más fiable es un flujo basado en código y especificaciones; adjunta capturas de pantalla solo después de seleccionar una ruta de modelo que declare la entrada de imágenes.
- Inicia dsh desde el repositorio, elige ese directorio como espacio de trabajo y selecciona la ruta de modelo para esta tarea.
- Define el contrato de marca en `AGENTS.md`, `CLAUDE.md` o en un archivo `DESIGN.md` referenciado: tokens, elementos primitivos, espaciado, tipografía, puntos de ruptura, estados y patrones prohibidos.
- Carga una skill de frontend específica desde `.dsh/skills` o `.agents/skills`; guarda los ejemplos y los scripts de validación junto a las instrucciones.
- Pide al agente que reutilice los componentes existentes, ejecute la aplicación y valide los estados adaptativos con las pruebas o las herramientas de navegador del propio proyecto.
- Revisa el resultado visible, registra las diferencias concretas e itera con commits pequeños. Revierte los intentos deficientes en lugar de acumular correcciones sobre una base inadecuada.
Un prompt útil especifica tanto las restricciones visuales como las pruebas de verificación:
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.Si una captura de pantalla es imprescindible, configura primero un proveedor con capacidad de imagen. DeepSeek Harness rechaza la imagen antes de enviarla cuando la ruta seleccionada no declara compatibilidad con imágenes, una medida útil para evitar que se omita la referencia de forma silenciosa.
Plugins, skills y contexto del proyecto
DeepSeek Harness se diferencia sobre todo en las capas situadas bajo la superficie del chat. Su árbol de plugins permite que los equipos incorporen el flujo de trabajo de diseño al runtime en vez de pegar un prompt en cada sesión.
- AGENTS.md y CLAUDE.md: El plugin de instrucciones carga el archivo global del usuario y la jerarquía del proyecto y, después de las operaciones de archivos propias, detecta los archivos de instrucciones anidados relevantes. Úsalo para reglas de diseño duraderas, no para peticiones puntuales.
- Skills del sistema de archivos: El registro de skills descubre las raíces del proyecto y del usuario, clasifica los duplicados y expone una herramienta `skill` al modelo. Es un lugar natural para procedimientos de calidad de frontend, accesibilidad, control de calidad adaptativo y sistemas de diseño.
- Perfiles y paquetes: Un perfil apila paquetes de plugins ordenados y modificaciones del usuario. Los equipos pueden mantener una composición centrada en el diseño con el proveedor, las herramientas, la política de permisos y las fuentes de skills que realmente necesitan.
- MCP y capacidades externas: El árbol de código fuente incluye funciones de cliente MCP, pero la configuración de cara al usuario sigue orientada a desarrolladores. Durante la versión preliminar, considera las integraciones como trabajo versionado sobre plugins, no como un flujo estable de casillas de verificación.
Antes de crear un flujo de trabajo interno duradero, inspecciona el árbol efectivo con `dsh --profile web --dump-config`. La salida muestra qué está realmente montado y se puede modificar; es más fiable que asumir que todos los paquetes del repositorio están activos en el perfil incluido.
Riesgos de la versión preliminar y del trabajo de diseño
Los errores más importantes surgen al tratar una versión preliminar como un producto estable, una ruta de solo texto como un modelo de visión o un entorno flexible como una fuente de criterio visual.
- Fija la versión antes de personalizar: Los cambios que rompen la compatibilidad forman parte explícita de la política de la versión preliminar. Fija la versión de npm y procura que las modificaciones de los perfiles sean lo bastante pequeñas como para revisarlas después de actualizar.
- Comprueba las modalidades del modelo seleccionado: La ruta nativa de finalización de chat de DeepSeek solo admite texto. Para convertir capturas en código, selecciona y declara una ruta de proveedor con capacidad de imagen en vez de dar por hecho que se comprenderá el archivo adjunto.
- Proporciona el criterio visual como datos: Facilita al agente tokens, componentes canónicos, estados de referencia y patrones prohibidos. Un runtime modular sin un contrato de diseño sigue generando interfaces genéricas.
- Verifica qué monta realmente el perfil: Los paquetes del repositorio son capacidades, no pruebas de que el perfil predeterminado las haya habilitado. Inspecciona la configuración compuesta antes de documentar una integración o depender de ella.
Cada medida implica una decisión de contexto y verificación. Esa es precisamente la labor que una capa de diseño debe hacer repetible, en vez de obligar a cada proyecto a redescubrirla.
Qué es realmente DeepSeek Harness
DeepSeek Harness (`dsh`) es un entorno de agentes con licencia MIT desarrollado por DeepSeek AI. La versión preliminar pública para desarrolladores incluye una interfaz web local y un ejecutor sin interfaz. No es un modelo ni una simple capa visual para la terminal: es el runtime que reúne un modelo, herramientas, contexto, permisos, sesiones e interfaz de usuario para formar un agente.
Su idea central es que «todo es un plugin». Cordis compone un árbol en el que el adaptador de modelo, el registro de herramientas, el bucle del agente, el sistema de archivos, el shell, el sandbox, las skills, los subagentes, la persistencia y la interfaz se pueden montar, sustituir o modificar mediante perfiles y paquetes. Los perfiles incluidos `web` y `headless` son puntos de partida, no productos inmutables.
- Interfaz web local: `npx @deepseek-ai/dsh web` inicia de forma predeterminada un espacio de trabajo en el navegador en `127.0.0.1:3080`. Añade un modelo, elige un espacio de trabajo y ejecuta tareas desde la interfaz de conversación.
- Modo sin interfaz: El perfil `headless` ejecuta una sesión nueva con persistencia, imprime la respuesta final y termina; resulta útil para auditorías mediante scripts, compilaciones y comprobaciones de diseño repetibles.
- Runtime componible: Los perfiles apilan paquetes de plugins y tus propias modificaciones. Así, un equipo puede cambiar proveedores, herramientas, políticas y el comportamiento de la interfaz sin crear un fork del bucle de un agente.
- Desarrollador: DeepSeek AI (proyecto oficial)
- Estado: versión preliminar para desarrolladores; se esperan cambios que rompan la compatibilidad
- Licencia: MIT
- Comando principal: `npx @deepseek-ai/dsh web`
DeepSeek Harness frente a DeepSeek TUI y otros agentes de diseño
Es fácil confundir los nombres. DeepSeek Harness y DeepSeek TUI, que figura actualmente en Open Design, son proyectos independientes con ejecutables y estados de integración distintos.
| Herramienta | Qué es | Mejor uso para diseño |
|---|---|---|
| DeepSeek Harness (`dsh`) | Entorno oficial de DeepSeek AI basado en plugins, con interfaz web local y perfiles sin interfaz; versión preliminar para desarrolladores | Equipos que quieren componer el runtime, las skills, los proveedores, las políticas y la interfaz en torno a un flujo de trabajo de diseño |
| DeepSeek TUI (`deepseek` / `codewhale`) | Un agente de programación independiente para terminal y el adaptador de DeepSeek que Open Design admite actualmente | Usar DeepSeek desde Open Design hoy |
| OpenCode | Agente maduro, de código abierto e independiente del proveedor para terminal | Cambiar de modelo dentro de un flujo estable de TUI con AGENTS.md y MCP |
| Claude Code | Agente de programación maduro para terminal, IDE, escritorio y web | Razonamiento de frontend, referencias con muchas imágenes e integraciones de diseño consolidadas |
| Open Design | Espacio de trabajo de diseño nativo para agentes y biblioteca para agentes de programación compatibles | Sistemas de diseño seleccionados, skills, artefactos visuales y un flujo de trabajo local independiente de un único proveedor de modelos |
Elige dsh cuando lo que quieras ampliar sea el propio entorno. Elige DeepSeek TUI dentro de Open Design si buscas el adaptador de DeepSeek compatible actualmente y una capa de diseño lista para usar. Podrían converger mediante un adaptador futuro, pero hoy no son intercambiables.
Usar DeepSeek Harness con un espacio de trabajo de diseño nativo para agentes
Open Design y DeepSeek Harness ocupan capas contiguas. dsh compone un runtime de agentes; Open Design selecciona los sistemas de diseño, las skills y el flujo de trabajo local con artefactos que hacen que un agente resulte útil para el trabajo visual. Open Design todavía no incluye un adaptador específico para `dsh`, por lo que el flujo de trabajo correcto actualmente consiste en usarlos en paralelo.
- Instala Open Design y utiliza sus sistemas de diseño y skills para establecer el contrato visual del proyecto.
- Guarda el archivo `DESIGN.md` resultante, las referencias y las instrucciones del proyecto en el mismo repositorio que DeepSeek Harness abre como espacio de trabajo.
- Ejecuta dsh para realizar experimentos basados en plugins y tareas de código; reutiliza los mismos tokens, reglas, recursos y criterios de validación en vez de mantener un segundo encargo de diseño.
- Cuando necesites DeepSeek directamente dentro de Open Design, selecciona el adaptador de DeepSeek TUI existente. Considera un futuro adaptador para dsh como una integración independiente, no como una función disponible actualmente.
El resultado es un único código base bajo tu control y un contrato de diseño portátil para dos herramientas locales. Open Design es independiente de DeepSeek AI; DeepSeek y DeepSeek Harness son marcas comerciales de su respectivo propietario.
Preguntas frecuentes sobre DeepSeek Harness
-
01 ¿Qué es DeepSeek Harness?
DeepSeek Harness (`dsh`) es el entorno de agentes oficial y de código abierto de DeepSeek AI. Combina modelos, herramientas, contexto, sesiones, políticas, orquestación e interfaz mediante un árbol de plugins de Cordis. La versión pública es actualmente una versión preliminar para desarrolladores bajo la licencia MIT.
-
02 ¿Cómo instalo y ejecuto DeepSeek Harness?
Instala una versión compatible de Node.js y ejecuta `npx @deepseek-ai/dsh web`. De forma predeterminada, inicia la interfaz web local en `http://127.0.0.1:3080`. Añade un modelo en Settings → Models, elige un espacio de trabajo e inicia una sesión.
-
03 ¿DeepSeek Harness es un proyecto oficial de DeepSeek?
Sí. El repositorio se publica en la organización `deepseek-ai` de GitHub y describe dsh como un entorno de agentes desarrollado por DeepSeek AI. Tiene licencia MIT y está marcado explícitamente como versión preliminar para desarrolladores.
-
04 ¿Puede DeepSeek Harness crear interfaces a partir de capturas de pantalla?
Solo cuando la ruta del proveedor seleccionada declara la entrada de imágenes. La ruta de finalización de chat propia de DeepSeek en dsh solo admite texto, y el entorno rechaza los archivos de imagen antes de enviarlos por una ruta de solo texto. Usa un proveedor con capacidad de imagen para las capturas o describe el objetivo mediante código, DOM, tokens y especificaciones escritas.
-
05 ¿DeepSeek Harness es compatible con AGENTS.md y las skills?
Sí. Su plugin de instrucciones carga AGENTS.md y archivos de proyecto compatibles con CLAUDE.md. Su proveedor de skills del sistema de archivos descubre las skills del proyecto en `.dsh/skills` y `.agents/skills`, además de las raíces configuradas del usuario y de los paquetes incluidos.
-
06 ¿Cuál es la diferencia entre DeepSeek Harness y DeepSeek TUI?
Son herramientas independientes. DeepSeek Harness usa el ejecutable `dsh` y es un runtime oficial de DeepSeek AI basado en plugins, con interfaz web y modo sin interfaz. DeepSeek TUI usa el dispatcher `deepseek` o `codewhale` y es el adaptador independiente de DeepSeek que Open Design admite actualmente.
-
07 ¿Open Design es compatible con DeepSeek Harness?
Todavía no mediante un adaptador propio específico. Open Design admite actualmente el adaptador independiente de DeepSeek TUI. Aun así, puedes usar los sistemas de diseño, las skills, los archivos DESIGN.md y los artefactos de Open Design junto con dsh en el mismo repositorio local.
-
08 ¿Dónde almacena DeepSeek Harness mi clave de API?
La guía oficial de modelos indica que las claves de los proveedores se almacenan en `$DSH_HOME/.credentials.yaml`. La configuración solo conserva una referencia a las credenciales y la interfaz web recibe un descriptor censurado, no el secreto literal.
Crea la capa de diseño que rodea tu flujo de trabajo con DeepSeek.
Usa hoy los sistemas de diseño locales, las skills y el flujo de trabajo con artefactos de Open Design, y conserva el mismo contrato del proyecto para cualquier runtime de agentes que elijas después.