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. Провайдер описан так:
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.
Проверка связки
Запрос без интерфейса показывает, что ключ, адрес и модель на месте:
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. Сторонние сборки из поисковой выдачи никто не проверяет, ставить их не стоит.