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분 Quickstart (소스 사용 가능)

현재는 소스 경로를 사용하세요. npm과 Marketplace는 아직 배포되지 않았으므로 공개 레지스트리나 디렉토리에서 동일한 이름의 패키지를 설치하지 마세요.

소스 설치 (현재 개발 경로)

전제 조건: Node.js 22.19+ 또는 24+, pnpm, Git, 실행 가능한 DSH 0.1.0-rc.8, Codex CLI 또는 Desktop, 그리고 DSH에 이미 구성된 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

초기화, 설치 및 상태 점검:

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, 동일 세션 계속, 실제 취소 및 기본 작업 공간 불변을 검증합니다.

향후 배포 설치 (npm / Marketplace)

npm 패키지와 Codex Plugin Marketplace 패키지는 아직 배포되지 않았습니다. 향후 패키지 이름, 심사 상태, Node 런타임 및 DSH 버전 제약은 공식 Release Notes를 기준으로 합니다. 현재 버전에서는 배포 설명으로 확인되지 않은 전역 설치 명령을 실행하지 마세요.

두 가지 실행 모드

두 모드는 프로토콜, 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에 민감한 취약점 세부 정보를 제출하지 마세요.

• 행동 강령: 프로젝트 참여 시 공동으로 유지하는 협업 표준.

• 지원 채널: 버그, 기능 제안 및 보안 문제는 어디로 가야 하는지.

• 변경 기록: 현재 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를 따르고, 키, 쿠키, 전체 로그 또는 비공개 코드를 공개 Issue에 붙여넣지 마세요.