DSH × Codex Bridge

Verbinde die Entscheidungskraft von Codex mit der Ausführungskraft von DSH.

中文 · English · Installation · Nutzung · Architektur

dsh-codex-bridge ist eine Open-Source-Agent-Infrastruktur für Entwickler: Codex ist für die Zerlegung von Zielen, die Auswahl der Delegationsstrategie und die Abnahmenachweise zuständig; DeepSeek Harness (DSH) ist für die Ausführung von Code, Tests und interner Sub-Agent-Arbeit im angegebenen Profil zuständig; die Bridge ist für das Protokoll, den isolierten Arbeitsbereich, den Aufgabenlebenszyklus und prüfbare Artefakte zuständig.

Projektstatus

Quellcode verfügbar｜0.1.0-alpha.1｜DSH 0.1.0-rc.8 Closed-Loop verifiziert

Die aktuelle Version kann aus dem Quellcode erstellt werden, Projekte initialisieren, lokale DSH-Profile und das Codex-Plugin installieren, Gesundheitschecks ausführen und DSH über MCP für isolierte Worktree-Aufgaben steuern. Closed-Loop-Nachweise für echte Provider sind in real-dsh-rc8.json, real-dsh-rc8.patch und real-dsh-rc8-continue.patch gespeichert.

Die aktuelle Veröffentlichungsform ist die Installation aus dem Quellcode; das npm-Paket und die öffentliche Marketplace-Veröffentlichung stehen noch aus. Die für die erste Version festgelegte DSH-Kompatibilitätsbasis ist 0.1.0-rc.8. DSH befindet sich in der Developer Preview. Daher muss ein Upgrade von DSH Kompatibilitätstests durchlaufen; die Verfügbarkeit darf nicht allein aus der Versionsnummer abgeleitet werden.

Related MCP server: agent-rack

Welches Problem löst es?

Wenn eine Aufgabe es nicht wert ist, den vollständigen Kontext des Hauptmodells zu verbrauchen, kann Codex sie an DSH übergeben:

Codex（计划 / 委派 / 审查）
        │
        │  Direct Mode：默认、低额外成本
        ▼
本地 MCP Gateway + Task Engine
        │
        ▼
DSH Plugin（Profile / 模型 / 工具 / Sub-Agent）
        │
        ▼
隔离 Worktree → Diff、测试、摘要、Artifact

Die Bridge deklariert DSH nicht als natives Codex-Modell oder nativen Sub-Agent. Der Standard-Direct Mode ist ein direkter Aufruf der Bridge-MCP aus dem Codex-Hauptthread; der optionale Native Shell Mode erzeugt einen Codex-Custom-Agenten mit engem Aufgabenbereich als Orchestrierungs-Shell, um ein Erlebnis zu erhalten, das näher am nativen Thread liegt, verbraucht aber zusätzlich Codex-Kontingent.

10-Minuten-Quickstart (Quellcode verfügbar)

Verwenden Sie derzeit den Quellcode-Pfad; npm und Marketplace sind noch nicht veröffentlicht. Installieren Sie keine gleichnamigen Pakete aus der öffentlichen Registry oder dem Verzeichnis.

Installation aus dem Quellcode (aktueller Entwicklungspfad)

Voraussetzungen: Node.js 22.19+ oder 24+, pnpm, Git, ein ausführbares DSH 0.1.0-rc.8, Codex CLI oder Desktop sowie mindestens ein bereits in DSH konfigurierter Provider.

git clone https://github.com/HazenSun/dsh-codex-bridge.git
cd dsh-codex-bridge
corepack enable
pnpm install
pnpm build
pnpm dsh-bridge --help

Initialisierung, Installation und Gesundheitscheck:

BRIDGE_PROJECT=/absolute/path/to/your-project
pnpm dsh-bridge init "$BRIDGE_PROJECT" --mode direct
pnpm dsh-bridge install --source . --codex --dsh --mode direct
pnpm dsh-bridge doctor --config "$BRIDGE_PROJECT/bridge.yaml" --json --redacted
pnpm dsh-bridge profiles validate --config "$BRIDGE_PROJECT/bridge.yaml"

