DeepSeek Harness (dsh) — это открытая «обвязка» (harness) для ИИ-агента от DeepSeek: программа, которая даёт языковой модели доступ к файлам, терминалу и инструментам, ведёт план и журнал сессии. Агент складывается из модели и обвязки, поэтому dsh не новая нейросеть и не чат. Модель подключается отдельно, по умолчанию это DeepSeek-V4.1-Flash через API. Сам Harness бесплатный (лицензия MIT), ставится десктоп-приложением для Windows x64 и Mac на Apple silicon или одной командой npx @deepseek-ai/dsh web.
Коротко:
- Код открыт 13 августа 2026 года, проект в статусе developer preview. На 6 октября стабильного релиза нет: тег latest в npm стоит на 0.2.0-rc.2, а README прямо обещает ломающие изменения.
- Платите только за модель. DeepSeek-V4.1-Flash вне пика стоит $0,15 за 1 млн входных токенов без кэша и $0,60 за 1 млн выходных; в пиковые часы (по будням 04:00–07:00 и 09:00–13:00 по Москве) вдвое дороже.
- Из России API DeepSeek 1 октября отвечал без VPN, но карты российских банков платформа не принимает. Выход: иностранная или виртуальная карта либо рублёвый шлюз, подключённый в dsh как свой провайдер.
- Официальные адреса: deepseek.com, github.com/deepseek-ai, deepseek-harness.github.io и npm-пакет @deepseek-ai/dsh. В топ-10 Яндекса 6 октября было четыре сторонних сайта с Harness в домене.
Что такое DeepSeek Harness простыми словами
Сама по себе языковая модель только отвечает текстом. Чтобы она правила код, запускала тесты или собирала отчёт из таблиц, нужна программа вокруг неё: передать задачу и контекст, выполнить предложенные команды, спросить у человека разрешение, записать каждый шаг. Такую программу и называют harness. Свой вариант DeepSeek выпустила под именем DeepSeek Harness, в поиске его часто пишут как «дипсик харнесс». Claude Code и Codex по сути тоже обвязки, только Anthropic и OpenAI делали их под свои модели.
Ставка DeepSeek Harness вынесена в описание репозитория: «Everything is a Plugin». По документации плагинами сделаны адаптер модели, реестр инструментов, журнал сессии и даже сам цикл агента, так что любую часть можно заменить конфигурацией, без форка. Основа проекта — фреймворк Cordis. Журнал сессии только дописывается, из него восстанавливается каждый запрос к модели, и сессию можно продолжить или разветвить.
Режимов работы агента четыре: стандартный, Creator (агент пишет и ставит плагины по просьбе в чате), PTC (модель пишет одну программу, которая сама вызывает инструменты) и минимальный. С версии 0.2.1-alpha.1 по умолчанию включается стандартный.
Чем DeepSeek Harness не является:
- Не модель. Цены, контекст и качество ответов относятся к DeepSeek-V4.1-Flash или V4-Pro, Harness только вызывает их по API.
- Не замена chat.deepseek.com. Чат живёт в браузере, а dsh работает на вашем компьютере, с вашими файлами и командами.
- Не форк Claude Code. Кодовая база своя, а Claude Code и Codex dsh умеет запускать как субагентов (с версии 0.1.0-rc.8).
- Не продукт с гарантиями. В SAFETY.md сказано, что аудита безопасности не было, а песочница и подтверждения не гарантируют изоляцию.
| DeepSeek Harness | Claude Code | Codex | OpenCode | |
|---|---|---|---|---|
| Разработчик | DeepSeek | Anthropic | OpenAI | открытый проект anomalyco/opencode |
| Лицензия | MIT | закрытая, «All rights reserved» | Apache-2.0 | MIT |
| Интерфейс | десктоп, веб, Python SDK, headless | терминал | CLI, десктоп-приложение ChatGPT, расширение для VS Code | терминал, веб |
| Модели DeepSeek | встроены, Flash по умолчанию | через адрес api.deepseek.com/anthropic | через Responses API, есть скрипт настройки от DeepSeek | команда /connect → deepseek |
У DeepSeek есть официальные инструкции для всех трёх соседей, поэтому выбирать приходится агента, а не модель. Для готового помощника в коде подойдут Claude Code или Codex (разборы: Claude Code в России, Codex в России). dsh интересен, когда хочется менять сам агент: инструменты, цикл, плагины.
Официальные адреса DeepSeek Harness и сайты-клоны
Скачивайте и читайте документацию только здесь:
| Что | Где |
|---|---|
| Страница продукта и установщики | deepseek.com/en/harness (файлы отдаются с download.deepseek.com) |
| Исходный код | github.com/deepseek-ai/deepseek-harness |
| Документация | deepseek-harness.github.io/deepseek-harness (на неё ссылаются README и документация API DeepSeek) |
| Пакет npm | @deepseek-ai/dsh |
6 октября в выдаче Яндекса на 2, 5, 8 и 9 местах стояли сторонние сайты с DeepSeek Harness в домене. Один называет себя «официальной средой выполнения» на домене в зоне .ru. Другой раздаёт .dmg и .exe из чужого репозитория на GitHub. Третий держит страницу «Скачать» со старой версией 0.1.2-rc.1. Часть таких сайтов честно пишет, что не связана с DeepSeek, но установщик из стороннего репозитория остаётся чужим кодом с доступом к вашим файлам и терминалу. Правило простое: адреса нет в таблице выше, значит, это не DeepSeek.
Как установить DeepSeek Harness
DeepSeek Harness Desktop для Windows и macOS
Если терминал не нужен, берите десктоп. Скачать его можно только со страницы продукта, там две кнопки: macOS (Apple silicon) и Windows (64-bit). Установщики весят около 370 МБ (.dmg) и 290 МБ (.exe), на сервере DeepSeek они датированы 29 сентября 2026 года.
- Node.js не нужен. С версии 0.2.0-rc.2 приложение несёт свою команду dsh для управления плагинами, её включают пунктом меню «Manage dsh command».
- Закрытое окно не останавливает задачи: на Windows приложение уходит в трей, на Mac остаётся в Dock.
- Для Linux и Windows на ARM кнопок нет. В заметках к 0.2.0-rc.2 упоминаются сборки для Mac на Intel, но ссылки на странице нет. На этих системах ставьте веб-версию или Python SDK.
Веб-интерфейс через npx: Windows, macOS, Linux
Нужен Node.js. README версию не называет, но в корневом package.json репозитория указано ^22.19.0 || >=24.0.0: ставьте Node 22.19 или новее либо ветку 24. Дальше одна команда:
npx @deepseek-ai/dsh webИнтерфейс поднимается на http://127.0.0.1:3080 и сам открывает браузер. В первой ссылке зашит свежий токен процесса, поэтому открывайте именно ту, что напечатана в терминале. Запускайте команду из папки проекта: каталог запуска dsh использует как папку по умолчанию.
Флаг --no-open запускает сервер без браузера, --port меняет порт. В справке CLI примеры даны для команды dsh из того же пакета:
dsh --profile web --no-open --port 8080Сборка из исходников
Этот вариант нужен в основном тем, кто пишет плагины или правит код. Понадобятся Git, Node.js и pnpm:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh webPython SDK
SDK запускает агента из вашей программы. Нужны Python 3.10+, Git и Linux x64/arm64, macOS 14+ на arm64 или Windows x64. Команды для Linux и macOS (для PowerShell вариант есть в документации):
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdkПакет приносит свой runtime и команду dsh, системный Node.js для обычной работы SDK не нужен.
Как пользоваться: ключ, папка, первая задача
- Откройте Settings → Models и вставьте в карточку DeepSeek API-ключ с platform.deepseek.com. Перезапуск не нужен. Ключ хранится в
$DSH_HOME/.credentials.yaml(по умолчанию папка~/.dsh). - Нажмите Choose workspace, добавьте папку, из которой запускали dsh, и выберите её. Пока папка не выбрана, поле ввода неактивно.
- Дайте первую задачу, например «Summarize this repository and identify its main packages». Агент читает и правит файлы, запускает команды и спрашивает разрешение там, где этого требует политика прав.
В десктоп-версии вместо ключа можно войти аккаунтом DeepSeek и платить с баланса аккаунта. Задачи на аккаунте и на API-ключе разнесены по разным пунктам в списке моделей.
Запуск DeepSeek Harness на сервере (VPS)
Для preview-версии сервер даже разумнее домашнего компьютера: SAFETY.md советует запускать проект в одноразовой виртуальной машине или контейнере с минимумом прав. Сценариев два.
Разовая задача без интерфейса. Профиль headless создаёт новую сессию, печатает итоговый ответ и завершается:
dsh --profile headless "run the tests"Веб-интерфейс на сервере. При запуске по SSH dsh печатает ссылку, но браузер не открывает: до порта вы добираетесь через проброс порта в SSH-клиенте. Слушать все сетевые интерфейсы нельзя, --host 0.0.0.0 отклоняется при старте. Для доступа по домену нужен обратный прокси с TLS и два флага:
dsh --profile web --public-url https://app.example/ui/ --trusted-host app.exampleСсылка при старте содержит токен процесса, передавайте её только тем, кому нужен доступ. Подойдёт обычный VPS с Node.js 22.19+, скажем Timeweb Cloud или AdminVPS (промокод AILIST). Как подобрать сервер под агентов, мы разбирали в статье на каком VPS запускать AI-агентов.
Модели DeepSeek Harness и цены API
Harness бесплатен, деньги уходят провайдеру модели. Встроенный адаптер DeepSeek знает две модели, цены за 1 млн токенов по официальному прайсу на 6 октября:
| Параметр | deepseek-flash (DeepSeek-V4.1-Flash) | deepseek-v4-pro (DeepSeek-V4-Pro-0813) |
|---|---|---|
| Вход из кэша, вне пика / пик | $0,003 / $0,006 | $0,022 / $0,044 |
| Вход без кэша, вне пика / пик | $0,15 / $0,30 | $0,66 / $1,32 |
| Выход, вне пика / пик | $0,60 / $1,20 | $1,98 / $3,96 |
| Контекст / максимум ответа | 1M / 384K | 1M / 384K |
| Картинки на входе | да | нет |
Пик по прайсу: 01:00–04:00 и 06:00–10:00 UTC с понедельника по пятницу, то есть 04:00–07:00 и 09:00–13:00 по Москве. Выходные и китайские праздники целиком идут по внепиковому тарифу.
Цену агентской сессии решает кэш: на Flash попадание в кэш в 50 раз дешевле промаха. Условный пример: задача на 5 млн входных токенов, 90% из них из кэша, и 200 тыс. выходных. На Flash вне пика это 4,5 × $0,003 + 0,5 × $0,15 + 0,2 × $0,60 ≈ $0,21, в пик ≈ $0,42. На V4-Pro та же задача стоит ≈ $0,83 и $1,65.
Другие модели подключаются через Add model provider. Среди встроенных провайдеров есть anthropic, openai, moonshotai (Kimi) и zai (GLM); про сами модели есть обзор китайских нейросетей 2026. Остальное идёт через Custom model API: шлюз, корпоративный прокси или свой сервер на одном из протоколов OpenAI Chat Completions, OpenAI Responses или Anthropic Messages. Так подключается и локальная модель в Ollama с её OpenAI-совместимым API. Вход по OAuth, как у Codex, пока не поддерживается.
DeepSeek Harness в России: доступ и оплата API
Программа работает локально, из сети ей нужен только API модели. 1 октября 2026 года автор Habr проверил api.deepseek.com с домашнего московского IP без VPN: ответ 200 за 0,4 секунды. Сайт chat.deepseek.com в той же проверке показал заглушку антибота. Роскомнадзор ещё в мае заявлял, что ограничений против DeepSeek не вводил, хотя пользователи тогда жаловались на сбои.
А вот с оплатой сложнее. DeepSeek принимает пополнение через PayPal, банковскую карту, Alipay и WeChat Pay, а карты российских банков форма оплаты отклоняет (это подтверждают разборы на Habr и vc.ru). Варианты:
- Иностранная карта, если она уже есть.
- Alipay или WeChat Pay с верифицированным аккаунтом.
- Виртуальная карта через посредника, например Плати по миру. Комиссии и риски таких сервисов мы сравнивали в материале про виртуальные карты для оплаты нейросетей.
- Рублёвый шлюз вместо platform.deepseek.com.
Шлюз удобен тем, что баланс пополняется в рублях. У GPTunnel (промокод AILIST10) на странице цен 6 октября были DeepSeek V4.1 Flash за 0,06 ₽ за 1000 токенов запроса и 0,24 ₽ за 1000 токенов ответа и DeepSeek V4 Pro за 0,23 ₽ и 0,68 ₽. Чат-API у шлюза OpenAI-совместимый, адрес https://gptunnel.ru/v1. В dsh: Settings → Models → Add model provider, карточку переключить на Custom model API. Затем Provider ID строчными буквами (переименовать его потом нельзя), base URL, протокол OpenAI Chat Completions, ключ GPTunnel и кнопка Fetch available models. Если список не пришёл, впишите ID моделей вручную. Чат и API DeepSeek без Harness разобраны в статье DeepSeek в России; карточки сервисов: DeepSeek и GPTunnel.
Плагины DeepSeek Harness
На странице продукта среди официальных плагинов показаны Agent teams, Auto approval review, Scheduled tasks и Voice input (все с пометкой Experimental), а ещё Terminal, Agent loop и Subagents. В десктопе плагины ставятся из встроенного менеджера, а в режиме Creator агент пишет плагин по описанию в чате.
Сторонние плагины ищут по тегу dsh-plugin на GitHub. 6 октября тег стоял у 17 778 репозиториев, но поставить его может кто угодно: в первой десятке по звёздам есть даже конструктор резюме. Из командной строки плагин добавляется в профиль так (пример из документации):
dsh plugin --profile demo add github:you/hello-pluginЕсли плагину из GitHub нужна сборка, первая установка упадёт: pnpm 10 и новее без разрешения не запускает сборочный скрипт git-пакета, и dsh подскажет добавить пакет в allowBuilds файла pnpm-workspace.yaml профиля. Документация прямо называет это разрешением запустить код пакета вне песочницы агента. Ставьте только то, чей код смотрели, и фиксируйте коммит в виде github:you/hello-plugin#<sha>.
Типовые ошибки DeepSeek Harness
| Что видите | Причина | Что сделать |
|---|---|---|
| Поле ввода неактивно | не выбрана рабочая папка | Choose workspace и папка проекта |
MISSING_CREDENTIAL | нет ключа провайдера | сохранить ключ в Settings → Models или задать переменную окружения |
UNKNOWN_MODEL после обновления | выбранной модели нет в каталоге; так бывает после 0.2.0-rc.2, где удалили часть старых ID | выбрать модель заново или добавить её в свой провайдер |
| Веб-интерфейс не стартует, порт 3080 занят | порт держит другой процесс | запустить с --port |
| Шлюз отклоняет все запросы при верном ключе | формат запроса отличается от OpenAI | в $DSH_HOME/profiles/web/cordis.patch.yml задать провайдеру compat.supportsDeveloperRole: false и compat.maxTokensField: max_tokens |
| DeepSeek через шлюз «думает» при уровне off | V4 рассуждает по умолчанию | добавить модели compat.thinkingFormat: deepseek |
Десктоп на Mac не видит переменные из ~/.zshrc | графические приложения macOS их не читали | обновиться до 0.2.0-rc.2 или новее |
| Десктоп на Windows не запускается | конфликт с зарезервированными Windows диапазонами портов | исправлено в 0.2.1-alpha.1: порт теперь выбирает система |
Безопасность, версии и куда писать о багах
С 10 августа в npm вышло 30 версий @deepseek-ai/dsh, и все предрелизные: rc и alpha. Чинят быстро, но и ошибки бывают серьёзные: в 0.1.7-alpha.1 исправили удаление файлов за пределами разрешённой папки в песочнице Windows. Держите версию свежей и следуйте SAFETY.md: минимальные права, отдельная ВМ или контейнер, резервные копии файлов, проверка плагинов и команд перед запуском. Пускать dsh в рабочий репозиторий без резервной копии пока рано.
Телеметрия использования отключается переменной DSH_TELEMETRY_MODE=DISABLED. Раздел Issues в репозитории выключен, и закрытых баг-репортов там не найти: об ошибках пишут в GitHub Discussions, ещё есть сервер в Discord.
FAQ
DeepSeek Harness бесплатный?
Да, код открыт под лицензией MIT. Платить нужно за модель: по API-ключу DeepSeek или другого провайдера либо с баланса аккаунта DeepSeek.
Работает ли DeepSeek Harness в России без VPN?
Сам dsh работает локально, а API DeepSeek при проверке 1 октября 2026 года отвечал с московского IP без VPN. Сложность в оплате: карту российского банка платформа не примет, нужна иностранная или виртуальная карта либо рублёвый шлюз.
Есть ли DeepSeek Harness для Linux?
Десктопа для Linux на официальной странице нет. Работают веб-интерфейс через npx @deepseek-ai/dsh web (Node.js 22.19+) и Python SDK для x64 и arm64.
Можно ли подключить к dsh Claude, GPT, Kimi или локальную модель?
Да. Среди встроенных провайдеров есть anthropic, openai, moonshotai (Kimi) и zai (GLM), остальное подключается как Custom model API, включая локальный сервер. Вход по подписке через OAuth, как у Codex, пока не поддерживается.
Куда сообщить об ошибке, если Issues на GitHub закрыты?
В GitHub Discussions репозитория deepseek-ai/deepseek-harness: README называет этот канал для отзывов и баг-репортов. Есть и Discord-сообщество DeepSeek Harness.
Редактор каталога нейросетей ailist.ru. Пишет про AI-инструменты: генерацию текста, изображений и видео, автоматизацию, чат-ботов и доступ к зарубежным сервисам из России. Тестирует новые сервисы и помогает выбирать рабочие инструменты под конкретные задачи. В AI с 2023 года — помнит времена, когда на сгенерированных нейросетью фотографиях у людей было по шесть пальцев.
