zhu1090093659/dsh-web

DeepSeek Harness（DSH）Web 插件聚合生态包 · 一切皆插件，创意工坊分发

dsh‑web 는 무엇인가요?

dsh‑web 는 DeepSeek Harness (DSH) Web 의 플러그인 생태계입니다. DeepSeek의 AI 에이전트와 상호작용할 수 있는 브라우저 기반 UI를 제공합니다. 리포지토리는 "모든 것을 포함한 하나의 패키지 (@linxin666/dsh-web-all)를 제공하며, 수십 가지 선택적 UI 확장 기능(태스크 보드, 모바일 원격 제어, SSH 콘솔, 이미지 이해 도구, Git 시각화 도구, 스킨, 펫, 마켓플레이스)을 번들로 제공하고, 핵심 DSH 코드를 수정하지 않고도 즉시 사용할 수 있도록 합니다.

핵심 아이디어

아이디어	작동 방식
모든 것이 플러그인	각 기능은 `@linxin666/dsh‑*` 스코프 아래의 개별 npm 패키지로 존재합니다. 집계 패키지는 이를 모두 나열하여 하나의 종속성만 설치하면 완전한 워크스테이션을 얻을 수 있습니다.
플러그인 가능한 스킨	시각적 테마도 플러그인입니다. 스킨 패키지는 `skin.json` 매니페스트, CSS, 이미지, 선택적 효과 스크립트를 포함합니다. UI는 런타임에 스킨을 로드하며, 핵심 코드와 완전히 분리되어 있어 새로운 외관을 릴리스 없이 추가할 수 있습니다.
마켓플레이스 (dsh‑market.com)	동일한 스킨/펫/플러그인 매니페스트에서 생성된 정적 사이트입니다. 사용자는 커뮤니티가 만든 자산을 브라우징, 미리보기, 한 번의 클릭으로 설치할 수 있습니다.
원격-모바일 페어링	QR 코드를 스캔하거나 링크를 복사하여 스마트폰 또는 다른 브라우저와 페어링할 수 있습니다. 페어링된 장치는 동일한 DSH 워크스테이션을 보며 메시지 전송, 모델 전환, 명령 실행이 가능합니다. 통신은 SSE를 사용하며, SSE가 지원되지 않으면 폴링으로 대체됩니다.
SSH 및 파일 전송	내장된 xterm.js 터미널, SFTP 업로드/다운로드, 포트 포워딩, 다중 호스트 배치 실행이 UI 패널로 제공됩니다.
이미지 이해	채팅 입력에 버튼을 추가합니다. 선택한 이미지는 `describe_image` 도구를 통해 설정 가능한 OpenAI 호환 비전 엔드포인트(예: GPT‑4o, Qwen‑VL, Ollama)로 전송됩니다. 대화에 저장되는 것은 생성된 텍스트만입니다.

주요 플러그인 ("모든 것을 포함한 하나의 번들"에 포함됨)

플러그인	기능
`dsh-client-ui-task-board`	다섯 개의 컬럼을 가진 칸반 보드, DSH 에이전트의 실시간 실행, cron 스타일 스케줄링.
`dsh-remote-web-ui`	모바일 또는 보조 브라우저용 QR 코드 페어링; 세션, 모델, 권한의 실시간 동기화.
`dsh-ssh`	터미널, SFTP, 로컬 전용 포트 포워딩, 클러스터 명령 실행을 포함한 SSH 패널.
`dsh-tool-describe-image`	이미지를 설정 가능한 비전 모델로 전달하고 텍스트 설명을 반환하는 비전 도구 (`describe_image`).
`dsh-client-ui-git-graph`	브랜치 선택기 및 시각화된 커밋 이력 그래프.
`dsh-client-ui-skin-center`	모든 스킨 자산을 로드하는 로더; 스킨은 필요 시 마켓플레이스에서 동적으로 가져옵니다.
`dsh-client-ui-market`	DSH Web 내부에서 마켓플레이스를 여는 UI 카드.
`dsh-client-ui-plugin-manager`	UI에서 직접 `@linxin666/*` 플러그인의 설치/활성화/비활성화가 가능합니다.
`dsh-better-sidebar` (외부)	파일 탐색기, 에디터, 터미널, Git 보기, 브라우저를 호스팅하는 오른쪽 사이드바.
…그리고 스킬 탐색기, 채팅 복구, 데스크톱 런처, "의사" 구조적 복구 모드와 같은 많은 선택적 유틸리티.

시작하기 (빠른 시작)

사전 요구 사항 – DeepSeek Harness가 이미 설치되어 있고 dsh web가 실행 가능한 상태여야 합니다. 소스에서 빌드하려면 Node ≥ 22와 pnpm이 필요합니다.

번들 설치

dsh plugin --profile web add @linxin666/dsh-web-all@latest

dsh web 재시작. 왼쪽 사이드바에 새로운 항목이 나타납니다.
설정 → 플러그인 구성에서 플러그인 활성화/비활성화 또는 스킨 시도 가능.

로컬에서 개발을 원하는 경우 리포지토리를 클론하고 pnpm install && pnpm -r build를 실행한 후, node scripts/link-profile.mjs로 빌드된 패키지를 링크한 후 UI를 재시작하세요.

누구에게 적합한가요?

DSH 에이전트를 구축, 테스트, 모니터링하기 위해 더 풍부한 UI를 원하는 AI 에이전트 개발자.
브라우저를 벗어나지 않고 원격 SSH 접근, 스케줄된 작업, 시각적 Git 이력을 필요로 하는 파워 유저.
스킨, 펫, 플러그인을 DSH 마켓플레이스에 공개하고 싶은 커뮤니티 창작자.

제한 사항 및 주의사항

스케줄된 작업은 DSH 호스트 프로세스에서 실행됩니다. 브라우저가 닫혀도 유지되지만, 호스트가 중지되거나 기기가 절전 모드에 들어가면 건너뜁니다.
SSH 자격 증명은 평문으로 저장됩니다 (~/.dsh/dsh-ssh.json, 모드 0600).
실시간 모바일 업데이트는 Server-Sent Events에 의존합니다. 일부 터널링 서비스(예: Cloudflare Quick Tunnel, Tailscale)는 폴링으로 전환되어 몇 초의 지연이 발생할 수 있습니다.
소스에서 빌드하려면 Node ≥ 22와 pnpm이 필요합니다. 일반 사용자는 미리 게시된 npm 패키지를 설치할 수 있습니다.

커뮤니티 및 기여

도움이나 논의를 위해 README에 있는 QR 코드를 통해 QQ 그룹 또는 Discord 서버에 참여하세요.
기여는 표준 CONTRIBUTING.md 워크플로우를 따르며, Conventional Commits를 사용하고, PR 병합 전에 pnpm typecheck && pnpm test && pnpm docs:check를 통과해야 합니다.
새로운 플러그인이나 스킨은 node scripts/dsh-plugin-new <name> 또는 node scripts/dsh-skin-new로 스크래핑할 수 있습니다.

요약하면: dsh‑web 는 모듈식이고 커뮤니티 주도적인 확장 계층으로, DeepSeek Harness 웹 UI를 플러그인 태스크 보드, 원격 모바일 제어, SSH, 비전 도구, 스킨, 커뮤니티 기여용 마켓플레이스를 갖춘 완전한 기능의 개발 워크스테이션으로 변모시킵니다.