dsh-gate

dsh-gate는 Codex가 MCP를 통해 장기 실행되는 DeepSeek Harness 세션을 감독할 수 있게 하면서, DSH Host와 세션을 MCP 프로세스와 독립적으로 유지합니다.

작업 공간에는 다음이 포함됩니다:

• @dsh-gate/mcp-server: DSH의 공용 네트워크 클라이언트와 재연결 컨트롤러를 위한 아홉 개의 MCP 도구;

• @dsh-gate/supervisor-tools: DSH 측 핸드오프, 아티팩트 허용, 보고된 실패 예산 도구;

• 두 가지의 좁은 운영자 스킬, 예제 Codex/DSH 구성, 그리고 결정적 bootstrap/doctor/Host 워크플로.

배포, 검증, 시작

pnpm bootstrap      # fetch the pinned DSH fork commit, build & link the exact
                    # network client, install the supervisor plugin into an
                    # isolated project-local DSH home (.dsh-state/) — never starts the Host
pnpm run doctor     # verify pin, link, built artifacts, and plugin/profile
pnpm host:start     # start the independent DSH Web Host on http://127.0.0.1:8080
pnpm run doctor --live  # additionally verify the running Host identity/protocol

그런 다음 config/codex-mcp.example.toml을 해당 Codex 구성으로 복사하고 <workspace-root> 자리 표시자를 이 체크아웃의 절대 경로로 바꾸세요. 이것이 유일한 머신별 값입니다. 서버 실행 파일은 packages/mcp-server/dist/cli.js입니다. 이전 구성이 여전히 dist/index.js를 가리킨다면 dist/cli.js로 업데이트하세요(라이브러리 진입점은 MCP 서버를 시작하지 않습니다). Codex MCP 구성은 command, args, environment, startup timeout, tool timeout 필드를 가진 stdio 서버를 지원합니다.

전체 운영자 가이드(전제 조건, 호환성 계약 및 업데이트 정책, Host 독립성, 브라우저 가시성, 깨끗한 실패 복구, 공식 업스트림 PR 제한)는 **DEPLOYMENT.md**를 읽으세요.

Related MCP server: codex-worker-runtime

고정된 DSH 포크 커밋

@dsh-gate/mcp-server는 제네릭 network-client 및 reconnect-controller 내보내기인 @deepseek-ai/dsh-client-connection/network-client를 가져옵니다. 이러한 내보내기는 게시된 어떤 DSH 릴리스에도 포함되지 않으며, 정확히 하나의 커밋에서 공개 포크로부터 사용됩니다:

• 포크: https://github.com/yidapan666-creator/deepseek-harness.git

• 커밋: 7212c955438c70c9a2d168f67e85a8014b8d4488

커밋 SHA가 호환성 계약입니다 — bootstrap은 SHA로 가져오고(이동하는 브랜치는 절대 사용하지 않음), doctor는 HEAD가 다르거나 원격 저장소가 해당 포크를 식별하지 못하는 체크아웃을 거부하며, 더티 체크아웃은 파괴적 복구 없이 거부됩니다. 링크 자체는 기존 scripts/link-local-dsh.mjs가 생성하며 bootstrap이 이를 재사용합니다. 이 링크는 로컬 전용이며 패키지 메타데이터에 머신 경로가 커밋되지 않습니다. dist/cli.js는 먼저 해당 연결 지점을 검사하고, 누락된 경우 원시 모듈 해석 오류 대신 명확한 진단 메시지를 출력합니다.

핀을 업데이트하려면 scripts/dsh-gate-lib.mjs에서 DSH_PINNED_COMMIT을 변경하고 .dsh-state/dsh를 제거한 다음 pnpm bootstrap을 다시 실행하세요. 정책 및 포크 커밋이 업스트림 머지로 주장되지 않는 이유는 DEPLOYMENT.md를 참조하세요.

감독 주기

