PC2005-cloud/dsh-pet

dsh‑pet – DeepSeek Harness용 "데스크톱 펫" 플러그인

소개 – dsh-pet은 DeepSeek Harness (DSH) 플랫폼(웹 기반 AI 채팅 환경)을 위한 플러그인입니다. 이 플러그인은 DSH UI나 별도의 투명한 데스크톱 창에서 살아가는 작은 애니메이션 캐릭터를 추가합니다. 펫은 사용자의 클릭, 드래그, DSH 대화 이벤트, 잔액 확인 API에 반응하며, 작은 HTTP API를 통해 스크립트로 제어할 수도 있습니다.

중요성 – AI 모델 자체는 아니지만, 생성형 AI로 구동되는 에셋(손으로 그린 애니메이션 팩은 AI 프롬프트로 생성됨)을 대화형 UI 구성 요소로 패키징하는 방법을 보여줍니다. 또한 다음 세 단계의 명확한 분리를 보여줍니다.

1. 프롬프트 레시피: AI로 애니메이션 에셋 생성.
2. 에셋 생성 파이프라인: 소스 비디오를 투명한 WebM/VP9‑Alpha 클립으로 변환.
3. DSH 플러그인: 해당 에셋을 소비하고 대화형 펫을 제공.

주요 기능 (README 설명 기준)

• 순수한 데스크톱 펫 경험 – 날씨나 시스템 모니터링 기능은 없으며, 선택적 모듈로 잔액 표시, "속삭임", 채팅, 작업 상태 및 시스템 알림이 있습니다.
• 애니메이션 체인 – 유휴, 회전, 이동 및 분류된 동작에는 가중치가 있으며, 다음 애니메이션이 자동으로 선택되고 매끄러운 교차 페이드가 적용됩니다.
• 이벤트 기반 애니메이션 – 잔액, 속삭임, 작업 상태 각각에 고유한 애니메이션 세트가 있으며 특정 트리거에서 실행됩니다.
• 다중 인스턴스 지원 – 여러 펫을 동시에 실행할 수 있으며, 각각 독립적인 크기, 위치 및 설정을 가집니다.
• 화면 로밍 및 물리 효과 – 펫은 화면을 돌아다니며 보이는 영역을 벗어나지 않도록 하고, 드래그 앤 스로우 물리 효과(탄성 바운스, 마찰 등)에 반응합니다.
• 컨텍스트 메뉴 – 우클릭으로 수동으로 애니메이션을 트리거하거나, URL을 열거나, 잔액을 확인하거나, 설정을 다시 로드할 수 있습니다.
• 데스크톱 모드 – 펫마다 Electron 기반의 투명 창을 사용하여 브라우저 밖에서도 펫을 키울 수 있습니다.
• 펫 팩 – pet/ 아래에 ‑config.json과 일치하는 애니메이션 폴더를 넣어 새로운 종을 추가할 수 있습니다.
• 사용자 지정 애니메이션 가져오기 – main-animation/webm/에 VP9‑Alpha .webm 파일을 넣어 라이브러리를 확장할 수 있습니다.
• 접근성 – prefers-reduced-motion을 존중하여 바운스 및 페이드인 효과를 건너뜁니다.
• 외부 HTTP API – 로컬의 인증되지 않은 엔드포인트 (/dsh-pet-7340/*)를 통해 다른 플러그인이 펫에게 말을 걸거나, 특정 애니메이션을 재생하거나, 상태를 쿼리할 수 있습니다. OpenAPI 사양과 작은 테스터 UI가 제공됩니다.
• 독립 실행형 모드 – DSH 없이 펫을 실행할 수 있으며, 동일한 UI와 물리 효과를 제공하지만 기능은 제한됩니다(잔액, 속삭임, 채팅, 시스템 알림 불가).

설치 및 사용법

1. DSH 런처와 pnpm을 설치합니다 (npm i -g @deepseek-ai/dsh pnpm).
2. DSH CLI를 통해 플러그인을 추가합니다: dsh plugin --profile desktop add dsh-pet (또는 UI에서 설치).
3. DSH 데스크톱 또는 웹 클라이언트를 다시 시작하면 오른쪽 상단에 펫이 나타납니다.
4. 개발을 위해서는 저장소를 복제하고 npm install && npm run build를 실행한 다음 dsh plugin --profile desktop add file:<path>로 추가합니다.

설정 – 기본 설정은 assets/config.jsonc에 있습니다. 사용자는 DSH 설정 UI를 통해 편집하거나 JSONC 파일($DSH_HOME/dsh-pet/main-config.jsonc)을 직접 편집할 수 있습니다. 이 파일은 다음을 제어합니다:

• pets 배열 (ID, 크기, 위치, 표시 모드, 잔액 토글)
• animations 및 animationWeights
• 잔액, 속삭임 등의 새로 고침 간격
• notificationsEnabled와 같은 전역 스위치

지원 플랫폼 – Windows, macOS, Linux (브라우저 오버레이 및 Electron 데스크톱 모두 지원). Safari는 투명 WebM을 지원하지 않으므로 .mov 대체 방안이 문서화되어 있습니다.

전반적인 인상 – dsh-pet은 DeepSeek Harness UI를 재미있고 확장 가능한 데스크톱 펫 환경으로 바꾸는, 문서화가 잘 되어 있고 기능이 풍부한 플러그인입니다. AI 기반 플랫폼과 밀접하게 결합된 실제 소프트웨어 프로젝트로서, AI 강화 UI 확장, 플러그인 생태계 및 대화형 시각 에이전트에 관심이 있는 독자에게 가치가 있습니다.

---

빠른 참조

• 저장소: https://github.com/PC2005-cloud/dsh-pet
• npm: dsh-pet
• 라이선스: (배지 참조) – 오픈 소스 라이선스로 추정.
• 주요 언어: TypeScript/JavaScript.
• 대상 독자: 시각적인 동반자를 원하는 DeepSeek Harness 사용자 및 사용자 지정 AI 생성 애니메이션 팩을 구축하려는 개발자.

---

위의 모든 세부 정보는 README에서 직접 가져온 것이며, 외부 추측은 포함되지 않았습니다.