디자인을 위한 DeepSeek Harness.
모델은 JSX를 작성할 수 있지만, 유용한 디자인 에이전트에는 모델의 출력 이상의 것이 필요합니다. 브랜드 규칙, 레퍼런스, 도구, 권한과 더불어 결과를 렌더링하고 검사하는 루프가 있어야 합니다. DeepSeek Harness는 이러한 주변 요소를 감추지 않고 드러냅니다.
인터페이스 작업에서는 요구사항과 승인 루프를 명확히 만드세요. 기본 DeepSeek 라우트는 텍스트만 지원하므로 코드 및 명세 기반 워크플로가 가장 신뢰할 수 있는 기준입니다. 이미지 입력을 지원한다고 명시된 모델 라우트를 선택한 후에만 스크린샷을 첨부하세요.
이러한 유연성은 디자인 작업에 유용합니다. 생성되는 UI의 품질은 모델을 둘러싼 하네스, 즉 지속적인 프로젝트 규칙, 재사용 가능한 스킬, 텍스트 또는 이미지 입력에 적합한 프로바이더, 파일 및 셸 도구, 검증 루프에 좌우되기 때문입니다. 이 가이드에서는 가장 빠르게 작동하는 설정 방법, UI 작업에서 중요한 제한 사항, Open Design과의 정확한 경계를 설명합니다. 현재 dsh에는 Open Design의 공식 어댑터가 없으며, 기존 DeepSeek TUI 어댑터는 별개의 CLI입니다.
DeepSeek Harness를 처음부터 설정하기
공개 프리뷰를 사용하려면 Node.js `^22.19.0` 또는 `>=24.0.0`이 필요합니다. npm 명령어는 처음 실행할 때 웹 프로필을 초기화하므로 저장소를 복제하지 않고도 작동하는 로컬 UI를 바로 열 수 있습니다.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- 자격 증명은 참조 형태로 유지: 웹 UI는 프로바이더 비밀 정보를 `$DSH_HOME/.credentials.yaml`에 저장합니다. 설정에는 자격 증명 참조만 유지되며, UI에는 실제 키가 아닌 마스킹된 설명자가 전달됩니다.
- 프리뷰는 버전을 고정한 인프라로 취급: 유지관리자는 호환성을 깨는 변경이 발생할 것이라고 명시적으로 경고합니다. 팀 워크플로에서는 버전을 고정하고, 업데이트 전에 릴리스 변경 사항을 검토하세요.
플러그인 우선 하네스가 디자인 작업에 적합한 이유
모델은 JSX를 작성할 수 있지만, 유용한 디자인 에이전트에는 모델의 출력 이상의 것이 필요합니다. 브랜드 규칙, 레퍼런스, 도구, 권한과 더불어 결과를 렌더링하고 검사하는 루프가 있어야 합니다. DeepSeek Harness는 이러한 주변 요소를 감추지 않고 드러냅니다.
- 지속적인 디자인 컨텍스트: 기본 지침 로더는 프로젝트 계층에서 `AGENTS.md`와 `CLAUDE.md`를 읽습니다. 모든 실행에서 참조할 수 있도록 토큰, 컴포넌트 규칙, 반응형 중단점, 검토 기준을 이 파일에 기록하세요.
- 재사용 가능한 스킬: 로컬 스킬은 `.dsh/skills` 또는 `.agents/skills` 아래에 둘 수 있습니다. 프런트엔드 스킬에는 각 UI 작업을 처음부터 시작하지 않도록 정확한 요구사항, 체크리스트, 예시, 스크립트를 패키징할 수 있습니다.
- 작업에 따른 프로바이더 선택: 웹 UI에서는 DeepSeek, Anthropic이나 OpenAI 같은 카탈로그 프로바이더, 사용자 지정 OpenAI 호환 엔드포인트를 설정할 수 있습니다. 스크린샷 입력에는 이미지 지원이 명시된 라우트를 사용하고, 텍스트·코드·DOM·명세 기반 작업에는 네이티브 DeepSeek 라우트를 사용하세요.
모든 에이전트에 동일하게 적용되는 중요한 한계가 있습니다. 조합 가능성이 곧 디자인 감각은 아닙니다. 타이포그래피, 간격, 컴포넌트, 인터랙션에 대한 세심한 제약이 없으면 런타임은 평범한 결과물을 충실하게 자동 생성할 뿐입니다. Open Design의 역할은 이러한 디자인 입력을 제공하고 체계화하는 것입니다.
실용적인 DeepSeek Harness UI 및 프런트엔드 워크플로
인터페이스 작업에서는 요구사항과 승인 루프를 명확히 만드세요. 기본 DeepSeek 라우트는 텍스트만 지원하므로 코드 및 명세 기반 워크플로가 가장 신뢰할 수 있는 기준입니다. 이미지 입력을 지원한다고 명시된 모델 라우트를 선택한 후에만 스크린샷을 첨부하세요.
- 저장소에서 dsh를 시작하고 해당 디렉터리를 워크스페이스로 선택한 뒤 이 작업에 사용할 모델 라우트를 선택합니다.
- 브랜드 규약을 `AGENTS.md`, `CLAUDE.md` 또는 참조된 `DESIGN.md`에 기록합니다. 토큰, 프리미티브, 간격, 서체, 중단점, 상태, 금지 패턴을 포함하세요.
- `.dsh/skills` 또는 `.agents/skills`에서 목적이 분명한 프런트엔드 스킬을 로드합니다. 예시와 검증 스크립트는 지침과 같은 위치에 둡니다.
- 에이전트에게 기존 컴포넌트를 재사용하고 애플리케이션을 실행한 뒤 프로젝트 자체 테스트 또는 브라우저 도구로 반응형 상태를 검증하도록 요청합니다.
- 화면에 표시된 결과를 검토하고 구체적인 차이를 기록한 뒤 작은 커밋 단위로 반복합니다. 좋지 않은 기반 위에 수정 사항을 쌓지 말고 완성도가 낮은 작업은 되돌리세요.
유용한 프롬프트는 시각적 제약과 검증 근거를 모두 명시합니다.
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.스크린샷이 반드시 필요하다면 먼저 이미지 지원 프로바이더를 설정하세요. 선택한 라우트에 이미지 지원이 명시되어 있지 않으면 DeepSeek Harness는 전송 전에 이미지를 거부합니다. 레퍼런스가 조용히 누락되는 것을 방지하는 유용한 안전장치입니다.
플러그인, 스킬, 프로젝트 컨텍스트
DeepSeek Harness의 가장 차별화된 부분은 채팅 화면 아래에 있습니다. 플러그인 트리를 사용하면 모든 세션에 프롬프트를 붙여 넣는 대신 디자인 워크플로 자체를 런타임의 일부로 만들 수 있습니다.
- AGENTS.md 및 CLAUDE.md: 지침 플러그인은 사용자 전역 파일과 프로젝트 계층을 로드한 뒤, 자체 제공 파일 작업이 처음 실행되면 관련 중첩 지침 파일을 감지합니다. 일회성 요청이 아닌 지속적인 디자인 규칙을 저장하는 데 사용하세요.
- 파일 시스템 스킬: 스킬 레지스트리는 프로젝트 및 사용자 루트를 탐색하고, 중복 항목의 우선순위를 정한 뒤, 모델에 `skill` 도구를 제공합니다. 프런트엔드 완성도, 접근성, 반응형 QA, 디자인 시스템 절차를 두기에 자연스러운 위치입니다.
- 프로필 및 번들: 프로필은 순서가 지정된 플러그인 번들과 사용자 패치를 계층적으로 결합합니다. 팀은 실제로 필요한 프로바이더, 도구, 권한 정책, 스킬 소스로 디자인 중심 구성을 유지할 수 있습니다.
- MCP 및 외부 기능: 소스 트리에는 MCP 클라이언트 기능이 포함되어 있지만, 사용자 대상 설정은 여전히 개발자 중심입니다. 프리뷰 기간에는 통합 기능을 안정적인 체크박스 방식의 워크플로가 아닌 버전이 지정된 플러그인 작업으로 취급하세요.
장기적으로 사용할 내부 워크플로를 구축하기 전에 `dsh --profile web --dump-config`로 실제 적용되는 트리를 확인하세요. 이 출력은 실제로 무엇이 마운트되어 있고 패치할 수 있는지 보여줍니다. 저장소의 모든 패키지가 기본 제공 프로필에서 활성화되어 있다고 가정하는 것보다 신뢰할 수 있습니다.
개발자 프리뷰 및 디자인 작업의 주의점
가장 큰 실수는 프리뷰를 안정적인 제품처럼 취급하거나, 텍스트 전용 라우트를 비전 모델처럼 사용하거나, 유연한 하네스 자체가 시각적 감각을 제공한다고 여기는 데서 생깁니다.
- 사용자 지정 전에 버전 고정: 호환성을 깨는 변경은 명시적인 프리뷰 정책입니다. npm 버전을 고정하고 업그레이드 후 검토하기 쉬울 정도로 프로필 패치를 작게 유지하세요.
- 선택한 모델의 모달리티 확인: 네이티브 DeepSeek chat-completions 라우트는 텍스트만 지원합니다. 스크린샷을 코드로 변환하려면 첨부 파일을 이해할 것이라고 가정하지 말고 이미지 지원 프로바이더 라우트를 선택하고 명시하세요.
- 디자인 감각을 데이터로 제공: 에이전트에 토큰, 표준 컴포넌트, 참조 상태, 금지 패턴을 제공하세요. 디자인 규약이 없는 모듈식 런타임은 여전히 평범한 UI를 만듭니다.
- 프로필이 실제로 마운트하는 항목 검증: 저장소 패키지는 사용 가능한 기능일 뿐 기본 프로필에서 활성화되었다는 증거가 아닙니다. 통합 기능을 문서화하거나 의존하기 전에 조합된 설정을 확인하세요.
각각의 대응책은 컨텍스트와 검증에 관한 결정입니다. 모든 프로젝트가 이를 반복해서 찾아내도록 맡기는 대신 디자인 계층이 반복 가능한 방식으로 만들어야 할 작업입니다.
DeepSeek Harness의 정확한 정체
DeepSeek Harness(`dsh`)는 DeepSeek AI가 개발하고 MIT 라이선스로 배포하는 에이전트 하네스입니다. 공개 개발자 프리뷰에는 로컬 웹 UI와 헤드리스 러너가 포함됩니다. 모델도 아니고 단순한 터미널 스킨도 아닙니다. 모델, 도구, 컨텍스트, 권한, 세션, 사용자 인터페이스를 하나의 에이전트로 조합하는 런타임입니다.
핵심 발상은 ‘모든 것이 플러그인’이라는 것입니다. Cordis는 모델 어댑터, 도구 레지스트리, 에이전트 루프, 파일 시스템, 셸, 샌드박스, 스킬, 서브에이전트, 영속성, UI를 프로필과 번들을 통해 마운트하거나 교체하고 패치할 수 있는 트리를 구성합니다. 기본 제공되는 `web` 및 `headless` 프로필은 고정된 제품이 아니라 출발점입니다.
- 로컬 웹 UI: `npx @deepseek-ai/dsh web`은 기본적으로 `127.0.0.1:3080`에서 브라우저 워크스페이스를 시작합니다. 모델을 추가하고 워크스페이스를 선택한 뒤 대화 UI에서 작업을 실행할 수 있습니다.
- 헤드리스 모드: `headless` 프로필은 새 영속 세션 하나를 실행하고 최종 답변을 출력한 뒤 종료합니다. 스크립트 기반 감사, 빌드, 반복 가능한 디자인 검사에 유용합니다.
- 조합 가능한 런타임: 프로필은 플러그인 번들과 자체 패치를 계층적으로 결합합니다. 따라서 팀은 에이전트 루프를 포크하지 않고도 프로바이더, 도구, 정책, UI 동작을 변경할 수 있습니다.
- 개발사: DeepSeek AI(공식 프로젝트)
- 상태: 개발자 프리뷰. 호환성을 깨는 변경이 예상됩니다.
- 라이선스: MIT
- 기본 명령어: `npx @deepseek-ai/dsh web`
DeepSeek Harness와 DeepSeek TUI 및 기타 디자인 에이전트 비교
이름이 비슷해 혼동하기 쉽습니다. DeepSeek Harness와 현재 Open Design에 등록된 DeepSeek TUI는 실행 파일과 통합 상태가 서로 다른 별개의 프로젝트입니다.
| 도구 | 정의 | 가장 적합한 디자인 용도 |
|---|---|---|
| DeepSeek Harness (`dsh`) | 로컬 웹 UI와 헤드리스 프로필을 갖춘 DeepSeek AI의 공식 플러그인 우선 하네스. 현재 개발자 프리뷰 단계 | 디자인 워크플로를 중심으로 런타임, 스킬, 프로바이더, 정책, UI를 직접 구성하려는 팀 |
| DeepSeek TUI (`deepseek` / `codewhale`) | 별도의 터미널 코딩 에이전트이며 현재 Open Design이 지원하는 DeepSeek 어댑터 | 현재 Open Design 내에서 DeepSeek 사용 |
| OpenCode | 성숙한 오픈 소스 프로바이더 독립형 터미널 에이전트 | AGENTS.md와 MCP를 사용하는 안정적인 TUI 워크플로 내 모델 전환 |
| Claude Code | 터미널, IDE, 데스크톱, 웹 전반에서 사용할 수 있는 성숙한 코딩 에이전트 | 프런트엔드 추론, 이미지 중심 레퍼런스, 검증된 디자인 통합 |
| Open Design | 지원되는 코딩 에이전트를 중심으로 구축된 에이전트 네이티브 디자인 워크스페이스 및 라이브러리 | 엄선된 디자인 시스템, 스킬, 시각적 아티팩트와 특정 모델 공급업체에 종속되지 않는 로컬 워크플로 |
하네스 자체를 확장하고 싶다면 dsh를 선택하세요. 현재 지원되는 DeepSeek 어댑터와 바로 사용할 수 있는 디자인 계층이 필요하다면 Open Design 내 DeepSeek TUI를 선택하세요. 향후 어댑터를 통해 통합될 수 있지만 현재로서는 서로 바꿔 쓸 수 없습니다.
에이전트 네이티브 디자인 워크스페이스와 함께 DeepSeek Harness 사용하기
Open Design과 DeepSeek Harness는 서로 인접한 계층을 담당합니다. dsh는 에이전트 런타임을 조합하고, Open Design은 에이전트가 시각적 작업에 유용하도록 디자인 시스템, 스킬, 로컬 아티팩트 워크플로를 엄선해 제공합니다. 아직 Open Design에는 전용 `dsh` 어댑터가 없으므로 현재로서는 두 도구를 나란히 사용하는 것이 정확한 워크플로입니다.
- Open Design을 설치하고 디자인 시스템과 스킬을 사용하여 프로젝트의 시각적 규약을 정립합니다.
- 완성된 `DESIGN.md`, 레퍼런스, 프로젝트 지침을 DeepSeek Harness가 워크스페이스로 여는 동일한 저장소에 보관합니다.
- 플러그인 우선 실험과 코드 작업에는 dsh를 실행합니다. 별도의 디자인 요구사항을 관리하지 말고 동일한 토큰, 규칙, 에셋, 검증 기준을 재사용하세요.
- 현재 Open Design 내에서 DeepSeek를 직접 사용해야 할 때는 기존 DeepSeek TUI 어댑터를 선택하세요. 향후 dsh 어댑터는 현재 기능이 아닌 별도의 통합 기능으로 간주해야 합니다.
그 결과 직접 소유하는 하나의 코드베이스와 이식 가능한 하나의 디자인 규약을 두 로컬 우선 도구에서 사용할 수 있습니다. Open Design은 DeepSeek AI와 독립적이며, DeepSeek와 DeepSeek Harness는 각 소유자의 상표입니다.
DeepSeek Harness 자주 묻는 질문
-
01 DeepSeek Harness란 무엇인가요?
DeepSeek Harness(`dsh`)는 DeepSeek AI의 공식 오픈 소스 에이전트 하네스입니다. Cordis 플러그인 트리를 통해 모델, 도구, 컨텍스트, 세션, 정책, 오케스트레이션, UI를 결합합니다. 현재 공개 릴리스는 MIT 라이선스로 제공되는 개발자 프리뷰입니다.
-
02 DeepSeek Harness를 어떻게 설치하고 실행하나요?
지원되는 Node.js 버전을 설치한 뒤 `npx @deepseek-ai/dsh web`을 실행하세요. 기본적으로 `http://127.0.0.1:3080`에서 로컬 웹 UI가 시작됩니다. Settings → Models에서 모델을 추가하고 워크스페이스를 선택한 뒤 세션을 시작하세요.
-
03 DeepSeek Harness는 DeepSeek의 공식 프로젝트인가요?
예. 저장소는 `deepseek-ai` GitHub 조직에서 공개하며 dsh를 DeepSeek AI가 개발한 에이전트 하네스로 설명합니다. MIT 라이선스가 적용되며 개발자 프리뷰로 명확히 표시되어 있습니다.
-
04 DeepSeek Harness로 스크린샷에서 UI를 만들 수 있나요?
선택한 프로바이더 라우트에 이미지 입력 지원이 명시된 경우에만 가능합니다. dsh의 DeepSeek 자체 chat-completions 라우트는 텍스트만 지원하며, 하네스는 텍스트 전용 라우트에서 이미지 첨부 파일을 전송하기 전에 거부합니다. 스크린샷에는 이미지 지원 프로바이더를 사용하거나 코드, DOM, 토큰, 서면 명세로 목표를 설명하세요.
-
05 DeepSeek Harness는 AGENTS.md와 스킬을 지원하나요?
예. 지침 플러그인은 AGENTS.md 및 CLAUDE.md 호환 프로젝트 파일을 로드합니다. 파일 시스템 스킬 프로바이더는 `.dsh/skills` 및 `.agents/skills`에 있는 프로젝트 스킬과 함께 설정된 사용자 및 번들 루트를 탐색합니다.
-
06 DeepSeek Harness와 DeepSeek TUI의 차이점은 무엇인가요?
서로 다른 도구입니다. DeepSeek Harness는 `dsh` 실행 파일을 사용하며, DeepSeek AI가 제공하는 공식 플러그인 우선 웹 UI 및 헤드리스 런타임입니다. DeepSeek TUI는 `deepseek` 또는 `codewhale` 디스패처를 사용하며, 현재 Open Design이 지원하는 별도의 DeepSeek 어댑터입니다.
-
07 Open Design은 DeepSeek Harness를 지원하나요?
아직 전용 공식 어댑터로는 지원하지 않습니다. 현재 Open Design은 별도의 DeepSeek TUI 어댑터를 지원합니다. 그래도 동일한 로컬 저장소에서 dsh와 함께 Open Design의 디자인 시스템, 스킬, DESIGN.md 파일, 아티팩트를 사용할 수 있습니다.
-
08 DeepSeek Harness는 API 키를 어디에 저장하나요?
공식 모델 가이드에 따르면 프로바이더 키는 `$DSH_HOME/.credentials.yaml`에 저장됩니다. 설정에는 자격 증명 참조만 유지되며, 웹 UI에는 실제 비밀 정보가 아닌 마스킹된 설명자가 전달됩니다.
DeepSeek 워크플로를 위한 디자인 계층을 구축하세요.
지금 Open Design의 로컬 디자인 시스템, 스킬, 아티팩트 워크플로를 사용하고, 다음에 어떤 에이전트 런타임을 선택하더라도 동일한 프로젝트 규약을 바로 활용할 수 있도록 준비하세요.