Configuración de DeepSeek Harness

DeepSeek Harness  (nombre del comando dsh) es el harness de agentes oficial y de código abierto de DeepSeek, construido sobre una arquitectura en la que todo es un plugin — modelos, herramientas, skills, sesiones, sandboxes y la interfaz son plugins intercambiables. Por defecto llama a la API oficial de DeepSeek; apunta su plugin de modelos a OfoxAI y el mismo harness alcanza más de 100 modelos.

Pasos de configuración

1. Instalar dsh

Instala primero Node.js. dsh se distribuye en npm como @deepseek-ai/dsh y proporciona el comando dsh una vez instalado.

npm install -g pnpm          # omitir si ya está instalado
pnpm add -g @deepseek-ai/dsh
dsh --version

npm install -g pnpm          # omitir si ya está instalado
pnpm add -g @deepseek-ai/dsh
dsh --version

npm install -g pnpm
pnpm add -g @deepseek-ai/dsh
dsh --version

Durante la instalación, pnpm puede mostrar la advertencia Ignored build scripts: node-pty, koffi …. Ignórala — ambos paquetes incluyen binarios precompilados para todas las plataformas y no necesitan compilación local.

Para probarlo sin instalarlo globalmente:

npx @deepseek-ai/dsh web

2. Configurar el proveedor OfoxAI

dsh guarda su configuración en $DSH_HOME — ~/.dsh en macOS y Linux, %USERPROFILE%\.dsh en Windows. Elige cualquiera de las dos rutas siguientes.

dsh web

llm-pi-ai:
  providers:
    ofox:
      apiKeyEnv: OFOX_API_KEY
      api: openai-completions
      baseURL: https://api.ofox.ai/v1
      models:
        - id: deepseek/deepseek-v4-pro-0813
          name: DeepSeek V4 Pro
        - id: google/gemini-2.5-flash
          name: Gemini 2.5 Flash
    ofox-anthropic:
      apiKeyEnv: OFOX_API_KEY
      api: anthropic-messages
      baseURL: https://api.ofox.ai/anthropic
      models:
        - id: anthropic/claude-sonnet-5
          name: Claude Sonnet 5
          contextWindow: 1000000
agent-default-model:
  provider: ofox
  model: deepseek/deepseek-v4-pro-0813

3. Configurar la API Key

apiKeyEnv nombra una credencial en lugar de contener la clave. dsh la resuelve en un orden fijo: el entorno en el que se lanzó dsh, luego $DSH_HOME/.credentials.yaml, luego el .env de tu proyecto y por último el .env de tu directorio personal. Si usaste la Web UI, la clave ya está guardada y puedes omitir este paso.

export OFOX_API_KEY=<tu OFOXAI_API_KEY>

export OFOX_API_KEY=<tu OFOXAI_API_KEY>

# solo para la sesión actual
$env:OFOX_API_KEY = "<tu OFOXAI_API_KEY>"
 
# permanente (disponible en nuevas terminales)
setx OFOX_API_KEY "<tu OFOXAI_API_KEY>"

4. Verificar

dsh --profile headless "Responde exactamente: OK. No llames a ninguna herramienta."

Recibir OK de vuelta significa que la capa de modelos está llegando a OfoxAI. Para el trabajo diario, lanza la interfaz web con dsh web, o ejecuta una sola tarea y sal con dsh --profile headless "run the tests".

Diferencias entre plataformas

El contenido del archivo de configuración es idéntico en las tres plataformas — solo cambian las rutas y la sintaxis de las variables de entorno.

Solución de problemas

TIMEOUT: Request timed out. — dsh es una aplicación Node y no lee http_proxy / all_proxy, así que tener un proxy de sistema funcionando no implica que dsh pueda conectarse. Si el dominio de baseURL no es accesible en tu red, los usuarios de China continental deberían cambiar al espejo https://api.ofox.io/v1.

MISSING_CREDENTIAL — la credencial indicada por apiKeyEnv no se resolvió a ningún valor. Confirma que la variable de entorno está activa en la terminal desde la que se lanzó dsh, o que la clave está guardada en $DSH_HOME/.credentials.yaml. La otra causa es elegir el modelo equivocado: la ruta integrada deepseek-official lista sus modelos en el selector incluso sin ninguna clave configurada, con nombres muy parecidos a los de tu ruta personalizada.

La respuesta llega vacía y no aparece ningún error — la trampa más fácil de pisar: combinar api: openai-responses con un modelo de Anthropic hace que la solicitud termine con normalidad (finish reason: stop) pero sin contenido. Mueve ese modelo a una ruta openai-completions, o a una ruta anthropic-messages apuntada a https://api.ofox.ai/anthropic.

INVALID_REQUEST / HTTP 400 endpoint_not_supported — el cuerpo de la respuesta dice Model '…' does not support the /v1/responses endpoint on this platform. Please use /v1/chat/completions instead. Los modelos de Google y Qwen hacen esto bajo openai-responses. De nuevo, cambia api a openai-completions.

La carga de plugins falla con un error de ruta duplicada — el mismo nombre de ruta se registró dos veces. Comprueba si tanto $DSH_HOME/cordis.patch.yml como settings.yaml definen ofox.

Avanzado: configurar mediante la capa de parches

settings.yaml contiene los ajustes de usuario en tiempo de ejecución y surte efecto en la siguiente solicitud. Para cambiar la composición de plugins en sí — sustituir o desactivar un plugin — usa la capa de parches en $DSH_HOME/cordis.patch.yml:

- id: llm-pi-ai
  config:
    providers:
      ofox:
        apiKeyEnv: OFOX_API_KEY
        api: openai-completions
        baseURL: https://api.ofox.ai/v1
- id: agent-default-model
  config:
    provider: ofox
    model: deepseek/deepseek-v4-pro-0813

Ejecuta dsh web --dump-config para imprimir el árbol de plugins compuesto y confirmar que tu configuración se aplicó.

Modelos recomendados

Para modelos recomendados, consulta el Mercado de modelos .