dsh_wait는 5분 집계 진행 주기로 실행됩니다. 기본적으로 약 300000ms마다 한 번의 관찰을 반환하며, 종료 상태, 승인/질문, 체크포인트, 차단 요인, 에스컬레이션과 같은 실질적인 감독 경계가 있을 때만 조기 반환합니다. 일반적인 이벤트 변동은 빠른 반복 대기 호출을 유발하지 않습니다. 각 주기 관찰은 이전 asOfSeq 이후의 진행 상황(단계 델타, 도구 횟수, 토큰 델타)과 함께 성공적인 편집/쓰기로 변경된 고유 프로젝트 파일과 시도된 대상 검증 명령(예: pnpm verify)의 간결하고 제한된 projectActivity 요약을 집계합니다. 종료 관찰은 작업 범위 합계를 포함합니다. 원시 로그, diff 또는 도구 출력은 절대 포함되지 않습니다.

대기 중인 프롬프트는 사람이 읽을 수 있는 목표로 시작한 뒤 영속적 작업 패킷을 포함합니다. 이를 통해 프로토콜 검증은 그대로 유지하면서 DSH Web 사이드바에서 새 감독 세션을 작업 이름으로 인식할 수 있습니다.

긴 핸드오프 세부 사항

supervisor_handoff.summary는 2048자로 제한됩니다. 작업에 더 긴 보고서가 필요한 경우 세션 작업 디렉터리(cwd) 안의 .dsh-handoff/<taskId>/ 아래에 Markdown으로 작성하고, artifacts에 상대 경로를 전달하고, 간결한 요약에서 이를 참조하세요. 핸드오프 도구는 제한을 초과하는 요약을 정확히 이 지침과 함께 거부하며, 핸드오프 데이터 자체를 절대 쓰지 않습니다. 특히 ~/.codex나 다른 전역 디렉터리에는 절대 쓰지 않습니다. 아티팩트 허용은 격리를 강제합니다. 상대 경로만 허용되며, 경로 탐색, 심볼릭 링크, 하드 링크 또는 일반 파일이 아닌 파일은 허용되지 않고, 세션 cwd 내에서 검증된 핸들을 통해 해시됩니다.

릴리스 상태

소스는 MIT 라이선스로 제공되며 yidapan666-creator/dsh-gate에서 공개 호스팅할 준비가 되어 있습니다. DSH 종속성은 SHA로 고정된 공개 포크 커밋이고, 작업 트리에는 머신별 경로나 비밀이 포함되지 않으며, pnpm verify는 bootstrap이 관리하는 링크로 통과합니다. npm 패키지로의 게시는 별개의, 여전히 보류된 결정입니다: 두 패키지 모두 "private": true를 유지하며, 업스트림 DSH network-client 연결 지점이 게시되기 전까지 깨끗한 패키지 설치로 빌드하거나 실행할 수 없습니다(포크 핀은 레지스트리 소비자가 아닌 소스 배포에 유효합니다).

남은 업스트림 제한은 npm 게시입니다. 제네릭 @deepseek-ai/dsh-client-connection/network-client 내보내기가 업스트림에 게시될 때까지 두 패키지 모두 비공개로 유지됩니다. 7212c955438c70c9a2d168f67e85a8014b8d4488의 공개 포크 핀은 오늘날 소스 배포를 재현 가능하게 하지만, 이는 업스트림 머지가 아니며 어떤 머지도 주장되지 않습니다.

소스 설치, 빌드, 테스트, 패키징 검사 및 프로토콜 계약은 문서화된 검증 워크플로로 다루어집니다.

상태 의미는 docs/protocol.md, 승인 경로는 docs/manual-e2e.md, 평가 설계는 docs/benchmark.md, 소스 및 라이선스 추적성은 docs/source-provenance.md, 과거 설계 검토는 docs/source-backed-reuse-review.md를 참조하세요. 기여자는 CONTRIBUTING.md를 확인하세요. 취약점 신고는 SECURITY.md를 확인하세요.