PC2005-cloud/dsh-pet
코드 에디터에서 작동하는 투명 데스크톱 펫, 100+ 애니메이션 담아 공개
원제 PC2005-cloud/dsh-pet
스타 3,061당일 +403TypeScript
Key Point
데스크톱 펫을 직접 생성·커스터마이징할 수 있는 완전한 생성 체인이 공개되었으며, 이는 개발자가 AI 영상 생성과 자동화 소재 처리를 통해 자신의 고유한 데스크톱 펫을 만들 수 있음을 의미한다.
핵심 요약
- DeepSeek Harness(DSH) 플러그인으로 제공되는 투명 배경 데스크톱 펫으로, 100개 이상의 애니메이션(대기·행동·상호작용)을 탑재했다.
- 한 줄 명령으로 설치하며 브라우저와 데스크톱 독립 창에서 동시 실행 가능하고, 다중 인스턴스로 여러 펫을 같은 화면에 배치할 수 있다.
- 크기·위치·display 모드(웹만/데스크톱만/둘 다/비표시)를 설정 페이지나 config.jsonc 파일로 구성 가능하며, 물리 시뮬레이션을 통해 드래그·투척·반발을 구현했다.
- 남은 토큰 액수를 차트 동작과 머리 위 버블로 시각화하며, DeepSeek/OpenCode Zen Go/Command Code 서비스의 실시간 잔액을 표시한다.
- 주기적 '중얼거림'(자동 텍스트 생성), 우클릭 대화 기능(메모리 지속), DSH 작업 상태 추적 동작(생각/작업/정렬/기다림/성공/오류 6단계)을 지원한다.
- HTTP 및 Cordis 서비스 인터페이스로 다른 플러그인이 펫을 제어하거나 상태를 읽을 수 있으며, 동작 지정·애니메이션 재생·대화 트리거가 가능하다.
- Windows/Linux/macOS 크로스플랫폼이며, Electron을 처음 시작 시 자동 다운로드(~/.dsh/electron)하고, Safari를 위해 GitHub Release에서 HEVC-Alpha .mov 소재를 별도 제공한다.
- 멀티 모니터 환경을 지원하며, 화면 경계·DPI 다층화·작업 표시줄을 올바르게 판정하고, 각 화면 내 활동만 제한하는 옵션이 있다.
- GitHub의 AI 비디오 도구(豆包 등)로 생성한 10초 녹화본을 Python 스크립트로 처리하면 VP9-Alpha webm 소재를 자동 변환할 수 있고, 공식 PR은 수작업 크로마키 처리를 거친다.
- 포함된 생성 체인으로 누구나 자신의 펫을 처음부터 생성 가능하며, 함수형 물리 엔진(dsh-pet/src/shared/physics.ts)과 좌우 거울상 제어를 정의해 재사용한다.
- 코드는 MIT, 애니메이션/제안어/원본 영상은 오픈소스 사용 허가이나 상용화 금지이며, 파생 작품은 원작자 GitHub 주소를 모든 배포·소개 위치에 명시해야 한다.
- 브라우저 지원은 Chromium(Chrome/Edge) 및 Firefox인데, Safari는 webm alpha 미지원 문제로 별도 mov 소재 필요하다.
- 독립 실행 모드(DSH 미사용)도 가능하며 HTTP 로컬 서비스로 동작하되, 잔액·중얼거림·대화·시스템 알림은 비활성화된다.
저장소 보기 ↗github.com