Rufen Sie dann in einer neuen Codex-Session list_profiles auf und delegieren Sie mit delegate_task eine schreibgeschützte oder kleinere Implementierungsaufgabe. Standardaufgaben verwenden einen separaten Git-Worktree; der Hauptarbeitsbereich sollte nicht direkt geändert werden.

Nach der Installation müssen Sie sich keine Tool-Namen merken. Sagen Sie Codex einfach:

使用 DSH 处理这个任务，自己判断单 Agent 还是多 Agent。

Der delegate-to-dsh-Skill erkennt verfügbare Profile, wählt basierend auf dem unabhängigen Workflow und dem Review-Nutzen single oder multi aus und schreibt Begründung und Rolle in die Aufgabe. Die explizite Angabe „Single-Agent" oder „Multi-Agent" überschreibt die automatische Entscheidung immer. Multi-Agent gilt nur dann als bestanden, wenn in der DSH-Session ausreichend Sub-Agent-Aufrufe und Abschlussereignisse beobachtet wurden.

Reale DSH-Closed-Loop-Verifizierung

Dieser Befehl startet ein reales DSH-Profil 0.1.0-rc.8 und ruft den auf der aktuellen Maschine konfigurierten Provider auf; es handelt sich nicht um ein Fake-LLM oder eine Offline-Simulation:

pnpm test:e2e:dsh
pnpm test:e2e:model-matrix

Entsprechende Nachweise: real-dsh-rc8.json, real-dsh-rc8.patch, real-dsh-rc8-continue.patch und model-matrix.json. Vor dem Ausführen muss die DSH-Provider-Konfiguration abgeschlossen sein; der Test erzeugt echte Netzwerk-/Modellaufrufe und verifiziert in einem temporären Git-Fixture den Aufgabenstatus, das Modell-Routing, die automatische Single-/Multi-Agent-Entscheidung, Sub-Agent-Ereignisse, den Artifact-Hash, die Fortsetzung in derselben Session, echten Abbruch und den unveränderten Hauptarbeitsbereich.

Zukünftige Installation (npm / Marketplace)

Das npm-Paket und das Codex-Plugin-Marketplace-Paket sind noch nicht veröffentlicht. Zukünftige Paketnamen, Prüfstatus, Node-Laufzeit und DSH-Versionsbeschränkungen richten sich nach den offiziellen Release Notes. Führen Sie in der aktuellen Version keine globalen Installationsbefehle aus, die nicht durch die Veröffentlichungshinweise bestätigt wurden.

Zwei Betriebsmodi

Beide Modi teilen sich Protokoll, Profile, Aufgabenstatus, Worktree und Artefakte; ein Wechsel des Modus sollte das Format der Aufgabenergebnisse nicht verändern.

Dokumentationsnavigation

• Vollständiges Installationshandbuch: Umgebung, Quellcode-Build, Direct/Native Shell, Grenzen für Upgrade und Deinstallation.

• Vollständiges Benutzerhandbuch: Natürliche Sprachauslösung, Single-/Multi-Agent, Profile, Ergebnisprüfung, Fortsetzen und Abbrechen.

• 10-Minuten-Einstieg: Von der Quellcode-Installation bis zur ersten prüfbaren Aufgabe.

• Konfigurationsreferenz: Profile, Modell-Routing, Arbeitsbereich, Parallelität und Richtlinien.

• Technischer Machbarkeitsbericht: Öffentliche API-Nachweise, Grenzen und M0-PoC.

• Softwarearchitektur-Planung: Gateway, Task Engine, DSH-Adapter und Protokoll.

• Implementierungs- und Veröffentlichungsplanung: Meilensteine, Tests und Definition of Done.

• Sicherheitsmodell: Schlüssel, Pfade, Netzwerk, Shell, Rekursion und Artefaktgrenzen.

• Fehlerbehebung: doctor, MCP, DSH, Provider, Worktree und Wiederherstellung.

• Beitragsrichtlinien: Lokale Entwicklung, Tests, Änderungen und Pull-Request-Standards.