Codex-DSH-Orchestrator

English | 简体中文

Codex-DSH-Orchestrator ist eine Codex-zentrierte Orchestrierungsschicht und eine Caller-seitige MCP-Bridge für die abgegrenzte Zusammenarbeit mit DeepSeek Harness (DSH). Sie ermöglicht es Codex, Implementierungs-, Recherche-, Debugging- und Arbeit mit langen Logs an DSH zu delegieren und diese Sitzungen dann zu beobachten, fortzusetzen oder abzubrechen, ohne den normalen Workflow zu verlassen. Claude Code bleibt über die gemeinsame Caller-Integrationsschicht unterstützt; andere Caller werden bewusst zurückgestellt, bis ihr Host-Verhalten verifiziert werden kann.

Die gemeinsame Bridge-Laufzeitumgebung in diesem Repository ist eine unabhängig gepflegte Weiterentwicklung des dsh-Agentlink-Projekts. Das Projekt behält die Upstream-MIT-Lizenz und die Urhebernennung bei und ist weder mit DeepSeek noch mit OpenAI oder den Upstream-Maintainern verbunden, noch wird es von ihnen unterstützt.

Projektabgrenzung

Codex-DSH-Orchestrator ist ein Caller-seitiges Orchestrierungs- und MCP-Bridge-Projekt. Es verbindet unterstützte Caller mit einem unabhängig laufenden DSH-Web-Host; es startet, besitzt oder authentifiziert diesen Host nicht und genehmigt DSH-Anfragen niemals automatisch. Es ist kein DSH-Cordis-Bundle.

Related MCP server: deepseek-harness-mcp

Projektkomponenten

• skill/codex-dsh-orchestrator/ — das projektspezifische Codex-Orchestrierungs-Skill und seine Agenten-Metadaten.

• skill/codex-dsh/ — das gemeinsame Codex-Caller-Kompatibilitätsskill.

• skill/claude-code-dsh/ — das beibehaltene Claude-Code-Caller-Kompatibilitätsskill.

• src/ — die gemeinsame caller-neutrale MCP-Bridge-Laufzeit und die Setup-Werkzeuge.

• test/ — lokale Mock-Host-, Sicherheits-, Kompatibilitäts- und Integrationstests.

• docs/project-overview.md — die detaillierte Zuordnung von Zuständigkeiten und Architektur.

Der Name dsh-Agentlink bleibt in den Laufzeitbezeichnern und der Upstream-Nennung aus Gründen der Kompatibilität und rechtlichen Klarheit erhalten; er ist nicht der öffentliche Projekttitel.

Caller-Unterstützung

Nur Caller, die als Unterstützt markiert sind, besitzen heute einen Installationspfad in diesem Repository. Geplante Einträge sind Richtungsangaben, keine Veröffentlichungszusagen.

Installation

Bereiten Sie zuerst die Umgebung vor: Sie benötigen Node.js 22+, einen unterstützten Caller (Codex oder Claude Code) und ein funktionierendes DSH CLI. Die getestete plattformübergreifende Basis ist x64 mit Node.js 22 und 24; andere Node.js-Hauptversionen und ARM64-Umgebungen werden von der aktuellen Testmatrix nicht abgedeckt. Konfigurieren Sie Ihr bevorzugtes Modell einmal in DSH; die gemeinsame Bridge übernimmt diese aktive Route, sofern nicht ein Delegat explizit ein unterstütztes semantisches Profil anfordert.

Grenzen von Portabilität und Installation

• Verwenden Sie auf einem anderen Rechner einen frischen Klon. Kopieren Sie kein einzelnes Worktree-Verzeichnis: Seine .git-Datei verweist auf die Worktree-Metadaten des Quellklons. Erstellen Sie Worktrees auf demselben Rechner über git worktree add.

• Bevorzugen Sie npm ci für einen sauberen, reproduzierbaren Checkout. Verwenden Sie npm install nur, wenn Sie die Lock-Datei absichtlich aktualisieren möchten.

