# Instrucciones para el agente: DeepSeek Harness: prueba un agente extensible mediante plugins

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/deepseek-ai/deepseek-harness (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/deepseek-harness

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara el entorno de prueba

Comprueba que tienes Node.js ≥24.9.0 y npm/npx, y elige una carpeta sin datos sensibles para la primera prueba. Lee el [aviso oficial](https://github.com/deepseek-ai/deepseek-harness/blob/HEAD/SAFETY.md): es software experimental que puede ejecutar comandos.

### Paso 2: inicia la interfaz

Desde la carpeta que quieras utilizar, ejecuta el comando del README:

```sh
npx @deepseek-ai/dsh web
```

Por defecto, la dirección local es `http://127.0.0.1:3080`. En un inicio local abre el navegador; por SSH imprime la dirección y debes usar el acceso reenviado de tu cliente.

### Paso 3: configura el modelo

Abre **Settings → Models**, introduce la clave de tu propia cuenta de DeepSeek y guarda. No la pegues en la conversación. La ruta de modelo queda disponible sin reiniciar. Para otros proveedores, consulta la [guía de modelos](https://github.com/deepseek-ai/deepseek-harness/blob/HEAD/docs/user/guide/providers.md).

### Paso 4: selecciona la carpeta

Pulsa **Choose workspace**, añade el directorio del proyecto y selecciónalo. Crea una sesión y solicita un resumen de los paquetes principales del repositorio. Revisa las aprobaciones que presente la política activa.

## Comprobación

Confirma que se abre la interfaz, que puedes seleccionar el espacio de trabajo y que el agente describe archivos que realmente existen en esa carpeta. Una interfaz visible no demuestra que el proveedor del modelo esté configurado.

## Si algo falla

Si el cuadro de mensaje no está disponible, selecciona primero un espacio de trabajo. Si el modelo falla, revisa su configuración en Settings y la guía de proveedores. Revisa el README antes de actualizar: la vista previa anuncia cambios incompatibles. No publiques el servidor como parte de esta prueba local.