- Preparar Node.js y un workspace de prueba.
- Arrancar la interfaz local de DSH.
- Completar una misión de lectura sin modificar archivos.
Antes de empezar
Usa una carpeta nueva o una copia desechable del proyecto. Evita documentos de clientes, claves, producción o repositorios con cambios sin guardar.
El README oficial marca DSH como developer preview: se actualiza rápido y puede introducir cambios incompatibles. Antes de publicar comandos en un equipo, comprueba la documentación vigente.
node -v # Arranque desde npm, según README oficial npx @deepseek-ai/dsh web # URL habitual que imprime el comando http://127.0.0.1:3080
Qué ocurre al arrancar la Web UI
El proceso dsh usa el directorio desde el que lo invocas como ubicación de filesystem por defecto. Aun así, una Web UI nueva no tiene workspace seleccionado hasta que lo añades.
Esto importa mucho: el composer de sesión permanece inutilizable hasta seleccionar un workspace. Si no puedes escribir una tarea, no es un error del modelo; probablemente falta Choose workspace.
- Arranca DSH desde la carpeta del proyecto o desde una carpeta de pruebas.
- Entra en Choose workspace.
- Añade el directorio donde arrancaste dsh.
- Selecciona ese workspace antes de crear la sesión.
Instalación desde código fuente
Usa el arranque desde fuente si vas a desarrollar plugins, inspeccionar Cordis o probar parches. No es necesario para empezar como usuario, pero sí para seguir las partes avanzadas de este curso.
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web
Primera misión
En la interfaz, selecciona el workspace de prueba y configura el nivel más restrictivo disponible. La misión inicial solo debe inspeccionar.
La guía oficial propone empezar con una tarea de resumen del repositorio. Aulafy añade una restricción extra: exige citas de archivos para que puedas comprobar si el agente realmente leyó el workspace.
- No concedas acceso total al sistema.
- Pide referencias a los archivos que sustentan el resumen.
- Observa el Trajectory completo antes de aprobar acciones.
- Guarda una captura del resultado y de las acciones realizadas.
Resume la estructura de este workspace. Lista carpetas, archivos de configuración y puntos de entrada. No modifiques nada. Cita los archivos en los que te basas.
Fuentes oficiales para esta fase
Consulta la guía Web UI, el README y el repositorio antes de usarlo en un entorno real.
- Quickstart Web UI: `https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart`
- README oficial: `https://github.com/deepseek-ai/deepseek-harness`
- Guía de configuración de modelos: `https://deepseek-harness.github.io/deepseek-harness/en/guide/providers`
Si has guardado la evidencia de esta lección, continúa con «Modelos DeepSeek, proveedores y coste». Si no, repite la comprobación antes de avanzar.