• npm run setup schreibt den absoluten Pfad der Node.js-Ausführung und den erstellten Bridge-Einstiegspunkt in die Caller-Konfiguration. Bewahren Sie den Checkout in einem stabilen Tools-Verzeichnis auf; nach einem Umzug, einem Wechsel der Node.js-Installation oder einem Wechsel zu einem anderen Worktree bauen Sie neu, führen das Setup erneut aus, prüfen den vorhandenen Eintrag und verwenden --replace nur mit ausdrücklicher Genehmigung.

• Codex-MCP-Einrichtung und Codex-Skill-Installation sind getrennt. npm run setup registriert den MCP-Eintrag, installiert aber nicht skill/codex-dsh-orchestrator/. Installieren und aktivieren Sie dieses Skill über Ihren normalen Codex-Skill-Workflow, und prüfen Sie anschließend, dass es auffindbar ist, bevor Sie sich auf den Befehl $codex-dsh-orchestrator verlassen. Der Claude-Code-Setup verwaltet das zugehörige Projekt-Skill separat, wie unten beschrieben.

• Halten Sie DSH_BRIDGE_HOME in einem zuverlässigen lokalen Dateisystem. Kopieren Sie kein altes Bridge-Home auf einen anderen Rechner, sondern verwenden Sie dort einen neuen Anlaufpunkt. Der DSH-Konversationsverlauf gehört dem DSH-Web-Host; Bridge-Aufgabenzuordnungen, Cursor und Claims werden nicht automatisch migriert.

• Windows-desktop-auto ist eine Opt-in-Option. Sie erfordert einen bereits laufenden DSH-Desktop-Host sowie die unterstützten Windows-Prozess-/Loopback-Erkennungsvoraussetzungen; CI simuliert diese Verhaltensweisen und belegt keine echte Desktop-Installation oder -Anmeldung. Der Einrichtungsassistent startet, stoppt und protokolliert sich nie bei DSH Desktop.

Mit dem KI-Agenten installieren

Senden Sie die folgende Repository-URL und Anweisung an Codex oder einen anderen Coding-Agenten:

Install Codex-DSH-Orchestrator from https://github.com/Fly2Kiana/Codex-DSH-Orchestrator.
Check Node.js 22+, the DSH CLI, and my DSH Web Host first. Clone it into a location I approve,
run npm ci and npm run check. For Codex, run npm run setup -- --yes, then install and verify
the shipped Codex skill separately through my normal Codex skill workflow. For Claude Code, run
npm run setup:claude -- --yes --project /absolute/path/to/my/project.
For Claude Code, let setup install the project MCP entry and shipped project skill; use --replace and --replace-skill only after reviewing existing files.
If dsh_agentlink or the legacy dsh_collab entry already exists, show me the conflict before using --replace.
Do not start or stop dsh web for me. Tell me when I need to reload the selected caller and approve project MCP trust.

Manuelle Installation

1. Prüfen Sie die Umgebung. Das DSH-CLI 0.1.0-rc.6 ist das aktuell getestete Ziel.

   node --version
   dsh --version

2. Starten Sie den offiziellen DSH-Web-Host in einem eigenen Terminal.

   dsh web

3. Klonen Sie das Repository und installieren Sie seine Abhängigkeiten.

   git clone https://github.com/Fly2Kiana/Codex-DSH-Orchestrator.git
   cd Codex-DSH-Orchestrator
   npm ci

