DeepSeek Harness
Código fuente de DeepSeek Harness: arquitectura y flujo
Una ruta práctica para seguir DeepSeek Harness desde la composición del perfil hasta un paso del modelo.
Qué aprenderás
- Read apps, packages, docs, and examples as separate architectural layers.
- Profile layers compose into a Cordis entry tree before the app activates services.
- Steps, turns, and event domains provide the vocabulary for tracing execution.
Antes de empezar
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
Conclusiones clave
- Apps, packages, docs y examples son capas distintas.
- Los perfiles se convierten en un árbol Cordis antes de activar servicios.
- Step, turn y eventos permiten seguir la ejecución.
Lee por capas
Empieza por `apps`, `packages`, `docs` y `examples`. El mapa de paquetes separa API core, adaptadores LLM, herramientas, sesiones, host, cliente, bundles y SDK.
El mapa evita abrir archivos al azar: muestra quién posee una capacidad y quién consume su definición de servicio.
Arranque y composición
El arranque aplica bundles del perfil, parches del perfil y del home y, finalmente, overlays de la CLI. app-boot compone la lista, monta Cordis y comprueba que las entradas se carguen y activen.
`dsh --profile web --dump-config` permite inspeccionar el árbol real. Un parche por id sustituye toda la configuración coincidente.
Turn, step y eventos
Un step es una petición de modelo más sus herramientas; un turn cubre desde reclamar la entrada hasta terminar el trabajo pendiente. Los eventos de sesión son duraderos y los de agente describen trabajo en vivo.
Traza un evento desde productor hasta consumidor y localiza definición, proveedor y consumidor orientado al modelo para obtener una extensión comprobable.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Trace this first | A service definition and its provider/consumer | A random implementation file without its composition |
| Use events when | The fact is durable or needs an extension point | A local helper has no lifecycle or observer contract |
Pasos de implementación
- 1
Lee arquitectura y mapa de paquetes.
- 2
Elige una capacidad y localiza su service key.
- 3
Inspecciona el orden de bundles y vuelca la configuración.
- 4
Sigue un evento hasta su consumidor y escribe una prueba.
Ejemplo para copiar
# Inspect the composed tree before changing a package
dsh --profile web --dump-config
# Source build checkpoints
pnpm run typecheck
pnpm run buildPreguntas frecuentes
¿Por dónde empiezo el análisis?
Por docs/architecture.md, después packages/README.md y el README del subsistema elegido.
Fuentes
- DeepSeek Harness architectureFuente verificada 2026-08-27
- DeepSeek Harness packages mapFuente verificada 2026-08-27
- DeepSeek Harness app-boot packageFuente verificada 2026-08-27