DSH ⇄ ChatGPT Fusion Gateway

, let's check requirement: "Translate prose only. Keep the following verbatim in the source script, including where they appear in running text without backticks: Product, project, organization, repository names (Claude Desktop, Playwright, Node.js, owner/my-mcp-server)." It specifically lists "Claude Desktop" etc, not part of this input. But the rule: keep product/project organization names verbatim. This includes "DeepSeek Harness", "ChatGPT Web", "DSH", "OpenAI", "DeepSeek". We'll keep. "Node.js" keep. "Chrome" keep. "Cloudflare" keep. "Linux, macOS, Windows" maybe platform names keep. "OAuth 2.0" keep? It's a protocol name. "HTTP 410" keep. We will translate "Bearer" maybe? Not important.

Need "the Gateway" maybe "Gateway" keep in English. Yes.

Need no over-translation of "The gateway" maybe "Das Gateway". Good.

Let's now produce final output without code# DSH ⇄ ChatGPT Fusion Gateway

Eine minimale MCP-Brücke, die DeepSeek Harness (DSH) als die einzige Agenten- und Laufzeitumgebung beibehält und ChatGPT Web nur als einen zustandslosen, einmaligen Reasoning-Provider nutzt.

DSH besitzt Agenten, Tools, Berechtigungen, Sitzungen, Komprimierung, Subagenten, Workflows, Ziele und die echte Datei-/Shell-Ausführung. Das Gateway leitet lediglich einen unveränderlichen DSH-Kontext-Snapshot an eine ChatGPT-„Brain“-Konversation weiter und leitet genau eine Entscheidung zurück – eine endgültige Antwort, einen Aktionsvorschlag oder einen begrenzten readonly_batch. Das Gateway führt die vorgeschlagene Aktion selbst nie aus.

User
 ↓
DSH UI
 ↓
DSH Native Agent Loop  →  Context / Compaction
 ↓
ChatGPT Fusion LLM Adapter
 ↓
Fusion Reasoning Gateway          ← this repository
 ↓
ChatGPT Brain Worker              (a dedicated ChatGPT Web conversation + optional wake extension)
 ↓
final | action_proposal | readonly_batch
 ↓
Gateway validation
 ↓
DSH Permissions / ToolRuntime  →  DSH Native Tool  →  Next DSH Tick

Funktionen

• Strenger Ein-Ergebnis-Reasoning-Kontrakt – jede Anfrage trägt einen vollständigen, unveränderlichen Snapshot; das Brain liefert genau ein endgültiges Ergebnis zurück (final, action_proposal, oder einen begrenzten readonly_batch mit read/glob/grep).

• Wiederherstellbare Zustellung – Anfragen werden auf der Festplatte journaliert; ein abgestürztes Gateway stellt in Bearbeitung befindliche Claims wieder her, anstatt sie zu verlieren. Wiederholungen sind durch Snapshot + Nonce idempotent.

• Multi-Worker-Failover – mehrere Brain-Konversationen können dieselbe Modellroute bedienen; ein festgefahrener Claim wird freigegeben und mit rotiertem Nonce an einen gesunden Standby neu zugestellt.

• OAuth 2.0 (Loopback) – optionale Authentifizierung für den öffentlichen ChatGPT-Connector (/brain-mcp), mit rotierenden Access-/Refresh-Tokens.

• Plattformübergreifend – das Gateway und der Node-Daemon laufen unter Linux, macOS und Windows.

• Optionaler Browser-Autowake – eine Chrome-Erweiterung (browser-autowake/) pollt Loopback-Warteschlangen-Metadaten und weckt einen streckenbezogenen Brain-Tab, wenn Arbeit ansteht.

Related MCP server: chatgpt-mcp

Anforderungen

• Node.js 18+ (nutzt das globale fetch).

• git (unter Linux auch der konfigurierte Befehlsbenutzer) für die Workspace-Tools.

DSH selbst muss für den DSH-nativen Agenten-Loop und die Tool-Laufzeit verfügbar sein; das Gateway erkennt die DSH-gebündelten node_modules automatisch, oder Sie können es mit der Umgebungsvariable DSH_NODE_MODULES darauf zeigen.

Schnellstart

git clone <your-repo-url>
cd dsh-chatgpt-mcp
npm install