4. Konfigurieren Sie Ihren Caller.

   Für Codex:

   npm run setup
   npm run doctor

   Wählen Sie unter Windows mit DSH Desktop und dessen wechselndem Loopback-Port explizit die automatische Erkennung:

   npm run setup -- --desktop-auto

   Der Codex-Assistent sichert die Codex-TOML-Konfiguration und installiert den MCP-Eintrag mit approval_mode = "prompt"; er installiert nicht skill/codex-dsh-orchestrator/. Installieren und aktivieren Sie dieses Skill über Ihren normalen Codex-Skill-Workflow und prüfen Sie, dass es auffindbar ist. Das statischen Setup verlangt weiterhin dsh --version; --desktop-auto kann dagegen den bereits laufenden Desktop-Host validieren, sogar wenn CLI nicht im PATH liegt, und meldet die fehlende Paketversion als Kompatibilitätswarnung. Es startet oder stoppt DSH Desktop nie. Das Umschalten eines vorhandenen Bridge-Eintrags auf einen der beiden Modi erfordert weiterhin dessen Prüfung und das Hinzufügen von --replace. Starten Sie Codex neu, und stellen Sie dann über /mcp oder die Codex-Einstellungen sicher, dass dsh_agentlink verbunden ist. Für eine vollständig manuelle TOML-Einrichtung siehe Manuelle Codex-MCP-Konfiguration.

   Für Claude Code 2.1.199 oder neuer richten Sie den Setup-Befehl auf das Projekt, das .mcp.json gemeinsam nutzen soll:

   npm run setup:claude -- --project /absolute/path/to/your/project
   cd /absolute/path/to/your/project
   claude mcp get dsh_agentlink

   Das Claude-Setup bearbeitet nur die .mcp.json jenes Projekts und .claude/skills/claude-code-dsh/SKILL.md und lässt unnötige Server unvergührt. Es meldet jeden dieser Punkte separat:

   • MCP-Registrierung

   • Projektvertrauen

   • Claude-Skill-Status

   • Claude-Genehmigungsunterstützung

   • DSH-Berechtigungs-/Sandbox-Besitz

   • Erreichbarkeit des DSH-Hosts

   Öffnen Sie Claude Code im Projekt und genehmigen Sie den ausstehenden Server über /mcp; die Bridge kennzeichnet dsh_resolve_approval als einen Vorgang, der menschliche Interaktion erfordert.

   Verwenden Sie --yes, um unbeaufsichtigte Standardwerte zu übernehmen. Um einen vorhandenen MCP-Eintrag zu aktualisieren, prüfen Sie ihn zuerst und fügen anschließend --replace hinzu; um ein vorhandenes Claude-Skill im Projekt zu aktualisieren, prüfen Sie es zuerst und fügen --replace-skill an; wenn Sie das Skill selbst verwalten, verwenden Sie --no-skill. Beide Installer erkennen die veraltete Eingabe dsh_collab und migrieren sie nur nach ausdrücklicher Genehmigung der Ersetzung zu dsh_agentlink. Keiner der Installer startet DSH, ändert DSH-Berechtigungs-/Sandbox-Einstellungen oder startet den Caller neu.

Die doctor-Diagnose meldet die Fail-Closed-Sperrorte der Bridge unter DSH_BRIDGE_HOME schreibgeschützt und bereinigt sie nie, sodass sie auch bei vorhandener Sperre sicher ausgeführt werden kann.

Dieser Quell-Patch verhindert, dass neue Projektion-/Chunk-Sintfluten das Koordinationsbuch vergrößern, verdichtet aber kein vorhandenes 5-MB+-Ledger. Bewahren Sie das alte Bridge-Home für eine Inspektion auf; neue Delegationen können sich auf ein separates DSH_BRIDGE_HOME stützen. Die DSH-session.history ist die maßgebliche Wahrheitsquelle; das Bridge-Ledger ist es nicht. Siehe Bekannte Probleme für die konservative Wiederherstellungsgrenze.

Diese Bridge (Laufzeitname dsh_agentlink) ist ein caller-seitiges Plugin, kein DSH-Cordis-Bundle. Installieren Sie es nicht mit dsh plugin --profile ... add ...befahl.

Warum Codex-DSH-Orchestrator?

DSH-Harness-Fähigkeiten nutzen

DSH vereint persistente Sitzungen, Tool-Ausführung, Sub-Agenten und menschliche Aufsicht für die Bearbeitung komplexer Aufgaben. Codex-DSH-Orchestrator lässt Ihren primären Caller – derzeit Codex oder Claude Code – diese Einrichtung besprechen und koordinierenmit einer zweiten Arbeitsumgebung, während Sie im selben Ablauf bleiben.

Mehreigen als ein weiteres nativ Sub-Modul

Ein eigenständiges Submodul bleibt im eigenen Agent-Baum des Keepers. Die gemeinsame Bridge fügt eine zusätzliche, von Ihnen selbst konfigurierte Arbeitsumgebung hinzu: ihre Sitzungen bleiben im DSH Web sichtbar und können auch die eigenen Worker und ; ihre Modellroute von DSH während des Betriebs nutzen und vom primären Caller beobachtet, fortgesetzt oder abgebrochen werden.

Zeit und Kosten sparen

