DeepSeek Harness Desktop

더블 클릭으로 실행되는 데스크톱 UI

터미널, Node.js 설치, dsh web 명령 없이 아이콘을 더블 클릭하면 DeepSeek Harness의 웹 인터페이스가 전용 창에서 열립니다. 엔진은 창이 살아 있는 동안에만 동작하므로 백그라운드 서비스로 남지 않습니다.

업스트림 harness와 동일한 인터페이스

데스크톱 셸은 자체 UI를 다시 구현하지 않으며, 내장 엔진이 제공하는 공식 웹 UI를 그대로 표시합니다. npm의 @deepseek-ai/dsh 패키지가 업데이트되면 GitHub Actions가 이를 감지하여 자동으로 새 설치 패키지를 빌드합니다.

CLI와 데이터 공유

기본 데이터 디렉터리는 표준 ~/.dsh 경로를 사용하므로 CLI에서 만든 세션, 설정, 플러그인을 데스크톱에서도 그대로 확인하고 편집할 수 있습니다. 격리가 필요한 경우 DSH_HOME 환경 변수로 경로를 변경할 수 있습니다.

엔진의 회环 주소 종속

엔진은 127.0.0.1에만 바인딩되며, 렌더러 프로세스는 contextIsolation과 sandbox가 활성화된 상태로 동작합니다. 외부 링크는 시스템 브라우저로 전달되고, 창 자체는 회环 소스를 벗어나지 않습니다.

다중 플랫폼 배포

동일한 코드 베이스로 Windows용 NSIS 설치 패키지, macOS용 DMG(Apple Silicon 및 Intel), Linux용 AppImage와 deb 패키지를 빌드합니다.

설치

• Windows 10/11 (x64): 공식 Releases에서 *-Setup.exe (NSIS 설치 프로그램)를 내려받아 설치합니다. 코드가 서명되어 있지 않으므로 SmartScreen이 표시될 수 있으며, 이 경우 추가 정보 → 계속 실행을 선택해 진행합니다.
• macOS (Apple Silicon): *-arm64.dmg
• macOS (Intel): *-x64.dmg (둘 다 최초 실행 시 응용 프로그램을 마우스 오른쪽 버튼으로 클릭한 뒤 열기를 선택합니다.)
• Linux (x64): *-x86_64.AppImage를 chmod +x로 실행 권한을 부여한 뒤 실행하거나, *.deb 패키지를 설치합니다.
• winget 사용 환경: winget install --id hongfeiyucode.DeepSeekHarnessDesktop --exact

기본 사용

설치 후 DeepSeek Harness Desktop을 일반 응용 프로그램처럼 실행합니다. 최초 실행 시 엔진이 ~/.dsh 아래에 구성 파일을 초기화하므로 몇 초 정도의 대기 시간이 발생할 수 있습니다. 이후 창에서 DeepSeek Harness의 웹 인터페이스를 그대로 사용할 수 있습니다.

환경 변수

• DSH_HOME: 기본값은 ~/.dsh이며 CLI와 동일한 데이터 디렉터리를 가리킵니다. 변경 시 내장 엔진에 그대로 전달됩니다.
• DSH_DESKTOP_PORT: 기본값은 32123,32124,32125이며, 내장 엔진이 사용할 회环 후보 포트를 쉼표로 지정합니다.

활용 예시

• 개발 환경이 없는 PC에서도 DeepSeek Harness의 웹 UI를 단일 응용 프로그램 형태로 즉시 실행하는 용도로 사용할 수 있습니다.
• CLI로 만든 세션과 설정을 그대로 이어 받아 데스크톱 창에서 작업하거나, 반대로 데스크톱에서 작성한 세션을 CLI에서 이어 보는 용도로 활용할 수 있습니다.
• 업스트림 harness가 업데이트될 때마다 새 빌드가 GitHub Release로 제공되므로, 항상 최신 엔진으로 작업할 수 있습니다.

버전·업데이트

GitHub Actions의 일일 스케줄 작업이 npm의 @deepseek-ai/dsh 버전을 확인하여 새 버전이 있을 때만 빌드를 트리거합니다. 데스크톱 버전 번호는 내장 엔진 버전을 반영하며, 예컨대 업스트림 0.1.0-rc.6은 데스크톱 0.1.0-rc.6.0으로 매핑되고, 데스크톱 자체 재빌드만 수행될 때는 마지막 세그먼트만 증가합니다. 현재 버전 0.1.1-rc.2.0에는 @deepseek-ai/dsh v0.1.1-rc.2 엔진이 내장되어 있습니다.

제한·라이선스·확인사항

• 설치 패키지는 코드 서명되어 있지 않아 Windows SmartScreen과 macOS Gatekeeper의 안내가 표시될 수 있습니다.
• 현재 데스크톱 자체에서 자동 업데이트는 제공되지 않으며, 새 버전은 GitHub Release로 배포됩니다.
• 한 인스턴스에 한 창만 열리며, 두 번째 실행 시에는 새 창이 열리는 대신 기존 창에 포커스가 맞춰집니다.
• 내장 엔진은 업스트림 harness의 자체 요구 사항을 그대로 따르므로, 셸 계열 도구 등을 사용할 때 호스트에 PowerShell 또는 bash가 있어야 합니다.
• 이 프로젝트는 MIT 라이선스로 배포되며, 업스트림 deepseek-ai/deepseek-harness 프로젝트 역시 MIT이고 npm의 @deepseek-ai/dsh 패키지가 그대로 내장되어 있습니다.