읽기 안내

Nonead DSH Desktop 사용자 매뉴얼

이 책은 일반 사용자를 위한 사용 설명서입니다. 코드를 쓸 줄 몰라도 되고, Node.js나 pnpm 같은 개발 도구를 미리 설치할 필요도 없습니다. 설치 패키지에 실행 환경이 모두 들어 있어 설치 후 바로 사용할 수 있습니다.

대상 독자: 이 제품을 처음 접하는 사용자
읽는 순서: 장 순서대로 읽거나, 필요한 절로 바로 이동

이 책의 안내

열세 개의 절은 「설치 → 사용 → 문제 해결」 순서로 배치했습니다. 특정 문제만 해결하고 싶다면 열두 번째 절로 바로 가면 됩니다.

1. 무엇인가

한 줄로: DeepSeek Harness의 에이전트 능력을 데스크톱 앱에 담았습니다. 아이콘을 두 번 클릭하면 대화를 시작하고, 파일을 읽고 쓰게 하며, 명령을 실행하고, 도구를 호출할 수 있습니다.

제품 전체는 세 계층으로 이루어져 있습니다. 사용자는 세 번째 계층만 다루면 되고, 앞의 두 계층은 백그라운드에서 자동으로 동작합니다.

데스크톱 셸 창 · 트레이 · 업데이트 · 터미널 · 다중 설정 Host (백그라운드 서비스) 플러그인 로드, 도구 실행, 세션과 파일 관리 웹 인터페이스 (보이는 창 내용) 대화 · 입력창 · 사이드바 · 설정
그림 1 제품은 세 계층으로 이루어지며, 일상 조작은 맨 위 계층에서만 일어납니다.
웹 버전과 무엇이 다른가요? 웹 버전은 채팅만 됩니다. 데스크톱 버전은 컴퓨터 전체를 맡깁니다. 파일 읽기, 명령 실행, 플러그인 설치, 작업 디렉터리 연결까지 모두 이 PC 안에서 이루어지고 데이터는 밖으로 나가지 않습니다.

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로 실행 권한을 준 뒤 두 번 클릭하거나 명령줄에서 실행
표 1 세 플랫폼의 설치 방식. Linux에서 FUSE가 없다는 메시지가 나오면 --appimage-extract-and-run으로 실행할 수 있습니다.

참고: Windows ARM64는 현재 실험적 빌드이며, 내장된 Python / Node 런타임이 여전히 x64 페이로드라 ARM 기기에서 완전한 검증을 마치지 않았습니다. 일반 사용자는 x64 버전을 권장합니다.

3. 처음 실행

처음 실행하면 기본 설정이 자동으로 준비되고 이 PC에서 인터페이스 서비스가 시작됩니다. 먼저 마법사가 나타납니다:

  1. 환영 페이지 — 제품의 기본 방향을 소개합니다.
  2. 플러그인 마켓 — 커뮤니티 플러그인 마켓을 켤지 정합니다. 「사용 안 함」을 골라도 기억되므로 이후에 반복해서 묻지 않습니다.
  3. 원격 제어 — 휴대폰 등 다른 기기가 이 PC의 데스크톱에 접속하는 것을 허용할지 정합니다.
  4. Computer Use — 마우스와 키보드를 조작하도록 허용할지 정합니다.
  5. 복구 모드 — 문제가 생겼을 때 쓰는 「안전망」의 사용법을 소개합니다.
주의: 창을 닫는 것은 종료가 아닙니다. 창 오른쪽 위의 닫기 버튼을 누르면 앱이 시스템 트레이로 내려가 계속 실행됩니다. 완전히 종료하려면 트레이 아이콘을 마우스 오른쪽 버튼으로 눌러 「종료」를 선택하세요.

4. 메인 화면 한눈에

메인 창의 구조는 단순합니다. 위에서 아래로, 왼쪽에서 오른쪽으로 네 영역뿐입니다.

① 데스크톱 프레임 (36px, 창 이동 가능) ② 사이드바 대화 1 대화 2 대화 3 워크스페이스 / 파일 / 플러그인 ③ 대화 내용 영역 나: 이 폴더의 이미지를 모두 webp로 변환해 줘 도우미: 이미지 12장을 찾았습니다. 모두 변환할까요? (쓰기 작업은 먼저 확인을 요청합니다) ④ 입력창 여기에 요청을 적고 Enter로 전송하세요
그림 2 메인 화면의 네 영역: ① 데스크톱 프레임 ② 사이드바 ③ 대화 내용 영역 ④ 입력창.
영역역할
데스크톱 프레임맨 위의 36픽셀 어두운 띠. 빈 곳을 잡고 창을 움직일 수 있고, 위의 아이콘은 바로 클릭할 수 있습니다.
사이드바대화 목록, 워크스페이스와 파일 진입점, 플러그인 진입점. 대화는 언제든 전환할 수 있고 기록은 그대로 남습니다.
대화 내용 영역입력한 내용, 응답, 도구 실행 결과가 모두 여기에 표시됩니다.
입력창요청을 적는 곳. 구체적일수록 결과가 원하는 것에 가까워집니다.
표 2 네 영역의 역할.

