DSH Desktop: DeepSeek Harness를 설치형 앱으로 쓰는 데스크톱 화면
DeepSeek Harness를 설치형 창·작업 프로필·플러그인 관리 화면으로 사용할 수 있게 만든 커뮤니티 데스크톱 앱이에요.
주요 기능
- 로컬 Harness Host와 Web UI를 Electron 창·트레이·터미널·업데이트 기능으로 묶습니다.
- 프로필별 플러그인 구성·전환, 플러그인 탐색·설치 관리, 시작 실패 복구와 진단 내보내기를 제공해요.
- 초기 설정 마법사, 창 모드, 알림, 선택적 브라우저·모바일 원격 기능을 제공해요. 채널별 범위는 달라요.
구조
독립 커뮤니티 Anywhere Labs의 프로젝트로 DeepSeek 공식 제품이나 승인된 배포판은 아니에요. 공식 deepseek-harness를 고정 버전으로 사용하고 데스크톱 기능 자체도 Cordis 플러그인으로 합성해요. 루트는 Yarn workspace이고 stable·beta·next 패키지가 나뉩니다. upstream.json에서 stable 0.2.1-rc.3, beta 0.2.2-alpha.2, next 0.2.1-rc.4를 확인했어요. 저장소 최신 소스와 이미 배포된 채널 패키지는 구분해야 해요.
누구에게 쓸모 있나요
Harness의 CLI·런타임 설치를 직접 관리하기보다 창 형태로 사용하고 싶은 사용자, 프로필·플러그인 구성을 실험하는 개발자에게 적합해요.
설치 전 준비
- 일반 stable 설치는 Windows x64 또는 macOS Universal 대상으로 Node·pnpm·고정 Harness 런타임을 포함하므로 별도 Node 설치가 필요 없다는 공식 안내예요.
- AI 기능은 선택한 모델 서비스의 인증과 연결이 필요해요. 로컬 실행이라고 클라우드 모델 호출까지 오프라인이 되는 것은 아니에요.
- 소스 개발은 Node ^22.19.0 또는 >=24.0.0, Yarn 4.18.0과 초기화된 deepseek-harness 하위 모듈이 필요해요.
- Windows 폴더 연결 문서에는 exFAT·FAT32·네트워크 드라이브 등 지원하지 않는 저장소 경로가 명시되어 있어요. 사용할 작업 드라이브를 확인해요.
- stable 사용자 문서: Windows x64, macOS Universal(Intel·Apple Silicon)
- 조회된 v2.0.20-next 릴리스: Linux x64·ARM64 패키지도 안내; stable FAQ의 Linux 미출시 문구와 채널·시점 차이 있음
- 소스에 Linux 빌드 코드가 있다는 사실만으로 모든 stable 채널·환경 지원을 보장하지 않음
- iOS·Android 원격 연결은 별도 서비스·연결 방식에 의존
설치 방법
- 일반 사용자는 공식 Releases에서 stable과 Beta·Next를 구분하고 해당 OS·CPU 패키지를 고릅니다. Windows는 NSIS 설치 흐름, macOS는 DMG의 앱을 Applications로 옮기는 흐름이에요. 이번 분석은 다운로드·설치를 수행하지 않았어요.
- 첫 실행에서 프로필별 Setup Wizard의 창 모드·플러그인 소스·알림·브라우저 접근 범위를 검토한 뒤 작업 폴더와 모델 설정을 준비해요.
- 소스 개발 문서 순서는 git submodule update –init –recursive → corepack yarn install –immutable → corepack yarn dev 예요. 실제 실행하지 않았으며, 최신 upstream.json의 채널과 패키지 선택도 확인해야 해요.
- 플러그인은 기본 신뢰 대상으로 간주하지 말고 출처·버전·권한을 검토해요. 공식 user-guide의 active profile 터미널 절차에 따라 추가한 뒤 앱을 재시작해요.
사용 방법
- 앱에서 작업 폴더·프로필을 선택하고 모델/도구를 구성한 다음 작업을 요청해요. 프로필 전환은 정상 재시작을 수행하며 플러그인을 자동 복사하는 기능은 아니에요.
- 트레이의 Open DSH Terminal은 전용 dsh·pnpm·node 경로를 해당 프로세스에만 준비해요. 전역 시스템 PATH 설치로 착각하지 마세요.
- 문서의 최소 예시 dsh plugin add <plugin> 은 활성 프로필을 대상으로 해요. 다른 프로필을 지정하려면 문서의 –profile 옵션을 확인하고 변경 후 재시작해요.
- 창 닫기는 트레이로 숨기는 동작일 수 있으므로 실행을 끝내려면 Quit을 사용해요. 시작 문제는 복구 화면·진단을 먼저 확인하고 설정·세션을 백업한 뒤 수정해요.
비용과 API 키
앱 소스는 MIT로 공개되지만 선택한 모델·MCP·외부 도구·원격 서비스의 키, 계정, 사용 요금은 별도예요. API-key 및 계정 모델 어댑터 의존성이 존재해요. 모든 사용자에게 무조건 무료 모델 사용이 제공된다는 근거는 없어요. 각 인증 방식과 현행 단가는 이번 분석에서 발급·결제·호출 없이 미확인으로 남깁니다.
라이선스
MIT. LICENSE의 저작권자는 2026 Anywhere Labs예요. DeepSeek Harness와 플러그인·패키지는 각자 라이선스·약관을 확인해야 해요. 코드 안 제품 식별자나 기존 명칭이 있다고 DeepSeek의 공식성·보증을 의미하지 않습니다.
주의사항과 알려진 이슈
- 설정·대화·로그는 기본 로컬 저장이지만 모델·도구·플러그인 요청은 외부로 보낼 수 있어요. 개인정보 문서는 자격 증명 YAML이 암호화 저장이 아니라고 명시하므로 같은 사용자 권한의 프로그램과 플러그인 접근을 주의해야 해요.
- 공식 업데이트 확인은 설치 UUID와 버전 등의 네트워크 메타데이터를 전송해요. 진단 ZIP·crash dump에는 경로·세션 식별자·메모리 일부가 남을 수 있으니 공개 이슈에 첨부하기 전에 검토해요.
- LAN 공개는 사용자 문서에서 인증 없는 컴퓨터 조작 위험으로 경고해요. 다만 최신 stable webserver 소스는 loopback을 강제하고 향후 LAN HTTPS를 전제로 하므로 README·채널·최신 소스 간 차이가 있어요. 실제 설치 버전의 보안 설명을 확인하고 LAN 공개를 기본 안내로 사용하지 않습니다.
- 플러그인 및 의존성은 사용자 권한으로 실행될 수 있어요. 마켓 등록·설치 가능 판정은 보안 심사를 뜻하지 않습니다. WebDAV/Gist 백업에 설정·키가 들어갈 수 있다는 개인정보 문서도 확인해야 해요.
- 일반 세션 통계의 upstream 설정에 따라 피드백 제출 시 원시 세션 기록이 전송될 수 있고 FULL 모드는 지속 전송이에요. Desktop 자체 업데이트 통계와 모델·upstream 원격 측정을 구분해요.
- BOM 프로필 오류·Windows 샌드박스 실행 실패 등의 열린 보고가 있어요. 모든 사용자에게 재현되는 장애로 단정하지 않았으며, 샌드박스 전체 해제나 프로필 삭제를 일반 해결책으로 안내하지 않습니다.
#1541: Windows 프로필 JSON의 UTF-8 BOM으로 시작 실패 보고
2.0.20-next·Windows 11·PowerShell 5.1 사례. 기존 storage BOM 수정과 별도 profile manifest 경로를 지적해요. 백업 후 버전에 맞는 공식 해결 상태를 확인할 항목이에요.
#1538: Windows 10 샌드박스 내 PowerShell 0xC0000142 실패 보고
2.0.20-next·Windows 10 19041·특정 관리자/콘솔 조건의 보고예요. 일반적인 정상 실행을 직접 시험하지 않았어요.
확인 범위
확인 날짜: 2026-10-29
확인 커밋: 872a0041d14fb33c5ee68989ebb8082e3c7d4d30
확인한 범위: README.en·user-guide·FAQ·PRIVACY·루트와 desktop package.json·upstream.json·Cordis 합성 패치·webserver.ts·LICENSE·Next/Beta 릴리스·열린 이슈를 읽었습니다.
확인 한계: 정적 확인만 했어요. 설치·실행·모델 인증·원격 연결·플러그인 설치·샌드박스 재현을 하지 않았어요. 문서와 채널별 배포 차이는 명시했고 모든 OS의 출시 상태를 하나로 일반화하지 않았어요.