Setzen Sie echte Zugangsdaten in config.json und model-bindings.json ein (alle Werte werden als REDACTED_*-Platzhalter ausgeliefert), und starten Sie dann:

npm run daemon:start     # background, supervised with auto-restart
npm run daemon:status

…oder führen Sie im Vordergrund aus:

npm start                # node server.strict.cjs

Das Gateway bindet an http://127.0.0.1:7688. Detaillierte Architektur und Invarianten finden Sie aufrufen in ARCHITECTURE.md.

Konfiguration

config.json

ownerPassword, staticToken und die Bind-Schlüssel sind erforderlich und müssen vor der Verwendung ausgefüllt werden. Auf macOS/Windows gibt es keinen portablen setuid-Helfer, deshalb laufen Sandbox-Befehle als aktueller Benutzer und commandUser wird ignoriert.

model-bindings.json

Weist jeder modelId- und reasoningEffort-Route einen bindingKey zu. Der bindingKey ist das Geheimnis, das mit einer passenden brain-worker-*.txt-Datei geteilt wird; halten Sie beide synchron.

Dienststeuerung

Funktio­niert identisch auf Linux, macOS und Windows:

node scripts/daemon.mjs start      # start detached supervisor + server
node scripts/daemon.mjs stop
node scripts/daemon.mjs restart
node scripts/daemon.mjs status

Diese sind auch als npm run daemon:start|stop|restart|status verfügbar. Die nur für Linux verfügbaren, auf screen basierten Skripte bleiben in scripts/ (control.sh, public_quick.sh, …) für den Cloudflare-Quick-Tunnel und die Headless-Chrome-Worker-Pools.

Reasoning-Protokoll (v4)

Das Gateway spricht ein striktes Protokoll zu dem ChatGPT-„Brain“:

fusion_wait_for_reasoning_request  →  one immutable snapshot + data-only action catalog
fusion_submit_reasoning_result     →  exactly one {final} | {action_proposal} | {readonly_batch}
fusion_fail_reasoning_request      →  terminal failure for the assigned snapshot

actionCatalog ist nur Daten – eine Beschreibung der nativen DSH-Tools, die nie als ChatGPT/MCP-Tools installiert werden. Ein action_proposal ist eine Empfehlung, die DSH später unter seiner eigenen Berechtigungs-/Sandbox-Richtlinie ausführt. Das Gateway führt sie nicht aus.

Der öffentliche Endpunkt ist „GET|POST /brain-mcp. Die ehemaligen Routen /mcp und /fusion/tasks… geben HTTP 410 zurück (deaktiviert).

Berechtigungen

Verwendet das native dreistufige DSH-Modell – read-only, workspace-write, danger-full-access – mit workspace-write als Standard.

Repository-Struktur

server.strict.cjs        active gateway (strict v4; no legacy /mcp)
server.cjs               full gateway incl. workspace file/shell tools
config.json              runtime configuration (secrets are placeholders)
model-bindings.json      modelId → bindingKey map
scripts/daemon.mjs       cross-platform daemon (start/stop/restart/status)
scripts/*.sh             Linux deployment helpers (screen, cloudflared, Chrome workers)
brain-worker-*.txt       per-route prompts for dedicated Brain conversations
browser-autowake/        optional Chrome extension that wakes Brain tabs
tests/                   selftests and headless integration workers
state/  logs/            runtime artifacts (gitignored)

Testen

npm install
node tests/reasoning-contract-v4-selftest.mjs   # primary protocol test
# …plus oauth, worker-recovery, failover, context-overflow, payload-limit selftests

Siehe den Abschnitt ## Verification der Implementierungsnotizen für die vollständige Matrix.

Sicherheitshinweise

• Standardmäßig an 127.0.0.1 binden; nur das Quick-Tunnel-Skript stellt eine öffentliche URL bereit.

• Committen Sie config.json oder model-bindings.json nicht mit echten Geheimnissen – deshalb wird dieses Repository mit Platzhaltern ausgeliefert.

• /bin/setpriv wird auf Linux verwendet, um Sandbox-Befehle auf commandUser zu reduzieren; auf anderen Plattformen laufen Befehle als aktueller Benutzer.

DSH ⇄ ChatGPT Fusion ist eine Community-Brücke und ist nicht mit OpenAI oder DeepSeek verbunden oder von diesen empfohlen. Die Nutzung von ChatGPT unterliegt den Nutzungsbedingungen von OpenAI.