읽기 안내
Nonead DSH Desktop 사용자 매뉴얼
이 책은 일반 사용자를 위한 사용 설명서입니다. 코드를 쓸 줄 몰라도 되고, Node.js나 pnpm 같은 개발 도구를 미리 설치할 필요도 없습니다. 설치 패키지에 실행 환경이 모두 들어 있어 설치 후 바로 사용할 수 있습니다.
이 책의 안내
열세 개의 절은 「설치 → 사용 → 문제 해결」 순서로 배치했습니다. 특정 문제만 해결하고 싶다면 열두 번째 절로 바로 가면 됩니다.
- 1 · 무엇인가 — 세 계층 구조이고, 일상에서는 맨 위 계층만 다룹니다.
- 2 · 설치 — 세 플랫폼에서 어떤 패키지를 받고 어떻게 설치하는지.
- 3 · 처음 실행 — 다섯 단계 마법사, 그리고 「닫기는 종료가 아니다」.
- 4 · 메인 화면 한눈에 — 네 영역이 각각 무엇을 맡는지.
- 5 · 첫 대화 — 요구 사항을 분명히 전달하는 방법.
- 6 · 트레이 메뉴 — 여섯 개의 시스템 수준 진입점.
- 7 · 설정 페이지 — 다섯 구역에서 무엇을 바꿀 수 있는지.
- 8 · Profile — 여러 설정을 전환하는 방법과 실패 시 되돌리기.
- 9 · 플러그인과 플러그인 마켓 — 두 가지 설치 경로와 「설치 후 재시작」.
- 10 · 설치된 플러그인 목록 — 이 PC의 35개 플러그인을 하나씩 용도와 사용법으로 설명.
- 11 · 업데이트 — 다섯 단계와 다시 쓸 수 있는 네 가지 조작.
- 12 · 문제가 생겼을 때 — 흔한 증상 대조표와 진단 내보내기.
- 13 · 데이터와 도움말 — 파일 위치와 더 많은 문서로 가는 입구.
1. 무엇인가
한 줄로: DeepSeek Harness의 에이전트 능력을 데스크톱 앱에 담았습니다. 아이콘을 두 번 클릭하면 대화를 시작하고, 파일을 읽고 쓰게 하며, 명령을 실행하고, 도구를 호출할 수 있습니다.
제품 전체는 세 계층으로 이루어져 있습니다. 사용자는 세 번째 계층만 다루면 되고, 앞의 두 계층은 백그라운드에서 자동으로 동작합니다.
2. 설치
제품 다운로드 페이지에서 해당 플랫폼의 설치 패키지를 받아 두 번 클릭하면 됩니다. 설치 패키지에는 Electron, Node.js, pnpm과 고정 버전의 DSH 런타임이 이미 포함되어 있어 별도의 환경 설치가 필요 없습니다. 이 버전에 포함된 것은 Electron 44.0.0, Node.js 24.21.0, pnpm 11.8.0, Python 3.12.14, 그리고 DSH 런타임 0.2.2-rc.1입니다.
| 플랫폼 | 받는 파일 | 설치 방법 |
|---|---|---|
| Windows x64 | .exe 설치 프로그램 | 두 번 클릭해 실행하고 안내에 따라 다음으로 진행 |
| macOS (Intel / Apple 칩 공용) | .dmg 디스크 이미지 | 열어서 아이콘을 「응용 프로그램」으로 드래그 |
| Linux x64 | .AppImage | 먼저 chmod +x로 실행 권한을 준 뒤 두 번 클릭하거나 명령줄에서 실행 |
참고: Windows ARM64는 현재 실험적 빌드이며, 내장된 Python / Node 런타임이 여전히 x64 페이로드라 ARM 기기에서 완전한 검증을 마치지 않았습니다. 일반 사용자는 x64 버전을 권장합니다.
3. 처음 실행
처음 실행하면 기본 설정이 자동으로 준비되고 이 PC에서 인터페이스 서비스가 시작됩니다. 먼저 마법사가 나타납니다:
- 환영 페이지 — 제품의 기본 방향을 소개합니다.
- 플러그인 마켓 — 커뮤니티 플러그인 마켓을 켤지 정합니다. 「사용 안 함」을 골라도 기억되므로 이후에 반복해서 묻지 않습니다.
- 원격 제어 — 휴대폰 등 다른 기기가 이 PC의 데스크톱에 접속하는 것을 허용할지 정합니다.
- Computer Use — 마우스와 키보드를 조작하도록 허용할지 정합니다.
- 복구 모드 — 문제가 생겼을 때 쓰는 「안전망」의 사용법을 소개합니다.
4. 메인 화면 한눈에
메인 창의 구조는 단순합니다. 위에서 아래로, 왼쪽에서 오른쪽으로 네 영역뿐입니다.
| 영역 | 역할 |
|---|---|
| 데스크톱 프레임 | 맨 위의 36픽셀 어두운 띠. 빈 곳을 잡고 창을 움직일 수 있고, 위의 아이콘은 바로 클릭할 수 있습니다. |
| 사이드바 | 대화 목록, 워크스페이스와 파일 진입점, 플러그인 진입점. 대화는 언제든 전환할 수 있고 기록은 그대로 남습니다. |
| 대화 내용 영역 | 입력한 내용, 응답, 도구 실행 결과가 모두 여기에 표시됩니다. |
| 입력창 | 요청을 적는 곳. 구체적일수록 결과가 원하는 것에 가까워집니다. |
5. 첫 대화 시작하기
- 입력창에 원하는 것을 한국어로 분명하게 적으세요. 예: 「이 디렉터리의 모든 png를 원본 크기 그대로 webp로 변환해 줘」.
- Enter로 전송합니다. 먼저 이해하고 계획을 세운 뒤 필요하면 도구를 호출합니다.
- 쓰기, 삭제, 명령 실행처럼 위험이 있는 작업은 네이티브 확인 창이 뜨고, 직접 동의하거나 거부합니다.
- 결과는 대화에 표시됩니다. 마음에 들지 않으면 「……로 바꿔 줘」라고 말하면 되고, 처음부터 다시 시작할 필요가 없습니다.
6. 트레이 메뉴
대부분의 시스템 수준 조작은 트레이 아이콘에 모여 있습니다. 트레이 아이콘을 마우스 오른쪽 버튼으로 누르면 다음 항목이 나타납니다:
- 설정 열기 — 데스크톱 설정 페이지로 들어갑니다.
- 업데이트 확인 — 새 버전을 직접 확인합니다. 이미 최신이어도 결과를 알려 줍니다.
- Profile 전환 — 여러 설정 사이를 전환합니다(8절 참고).
- 복구 도우미 — 시작이 비정상일 때 마지막으로 정상 동작한 설정으로 되돌립니다.
- DSH 터미널 열기 — 환경 변수가 이미 설정된 터미널을 엽니다.
- 종료 — 앱을 실제로 닫습니다.
7. 설정 페이지
설정 페이지는 기능에 따라 다섯 구역으로 나뉘며 왼쪽에서 오른쪽 순서입니다:
| 구역 | 여기서 할 수 있는 일 |
|---|---|
| 일반 | 부팅 시 자동 시작, 인터페이스 언어, 로컬 웹 포트, 업데이트 카드(「업데이트 설명」과 수동 확인 포함). |
| Profile | 설정 프로필 조회와 새로 만들기, 현재 사용하는 Profile 전환. |
| 도구 | DSH 터미널 열기, 일반 재시작, 복구 모드로 재시작. |
| 복구 | 정상 스냅숏 목록과 롤백. 롤백 전에 항상 현재 상태를 스냅숏으로 남깁니다. |
| 권한 | Computer Use 등 시스템 권한 관리. |
8. Profile: 여러 설정
Profile은 「독립된 설정 프로필 하나」로 이해하면 됩니다. 플러그인 조합, 패치, 설정이 각각 다릅니다. 여러 개를 준비해 두고 상황에 따라 전환할 수 있으며 서로 간섭하지 않습니다.
세 가지만 기억하세요:
- Profile 전환은 앱을 재시작합니다. 설계상 그렇고, 멈춘 것이 아닙니다.
- 서로 다른 Profile 사이에 플러그인이 자동으로 복사되지 않습니다. 다른 플러그인 조합이 필요하면 터미널에서 직접 설치하세요.
- 대부분의 경우 모든 Profile이 같은 세션과 설정 데이터를 공유하므로, 전환해도 기록이 남아 있습니다.
9. 플러그인과 플러그인 마켓
플러그인은 이 도우미에 능력을 더하는 방법입니다. 모델, 도구, 화면 패널, 자동화 흐름을 추가할 수 있습니다. 공식 플러그인은 바로 설치할 수 있고, 여러 플러그인을 동시에 적용할 수 있습니다.
설치 경로는 두 가지입니다:
- 플러그인 마켓 — 화면에서 둘러보고 이름으로 검색해 설치를 누릅니다. 마켓과 데스크톱은 같은 조합 안에서 상호 배타적으로 동작하므로 충돌하지 않습니다.
- 명령줄 — 트레이에서 연 DSH 터미널에서
dsh plugin add <플러그인 이름>을 실행하고,remove로 제거,update로 업그레이드합니다.
10. 설치된 플러그인 35개의 사용법
이 절은 현재 desktop 설정 프로필에 실제로 설치된 35개 플러그인을 하나씩 소개합니다. 이름과 버전은 이 PC의 설정 프로필에서 실측 수집했습니다(스냅숏 날짜 2026-11-08). 용도에 따라 일곱 그룹으로 나누고, 각 그룹마다 한 줄 개요를 먼저 제시한 뒤 어떤 일을 하고 언제 쓰이는지 설명합니다.
이들은 서로 따로 떨어져 있지 않고, 실제 사용에서는 「맥락을 기억하는 것」에서 「결과를 인도하는 것」까지 하나의 흐름을 이룹니다:
dsh plugin add <플러그인 이름>, 제거는 remove, 업그레이드는 update입니다. 어떤 변경이든 후에는 앱을 재시작해야 합니다. 명령은 기본적으로 현재 활성화된 Profile에 적용되며, 지정하려면 --profile <이름>을 붙입니다.
첫 번째 그룹 · 기억과 맥락 (5개)
이 그룹은 「지난번에 무슨 말을 했는지 기억하지 못한다」는 문제를 해결합니다.
@a9i5k4/dsh-auto-memory3.3.17능동형 연상 기억: 모델이 말을 꺼내기 전에 관련 기억을 먼저 자동 소환하고, 세 계층으로 자동 정리하며, 반복하는 절차를 스킬로 고정할 수도 있습니다.
사용법: 별도 조작이 필요 없습니다. 무엇을 소환할지 스스로 판단합니다. 오래된 기억을 정리하게 하려면 「최근 경험을 정리해 줘」라고 말하세요.
@yolk_vat-y/dsh-project-memory0.6.11문서(PDF / Markdown / 텍스트)와 코드 심볼을 워크스페이스마다 독립적이고 검색 가능한 라이브러리로 색인하고, 소환할 때 출처 인용을 함께 제시합니다.
사용법: 프로젝트에 들어가면 먼저 한 번 색인하게 하고, 이후 「이 프로젝트에서 XX는 어떻게 구현됐어?」라고 물으면 파일 출처와 함께 답합니다.
dsh-context0.82.1현재 맥락이 무엇으로 구성되고 얼마나 차지하는지 보여 주고, 그에 맞춰 간소화해 대화가 길어질수록 느려지는 일을 막습니다.
사용법: 대화가 느려지거나 맥락이 너무 길다는 알림이 뜨면 그 패널을 열어 구성을 보고, 필요 없는 기록을 잘라내세요.
dsh-nonead-prompt-recall0.8.7입력창이 비어 있을 때 ↑를 누르면 직전 입력이 나오고, 다시 누르면 계속 앞으로 갑니다. ↓로는 뒤로 돌아옵니다. 기록은 워크스페이스별로 따로 저장되어 재시작 후에도 남습니다. 모델 선택기 옆에는 다시 쓰기 버튼도 있는데, 현재 모델로 쓰다 만 프롬프트를 다시 써 주며 @ 참조는 유지됩니다.
사용법: 방금 쓴 긴 프롬프트를 다시 쓰고 싶을 때 빈 입력창에서 ↑만 누르면 됩니다.
dsh-nonead-prompt-rewind0.5.4창 안에서 대화를 이전 어느 시점으로 되돌리고, 동시에 워크스페이스 파일까지 함께 복원할 수 있습니다.
사용법: 방향을 잘못 잡아 「세 단계 전으로 돌아가 다시 하자」고 할 때 쓰면 새 세션을 여는 것보다 간편합니다.
두 번째 그룹 · 스킬과 전문가 (8개)
이 그룹은 「구체적인 작업을 만났을 때 전문적인 절차대로 하게 하려면」이라는 문제를 해결합니다.
@michengai/dsh-skills-manager1.2.35이 PC의 Agent Skills를 통합 로드하고 안전하게 관리해, 여러 출처의 스킬이 서로 덮어쓰는 일을 막습니다.
사용법: 새 스킬을 설치한 뒤 여기서 올바르게 로드되었는지, 출처가 분명한지 확인하고 나서 활성화할 것을 정하세요.
@weibaohui/skills-management0.9.3한 페이지에서 이 PC의 모든 코딩 도우미(Claude, Codex, ZCode 등 십여 종) 스킬을 관리하고, 클릭 한 번으로 DSH에 편입할 수 있습니다. 6600+ 스킬 마켓이 내장되어 있고 주입 비용 기준 정렬을 지원합니다.
사용법: 어떤 능력에 쓸 만한 스킬을 찾을 때 여기서 먼저 검색하세요. 설치 전에 토큰 비용을 보고, 한 번에 너무 많이 설치하지 마세요.
@linxin666/dsh-client-ui-skill-explorer0.4.15출처(내장 / 프로젝트 / 사용자 / 사용자 정의 / 런타임)별로 로드된 스킬을 둘러보고, 활성화·비활성화·생성·삭제를 할 수 있습니다.
사용법: 어떤 스킬이 동작하지 않는 것 같을 때 여기서 어느 계층에 속하는지, 비활성화되지는 않았는지 먼저 확인하세요.
@wenaixi/dsh-superpower8.0.0obra/superpowers의 엔지니어링 스킬 15개(요구 사항 명확화, TDD, 체계적 디버깅, 코드 리뷰 등)를 묶음으로 제공하며, 한국어·영어 설명과 개별 on/off를 지원합니다.
사용법: 개발 작업에서는 이 절차를 우선 따르게 하세요. 필요 없는 개별 스킬은 꺼서 방해를 줄일 수 있습니다.
@michengai/dsh-agency-agents1.2.26소환 가능한 전문 에이전트 331명이 22개 분야의 역할을 담당하며, 필요할 때 전문가 한 명을 부르거나 팀을 구성할 수 있습니다.
사용법: 전문적 관점이 필요한 문제라면 「XX 전문가에게 보게 해 줘」라고 하면 됩니다. 복잡한 작업은 팀을 구성해 병렬로 처리할 수 있습니다.
dsh-github-skills0.2.1OpenAI Codex의 GitHub 워크플로 의미를 이식했습니다. PR 보기, 리뷰 의견 처리, CI 확인, 배포 등.
사용법: 저장소에서 「이 PR의 리뷰 의견 좀 봐 줘」 또는 「CI가 왜 깨졌어?」라고 하면 해당 절차를 따릅니다.
@tt-a1i/archify-dsh1.0.0요구 사항이나 코드 구조를 상호작용 가능한 아키텍처 다이어그램, 순서도, 시퀀스 다이어그램으로 그려 독립 HTML로 출력하며, 다크 모드와 내보내기를 지원합니다.
사용법: 「이 시스템 아키텍처를 그려 줘」라고 하면 코드를 먼저 읽고 그립니다. 허공에서 구성하지 않습니다.
dsh-ppt-master6.1.0AI 기반 프레젠테이션 워크플로: 편집 가능한 PPTX 생성, 페이지 스냅숏, 네이티브 템플릿 채우기.
사용법: 주제와 요점을 주거나 기존 문서를 바탕으로 만들게 하세요. 레이아웃을 바꾸려면 「네이티브 템플릿으로 바꿔 줘」라고 하면 됩니다.
세 번째 그룹 · 인터페이스와 효율 (8개)
이 그룹은 「매일 보는 화면」과 「얼마나 드는지」를 개선합니다.
dsh-better-sidebar0.30.1파일 트리, 편집기, 변경 사항, 작업, 사이드 채팅을 한 열에 모으고 세션마다 서로 간섭하지 않게 합니다. 또한 다른 플러그인이 자기 탭과 파일 뷰어를 이 사이드바에 붙일 수 있도록 서비스를 제공합니다. 열두 번째 절의 「오른쪽 패널이 계속 4xx를 낸다」는 바로 어떤 플러그인이 이 서비스를 받지 못한 경우입니다.
사용법: 코드를 고칠 때 창을 오갈 필요 없이 오른쪽에서 파일과 diff를 보고 사이드 채팅을 열 수 있습니다.
@linxin666/dsh-client-ui-task-board0.4.15Host가 권위를 가진 작업 보드: 카드가 실제로 실행되고, cron 예약과 크로스 플랫폼 절전 보호를 지원합니다.
사용법: 할 일을 카드로 나눠 보드에 배치하면 순서나 시간에 따라 자동으로 실행됩니다.
@linxin666/dsh-client-ui-git-graph0.4.14빈 세션에서의 브랜치 선택기와 Git 관계도. 실제 Host 측 git 조작과 안전 검사를 갖추고 있습니다.
사용법: 새 세션을 열기 전에 그래프에서 브랜치 관계를 확인해 잘못된 브랜치에서 작업하는 일을 피하세요.
@changfenhuang/dsh-genui0.15.0응답 안에서 상호작용 가능한 컴포넌트를 직접 렌더링합니다. 레이아웃, 차트, 함수 그래프, 폼, 퀴즈 등.
사용법: 차트나 비교표가 필요하면 「표/차트로 보여 줘」라고 하면 조작 가능한 패널로 렌더링합니다.
dsh-notify-say0.5.3데스크톱 알림을 실제로 읽어 줍니다. Windows 내장 TTS는 별도 다운로드 없이 바로 쓸 수 있고, VOICEVOX 음색을 고를 수 있으며 시스템 효과음으로 대체할 수도 있습니다. 또 파견한 서브에이전트가 모두 끝난 뒤에야 「이번 라운드 완료」를 읽습니다.
사용법: 긴 작업을 돌려 두고 다른 일을 하다가 완료되면 소리로 알려 줍니다. 설정에서 음색을 바꿀 수 있습니다.
dsh-cost-meter1.9.58이 세션과 당일 비용을 집계하고, 170개 이상의 모델 가격 목록을 내장해 자동으로 매칭합니다. 16개 Coding Plan의 구독 한도와 사용자 정의 Provider의 잔액(임의 HTTP 엔드포인트 지정)도 조회해 진행 막대로 보여 줍니다.
사용법: 긴 작업 전에 당일 지출을 확인하고, 모델을 바꿀 때 단가를 비교해 비싼 모델로 싼 일을 하는 것을 피하세요.
@michengai/dsh-archive-manager1.2.8세션을 보관, 복원, 즐겨찾기, 영구 삭제하고 손상된 세션 로그를 진단합니다.
사용법: 세션 목록이 너무 길면 오래된 것을 보관하세요. 어떤 세션이 열리지 않으면 먼저 이것으로 로그를 진단하세요.
dsh-client-auto-continue0.17.4네트워크 오류 등 사람의 의사가 아닌 이유로 세션이 중단되면 계속 프롬프트를 자동으로 보내 대화를 이어 줍니다. 엔진이 호스트 프로세스에서 돌기 때문에 브라우저 탭을 닫아도 계속 동작합니다. 기본값은 「중단 복구」만이며, 끝난 뒤에도 이어서 하게 하는 자율 루프는 설정에서 직접 켜야 합니다.
사용법: 네트워크가 불안정하거나 긴 작업을 돌릴 때 켜 두면 돌아왔을 때 대화가 이미 이어져 있습니다. 한 라운드씩 스스로 계속하게 하려면 자율 루프를 따로 켜세요.
네 번째 그룹 · 협업과 개발 (8개)
이 그룹은 「도우미 하나」를 「팀 하나」로 바꿉니다.
@deepseek-ai/dsh-tool-subagent0.2.2-rc.1모델을 위한 서브에이전트 위임 도구: 독립적인 하위 작업을 다른 에이전트에게 넘겨 현재 대화의 맥락을 차지하지 않게 합니다.
사용법: 작업을 서로 의존하지 않는 여러 조각으로 나눌 수 있으면 병렬로 분배하고, 주 대화는 결론만 받습니다.
@deepseek-ai/dsh-subagent-claude-code0.2.2-rc.1공식 Agent SDK 기반의 일회성 Claude Code 서브에이전트로, 작업을 맡겨 끝낸 뒤 결과를 받습니다.
사용법: Claude Code의 그런 능력(대규모 코드 수정, 테스트 실행)이 필요할 때 이름을 지정해 쓰세요.
@deepseek-ai/dsh-subagent-codex0.2.2-rc.1공식 app-server 프로토콜 기반의 일회성 Codex 서브에이전트.
사용법: 어떤 구현을 Codex가 독립적으로 끝내게 하고 싶을 때 쓰며, Claude Code 서브에이전트와 함께 쓸 수 있습니다.
@michengai/dsh-code-review1.0.8Codex 스타일 코드 리뷰: 독립 네이티브 서브 Agent, 선택 가능한 검토 범위, 한국어·영어 보고서.
사용법: 커밋 전에 「이번 변경 사항을 검토해 줘」라고 하면 diff, 관련 코드, 미커밋 파일로 범위를 나눠 검사합니다.
dsh-superagent0.1.0단일 GitHub 저장소를 위한 능동형 에이전트: GitHub(선택적으로 Feishu)를 지켜보며 규칙에 따라 요청을 평가합니다.
사용법: issue / PR을 대신 지켜보게 하려면 활성화하세요. 먼저 어떤 저장소에 작용하고 어떤 트리거 규칙을 쓰는지 확인하세요.
dsh-find-plugins0.3.0다섯 개 커뮤니티 카탈로그와 실시간 GitHub / npm 검색으로 플러그인을 찾고, 관련성 × 신뢰도 × 최신성 × 인기도로 정렬합니다.
사용법: 기능을 추가하고 싶을 때 마켓을 직접 뒤지는 것보다 「그런 플러그인 있어?」라고 묻는 편이 정확합니다.
dshmarket1.73.14화면 안의 시각적 플러그인 마켓: 둘러보기, 검색, 클릭 한 번 설치.
사용법: 설정 페이지에서 마켓을 열어 찾은 뒤 설치를 누르세요. 설치 후 재시작해야 적용됩니다.
dsh-mcp-connector0.2.94기업, 금융, 법률, 특허, 연구 등의 데이터 소스에 연결하는 MCP 마켓으로, 권한 부여·검색·호출을 관리합니다.
사용법: 외부 데이터가 필요하면 여기서 커넥터를 찾아 권한을 부여하세요. 호출 전에 어떤 권한을 요구하는지 확인하세요.
다섯 번째 그룹 · 로봇 제어 (2개, Suzhou Nonead 자체 개발)
이 그룹은 DSH가 자연어로 Universal Robots 로봇 팔을 직접 구동하게 합니다.
dsh-nonead-universal-robots0.8.6자연어로 UR 로봇 팔을 제어합니다. 상태 읽기, 관절 이동, 직선 이동, 힘 제어, I/O와 레지스터, 컨베이어 추적 등이며 자체 개발한 nUR MCP Server와 같은 계보의 로직을 씁니다.
사용법: 먼저 「192.168.x.x에 연결해 줘」라고 한 뒤 동작을 지시하세요. 운동과 관련된 명령은 기본적으로 승인 게이트의 적용을 받아 하나씩 확인해야 합니다.
dsh-nonead-ursim0.3.14같은 로직의 오프라인 시뮬레이션 버전: 실제 로봇 없이 가상 UR 로봇 팔을 구동해 궤적을 검증합니다.
사용법: 시뮬레이션에서 동작을 먼저 돌려 충돌이 없는지 확인한 뒤 실기에 적용하세요. 시뮬레이션은 운동학만 다루며 힘 제어와 I/O에는 의미가 없습니다.
여섯 번째 그룹 · 이미지와 미디어 (3개)
이 그룹은 결과를 바로 인도할 수 있는 형태로 만듭니다. 이미지, 영상, 문서.
dsh-image-gen0.10.3ChatGPT식 이미지 생성을 DSH로 가져옵니다. Gemini, OpenAI, Seedream, DashScope를 지원하고 이 PC의 ComfyUI 워크플로도 쓸 수 있습니다. 스케치를 그리고 참조 이미지를 고를 수 있는 워크벤치 캔버스가 함께 있습니다.
사용법: 「한 장 그려 줘……」라고 하면 이미지를 만들어 대화에 바로 붙입니다. 기존 이미지를 고치려면 「이걸 ……로 바꿔 줘」라고 하세요. 공급자나 모델을 바꾸려면 분명히 말해야 하며, 기본값은 설정에 구성된 것을 씁니다.
dsh-remotion0.10.5공식 Remotion 스킬 + 프로젝트 검색, 템플릿, 소재 정렬, Studio 미리보기, MP4 내보내기.
사용법: 영상이나 오프닝을 만들 때 활성화하세요. 템플릿을 먼저 보고 고치는 편이 컴포넌트를 처음부터 쓰는 것보다 빠릅니다. 처음 환경을 준비할 때 의존성을 내려받으므로 네트워크가 필요합니다.
dsh-univer-office0.4.0DSH와 Univer 통합: 문서 인라인 미리보기, 플로팅 Worktree 창, 세션 종료 시 리뷰 동작.
사용법: 표 / 문서 / 발표 자료를 만들게 하면 결과가 패널에서 바로 미리보기되므로 내려받아 확인할 필요가 없습니다.
일곱 번째 그룹 · 시스템 유지보수 (1개)
dsh-config-manager0.4.3DSH 설정 전체를 백업, 복원, 내보내기, 가져오기, 이전, 동기화합니다. 설정, 플러그인, MCP, 스킬, 에이전트 프리셋 등.
사용법: 설정을 크게 바꾸기 전에 한 번 내보내 두세요. 기기를 옮길 때는 가져오기로 복원하는 편이 항목별로 다시 설정하는 것보다 훨씬 빠릅니다.
profiles/desktop/package.json에 있는 dependencies를 직접 보세요.
전부 한꺼번에 켜는 것도 권장하지 않습니다. 플러그인이 많을수록 맥락과 시작 비용이 커집니다. 앞서 말한 「스킬 마켓」에서 각 스킬의 주입 비용을 볼 수 있으니 설치 전에 가늠해 보세요. 당장 쓰지 않는 것은 비활성화해 두었다가 필요할 때 켜면 됩니다.
11. 업데이트
앱은 백그라운드에서 조용히 새 버전을 확인하며 사용자를 방해하지 않습니다. 새 버전을 찾으면 트레이에만 알리고 스스로 팝업을 띄우지 않습니다.
몇 가지 유용한 스위치:
| 조작 | 효과 |
|---|---|
| 이 버전 건너뛰기 | 해당 버전은 이후 알리지 않습니다. 재시작 후에도 유효합니다 |
| 건너뛰기 해제 | 건너뛰기 기록을 지워 해당 버전이 다시 알림 대상이 됩니다 |
| 설치 재시도 | 이미 받은 설치 패키지를 재사용하며 다시 받지 않습니다 |
| 설치 후 재시작 | 준비되면 바로 설치하고 재시작합니다 |
12. 문제가 생겼을 때
먼저 아래 표와 대조해 보세요. 대부분의 문제는 스스로 해결할 수 있습니다.
| 증상 | 대처 방법 |
|---|---|
| 창이 사라졌다 | 시스템 트레이를 보세요. 창을 닫는 것은 숨기는 것이지 종료가 아닙니다. |
| 눌러도 반응이 없다 / 계속 돌기만 한다 | 잠시 기다려 보세요. 그래도 응답이 없으면 트레이 메뉴에서 재시작하거나 「복구 모드로 재시작」을 쓰세요. |
| 시작하자마자 죽는다, 들어갈 수 없다 | 「복구 도우미」로 마지막으로 정상 동작한 설정으로 되돌리세요. 롤백 전에 현재 상태를 자동으로 백업하므로 롤백 자체도 다시 롤백할 수 있습니다. |
| 플러그인을 설치했는데 적용되지 않는다 | 명령이 올바른 Profile에 적용되었는지 확인하고 앱을 재시작하세요. |
| 이미지를 만들라고 했는데 나오지 않는다 | 이미지 생성은 설정에서 이미지 공급자(API 자격 증명 또는 로그인된 구독 계정)를 먼저 구성해야 합니다. 구성 전에는 사용 가능한 공급자가 없다고만 알려 줍니다. |
| 터미널에서 명령을 찾을 수 없다 | 트레이에서 「DSH 터미널」을 다시 여세요. 데스크톱 앱은 시스템 PATH를 수정하지 않습니다. |
| 오른쪽 「파일」 등 패널이 계속 4xx를 낸다 | 보통 어떤 플러그인이 의존 서비스를 받지 못해 멈춘 경우입니다. 데이터 디렉터리의 logs/에서 pending (waiting for service:를 검색하고, 해당 플러그인을 비활성화한 뒤 재시작하세요. |
| 업데이트 알림을 받지 못했다 | 백그라운드 확인은 조용히 이루어집니다. 트레이나 설정의 「업데이트 확인」으로 직접 결과를 보세요. |
진단 정보 내보내기
문제를 유지보수 담당자에게 알려야 한다면 트레이 아이콘을 마우스 오른쪽 버튼으로 눌러 진단 패키지를 내보낼 수 있습니다. 최근 로그를 모으고, 로그에 있는 식별 가능한 자격 증명은 마스킹됩니다. 다만 로컬 경로, 워크스페이스 이름, 세션 ID는 남을 수 있으니 공개 업로드 전에 내용을 직접 한 번 확인하세요.
13. 데이터는 어디에, 도움은 어디서
| 내용 | 위치 |
|---|---|
| 데이터 디렉터리 (세션 / 설정 / 로그) | 기본값 ~/.dsh, Windows에서는 %USERPROFILE%\.dsh |
| 로그 | 데이터 디렉터리의 logs/ |
| 창 위치와 크기 | 앱 데이터 디렉터리의 window-state.json |
| 데스크톱 설정 (포트 포함) | 데이터 디렉터리의 desktop-preferences.json |
| 환경 변수 덮어쓰기 | 앱 데이터 디렉터리의 .env (엄격한 KEY=VALUE, 실제 환경 변수는 덮어쓰지 않음) |
더 많은 문서
- 더 짧은 시작 안내 —
docs/user-guide.md - 자주 묻는 질문(플랫폼 차이, 사용 경계) —
docs/faq.md - 왜 데스크톱 버전을 만들었는가 —
docs/why-desktop.md - 아키텍처 설명 —
docs/architecture.md - 플러그인 개발과 생태계 —
docs/plugin-development.md,docs/plugin-ecosystem.md
감사의 글
이 책이 나올 수 있었던 것은 두 층의 사람들 덕분입니다.
DeepSeek과 DeepSeek Harness 업스트림 팀 — 이 제품은 수정하지 않은 업스트림 위에 서 있습니다. 에이전트 루프, 도구 호출, 플러그인 호스트, 웹 인터페이스가 모두 업스트림에서 왔고, 업스트림의 공개 코드와 문서가 이 매뉴얼의 기술적 원본입니다.
35개 플러그인의 저자들 — 열 번째 장에서 하나씩 소개한 플러그인은 대부분 커뮤니티가 독립적으로 개발하고 유지합니다. 저장소 귀속 기준으로 묶으면 각자의 GitHub 계정 또는 조직은 다음과 같습니다:
Aik358·omdsh-dev·zhu1090093659·MichengAI·Wenaixi·weibaohui·tt-a1i·00080000·HsiangNianian·xiajiajun516·bowenliang123·Han-1413141·Eray114514·Starfie1d1272·shanliuling·duhu2000·unifilitence·pn1024·STARDUSTLC666·DreamNum / Univer·dsh-market·DeepSeek Harness Team·NoneadChina
설치 패키지 자체도 오픈 소스 프로젝트의 어깨 위에 서 있습니다. Electron, electron-builder, pnpm, Node.js와 Python 런타임, 그리고 업스트림 의존성 트리의 수많은 저자들입니다. 명단에 빠진 곳이 있거나 표기가 잘못되었다면 저장소에 issue로 알려 주세요.
회사 정식 명칭: Suzhou Nonead Robot Technology Co., Ltd.
주소: 4F, Unit 9-10, Building B, Tengfei Xinsu Fang, No. 5 Xinghan Street, Suzhou Industrial Park, Jiangsu, China
웹사이트: https://www.nonead.com
전화: 0086-0512-67263000
이메일: service@nonead.com
