dsh-visual-skin

DeepSeek Harness Skin Studio — Ein visuelles Skin-Studio mit einem Klick für DeepSeek Harness

Ein visuelles Skin-Studio für DeepSeek Harness (DSH): Entwerfen, Vorschau und sicheres Anwenden von Skins mit einem Klick – keine Konfigurationsdateien erforderlich. Ausgeliefert als Agent Skill + MCP-Server + DSH-Plugin, mit einem One-Shot-PowerShell-Installer.

Nach der Installation kann dein KI-Assistent mit nur einem Bild automatisch den gesamten Skin-Wechsel-Prozess von Bild-Upload → Theme-Erstellung → isolierte Vorschau → manuelle Bestätigung durchführen; du kannst auch die eigenständige Studio-Webseite öffnen, um Skins visuell anzupassen und mit einem Klick in DSH zu schreiben.

✨ Funktionen

📦 Installation

Voraussetzungen

Methode 1: Installation über die Befehlszeile (empfohlen)

# 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

Der Installer führt automatisch aus:

1. Erstellen/Wiederverwenden einer eigenständigen portablen Laufzeit (Controller + Studio + MCP + Plugin, ca. 51 MB, installiert im Skill-Verzeichnis);

2. Installieren des Skills in %DSH_HOME%\skills\deepseek-harness-skin-studio (der DSH-Assistent erhält sofort diesen Skill);

3. Registrieren des DSH-Plugins (cordis.patch.yml-verwalteter Block, inklusive Skin-Einstellungen-Einstellungskarte);

4. Registrieren des MCP-Servers (mcp__skin-studio__*, verweist auf die installierte portable Laufzeit);

5. Starten des Studios (Controller, Standard-Port 11862, Browser öffnet http://127.0.0.1:11862);

6. Bei Erkennung von Codex automatisch den Skill synchronisieren und Codex MCP registrieren.

Starte DSH nach der Installation einmal neu (oder über den Desktop-Launcher), um das Profil-Patch und den MCP-Client zu aktivieren.

Optionale Parameter

Beispiel (benutzerdefinierte Installation + automatischer Neustart von DSH nach der Installation):

.\install.ps1 -DshHome C:\Users\me\.dsh -ProfileName web -ControllerPort 12000 -RestartDsh

Methode 2: KI-Installation

Übergib dieses Repository an einen beliebigen Agenten und sage ihm:

Bitte lies die README und die install.ps1 in diesem Repository und führe dann die Installation aus.

Der Agent führt die Installation gemäß dem obigen Ablauf durch (er kann auch direkt install.ps1 ausführen).

Installation überprüfen

# 插件健康检查（在 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/status

• Studio öffnen: http://127.0.0.1:11862 (oder über das Startmenü / Taskleistensymbol klicken)

• In den DSH-Einstellungen sollte die Karte „Skin-Einstellungen" erscheinen; sage dem Assistenten „Skin wechseln", um das mcp__skin-studio__*-Tool auszulösen.

🚀 Verwendung

Nach der Installation und dem Neustart kannst du dem DSH-Assistenten einfach sagen:

• „Gib mir einen neuen Skin" / „Verwende dieses Bild als Hintergrund" → Der Assistent ruft automatisch mcp__skin-studio__* auf, um die Erstellung durchzuführen und im Studio eine Vorschau anzuzeigen;

• „Tausche den aktuellen Skin-Hintergrund aus" → Der Assistent ändert das aktuelle Design;

• Im Studio manuell anpassen (Hintergrund, Bereich, Token, Trennlinie) → Klicke auf In mein DSH schreiben, bestätige im erscheinenden Plan-Bestätigungsfenster manuell → Nach Neustart von DSH wirksam.

Skin-Wechsel-Ablaufdiagramm

用户指令 / 图片 ──▶ Agent Skill ──▶ MCP (design_create → asset_upload → theme_patch
                                      → theme_validate → preview_start)
                                              │
                                              ▼
                              隔离 DSH 预览（真实渲染，不碰你的 DSH）
                                              │
                                              ▼
                          Studio 可见确认（theme_apply_plan → theme_apply）
                                              │
                                              ▼
                              你的 DSH 皮肤生效（可随时 Restore 还原）

🗂️ Verzeichnisstruktur

├─ 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 预览）

🛠️ Entwicklung

pnpm install          # 安装依赖（需要 Node 22+ / pnpm 11+）
pnpm build            # 构建全部包
pnpm test             # 回归测试（会启动真实 rc.6 隔离预览）
pnpm controller       # 本地启动 Controller（开发）
pnpm dev              # Studio 开发模式（Vite）

🗑️ Deinstallation

1. Entferne alle Einträge zwischen den Kommentarblöcken # >>> dsh-skin-studio und # <<< dsh-skin-studio in %DSH_HOME%\profiles\<profile>\cordis.patch.yml;

2. Lösche %DSH_HOME%\profiles\node_modules\@dsh-skin und %DSH_HOME%\skills\deepseek-harness-skin-studio;

3. Starte DSH neu;

4. Um Studio-Daten zu bereinigen, lösche %LOCALAPPDATA%\DeepSeekHarnessSkinStudio.

🔒 Sicherheit und Kompatibilität

• Ziel-DSH-Version: 0.1.0-rc.6 (Fähigkeits-Pinning, bei Versionskonflikt schließt das Plugin fail-closed).

• Das Skin-Modell (ThemeSpec) erlaubt nur strukturierte Daten: Literal-CSS-Farben, inhaltsadressierte Bilder (sha256), kontrollierte Token; kein beliebiges CSS/JS/URL ist erlaubt.

• Die Vorschau verwendet ein isoliertes temporäres DSH, das dem Controller gehört; Bestätigung und Schreiben müssen manuell im sichtbaren Studio erfolgen.

• Guthabenabfrage: API-Key wird nur serverseitig geparst (DSH_SKIN_BALANCE_API_KEY → DEEPSEEK_API_KEY → %DSH_HOME%\.credentials.yaml), der Browser sieht nur das aggregierte Guthaben, der Schlüssel gelangt nicht in den Browser.

📄 Dokumentation

• docx/ — Implementierungsplan, Anforderungsspezifikation, Technisches Architekturdesign

• CHANGELOG.md — Änderungsprotokoll

• RELEASING.md — Veröffentlichungs-Checkliste (GitHub Release / npm)

📃 Lizenz

MIT © 2026 trrrrrryg