ConnecterConnecterDeepSeek Harness

MCP Client

DeepSeek Harness

Connectez la boucle d'exécution de l'agent CLI DeepSeek Harness (dsh) à XMemo à l'aide du paquet npm natif dsh-xmemo.

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 :

dsh plugin --profile <name> 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='<your-xmemo-token>').
  • 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.

Source : Intégration DeepSeek Harness