К содержимому
Блог

DeepSeek Harness: что это, установка и подключение моделей

DeepSeek Harness: что это, установка и подключение моделей

DeepSeek Harness, команда dsh, это агентная оболочка с веб-интерфейсом, сессиями и инструментами: она читает проект, правит файлы, запускает команды и принимает плагины. Модель в неё не вшита, поэтому Harness умеет работать с любым OpenAI-совместимым провайдером, в том числе с Relay. Ниже что это за продукт, как его поставить, как прописать Relay и чем рискуете, если запускать его на рабочей машине.

Коротко

  • Harness работает с OpenAI-совместимыми провайдерами: Relay подключается адресом https://relay-llm.ru/v1 и ключом из консоли.

  • Нужен Node.js 24, ставится командой npm install -g @deepseek-ai/dsh, запускается dsh web.

  • Проверить связку можно без интерфейса: dsh --profile headless "Reply with OK only".

  • По описанию самого проекта, это превью без аудита безопасности: запускайте в изолированной среде.

Что такое DeepSeek Harness

По описанию в репозитории проекта (сведения нашего источника на 29 октября 2026), это открытый «agent harness» от DeepSeek под лицензией MIT. Архитектура построена на плагинах: даже адаптер модели и цикл агента подключаются как плагины. Интерфейс умеет субагентов, фоновые задачи и режим, где плагины пишутся прямо в чате. Статус проекта в тех же материалах назван публичным превью, а значит, несовместимые изменения между версиями вполне возможны.

Для читателя Relay важна одна деталь: Harness не привязан к моделям DeepSeek. Вы указываете провайдера, адрес и список моделей, а остальное он делает сам. По тем же материалам, веб-интерфейс переведён на русский, так что работать в нём можно без английского.

Способы установки

СпособКоманда или шагКогда выбирать
Глобальный пакетnpm install -g @deepseek-ai/dsh, затем dsh webкак в руководстве Relay, команда dsh остаётся в терминале
Разовый запускnpx @deepseek-ai/dsh webпопробовать, ничего не устанавливая
Десктопное приложениезагрузка со страницы Harness на сайте DeepSeek (macOS на Apple silicon и Windows 64-бит, по данным источника)если нужна обычная программа без терминала
Сборка из исходниковклонировать репозиторий организации deepseek-ai и собратьправить ядро и писать плагины

Для первых двух путей нужен Node.js 24, npm идёт в комплекте. После установки откройте терминал заново и проверьте версии: вывод node --version должен начинаться с v24.

Скачивайте только с официального сайта DeepSeek и из репозитория организации deepseek-ai. Поисковая выдача по запросу вроде «deepseek harness скачать» приносит и сторонние сборки, а их содержимое никто не гарантирует. Пакеты для npm берите из области @deepseek-ai.

Подключение Relay

Ключи Relay начинаются с sk-rly-, создаются в консоли. Руководство Relay предлагает команду, которая за один проход ставит Harness, делает резервную копию существующей конфигурации, объединяет её с новой, сохраняет ключ, прописывает модели Relay и запускает dsh web. Ваша тема и прочие настройки при этом не удаляются. Целиком скрипт для macOS, Linux и Windows приведён на странице DeepSeek Harness в разделе интеграций, здесь покажем, что он в итоге записывает.

Настройки лежат в settings.yaml внутри каталога ~/.dsh (его можно переопределить переменной DSH_HOME). Ключ скрипт сохраняет в файле .env рядом, как переменную RELAY_API_KEY. Провайдер описан так:

yaml
llm-pi-ai:
  providers:
    relay:
      displayName: Relay
      apiKeyEnv: RELAY_API_KEY
      api: openai-completions
      baseURL: https://relay-llm.ru/v1
      models:
        - id: deepseek-v4.1-flash
          name: DeepSeek V4.1 Flash
        - id: deepseek-v4.1-flash-1017-free
          name: DeepSeek V4.1 Flash 1017 (Free)
        - id: deepseek-v4-pro
          name: DeepSeek V4 Pro
        - id: gpt-6-astra
          name: GPT-6 Astra
        - id: gpt-5.6-sol
          name: GPT-5.6 Sol