5. 첫 대화 시작하기

  1. 입력창에 원하는 것을 한국어로 분명하게 적으세요. 예: 「이 디렉터리의 모든 png를 원본 크기 그대로 webp로 변환해 줘」.
  2. Enter로 전송합니다. 먼저 이해하고 계획을 세운 뒤 필요하면 도구를 호출합니다.
  3. 쓰기, 삭제, 명령 실행처럼 위험이 있는 작업은 네이티브 확인 창이 뜨고, 직접 동의하거나 거부합니다.
  4. 결과는 대화에 표시됩니다. 마음에 들지 않으면 「……로 바꿔 줘」라고 말하면 되고, 처음부터 다시 시작할 필요가 없습니다.
요청을 쓰는 요령: 「무엇에 대해」, 「어떤 기준까지」, 「무엇은 건드리지 말 것」을 분명히 말하는 편이 무엇을 할지만 말하는 것보다 훨씬 효과적입니다. 말하지 않은 맥락은 보이지 않습니다.

6. 트레이 메뉴

대부분의 시스템 수준 조작은 트레이 아이콘에 모여 있습니다. 트레이 아이콘을 마우스 오른쪽 버튼으로 누르면 다음 항목이 나타납니다:

설정 열기 업데이트 확인 Profile 전환 복구 도우미 DSH 터미널 열기 종료
그림 3 트레이 메뉴의 여섯 항목. 가장 자주 쓰는 세 가지는 「설정 열기」「업데이트 확인」「복구 도우미」입니다.

7. 설정 페이지

설정 페이지는 기능에 따라 다섯 구역으로 나뉘며 왼쪽에서 오른쪽 순서입니다:

일반 Profile 도구 복구 권한
그림 4 설정 페이지의 다섯 구역.
구역여기서 할 수 있는 일
일반부팅 시 자동 시작, 인터페이스 언어, 로컬 웹 포트, 업데이트 카드(「업데이트 설명」과 수동 확인 포함).
Profile설정 프로필 조회와 새로 만들기, 현재 사용하는 Profile 전환.
도구DSH 터미널 열기, 일반 재시작, 복구 모드로 재시작.
복구정상 스냅숏 목록과 롤백. 롤백 전에 항상 현재 상태를 스냅숏으로 남깁니다.
권한Computer Use 등 시스템 권한 관리.
표 3 다섯 구역의 주요 용도.
작은 팁: 로컬 웹 포트를 고정하면 화면에서 저장한 설정(일부 플러그인의 환경 설정 등)이 재시작 후에야 다시 읽힐 수 있습니다. 특별한 이유가 없다면 기본값으로 두고 포트를 시스템이 자동 할당하게 하세요.

8. Profile: 여러 설정

Profile은 「독립된 설정 프로필 하나」로 이해하면 됩니다. 플러그인 조합, 패치, 설정이 각각 다릅니다. 여러 개를 준비해 두고 상황에 따라 전환할 수 있으며 서로 간섭하지 않습니다.

현재 Profile 예: desktop 트레이 → Profile 전환 설정 프로필 하나를 선택 순차 재시작 약 수 초 시작 실패? 마지막 정상 설정으로 자동 복귀 트레이의 「복구 도우미」로 직접 롤백할 수도 있습니다
그림 5 Profile 전환 흐름: 선택 → 순차 재시작 → 실패 시 자동 복귀.

세 가지만 기억하세요:

9. 플러그인과 플러그인 마켓

플러그인은 이 도우미에 능력을 더하는 방법입니다. 모델, 도구, 화면 패널, 자동화 흐름을 추가할 수 있습니다. 공식 플러그인은 바로 설치할 수 있고, 여러 플러그인을 동시에 적용할 수 있습니다.

설치 경로는 두 가지입니다:

설치 후에는 재시작해야 합니다. 플러그인을 바꾼 뒤에는 반드시 앱을 재시작해야 새 플러그인이 로드됩니다. 설치했는데 반응이 없으면 먼저 명령이 지금 쓰는 Profile에 적용되었는지 확인하고 다시 한 번 재시작하세요.

