AIREITERDeepSeek Harness (DSH) — оболочка для coding agent, рассчитанная на V4-Pro и V4-Flash. Пакет @deepseek-ai/dsh вышел в npm 13 августа 2026 года — в тот же день, когда V4-Pro стал общедоступным. Для работы достаточно стандартного API-ключа DeepSeek, а установка занимает четыре шага; в комплекте есть и система плагинов. Но перед установкой важно не перепутать его с другим проектом: независимый Python-пакет deepseek-harness появился на PyPI ещё в мае и тоже предоставляет команду dsh. Это совершенно разные инструменты.
Что такое DeepSeek Harness (DSH)
Оболочка coding agent отвечает за выбор контекста, обработку ошибок инструментов, перепланирование и определение момента завершения задачи. Поэтому даже при одной и той же модели результаты бенчмарков могут заметно меняться в зависимости от конфигурации harness. Именно по этой причине DeepSeek публикует настройки оболочки вместе с результатами агентских тестов, а не ограничивается «голыми» показателями модели.
Похожие примеры уже хорошо знакомы рынку. Claude Code — оболочка для моделей Anthropic Claude, Cursor объединяет разных провайдеров внутри IDE, а GitHub Copilot использует модели OpenAI в VS Code. Агентом становится связка модели и harness: такая система умеет редактировать файлы, запускать команды и обращаться к API, а не только отвечать на отдельные запросы. Для V4-Pro и V4-Flash эту роль выполняет DSH.
DSH — собственная оболочка DeepSeek, созданная специально для V4-Pro и V4-Flash, примерно так же, как Claude Code оптимизирован под Sonnet и Opus. Впервые публично о ней упомянули в июльской записи changelog по бета-версии V4-Flash: агентские бенчмарки запускались в «минимальном режиме DeepSeek Harness (скоро будет выпущен)» с параметром effort=max, top_p=0.95 и temperature=1.0.
«Минимальный режим» — это урезанная конфигурация с максимальным усилием рассуждений и фиксированными параметрами сэмплирования. Такой подход нужен, чтобы результаты агентских тестов можно было воспроизводить, а не подгонять настройки под каждый бенчмарк. Полный продукт, включая систему плагинов, о которой говорилось в сообщениях о бета-тестировании, шире тестового раннера, на котором получены опубликованные результаты.
И V4-Pro, и V4-Flash поддерживают контекстное окно на 1 млн токенов и три уровня усилий рассуждений: low для простых задач, high для обычной работы агента и max для сложных задач (официальный changelog, запись от 13 августа).
Как установить @deepseek-ai/dsh
Понадобится Node.js версии 18 или новее — такое же минимальное требование указано в официальной инструкции DeepSeek по интеграции с Claude Code.
- Проверьте Node.js:
node --version(нужна версия 18+; если на macOS Node.js не установлен, используйтеbrew install node). - Установите пакет глобально:
npm install -g @deepseek-ai/dsh. - Укажите ключ:
export DEEPSEEK_API_KEY=<your key>, получив его на платформе DeepSeek. - Запустите harness:
cd /path/to/my-project && dsh.
Ошибки доступа при глобальной установке npm на macOS встречаются часто. Рекомендуемый npm вариант — настроить глобальный префикс, доступный пользователю (npm config set prefix ~/.npm-global). Команда sudo тоже сработает, но впоследствии может привести к конфликтам прав при обновлении пакетов.
Отдельная цена на сам harness пока не объявлена. Стоимость модели, которая работает за ним, изменится 16 августа в 16:00 UTC: для семейства V4 появятся пиковые и непиковые тарифы, причём непиковая ставка будет вдвое ниже пиковой (официальный changelog).
Бенчмарки V4-Pro GA: где виден вклад harness
Ниже — официальные результаты из записи changelog от 13 августа. Все они получены с описанной выше конфигурацией harness:
| Бенчмарк | V4-Pro GA | V4-Flash beta |
|---|---|---|
| Terminal Bench 2.1 | 87.9 | 82.7 |
| Cybergym | 83.3 | 76.7 |
| Toolathlon-Verified | 74.1 | 70.3 |
| DSBench-FullStack | 71.1 | 68.7 |
| DSBench-Hard | 67.2 | 59.6 |
| DeepSWE | 62.7 | 54.4 |
| NL2Repo | 61.5 | 54.2 |
| Agents' Last Exam | 25.7 | 25.2 |
| HLE (with tools) | 60.0 | — |
Преимущество V4-Pro над Flash в этих тестах составляет от 0,5 до 8,3 балла. Самый большой разрыв — в DeepSWE (+8,3) и NL2Repo (+7,3), а главным результатом выглядит 87,9 в Terminal Bench 2.1. Независимое воспроизведение на публичном harness, опубликованное на r/LocalLLaMA, дало Flash 0731 результат 82,7 по итогам 445 испытаний — в пределах разброса, связанного с конфигурацией, это совпадает с заявлением DeepSeek. DSBench-FullStack и DSBench-Hard — внутренние наборы для оценки, поэтому приведённые в этих строках цифры получены самой DeepSeek.
Все опубликованные тесты запускались с уровнем усилий max. Для реальной работы DeepSeek рекомендует low для простых задач, high для обычных агентских сценариев и max для сложных задач.
@deepseek-ai/dsh и pip install deepseek-harness: не перепутайте пакеты
Пакеты с почти одинаковыми названиями вышли с разницей в несколько месяцев, но общего между ними ничего нет.
@deepseek-ai/dsh (npm) | deepseek-harness (PyPI) | |
|---|---|---|
| Разработчик | DeepSeek (официальный пакет) | Henry Zhang, независимый разработчик |
| Первый релиз | 13 августа 2026 года | 9 мая 2026 года |
| Язык | Node.js | Python |
| Назначение | Оболочка coding agent | Библиотека-адаптер протоколов |
| Установка | npm install -g @deepseek-ai/dsh | pip install deepseek-harness |
| Лицензия | Пока не подтверждена | MIT |
Проект на PyPI — это библиотека-адаптер протоколов, а не coding agent. Её автор описал 16 особенностей V4 API по итогам более 270 испытаний и оформил их в контракт из 10 правил. Контракт поставляется в четырёх вариантах: Python-библиотека, CLI dsh, MCP-сервер и Anthropic Skill. Вот три момента, которые особенно важно учитывать при разработке под V4:
- В многошаговых циклах с инструментами сервер возвращает HTTP 400, если в сообщениях ассистента не сохранить
reasoning_content; это воспроизвелось 3 раза из 3 на обеих моделях. - Эндпоинт
/betaбез уведомления переназначаетv4-proнаdeepseek-reasoner. - Попадания в кэш появляются блоками по 256 токенов после префикса длиной 1 024 токена; в одном цикле из пяти ходов равновесие достигло 95%, что примерно в 50 раз снизило эффективную стоимость входных данных.
Оба пакета устанавливают команду dsh — отсюда и возникает путаница. Если вы использовали pip, у вас библиотека-адаптер. Если установка выполнялась через npm с областью @deepseek-ai, вы получили harness.
Как использовать DeepSeek V4 в роли coding agent без DSH
Если нужен coding agent на базе DeepSeek, а документация DSH ещё не устоялась, можно воспользоваться тремя поддерживаемыми вариантами из официальной инструкции DeepSeek:
| Инструмент | Настройка | Модели DeepSeek | Для чего подходит | |
|---|---|---|---|---|
| Claude Code | Переменные окружения, совместимый с Anthropic эндпоинт | V4-Pro (основная), V4-Flash (субагент) | Терминальная разработка с максимальным усилием | |
| OpenCode | Сценарий /connect, выбор провайдера DeepSeek | V4-Pro | Открытый код, интерактивный выбор провайдера (нужна версия v1.14.24+) | |
| OpenClaw | `curl -fsSL https://openclaw.ai/install.sh \ | bash` | V4-Pro или V4-Flash | Персональный ассистент со Skills и интеграцией с чатами |
В конфигурации Claude Code модели DeepSeek распределяются по слотам Claude:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=maxЕсть один нюанс с соответствием моделей: запросы к claude-sonnet направляются на Flash, а не на Pro. В документации DeepSeek Pro назначен слоту Opus, а Flash — слоту Haiku. Все три инструмента описаны как сторонние интеграции, для которых DeepSeek не гарантирует эффективность или безопасность. Более широкое сравнение есть в нашем материале о LLM для coding agents, а детали API — в гайде по V4-Pro GA API.
FAQ
@deepseek-ai/dsh — это официальный DeepSeek Harness?
Область @deepseek-ai в npm совпадает с организацией DeepSeek на GitHub, а дата релиза укладывается в обещанное в changelog от 31 июля окно. Сообщество подтверждает, что пакет устанавливается. При этом в changelog DeepSeek от 13 августа описан релиз V4-Pro GA, но сам harness там не назван, а npm блокирует автоматическую проверку страницы пакета.
Чем DSH отличается от deepseek-harness на PyPI?
Это разные продукты от разных разработчиков. @deepseek-ai/dsh — оболочка coding agent в npm, выпущенная 13 августа. Команда pip install deepseek-harness устанавливает независимую Python-библиотеку-адаптер протоколов авторства Henry Zhang (MIT, 9 мая), которая учитывает особенности V4 API. Оба пакета предоставляют команду dsh.
Нужен ли API-ключ DeepSeek для работы с DSH?
Да. Harness обращается к V4-Pro и V4-Flash через DeepSeek API, поэтому использование оплачивается по числу токенов. Сам npm-пакет устанавливается бесплатно; платить нужно за обращения к API. 16 августа в 16:00 UTC тарифы семейства V4 перейдут на пиковые и непиковые ставки, причём непиковая будет вдвое ниже пиковой.
Как DSH выглядит на фоне Claude Code?
Claude Code — зрелый и хорошо документированный терминальный coding agent, который уже умеет работать с DeepSeek через совместимый с Anthropic эндпоинт. Сильная сторона DSH — оптимизация под конкретные модели: это harness, рассчитанный на особенности протокола V4, а не адаптированный к нему постфактум. По раскрытой конфигурации бенчмарков такое преимущество выглядит правдоподобно, но независимых подтверждений пока нет — сначала должны появиться документация DSH и результаты более широкого тестирования сообществом.
Чем AI harness отличается от AI agent?
Harness — это инфраструктурный слой: управление контекстом, маршрутизация инструментов и координация задач. Agent — объединённая система, в которой модель работает внутри harness и способна выполнять многошаговые действия. Любому агенту нужен harness, но одна и та же оболочка может обслуживать разные модели. Claude Code, Cursor, Copilot и DSH — harness; агентами их делает модель, которая работает внутри.
Статус релиза: что подтверждено, а что сообщило сообщество
Факты в этой статье опираются на два уровня источников.
Официально подтверждено (changelog DeepSeek API с датированными записями):
deepseek-v4-proдостиг статуса GA 13 августа, получил нативную поддержку OpenAI Responses API и три уровня усилий рассуждений (changelog).- V4-Flash вышел в публичную бету 31 июля; бенчмарки для него запускались в «минимальном режиме DeepSeek Harness (скоро будет выпущен)».
- Все показатели V4-Pro GA и V4-Flash beta взяты из этих записей changelog.
- 16 августа в 16:00 UTC тарифы семейства V4 изменятся на пиковые и непиковые.
- Инструкция по интеграции Claude Code, OpenCode и OpenClaw является официальной документацией.
Сообщается сообществом (посты на Reddit и воспроизведённые скриншоты):
@deepseek-ai/dshустанавливается и работает. u/Testx01 опубликовал ссылку на пакет в 12:56 UTC 13 августа; через несколько минут к обсуждению присоединился u/Available_Yam_6267. Область@deepseek-aiв npm совпадает с организацией DeepSeek на GitHub.- Страница пакета npm блокирует автоматические запросы, поэтому сведения о версии, лицензии и сопровождающем пока нельзя подтвердить через реестр.
«Deepseek harness уже в npm :)» — u/Testx01, r/DeepSeek, 13 августа
- В воспроизведённом сообщении из внутренней беты говорится о группе из 369 участников. Она выпустила финальную внутреннюю сборку 11 августа, а разработчикам плагинов предложили помечать репозитории тегом
#dshперед публичной бетой 13 августа. После запуска плагины можно будет переносить в личные аккаунты. - Сообщения сообщества со ссылкой на китайские технологические СМИ утверждали в мае, что DeepSeek формирует отдельную команду для harness и нанимает специалистов на продуктовые роли, связанные с Agent Harness.
Информацию о возможностях DSH, его CLI и плагинах стоит считать подтверждённой сообществом до тех пор, пока DeepSeek не опубликует официальную документацию на собственном сайте.