ayuayue/PiDeck

PiDeck – Pi 및 DSH 코딩 에이전트용 데스크톱 워크벤치

이것은 무엇인가

• PiDeck은 pi 코딩 어시스턴트 CLI 및 **DSH(DeepSeek Harness)**용 그래픽 셸 역할을 하는 오픈 소스 데스크톱 애플리케이션(Electron + React/TypeScript 기반)입니다. pi를 대체하지 않으며, 단지 pi(또는 DSH) 프로세스를 rpc 모드로 실행하고 여러 프로젝트와 여러 에이전트 세션을 관리하기 위한 통합 UI를 제공합니다.

대상 사용자

• 로컬에서 pi 또는 DeepSeek 에이전트를 사용하며 다음을 원하는 개발자:
  • 여러 코드베이스에 대해 별도의 작업 공간 유지
  • 대화 기록 탐색, 검색 및 내보내기
  • UI를 벗어나지 않고 Git 상태 확인, 파일 편집, 터미널 실행, 모델 구성
  • 기존 Codex/Claude 세션 파일을 가져와 PiDeck 호환 기록으로 변환

주요 기능

영역	PiDeck이 하는 일
멀티 프로젝트 작업 공간	로컬 프로젝트 폴더를 추가, 재정렬, 전환할 수 있으며 각 프로젝트는 자체 격리된 pi RPC 프로세스를 실행합니다.
세션 관리	세션을 생성, 이름 변경, 복제, 삭제, 내보내기(HTML) 및 재시작할 수 있으며 pi 및 DSH 백엔드를 모두 지원하고 OpenAI 호환 이미지 API와 통신하는 "이미지 생성" 모드도 포함합니다.
풍부한 입력 도우미	@ 파일 참조, / 명령 팔레트, ! 셸 실행 – 모두 단일 채팅 상자에서 제공됩니다.
파일 및 Git 통합	Git 상태 배지가 있는 파일 트리, 내장 편집기, 외부 편집기 단축키, Git 분기 선택기, 활성 에이전트에 연결된 터미널 독을 제공합니다.
모델 및 자격 증명 UI	models.json, auth.json, settings.json용 시각적 편집기, 원클릭 연결 테스트, 공급자별 사용량 및 잔액 표시, 프록시 구성을 제공합니다.
확장 프로그램 및 스킬 스토어	내장 확장 프로그램 활성화/비활성화, 커뮤니티 Skill 및 Prompt 마켓플레이스 탐색, 중국어 프롬프트 컬렉션(XuePrompt) 설치를 지원합니다.
데스크톱 완성도	시스템 트레이, 테마 전환, 데스크톱 펫 마스코트, 토스트 알림, Feishu 봇 동기화, LAN 액세스 가능 웹 UI, 프로세스 모니터 및 로그 뷰어를 제공합니다.
DSH 심층 통합	임베디드 DSH 호스트가 Electron 유틸리티 프로세스로 실행됩니다(추가 포트 불필요). 전체 세션 탐색, 명령 완성, 사용량 통계 및 자격 증명 편집 기능이 제공됩니다.

작동 방식

• Electron 메인 프로세스는 각 세션에 대해 별도의 pi --mode rpc 프로세스와 임베디드 DSH 호스트를 실행합니다. 통신은 stdio JSON-RPC를 통해 이루어지며 에이전트를 격리된 상태로 유지합니다.
• 프리로드 스크립트는 contextBridge를 통해 제한된 window.piDesktop API를 React 렌더러에 노출합니다.
• 렌더러(React)는 프로젝트 목록, 채팅 타임라인, 파일 탐색기, Git 패널, 터미널 독, 설정 등을 표시합니다.
• 구성 파일은 시각적 UI를 통해 직접 편집되며, 해당 에이전트가 다시 시작된 후 변경 사항이 적용됩니다.

시작하기

1. pi CLI를 설치하고 PATH에 있는지 확인하세요(pi --version).
2. GitHub Releases 페이지에서 적절한 설치 프로그램(Windows/macOS/Linux)을 다운로드하세요. 별도의 PiDeck Dev 사전 릴리스 채널도 제공됩니다.
3. 앱을 실행하고 프로젝트 폴더를 추가한 다음 새 pi 또는 DSH 세션을 만드세요.
4. 사이드 패널을 사용하여 models.json 등을 편집하거나 내장 터미널을 열어 명령을 실행하세요.

개발

• Node 20+ 및 npm이 필요합니다.
• 일반적인 워크플로: npm install && npm run dev를 실행하여 핫 리로딩 Electron 창을 시작합니다.
• 빌드 명령(npm run dist:*)은 각 플랫폼용 설치 프로그램을 생성하며, dist:*:dev는 병렬 개발 채널을 만듭니다.

라이선스 및 커뮤니티

• MIT 라이선스이며 활발한 중국어 커뮤니티(QQ/WeChat 그룹)와 GitHub의 공개 이슈 트래커가 있습니다.

요약하자면, PiDeck은 여러 로컬 AI 코딩 에이전트를 나란히 실행하고, 대화를 체계적으로 유지하며, 코드베이스 및 도구와 긴밀하게 통합할 수 있는 완전한 기능을 갖춘 데스크톱 IDE 스타일 래퍼입니다.

---

저장소 메타데이터

• 상태: 실험적(v0.9.0, 2026-10-14)
• 플랫폼: Windows | macOS | Linux
• 핵심 기술: Electron 38, React 19, TypeScript
• 라이선스: MIT

---

위의 모든 세부 사항은 프로젝트의 README에서 직접 가져온 것입니다.