Saltar al contenido principal
DeepSeek Harness (comando dsh) es el framework de agente de programación de código abierto de DeepSeek. Incluye espacios de trabajo, terminal, edición de archivos, Skills, planificación y Web UI. Su interfaz compatible con OpenAI Chat Completions permite conectarlo a AIHubMix.
Esta guía se basa en DeepSeek Harness 0.2.0-rc.2, la versión más reciente a fecha del 18 de octubre de 2026. Respecto a 0.1.0-rc.6, la versión cambia de forma considerable: la ubicación de la configuración y la interfaz se han actualizado. Harness sigue en vista previa para desarrolladores, por lo que las versiones posteriores pueden cambiar campos o detalles de la interfaz.

​
Resumen

La integración requiere cuatro valores:
AIHubMix configurado en la página Models de DeepSeek Harness

​
¿Qué necesitas?

  • Una clave API de AIHubMix activa
  • Node.js 22 (22.19.0 o posterior) o Node.js 24 o posterior
  • Acceso de red al registro npm y a https://aihubmix.com

​
¿Cómo se instala DeepSeek Harness?

Instala la versión publicada en npm sin clonar el repositorio de código fuente:
Si aparece dsh: command not found, ejecuta npm config get prefix y comprueba que su directorio bin esté incluido en PATH.

​
¿Cómo se inicia la Web UI?

Ejecuta el comando desde el directorio que quieras usar como espacio de trabajo. La forma oficialmente recomendada es npx:
Si Harness ya está instalado globalmente, también puedes ejecutar:
Abre http://127.0.0.1:3080 y selecciona o añade un espacio de trabajo durante el primer uso.

​
¿Cómo se configura el proveedor AIHubMix?

Abre Settings → Models → Add model provider, cambia la tarjeta a Custom model API y luego introduce los siguientes valores:
Formulario de proveedor personalizado en DeepSeek Harness
El endpoint final es https://aihubmix.com/v1/chat/completions.
No introduzcas la ruta completa /chat/completions en Base URL.

​
Añadir auto u otro modelo

Después de introducir Base URL y la clave API, abre Model catalog y selecciona Fetch available models. Harness solicita GET https://aihubmix.com/v1/models y muestra los ID de modelo disponibles.
Modelos de AIHubMix disponibles en DeepSeek Harness
Para la primera prueba puedes añadir solo auto y usar Auto como nombre visible. Para usar un modelo específico, márcalo en la lista obtenida y selecciona Add selected. El selector gráfico solo muestra los modelos registrados en el catálogo del Provider actual.
Añadir manualmente el modelo auto de AIHubMix

​
Comparación entre auto y un modelo específico

Ambas opciones usan el mismo Provider, Base URL y clave API. Cambiar de modelo no requiere crear de nuevo el proveedor.

​
Guardar la clave API en una variable de entorno

En equipos de desarrollo y en CI, Harness puede leer la clave desde una variable de entorno mediante un archivo de perfil. La Web UI usa el perfil web y las pruebas headless usan el perfil headless. Las rutas de los archivos son:
  • $DSH_HOME/profiles/web/cordis.patch.yml
  • $DSH_HOME/profiles/headless/cordis.patch.yml
Ambos archivos contienen el siguiente contenido:
Las dos entradas son obligatorias. Si solo escribes llm-pi-ai y omites agent-default-model, el modo headless seguirá usando el valor predeterminado deepseek-official y mostrará MISSING_CREDENTIAL.
Las versiones anteriores guardaban la configuración en $HOME/.dsh/settings.yaml, archivo que la versión 0.2.0 ya no utiliza. Al iniciar DSH 0.2.0 por primera vez, ese archivo se migra a un perfil y el original se renombra como settings.yaml.imported. En esa ejecución de migración puede aparecer MISSING_CREDENTIAL; basta con volver a ejecutar el comando.
Cuando la clave procede del entorno de inicio, la página de ajustes muestra un aviso de solo lectura sin revelar el valor.
Detalles del proveedor AIHubMix en DeepSeek Harness
Reinicia Harness después de cambiar la variable de entorno.

​
Seleccionar un modelo y probar una conversación

Cierra Settings y selecciona Auto u otro modelo añadido desde el selector situado en la esquina inferior derecha del cuadro de entrada.
Auto seleccionado en DeepSeek Harness
La respuesta esperada confirma la conexión entre Harness, el endpoint compatible con OpenAI Chat Completions y AIHubMix.
Respuesta correcta de AIHubMix en DeepSeek Harness

​
Ejecutar una prueba headless

Para probar sin la Web UI, ejecuta el siguiente comando. Usa el perfil headless, así que $DSH_HOME/profiles/headless/cordis.patch.yml debe contener las dos entradas indicadas arriba.
Una ejecución correcta muestra DSH_AIHUBMIX_OK.

​
Preguntas frecuentes

​
¿Por qué aparece MISSING_CREDENTIAL?

Harness no obtuvo una configuración utilizable. Comprueba que las dos entradas estén escritas en el perfil y que la variable AIHUBMIX_API_KEY esté definida, y luego inicia Harness desde el mismo terminal:

​
¿Por qué la búsqueda de modelos devuelve 401?

Comprueba que la clave API sea válida y no contenga espacios o saltos de línea adicionales. La solicitud utiliza autenticación Bearer.

​
¿Por qué Auto es el único modelo del selector?

El selector solo muestra modelos registrados en el catálogo actual del Provider. Abre Settings → Models → AIHubMix → Edit, selecciona Fetch available models en Model catalog, marca los modelos que necesites y selecciona Add selected.

​
¿Por qué Harness muestra UNKNOWN_MODEL?

El catálogo actual no contiene ese ID. Los ID distinguen mayúsculas y minúsculas, usa el valor exacto devuelto por la búsqueda.

​
¿Por qué se agota el tiempo de conexión?

Comprueba DNS, la red de tu organización y el proxy local. DSH lee automáticamente las variables HTTP_PROXY y HTTPS_PROXY. Para excluir direcciones del proxy, define NO_PROXY. Si solo el navegador usa el proxy del sistema, define HTTP_PROXY y HTTPS_PROXY en el terminal que inicia dsh.

​
Recomendaciones de seguridad

  • No incluyas claves API en Git, capturas de pantalla o scripts compartidos
  • Usa el almacenamiento de credenciales de Harness o AIHUBMIX_API_KEY
  • No muestres una clave API completa durante el diagnóstico
  • Usa la gestión de secretos de la plataforma CI para inyectar variables
Última actualización: 2026-10-18