dsh-gate

dsh-gate ermöglicht es Codex, lang laufende DeepSeek-Harness-Sitzungen über MCP zu überwachen, während DSH Host und Sitzungen unabhängig vom MCP-Prozess bleiben.

Der Arbeitsbereich enthält:

• @dsh-gate/mcp-server: neun MCP-Tools über DSHs öffentlichen Netzwerk-Client und Reconnect-Controller;

• @dsh-gate/supervisor-tools: DSH-seitige Übergabe-, Artefakt-Aufnahme- und gemeldete Fehlerbudget-Tools;

• zwei schmale Operator-Skills, Beispiel-Codex/DSH-Konfiguration und einen deterministischen Bootstrap/Doctor/Host-Workflow.

Bereitstellen, verifizieren und starten

pnpm bootstrap      # fetch the pinned DSH fork commit, build & link the exact
                    # network client, install the supervisor plugin into an
                    # isolated project-local DSH home (.dsh-state/) — never starts the Host
pnpm run doctor     # verify pin, link, built artifacts, and plugin/profile
pnpm host:start     # start the independent DSH Web Host on http://127.0.0.1:8080
pnpm run doctor --live  # additionally verify the running Host identity/protocol

Kopieren Sie dann config/codex-mcp.example.toml in die passende Codex-Konfiguration und ersetzen Sie den <workspace-root>-Platzhalter durch den absoluten Pfad dieses Checkouts – der einzige maschinenspezifische Wert. Die Server-ausführbare Datei ist packages/mcp-server/dist/cli.js – wenn eine ältere Konfiguration noch auf dist/index.js zeigt, aktualisieren Sie sie auf dist/cli.js (der Bibliotheks-Einstiegspunkt startet den MCP-Server nicht). Die Codex-MCP-Konfiguration unterstützt stdio-Server mit Feldern für Befehl, Argumente, Umgebung, Start-Timeout und Tool-Timeout.

Für den vollständigen Operator-Leitfaden – Voraussetzungen, Kompatibilitätsvertrag und Aktualisierungsrichtlinie, Host-Unabhängigkeit, Browser-Sichtbarkeit, saubere Fehlerbehebung und die Einschränkung bezüglich offizieller Upstream-PRs – lesen Sie DEPLOYMENT.md.

Related MCP server: dsh-orchestrator

Der festgepinnte DSH-Fork-Commit

@dsh-gate/mcp-server importiert @deepseek-ai/dsh-client-connection/network-client, die generischen Network-Client- und Reconnect-Controller-Exporte. Diese Exporte sind nicht Teil einer veröffentlichten DSH-Version; sie werden aus dem öffentlichen Fork an genau einem Commit bezogen:

• Fork: https://github.com/yidapan666-creator/deepseek-harness.git

• Commit: 7212c955438c70c9a2d168f67e85a8014b8d4488

Die Commit-SHA ist der Kompatibilitätsvertrag – Bootstrap holt per SHA (niemals über einen beweglichen Branch), Doctor lehnt einen Checkout ab, dessen HEAD abweicht oder dessen Remote den Fork nicht identifiziert, und ein unsauberer Checkout wird ohne destruktive Wiederherstellung abgelehnt. Der Link selbst wird vom vorhandenen scripts/link-local-dsh.mjs erstellt, das von Bootstrap wiederverwendet wird; er ist nur lokal, und es wird kein Maschinenpfad in Paketmetadaten festgeschrieben. dist/cli.js prüft zuerst die Nahtstelle und gibt eine klare Diagnose aus, statt eines rohen Modulauflösungsfehlers, wenn sie fehlt.

Zum Aktualisieren des Pins: DSH_PINNED_COMMIT in scripts/dsh-gate-lib.mjs ändern, .dsh-state/dsh entfernen und pnpm bootstrap erneut ausführen. Siehe DEPLOYMENT.md für die Richtlinie und dafür, warum der Fork-Commit nicht als Upstream-Merge beansprucht wird.

Überwachungsrhythmus

