Diseña con DeepSeek Harness.
DeepSeek Harness puede crear landing pages, interfaces de producto, paneles y prototipos frontend porque puede leer un repositorio, editar código de UI real, ejecutar comandos, cargar instrucciones del proyecto y mantener una sesión entre iteraciones. Lo que no aporta por sí solo es criterio visual: un trabajo de diseño útil sigue necesitando reglas de marca, referencias, herramientas, permisos y un ciclo que renderice y compruebe el resultado.
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.
El modelo sigue necesitando orientación visual. La forma más sencilla de proporcionársela es conectar DeepSeek Harness con OpenDesign: OpenDesign aporta el sistema de diseño, las skills de frontend, la vista previa de artefactos y la superficie de revisión; dsh se encarga del código. Esta guía recorre ese flujo de trabajo desde la [página oficial de DeepSeek Harness](https://www.deepseek.com/harness/) y el [repositorio de código fuente](https://github.com/deepseek-ai/deepseek-harness) hasta una interfaz terminada.
¿Puede DeepSeek Harness encargarse del diseño?
DeepSeek Harness puede crear landing pages, interfaces de producto, paneles y prototipos frontend porque puede leer un repositorio, editar código de UI real, ejecutar comandos, cargar instrucciones del proyecto y mantener una sesión entre iteraciones. Lo que no aporta por sí solo es criterio visual: un trabajo de diseño útil sigue necesitando reglas de marca, referencias, herramientas, permisos y un ciclo que renderice y compruebe el resultado.
- 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 OpenDesign es proporcionar y organizar esas entradas de diseño.
¿Existe una GUI para DeepSeek Harness?
Sí. DeepSeek Harness incluye una interfaz gráfica de serie: ejecuta `dsh web` y la Web UI local oficial se abre en `http://127.0.0.1:3080` con una vista de espacio de trabajo, sesiones y un selector de modelos. No hay que descargar ningún instalador de escritorio aparte: la Web UI forma parte del mismo paquete `@deepseek-ai/dsh` que el runtime headless.
La Web UI integrada es una consola de sesiones: el lugar indicado para configurar proveedores, elegir modelos y seguir las ejecuciones. No es una superficie de diseño: no tiene previsualización de artefactos, ni reglas de sistema de diseño, ni revisión visual. Si buscas una GUI para DeepSeek Harness porque quieres ver y dirigir lo que dsh construye, conéctalo a la aplicación de escritorio de OpenDesign: OpenDesign ejecuta tu instalación de dsh como agente local de primera clase y añade a su alrededor el espacio de trabajo de diseño visual.
- `dsh web` — la Web UI oficial integrada. Una consola de sesiones local para proveedores, modelos, sesiones y ejecuciones.
- OpenDesign — un espacio de trabajo visual de código abierto (Apache-2.0) y local-first que envuelve dsh: previsualización de artefactos, sistemas de diseño, skills reutilizables y revisión en una sola GUI.
- Wrappers de escritorio de la comunidad — proyectos no oficiales que reempaquetan la Web UI. Persiguen una developer preview que cambia muy rápido, así que verifica el mantenimiento y la procedencia antes de depender de uno.
El resto de esta guía usa las dos primeras opciones en conjunto: `dsh web` una sola vez para configurar el proveedor, y luego OpenDesign como espacio de trabajo gráfico para el trabajo de diseño propiamente dicho.
Paso 1: Instale y configure DeepSeek Harness
Primero, asegúrese de que DeepSeek Harness funcione por sí solo. Instale la versión probada de dsh y abra su Web UI local para configurar la clave API y el modelo antes de abrir OpenDesign. La versión preliminar para desarrolladores requiere Node.js `^22.19.0` o `>=24.0.0`.
# OpenDesign currently tests DeepSeek Harness 0.1.0-rc.6
# Requires Node.js ^22.19.0 or >=24.0.0
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
# Verify the local executable
dsh --version
# Start the local Web UI and configure a provider and model
dsh web
# Open http://127.0.0.1:3080- Abra la Web UI de Harness: Ejecute `dsh web`. Normalmente abre `http://127.0.0.1:3080`; si el navegador no se abre, copie la dirección que muestra el terminal y use exactamente esa dirección.
- Añada la clave API de DeepSeek: Continúe después del aviso de versión preliminar y guarde o aplique la clave cuando se le solicite. Si no aparece el aviso, abra Configuración → Modelos → DeepSeek → Clave API. Pegue solo la clave, sin `DEEPSEEK_API_KEY=...` ni comillas. El cambio se aplica de inmediato; no es necesario reiniciar `dsh web`. Si la necesita, créela en DeepSeek Platform.
- Confirme el modelo y cierre la UI de configuración: El proveedor DeepSeek debe aparecer como configurado y sus modelos deben mostrarse en el selector. Si ve `MISSING_CREDENTIAL`, vuelva a abrir la tarjeta DeepSeek y guarde de nuevo la clave. Cuando funcione un mensaje de prueba, pulse `Ctrl+C`; no es necesario mantener `dsh web` abierto mientras usa OpenDesign.
DeepSeek Harness guarda las credenciales de proveedor como secretos de solo escritura: la UI puede indicar si una clave está configurada, pero no puede leer ni mostrar la clave en texto plano. OpenDesign reutiliza este dsh instalado por el usuario y su configuración de modelos sin copiar la clave en OpenDesign. Para un flujo de trabajo fiable, mantenga dsh fijado en la versión probada `0.1.0-rc.6`. Consulte la guía oficial de proveedores para conocer el funcionamiento original de las credenciales.
Paso 2: Descargue OpenDesign 0.19.1 o posterior
Cuando dsh funcione localmente, el resto se hace en OpenDesign. La integración con DeepSeek Harness está disponible a partir de OpenDesign 0.19.1.
Obtenga la versión actual para escritorio en la página de descarga de OpenDesign, instálela e inicie la aplicación.
Paso 3: Detecte DeepSeek Harness
Abra Configuración → Modelos y proveedores → Local CLI y elija Volver a escanear. Reinicie OpenDesign o vuelva a escanear si ya estaba abierto durante la instalación. La tarjeta DeepSeek Harness aparecerá cuando OpenDesign encuentre el ejecutable `dsh` del paso 1.
Paso 4: Conecte el perfil de OpenDesign
Seleccione la tarjeta DeepSeek Harness. Si muestra «Se requiere configuración de conexión», confirme «Instalar y seleccionar». OpenDesign verifica su propio componente, pide a dsh que lo instale en el perfil `open-design`, vuelve a escanear y prueba la conexión.
Con esto se completa la conexión. La UI y `od agent setup deepseek-harness --json` usan la misma ruta de configuración local; cada ejecución inicia `dsh --profile open-design --stdio`, mientras Harness conserva la identidad de la sesión para los turnos posteriores.
Paso 5: Inicie una tarea de diseño
Confirme que la tarjeta muestre la versión de Harness y «Sincronizado desde CLI» y, después, haga clic en Probar. Cuando la prueba termine correctamente, abra o cree un proyecto, elija DeepSeek Harness y un modelo sincronizado, y envíe su solicitud de diseño.
Create a polished product landing page in this workspace.
Use DESIGN.md, AGENTS.md, and the installed frontend skill as the visual contract.
Reuse the project tokens and components; include desktop and mobile states.
Run the app, inspect the rendered result, fix visible spacing and hierarchy issues,
and leave the final HTML and assets in the project for OpenDesign to preview.
El límite es sencillo: Harness gestiona dsh, las credenciales, los modelos y las sesiones; OpenDesign gestiona el perfil de conexión verificado y el workspace de diseño. OpenDesign es independiente de DeepSeek AI, y DeepSeek y DeepSeek Harness son marcas comerciales de sus respectivos propietarios.
Ejecute el ciclo de compilación y revisión de UI
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.
Haga que el flujo de trabajo sea reutilizable con plugins y skills
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.
Evite los fallos que arruinan el resultado visual
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é aporta el entorno de agentes al diseño
DeepSeek Harness (`dsh`) es un entorno de agentes con licencia MIT desarrollado por DeepSeek AI. La página oficial del producto presenta el proyecto; el repositorio de GitHub contiene el código fuente, el historial de versiones y las guías mantenidas. La versión preliminar pública para desarrolladores incluye una interfaz web local y perfiles sin interfaz.
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, DeepSeek TUI y OpenDesign
DeepSeek Harness y DeepSeek TUI son proyectos separados con diferentes ejecutables. OpenDesign ahora admite ambos como agentes locales, por lo que la elección es qué runtime desea, no si cualquiera de ellos puede ingresar al espacio de trabajo de diseño.
| 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; adaptador propio de OpenDesign | Uso de sesiones, proveedores y composición de plugins de Harness dentro del flujo de trabajo de artefactos de OpenDesign |
| DeepSeek TUI (`deepseek` / `codewhale`) | Un agente de programación para terminal independiente con su propio adaptador de OpenDesign | Un flujo de trabajo DeepSeek que prioriza el terminal sin la arquitectura de perfil Harness |
| 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 |
| OpenDesign | 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 |
Elija DeepSeek Harness si busca su Web UI oficial, su sistema de perfiles, su catálogo de modelos y sesiones de Harness que se pueden reanudar. Elija DeepSeek TUI dentro de OpenDesign si prefiere el flujo de trabajo orientado al terminal de ese agente. Siguen siendo runtimes distintos, aunque OpenDesign ahora puede integrar cualquiera de ellos en el mismo proceso de diseño.
Uso de DeepSeek Harness para diseño: preguntas frecuentes
-
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?
Instale la CLI probada con `npm install -g @deepseek-ai/dsh@0.1.0-rc.6` y ejecute `dsh web`. Continúe después del aviso de versión preliminar y guarde únicamente la clave API en Configuración → Modelos → DeepSeek → Clave API. Confirme que el proveedor y el modelo funcionan, detenga la Web UI con `Ctrl+C`, instale OpenDesign 0.19.1 o posterior, vuelva a escanear los agentes de Local CLI, conecte la tarjeta Harness y haga clic en Probar.
-
03 ¿DeepSeek Harness tiene GUI o interfaz web?
Sí. Ejecuta `dsh web` para iniciar la Web UI local oficial en `http://127.0.0.1:3080`: una consola de sesiones gráfica para proveedores, modelos, sesiones y ejecuciones, incluida en el paquete `@deepseek-ai/dsh`. Para un espacio de trabajo de diseño gráfico completo sobre dsh — previsualización visual de artefactos, sistemas de diseño, skills y revisión — conéctalo a la aplicación de escritorio de OpenDesign, que ejecuta dsh como agente local de primera clase.
-
04 ¿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.
-
05 ¿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.
-
06 ¿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.
-
07 ¿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 OpenDesign admite actualmente.
-
08 ¿OpenDesign es compatible con DeepSeek Harness?
Sí. OpenDesign detecta su instalación oficial de dsh, instala un componente de perfil verificado propiedad de OpenDesign tras su confirmación explícita, sincroniza el catálogo de modelos de Harness y ejecuta DeepSeek Harness como agente local propio. OpenDesign no instala dsh ni recibe los secretos del proveedor que gestiona Harness.
-
09 ¿Dónde almacena DeepSeek Harness mi clave de API?
Configure la clave en DeepSeek Harness, no en OpenDesign. Según la guía oficial de modelos, las claves de proveedor se guardan en `$DSH_HOME/.credentials.yaml` como secretos de solo escritura: la UI puede comprobar si hay una clave configurada, pero no puede leer ni mostrar su valor en texto plano. OpenDesign no le pide que pegue la clave en la aplicación ni la escribe en la configuración de OpenDesign.
Diseña con DeepSeek Harness en OpenDesign.
Instale el runtime oficial dsh, conéctelo una vez y luego use los sistemas de diseño, las skills, los modelos sincronizados y las vistas previas de artefactos locales de OpenDesign en un solo flujo de trabajo.