DeepSeek Harness용 OrgX

@useorgx/deepseek-harness-plugin은 DeepSeek Harness 프로필에 OrgX MCP 도구를 추가하며, Harness 헤드리스 모드를 통해 작업공간에 바인딩된 OrgX 게이트웨이 피어를 실행할 수 있습니다.

이 패키지는 개발자 프리뷰입니다. 패키지 설치가 완료되었다는 것은 번들이 존재한다는 것만 증명할 뿐, OrgX 인증, 게이트웨이 승인, 성공적인 디스패치, 배포 또는 프로덕션 사용을 증명하지 않습니다.

OrgX 마법사로 설치

지원되는 사용자 흐름은 OrgX 마법사입니다. 호환되는 DeepSeek Harness 설치를 감지하고, 이 패키지를 headless 프로필에 설치하며, 브라우저에서 OrgX를 페어링합니다:

npx @useorgx/wizard@latest setup

그런 다음 마법사를 통해 작업을 시작하여 DSH가 시작되기 전에 OAuth 토큰을 갱신할 수 있도록 합니다:

npx @useorgx/wizard@latest deepseek "List the OrgX tools available in this workspace."

DSH 번들은 MCP 연결 또는 초기 도구 동기화에 실패하면 시작에 실패합니다. 패키지 존재를 OrgX 도구 표면이 인증되었다는 증거로 간주하지 마십시오.

Related MCP server: dsh-harness-mcp-server

번들을 직접 설치

DeepSeek Harness는 0.1.0-rc.6에 고정되어 있습니다. 고급 사용자는 Node ^22.19.0 또는 >=24.0.0을 사용하여 패키지를 직접 설치할 수 있습니다:

npm install --global @deepseek-ai/dsh@0.1.0-rc.6
export ORGX_MCP_ACCESS_TOKEN='your_orgx_oauth_access_token'
export DEEPSEEK_API_KEY='your_deepseek_key'
dsh plugin --profile headless add @useorgx/deepseek-harness-plugin@0.1.0
dsh --profile headless --dump-config
dsh --profile headless "List the OrgX tools available in this workspace."

소스 개발의 경우 npm pack --ignore-scripts를 실행하고 결과 tarball을 file: URL로 설치하십시오. 단순한 로컬 링크는 동일한 깨끗한 설치 보장을 제공하지 않습니다.

이 패키지는 @useorgx/orgx-gateway-sdk@0.1.0-alpha.9 커밋 49f3cad612954c448878dc62d0f9c6bc87fa0f79의 정확한 MIT 라이선스 OrgX 게이트웨이 피어 클라이언트를 벤더링합니다. DSH는 플러그인을 설치하는 동안 Git 및 기타 이국적인 하위 종속성을 차단하므로, 감사된 해당 클라이언트를 번들링하는 것이 새로운 프로필을 설치 가능하게 유지하는 방법입니다. THIRD_PARTY_NOTICES.md를 참조하십시오.

번들은 orgx라는 이름의 @deepseek-ai/dsh-mcp-client 인스턴스 하나를 마운트합니다. Streamable HTTP를 통해 https://mcp.useorgx.com/mcp에 연결하고 Authorization: Bearer $ORGX_MCP_ACCESS_TOKEN을 보냅니다. 해당 값은 클라이언트가 관리하는 OrgX OAuth 2.1 액세스 토큰이어야 합니다. oxk_ 게이트웨이 키는 호스팅된 MCP에 유효하지 않습니다. 다른 OrgX MCP 엔드포인트를 사용하려면 ORGX_MCP_URL을 설정하십시오. OAuth 토큰이 없거나 초기 MCP 연결 및 도구 동기화가 실패하면 시작에 실패합니다. 이 프리뷰는 브라우저 PKCE 흐름을 실행하거나 토큰을 갱신하지 않습니다. 만료되면 클라이언트가 관리하는 액세스 토큰을 교체하십시오.

DeepSeek Harness 0.1.0-rc.6은 MCP 도구만 브리징합니다. MCP 리소스 및 프롬프트는 이 클라이언트를 통해 사용할 수 없습니다. 비텍스트 MCP 블록은 실행-로컬 결과가 JSON 블록을 유지하더라도 모델 측면에서 손실이 있는 투영을 가집니다.