10. 설치된 플러그인 35개의 사용법

이 절은 현재 desktop 설정 프로필에 실제로 설치된 35개 플러그인을 하나씩 소개합니다. 이름과 버전은 이 PC의 설정 프로필에서 실측 수집했습니다(스냅숏 날짜 2026-11-08). 용도에 따라 일곱 그룹으로 나누고, 각 그룹마다 한 줄 개요를 먼저 제시한 뒤 어떤 일을 하고 언제 쓰이는지 설명합니다.

설치된 플러그인 35개 · 용도별 그룹 기억·맥락 5개 · 자동 소환, 프로젝트 검색, 맥락 통찰, 입력 기록, 대화 되돌리기 스킬·전문가 8개 · 스킬 관리/마켓/센터, 엔지니어링 스킬셋, 전문가팀, GitHub 워크플로, 아키텍처 다이어그램, PPT 인터페이스·효율 8개 · 자동 계속, 사이드바 강화, 작업 보드, Git 그래프, 인라인 UI, 음성 알림, 비용 통계, 세션 보관 협업·개발 8개 · 서브에이전트 위임, Claude Code / Codex 서브에이전트, 코드 리뷰, 상시 에이전트, 플러그인 탐색, 마켓, MCP 로봇 제어 2개 · UR 실기 제어, UR 오프라인 시뮬레이션 (Suzhou Nonead 자체 개발) 이미지·미디어 3개 · 이미지 생성 워크벤치, React 영상 워크벤치, Univer 문서 미리보기
그림 6 용도별로 나눈 일곱 가지 플러그인 그룹 (시스템 유지보수 1개: 설정 백업 — 문서 끝 35번 항목 참고).

이들은 서로 따로 떨어져 있지 않고, 실제 사용에서는 「맥락을 기억하는 것」에서 「결과를 인도하는 것」까지 하나의 흐름을 이룹니다:

① 기억 기억 · 맥락 ② 스킬 선택 스킬 · 전문가팀 ③ 실행 서브에이전트 · 로봇 ④ 전달 문서 · 영상 · 이미지 ⑤ 회고 검토 · 비용 이 흐름은 직접 이을 필요가 없습니다. 플러그인끼리 DSH의 서비스 주입을 통해 자동으로 연결됩니다.
그림 7 플러그인의 전형적인 협업 흐름.
먼저 세 가지 공통 조작을 기억하세요: 플러그인 설치는 dsh plugin add <플러그인 이름>, 제거는 remove, 업그레이드는 update입니다. 어떤 변경이든 후에는 앱을 재시작해야 합니다. 명령은 기본적으로 현재 활성화된 Profile에 적용되며, 지정하려면 --profile <이름>을 붙입니다.

첫 번째 그룹 · 기억과 맥락 (5개)

이 그룹은 「지난번에 무슨 말을 했는지 기억하지 못한다」는 문제를 해결합니다.

1자동 기억@a9i5k4/dsh-auto-memory3.3.17

능동형 연상 기억: 모델이 말을 꺼내기 전에 관련 기억을 먼저 자동 소환하고, 세 계층으로 자동 정리하며, 반복하는 절차를 스킬로 고정할 수도 있습니다.

사용법: 별도 조작이 필요 없습니다. 무엇을 소환할지 스스로 판단합니다. 오래된 기억을 정리하게 하려면 「최근 경험을 정리해 줘」라고 말하세요.

2프로젝트 기억@yolk_vat-y/dsh-project-memory0.6.11

문서(PDF / Markdown / 텍스트)와 코드 심볼을 워크스페이스마다 독립적이고 검색 가능한 라이브러리로 색인하고, 소환할 때 출처 인용을 함께 제시합니다.

사용법: 프로젝트에 들어가면 먼저 한 번 색인하게 하고, 이후 「이 프로젝트에서 XX는 어떻게 구현됐어?」라고 물으면 파일 출처와 함께 답합니다.

3맥락 통찰dsh-context0.82.1

현재 맥락이 무엇으로 구성되고 얼마나 차지하는지 보여 주고, 그에 맞춰 간소화해 대화가 길어질수록 느려지는 일을 막습니다.

사용법: 대화가 느려지거나 맥락이 너무 길다는 알림이 뜨면 그 패널을 열어 구성을 보고, 필요 없는 기록을 잘라내세요.

4입력 기록dsh-nonead-prompt-recall0.8.7

