이 튜토리얼은 5분 안에 첫 DeepSeek Harness 플러그인 설치를 완료합니다. 카탈로그 CLI 설치, 플러그인 검색부터 dry-run, 설치 확정, 로드 확인까지. 전 과정이 터미널 명령으로 이루어지며 모든 단계를 복사할 수 있습니다.
사전 준비
시작하기 전에 환경이 다음 요구사항을 충족하는지 확인하세요:
- Node.js 20 이상 — dsp CLI 실행 환경입니다.
node --version으로 확인하세요; - 공식
dsh명령 — 실제 설치를 수행하는 Harness CLI입니다; pnpm— Harness가 profile 의존성을 관리하는 데 사용하며,PATH에 있어야 합니다.
핵심 개념
설치를 시작하기 전에 단 1분만 네 단어를 이해합시다. 아래의 모든 명령이 이것들을 다룹니다:
- 플러그인(plugin): Harness 기능을 확장하는 코드 모듈입니다. 이 카탈로그의 모든 플러그인은 npm에 게시되어 있으며 고유한
owner/repo식별자를 가집니다. - profile: Harness의 이름 있는 환경으로, 플러그인이 설치되는 곳입니다. 기본 profile과
web같은 여러 profile을 가질 수 있으며 서로 영향을 주지 않습니다.dsp install은 기본적으로 현재 profile에 기록합니다. - bundle: 플러그인이 npm에 게시하는 패키징 산출물입니다. 카탈로그는 각 플러그인에 대해 정확한 버전, 무결성 해시, bundle 증거를 등록해 두었으며,
dsp는 이를 바탕으로 설치하는 패키지가 등록된 것과 동일한지 검증합니다. - patch(
--patch): 이번 실행에만 설정을 겹쳐 올리는 방식입니다. 개발 중 로컬 플러그인을 로드할 때 자주 쓰이며 어떤 profile도 수정하지 않습니다.
dsp CLI 설치
dsp는 dsh-plugins 패키지에 포함되어 있으며, 한 줄로 전역 설치합니다:
npm install --global dsh-plugins
dsp --version
설치하면 터미널에 dsp 명령이 생깁니다. 플러그인 레지스트리 스냅샷을 내장하고 있어 오프라인에서도 검색됩니다. 기본적으로 15분에 최대 한 번만 온라인 레지스트리 업데이트를 확인합니다.
플러그인 검색
키워드로 카탈로그를 검색하세요. 예를 들어 터미널 UI(TUI) 계열 플러그인을 찾는다면:
dsp search TUI
검색 결과에는 일치하는 플러그인, 저장소 식별자, 한 줄 소개가 표시됩니다. 이 사이트의플러그인 카탈로그에서 분류별로 둘러볼 수도 있습니다.
플러그인 상세 보기
마음에 드는 플러그인이 있으면 owner/repo 식별자로 전체 정보를 확인하세요:
dsp show huiliyi37/dsh-tianshu-tui
출력에는 플러그인 소개, 등록된 정확한 npm 버전, 무결성 해시, bundle 검사 결과가 포함됩니다. 이 정보가 빠른 설치 사용 가능 여부를 결정합니다.
dry-run: 설치 계획 미리 보기
설치 전에는 먼저 dry-run하세요. --dry-run은 설치 계획만 출력하고 어떤 설정도 바꾸지 않습니다:
dsp install huiliyi37/dsh-tianshu-tui --dry-run
계획에 적힌 패키지 이름, 버전, 기록될 profile을 꼼꼼히 확인하세요. 의심스러운 설치를 막을 수 있는 마지막 기회입니다.
설치 확정
계획에 문제가 없으면 --yes를 붙여 실제 설치를 실행합니다:
dsp install huiliyi37/dsh-tianshu-tui --yes
dsp는 공식 dsh 명령을 호출해 등록된 packageName@version을 현재 profile에 설치합니다. 다른 profile을 지정하려면 --profile web을 붙이세요.
플러그인 로드 확인
Harness Web 인터페이스를 시작하고 플러그인이 로드 로그나 화면에 나타나는지 확인하세요:
dsh web
# http://127.0.0.1:3080 열기
터미널 시작 시 로드된 플러그인 목록이 출력됩니다. 방금 설치한 플러그인이 보이면 전 과정이 제대로 동작한 것입니다.
자주 쓰는 명령 모음
이 튜토리얼에서 사용한 명령을 한곳에 모았습니다. 나중에 다시 와서 복사해 가세요:
# dsp CLI 설치 / 업그레이드
npm install --global dsh-plugins
# CLI 버전 확인
dsp --version
# 키워드로 카탈로그 검색
dsp search TUI
# 플러그인 상세와 보안 증거 보기
dsp show huiliyi37/dsh-tianshu-tui
# dry-run: 계획만 출력하고 설정은 변경하지 않음
dsp install huiliyi37/dsh-tianshu-tui --dry-run
# 현재 profile에 설치 확정
dsp install huiliyi37/dsh-tianshu-tui --yes
# Harness Web 인터페이스를 시작해 로드 확인
dsh web
기억할 근육 기억 하나: 어떤 설치든 먼저 --dry-run으로 계획을 보고, 문제가 없을 때만 --yes로 실행하기.
빠른 시작 자주 묻는 질문
dsp와 dsh는 어떤 관계인가요?
dsh는 Agent와 플러그인을 관리하는 DeepSeek Harness 공식 명령줄입니다. dsp(dsh-plugins 패키지)는 이 사이트가 제공하는 카탈로그 조회 도구로, 카탈로그를 검색하고 설치 증거를 보여주며, 공식 dsh 명령을 호출해 설치를 완료합니다.
플러그인을 설치해도 안전한가요?
서드파티 플러그인은 당신의 사용자 권한으로 실행되며 패키지 라이프사이클 스크립트를 실행할 수 있습니다. dsp는 정확한 버전, 무결성 해시, bundle 증거가 등록된 플러그인만 빠른 설치를 허용합니다. 설치 전에는 항상 --dry-run으로 계획을 확인하고 플러그인 저장소 소스를 읽으세요.
Node.js 환경이 없으면 어떡하죠?
검색 기능에는 Node.js 20+만 있으면 됩니다. 당장 CLI를 설치하고 싶지 않다면 이 사이트의 플러그인 카탈로그를 바로 둘러보세요. 모든 플러그인에 README와 설치 방법을 보여주는 개별 상세 페이지가 있습니다.
플러그인은 어디에 설치되나요?
플러그인은 dsp CLI에 설치되는 것이 아니라 공식 dsh 명령이 현재 profile에 기록합니다. profile은 Harness가 pnpm으로 관리하는 이름 있는 환경입니다. 기본적으로 현재 profile에 설치되며, --profile web을 붙이면 다른 profile을 지정할 수 있습니다.
플러그인을 검색할 때 인터넷이 필요한가요?
아니요. dsp는 플러그인 레지스트리 스냅샷을 내장하고 있어 오프라인에서도 검색됩니다. 기본적으로 15분에 최대 한 번만 온라인 레지스트리 업데이트를 확인하므로, 네트워크가 연결되어 있으면 결과가 자동으로 최신 상태를 유지합니다.