데스크톱에서 DeepSeek Harness를 실행하세요 —
Node.js, pnpm, Docker를 수동으로 설정할 필요가 없습니다. 일반 설치 시 첫 실행에서 네트워크를 통한 초기화가 필요할 수 있습니다.
Download · English · Español · Русский · 한국어 · Docs · 中文
- 🪶 네이티브 데스크톱 — Tauri 2 + React 19 + HeroUI 3 기반으로 로컬 Harness UI를 내장합니다.
- 📱 원격 연결 — Android / iOS 앱에서 QR 코드를 스캔하여 LAN 또는 Cloudflare 공개 터널을 통해 컴퓨터의 DSH에 연결합니다.
- 🔄 런타임 관리 — 의존성을 설치하고 코어 버전을 선택하며, 데스크톱과 코어 업데이트 기능을 이용할 수 있습니다.
- 🧩 플러그인 관리 — 12개의 내장 플러그인을 제공하며, 로컬 디렉터리에서 설치, 내장 플러그인 비활성화, 커뮤니티 플러그인 설치, 업그레이드, 제거, 오류 상세 정보 확인을 지원합니다.
- 🗂️ 프로필 구성 — 프로필별로 플러그인과 설정을 분리하고, 클릭 한 번으로 프로필 데이터를 이전, 백업, 복제할 수 있습니다.
- 💽 데이터 디렉터리 — 설치 시 데이터 저장 위치를 선택하고(Windows), 나중에 Windows, macOS, Linux의 설정에서 이전하거나 되돌릴 수 있습니다.
- ⌨️ CLI 통합 — npm을 통한 전역 코어 설치가 아니라, 관리형 shim을 통해
dsh/pnpm명령어를 제공합니다. - 🐾 데스크톱 펫 — Pets / Codex 리소스, 팩 가져오기, 대화 활동 표시를 지원합니다. 사전 설정된 미디어는 원격 호스트에서 가져옵니다.
- 🎨 개인화 — 8가지 색상 팔레트, 로컬 UI 배율 조정, 터미널 모드, 불투명도 조절, 선택적 반투명 블러 효과를 제공합니다.
데스크톱 리소스와 함께 배포되는 자체 개발 플러그인입니다:
- DSH Tauri — 핵심 플러그인: 데스크톱과 Harness 간 통신, 버전 어댑터, 플러그인 의존성 관리
- DSH Tauri UI — 데스크톱 설정 UI, 네이티브 코어 구성 요소, 테마, 색상 팔레트
- DSH Tauri Mobile UI — 터치 레이아웃과 모바일 환경 설정
- DSH Tauri Worktree — 세션 단위 Git 워크트리와 체크아웃
- DSH Tauri Extension — 공식 플러그인 관리자, 플러그인 마켓, Skills, MCP
- DSH Tauri Scheduler — 예약 작업과 실행 기록
- DSH Tauri Archive — 대화 보관과 복원
- DSH Tauri Pet — 데스크톱 펫과 활동 상태 설정
- DSH Tauri Rightclick Menu — 세션, 작업 공간, 텍스트의 컨텍스트 메뉴
- DSH Tauri Model — 모델 선택, 매개변수, 자동 구성
- DSH Tauri Remote — SSH를 통한 원격 Harness 연결 및 동기화, LAN 또는 공개 터널을 통한 로컬 Harness 공유
- DSH Tauri Notification — 대화 알림과 관련 동작
초기 설정 과정에서 다음 커뮤니티 플러그인을 필요에 따라 설치할 수 있습니다.
- DSH Better Sidebar — 세션별 편집기 사이드바
- Billion Context — 컨텍스트 압축과 기록 복원
- DSH Office Kit — Office 문서, PDF, 프레젠테이션, 스프레드시트
- DSH Market — 커뮤니티 플러그인 마켓
- DSH Rewind — 대화 되감기와 작업 공간 백업
- DSH IM — IM 채널과 봇 관리
- DSH OPS — 토큰 사용량과 작업 실행 시간을 줄이는 저수준 작업 도구
프리셋 추가나 업데이트는 Issues를 통해 요청하세요. 사용 가능한 버전은 매니페스트의 코어 호환성 규칙을 따릅니다.
Releases에서 사용 중인 플랫폼과 아키텍처에 맞는 설치 프로그램을 다운로드하세요:
| 플랫폼 | 요구 사항 | 설치 프로그램 |
|---|---|---|
| Windows | Windows 10+, WebView2 | x64 .exe / .msi |
| macOS | macOS 12+; 웹 UI는 Safari 17.4+ 수준의 기능 필요 | Intel / Apple Silicon .dmg |
| Linux | WebKit2GTK 4.1 런타임 라이브러리 | x64 .AppImage / .deb |
macOS에서는 Homebrew로도 설치할 수 있습니다:
brew install dsh-tauri/desktop/deepseek-harnessFedora 43+(x64 / ARM64)에서는 Copr 저장소로 설치할 수 있습니다. 업데이트는 dnf upgrade로 받으며 앱 내 업데이트는 비활성화됩니다. 프리릴리스를 쓰려면 dsh-tauri-beta를 설치하세요(dsh-tauri와 동시에 설치할 수 없으며 sudo dnf swap dsh-tauri dsh-tauri-beta로 전환합니다):
sudo dnf copr enable fairyband/dsh-tauri
sudo dnf install dsh-tauri # 정식 버전- 일반 설치 프로그램은 첫 실행 시 누락된 런타임 및 코어 구성 요소를 다운로드하기 위해 네트워크가 필요합니다. Git 기능을 사용하려면 Git을 실행할 수 있어야 합니다.
- 이름에
Bundle접미사가 있는 파일은 오프라인 설치 프로그램입니다(_Bundle_*.exe,_Bundle_*.deb, 두 종류의_Bundle_*.dmg). - 로컬 실행이 완전한 오프라인 실행을 의미하지는 않습니다. 모델 서비스, 플러그인 설치, 업데이트, 사전 설정된 펫 미디어는 여전히 네트워크를 사용할 수 있습니다.
- Linux 화면 표시, Wayland, AppImage, 권한 문제의 해결 방법은 설치 및 문제 해결 문서를 참고하세요.
- 구성 → 애플리케이션 → 프록시 URL에서 HTTP, HTTPS, SOCKS5 또는 SOCKS5H 프록시를 설정하세요.
- 데스크톱 런타임 및 코어 다운로드, 업데이트 확인, 플러그인 메타데이터에만 적용됩니다. 모델 요청이나 플러그인 하위 프로세스의 네트워크 통신에는 적용되지 않습니다.
- 비워 두면 시스템 및 환경 설정을 따릅니다. 저장한 변경 사항은 새 요청부터 적용되므로, 이후 실패한 다운로드를 다시 시도하세요.
- SOCKS5H는 프록시를 통해 대상 이름을 해석하며, 루프백 연결은 계속 직접 연결됩니다.
DSH Mobile은 LAN 또는 공개 터널을 통해 컴퓨터의 Harness에 접속하며, 휴대폰에서 코어를 실행하지 않습니다.
- Android: Releases에서 APK를 다운로드하세요.
- iOS: TestFlight 초대를 통해 베타 버전을 설치하세요. 승인 여부와 잔여 인원에 따라 이용이 제한될 수 있습니다. Releases의 서명되지 않은 IPA는 직접 서명해야 합니다.
데스크톱 상단 표시줄의 공유에서 공유를 활성화한 뒤 QR 코드를 스캔하여 페어링하세요. 컴퓨터, Harness, 사용 중인 터널을 모두 온라인 상태로 유지해야 합니다. 원격 접속은 읽기 전용이 아니므로 QR 코드와 접근 코드를 비공개로 유지하세요. 모바일 원격 접속 가이드를 참고하세요.
이 앱은 공식 모바일 서비스가 출시될 때까지만 유지보수됩니다. 개발 관련 세부 사항은 모바일 명세를 참고하세요.
Windows에서 시작에 실패하면 네이티브 대화 상자에 원인 오류가 표시됩니다. STARTUP_LOW_INTEGRITY가 발생한 경우:
- 프로세스가 Medium보다 낮은 무결성 수준으로 실행되어 일반 사용자 데이터를 쓸 수 없는 상태입니다. 업데이트 시 폴더의 Low 레이블을 상속할 수 있습니다.
icacls로 폴더와 실행 파일을 확인하세요. 신뢰할 수 있는 설치의 무결성 수준을 Medium으로 복원하거나, 일반 폴더에 다시 설치하세요.- 관리자 권한으로 실행해도 Low 레이블 제한은 해제되지 않습니다. 세션과
DSH_HOME은 변경하지 마세요.
| 현재 기준 | 버전 |
|---|---|
| 권장 Harness 코어 | 0.2.1-rc.2 |
| 지원하는 최소 코어 | 0.1.7-rc.1; 모든 플러그인의 호환성을 보장하지는 않음 |
이전 코어는 더 이상 지원하지 않습니다. 과거의 호환성 기록은 이력을 나타낼 뿐, 현재 지원 범위를 의미하지 않습니다.
- 코어와 프리셋 선택은 리소스 매니페스트와 플러그인에 선언된 버전 범위를 따릅니다. 임의의 최신 업스트림 릴리스와의 호환성을 보장하는 것은 아닙니다.
- 정식 릴리스에서는 CLI 통합이 기본으로 활성화됩니다. Windows / macOS / Linux에서 PATH가 자동으로 업데이트됩니다. 터미널을 다시 여세요. 다른 셸은 여전히 수동 설정이 필요할 수 있습니다.
![]() QQ 그룹 |
![]() WeChat 그룹 (정원 마감, 먼저 WeChat에서 저를 추가하세요) → |
![]() |
영문 개발 가이드 또는 중문 개발 가이드를 참고하세요. 기능별 세부 사항은 온라인 문서에서 확인할 수 있습니다.
Warning
개발자 프리뷰 — 업스트림 dsh는 빠르게 발전하고 있어 호환성을 깨는 변경이 도입될 수 있습니다. 업그레이드 전에 호환성을 확인하세요.
Note
보안 — dsh는 로컬에서 코드를 실행할 수 있습니다. 학습 / 연구 / 테스트 용도로만 사용하고, 신뢰할 수 있는 격리된 환경에서 실행하세요.
- dsh-tauri-notify-webhook - 작업이 비정상적으로 중단되거나 완료되면 webhook, 이메일(SMTP), pushplus로 알림 전달 · 제작: @iuuuuuuuu
- dsh-pdf-reader - 페이지별 PDF 읽기, 로컬 OCR, 인용, 검색, 시각적 자르기 · 제작: @SkanderBog
- dsh-context-manager - 적용 전 컨텍스트를 검토하고, 전체 기록 그룹별로 이전 내용을 유지, 요약 또는 생략할지 선택 · 제작: @SkanderBog
- @ryuu-64/dsh-find-all - 현재 대화에서 Ctrl+F로 저장된 기록 검색 · 제작: @Ryuu-64
- deepseek-harness — 업스트림
dsh에이전트 플랫폼 - deepseek-harness-pkg — 사전 빌드된 Harness 배포판과 다운로드 소스
- dsh-pet · dsh-pet-mov · dsh-pet-component — 펫 리소스와 렌더러
- dsh-plugin-codex-pets · BongoCat · dsh-dafeiyu · codex-to-dsh-pet — 펫 참고 프로젝트
MIT에 비상업적 이용 조건이 추가로 적용됩니다. © deepseek-harness-desktop contributors



