DeepSeek Harness

DeepSeek Harness (dsh)는 제1자 npm 번들 @chorus-aidlc/chorus-dsh를 통해 Chorus에 연결됩니다. 이 번들은 Chorus MCP 도구, 워크플로 스킬, 페르소나를 dsh 프로필에 추가합니다. dsh는 대화식으로 사용할 수 있으며, dsh 0.1.2-rc.1부터는 Chorus가 데몬 백엔드로서 dsh를 무인으로 깨울(wake) 수도 있습니다.

설치 전에 0.1.2-rc.1 이상의 dsh(및 pnpm)를 사용하고 에이전트 액세스 준비에 따라 에이전트 키를 만드세요.

번들 설치와 자격 증명 저장

chorus agents add는 번들을 dsh 프로필에 설치하고 자격 증명을 $DSH_HOME/.env에 한 번에 씁니다. 프로필 이름은 --dsh-profile로 지정합니다:

npm install --global @chorus-aidlc/chorus
chorus agents add --agents dsh --dsh-profile <name>

프롬프트가 나오면 Chorus URL과 에이전트 키를 입력합니다. dsh는 도구 하위 프로세스에서 자격 증명 형태의 변수를 제거하므로, chorus agents add는 CHORUS_URL, CHORUS_API_KEY, CHORUS_AGENT_PROFILE를 $DSH_HOME/.env에 저장하고, dsh가 이를 세션에 로드합니다. dsh는 다음 순서로 자격 증명을 해석합니다: 환경 변수 → $DSH_HOME/.credentials.yaml → <cwd>/.env → $DSH_HOME/.env.

번들을 직접 추가하려면 다음을 실행한 뒤(dsh 프로필은 pnpm 워크스페이스 루트이므로 -w가 필요합니다), $DSH_HOME/.env에 자격 증명을 직접 설정하세요:

dsh plugin --profile <name> add @chorus-aidlc/chorus-dsh -w

연결 확인

프로필을 실행합니다:

dsh --profile <name>

“check in to chorus”라고 요청하세요. Chorus에서 설정 → 에이전트를 열고 dsh 연결이 온라인인지 확인합니다.

데몬 백엔드로 실행하기 (선택)

dsh 0.1.2-rc.1부터 Chorus는 Claude Code, Codex, Kiro를 깨우는 것과 동일하게 dsh를 무인으로 깨울 수 있습니다. 먼저 chorus agents add --agents dsh로 자격 증명을 한 번 저장한 뒤, dsh 백엔드를 선택해 데몬을 시작합니다:

chorus daemon --agent dsh

데몬은 dsh를 처음 깨울 때 자체 관리형 sdk 프로필을 빌드하고 검증하므로, 이 경로에는 자격 증명만 있으면 되고 프로필을 수동으로 설치할 필요가 없습니다. dsh 본체는 PATH에 있어야 합니다(또는 CHORUS_DSH_PATH 설정). Chorus는 dsh 런타임을 번들하지 않습니다. Chorus 디스패치(dsh에 idea/작업 할당 또는 @멘션)가 dsh를 깨웁니다.

각 wake는 새로운 dsh 세션입니다(dsh에는 네이티브 wake 간 세션 재개가 없습니다). Chorus는 대화 컨텍스트를 할당된 idea/작업에 보관하고, 깨어난 dsh 에이전트는 Chorus MCP 도구로 이를 다시 읽어옵니다.

기능과 제한

번들은 Chorus MCP 도구, 워크플로 스킬, Chorus 페르소나를 제공합니다.
dsh는 자체 프로필을 통해 대화식으로 동작하며, 무인 데몬 백엔드(chorus daemon --agent dsh)로도 동작합니다.
wake마다 dsh는 새 세션을 시작합니다. 네이티브 wake 간 세션 재개는 없으며, 연속성은 wake가 연결된 Chorus 리소스에서 옵니다.

자주 발생하는 문제

dsh 또는 pnpm을 찾을 수 없음: 두 전제 도구를 설치하고 새 셸을 엽니다.
ERR_PNPM_ADDING_TO_ROOT: -w를 붙여 명령을 다시 실행하세요. dsh 프로필은 pnpm 워크스페이스 루트입니다.
패키지를 찾을 수 없음: 레지스트리 액세스와 패키지 이름 @chorus-aidlc/chorus-dsh를 확인한 뒤 추가 명령을 다시 실행합니다.
체크인이 승인되지 않음: CHORUS_URL과 cho_ 에이전트 키가 $DSH_HOME/.env에 저장되었는지 확인한 뒤(chorus agents add --agents dsh --dsh-profile <name>를 다시 실행하면 새로 고칩니다) 프로필을 다시 시작합니다.
프로필 업데이트 후 체크인 실패: dsh 프로필을 재시작하여 유효한 composition을 다시 로드합니다.