DeepSeek Harness
Perfiles y bundles de DeepSeek Harness: capas de configuración
Sigue cómo perfiles, bundles, cordis.patch.yml y overlays forman el árbol de plugins.
Qué aprenderás
- Profiles persist a composition; bundles distribute patchable plugin rows.
- Later layers replace or insert rows in a fixed precedence order.
- Dump the actual tree before debugging a configuration issue.
Antes de empezar
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
Conclusiones clave
- El perfil guarda la composición y el bundle distribuye filas parcheables.
- La precedencia es fija y reemplaza configuraciones completas.
- El dump es la evidencia para depurar.
Perfil frente a bundle
Un perfil guarda una composición con bundles, dependencias externas y parches. Un bundle distribuye filas Cordis y el código que montan.
Web y headless son plantillas; otros perfiles se crean mediante la ruta de plugins y tienen su propio límite de dependencias.
Precedencia
El orden es bundles del perfil, parche del perfil, parche del home y overlay de CLI. Las capas posteriores insertan o sustituyen filas por id.
La sustitución por id no hace merge profundo: debes repetir los campos que conservas.
Verifica el árbol
`dsh --profile web --dump-config` muestra el árbol real. Etiqueta cada fila por su capa antes de cambiar paquetes.
Usa overlays pequeños para experimentar y elimina el overlay cuando la composición esté entendida.
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
Localiza el perfil en DSH_HOME.
- 2
Lee bundles y parches.
- 3
Comprueba la precedencia.
- 4
Valida con dump-config.
Ejemplo para copiar
# illustrative patch shape from the documented model
- insert:
- id: my-plugin
name: /absolute/path/to/plugin.tsPreguntas frecuentes
¿El parche hace merge profundo?
No; reemplaza toda la configuración coincidente.
Fuentes
- DeepSeek Harness architectureFuente verificada 2026-08-27
- DeepSeek Harness CLI READMEFuente verificada 2026-08-27