deepseek harness
DeepSeek Harness Alpha.2 : Worktrees et vérifications
DeepSeek-V4 Team · 8 octobre 2026 · 7 min read
Keywords: deepseek harness alpha.2, git worktrees, migration sdk
Published: 8 octobre 2026 Author: DeepSeek-V4 Team
DeepSeek Harness dsh-v0.2.1-alpha.2, publié le 9 octobre 2026, met des checkouts Git séparés à disposition des agents et modifie plusieurs interfaces utilisées par les runtimes personnalisés. Pour quelqu'un utilisant déjà l'alpha.1 du 3 octobre, la décision dépend de besoins précis : avez-vous besoin des Worktrees, d'une correction de fiabilité particulière ou du nouveau comportement du SDK ?
Ce guide a été publié initialement pour l'alpha.1 et inclut désormais l'alpha.2. Il s'appuie sur les notes de version officielles alpha.2 et la documentation correspondant à cette version. Les vérifications d'acceptation ci-dessous sont des vérifications proposées pour votre installation, ni un benchmark multiplateforme ni une affirmation que nous avons exécuté la version de bureau de Harness.
Commencez par le changement qui affecte votre travail
Le nouveau plugin Git Worktrees permet à un agent de créer une branche et un checkout séparé, puis de poursuivre la session dans ce répertoire. Il est expérimental et désactivé par défaut. Vous pouvez donc commencer par un essai limité : laissez un agent modifier un petit fichier de documentation à l'écart de votre répertoire de travail principal, puis inspectez le diff résultant.
Alpha.2 ajoute également la traduction expérimentale du raisonnement via un plugin. La version répertorie la traduction Bing et Google, plus une option DeepSeek Flash payante. Cela concerne la présentation du contenu de raisonnement ; ce n'est pas une nouvelle version de modèle de base ni une preuve d'une meilleure précision du raisonnement. Évaluez la traduction que vous lisez réellement, y compris les identifiants techniques qui doivent rester inchangés.
Un troisième ensemble de changements aide les workflows existants : les flux de réponses bloqués peuvent atteindre un délai d'inactivité, les métadonnées de plugin illisibles ne bloquent plus l'ensemble de la requête, et les tâches d'arrière-plan sont moins susceptibles d'être affichées comme interrompues simplement parce qu'un tour parent s'est terminé. Ce sont des affirmations des notes de version. Reproduisez votre propre cas d'échec avant de le déclarer résolu.
| Votre situation | Premier élément à évaluer | Preuves à conserver |
|---|---|---|
| Les modifications des agents entrent en conflit avec le travail local | Git Worktrees | Répertoire, branche, référence et diff |
| Une tâche d'arrière-plan semble interrompue | La même tâche après mise à niveau | Résultat réel et état final de la tâche |
| Vous maintenez un runtime SDK personnalisé | Exigences de migration | Test d'intégration et gestion des événements |
| Votre workflow actuel est stable | Une petite session de régression | Même tâche, même résultat attendu |
Les Worktrees séparent les fichiers, pas les permissions
La documentation alpha.2 Worktrees décrit un checkout créé à partir d'une révision Git locale. Les fichiers modifiés dans le checkout original ne sont pas copiés. Si un agent a besoin d'une modification qui existe uniquement dans votre éditeur, ouvrir un worktree ne rend pas cette modification disponible.
L'opération conserve également la politique d’accès aux fichiers existante de la session. Un nouveau chemin n'est pas une nouvelle frontière de sécurité et n'accorde pas la permission d'écrire dans des emplacements autrement restreints. La destination et le répertoire d'administration Git partagé doivent tous deux être accessibles en écriture selon la politique existante.
Considérez le chemin renvoyé comme quelque chose à vérifier avant d'éditer. Le pool par défaut réside sous le checkout actuel, ainsi, démarrer à l'intérieur d'un checkout lié existant y crée un pool imbriqué. Quitter le répertoire conserve à la fois le checkout et la branche. Notre guide de premier usage Worktrees parcourt ces décisions avec une petite tâche vérifiable.
Les intégrations personnalisées nécessitent une vérification de migration distincte
Les changements alpha.2 les plus conséquents peuvent être invisibles dans l'interface normale. Les outils de sous-agent renvoient désormais l'ID de session enfant immédiatement ; les runtimes SDK personnalisés doivent prendre en charge session/wait. Le code qui traitait le premier résultat comme un travail terminé nécessite une nouvelle vérification de fin de tâche.
La version supprime également la valeur de présentation d'outil both, laissant native et ptc. Python PTC utilise désormais la sandbox du système de fichiers de session ; les compositions personnalisées doivent fournir les services de sandbox et de politique de sandbox. Ce sont des changements de configuration et de cycle de vie, pas des paramètres à remplacer indistinctement dans chaque fichier contenant un mot correspondant.
La messagerie Agent Team passe à une livraison directe dans la Boîte de réception cible. Les plugins personnalisés dépendant de l'ancienne boîte d'envoi, des tentatives automatiques ou de la déduplication des renvois doivent être vérifiés par rapport aux notes de migration. Un envoi réussi suivi du résultat attendu côté destinataire constitue une preuve plus forte que l'absence d'exception.
Enfin, le répertoire d'agents partagé accepte un AGENTS.md, avec DSH_AGENTS_HOME disponible comme remplacement. La version supprime séparément l'option dshHome par ligne pour les instructions d'agent en faveur de la valeur par défaut DSH_HOME au niveau processus. Gardez ces deux paramètres distincts lors de l'examen d'un déploiement existant.
Une meilleure étiquette de tâche nécessite toujours une vérification du résultat
Un affichage corrigé des tâches d'arrière-plan est utile car il rend les échecs plus faciles à diagnostiquer. Cela ne prouve pas que la sortie demandée par la tâche existe. Pour une tâche de rédaction de rapport, inspectez le rapport ; pour une modification de code, inspectez le diff et le résultat du test. Gardez l'état affiché à côté de cette preuve.
Par exemple, une tâche peut se terminer tout en écrivant un rapport dans un répertoire différent de celui que vous attendiez. Un état terminé et un fichier manquant sont des observations compatibles jusqu'à ce que vous établissiez où le processus s'est exécuté. L'outil working_directory d'Alpha.2 et les opérations de répertoire SDK font de l'emplacement de la session une part explicite de cette enquête.
Les workflows planifiés existants méritent le même traitement. Vérifiez la livraison de rappel séparément du travail demandé par le rappel. Le tutoriel d'acceptation d'automatisation couvre cette distinction ; il reste pertinent après les corrections d'affichage.
Conservez les changements alpha.1 dans leur contexte d'origine
La version alpha.1 du 3 octobre a introduit l'entrée de création de plugin, l'automatisation Web intégrée et la compatibilité expérimentale Claude Code Mods. Ce sont des informations utiles pour les lecteurs mettant à niveau depuis une build plus ancienne, mais ce ne sont pas des ajouts du 9 octobre.
Si vous maintenez des plugins, vérifiez les deux versions plutôt que de sauter les notes de migration antérieures. Alpha.1 a supprimé les plugins invariants de runtime et divisé les statistiques de la zone de saisie en activity et usage. Son installateur a également commencé à signaler la version installée plus clairement, y compris les cas où la politique d'âge de version a sélectionné un package plus ancien. La version demandée et la version installée restent des faits séparés.
Pour une configuration initiale, commencez par le guide de démarrage rapide local. Pour la création de plugin, utilisez le tutoriel Creator. Aucun workflow ne nécessite de traiter chaque fonctionnalité expérimentale comme faisant partie du même test de mise à niveau.
Prenez la décision de mise à niveau avec une session contrôlée
Enregistrez votre version Harness actuelle et conservez la configuration et les données de session sur lesquelles vous comptez. Choisissez une tâche ordinaire avec un résultat attendu connu, puis répétez-la après la mise à niveau. Ce n'est qu'une fois ce test de référence réussi que vous devez activer le plugin expérimental dont vous avez besoin ou tester l'intégration que vous avez changée.
Pour les Worktrees, l'acceptation signifie un commit connu, une nouvelle branche, le répertoire courant correct et un diff examiné. Pour une intégration SDK, cela signifie vérifier la fin réelle de la session enfant et tester les interfaces que vous utilisez. Si aucun avantage ne compte pour votre travail, le statut alpha justifie de garder l'essai séparé de votre configuration quotidienne.