• Zeit sparen. Leiten Sie Implementierungs-, Recherche-, Debug- und Long-Log-Aufgaben an ein in DSH eingerichtetes schnelles Modell weiter, zum Beispiel eine DeepSeek-V4-Route, während Ihr primärer Agent weiter plant und das Ergebnis prüft.

• Geld sparen. Wenn ausführungsintensive Aufgaben an eine preiswertere DeepSeek-Route gehen, kann das den Verbrauch der teueren primären Modelle reduzieren.

Die tatsächliche Geschwindigkeit und die Kosten hängen vom gewählten Modell, vom Anbieter, vom Deploymenturt, vom Netzwerk und der Aufgabe ab. Nach der Installation können Sie einfach in Codex oder Claude Code weiterarbeiten und es darum bitten. Erst wenn DSH der bessere Ausführungspfad ist, delegieren.

Verwenden

Wenn dsh web läuft und Ihr Caller die MCP-Konfiguration geladen und vertraut, können Sie Codex oder Claude Code in normaler Sprache auffordern, zum Beispiel:

Verwende Codex-DSH-Orchestrator, um diese Implementierung im aktuellen Repository an DSH zu delegieren. Behalte sie in DSH

so zu sein, diese sichtbar ist, berichte den Fortschritt und frag mich bei jeder Genehmigung zur.

Der Caller kann dann die Aufgabe übernehmen, den Ereignisstrom der Sitzung ansehen, die Sitzung so wieder aufnehmen, sich mit Ihnen abstimmen oder die Arbeit befustigen. Öffnen Sie den konfigurierten DSH-Stammserver, greifen Sie auf dasselbe zu und arbeiten Sie damit. Auf Windows kann eine definierte DSH_HOST_MODE=-Laufzeit aus der der Wahl den gesicherten loopback-Hörer?

usern Discovery besitzen, statt den sich ändernen temporären Port zu verwenden; eine explizite DSH_HOST_URL hat immer Vorrang.

Vor einer neuen Beauftragung erstellt der Anrufer im Prompt eine kompakte Übergabe auf der Grundlage bekannter Fortschritte und schreibgeschützter Bereits Nachweise: Ziel, abgeschlossene Arbeit, Git HEAD/Status und geänderte Pfade, sofern vorhanden, fokussierte Pfade für C-Code/Markdown-Dateien, relevante Testfälle, Randbeschränkungen und ungelöste Probleme. Er instrruiert DSH, zuerst diese Fokus zu lesen und keine gesamtkopierte Scans zu machen, falls das nicht nötig ist. Die Übergabe enthält keine Geheimnisse, rohen großen Diffs, Dateien, Chat-Inhalte des Ansetzers oder interne Gedanken. Dieses Verhalten ist ein einzuges System des Callers, keine neue Dateiautorisierung; ded-Agentlink ist nicht dabei, den Zustand der vorherigen Anrufer bekannt.

Für dieselbe bekannte Bridge-Task verwendet der Caller dsh_followup; ist keine passende Task-ID bekannt, startet er eine eigene neue Delegation, statt eine alte ID zu raten.

Wenn der Benutzer die Klarheitzen vorhandenen Sitzung (DSH Desktop) bemerkt, kann der Caller zuerst mit dsh_find_sessions beschränkte Metadaten der Stützsitzung anderen und anschließend dsh_attach_session mit der identisch passenden Sitzungs-ID und frischen Vorbedingungen ausführen. Titel dienen zur Auffindung, nicht als Identität. Die Anlage akzeptiert nur eine inaktiven Root-Session, erstellt oder benutzt erneut einen bbridge-lokalen Map und Workbereich-Anspruch und kann den Verlauf für die Beurichtung abgleichen, aber erübt nicht, noch speichert sie Nachterinhalte übergeben. Eine weitere dsh_followup transportiert den Zusammenhaltes weiter, wenn die Arbeit fortgesetzt werden soll.

Die Wiederverwendung einer Sitzung über mehrere Codex-Aufgaben hinweg ist eine konservative Entscheidung mit drei Optionen: same-known-task, attached-existing-task oder new-session. Verwenden Sie nur dieselbe bekannte BridgeTask für denselben Workstream wieder. Für eine neue Aufgabe mit eindeutigen Fortsetzungsbe