DeepSeek Harness для дизайна.
Модель умеет писать JSX, но полезному дизайн-агенту недостаточно результата модели. Ему нужны правила бренда, референсы, инструменты, разрешения и цикл, который отрисовывает и проверяет результат. DeepSeek Harness предоставляет доступ к этим сопутствующим компонентам, а не скрывает их.
Для работы над интерфейсами явно формулируйте задание и цикл приёмки. Стандартный маршрут DeepSeek поддерживает только текст, поэтому самый надёжный базовый вариант — процесс на основе кода и спецификации; прикладывайте скриншоты только после выбора маршрута модели с заявленной поддержкой изображений.
Такая гибкость полезна в работе над дизайном, потому что качество создаваемого UI зависит от среды вокруг модели: постоянных правил проекта, переиспользуемых навыков, подходящего провайдера для текста или изображений, инструментов для работы с файлами и оболочкой, а также цикла проверки. В этом руководстве описаны кратчайший путь к рабочей конфигурации, важные для UI-задач ограничения и реальная граница интеграции с Open Design: у dsh пока нет собственного адаптера для Open Design, а существующий адаптер DeepSeek TUI относится к другому CLI.
Настройка DeepSeek Harness с нуля
Для публичной предварительной версии требуется Node.js `^22.19.0` или `>=24.0.0`. При первом запуске команда npm инициализирует веб-профиль, поэтому рабочий локальный UI можно открыть без клонирования репозитория.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- Учётные данные хранятся в виде ссылок: Веб-интерфейс хранит секреты провайдеров в `$DSH_HOME/.credentials.yaml`; в настройках остаётся ссылка на учётные данные, а UI получает скрытое описание вместо самого ключа.
- Фиксируйте версию предварительной инфраструктуры: Сопровождающие проекта прямо предупреждают, что будут происходить изменения, нарушающие совместимость. Зафиксируйте версию для командного процесса и изучайте изменения в релизе перед обновлением.
Почему плагинная среда подходит для работы над дизайном
Модель умеет писать JSX, но полезному дизайн-агенту недостаточно результата модели. Ему нужны правила бренда, референсы, инструменты, разрешения и цикл, который отрисовывает и проверяет результат. DeepSeek Harness предоставляет доступ к этим сопутствующим компонентам, а не скрывает их.
- Постоянный контекст дизайна: Стандартный загрузчик инструкций читает `AGENTS.md` и `CLAUDE.md` из иерархии проекта. Запишите токены, правила компонентов, адаптивные контрольные точки и критерии проверки там, где они будут доступны при каждом запуске.
- Переиспользуемые навыки: Локальные навыки можно хранить в `.dsh/skills` или `.agents/skills`. Навык для фронтенда может содержать точное техническое задание, чек-лист, примеры и скрипты, чтобы не начинать каждую UI-задачу с нуля.
- Выбор провайдера под задачу: В веб-интерфейсе можно настроить DeepSeek, провайдеров из каталога, например Anthropic или OpenAI, а также пользовательские конечные точки, совместимые с OpenAI. Для скриншотов используйте явно объявленный маршрут с поддержкой изображений, а для работы с текстом, кодом, DOM и спецификациями — собственный маршрут DeepSeek.
Ключевое ограничение одинаково для всех агентов: модульность не заменяет дизайнерское чутьё. Без продуманных ограничений для типографики, отступов, компонентов и взаимодействий рантайм будет добросовестно автоматизировать создание шаблонного результата. Роль Open Design — предоставлять и упорядочивать эти исходные данные для дизайна.
Практический процесс работы с UI и фронтендом в DeepSeek Harness
Для работы над интерфейсами явно формулируйте задание и цикл приёмки. Стандартный маршрут DeepSeek поддерживает только текст, поэтому самый надёжный базовый вариант — процесс на основе кода и спецификации; прикладывайте скриншоты только после выбора маршрута модели с заявленной поддержкой изображений.
- Запустите dsh из репозитория, выберите этот каталог в качестве рабочего пространства и укажите маршрут модели для текущей задачи.
- Запишите правила бренда в `AGENTS.md`, `CLAUDE.md` или указанный в них `DESIGN.md`: токены, базовые элементы, отступы, типографику, контрольные точки, состояния и запрещённые шаблоны.
- Загрузите специализированный навык для фронтенда из `.dsh/skills` или `.agents/skills`; храните примеры и скрипты проверки рядом с инструкциями.
- Попросите агента переиспользовать существующие компоненты, запустить приложение и проверить адаптивные состояния с помощью собственных тестов проекта или браузерных инструментов.
- Проверьте видимый результат, зафиксируйте конкретные расхождения и дорабатывайте небольшими коммитами. Откатывайте неудачные попытки, а не наслаивайте исправления на слабую основу.
В хорошем запросе указаны как визуальные ограничения, так и подтверждения, необходимые для проверки:
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.Если без скриншота не обойтись, сначала настройте провайдера с поддержкой изображений. DeepSeek Harness отклоняет изображение до отправки, если выбранный маршрут не заявляет поддержку изображений. Это полезная защита от ситуации, когда референс незаметно игнорируется.
Плагины, навыки и контекст проекта
Главные отличия DeepSeek Harness скрываются под интерфейсом чата. Благодаря дереву плагинов команды могут сделать процесс работы над дизайном частью рантайма, а не вставлять один и тот же запрос в каждую сессию.
- AGENTS.md и CLAUDE.md: Плагин инструкций загружает глобальный пользовательский файл и иерархию проекта, а после встроенных операций с файлами обнаруживает подходящие вложенные файлы инструкций. Используйте его для постоянных правил дизайна, а не разовых запросов.
- Навыки из файловой системы: Реестр навыков обнаруживает корневые каталоги проекта и пользователя, ранжирует дубликаты и предоставляет модели инструмент `skill`. Здесь естественно хранить правила мастерства фронтенд-разработки, доступности, проверки адаптивности и процедуры дизайн-системы.
- Профили и пакеты: Профиль объединяет упорядоченные пакеты плагинов и пользовательские изменения. Команды могут поддерживать специализированную для дизайна конфигурацию с нужными им провайдером, инструментами, политикой разрешений и источниками навыков.
- MCP и внешние возможности: Исходный код содержит возможности клиента MCP, но пользовательская конфигурация по-прежнему ориентирована на разработчиков. В предварительной версии рассматривайте интеграции как версионируемую работу над плагинами, а не как стабильный процесс с флажками в настройках.
Прежде чем строить долгосрочный внутренний процесс, изучите фактическое дерево с помощью `dsh --profile web --dump-config`. Вывод этой команды показывает, что действительно подключено и доступно для изменения; он надёжнее предположения о том, что каждый пакет репозитория активен в поставляемом профиле.
Риски предварительной версии и сложности работы с дизайном
Самые серьёзные ошибки возникают, когда предварительную версию считают стабильным продуктом, текстовый маршрут — моделью компьютерного зрения, а гибкую агентную среду — источником дизайнерского вкуса.
- Зафиксируйте версию до настройки: Изменения, нарушающие совместимость, прямо предусмотрены политикой предварительной версии. Зафиксируйте версию npm и делайте изменения профиля достаточно небольшими, чтобы их можно было проверить после обновления.
- Проверьте модальности выбранной модели: Собственный маршрут чат-запросов DeepSeek поддерживает только текст. Для преобразования скриншота в код выберите и объявите маршрут провайдера с поддержкой изображений, а не рассчитывайте, что вложение будет распознано автоматически.
- Передавайте требования к дизайну как данные: Предоставьте агенту токены, эталонные компоненты, референсные состояния и запрещённые шаблоны. Модульный рантайм без дизайн-контракта по-прежнему создаёт шаблонный UI.
- Проверяйте, что именно подключает профиль: Пакеты репозитория отражают доступные возможности, но не доказывают, что они включены в стандартном профиле. Изучите собранную конфигурацию, прежде чем документировать интеграцию или полагаться на неё.
Каждая мера снижения риска требует решения о контексте и проверке. Именно такую работу слой дизайна должен превращать в повторяемый процесс, чтобы каждому проекту не приходилось заново искать решение.
Что на самом деле представляет собой DeepSeek Harness
DeepSeek Harness (`dsh`) — разработанная DeepSeek AI агентная среда с лицензией MIT. Публичная предварительная версия для разработчиков включает локальный веб-интерфейс и средство запуска без интерфейса. Это не модель и не просто оболочка для терминала, а рантайм, который объединяет модель, инструменты, контекст, разрешения, сессии и пользовательский интерфейс в агента.
Её основная идея — «всё является плагином». Cordis собирает дерево, в котором адаптер модели, реестр инструментов, агентный цикл, файловую систему, оболочку, песочницу, навыки, субагентов, постоянное хранилище и UI можно подключать, заменять или изменять с помощью профилей и пакетов. Поставляемые профили `web` и `headless` — это отправные точки, а не фиксированные продукты.
- Локальный веб-интерфейс: По умолчанию команда `npx @deepseek-ai/dsh web` запускает рабочее пространство в браузере по адресу `127.0.0.1:3080`. Добавьте модель, выберите рабочее пространство и запускайте задачи через интерфейс диалога.
- Режим без интерфейса: Профиль `headless` запускает одну новую сессию с сохранением состояния, выводит окончательный ответ и завершает работу — это удобно для автоматизированных аудитов, сборок и повторяемых проверок дизайна.
- Модульный рантайм: Профили объединяют пакеты плагинов и ваши собственные изменения. Благодаря этому команда может менять провайдеров, инструменты, политики и поведение UI, не создавая форк агентного цикла.
- Разработчик: DeepSeek AI (официальный проект)
- Статус: предварительная версия для разработчиков; ожидаются изменения, нарушающие совместимость
- Лицензия: MIT
- Основная команда: `npx @deepseek-ai/dsh web`
DeepSeek Harness в сравнении с DeepSeek TUI и другими дизайн-агентами
Эти названия легко перепутать. DeepSeek Harness и указанный сейчас в Open Design DeepSeek TUI — отдельные проекты с разными исполняемыми файлами и статусом интеграции.
| Инструмент | Что это | Оптимальное применение в дизайне |
|---|---|---|
| DeepSeek Harness (`dsh`) | Официальная плагинная среда DeepSeek AI с локальным веб-интерфейсом и профилями без интерфейса; предварительная версия для разработчиков | Для команд, которым нужно компоновать рантайм, навыки, провайдеров, политики и UI вокруг процесса работы над дизайном |
| DeepSeek TUI (`deepseek` / `codewhale`) | Отдельный терминальный агент для программирования и адаптер DeepSeek, который сейчас поддерживает Open Design | Для использования DeepSeek внутри Open Design уже сегодня |
| OpenCode | Зрелый терминальный агент с открытым исходным кодом, не зависящий от провайдера | Для переключения между моделями в стабильном процессе TUI с AGENTS.md и MCP |
| Claude Code | Зрелый агент для программирования, доступный в терминале, IDE, приложении для компьютера и веб-интерфейсе | Для работы с логикой фронтенда, большим количеством визуальных референсов и готовыми интеграциями для дизайна |
| Open Design | Дизайн-пространство и библиотека, изначально рассчитанные на агентов и работающие с поддерживаемыми агентами для программирования | Для отобранных дизайн-систем, навыков, визуальных артефактов и локального процесса, не зависящего от одного поставщика моделей |
Выбирайте dsh, если хотите расширять саму агентную среду. Выбирайте DeepSeek TUI внутри Open Design, если вам нужен уже поддерживаемый адаптер DeepSeek и готовый слой дизайна. В будущем они могут сблизиться благодаря новому адаптеру, но сегодня это не взаимозаменяемые решения.
Использование DeepSeek Harness с дизайн-пространством, изначально рассчитанным на агентов
Open Design и DeepSeek Harness занимают соседние уровни. dsh компонует агентный рантайм, а Open Design предоставляет дизайн-системы, навыки и локальный процесс работы с артефактами, которые делают агента полезным для визуальных задач. У Open Design пока нет отдельного адаптера `dsh`, поэтому корректный рабочий процесс сегодня предполагает параллельное использование этих инструментов.
- Установите Open Design и используйте его дизайн-системы и навыки, чтобы определить визуальный контракт проекта.
- Храните получившийся `DESIGN.md`, референсы и инструкции проекта в том же репозитории, который DeepSeek Harness открывает как рабочее пространство.
- Запускайте dsh для экспериментов с плагинной архитектурой и задач с кодом; переиспользуйте те же токены, правила, ресурсы и критерии проверки вместо поддержки второго технического задания на дизайн.
- Если DeepSeek нужен непосредственно внутри Open Design уже сегодня, выберите существующий адаптер DeepSeek TUI. Рассматривайте будущий адаптер dsh как отдельную интеграцию, а не как уже доступную возможность.
В результате вы получаете одну принадлежащую вам кодовую базу и один переносимый дизайн-контракт для двух инструментов, работающих преимущественно локально. Open Design остаётся независимым от DeepSeek AI; DeepSeek и DeepSeek Harness являются товарными знаками соответствующего правообладателя.
Частые вопросы о DeepSeek Harness
-
01 Что такое DeepSeek Harness?
DeepSeek Harness (`dsh`) — официальная среда с открытым исходным кодом для запуска агентов от DeepSeek AI. Она объединяет модели, инструменты, контекст, сессии, политики, оркестрацию и UI через дерево плагинов Cordis. Публичный релиз сейчас доступен как предварительная версия для разработчиков с лицензией MIT.
-
02 Как установить и запустить DeepSeek Harness?
Установите поддерживаемую версию Node.js, затем выполните `npx @deepseek-ai/dsh web`. По умолчанию команда запускает локальный веб-интерфейс по адресу `http://127.0.0.1:3080`. Добавьте модель в разделе Settings → Models, выберите рабочее пространство и начните сессию.
-
03 DeepSeek Harness — официальный проект DeepSeek?
Да. Репозиторий опубликован в организации `deepseek-ai` на GitHub и описывает dsh как агентную среду, разработанную DeepSeek AI. Проект распространяется по лицензии MIT и явно помечен как предварительная версия для разработчиков.
-
04 Может ли DeepSeek Harness создавать UI по скриншотам?
Только если выбранный маршрут провайдера заявляет поддержку изображений на входе. Собственный маршрут чат-запросов DeepSeek в dsh поддерживает только текст, и среда отклоняет вложенные изображения перед отправкой по текстовому маршруту. Для работы со скриншотами используйте провайдера с поддержкой изображений или опишите целевой результат через код, DOM, токены и письменные спецификации.
-
05 Поддерживает ли DeepSeek Harness AGENTS.md и навыки?
Да. Плагин инструкций загружает файлы проекта, совместимые с AGENTS.md и CLAUDE.md. Провайдер навыков из файловой системы обнаруживает навыки проекта в `.dsh/skills` и `.agents/skills`, а также в настроенных пользовательских и встроенных корневых каталогах.
-
06 Чем DeepSeek Harness отличается от DeepSeek TUI?
Это отдельные инструменты. DeepSeek Harness использует исполняемый файл `dsh` и представляет собой официальный плагинный веб-интерфейс и рантайм без интерфейса от DeepSeek AI. DeepSeek TUI использует диспетчер `deepseek` или `codewhale` и является отдельным адаптером DeepSeek, который сейчас поддерживает Open Design.
-
07 Поддерживает ли Open Design DeepSeek Harness?
Пока не в виде отдельного собственного адаптера. Сейчас Open Design поддерживает другой адаптер — DeepSeek TUI. При этом дизайн-системы, навыки, файлы DESIGN.md и артефакты Open Design можно использовать вместе с dsh в одном локальном репозитории.
-
08 Где DeepSeek Harness хранит мой ключ API?
Согласно официальному руководству по моделям, ключи провайдеров хранятся в `$DSH_HOME/.credentials.yaml`. В настройках остаётся только ссылка на учётные данные, а веб-интерфейс получает скрытое описание вместо самого секрета.
Создайте слой дизайна вокруг своего рабочего процесса DeepSeek.
Уже сегодня используйте локальные дизайн-системы, навыки и процесс работы с артефактами Open Design и сохраните тот же контракт проекта для любого агентного рантайма, который выберете в будущем.