dsh-visual-skin

DeepSeek Harness Skin Studio — Инструмент для визуальной смены тем оформления в один клик для DeepSeek Harness

Visual skin studio для DeepSeek Harness (DSH): создавайте, просматривайте и безопасно применяйте темы оформления в один клик — без редактирования конфигурационных файлов. Поставляется как Agent Skill + MCP сервер + плагин DSH, с установщиком PowerShell в один шаг.

После установки ваш ИИ-ассистент может автоматически выполнить полный процесс смены темы, используя всего одно изображение: загрузка изображения → создание темы → изолированный предпросмотр → ручное подтверждение применения. Также можно открыть отдельную веб-страницу Studio для визуальной настройки темы и применить её в DSH одним нажатием.

✨ Возможности

Related MCP server: dstools

🎬 Демонстрация

Анимация создана huashu-design · Раскадровка: docs/demo/storyboard.md · Доска направлений: docs/demo/direction-boards.html

📦 Установка

Предварительные требования

Способ 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

Установщик автоматически выполняет:

1. Сборка/повторное использование самодостаточной портативной среды выполнения (Controller + Studio + MCP + плагин, ~51 МБ, устанавливается в каталог навыков);

2. Установка навыка в %DSH_HOME%\skills\deepseek-harness-skin-studio (ассистент DSH немедленно получает этот навык);

3. Регистрация плагина DSH (блок cordis.patch.yml, содержащий карточку настроек 皮肤设置);

4. Регистрация MCP-сервера (mcp__skin-studio__*, указывает на установленную портативную среду выполнения);

5. Запуск Studio (Controller, порт по умолчанию 11862, браузер открывает http://127.0.0.1:11862);

6. При обнаружении Codex автоматическая синхронизация навыка и регистрация Codex MCP.

После установки перезапустите DSH один раз (или перезапустите в лаунчере рабочего стола), чтобы применились патч профиля и клиент MCP.

Необязательные параметры

Пример (пользовательская установка + автоматический перезапуск DSH после установки):

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

Способ 2: Установка через ИИ

Передайте этот репозиторий любому агенту и скажите ему:

Прочитайте README и install.ps1 из этого репозитория, затем выполните установку.

Агент выполнит установку по описанному выше процессу (он также может напрямую запустить 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/status

• Studio открывается: 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）

🗑️ Удаление

1. Удалите все записи между комментариями # >>> dsh-skin-studio и # <<< dsh-skin-studio в файле %DSH_HOME%\profiles\<profile>\cordis.patch.yml;

2. Удалите каталоги %DSH_HOME%\profiles\node_modules\@dsh-skin и %DSH_HOME%\skills\deepseek-harness-skin-studio;

3. Перезапустите DSH;

4. Для очистки данных Studio удалите каталог %LOCALAPPDATA%\DeepSeekHarnessSkinStudio.

🔒 Безопасность и совместимость

• Целевая версия DSH: 0.1.0-rc.6 (привязка возможностей; при несоответствии версий плагин отключается с ошибкой).

• Модель темы (ThemeSpec) допускает только структурированные данные: литералы CSS-цветов, изображения с адресацией по содержимому (sha256), контролируемые токены; не допускаются произвольные CSS/JS/URL.

• Для предпросмотра используется изолированный временный DSH, которым управляет Controller; подтверждение и запись выполняются только человеком в видимом интерфейсе Studio.

• Запрос баланса: API-ключ обрабатывается только на стороне хоста (DSH_SKIN_BALANCE_API_KEY → DEEPSEEK_API_KEY → %DSH_HOME%\.credentials.yaml), браузер видит только агрегированный баланс, ключ не попадает в браузер.

📄 Документация

• docx/ — План реализации, спецификация требований, техническая архитектура

• CHANGELOG.md — История изменений

• RELEASING.md — Чек-лист релиза (GitHub Release / npm)

📃 Лицензия

MIT © 2026 trrrrrryg