# DeepSeek Harness Verbinden Sie die CLI-Agent-Ausführungsschleife von DeepSeek Harness (dsh) über das native npm-Paket dsh-xmemo mit XMemo. - Canonical: https://docs.xmemo.dev/de/docs/connect/deepseek-harness - Locale: de-DE - Content-Locale: de-DE - Canonical-Content-Digest: c6de6cc4c0f626de469ac03a56dc357d0c9af7afcc4dfe19946e5ef345c10181 - Edition-Digest: 1384791b77ed312ada9f1dc92dace1aa60ca71f9e1bad5f4ce781a9b98b80061 - Source-Revision: sha256:dec9ab1fbe4dd6a2bdb916f3b710fbe7727d084a06a4c81753e6790881a0afee ## Zielgruppe und Systemgrenze Diese Anleitung verbindet die CLI-Agent-Ausführungsschleife von DeepSeek Harness (dsh) mit dem persistenten Speicher von XMemo. Die Integration erfolgt über das native Plugin-Paket dsh-xmemo (Version 0.1.0) auf npm, verankert im Repository yonro/xmemo-deepseek-plugin @ e7101afb0a (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md). Wichtige Systemgrenze: Diese Integration gilt ausschließlich für das CLI-Werkzeug dsh agent harness; sie ist KEINE Integration in den Verbraucher-Webchat von DeepSeek (chat.deepseek.com), der weder benutzerdefinierte Plugins noch MCP-Erweiterungen unterstützt. ## Voraussetzungen Stellen Sie sicher, dass vor dem Verbinden die folgenden Laufzeitabhängigkeiten und Werkzeuge vorhanden sind: - DeepSeek Harness (dsh) CLI installiert und betriebsbereit. - Node.js-Laufzeitumgebung Version 18.0.0 oder höher. - Gültiges XMemo-Konto unter https://xmemo.dev. - Netzwerkzugriff auf https://xmemo.dev/mcp über HTTPS. ## Installation Fügen Sie das native dsh-xmemo-Plugin mit dem dokumentierten Befehl aus den Zeilen 90–94 der README zu Ihrem DeepSeek Harness-Profil hinzu: ```bash dsh plugin --profile add dsh-xmemo ``` ## Autorisierung und Konfiguration der Anmeldedaten Konfigurieren Sie Anmeldedaten über Umgebungsvariablen oder die Profilkonfiguration des Harness. Hinterlegen Sie keine Klartext-API-Schlüssel in öffentlichen Projekt-Repositories: - Umgebungsvariable (empfohlen): Setzen Sie XMEMO_KEY vor dem Starten von dsh in der Umgebung (export XMEMO_KEY=''). - Profilkonfiguration: Geben Sie Authentifizierungsdaten in der Ziel-Profilkonfigurationsdatei (~/.dsh/config.json) an. ## Lade- und Neustartverhalten Verfahren zum Neustart des Daemons oder zum Neuladen der Ausführungsschleife sind in der README des dsh-xmemo-Plugins (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md) nicht explizit dokumentiert; konsultieren Sie die CLI-Dokumentation von DeepSeek Harness oder starten Sie Aufgaben mit Ihrem konfigurierten Profil. ## Verbindungsprüfung (schreibgeschützt) Überprüfen Sie die Verbindung mit einer rein lesenden Abrufanfrage, bevor Sie Ausführungsschleifen des Agenten starten: - Prüfung: Führen Sie über dsh eine schreibgeschützte Auswertungsabfrage aus, ohne den Speicherzustand zu verändern. - Erfolgssignal: dsh liefert strukturierte Speicherergebnisse mit gültigen Reference- und Location-Feldern aus dem autorisierten Arbeitsbereich zurück. ## Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus Verifizieren Sie Speicherpersistenz, zustandslosen Sitzungsübergang, quellenzugeordneten Abruf und Korrektur: - 1. Synthetischen Fakt speichern: Speichern Sie eine Aufgabenkonvention des Harness ("Harness demo build target: ESM with strict typing.") unter "projects/demo-dsh/conventions". - 2. Zustandsloser Übergang: Beenden Sie die aktuelle dsh-Aufgabe und starten Sie einen frischen Ausführungslauf mit dem konfigurierten Profil. - 3. Abruf mit Quellenzuordnung: Fragen Sie "harness build target convention" ab. Bestätigen Sie die zurückgegebenen Felder Reference und Location. - 4. Speicher korrigieren: Aktualisieren Sie die gespeicherte Konvention mit update_memory unter Angabe aktualisierter Build-Ziele. - 5. Optionale Bereinigung: Führen Sie ein Soft-Delete (forget) für die Demo-Konvention durch, sobald die Onboarding-Verifizierung abgeschlossen ist. ## Umfang der automatischen Erfassung und Duplikatvermeidung Speicherverwaltung der Ausführungsschleife in DeepSeek Harness: - Schleifen-Checkpointing: dsh-xmemo erfasst Aufgabenergebnisse, Architekturentscheidungen und Fehlerbehebungen automatisch an Grenzen des Aufgabenabschlusses. - Duplikatvermeidung: Deduplizierungs-Hashing verhindert das erneute Erfassen identischer Ausführungskontexte über wiederholte Schleifeniterationen hinweg. - Bereichsisolation: Erfasster Kontext ist strikt auf den authentifizierten Arbeitsbereich und den aktiven Repository-Bereich begrenzt. ## Konflikte mit bestehenden Providern und Speicherzuständigkeit Laufzeitgrenzen und Speicherzuständigkeit: - Provider-Konflikte: Deaktivieren Sie den standardmäßigen flüchtigen lokalen Speicher in dsh.config.json, wenn Sie dsh-xmemo verwenden, um redundante oder widersprüchliche Kontextinjektionen zu vermeiden. - Speicherzuständigkeit: Dauerhafte Speicherdaten verbleiben im benutzerkontrollierten XMemo-Cloud-Backend; dsh speichert lediglich flüchtige Ausführungstranskripte und lokale Ausführungsprotokolle. - Offline- und Replay-Grenzen: Vorübergehende Verbindungsunterbrechungen werden lokal gepuffert; bei längeren Offline-Phasen schlagen Schreiboperationen fehl, sobald der Puffer erschöpft ist, und Offline-Kontext wird erst nach Wiederherstellung der Netzwerkverbindung zwischen Agenten geteilt. ## Wiederherstellung, Aktualisierung und Deinstallation Verfahren zur Fehlerbehebung, Aktualisierung und Entfernung für DeepSeek Harness: - Wiederherstellung (401 invalid_token): Überprüfen Sie, ob XMEMO_KEY in der Shell-Umgebung exportiert ist, in der dsh ausgeführt wird. - Aktualisierung und Entfernung: Verfahren zur Aktualisierung und Entfernung des Plugins sind in der README des dsh-xmemo-Plugins (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md) nicht dokumentiert; konsultieren Sie die CLI-Dokumentation von DeepSeek Harness zur Profilverwaltung oder widerrufen Sie Anmeldedaten und bereinigen Sie gespeicherte Speicherdaten unter https://xmemo.dev/me. - Remote-Löschung: Um gespeicherte Speicherdaten zu bereinigen oder Zugriffstoken zu widerrufen, verwalten Sie Ihren Arbeitsbereich unter https://xmemo.dev/me.