OrgX 피어 실행

피어는 실행 cwd를 ORGX_WORKSPACE_ROOT 내부로 설정합니다. 요청된 저장소가 해당 디렉터리 외부로 확인되면 Harness가 시작되기 전에 실패합니다. 이는 경로 및 변형 경계이지 호스트 격리가 아닙니다. Harness workspace-write는 동일 사용자의 파일 읽기, 프로세스 가시성 또는 네트워크 액세스를 제한하지 않으므로 모델이나 도구가 다른 호스트 데이터를 관찰하거나 네트워크를 통해 데이터를 보낼 수 있습니다. 해당 위험을 수용한 후에만 ORGX_DEEPSEEK_HOST_ACCESS_ACK=1을 설정하십시오. 승인 없이는 시작 및 자격 증명 준비가 실패합니다.

gateway:drive 및 plugin:heartbeat 범위의 API 키를 사용하십시오. OrgX 게이트웨이 키 응답은 installation_id를 반환합니다. 해당 안정적인 값을 키와 함께 유지하고 매 시작마다 변경하지 않고 전달하십시오.

export ORGX_API_KEY='oxk_your_workspace_key'
export ORGX_MCP_ACCESS_TOKEN='your_orgx_oauth_access_token'
export DEEPSEEK_API_KEY='your_deepseek_key'
export ORGX_WORKSPACE_ID='your-workspace-uuid'
export ORGX_INSTALLATION_ID='install.your-stable-installation-id'
export ORGX_WORKSPACE_ROOT='/absolute/path/to/the/workspace'
export ORGX_DEEPSEEK_HOST_ACCESS_ACK='1'
dsh plugin --profile headless exec orgx-deepseek-harness-peer

이 프리뷰는 관리되지 않는 게이트웨이 프로토콜 v1 피어입니다. 후보/정식 활성화 및 승격 수명 주기를 구현하지 않습니다. ORGX_RUNNER_INSTANCE_ID, ORGX_ACTIVATION_ATTEMPT_ID 또는 ORGX_RUNNER_ROLE을 제공하면 시작이 명확하게 실패합니다. 해당 필드는 하트비트 또는 소켓 URL에 전송되지 않습니다.

WebSocket을 열기 전에 피어는 전송 및 디스패치 준비 상태가 false인 게이트웨이 하트비트를 씁니다. 다음 모든 검사가 성공한 후에만 디스패치 준비 상태를 알립니다:

• dsh --version은 고정된 런타임 프로세스가 살아 있음을 증명합니다.

• 고정된 공식 https://api.deepseek.com/user/balance 엔드포인트가 DEEPSEEK_API_KEY를 수락하고 추론 요청 없이 is_available: true를 보고합니다.

• MCP Streamable HTTP 초기화 및 tools/list 교환이 ORGX_MCP_ACCESS_TOKEN을 수락합니다.

비밀 존재 및 자격 증명 없는 버전 명령은 인증으로 간주되지 않습니다. 프로브 실패, 거부되거나 만료된 자격 증명, 누락된 증거는 실패-폐쇄 상태로 유지됩니다. 성공적인 증거는 45초 동안 캐시됩니다. 피어는 15초마다 게이트웨이 존재를 갱신하고 소켓이 닫힐 때 최선의 오프라인 하트비트를 씁니다.

DSH 자식은 제공자 키와 별도로 범위가 지정된 MCP 액세스 토큰을 받지만 게이트웨이 키는 받지 않습니다. 주변 DSH_* 제어는 DSH_HOME을 제외하고 전달되지 않습니다. 자식은 workspace-write 권한으로 강제되고 텔레메트리는 비활성화되어 주변 전체 액세스 또는 OTLP-내보내기 설정이 해당 두 정책을 재정의할 수 없습니다. 이러한 설정은 여전히 호스트 읽기, 프로세스 또는 네트워크 액세스를 격리하지 않습니다.

선택적 런타임 설정:

• ORGX_BASE_URL은 OrgX 게이트웨이 기본 URL을 변경합니다.