dsh_wait führt einen fünfminütigen aggregierten Fortschrittsrhythmus aus: Standardmäßig liefert es etwa eine Beobachtung alle 300000 ms zurück und kehrt nur bei einer wesentlichen Supervisor-Grenze vorzeitig zurück – zum Beispiel bei einem Endzustand, einer Genehmigung/Frage, einem Checkpoint, einem Blocker oder einer Eskalation. Gewöhnliches Ereignisrauschen löst niemals schnelle wiederholte Wait-Aufrufe aus. Jede Rhythmus-Beobachtung aggregiert den Fortschritt seit der vorherigen asOfSeq – Schritt-Delta, Tool-Zählungen, Token-Deltas – plus eine kompakte, begrenzte projectActivity-Zusammenfassung der verschiedenen Projektdateien, die durch erfolgreiche Bearbeitungen/Schreibvorgänge berührt wurden, und der gezielten Verifikationsbefehle, die versucht wurden (zum Beispiel pnpm verify). Terminal-Beobachtungen tragen die Gesamtsummen des Aufgabenbereichs. Rohe Logs, Diffs oder Tool-Ausgaben sind niemals enthalten.

Der in die Warteschlange gestellte Prompt beginnt mit dem menschenlesbaren Ziel und bettet das dauerhafte Aufgabenpaket danach ein. Dies hält die Protokollvalidierung unverändert, während neue überwachte Sitzungen in der DSH-Web-Seitenleiste am Aufgabennamen erkennbar werden.

Details zur langen Übergabe

supervisor_handoff.summary ist auf 2048 Zeichen begrenzt. Wenn eine Aufgabe einen längeren Bericht benötigt, schreiben Sie ihn als Markdown unter .dsh-handoff/<taskId>/ innerhalb des Sitzungs-Arbeitsverzeichnisses (das Verzeichnis ist gitignored), übergeben Sie den relativen Pfad in artifacts und verweisen Sie in der prägnanten Zusammenfassung darauf. Das Übergabe-Tool lehnt überlange Zusammenfassungen mit genau dieser Anweisung ab und schreibt selbst niemals Übergabedaten – insbesondere niemals nach ~/.codex oder in ein anderes globales Verzeichnis. Die Artefakt-Aufnahme erzwingt Eingrenzung: nur relative Pfade, keine Traversierung, Symlinks, Hardlinks oder nicht-reguläre Dateien, gehasht über einen validierten Handle innerhalb des Sitzungs-Arbeitsverzeichnisses.

Veröffentlichungsstatus

Der Quellcode ist unter MIT lizenziert und für die öffentliche Hosting-Bereitstellung unter yidapan666-creator/dsh-gate vorbereitet: Die DSH-Abhängigkeit ist ein öffentlicher Fork-Commit, der per SHA gepinnt ist, der Arbeitsbaum enthält keine maschinenspezifischen Pfade oder Geheimnisse, und pnpm verify besteht mit dem vom Bootstrap verwalteten Link. Die Veröffentlichung als npm-Pakete ist eine separate, weiterhin blockierte Entscheidung: Beide Pakete behalten "private": true, und eine saubere Paketinstallation kann nicht bauen oder laufen, bis die Upstream-DSH-Network-Client-Nahtstelle veröffentlicht ist (der Fork-Pin funktioniert für Quellcode-Bereitstellungen, nicht für Registry-Konsumenten).

Die verbleibende Upstream-Einschränkung ist die npm-Veröffentlichung: Beide Pakete bleiben privat, bis die generischen @deepseek-ai/dsh-client-connection/network-client-Exporte upstream veröffentlicht sind. Der öffentliche Fork-Pin bei 7212c955438c70c9a2d168f67e85a8014b8d4488 macht Quellcode-Bereitstellungen heute reproduzierbar; er ist kein Upstream-Merge und es wird kein Merge beansprucht.

Quellcode-Installation, Build, Tests, Paketierungsprüfungen und der Protokollvertrag werden durch den dokumentierten Verifikationsworkflow abgedeckt.

Siehe docs/protocol.md für Zustandssemantik, docs/manual-e2e.md für den Abnahmepfad, docs/benchmark.md für das Evaluierungsdesign, docs/source-provenance.md für Quellcode- und Lizenz-Rückverfolgbarkeit und docs/source-backed-reuse-review.md für die historische Designprüfung. Für Mitwirkende: CONTRIBUTING.md. Für Schwachstellenmeldungen: SECURITY.md.