입력창이 비어 있을 때 ↑를 누르면 직전 입력이 나오고, 다시 누르면 계속 앞으로 갑니다. ↓로는 뒤로 돌아옵니다. 기록은 워크스페이스별로 따로 저장되어 재시작 후에도 남습니다. 모델 선택기 옆에는 다시 쓰기 버튼도 있는데, 현재 모델로 쓰다 만 프롬프트를 다시 써 주며 @ 참조는 유지됩니다.

사용법: 방금 쓴 긴 프롬프트를 다시 쓰고 싶을 때 빈 입력창에서 ↑만 누르면 됩니다.

5대화 되돌리기dsh-nonead-prompt-rewind0.5.4

창 안에서 대화를 이전 어느 시점으로 되돌리고, 동시에 워크스페이스 파일까지 함께 복원할 수 있습니다.

사용법: 방향을 잘못 잡아 「세 단계 전으로 돌아가 다시 하자」고 할 때 쓰면 새 세션을 여는 것보다 간편합니다.

두 번째 그룹 · 스킬과 전문가 (8개)

이 그룹은 「구체적인 작업을 만났을 때 전문적인 절차대로 하게 하려면」이라는 문제를 해결합니다.

6스킬 관리자@michengai/dsh-skills-manager1.2.35

이 PC의 Agent Skills를 통합 로드하고 안전하게 관리해, 여러 출처의 스킬이 서로 덮어쓰는 일을 막습니다.

사용법: 새 스킬을 설치한 뒤 여기서 올바르게 로드되었는지, 출처가 분명한지 확인하고 나서 활성화할 것을 정하세요.

7스킬 마켓@weibaohui/skills-management0.9.3

한 페이지에서 이 PC의 모든 코딩 도우미(Claude, Codex, ZCode 등 십여 종) 스킬을 관리하고, 클릭 한 번으로 DSH에 편입할 수 있습니다. 6600+ 스킬 마켓이 내장되어 있고 주입 비용 기준 정렬을 지원합니다.

사용법: 어떤 능력에 쓸 만한 스킬을 찾을 때 여기서 먼저 검색하세요. 설치 전에 토큰 비용을 보고, 한 번에 너무 많이 설치하지 마세요.

8스킬 센터@linxin666/dsh-client-ui-skill-explorer0.4.15

출처(내장 / 프로젝트 / 사용자 / 사용자 정의 / 런타임)별로 로드된 스킬을 둘러보고, 활성화·비활성화·생성·삭제를 할 수 있습니다.

사용법: 어떤 스킬이 동작하지 않는 것 같을 때 여기서 어느 계층에 속하는지, 비활성화되지는 않았는지 먼저 확인하세요.

9엔지니어링 스킬셋@wenaixi/dsh-superpower8.0.0

obra/superpowers의 엔지니어링 스킬 15개(요구 사항 명확화, TDD, 체계적 디버깅, 코드 리뷰 등)를 묶음으로 제공하며, 한국어·영어 설명과 개별 on/off를 지원합니다.

사용법: 개발 작업에서는 이 절차를 우선 따르게 하세요. 필요 없는 개별 스킬은 꺼서 방해를 줄일 수 있습니다.

10전문가팀@michengai/dsh-agency-agents1.2.26

소환 가능한 전문 에이전트 331명이 22개 분야의 역할을 담당하며, 필요할 때 전문가 한 명을 부르거나 팀을 구성할 수 있습니다.

사용법: 전문적 관점이 필요한 문제라면 「XX 전문가에게 보게 해 줘」라고 하면 됩니다. 복잡한 작업은 팀을 구성해 병렬로 처리할 수 있습니다.

11GitHub 워크플로 스킬dsh-github-skills0.2.1

OpenAI Codex의 GitHub 워크플로 의미를 이식했습니다. PR 보기, 리뷰 의견 처리, CI 확인, 배포 등.

사용법: 저장소에서 「이 PR의 리뷰 의견 좀 봐 줘」 또는 「CI가 왜 깨졌어?」라고 하면 해당 절차를 따릅니다.

12아키텍처 다이어그램@tt-a1i/archify-dsh1.0.0

요구 사항이나 코드 구조를 상호작용 가능한 아키텍처 다이어그램, 순서도, 시퀀스 다이어그램으로 그려 독립 HTML로 출력하며, 다크 모드와 내보내기를 지원합니다.

사용법: 「이 시스템 아키텍처를 그려 줘」라고 하면 코드를 먼저 읽고 그립니다. 허공에서 구성하지 않습니다.

13PPT 마스터dsh-ppt-master6.1.0

AI 기반 프레젠테이션 워크플로: 편집 가능한 PPTX 생성, 페이지 스냅숏, 네이티브 템플릿 채우기.

