# DeepSeek Harness Connectez la boucle d'exécution de l'agent CLI DeepSeek Harness (dsh) à XMemo à l'aide du paquet npm natif dsh-xmemo. - Canonical: https://docs.xmemo.dev/fr/docs/connect/deepseek-harness - Locale: fr-FR - Content-Locale: fr-FR - Canonical-Content-Digest: c6de6cc4c0f626de469ac03a56dc357d0c9af7afcc4dfe19946e5ef345c10181 - Edition-Digest: 502dbd81c0e4250a630fba30d793a9e9078f09edb904227502cdb0863fe7a07f - Source-Revision: sha256:dec9ab1fbe4dd6a2bdb916f3b710fbe7727d084a06a4c81753e6790881a0afee ## Public visé et limites Ce guide connecte la boucle d'exécution de l'agent CLI DeepSeek Harness (dsh) à la mémoire persistante de XMemo. L'intégration s'effectue via le paquet de plugin natif dsh-xmemo (version 0.1.0) sur npm, rattaché au référentiel yonro/xmemo-deepseek-plugin @ e7101afb0a (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md). Limite importante : cette intégration est spécifiquement conçue pour l'outil CLI dsh agent harness ; il ne s'agit PAS d'une intégration dans le chat web grand public DeepSeek (chat.deepseek.com), qui ne prend pas en charge les plugins personnalisés ni les extensions MCP. ## Prérequis Vérifiez la présence des dépendances d'exécution et des outils suivants avant de vous connecter : - CLI DeepSeek Harness (dsh) installée et opérationnelle. - Environnement d'exécution Node.js version 18.0.0 ou supérieure. - Compte XMemo valide sur https://xmemo.dev. - Accès réseau à https://xmemo.dev/mcp via HTTPS. ## Installation Ajoutez le plugin natif dsh-xmemo à votre profil DeepSeek Harness à l'aide de la commande documentée aux lignes 90-94 du fichier README : ```bash dsh plugin --profile add dsh-xmemo ``` ## Autorisation et configuration des identifiants Configurez les identifiants à l'aide de variables d'environnement ou de la configuration du profil harness. Ne placez jamais de clés API en clair dans des référentiels de projet publics : - Variable d'environnement (recommandé) : Définissez XMEMO_KEY dans l'environnement avant de lancer dsh (export XMEMO_KEY=''). - Configuration de profil : Renseignez les identifiants d'authentification dans le fichier de configuration du profil cible (~/.dsh/config.json). ## Comportement de chargement et de redémarrage Les procédures de redémarrage du démon ou de rechargement de la boucle d'exécution ne sont pas explicitement documentées dans le README du plugin dsh-xmemo (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md) ; consultez la documentation de la CLI DeepSeek Harness ou lancez des tâches à l'aide de votre profil configuré. ## Vérification de connexion (lecture seule) Vérifiez la connectivité avec une requête de rappel (recall) en lecture seule avant de démarrer les boucles d'exécution de l'agent : - Vérification : Exécutez une requête d'évaluation en lecture seule via dsh sans modifier l'état de la mémoire. - Indicateur de succès : dsh renvoie des résultats de mémoire structurés comportant des champs Reference et Location valides issus de l'espace de travail autorisé. ## Première tâche utile : Cycle de vie d'une mémoire synthétique Vérifiez la persistance de la mémoire, la transition de session sans état, le rappel avec attribution de la source et la correction : - 1. Enregistrer un fait synthétique : Stockez une convention de tâche du harness ("Harness demo build target: ESM with strict typing.") dans "projects/demo-dsh/conventions". - 2. Transition sans état : Terminez la tâche dsh en cours et démarrez une nouvelle exécution à l'aide du profil configuré. - 3. Rappel avec attribution de la source : Interrogez "harness build target convention". Confirmez les valeurs renvoyées pour Reference et Location. - 4. Corriger la mémoire : Mettez à jour la convention mémorisée à l'aide de update_memory avec les cibles de build actualisées. - 5. Nettoyage optionnel : Supprimez de manière réversible (forget) la convention de démonstration une fois la vérification d'intégration achevée. ## Portée de la capture automatique et prévention des doublons Gestion de la mémoire de la boucle d'exécution DeepSeek Harness : - Points de contrôle de boucle : dsh-xmemo capture automatiquement les résultats de tâches, décisions d'architecture et résolutions d'erreurs aux jalons d'achèvement de tâche. - Prévention des doublons : Le hachage de déduplication empêche la recapture d'un contexte d'exécution identique au fil des itérations répétées. - Isolation de la portée : Le contexte capturé est strictement limité à l'espace de travail authentifié et au périmètre du référentiel actif. ## Conflits avec les fournisseurs existants et propriété du stockage Limites d'exécution et propriété du stockage : - Conflits de fournisseurs : Désactivez la mémoire locale éphémère par défaut dans dsh.config.json lors de l'utilisation de dsh-xmemo afin d'éviter toute injection de contexte redondante ou conflictuelle. - Propriété du stockage : Les mémoires durables résident dans le backend cloud XMemo appartenant à l'utilisateur ; dsh ne stocke que les transcriptions d'exécution éphémères et les journaux d'exécution locaux. - Limites hors ligne et de rejeu : Les interruptions passagères du réseau sont mises en mémoire tampon locale ; les déconnexions prolongées font échouer les écritures une fois le tampon saturé, et le contexte hors ligne n'est partagé avec d'autres agents qu'après reconnexion au réseau. ## Récupération, mise à jour et suppression Procédures de dépannage, de mise à jour et de suppression pour DeepSeek Harness : - Récupération (401 invalid_token) : Vérifiez que XMEMO_KEY est bien exportée dans l'environnement de shell exécutant dsh. - Mise à jour et suppression : Les procédures de mise à jour et de retrait du plugin ne sont pas documentées dans le README du plugin dsh-xmemo (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md) ; consultez la documentation de la CLI DeepSeek Harness pour la gestion des profils, ou révoquez les identifiants et purgez les mémoires stockées sur https://xmemo.dev/me. - Suppression à distance : Pour purger les mémoires stockées ou révoquer les jetons d'accès, gérez votre espace de travail sur https://xmemo.dev/me.