deepseek harness
DeepSeek Harness Alpha.2: Worktrees y Verificación
DeepSeek-V4 Team · 8 de octubre de 2026 · 7 min read
Keywords: actualización deepseek harness, git worktrees
Published: 8 de octubre de 2026 Author: DeepSeek-V4 Team
DeepSeek Harness dsh-v0.2.1-alpha.2, lanzado el 9 de octubre de 2026, pone a disposición de los agentes checkouts de Git separados y cambia varias interfaces utilizadas por runtimes personalizados. Para alguien que ya usa el alpha.1 del 3 de octubre, la decisión depende de una necesidad concreta: ¿necesitas Worktrees, una corrección de confiabilidad particular o el comportamiento más nuevo del SDK?
Esta guía se publicó primero para alpha.1 y ahora incluye alpha.2. Se basa en las notas de la versión oficial alpha.2 y la documentación con versión fijada. Las verificaciones de aceptación a continuación son verificaciones propuestas para tu instalación, no un benchmark multiplataforma ni una afirmación de que ejecutamos la compilación de escritorio de Harness.
Comienza con el cambio que afecta tu trabajo
El nuevo plugin de Git Worktrees permite a un agente crear una rama y un checkout separado, luego continuar la sesión allí. Es experimental y está deshabilitado inicialmente. Eso lo convierte en un candidato útil para una prueba de alcance limitado: permite a un agente editar un pequeño archivo de documentación lejos de tu directorio de trabajo principal, luego inspecciona el diff resultante.
Alpha.2 también añade traducción de razonamiento experimental a través de un plugin. Las notas de la versión enumeran traducción de Bing y Google, más una opción de pago de DeepSeek Flash. Esto concierne a la presentación del contenido de razonamiento; no es un lanzamiento de modelo base nuevo ni evidencia de mejor precisión de razonamiento. Evalúa la traducción que realmente lees, incluidos los identificadores técnicos que deben permanecer sin cambios.
Un tercer conjunto de cambios ayuda a los flujos de trabajo existentes: los flujos de respuesta estancados pueden alcanzar un tiempo de espera por inactividad, los metadatos de plugin ilegibles ya no bloquean toda la solicitud y es menos probable que las tareas en segundo plano se muestren como interrumpidas simplemente porque un turno padre terminó. Estas son afirmaciones de las notas de la versión. Reproduce tu propio caso fallido antes de declararlo resuelto.
| Tu situación | Primer elemento a evaluar | Evidencia a conservar |
|---|---|---|
| Las ediciones del agente colisionan con el trabajo local | Git Worktrees | Directorio, rama, base y diff |
| Una tarea en segundo plano parece interrumpida | La misma tarea después de la actualización | Resultado real y estado final de la tarea |
| Mantienes un runtime de SDK personalizado | Requisitos de migración | Prueba de integración y manejo de eventos |
| Tu flujo de trabajo actual es estable | Una pequeña sesión de regresión | Misma tarea, mismo resultado esperado |
Worktrees separa archivos, no permisos
La documentación de Worktrees alpha.2 describe un checkout creado desde una revisión local de Git. Los archivos con cambios pendientes en el checkout original no viajan con él. Si un agente necesita un cambio que existe solo en tu editor, abrir un worktree no hace que ese cambio esté disponible.
La operación también retiene la política de archivos existente de la sesión. Una nueva ruta no es un nuevo límite de seguridad y no otorga permiso para escribir en ubicaciones restringidas de otra manera. Tanto el destino como el directorio de administración de Git compartido deben ser escribibles bajo la política existente.
Trata la ruta devuelta como algo que verificar antes de editar. El directorio predeterminado de worktrees se sitúa debajo del checkout actual, por lo que comenzar dentro de un checkout vinculado existente crea un pool anidado allí. Dejar el directorio retiene tanto el checkout como la rama. Nuestra guía de primer uso de Worktrees recorre esas decisiones con una pequeña tarea revisable.
Las integraciones personalizadas necesitan una revisión de migración específica
Los cambios de mayor impacto de alpha.2 pueden ser invisibles en la interfaz normal. Las herramientas de subagente ahora devuelven el ID de sesión hijo inmediatamente; los runtimes de SDK personalizados necesitan soportar session/wait. El código que trató el primer resultado como trabajo completado necesita una nueva comprobación de finalización.
La versión también elimina el valor de presentación de herramienta both, dejando native y ptc. Python PTC ahora usa el sandbox del sistema de archivos de sesión; las composiciones personalizadas deben suministrar los servicios de sandbox y sandbox-policy. Estos son cambios de configuración y ciclo de vida, no configuraciones para reemplazar indiscriminadamente en cada archivo que contenga una palabra coincidente.
La mensajería de Agent Team cambia a entrega directa en la Bandeja de Entrada objetivo. Los plugins personalizados que dependen de la antigua bandeja de salida, reintentos automáticos o deduplicación de reenvío necesitan ser verificados contra las notas de migración. Un envío exitoso seguido del resultado esperado del lado del destinatario es una evidencia más fuerte que la ausencia de una excepción.
Finalmente, el directorio de agentes compartido acepta un AGENTS.md, con DSH_AGENTS_HOME disponible para especificar otro directorio. La versión elimina por separado la opción dshHome por fila para instrucciones de agente en favor del predeterminado DSH_HOME a nivel de proceso. Mantén esas dos configuraciones distintas al revisar una implementación existente.
Una mejor etiqueta de tarea aún necesita una verificación de resultado
Una visualización corregida de tareas en segundo plano es útil porque hace que los fallos sean más fáciles de diagnosticar. No prueba que la salida solicitada de la tarea exista. Para un trabajo de escritura de informes, inspecciona el informe; para un cambio de código, inspecciona el diff y el resultado de la prueba. Mantén el estado mostrado junto a esa evidencia.
Por ejemplo, un trabajo puede terminar mientras escribe un informe en un directorio diferente del que esperabas. Un estado completado y un archivo faltante son observaciones compatibles hasta que estableces dónde se ejecutó el proceso. La herramienta working_directory de Alpha.2 y las operaciones de directorio del SDK hacen que la ubicación de la sesión sea una parte explícita de esta investigación.
Los flujos de trabajo programados existentes merecen el mismo tratamiento. Verifica la entrega de recordatorios por separado del trabajo solicitado por el recordatorio. El tutorial de aceptación de automatización cubre esa distinción; permanece relevante después de las correcciones de visualización.
Mantén los cambios de alpha.1 en su contexto original
La versión alpha.1 del 3 de octubre introdujo la entrada de creación de plugin, automatización Web integrada y compatibilidad experimental con Claude Code Mods. Esos son antecedentes útiles para los lectores que actualizan desde una compilación más antigua, pero no son adiciones del 9 de octubre.
Si mantienes plugins, verifica ambas versiones en lugar de omitir las notas de migración anteriores. Alpha.1 eliminó los plugins invariantes de runtime y dividió las estadísticas del cuadro de entrada de mensajes en activity y usage. Su instalador también comenzó a reportar la versión instalada más claramente, incluidos los casos donde la política de antigüedad de versión seleccionó un paquete más antiguo. La versión solicitada y la versión instalada permanecen como hechos separados.
Para una configuración inicial, comienza con la guía de inicio rápido local. Para la creación de plugins, usa el tutorial de Creator. Ningún flujo de trabajo requiere tratar cada función experimental como parte de la misma prueba de actualización.
Toma la decisión de actualización con una sesión controlada
Registra tu versión actual de Harness y preserva la configuración y los datos de sesión en los que confías. Elige una tarea ordinaria con un resultado esperado conocido, luego repítela después de actualizar. Solo después de que esa base funcione debes habilitar el plugin experimental que necesitas o probar la integración que cambiaste.
Para Worktrees, la aceptación significa un commit conocido, una nueva rama, el directorio actual correcto y un diff revisado. Para una integración de SDK, significa comprobar que la sesión hija ha terminado y probar las interfaces que usas. Si ningún beneficio importa para tu trabajo, la etiqueta alpha justifica mantener la prueba separada de tu configuración diaria.