사용법: 주제와 요점을 주거나 기존 문서를 바탕으로 만들게 하세요. 레이아웃을 바꾸려면 「네이티브 템플릿으로 바꿔 줘」라고 하면 됩니다.

세 번째 그룹 · 인터페이스와 효율 (8개)

이 그룹은 「매일 보는 화면」과 「얼마나 드는지」를 개선합니다.

14사이드바 강화dsh-better-sidebar0.30.1

파일 트리, 편집기, 변경 사항, 작업, 사이드 채팅을 한 열에 모으고 세션마다 서로 간섭하지 않게 합니다. 또한 다른 플러그인이 자기 탭과 파일 뷰어를 이 사이드바에 붙일 수 있도록 서비스를 제공합니다. 열두 번째 절의 「오른쪽 패널이 계속 4xx를 낸다」는 바로 어떤 플러그인이 이 서비스를 받지 못한 경우입니다.

사용법: 코드를 고칠 때 창을 오갈 필요 없이 오른쪽에서 파일과 diff를 보고 사이드 채팅을 열 수 있습니다.

15작업 보드@linxin666/dsh-client-ui-task-board0.4.15

Host가 권위를 가진 작업 보드: 카드가 실제로 실행되고, cron 예약과 크로스 플랫폼 절전 보호를 지원합니다.

사용법: 할 일을 카드로 나눠 보드에 배치하면 순서나 시간에 따라 자동으로 실행됩니다.

16Git 그래프@linxin666/dsh-client-ui-git-graph0.4.14

빈 세션에서의 브랜치 선택기와 Git 관계도. 실제 Host 측 git 조작과 안전 검사를 갖추고 있습니다.

사용법: 새 세션을 열기 전에 그래프에서 브랜치 관계를 확인해 잘못된 브랜치에서 작업하는 일을 피하세요.

17인라인 상호작용 UI@changfenhuang/dsh-genui0.15.0

응답 안에서 상호작용 가능한 컴포넌트를 직접 렌더링합니다. 레이아웃, 차트, 함수 그래프, 폼, 퀴즈 등.

사용법: 차트나 비교표가 필요하면 「표/차트로 보여 줘」라고 하면 조작 가능한 패널로 렌더링합니다.

18음성 알림dsh-notify-say0.5.3

데스크톱 알림을 실제로 읽어 줍니다. Windows 내장 TTS는 별도 다운로드 없이 바로 쓸 수 있고, VOICEVOX 음색을 고를 수 있으며 시스템 효과음으로 대체할 수도 있습니다. 또 파견한 서브에이전트가 모두 끝난 뒤에야 「이번 라운드 완료」를 읽습니다.

사용법: 긴 작업을 돌려 두고 다른 일을 하다가 완료되면 소리로 알려 줍니다. 설정에서 음색을 바꿀 수 있습니다.

19비용 통계dsh-cost-meter1.9.58

이 세션과 당일 비용을 집계하고, 170개 이상의 모델 가격 목록을 내장해 자동으로 매칭합니다. 16개 Coding Plan의 구독 한도와 사용자 정의 Provider의 잔액(임의 HTTP 엔드포인트 지정)도 조회해 진행 막대로 보여 줍니다.

사용법: 긴 작업 전에 당일 지출을 확인하고, 모델을 바꿀 때 단가를 비교해 비싼 모델로 싼 일을 하는 것을 피하세요.

20세션 보관@michengai/dsh-archive-manager1.2.8

세션을 보관, 복원, 즐겨찾기, 영구 삭제하고 손상된 세션 로그를 진단합니다.

사용법: 세션 목록이 너무 길면 오래된 것을 보관하세요. 어떤 세션이 열리지 않으면 먼저 이것으로 로그를 진단하세요.

21자동 계속dsh-client-auto-continue0.17.4

네트워크 오류 등 사람의 의사가 아닌 이유로 세션이 중단되면 계속 프롬프트를 자동으로 보내 대화를 이어 줍니다. 엔진이 호스트 프로세스에서 돌기 때문에 브라우저 탭을 닫아도 계속 동작합니다. 기본값은 「중단 복구」만이며, 끝난 뒤에도 이어서 하게 하는 자율 루프는 설정에서 직접 켜야 합니다.

사용법: 네트워크가 불안정하거나 긴 작업을 돌릴 때 켜 두면 돌아왔을 때 대화가 이미 이어져 있습니다. 한 라운드씩 스스로 계속하게 하려면 자율 루프를 따로 켜세요.

네 번째 그룹 · 협업과 개발 (8개)

