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 Open Design: Open Design 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 Open Design es proporcionar y organizar esas entradas de diseño.
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 Open Design. La versión preliminar para desarrolladores requiere Node.js `^22.19.0` o `>=24.0.0`.
# Open Design currently tests DeepSeek Harness 0.1.0-rc.6
# Requires Node.js ^22.19.0 or >=24.0.0
npm install -g @deepseek-ai/[email protected]
# 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 Open Design.
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. Open Design reutiliza este dsh instalado por el usuario y su configuración de modelos sin copiar la clave en Open Design. 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.
Pasos 2–5: Conecte DeepSeek Harness con Open Design
Cuando dsh funcione localmente, el resto se hace en Open Design. La integración con DeepSeek Harness está disponible a partir de Open Design 0.19.1.
- 2 · Descargue Open Design 0.19.1 o posterior: Obtenga la versión actual para escritorio en la página de descarga de Open Design, instálela e inicie la aplicación.
- 3 · Detecte DeepSeek Harness: Abra Configuración → Modelos y proveedores → Local CLI y elija Volver a escanear. Reinicie Open Design o vuelva a escanear si ya estaba abierto durante la instalación. La tarjeta DeepSeek Harness aparecerá cuando Open Design encuentre el ejecutable `dsh` del paso 1.
- 4 · Conecte el perfil de Open Design: Seleccione la tarjeta DeepSeek Harness. Si muestra «Se requiere configuración de conexión», confirme «Instalar y seleccionar». Open Design verifica su propio componente, pide a dsh que lo instale en el perfil `open-design`, vuelve a escanear y prueba la conexión.
- 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.
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.
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 Open Design to preview.
El límite es sencillo: Harness gestiona dsh, las credenciales, los modelos y las sesiones; Open Design gestiona el perfil de conexión verificado y el workspace de diseño. Open Design 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 Open Design
DeepSeek Harness y DeepSeek TUI son proyectos separados con diferentes ejecutables. Open Design 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 Open Design | Uso de sesiones, proveedores y composición de plugins de Harness dentro del flujo de trabajo de artefactos de Open Design |
| DeepSeek TUI (`deepseek` / `codewhale`) | Un agente de programación para terminal independiente con su propio adaptador de Open Design | 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 |
| 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 |
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 Open Design si prefiere el flujo de trabajo orientado al terminal de ese agente. Siguen siendo runtimes distintos, aunque Open Design 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/[email protected]` 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 Open Design 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 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?
Sí. Open Design detecta su instalación oficial de dsh, instala un componente de perfil verificado propiedad de Open Design tras su confirmación explícita, sincroniza el catálogo de modelos de Harness y ejecuta DeepSeek Harness como agente local propio. Open Design no instala dsh ni recibe los secretos del proveedor que gestiona Harness.
-
08 ¿Dónde almacena DeepSeek Harness mi clave de API?
Configure la clave en DeepSeek Harness, no en Open Design. 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. Open Design no le pide que pegue la clave en la aplicación ni la escribe en la configuración de Open Design.
Diseña con DeepSeek Harness en Open Design.
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 Open Design en un solo flujo de trabajo.