프로젝트 소개

## 프로젝트 개요 DeepSeek Harness 데스크톱 버전은 업스트림 DeepSeek Harness(`dsh` agent 플랫폼)의 데스크톱 셸로, Electron이 아닌 Tauri 2 기반이며 더 작은 설치 패키지, 더 낮은 메모리 사용량, 네이티브 창을 지향합니다. 사용자는 설치 패키지를 다운로드해 바로 실행할 수 있으며 Node.js, pnpm, Docker 환경을 직접 준비할 필요가 없습니다. ## 주요 기능 - **플러그인 관리**: 플러그인 패널에서 설치된 플러그인을 확인할 수 있고, 이상 발생 시 업그레이드, 제거 진입점과 오류 상세를 제공합니다. - **내장 플러그인**: 설치 패키지에 퍼스트파티 플러그인이 포함되며, 향후 더 많은 내장 플러그인을 도입할 계획입니다. - **네이티브 경량**: Tauri 2 셸로 설치 패키지 크기가 작고 메모리 사용량이 낮습니다. - **명령줄 통합**: 설치 시 `dsh` 명령을 자동 등록해 새 터미널에서 바로 사용할 수 있으며, 기존 shell 설정을 덮어쓰지 않습니다. - **시작 안내**: 첫 실행 시 추천 플러그인을 선택할 수 있고, 이후에도 설정에서 다시 선택할 수 있습니다. - **자동 업데이트**: 앱 내 업데이트를 지원해 설치 패키지를 다시 다운로드할 필요가 없습니다. - **데스크톱 펫**: Pets / Codex 두 소스의 데스크톱 펫 관리를 제공하며, 프리셋 펫은 바로 사용 가능(원격 소재 직결)하고 Codex `.zip` 리소스 패키지를 가져올 수 있으며 세션 활동에 따라 상태 말풍선을 표시합니다. ## 프리셋 플러그인 첫 실행 안내에서 필요에 따라 체크해 설치하며, 다음을 포함합니다: DSH Market(커뮤니티 플러그인 탐색, 검색 및 원클릭 설치), DSH Better Sidebar(VSCode류 오른쪽 사이드바, 세션별 격리), DSH Rewind(동일 창 내 대화 되돌리기, 경량 워크스페이스 백업 내장), DSH-IM(WeChat, Feishu, DingTalk, WeCom, QQ, Slack, Telegram, Discord, WhatsApp, iMessage 등 채널 연동 및 왼쪽 사이드바 통합 관리). 프리셋 목록은 데스크톱 측에서 관리하며, 추가나 갱신은 저장소 issues에서 요청해야 합니다. ## 내장 플러그인 설치 패키지 리소스에 내장된 퍼스트파티 플러그인은 다음을 포함합니다: Tauri 2 셸과의 통신 채널(DSH Tauri), 사용자 정의 설정 사이드바(DSH Tauri UI), 세션별 격리 Git Worktree(DSH Tauri Worktree), Skills/MCP 관리 및 스킬 저장소 가져오기(DSH Tauri Panel Extension), 예약 작업(DSH Tauri Panel Scheduler), Agent 턴별 프라이빗 Git 스냅샷 기록(DSH Running Changes), 워크스페이스 아카이브 및 아카이브된 채팅 관리(DSH Tauri Session), 데스크톱 펫 관리(DSH Tauri Pet), 우클릭 자주 쓰는 작업(DSH Tauri Rightclick), 모델 선택 및 파라미터 설정(DSH Tauri Model Config) 등. ## 빠른 시작 Releases에서 해당 플랫폼 설치 패키지를 다운로드해 설치 후 실행하면 됩니다. macOS는 Homebrew로도 설치할 수 있습니다. 첫 실행 시 Node 런타임과 Harness 커널을 다운로드하며(`dsh`가 이미 설치되어 있으면 설치 버전 사용), 이후 `http://127.0.0.1:3080`의 Harness 인터페이스로 진입하고 그 뒤로는 완전히 로컬에서 실행됩니다. 시스템 요구 사항은 Windows 10+, macOS 10.15+, Linux(AppImage / .deb)이며, 첫 실행에는 네트워크가 필요하고 Harness 커널은 0.1.5-rc.1 이상이어야 합니다. README는 또한 Linux Wayland에서 AppImage가 검은 화면이나 크래시를 일으킬 수 있는 경우에 대한 처리 방안(`.deb`로 전환하거나 관련 환경 변수 설정)을 제시하고, 롤링 릴리스 배포판에서 실행 즉시 크래시하는 원인과 수정 방법을 설명합니다. ## 작동 원리 프런트엔드는 Tauri WebView(React)로 설치 상태 머신, 다운로드 진행률, iframe으로 dsh Web 인터페이스 로드 및 사이드바 제어를 담당합니다. Rust 백엔드는 다운로드 설치, Harness 코어 다중 버전 관리, dsh 프로필 관리, 플러그인 제거·업그레이드, dsh 명령 shim과 PATH, 데스크톱 자동 업데이트, dsh 프로세스 수명 주기와 상태 확인 등의 서비스를 제공합니다. Harness 배포판은 deepseek-harness-pkg가 빌드·배포하며, 매번 시작 시 최신 배포판과 비교해 로컬이 오래된 경우 업데이트를 알리고, GitHub에 접근할 수 없으면 로컬 설치를 유지합니다. CLI로 전역 설치한 로컬 코어가 우선 사용됩니다. ## 주의 사항 프로젝트는 개발 프리뷰로 표시되어 있으며 업스트림 `dsh`는 여전히 빠르게 반복되고 파괴적 변경이 존재합니다. 보안 선언에 따르면 `dsh`는 로컬 코드 실행 능력을 갖추고 있어 학습, 연구, 테스트 용도로만 사용해야 하며 신뢰할 수 있고 격리된 환경에서 사용해야 합니다. 라이선스는 MIT에 비상업 조항이 추가되어 있습니다.