이 그룹은 「도우미 하나」를 「팀 하나」로 바꿉니다.

22서브에이전트 위임@deepseek-ai/dsh-tool-subagent0.2.2-rc.1

모델을 위한 서브에이전트 위임 도구: 독립적인 하위 작업을 다른 에이전트에게 넘겨 현재 대화의 맥락을 차지하지 않게 합니다.

사용법: 작업을 서로 의존하지 않는 여러 조각으로 나눌 수 있으면 병렬로 분배하고, 주 대화는 결론만 받습니다.

23Claude Code 서브에이전트@deepseek-ai/dsh-subagent-claude-code0.2.2-rc.1

공식 Agent SDK 기반의 일회성 Claude Code 서브에이전트로, 작업을 맡겨 끝낸 뒤 결과를 받습니다.

사용법: Claude Code의 그런 능력(대규모 코드 수정, 테스트 실행)이 필요할 때 이름을 지정해 쓰세요.

24Codex 서브에이전트@deepseek-ai/dsh-subagent-codex0.2.2-rc.1

공식 app-server 프로토콜 기반의 일회성 Codex 서브에이전트.

사용법: 어떤 구현을 Codex가 독립적으로 끝내게 하고 싶을 때 쓰며, Claude Code 서브에이전트와 함께 쓸 수 있습니다.

25코드 리뷰@michengai/dsh-code-review1.0.8

Codex 스타일 코드 리뷰: 독립 네이티브 서브 Agent, 선택 가능한 검토 범위, 한국어·영어 보고서.

사용법: 커밋 전에 「이번 변경 사항을 검토해 줘」라고 하면 diff, 관련 코드, 미커밋 파일로 범위를 나눠 검사합니다.

26저장소 상시 에이전트dsh-superagent0.1.0

단일 GitHub 저장소를 위한 능동형 에이전트: GitHub(선택적으로 Feishu)를 지켜보며 규칙에 따라 요청을 평가합니다.

사용법: issue / PR을 대신 지켜보게 하려면 활성화하세요. 먼저 어떤 저장소에 작용하고 어떤 트리거 규칙을 쓰는지 확인하세요.

27플러그인 탐색dsh-find-plugins0.3.0

다섯 개 커뮤니티 카탈로그와 실시간 GitHub / npm 검색으로 플러그인을 찾고, 관련성 × 신뢰도 × 최신성 × 인기도로 정렬합니다.

사용법: 기능을 추가하고 싶을 때 마켓을 직접 뒤지는 것보다 「그런 플러그인 있어?」라고 묻는 편이 정확합니다.

28플러그인 마켓dshmarket1.73.14

화면 안의 시각적 플러그인 마켓: 둘러보기, 검색, 클릭 한 번 설치.

사용법: 설정 페이지에서 마켓을 열어 찾은 뒤 설치를 누르세요. 설치 후 재시작해야 적용됩니다.

29MCP 커넥터dsh-mcp-connector0.2.94

기업, 금융, 법률, 특허, 연구 등의 데이터 소스에 연결하는 MCP 마켓으로, 권한 부여·검색·호출을 관리합니다.

사용법: 외부 데이터가 필요하면 여기서 커넥터를 찾아 권한을 부여하세요. 호출 전에 어떤 권한을 요구하는지 확인하세요.

다섯 번째 그룹 · 로봇 제어 (2개, Suzhou Nonead 자체 개발)

이 그룹은 DSH가 자연어로 Universal Robots 로봇 팔을 직접 구동하게 합니다.

30UR 실기 제어dsh-nonead-universal-robots0.8.6

자연어로 UR 로봇 팔을 제어합니다. 상태 읽기, 관절 이동, 직선 이동, 힘 제어, I/O와 레지스터, 컨베이어 추적 등이며 자체 개발한 nUR MCP Server와 같은 계보의 로직을 씁니다.

사용법: 먼저 「192.168.x.x에 연결해 줘」라고 한 뒤 동작을 지시하세요. 운동과 관련된 명령은 기본적으로 승인 게이트의 적용을 받아 하나씩 확인해야 합니다.

31UR 오프라인 시뮬레이션dsh-nonead-ursim0.3.14

같은 로직의 오프라인 시뮬레이션 버전: 실제 로봇 없이 가상 UR 로봇 팔을 구동해 궤적을 검증합니다.

사용법: 시뮬레이션에서 동작을 먼저 돌려 충돌이 없는지 확인한 뒤 실기에 적용하세요. 시뮬레이션은 운동학만 다루며 힘 제어와 I/O에는 의미가 없습니다.

여섯 번째 그룹 · 이미지와 미디어 (3개)

