dsh-visual-skin
dsh-visual-skin
DeepSeek Harness Skin Studio — DeepSeek Harness를 위한 원클릭 시각적 스킨 도구
A visual skin studio for DeepSeek Harness (DSH): design, preview and safely apply skins with one click — no config files to touch. Ship as an Agent Skill + MCP server + DSH plugin, with a one-shot PowerShell installer.
설치 후, AI 어시스턴트는 이미지 한 장만으로 이미지 업로드 → 테마 생성 → 격리 미리보기 → 수동 확인 적용의 완전한 스킨 변경 프로세스를 자동으로 수행합니다. 또는 독립형 Studio 웹 페이지에서 시각적으로 스킨을 조정하고 원클릭으로 DSH에 적용할 수 있습니다.
✨ 기능
기능 | 설명 |
🎨 Skin Studio (시각적 디자이너) | 독립형 Web UI: 이중 영역 배경(사이드바/메인 영역), 이미지/그라데이션 배경, 유리 모피즘, 토큰 색상 조정, 영역 선택기, WYSIWYG |
🤖 Agent Skill | 설치 후 DSH / Codex 어시스턴트가 "스킨 변경 / 이 이미지를 배경으로 사용" 요청을 받으면 전체 스킨 변경 프로세스를 자동으로 오케스트레이션 |
🔌 MCP Server (26개 도구) |
|
🖥️ DSH 플러그인 | 상시 배경(body 레벨 CSS, 대화 전환 시에도 유지), 대화 오버레이(클릭 즉시 적용, 전환 시 무감각), 사이드바 구분선, 잔액 표시줄(설정 위 잔액 버튼 + 대화 상세 잔액 표시, 새로고침 가능) |
🛡️ 보안 경계 | 모든 "DSH 쓰기" 작업은 격리 DSH 미리보기 → 불변 apply 계획 → 보이는 UI에서 수동 확인을 거칩니다. MCP는 절대 확인을 위조할 수 없습니다. |
📦 원클릭 설치 | PowerShell 설치 프로그램이 자동으로 빌드 → Skill 설치 → 플러그인 등록 → MCP 등록 → Studio 시작 → (선택 사항) Codex 동기화를 수행합니다. |
Related MCP server: gpt-dsh-bridge
🎬 데모
Hero · 어두운 전시(12초) | 생성 · 이미지에서 스킨으로(7초) |
|
|
애니메이션 제작: huashu-design · 스토리보드: docs/demo/storyboard.md · 방향 보드: docs/demo/direction-boards.html
📦 설치
사전 요구 사항
의존성 | 버전 | 설명 |
Windows | 10 / 11 | 설치 프로그램은 PowerShell 스크립트 |
22+ | 플러그인 및 Controller 실행 필수 | |
11+ | 최초 설치 시에만 필요(휴대용 런타임 빌드용) | |
0.1.0-rc.6 | 대상 버전, 기능 고정, 버전 불일치 시 플러그인 fail-closed |
방법 1: 명령줄 설치 (권장)
# 1. 获取项目
git clone https://github.com/trrrrrryg/dsh-visual-skin.git
cd dsh-visual-skin
# 2. 一键安装(默认目标:%USERPROFILE%\.dsh,profile: web,Controller 端口 11862)
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1설치 프로그램이 자동으로 수행:
자체 포함 휴대용 런타임(Controller + Studio + MCP + 플러그인, 약 51MB, Skill 디렉토리에 설치) 빌드/재사용;
Skill을
%DSH_HOME%\skills\deepseek-harness-skin-studio에 설치(DSH 어시스턴트가 즉시 해당 스킬 획득);DSH 플러그인 등록(
cordis.patch.yml호스팅 블록,스킨 설정설정 카드 포함);MCP 서버 등록(
mcp__skin-studio__*, 설치된 자체 포함 런타임을 가리킴);Studio 시작(Controller, 기본 포트 11862, 브라우저에서
http://127.0.0.1:11862접속);Codex 감지 시 자동으로 Skill 동기화 및 Codex MCP 등록.
설치 완료 후 DSH를 한 번 재시작(또는 데스크톱 런처에서 재시작)하여 profile patch와 MCP 클라이언트를 활성화합니다.
선택적 매개변수
매개변수 | 설명 |
| DSH 루트 디렉토리(기본값 |
| 대상 profile(기본값 |
| Studio 데이터 디렉토리(기본값 |
| Studio Controller 포트(기본값 |
| 이미 빌드된 런타임 사용, 빌드 건너뛰기 |
| 해당 구성 요소 건너뛰기 |
| 설치 후 DSH 자동 재시작(기본값 재시작 안 함, 실행 중인 세션 중단 방지) |
예시 (사용자 지정 설치 + 설치 후 DSH 자동 재시작):
.\install.ps1 -DshHome C:\Users\me\.dsh -ProfileName web -ControllerPort 12000 -RestartDsh방법 2: AI 설치
이 저장소를 모든 agent에 전달하고 다음을 지시:
README와 이 저장소의
install.ps1을 읽고 설치를 실행하세요.
agent가 위 프로세스에 따라 설치를 완료합니다(직접 install.ps1을 실행할 수도 있음).
설치 확인
# 插件健康检查(在 DSH 端口上,应返回 ok:true;默认 DSH 端口 10402)
Invoke-RestMethod http://127.0.0.1:10402/dsh-skin/health
# Controller / Studio 状态检查(应返回 ok:true、capabilities.compatible:true)
Invoke-RestMethod http://127.0.0.1:11862/api/v1/statusStudio 열기:
http://127.0.0.1:11862(또는 시작 메뉴/트레이 아이콘 클릭)DSH 설정 페이지에 '스킨 설정' 카드가 나타나야 함. 어시스턴트에게 "스킨 변경"이라고 말하면
mcp__skin-studio__*도구가 트리거됩니다.
🚀 사용
설치 및 재시작 후 DSH 어시스턴트에게 직접 말하기:
"스킨을 변경해줘" / "이 이미지를 배경으로 사용해줘" → 어시스턴트가 자동으로
mcp__skin-studio__*를 호출하여 제작을 완료하고 Studio에서 미리보기;"현재 스킨 배경을 바꿔줘" → 어시스턴트가 현재 디자인 수정;
Studio에서 수동 조정(배경, 영역, 토큰, 구분선) → 내 DSH에 쓰기 클릭, 팝업 계획 확인 창에서 수동 확인 → DSH 재시작 후 적용.
스킨 변경 흐름도
用户指令 / 图片 ──▶ Agent Skill ──▶ MCP (design_create → asset_upload → theme_patch
→ theme_validate → preview_start)
│
▼
隔离 DSH 预览(真实渲染,不碰你的 DSH)
│
▼
Studio 可见确认(theme_apply_plan → theme_apply)
│
▼
你的 DSH 皮肤生效(可随时 Restore 还原)🗂️ 디렉토리 구조
├─ install.ps1 # 一键安装器(命令行 / AI)
├─ apps/
│ ├─ controller/ # Studio 后端(API、隔离预览、apply/restore、GC)
│ └─ studio/ # Studio Web UI(React + Vite)
├─ packages/
│ ├─ dsh-plugin/ # DSH 插件(host 路由 + client 皮肤渲染)
│ ├─ theme-schema/ # ThemeSpec v2 数据契约
│ ├─ design-session-core/ # 设计会话 / 确认票据 / 操作日志
│ ├─ shared/ # 跨端类型与错误码
│ ├─ agent-cli/ # dsh-skin JSON CLI
│ ├─ mcp-server/ # MCP stdio 服务器(26 个工具)
│ └─ portable-runtime/ # 便携运行时聚合
├─ agents/codex-skill/deepseek-harness-skin-studio/
│ ├─ SKILL.md # Agent Skill 指令(自动换肤流程)
│ └─ scripts/ # open-studio / build-portable / install-local
├─ research/ # 同类项目调研材料(16 个项目 README)
├─ docx/ # 项目文档(实施计划 / 需求分析 / 架构设计)
└─ tests/ # 回归测试(含真实 rc.6 隔离 Chromium 预览)🛠️ 개발
pnpm install # 安装依赖(需要 Node 22+ / pnpm 11+)
pnpm build # 构建全部包
pnpm test # 回归测试(会启动真实 rc.6 隔离预览)
pnpm controller # 本地启动 Controller(开发)
pnpm dev # Studio 开发模式(Vite)🗑️ 제거
%DSH_HOME%\profiles\<profile>\cordis.patch.yml에서# >>> dsh-skin-studio와# <<< dsh-skin-studio주석 블록 사이의 모든 항목 제거;%DSH_HOME%\profiles\node_modules\@dsh-skin및%DSH_HOME%\skills\deepseek-harness-skin-studio삭제;DSH 재시작;
Studio 데이터 정리가 필요한 경우
%LOCALAPPDATA%\DeepSeekHarnessSkinStudio삭제.
🔒 보안 및 호환성
대상 DSH 버전:
0.1.0-rc.6(기능 고정, 버전 불일치 시 플러그인 fail-closed).스킨 모델(ThemeSpec)은 구조화된 데이터만 허용: 리터럴 CSS 색상, 콘텐츠 주소 지정 이미지(sha256), 제어된 토큰; 임의의 CSS/JS/URL은 허용되지 않음.
미리보기는 Controller가 소유한 격리된 임시 DSH를 사용. 확인 및 쓰기는 보이는 Studio에서 수동으로 완료해야 함.
잔액 조회: API Key는 호스트 측에서만 구문 분석(
DSH_SKIN_BALANCE_API_KEY→DEEPSEEK_API_KEY→%DSH_HOME%\.credentials.yaml), 브라우저는 집계된 잔액만 표시, 키는 브라우저에 저장되지 않음.
📄 문서
docx/— 구현 계획, 요구 사항 분석 명세서, 기술 아키텍처 설계 명세서CHANGELOG.md— 변경 기록RELEASING.md— 릴리스 체크리스트 (GitHub Release / npm)
📃 License
MIT © 2026 trrrrrryg
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Agent MCP: 65 tools — 5-chain verification, risk, prediction & crypto trends, 17 web tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceAugments DeepSeek-V4 with image understanding and deep research capabilities via MCP, enabling vision and web research tools.51MIT
- AlicenseNot gradedqualityCmaintenanceMCP server bridging ChatGPT to DeepSeek Harness, exposing 13 tools for task submission, status tracking, result retrieval, project/session management, and human-in-the-loop approvals.4MIT
- AlicenseBqualityDmaintenanceLets any MCP-compatible agent analyze, describe, OCR, compare, locate, upload, and manage images through DeepSeek's vision model.81MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to create, edit, animate, inspect, and export icons and icon packs through MCP tools, with live previews and SVG or React output. It provides read, look, write, export, and language-setting tools for agent-driven icon design.MIT

