deepseek-harness-desktop

DeepSeek Harness Desktop은 커뮤니티가 유지보수하는 데스크탑 배포판으로, 공식 오픈소스인 DeepSeek Harness Web 환경(에이전트 런타임, Web UI 및 플러그인 시스템)을 macOS, Linux, Windows용 독립형 데스크탑 애플리케이션으로 패키징한 것입니다. 프로젝트는 명시적으로 DeepSeek 공식 제품이 아니며 DeepSeek AI의 인증이나 소속 관계가 없다고 밝히고 있습니다. 데스크탑 전용 코드는 저장소의 apps/desktop에 있으며, 전체적으로 MIT 라이선스로 배포됩니다. 프로젝트가 강조하는 포지셔닝은 런타임 환경 제로 설정, 즉석 사용 가능, 개발 장벽 제로입니다. 설치 패키지에는 Electron, Node.js, 프로덕션 플러그인 그림 및 웹 리소스가 이미 포함되어 있으므로, 사용자는 Node.js, pnpm 또는 Electron을 사전에 설치할 필요가 없으며, 터미널 명령어를 실행할 필요도 없고 브라우저를 직접 시작할 필요도 없습니다. 데스크탑 런처가 로컬 Harness 서비스를 자동으로 시작하고 종료하며, 완전한 Harness 인터페이스가 데스크탑 창에 그대로 표시됩니다. 모델을 호출해야 할 경우, 앱 내에서 서비스 제공업체가 요구하는 자격 증명을 입력하면 됩니다. 다운로드와 설치를 위해선 공식 웹사이트 다운로드 페이지나 GitHub Releases에서 설치 패키지를 얻을 수 있으며, 지원되는 플랫폼과 형식은 다음과 같습니다: macOS Apple Silicon(DMG 또는 ZIP), macOS Intel(DMG 또는 ZIP), Windows x64(NSIS 설치 프로그램 또는 ZIP), Linux x64(AppImage 또는 DEB). 출시 파이프라인은 Apple Developer 자격 증명이 있는 경우 macOS 애플리케이션에 대한 자동 서명, 공증 및 검증을 수행합니다. 인증서가 없을 경우 서명되지 않은 설치 패키지가 여전히 출시되며, Release 설명서에 상태가 명시됩니다. Windows SmartScreen에서도 알 수 없는发布者 경고가 표시될 수 있습니다. README는 macOS의 서명되지 않은 버전에 대해 첫 번째 실행 단계를 제공합니다: 앱을 "앱" 폴더로 이동한 후, 처음에는 직접 더블클릭하지 말고 Control 키를 누른 채 애플리케이션을 클릭하여 "열기"를 선택하고, 확인 창에서 다시 확인합니다. 만약 시스템이 검증할 수 없는 개발자라는 이유로 시작을 막을 경우, "시스템 환경설정 → 보안과 개인 정보 보호"에서 막힌 애플리케이션을 찾아서 "여전히 열기"를 선택할 수 있습니다. README는 이러한 조치가 일반적으로 한 번만 필요하다고 지적하고, Gatekeeper를 전역으로 비활성화하지 않는 것을 권장합니다. 원격 접근은 이 프로젝트의 기능 중 하나입니다. 첫 번째 시작이나 아직 계정을 인증하지 않은 상태라면, 클라이언트는 로그인 또는 회원가입을 제안하며, 로그인한 후 휴대폰이나 다른 기기에서 이 컴퓨터를 원격으로 사용할 수 있음을 알립니다. 사용자는 로그인을 건너뛰고 로컬에서 계속 사용할 수도 있습니다. 인증 완료 후 "원격 제어" 기능을 켤 수 있으며, 이 기능은 기본값이 꺼져 있고 "설정 → 일반 설정 → 원격 제어"에서 관리할 수 있습니다. 로그인하지 않은 사용자가 켜려고 할 때는 다시 로그인 표시가 나타나며, 로그인이 완료되기 전까지 활성화할 수 없습니다. 공식 웹사이트의 "장치 센터"에 로그인한 후, 현재 계정 아래의 온라인 컴퓨터를 선택하고 "연결"을 클릭하면, 새로운 브라우저 탭에서 대화를 계속하고 작업을 확인하며 컴퓨터의 워크스페이스를 사용할 수 있습니다. 버전 업데이트와 관련해 데스크탑 클라이언트는 시작 시 즉시 공식 웹사이트 버전 센터에서 새 버전을 체크한 뒤, 이후 매 10분마다 체크합니다. 새 버전을 발견하면 왼쪽 하단에 업데이트 표시가 나타납니다. 클릭하면 클라이언트가 공식 웹사이트에서 설치 패키지를 다운로드하고, 오른쪽 하단에 실시간으로 다운로드 및 검증 진행 상황이 표시되며 언제든 취소할 수 있습니다. 설치 패키지는 파일 크기와 SHA-256 무결성 검증을 통과한 뒤에야 시스템에서 열어 처리합니다. 현재 프로젝트는 데스크탑 베타 단계에 있으며, macOS Apple Silicon, macOS Intel, Linux x64 및 Windows x64 설치 패키지를 제공하고 있습니다. 데스크탑 런타임 환경, 계정 인증, 원격 접근, 모바일 적응 및 공식 웹사이트 버전 업데이트 기능을 포함합니다. README는 DeepSeek Harness 자체가 여전히 빠르게 개발 중이며, 안정적인 데스크탑 버전 출시 전에 설정, 플러그인 및 영속적 데이터가 변경될 수 있음을 알립니다. 애플리케이션 데이터는 Electron 표준 사용자별 애플리케이션 데이터 디렉토리의 runtime 서브디렉터리에 위치하며, 애플리케이션을 제거해도 이러한 데이터가 자동으로 삭제되지 않습니다. 만약 저장된 세션이 중요하다면, 서로 다른 베타 버전 간 마이그레이션 전에 백업을 권장합니다. 소스 코드 빌드를 위해서는 Git, Node.js 24 및 pnpm 11이 필요합니다. 저장소를 클론한 후 pnpm install 및 pnpm run desktop:dist를 실행하면 현재 플랫폼의 설치 패키지가 dist/desktop에 기록됩니다. 네이티브 의존성은 설치 단계에서 플랫폼별로 선택되므로 각 대상은 해당 운영체제에서 패키징해야 하며, desktop:dist:mac, desktop:dist:linux, desktop:dist:windows 등의 명령어를 사용할 수 있습니다. 저장소의 데스크탑 패키지화 워크플로는 GitHub 기본 runner를 사용해 macOS arm64, macOS x64, Linux x64 및 Windows x64를 빌드합니다. v* 태그를 푸시하면 워크플로가 설치 패키지를 해당 GitHub Release에 첨부합니다. macOS 빌드는 항상 Hardened Runtime과 Electron에 필요한 entitlements를 활성화하며, 관리자는 완전한 Apple Developer 자격 증명을 구성해 자동 서명과 Apple 공증을 완료할 수 있습니다. 일부 자격 증명만 구성된 경우 불완전한 산물이 서명된 버전으로 오인되지 않도록 빌드를 중단합니다. 개발 및 검증 관련 명령어로는 desktop:dev, apps/desktop에서 테스트 실행, verify-desktop-runtime-closure 및 build 등이 있습니다.