이 그룹은 결과를 바로 인도할 수 있는 형태로 만듭니다. 이미지, 영상, 문서.

32이미지 생성 워크벤치dsh-image-gen0.10.3

ChatGPT식 이미지 생성을 DSH로 가져옵니다. Gemini, OpenAI, Seedream, DashScope를 지원하고 이 PC의 ComfyUI 워크플로도 쓸 수 있습니다. 스케치를 그리고 참조 이미지를 고를 수 있는 워크벤치 캔버스가 함께 있습니다.

사용법: 「한 장 그려 줘……」라고 하면 이미지를 만들어 대화에 바로 붙입니다. 기존 이미지를 고치려면 「이걸 ……로 바꿔 줘」라고 하세요. 공급자나 모델을 바꾸려면 분명히 말해야 하며, 기본값은 설정에 구성된 것을 씁니다.

33React 영상 워크벤치dsh-remotion0.10.5

공식 Remotion 스킬 + 프로젝트 검색, 템플릿, 소재 정렬, Studio 미리보기, MP4 내보내기.

사용법: 영상이나 오프닝을 만들 때 활성화하세요. 템플릿을 먼저 보고 고치는 편이 컴포넌트를 처음부터 쓰는 것보다 빠릅니다. 처음 환경을 준비할 때 의존성을 내려받으므로 네트워크가 필요합니다.

34Univer 문서 미리보기dsh-univer-office0.4.0

DSH와 Univer 통합: 문서 인라인 미리보기, 플로팅 Worktree 창, 세션 종료 시 리뷰 동작.

사용법: 표 / 문서 / 발표 자료를 만들게 하면 결과가 패널에서 바로 미리보기되므로 내려받아 확인할 필요가 없습니다.

일곱 번째 그룹 · 시스템 유지보수 (1개)

35설정 백업dsh-config-manager0.4.3

DSH 설정 전체를 백업, 복원, 내보내기, 가져오기, 이전, 동기화합니다. 설정, 플러그인, MCP, 스킬, 에이전트 프리셋 등.

사용법: 설정을 크게 바꾸기 전에 한 번 내보내 두세요. 기기를 옮길 때는 가져오기로 복원하는 편이 항목별로 다시 설정하는 것보다 훨씬 빠릅니다.

이 목록은 스냅숏이며 설치·제거에 따라 달라집니다. 이 PC에 지금 무엇이 설치되어 있고 버전이 무엇인지 알려면 설정 페이지의 플러그인 마켓에서 대조하거나, 데이터 디렉터리의 profiles/desktop/package.json에 있는 dependencies를 직접 보세요.

전부 한꺼번에 켜는 것도 권장하지 않습니다. 플러그인이 많을수록 맥락과 시작 비용이 커집니다. 앞서 말한 「스킬 마켓」에서 각 스킬의 주입 비용을 볼 수 있으니 설치 전에 가늠해 보세요. 당장 쓰지 않는 것은 비활성화해 두었다가 필요할 때 켜면 됩니다.

11. 업데이트

앱은 백그라운드에서 조용히 새 버전을 확인하며 사용자를 방해하지 않습니다. 새 버전을 찾으면 트레이에만 알리고 스스로 팝업을 띄우지 않습니다.

업데이트 확인 새 버전 발견 트레이 알림 다운로드 설치 재시작 완료 실패해도 현재 버전에는 영향이 없습니다. 트레이에서 「설치 재시도」를 할 수 있고, 이미 받은 패키지는 남아 있어 다시 받지 않아도 됩니다.
그림 8 업데이트의 다섯 단계. 어느 단계에서 실패해도 현재 버전은 유지됩니다.

몇 가지 유용한 스위치:

조작효과
이 버전 건너뛰기해당 버전은 이후 알리지 않습니다. 재시작 후에도 유효합니다
건너뛰기 해제건너뛰기 기록을 지워 해당 버전이 다시 알림 대상이 됩니다
설치 재시도이미 받은 설치 패키지를 재사용하며 다시 받지 않습니다
설치 후 재시작준비되면 바로 설치하고 재시작합니다
표 4 업데이트와 관련된 네 가지 조작.

12. 문제가 생겼을 때

먼저 아래 표와 대조해 보세요. 대부분의 문제는 스스로 해결할 수 있습니다.

