dsh-visual-skin

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

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

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

✨ Функции

📦 Установка

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

Способ 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 МБ, устанавливается в каталог Skill);

2. Установку Skill в %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 автоматическую синхронизацию Skill и регистрацию MCP для Codex.

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

Дополнительные параметры

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

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

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

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

Пожалуйста, прочитайте 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_HOME%\profiles\<profile>\cordis.patch.yml все записи между блоками комментариев # >>> dsh-skin-studio и # <<< dsh-skin-studio;

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 Key обрабатывается только на стороне хоста (DSH_SKIN_BALANCE_API_KEY → DEEPSEEK_API_KEY → %DSH_HOME%\.credentials.yaml), браузер видит только агрегированный баланс, ключ не попадает в браузер.

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

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

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

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

📃 Лицензия

MIT © 2026 trrrrrryg