DeepSeek Harness: inicio, cuatro modos y límites de plugins
Inicia DeepSeek Harness en una carpeta aislada, elige entre Standard, PTC, Minimal y Creation, y revisa permisos antes de añadir plugins.
DeepSeek Harness es un entorno open source para construir un agente con piezas sustituibles: modelo, herramientas, skills, sesión, sandbox, almacenamiento, agent loop, planificación e interfaz. DeepSeek lo marca como Developer Preview, así que el primer objetivo debería ser una ejecución observable en una carpeta aislada, no desplegarlo de inmediato sobre un repositorio de producción.
Si vas a conectar un modelo mediante un API endpoint personalizado, comprueba el protocolo, el Base URL y la autenticación antes de instalar plugins. BetterToken.ai ofrece interfaces OpenAI-compatible y Anthropic-compatible para herramientas que aceptan un Base URL propio, pero eso no demuestra compatibilidad con todos los plugins de Harness. Revisa el esquema del proveedor y el API Key en la documentación de BetterToken y ejecuta después una tarea read-only pequeña.
Qué publicó DeepSeek
El repositorio oficial usa licencia MIT y se apoya en Cordis. Cordis carga y descarga plugins y gestiona dependencias; las capacidades del agente proceden de los plugins. Esta separación permite cambiar el modelo, las herramientas o la sesión de forma independiente.
Primer inicio en una carpeta desechable
Tras instalar Node.js, inicia la Web UI con:
- Crea una carpeta vacía o un clon limpio sin secretos ni cambios sin confirmar.
- Elige Standard.
- Pide una tarea read-only, como localizar el punto de entrada o explicar la estructura.
- Compara la respuesta con los archivos y revisa Trajectory antes de permitir ediciones.
El aislamiento es una práctica de ingeniería; no significa que Harness vuelva seguro cualquier comando de shell.
Cómo elegir el modo
- Standard: agente completo con edición, shell, búsqueda, skills, planes, objetivos, subagentes y workflows. Es el punto de partida normal.
- PTC: añade Code Mode SDK y permite que el modelo componga llamadas a herramientas mediante un programa TypeScript. Revisa el programa y los límites de cada llamada.
- Minimal: conserva solo bash persistente y
str_replace_editor. Sirve como entorno mínimo o baseline de benchmark. - Creation: añade inspección del runtime, experimentos de plugins Cordis en memoria y creación de presets. Úsalo para diseñar una configuración propia.
PTC no garantiza un resultado mejor; hace visible y reproducible la orquestación. Minimal es una referencia diagnóstica, no un Standard cotidiano más ligero.
Trajectory como registro de auditoría
DeepSeek indica que el contexto visto por el modelo y los eventos de ejecución se guardan en un log de sesión append-only: prompts de sistema, tool calls y resultados, programación de subagentes e inyecciones de contexto. En Trajectory puedes comprobar qué archivos vio el agente, dónde apareció una llamada inesperada y si la ejecución se detuvo por permisos, herramientas, instrucciones o contexto.
Antes de instalar un plugin, documenta qué carencia resuelve, a qué datos y servicios accede, cómo detectar una regresión y cómo volver atrás. Lee el código y las dependencias de plugins de la comunidad. Vuelve a consultar el quickstart oficial antes de usar datos reales: durante Developer Preview se esperan cambios incompatibles.