DeepSeek Harness: 웹 화면과 실행 환경을 갖춘 플러그인형 에이전트 플랫폼
AI가 프로젝트 파일을 읽고 수정하거나 명령을 실행하도록 웹 화면과 실행 환경을 제공하는 플러그인형 에이전트 플랫폼이에요.
주요 기능
- 웹 UI에서 모델 설정·작업 폴더 선택·대화 세션으로 파일 편집, 명령 실행, 계획·위임 작업을 수행한다.
- 모델 연결·도구·세션 기록·권한과 실행 루프까지 교체 가능한 Cordis 플러그인으로 구성한다.
- web·headless·sdk·sdk-minimal·acp 프로필과 별도 Electron 데스크톱 앱 구조를 제공한다.
- DeepSeek API 키 외에도 내장 타사 제공자와 OpenAI 호환/Responses/Anthropic 프로토콜의 사용자 지정 모델 연결을 안내한다.
구조
TypeScript/pnpm 모노레포이며 apps/cli의 공개 패키지 이름은 @deepseek-ai/dsh다. CLI 실제 bin.ts가 프로필 실행·플러그인 관리·설정 덤프를 분기한다. Cordis의 플러그인 트리를 프로필·번들·patch 계층으로 조합하고 세션 이벤트 로그를 모델 문맥과 복구의 근거로 삼는다. 웹 UI는 로컬 Host에 접속하며 데스크톱은 Electron에 정확히 맞는 런타임을 번들한다. 조사 커밋 버전은 0.2.2-alpha.2다.
누구에게 쓸모 있나요
AI 개발 에이전트를 로컬에서 구성·확장하거나 SDK·자동화·플러그인을 개발하려는 개발자. 보안 검증이 끝난 업무 시스템을 바로 원하는 일반 사용자에게는 신중한 평가가 필요하다.
설치 전 준비
현재 root와 CLI package.json은 Node.js >=24.9.0을 요구한다. 소스 개발은 pnpm@11.28.5가 지정되어 있고 빌드·네이티브 구성 요소 의존성은 플랫폼에 따라 추가 준비가 필요하다. 웹 사용은 로컬 브라우저·작업 폴더와 모델 제공자 자격 증명/사용 권한이 필요하다. 임의로 API 키를 발급하거나 저장하지 않았다.
- Node.js >=24.9.0 + 로컬 브라우저 기반 Web UI
- 소스에 Windows·macOS·Linux 관련 실행/네이티브·테스트 구성 존재; 실제 OS별 설치 성공은 미검증
- Electron 데스크톱 소스는 macOS arm64/x64와 Windows x64 패키징 스크립트 포함; 일반 CLI와 배포/업데이트 소유권을 구분
- headless·SDK·ACP는 프로필별 기능·기본값이 다름
설치 방법
- 문서상 npm 실행 예시: npx @deepseek-ai/dsh web — 패키지를 받아 로컬 웹 UI를 시작하는 명령이며 이번 조사에서 실행하지 않았다. 공식 README는 기본 주소를 127.0.0.1:3080으로 안내한다.
- 소스 개발자는 README 순서대로 저장소를 준비하고 pnpm 의존성 설치 → 빌드 → pnpm dsh web을 진행한다. 해당 절차의 성공을 본 환경에서 검증한 것은 아니다.
- 처음 실행 전 SAFETY.md를 읽고 별도 테스트 환경·최소 접근 권한·파일 백업을 준비한다. 실제 업무 폴더에 쓰기 권한을 주기 전에 승인 정책을 확인한다.
- 웹 UI Settings → Models에서 사용할 제공자의 자격 증명을 설정하고 저장한다. 문서상 DeepSeek 키는 DSH_HOME의 .credentials.yaml에 저장되고 화면에는 가려진 설명만 반환된다.
사용 방법
- Choose workspace에서 작업 폴더를 추가·선택한다. 새 UI는 폴더가 선택되기 전 입력을 사용할 수 없다고 안내한다.
- 새 세션에서 저장소 요약처럼 읽기 위주의 작업부터 시작하고, 파일 수정·명령 실행을 요청할 때는 범위·승인 대상을 확인한다.
- 설정에서 모델을 선택하거나 타사 제공자를 추가한다. 직접 만드는 게이트웨이는 서버가 실제 지원하는 API 프로토콜과 모델 ID를 맞춰야 한다.
- 원격 공개는 별도 운영 작업이다. 공식 reverse proxy 문서의 TLS, Host 허용, WebSocket, 경로·쿠키 설정을 검토해야 하며 출력된 시작 URL의 토큰은 자격 증명이므로 공개 게시하지 않는다.
비용과 API 키
코드는 MIT 오픈소스지만 모델 제공자의 API 키 또는 지원 인증이 필요하며 실제 모델 호출·검색 등 연결 서비스 요금이 별도다. 저장소를 쓴다고 API가 무료가 되지 않는다. 현재 공급자별 가격·계정 제공 범위는 조사하지 않았고 금액을 제시하지 않는다.
라이선스
LICENSE와 CLI/root package.json에서 MIT를 확인했다. 번들·플러그인·외부 모델 서비스에는 각각의 라이선스·약관이 적용될 수 있으며 MIT는 보안이나 데이터 보호를 보증하지 않는다.
주의사항과 알려진 이슈
- 공식 SAFETY.md는 개발자 프리뷰·미감사·운영 보안 보장 없음과 호환성 파괴 가능성을 명시한다. 0.2.2-alpha.2와 0.2.1-rc.4는 prerelease로 표시되어 있다.
- 모델이 만든 코드·명령, 외부 플러그인이 파일 삭제·수정·프로세스·네트워크·자격 증명에 접근할 수 있다. 샌드박스와 승인도 허용된 자원 안의 피해를 막는 완전한 보장이 아니다.
- 웹 UI 시작 URL에 프로세스 접근 토큰이 들어갈 수 있다. 공개 URL 설정만으로 인증·방화벽이 갖춰지는 것은 아니며 TLS와 네트워크 제한을 따로 구성해야 한다.
- 키 저장 파일과 모델에 전달할 작업 파일을 보호해야 한다. 타사 모델·플러그인 신뢰성과 과금 한도를 별도로 확인한다.
- 데스크톱과 npm CLI는 제품 데이터를 공유하지만 패키지·활성화·잠금 파일이 분리된다. CLI 최신 버전과 데스크톱 번들 또는 서드파티 플러그인 호환성을 같다고 가정하면 안 된다.
공식 저장소는 GitHub Issues 비활성화
저장소 메타데이터 has_issues=false와 issues API의 빈 목록을 확인했다. 결함이 없다는 뜻이 아니며 공식 피드백 창구는 Discussions로 안내한다. 토론 전체는 검토하지 않았다.
v0.2.2-alpha.2 릴리스의 호환성·수정 내역
Node 최소 버전 상향과 플러그인·SDK 변경, 승인 정책 보존 등의 수정이 기재되어 있다. 릴리스 노트는 작성자 보고이며 본 분석에서 수정 동작을 재현하지 않았다.
확인 범위
확인 날짜: 2026-10-29
확인한 범위: 공식 GitHub의 지정 커밋 README·매니페스트·주요 구현/안전 문서·라이선스와 릴리스/열린 이슈를 읽은 정적 분석. 설치·실행·로그인·API 호출은 하지 않음.
확인 한계: 아래 설치·사용 절차는 공식 문서에 기재된 방법을 재정리한 것이며 직접 실행 검증 결과가 아님. 모든 OS·모델·브라우저 조합, 전체 의존성 보안, 모든 이슈를 검증하지 않음. 전체 재귀 트리 요청은 전송 오류여서 루트 README와 명시된 개별 파일을 직접 조회했다. Discussions·전체 네이티브 구현·실제 모델 호출은 미확인.
확인 커밋: f3803c96974ad4a94195fb97e5c637e9c2a3afe3