DeepSeek Harness
CLI y modo headless de DeepSeek Harness: perfiles y automatización
Comprende la frontera de argumentos de dsh y cómo headless ejecuta una sesión persistente sin servidor.
Qué aprenderás
- Launcher flags and profile app arguments have separate parsing boundaries.
- Headless mode prints one persisted task result and exits.
- Dump the composed config before automating a profile.
Antes de empezar
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
Conclusiones clave
- Los flags del launcher y de la aplicación tienen límites separados.
- Headless imprime una tarea persistente y termina.
- Inspecciona la configuración antes de automatizar.
La frontera del launcher
dsh es el launcher de perfiles. Sus flags van primero; el primer token no reconocido pertenece a la aplicación seleccionada.
`dsh web` es un alias del perfil web, mientras `dsh --profile headless "job"` ejecuta una sesión nueva, imprime la respuesta y termina.
Inspecciona antes de arrancar
`--dump-default-config` y `--dump-config` muestran la composición sin arrancar servicios. Permiten revisar bundles, parches y overlays.
El directorio del perfil contiene package.json, el manifiesto dsh.profile y cordis.patch.yml; un parche por id sustituye toda la fila de configuración.
Automatiza con aislamiento
Headless crea estado persistente, así que cada trabajo necesita identidad de sesión y workspace aislado.
Desde código fuente, construye primero los artefactos y usa después `pnpm dsh` para ejecutar la entrada TypeScript.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Elige web para servidor o headless para una tarea.
- 2
Vuelca la configuración y comprueba precedencia.
- 3
Aísla workspace y sesión.
- 4
Construye antes de usar pnpm dsh.
Ejemplo para copiar
dsh --help
dsh web --port 8080
dsh --profile headless "summarize this workspace"
dsh --profile web --dump-configPreguntas frecuentes
¿Qué hace headless?
Ejecuta una sesión persistente, imprime la respuesta final y termina sin iniciar la Web UI.
Fuentes
- DeepSeek Harness CLI READMEFuente verificada 2026-08-27