• ORGX_RECEIPT_OUTBOX_PATH는 절대 내구성 영수증 디렉터리를 설정합니다. 기본값은 현재 사용자의 OrgX 상태 디렉터리 아래에 있습니다.

• ORGX_DEEPSEEK_HARNESS_BIN은 실행 파일 경로를 dsh에서 변경합니다.

• ORGX_DEEPSEEK_HARNESS_PROFILE은 프로필을 headless에서 변경합니다.

• ORGX_DEEPSEEK_HARNESS_MODEL은 deepseek-official 제공자에 대한 패키지된 모델 패치를 활성화합니다. 구성 기본값을 변경합니다. DSH 설정에 이미 저장된 모델이 여전히 우선할 수 있습니다.

Harness 헤드리스 stdout은 최종 어시스턴트 텍스트와 종료 코드를 포함하지만 토큰 또는 비용 회계는 포함하지 않습니다. 따라서 드라이버 와이어 메시지는 숫자 tokens_used: 0 및 cost_estimate_cents: 0을 전달해야 합니다. 둘 다 이 소스에서는 알 수 없음을 의미하며 무료가 아닙니다. OrgX는 지속된 DeepSeek 비용을 보수적인 디스패치 추정치로 정규화하고, 계량 품질을 기록하며, 해당 추정치를 예산 한도에 누적합니다. 0 프로세스 종료는 outcome_kind: awaiting_review를 보고합니다. 프로세스는 완료되었지만 작업이 아직 수락, 병합, 배포 또는 프로덕션에서 입증되지 않았습니다.

SDK의 WebSocket 전송에는 서버 확인이 없으므로 애플리케이션이 내구성을 소유합니다. task.started를 생성하기 전에 피어는 원자적으로 시작 전 예약 마커를 씁니다. 해당 쓰기가 실패하면 Harness가 생성할 수 있기 전에 내부 반복자를 닫고 최선의 POST로 차단된 영수증을 보냅니다. 시작 후 task.completed 프레임을 생성하기 전에 피어는 모드-0600 파일을 사용하여 정확한 v1 HTTP 영수증을 모드-0700 outbox에 원자적으로 쓴 다음 멱등성 실행-영수증 엔드포인트에 POST합니다. 키나 토큰은 두 파일에 기록되지 않습니다.

2xx 응답만이 최종 영수증을 제거합니다. Harness가 완료된 후 최종 지속이 실패하면 피어는 즉시 바인딩된 HTTP 영수증을 직접 시도하고 여전히 원래 완료를 생성합니다. 2xx는 예약을 지웁니다. HTTP도 실패하면 완료는 메모리 내 재시도 큐에 남아 있고 예약 마커는 유지됩니다. 보류 중인 영수증은 시작, 재연결 및 15초마다 하트비트 틱에서 재시도됩니다. 해결되지 않은 예약으로 재시작하면 재실행 위험 대신 수리 메시지와 함께 실패-폐쇄됩니다.

고정된 SDK는 소켓 전용 task.failed를 내구성 있게 복구할 수 없습니다. 따라서 실행이 시작된 후 피어는 실패 이유를 단계로 기록하고 outcome_kind: blocked를 내보냅니다. 취소는 outcome_kind: abandoned를 내보냅니다. 둘 다 애플리케이션 outbox를 사용합니다. task.started 전에 거부된 중복은 task.failed로 유지되며 해당 실행 ID를 이미 소유한 디스패치를 종료할 수 없습니다.

검증

패키지 개발의 경우 수명 주기 스크립트 없이 고정된 종속성을 설치한 다음 결정론적 검사를 실행하십시오:

npm install --ignore-scripts --no-package-lock
npm run validate

패키지 테스트 스크립트는 test/*.node-test.mjs에 대해 명시적으로 node:test를 실행합니다. Node 전용 접미사는 이러한 스위트를 저장소의 루트 Vitest 검색에서 제외하면서 npm run validate에서 유지합니다.

검증은 번들 및 매니페스트, 증거 기반 준비 상태, 작업공간 및 자식 환경 경계, 취소 및 중복 경합, 관리되지 않는 프로토콜-v1 하트비트, 고정된 SDK의 연결 끊김 시 HTTP 실패 복구를 확인합니다. OrgX 또는 DeepSeek에 접촉하지 않습니다.