agent-default-model:
  provider: relay
  model: deepseek-v4.1-flash

Протокол задан как openai-completions, то есть запросы идут в формат Chat Completions. Модель по умолчанию определяет блок agent-default-model. Идентификаторы сверяйте с каталогом: в нём модели сменяются, а актуальный список отдаёт GET https://relay-llm.ru/v1/models.

DeepSeek V4.1 Flash0,06 $ за 1 млн входных токенов
DeepSeek V4 Pro0,22 $ за 1 млн входных токенов

Проверка связки

Запрос без интерфейса показывает, что ключ, адрес и модель на месте:

bash
export RELAY_API_KEY="..."
dsh --profile headless "Reply with OK only"

Если терминал вернул OK, Harness дошёл до модели через Relay. Нет ответа? Убедитесь, что export выполнен в том же окне терминала: переменная окружения живёт только в нём, и в новом окне её придётся задать заново. После этого выполните dsh web и откройте локальный адрес, который покажет терминал: обычно это порт 3080 на вашем компьютере. Чтобы работать над конкретным проектом, перед запуском перейдите в его настоящий каталог, а не подставляйте путь-заглушку из примеров.

Если пришёл ответ 401, проверьте, что ключ скопирован целиком и без пробелов, не удалён и начинается с sk-rly-. Не помогло, создайте новый ключ в консоли.

Как сменить модель

Добавьте нужные идентификаторы в список models и измените agent-default-model.model. Существующие сессии могут продолжить работу со своей исходной моделью, поэтому после правки обновите страницу и начните новую сессию либо переключите модель вручную в селекторе. Для сравнения моделей на одном поручении удобно держать в списке две-три: сильную и более лёгкую. Что умеет каждая, видно в карточках каталога: там указаны контекст, возможности и пример запроса. Если выбираете между ними впервые, прогоните одно и то же поручение через обе и сравните результат и число токенов в журнале.

Расход агента растёт вместе с контекстом, а одно действие в интерфейсе может вылиться в несколько обращений к модели. Заведите для Harness отдельный ключ: суточный лимит расходов и список разрешённых моделей задаются на ключ, а остаток видно запросом GET /v1/key. Как читать списания, описано в разделе про оплату.

Безопасность превью

Инструмент исполняет код и команды, которые написала модель, и подгружает сторонние плагины. По тексту SAFETY.md в репозитории проекта (сведения источника), продукт экспериментальный, аудит безопасности не проходил и считаться готовым к продакшену не должен. Практические выводы такие:

  • запускайте Harness в виртуальной машине, контейнере или хотя бы под отдельной учётной записью;

  • держите в рабочей папке только то, что можно потерять, и делайте резервные копии;

  • не кладите туда ключи от боевых систем;

  • читайте код плагинов и команды до первого запуска.

Плагины и MCP-серверы расширяют возможности, но и поверхность риска тоже. Всё, что вернул инструмент, попадает в промпт и уходит поставщику модели, а Relay, по странице безопасности, тексты запросов и ответов не хранит.

DeepSeek Harness бесплатный?

Сам инструмент открыт под лицензией MIT. Платить нужно за модели: в Relay токены списываются с баланса, подписки нет. Для проверки связки в каталоге есть модель с пометкой Free, её условия смотрите в карточке.

Можно ли подключить к Harness не DeepSeek, а другую модель?

Можно, если провайдер совместим с OpenAI. В списке models рядом с моделями DeepSeek в примере стоят gpt-6-astra и gpt-5.6-sol из каталога Relay.

Где скачать DeepSeek Harness?

На официальном сайте DeepSeek и в репозитории организации deepseek-ai. Сторонние сборки из поисковой выдачи никто не проверяет, ставить их не стоит.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.