Electricitysheep/dsh-handbook

DeepSeek Harness (dsh) 从 0 到 1 深度手册：安装/插件开发/性能调优/实测案例/同模型多 Agent 实测对比（中文 + 英文 PDF）

이 프로젝트는 무엇인가요?

dsh-handbook(DeepSeek Harness 백서)은 DeepSeek이 2026년 8월 13일에 출시한 공식 에이전트 런타임인 DeepSeek Harness(약칭 dsh)를 위한 오픈 소스 커뮤니티 주도형 매뉴얼입니다. dsh를 AI 에이전트를 구축하기 위한 "레고 베이스"라고 생각하세요. 이는 플러그인이라는 구성 요소를 추가하거나 교체하여 AI 어시스턴트의 동작, 사용 가능한 도구, 시스템과의 상호 작용 방식을 커스터마이징할 수 있는 플러그형 기반을 제공합니다.

이 핸드북은 공식 문서의 공백을 메워줍니다. DeepSeek의 문서가 아키텍처에 중점을 둔다면, 이 프로젝트는 설치, 사용법, 플러그인 개발, 성능 튜닝, 실제 사례 연구 등 0에서 1까지의 경로를 제공하며, 모든 명령어는 실제 하드웨어에서 테스트되었습니다. 주로 중국어로 작성되었지만, 많은 챕터가 영어로도 제공됩니다.

핸드북에는 무엇이 포함되어 있나요?

이 프로젝트는 15개의 챕터 가이드(부록 포함)로 구성되어 있으며, 5단계로 나뉩니다:

1단계(1~2장): 소개 및 5분 퀵 스타트—dsh 설치, 첫 대화 실행, 두 가지 모드(웹 UI 및 헤드리스 CLI) 이해.
2단계(3~4장): profile 및 플러그인 시스템 심층 분석—플러그인 마운트 방법, 기능 확장, 처음부터 첫 플러그인 작성하기.
3단계(5~6장): 실제 시나리오 및 성능 튜닝—5가지 사례 연구, 추론 노력(reasoning-effort) 전략 및 일반적인 함정.
4단계(7~9장): 생태계 및 오케스트레이션—MCP(외부 도구 연결 프로토콜) 통합 방법, 하위 에이전트 사용, 결정론적 워크플로우 구축.
5단계(10~15장): 고급 주제—복잡한 사례 연구, 미래 전망, 솔직한 한계점, 보안 및 샌드박싱, 비용/캐시 엔지니어링 및 최종 생태계 보고서.

부록에는 용어집, 명령어 치트 시트, 그리고 동일한 모델을 사용하여 dsh와 다른 에이전트(Claude Code, Codex, OpenCode, Gemini CLI, Kimi CLI 등)를 비교한 벤치마크가 포함되어 있습니다.

이 핸드북은 누구를 위한 것인가요?

초보자: dsh를 사용해 본 적이 없는 분—3일 학습 경로를 따라가면 제로에서 작동 가능한 설정까지 완료할 수 있습니다.
개발자: 복제 가능한 플러그인 템플릿과 전체 구성 참조를 찾는 분.
평가자: 다양한 에이전트 프레임워크를 비교하는 분—핸드북에는 기능 매트릭스와 벤치마크 결과가 포함되어 있습니다.
성능 튜너: 추론 노력 수준, 캐싱 및 비용 최적화에 대해 배우고 싶은 분(핸드북 테스트에서 97%의 캐시 적중률 보고).
모든 사용자: 실제 토론, 플러그인 예제 및 커뮤니티 인사이트를 통해 dsh 생태계를 이해하고 싶은 분.

주요 기능 및 자산

README는 몇 가지 실용적인 도구를 강조합니다:

퀵 스타트: 단일 명령어 (npx -y @deepseek-ai/dsh web)로 http://127.0.0.1:3080에서 웹 UI를 실행합니다.
치트 시트 및 구성 참조—일반적인 시나리오를 위한 복사-붙여넣기 설정.
플러그인 템플릿—두 단계로 플러그인을 마운트하는 방법을 보여주는 최소한의 예제.
FAQ—5가지 일반적인 질문(예: "dsh는 모델인가요?" → 아니요, 런타임입니다).
비교 매트릭스—다른 5개 에이전트와의 비교를 통해 dsh가 오픈 소스이며, 모델에 구애받지 않고, 공식 플러그인 시스템을 갖추고 있음을 보여줍니다.
벤치마크 결과: 동일한 모델을 사용한 5개 작업 테스트에서 dsh는 130초 만에 작업을 완료했습니다(omp는 70초, opencode는 172초). 모두 45/45 정답률을 달성했습니다.

핸드북 사용 방법

온라인 읽기: https://electricitysheep.github.io/dsh-handbook/
PDF 다운로드: 중국어 및 영어 전체 버전은 Releases section에서 이용 가능합니다.
읽기 시작: 3일 학습 경로 또는 5분 퀵 스타트로 이동하세요.

커뮤니티 및 기여

이 핸드북은 살아있는 문서입니다. GitHub에서 280개 이상의 별을 받았고, 공식 토론에서 195개 이상의 답변이 달렸으며, 커뮤니티 Q&A를 통합하기 위한 피드백 파이프라인이 진행 중입니다. 실제 사례를 실행했다면 포함을 위해 제출할 수 있습니다(출처 표기). 또한 추천 커뮤니티 플러그인(git 패널, 메모리 엔진, 비용 추적기 등) 목록을 관리하고 다른 생태계 프로젝트와 적극적으로 연결하고 있습니다.

라이선스

콘텐츠는 CC BY-NC-SA 4.0을 따르며, 예제 코드는 MIT 라이선스입니다.

이 설명은 프로젝트의 README에서 제공된 정보만을 바탕으로 작성되었습니다.