ccch1mneyyy/dsh-TUI

dsh‑TUI – DeepSeek Harness용 Claude 스타일 터미널 UI

무엇인가요

• 공식 dsh CLI(DeepSeek Harness) 위에 풍부한 그래픽 감성의 텍스트 사용자 인터페이스(TUI)를 추가하는 플러그인입니다. 핵심 엔진을 수정하지 않으며, 기존 DSH 서비스와 통신하는 UI 계층만 추가합니다.
• UI는 Claude Code의 디자인을 모방합니다: 픽셀 아트 고래 배너, 빛나는 제목, 실시간 상태바, 진행률 바, TPS(초당 토큰 수) 게이지, 스트리밍 Markdown, 도구 카드, 이미지 첨부 지원을 제공합니다.

왜 중요한가요

• 장시간 실행되는 AI 에이전트 세션을 터미널에서 사용 가능하게 만듭니다. 모델 토큰 수, 캐시 히트율, 현재 "에이전트" 상태를 실시간으로 확인할 수 있습니다.
• DeepSeek Harness의 기능을 반영한 완전한 명령어 세트(/new, /resume, /model, /audit, ...)를 제공합니다. 도구 실행, 서브에이전트, 승인 흐름 등도 동일한 창 내에서 가능합니다.
• 저자원 환경을 고려해 설계되었습니다. 가상 스크롤링을 통해 매우 긴 대화에서도 렌더링 비용이 가시 창 크기와 비례(O(visible-window))로 유지됩니다.

주요 기능(README에 기술됨)

기능	제공되는 기능
네이티브 터미널 상호작용	스트리밍 Markdown, 구조화된 도구 카드, 명령/파일 완성(예: @-파일 참조 포함), 이미지 첨부 처리, 이력 검색, 인라인/대체 화면 렌더링, 언어 전환(/lang).
관찰 가능한 에이전트 상태	실시간 작업 상태 줄, 컨텍스트 세그먼트 진행률 바, TPS 게이지, 캐시 히트율, 추론 수준, 토큰 수, Git/세션 정보.
완전한 세션 워크플로우	새/재개/압축/내보내기 세션 명령어, 사이드 질문(/btw), 모델 전환, 이중 Esc로 시간 되돌리기/포크.
DeepSeek Harness 통합	에이전트 프리셋, 스킬, MCP(원격 도구 서버), 목표, 할 일, 서브에이전트, ask_user_question 질문 흐름 접근.
장시간 세션 설계	이벤트 기반 프로젝션, 차이 기반 터미널 출력, 메시지 가상화, 제한된 캐시, 메모리 폭발 방지.
테마 시스템	터미널 배경 자동 감지, 내장된 라이트/다크/ANSI 테마, ~/.dsh‑tui/themes/에 배치된 사용자 정의 JSON 테마.
키보드 및 마우스 단축키	전체 핫키 목록(Enter, Ctrl‑C, Esc, Ctrl‑O, Ctrl‑R 등)에 더해 마우스 드래그 복사, 스크롤, 클릭 선택 기능.
플러그인 생태계	확장 개발 문서, 커뮤니티 리포지토리(dsh‑tui‑ecosystem), 템플릿 스타터.

설치 및 빠른 시작

# 핵심 DSH CLI와 TUI 플러그인을 전역으로 설치
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# 실행 – 첫 실행 시 프로필 자동 생성
dsh-tui

• TTY 터미널, pnpm 10+, 모델 호출용 DEEPSEEK_API_KEY 필요.
• Windows에서는 패키지된 dsh-tui.cmd를 실행할 수 있습니다.
• dsh-tui --resume 명령어로 마지막 세션을 복원할 수 있으며, /update로 플러그인을 즉시 업데이트 가능합니다.

내부 동작 방식

1. dsh는 프로필을 로드하여 기본 DSH 구현 → dsh‑TUI Cordis 패치 → 선택된 에이전트 프리셋의 체인을 구성합니다.
2. 세션 이벤트는 프로세스 내 이벤트 스트림을 통해 DSH 백엔드에서 TUI로 흐릅니다.
3. UI는 이식된 Ink/Yoga 렌더러를 사용하며, 인크리멘탈 차이 업데이트와 레이아웃 가상화를 통해 성능을 일정하게 유지합니다.
4. 모든 지속성(채팅 기록, 도구 결과 등)은 DSH 서비스의 책임이며, TUI는 상태 표시만 담당합니다.

일반 워크플로우

• dsh-tui를 시작 → 고래 배너와 상태 줄을 확인.
• 프롬프트 입력(Enter로 전송, Shift-Enter로 줄바꿈). 모델이 Markdown을 스트리밍으로 반환하며, 도구 카드가 인라인으로 표시됩니다.
• /model로 다른 모델 선택, /preset로 에이전트 모드 변경, /new로 새 대화 시작.
• 빈 줄에서 이중 Esc를 누르면 세션을 되돌리기 (이전 지점에서 새로운 브랜치 포크).
• /export로 전체 대화를 내보내기(Markdown)하거나 /로 이력 검색.

커뮤니티 및 지원

• 공식 DeepSeek Harness 공개 베타 WeChat 채널에서 소개됨.
• 빠른 도움이 필요하면 전용 QQ 그룹(572549239)과 WeChat 그룹 이용 가능.
• 문서에는 설치, 설정, 테마 커스터마이징, 상호작용 세부 사항, 아키텍처, VS Code 통합, 플러그인 개발, 기여 가이드라인 포함.

라이선스

• MIT – 자유롭게 사용, 수정, 재배포 가능.

---

위 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.