DSH × Codex Bridge

Codex の意思決定力と DSH の実行力を接続する。

日本語 · English · インストール · 使用 · アーキテクチャ

dsh-codex-bridge は、開発者向けのオープンソース Agent インフラストラクチャです。Codex は目標の分解、委任戦略の選択、受け入れ証跡を担当し、DeepSeek Harness（DSH）は指定された Profile 内でコード、テスト、内部 Sub-Agent 作業を実行し、Bridge はプロトコル、隔離ワークスペース、タスクライフサイクル、監査可能な成果物を担当します。

プロジェクトステータス

ソースコード利用可能｜0.1.0-alpha.1｜DSH 0.1.0-rc.8 クローズドループ検証済み

現在のバージョンはソースコードからビルドし、プロジェクトの初期化、ローカル DSH Profile と Codex Plugin のインストール、ヘルスチェックの実行が可能で、MCP 経由で DSH を駆動して隔離された Worktree タスクを完了できます。実際の Provider によるクローズドループの証跡は real-dsh-rc8.json、real-dsh-rc8.patch、real-dsh-rc8-continue.patch に保存されています。

現在のリリース形態はソースコードインストールです。npm パッケージと Marketplace への公開リリースはまだ行われていません。最初のバージョンで固定された DSH 互換ベースラインは 0.1.0-rc.8 です。DSH は Developer Preview のため、DSH のアップグレードには互換性テストが必須であり、バージョン番号だけで可用性を判断することはできません。

Related MCP server: agent-rack

これは何を解決するのか？

タスクがメインモデルの完全なコンテキストを消費する価値がない場合、Codex はそれを DSH に委任できます：

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

Bridge は DSH を Codex のネイティブモデルやネイティブ Sub-Agent として主張しません。デフォルトの Direct Mode は Codex メインスレッドが Bridge MCP を直接呼び出します。オプションの Native Shell Mode は、狭い責務を持つ Codex カスタム Agent をスケジューリングシェルとして生成し、ネイティブスレッドに近い体験を提供しますが、Codex の使用量を追加で消費します。

10 分クイックスタート（ソースコード利用可能）

現時点ではソースコードパスを使用してください。npm と Marketplace は未公開のため、公共の registry やディレクトリから同名のパッケージをインストールしないでください。

ソースコードインストール（現在の開発パス）

前提条件：Node.js 22.19+ または 24+、pnpm、Git、実行可能な DSH 0.1.0-rc.8、Codex CLI または Desktop、そして DSH で設定済みの Provider が少なくとも 1 つ必要です。

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

初期化、インストール、ヘルスチェック：

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"

その後、Codex の新しいセッションで list_profiles を呼び出し、delegate_task を使用して読み取り専用または小規模な実装タスクを委任します。デフォルトのタスクは独立した Git Worktree を使用するため、メインワークスペースは直接変更しないでください。

インストール完了後、ツール名を覚える必要はありません。Codex に直接伝えてください：

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

delegate-to-dsh Skill は利用可能な Profile を発見し、独立したワークフローとレビュー利益に基づいて single または multi を選択し、理由と役割をタスクに書き込みます。「シングル Agent」または「マルチ Agent」と明示的に指定すると、常に自動判断が上書きされます。マルチ Agent は、DSH Session で十分な数の子 Agent 呼び出しと完了イベントが観測された場合にのみ合格とみなされます。

実際の DSH クローズドループ検証

このコマンドは実際の DSH 0.1.0-rc.8 Profile を起動し、現在のマシンで設定済みの Provider を呼び出します。Fake LLM やオフラインシミュレーションではありません：

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

対応する証跡：real-dsh-rc8.json、real-dsh-rc8.patch、real-dsh-rc8-continue.patch、model-matrix.json。実行前に DSH Provider の設定を完了する必要があります。テストは実際のネットワーク/モデル呼び出しを発生させ、一時的な Git Fixture 内でタスク状態、モデルルーティング、自動シングル/マルチ Agent 判断、子 Agent イベント、Artifact Hash、同一 Session での継続、実際のキャンセル、メインワークスペースの不変性を検証します。

