dsh-visual-skin

DeepSeek Harness Skin Studio — Una herramienta visual de cambio de piel con un solo clic para DeepSeek Harness

Un estudio visual de pieles para DeepSeek Harness (DSH): diseñe, previsualice y aplique pieles de forma segura con un solo clic, sin tocar archivos de configuración. Se distribuye como un Agent Skill + servidor MCP + complemento DSH, con un instalador PowerShell de un solo paso.

Después de la instalación, tu asistente de IA puede completar automáticamente el flujo completo de cambio de piel con solo una imagen: subir imagen → crear tema → previsualización aislada → confirmación humana para aplicar; también puedes abrir una página web independiente de Studio para ajustar visualmente la piel y escribirla en DSH con un solo clic.

✨ Funcionalidades

📦 Instalación

Requisitos previos

Método 1: Instalación por línea de comandos (recomendado)

# 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

El instalador completa automáticamente:

1. Construir/reutilizar el tiempo de ejecución portátil autocontenido (Controlador + Studio + MCP + complemento, aproximadamente 51 MB, instalado en el directorio Skill);

2. Instalar Skill en %DSH_HOME%\skills\deepseek-harness-skin-studio (el asistente DSH obtiene inmediatamente la habilidad);

3. Registrar el complemento DSH (bloque alojado en cordis.patch.yml, que incluye la tarjeta de configuración Configuración de piel);

4. Registrar el servidor MCP (mcp__skin-studio__*, apuntando al tiempo de ejecución autocontenido instalado);

5. Iniciar Studio (Controlador, puerto predeterminado 11862, navegador accede a http://127.0.0.1:11862);

6. Si se detecta Codex, sincronizar automáticamente el Skill y registrar el MCP de Codex.

Después de la instalación, reinicia DSH una vez (o en el lanzador del escritorio) para que el parche de perfil y el cliente MCP surtan efecto.

Parámetros opcionales

Ejemplo (instalación personalizada + reinicio automático de DSH después de la instalación):

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

Método 2: Instalación por IA

Entrega este repositorio a cualquier agente y dile:

Por favor, lee el README y el install.ps1 de este repositorio, luego ejecuta la instalación.

El agente completará la instalación siguiendo el proceso anterior (también puede ejecutar directamente install.ps1).

Verificar la instalación

# 插件健康检查（在 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 abierto: http://127.0.0.1:11862 (o haz clic en el menú de inicio/icono de la bandeja)

• En la página de configuración de DSH debería aparecer la tarjeta Configuración de piel; dile al asistente "cambia la piel" para activar la herramienta mcp__skin-studio__*.

🚀 Uso

Después de la instalación y el reinicio, simplemente dile al asistente DSH:

• "Cámbiame la piel" / "Usa esta imagen como fondo" → El asistente llama automáticamente a mcp__skin-studio__* para crear la piel y previsualizarla en Studio;

• "Cambia el fondo de la piel actual" → El asistente modifica el diseño actual;

• Ajusta manualmente en Studio (fondo, área, token, línea divisoria) → Haz clic en Escribir en mi DSH, confirma manualmente en la ventana de plan emergente → Reinicia DSH para que surta efecto.

Diagrama de flujo de cambio de piel

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

🗂️ Estructura de directorios

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

🛠️ Desarrollo

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

🗑️ Desinstalación

1. Elimina todas las entradas entre los bloques de comentarios # >>> dsh-skin-studio y # <<< dsh-skin-studio en %DSH_HOME%\profiles\<profile>\cordis.patch.yml;

2. Elimina %DSH_HOME%\profiles\node_modules\@dsh-skin y %DSH_HOME%\skills\deepseek-harness-skin-studio;

3. Reinicia DSH;

4. Si necesitas limpiar los datos de Studio, elimina %LOCALAPPDATA%\DeepSeekHarnessSkinStudio.

🔒 Seguridad y compatibilidad

• Versión objetivo de DSH: 0.1.0-rc.6 (fijación de capacidades, si la versión no coincide, el complemento falla de forma cerrada).

• El modelo de piel (ThemeSpec) solo permite datos estructurados: colores CSS literales, imágenes direccionadas por contenido (sha256), tokens controlados; no se aceptan CSS/JS/URL arbitrarios.

• La previsualización utiliza un DSH temporal aislado propiedad del controlador; la confirmación y escritura deben ser realizadas manualmente por un humano en el Studio visible.

• Consulta de saldo: la clave API solo se analiza en el lado del host (DSH_SKIN_BALANCE_API_KEY → DEEPSEEK_API_KEY → %DSH_HOME%\.credentials.yaml), el navegador solo ve el saldo agregado, la clave no se almacena en el navegador.

📄 Documentación

• docx/ — Plan de implementación, documento de especificación de requisitos, documento de especificación de diseño de arquitectura técnica

• CHANGELOG.md — Registro de cambios

• RELEASING.md — Lista de verificación de publicación (GitHub Release / npm)

📃 Licencia

MIT © 2026 trrrrrryg