증상대처 방법
창이 사라졌다시스템 트레이를 보세요. 창을 닫는 것은 숨기는 것이지 종료가 아닙니다.
눌러도 반응이 없다 / 계속 돌기만 한다잠시 기다려 보세요. 그래도 응답이 없으면 트레이 메뉴에서 재시작하거나 「복구 모드로 재시작」을 쓰세요.
시작하자마자 죽는다, 들어갈 수 없다「복구 도우미」로 마지막으로 정상 동작한 설정으로 되돌리세요. 롤백 전에 현재 상태를 자동으로 백업하므로 롤백 자체도 다시 롤백할 수 있습니다.
플러그인을 설치했는데 적용되지 않는다명령이 올바른 Profile에 적용되었는지 확인하고 앱을 재시작하세요.
이미지를 만들라고 했는데 나오지 않는다이미지 생성은 설정에서 이미지 공급자(API 자격 증명 또는 로그인된 구독 계정)를 먼저 구성해야 합니다. 구성 전에는 사용 가능한 공급자가 없다고만 알려 줍니다.
터미널에서 명령을 찾을 수 없다트레이에서 「DSH 터미널」을 다시 여세요. 데스크톱 앱은 시스템 PATH를 수정하지 않습니다.
오른쪽 「파일」 등 패널이 계속 4xx를 낸다보통 어떤 플러그인이 의존 서비스를 받지 못해 멈춘 경우입니다. 데이터 디렉터리의 logs/에서 pending (waiting for service:를 검색하고, 해당 플러그인을 비활성화한 뒤 재시작하세요.
업데이트 알림을 받지 못했다백그라운드 확인은 조용히 이루어집니다. 트레이나 설정의 「업데이트 확인」으로 직접 결과를 보세요.
표 5 흔한 증상과 대처 방식.

진단 정보 내보내기

문제를 유지보수 담당자에게 알려야 한다면 트레이 아이콘을 마우스 오른쪽 버튼으로 눌러 진단 패키지를 내보낼 수 있습니다. 최근 로그를 모으고, 로그에 있는 식별 가능한 자격 증명은 마스킹됩니다. 다만 로컬 경로, 워크스페이스 이름, 세션 ID는 남을 수 있으니 공개 업로드 전에 내용을 직접 한 번 확인하세요.

13. 데이터는 어디에, 도움은 어디서

내용위치
데이터 디렉터리 (세션 / 설정 / 로그)기본값 ~/.dsh, Windows에서는 %USERPROFILE%\.dsh
로그데이터 디렉터리의 logs/
창 위치와 크기앱 데이터 디렉터리의 window-state.json
데스크톱 설정 (포트 포함)데이터 디렉터리의 desktop-preferences.json
환경 변수 덮어쓰기앱 데이터 디렉터리의 .env (엄격한 KEY=VALUE, 실제 환경 변수는 덮어쓰지 않음)
표 6 자주 쓰는 파일 위치.

더 많은 문서

마지막 조언 하나: 이 매뉴얼을 설명서가 아니라 지도로 보세요. 일상에서 정말 기억할 것은 세 가지뿐입니다. 입력창에 요구 사항을 분명히 적기, 쓰기 작업 전에 확인 창 한 번 보기, 창이 안 보이면 트레이를 확인하기.

감사의 글

이 책이 나올 수 있었던 것은 두 층의 사람들 덕분입니다.

DeepSeek과 DeepSeek Harness 업스트림 팀 — 이 제품은 수정하지 않은 업스트림 위에 서 있습니다. 에이전트 루프, 도구 호출, 플러그인 호스트, 웹 인터페이스가 모두 업스트림에서 왔고, 업스트림의 공개 코드와 문서가 이 매뉴얼의 기술적 원본입니다.

35개 플러그인의 저자들 — 열 번째 장에서 하나씩 소개한 플러그인은 대부분 커뮤니티가 독립적으로 개발하고 유지합니다. 저장소 귀속 기준으로 묶으면 각자의 GitHub 계정 또는 조직은 다음과 같습니다:

설치 패키지 자체도 오픈 소스 프로젝트의 어깨 위에 서 있습니다. Electron, electron-builder, pnpm, Node.js와 Python 런타임, 그리고 업스트림 의존성 트리의 수많은 저자들입니다. 명단에 빠진 곳이 있거나 표기가 잘못되었다면 저장소에 issue로 알려 주세요.

제작사 안내: 이 매뉴얼과 제품은 Suzhou Nonead Robot Technology Co., Ltd.가 제작했습니다. Suzhou Nonead Robot Technology Co., Ltd.는 DeepSeek 및 그 계열사와 어떠한 제휴 관계도 없습니다 — 본 제품은 독립적으로 개발·유지되며 DeepSeek의 입장이나 견해를 대표하지 않고, DeepSeek의 승인·보증·인가도 받지 않았습니다.
회사 정식 명칭: 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