将来のリリースインストール（npm / Marketplace）

npm パッケージと Codex Plugin Marketplace パッケージはまだ公開されていません。将来のパッケージ名、審査状況、Node ランタイム、DSH バージョン制約は、正式な Release Notes に従います。現在のバージョンでは、リリースノートで確認されていないグローバルインストールコマンドを実行しないでください。

2 つの実行モード

両モードはプロトコル、Profile、タスク状態、Worktree、Artifact を共有します。モードを切り替えてもタスク結果の形式は変わらないはずです。

ドキュメントナビゲーション

• 完全インストールマニュアル：環境、ソースコードビルド、Direct/Native Shell、アップグレードとアンインストールの境界。

• 完全使用マニュアル：自然言語トリガー、シングル/マルチ Agent、Profile、結果レビュー、継続とキャンセル。

• 10 分入門：ソースコードインストールから最初のレビュー可能なタスクまで。

• 設定リファレンス：Profile、モデルルーティング、ワークスペース、並行性とポリシー。

• 技術実現可能性レポート：公開 API の証跡、境界、M0 PoC。

• ソフトウェアアーキテクチャ計画：Gateway、Task Engine、DSH Adapter とプロトコル。

• 実装とリリース計画：マイルストーン、テスト、Definition of Done。

• セキュリティモデル：キー、パス、ネットワーク、Shell、再帰、成果物の境界。

• トラブルシューティング：doctor、MCP、DSH、Provider、Worktree と復旧。

• 貢献ガイド：ローカル開発、テスト、変更、Pull Request の規範。

• セキュリティ脆弱性の開示：機密性の高い脆弱性の詳細を公開 Issue に提出しないでください。

• 行動規範：プロジェクト参加時に共同で維持するコラボレーション基準。

• サポート窓口：Bug、機能提案、セキュリティ問題はどこに連絡すべきか。

• 変更履歴：現在の Alpha の機能と既知の制限。

現在の制限

• ソースコードインストールのみをサポート。npm パッケージと公共の Codex Plugin Directory は未公開。

• 現在の書き込みランタイムは Git isolated Worktree のみをサポート。

• Bridge は DSH の結果を自動的にコミット、マージ、デプロイ、公開しません。

• Profile 内の一部のネットワーク、拒否パス、ファイル数、ディスクポリシーはまだプロトコル宣言であり、Bridge 側の実行器にはすべてマッピングされていません。

• 決定的なクロスモデル実行には複数の名前付き Profile を使用してください。ロールレベルのサブモデル強制ルーティングには、引き続き DSH Child Setup Contract が必要です。

設計上の約束

• Protocol first：Codex、DSH、および将来の他の Host はバージョン管理された JSON のみを交換し、Cordis のプライベート型を公開しません。

• Profile over model：ユーザーはセマンティックな Profile を選択します。Provider、Model、Reasoning は検証可能な解析結果です。

• Safety by default：デフォルトで Worktree を隔離し、最小権限、リソース上限、キャンセル可能、シークレットのマスキングを備えます。

• Codex owns the decision：DSH が証跡を返し、Codex が受け入れ、継続、キャンセル、破棄を決定します。

• Release as one unit：Codex Plugin、DSH Plugin、共有プロトコルは固定バージョンで同期リリースされます。

オープンソースライセンス

コードは Apache-2.0 を採用しています。サードパーティの依存関係、サンプル、DSH 自体はそれぞれの著作権とライセンスを保持します。正式リリース前に、依存ライセンス一覧、SBOM、ビルド由来の証明が生成されます。

貢献とフィードバック

プロジェクトは再現可能なソースコードのクローズドループを備えています。Issue を提出する前に、貢献ガイド と トラブルシューティング をお読みください。セキュリティ関連の問題は SECURITY.md に従い、キー、Cookie、完全なログ、プライベートコードを公開 Issue に貼り付けないでください。