Что такое DeepSeek Harness (dsh) и почему это не модель

Что такое DeepSeek Harness, если коротко

DeepSeek Harness (dsh, пакет npm @deepseek-ai/dsh) это открытый агентный харнесс от DeepSeek AI под лицензией MIT. Он вышел в августе 2026 года в статусе developer preview. Это программа, которая запускает цикл агента, инструменты, плагины и локальный веб-интерфейс. Она не является ни моделью, ни чатом DeepSeek. Модель подключается к ней отдельно, например по ключу DeepSeek API.

Харнесс (англ. harness) в мире агентов искусственного интеллекта (ИИ) означает программу вокруг языковой модели. Модель только пишет текст. Харнесс отправляет ей задачу, выполняет команды, которые она просит запустить, и возвращает ей результат. Шаг за шагом так и работает агент. Подробнее эта схема разобрана в статье что такое агентный харнесс и из чего он состоит.

Путаница понятна. Слово DeepSeek стоит сразу на трёх разных продуктах, и в разговоре их часто называют одним именем. Ниже мы разделим их и посмотрим, что внутри dsh. Потом отдельно разберём, какие части этой цепочки касаются читателя из России.

Три продукта с именем DeepSeek, которые легко спутать

Для каждого продукта важны два вопроса: где он работает и за что вы платите.

Чат DeepSeek (chat.deepseek.com)

На главной странице deepseek.com чат подписан как «DeepSeek Web», и ссылка ведёт на chat.deepseek.com. Там же есть QR-код для мобильного приложения. Это готовый продукт для человека: вы пишете вопрос в окне и читаете ответ. Работает он на серверах DeepSeek, у вас только браузер или телефон. Бесплатен ли чат и где он доступен, главная страница не говорит. Эти условия проверяйте на самом сайте, мы их не подтверждали.

Модели и DeepSeek API

API (application programming interface, программный интерфейс) нужен программам, а не людям. Ваш код отправляет запрос на адрес DeepSeek и получает ответ модели. Базовый адрес https://api.deepseek.com принимает запросы в формате OpenAI, а https://api.deepseek.com/anthropic в формате Anthropic. Ключ API создают в личном кабинете на platform.deepseek.com/api_keys.

На странице цен на 13 октября 2026 года две модели: deepseek-flash (DeepSeek-V4.1-Flash) и deepseek-v4-pro. Старые имена deepseek-v4-flash и deepseek-v4-flash-vision-exp API по-прежнему принимает и считает по цене Flash. Платите вы за токены, с баланса в кабинете. Модель работает на серверах DeepSeek.

DeepSeek Harness (dsh)

Это программа, которую вы запускаете у себя: на ноутбуке или на VPS (virtual private server, виртуальный частный сервер). Для запуска через npm нужен Node.js. Сама программа открыта и распространяется по лицензии MIT, поэтому за код вы не платите. Платите вы за токены той модели, которую подключили, и за сервер, если запускаете харнесс не на своём компьютере.

Главное различие простое. Чат и API работают у DeepSeek. Харнесс работает у вас и сам отправляет запросы в API.

Что внутри DeepSeek Harness: всё является плагином

Описание репозитория звучит так: «DeepSeek Harness: Everything is a Plugin». Харнесс построен на фреймворке Cordis. В документе docs/architecture.md сказано, что плагином является каждая часть продукта, включая адаптер модели и реестр инструментов. Цикл агента тоже плагин, по умолчанию это core/agent-loop. Браузерное приложение добавляет модуль dsh-web-app.

Для читателя из этого следует практическое правило. Почти любое поведение dsh меняется установкой или отключением плагина, а не правкой ядра. Плагин при этом является кодом, который выполняется на вашей машине, поэтому ставьте только те, которым доверяете. Как проверять плагин перед установкой, описано в статье как безопасно ставить плагины dsh. Удачные варианты собраны в обзоре плагинов DeepSeek Harness, которые стоит установить.

Пакет npm называется @deepseek-ai/dsh, а команда в нём одна: dsh. В описании пакета сказано, что эта команда запускает профили, управляет плагинами и показывает конфигурацию.

Команда dsh web запускает веб-интерфейс по адресу http://127.0.0.1:3080 и открывает его в браузере по умолчанию. Адрес 127.0.0.1 означает петлевой интерфейс (loopback): сервер слушает только эту машину, и снаружи к нему подключиться нельзя. На VPS это значит, что интерфейс не откроется по публичному IP, и это правильно. Почему так сделано и как открыть интерфейс через SSH-туннель, объясняет статья что означает адрес 127.0.0.1:3080 в DeepSeek Harness.

Как к dsh подключается модель

В README про модели и ключи ничего нет. Ответ есть в каталоге настроек docs/config-catalog.md в репозитории. Мы перечитали его 13 октября 2026 года в основной ветке, которая может опережать версию из npm.

Для DeepSeek API есть плагин @deepseek-ai/dsh-llm-deepseek-api-key. Он берёт ключ из переменной окружения, имя которой задаёт параметр apiKeyEnv. По умолчанию это DEEPSEEK_API_KEY. Есть и второй путь, через аккаунт DeepSeek (@deepseek-ai/dsh-llm-deepseek-account). Там, по словам каталога, аутентификация идёт только через сервис аккаунтов.

Другие провайдеры подключаются через плагин @deepseek-ai/dsh-llm-pi-ai. Для каждого маршрута в нём задаются протокол, адрес baseURL и имя переменной с ключом (apiKeyEnv). Протоколов, которые можно указать для маршрута, всего три: openai-completions, openai-responses и anthropic-messages. Так написано в исходном коде плагина и в руководстве по провайдерам, и так же было в версиях 0.2.0-rc.2 и 0.2.1-alpha.2. Если маршрут называет любой другой протокол, плагин отказывается его обслуживать и выдаёт ошибку со списком поддерживаемых. README плагина объясняет, что Bedrock, Vertex, Azure и Codex проходят аутентификацию способами, которые профиль не может описать полностью, поэтому их протокол указать в маршруте нельзя. Значит, модель в dsh действительно сменная, если сервис говорит на одном из трёх протоколов: харнесс не привязан к моделям DeepSeek. Пошаговая настройка ключей и выбор модели по умолчанию описаны в статье как настроить ключи API и модели в dsh.

Какую версию мы проверяли

На 13 октября 2026 года тег latest в реестре npm указывал на версию 0.2.0-rc.2, опубликованную 29 сентября. Тег alpha указывал на 0.2.1-alpha.2, опубликованную 9 октября. Все релизы на странице Releases в GitHub помечены как pre-release.

README предупреждает прямо: «DeepSeek Harness is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES». Иначе говоря, совместимость между версиями будет ломаться. На сайте deepseek.com тот же продукт назван public preview. Версия меняется почти каждый день, поэтому мы не пишем «последняя», а называем номер. Закрепляйте номер и в своих командах.

Установка в одном абзаце

README говорит: установите Node.js, затем запустите одну команду. Сборка из исходников тоже возможна: git clone https://github.com/deepseek-ai/deepseek-harness, затем pnpm install, pnpm run build и pnpm dsh web. Кроме того, на 13 октября 2026 года на странице deepseek.com/en/harness/ можно скачать настольное приложение Harness Desktop для macOS на Apple silicon и для 64-битной Windows. Берите пакет только из пространства @deepseek-ai в npm, а код только из github.com/deepseek-ai, потому что именно эти источники указаны в README. Отдельный пользователь, firewall, systemd и доступ к интерфейсу на сервере разобраны в руководстве как установить DeepSeek Harness на VPS. Частые сбои при установке собраны в статье ошибки установки и версий dsh.

npx @deepseek-ai/dsh@0.2.0-rc.2 web

Сколько стоят токены DeepSeek API

Харнесс бесплатен, поэтому весь счёт приходит от модели. Ниже цены со страницы DeepSeek API в долларах США за миллион токенов, как они стояли 13 октября 2026 года. Вход делится на два тарифа: попадание в кэш (cache hit) и промах (cache miss).

[
  {
    "label": "deepseek-flash, \u043f\u0438\u043a",
    "input_cache_hit_usd": 0.006,
    "input_cache_miss_usd": 0.3,
    "output_usd": 1.2
  },
  {
    "label": "deepseek-flash, \u043d\u0435 \u043f\u0438\u043a",
    "input_cache_hit_usd": 0.003,
    "input_cache_miss_usd": 0.15,
    "output_usd": 0.6
  },
  {
    "label": "deepseek-v4-pro, \u043f\u0438\u043a",
    "input_cache_hit_usd": 0.044,
    "input_cache_miss_usd": 1.32,
    "output_usd": 3.96
  },
  {
    "label": "deepseek-v4-pro, \u043d\u0435 \u043f\u0438\u043a",
    "input_cache_hit_usd": 0.022,
    "input_cache_miss_usd": 0.66,
    "output_usd": 1.98
  }
]

Миллион выходных токенов deepseek-flash в часы пик стоил $1.2, а deepseek-v4-pro $3.96. Вне пика те же токены Pro стоили $1.98. Страница цен говорит, что вне пика тарифы ровно в два раза ниже. Там же написано, что DeepSeek может менять цены, поэтому перед расчётом бюджета откройте таблицу заново.

В агентном цикле модель получает контекст задачи на каждом шаге, поэтому входных токенов набирается много. Откуда берутся эти токены и как их сократить, разобрано в статье сколько токенов тратит сам харнесс.

Когда токены дешевле: окно скидки по московскому времени

Страница цен задаёт часы пик в UTC (всемирное координированное время): с 01:00 до 04:00 и с 06:00 до 10:00, с понедельника по пятницу, кроме государственных праздников Китая. Все остальные часы считаются не пиком, включая выходные и праздники Китая целиком.

Московское время равно UTC+3 весь год, перехода на летнее время нет. Проверить это можно по базе часовых поясов на любом Linux-сервере. В примере взят понедельник, 12 октября 2026 года:

TZ=Europe/Moscow date -d '2026-10-12 01:00 UTC'
TZ=Europe/Moscow date -d '2026-10-12 10:00 UTC'

В английской локали вывод будет Mon Oct 12 04:00:00 MSK 2026 и Mon Oct 12 13:00:00 MSK 2026. Значит, по московскому времени пик идёт с 04:00 до 07:00 и с 09:00 до 13:00 в будние дни. Половинная цена действует с 07:00 до 09:00 и с 13:00 до 04:00 следующего утра. В субботу и воскресенье скидка действует весь день. Праздники считаются по календарю Китая, а не России.

Для агента это удобно. Длинную задачу, которая не требует вашего участия, можно поставить на вечер или на выходные. Как держать dsh запущенным на сервере без открытого терминала, описано в статье запуск dsh на VPS как службы systemd.

Что из этой цепочки касается читателя в России

Ниже каждое звено цепочки по порядку, от установки до оплаты. По каждому мы искали ответ в первоисточниках DeepSeek, а не в пересказах.

Установка. Пакет приходит из реестра npm, исходники лежат на GitHub. Эти адреса должны открываться с той машины, где запускается dsh. Если харнесс стоит на VPS в другой стране, пакеты скачивает сервер, а не ваш ноутбук. К вам приходит только веб-интерфейс через SSH-туннель. Работает ли доступ к npm и GitHub из конкретной российской сети, документация DeepSeek не обсуждает, и мы этого не утверждаем.

Запросы к API. Харнесс отправляет запросы на api.deepseek.com с той же машины, где он запущен. Документация API ничего не говорит о регионах, из которых доступен сервис. Проверьте это сами: после настройки ключа отправьте один короткий запрос с вашего сервера.

Оплата токенов. Это главный вопрос, и честный ответ здесь такой. Главная страница документации API и страницы цен и лимитов не перечисляют ни способы оплаты, ни карты, ни страны. В FAQ есть вопрос «How to Top Up?», но 13 октября 2026 года нам не удалось прочитать текст ответа, поэтому на FAQ мы здесь не опираемся. Страница пополнения находится в личном кабинете. Поэтому мы не пишем, проходят ли карты российских банков или другие способы. Откройте раздел Top Up в своём кабинете на platform.deepseek.com: список способов оплаты виден там. Списки из статей посредников первоисточником не являются. Сама DeepSeek советует пополнять баланс по фактическому расходу.

Два факта о балансе и лимитах из документации всё же полезны. Сначала списывается подаренный баланс (granted balance), потом пополненный. Лимит одновременных запросов считается на весь аккаунт, независимо от ключа:

[
  {
    "label": "deepseek-flash",
    "concurrent_requests": 2500
  },
  {
    "label": "deepseek-v4-pro",
    "concurrent_requests": 500
  }
]

Для deepseek-flash это 2500 запросов, для deepseek-v4-pro 500. При превышении API отвечает ошибкой HTTP 429. Если вы видите 429, значит, под вашим аккаунтом одновременно идёт больше запросов, чем позволяет лимит выбранной модели.

Какой харнесс выбрать

Если вы выбираете между dsh и другими агентами, это отдельный вопрос со своими критериями. Мы сравнили их в статье DeepSeek Harness, Claude Code и Omnigent: что выбрать. Если путаются сами термины «агент», «модель» и «ассистент», начните с разницы между ИИ-агентом, большой языковой моделью и ассистентом.

FAQ

DeepSeek Harness это модель или программа?

Программа. DeepSeek Harness (dsh) это открытый агентный харнесс от DeepSeek AI под лицензией MIT. Он запускает цикл агента, инструменты, плагины и веб-интерфейс на 127.0.0.1:3080. Модель подключается отдельно: для DeepSeek API есть плагин @deepseek-ai/dsh-llm-deepseek-api-key, который по умолчанию читает ключ из переменной DEEPSEEK_API_KEY. Через плагин @deepseek-ai/dsh-llm-pi-ai можно подключить и других провайдеров, если они работают по протоколу openai-completions, openai-responses или anthropic-messages.

Сколько стоит DeepSeek Harness?

Сам харнесс бесплатен, потому что распространяется по лицензии MIT. Вы платите за токены подключённой модели и за сервер, если запускаете dsh на VPS. Цены DeepSeek API указаны в долларах за миллион токенов и зависят от модели и времени суток. Вне часов пик тарифы в два раза ниже.

Когда токены DeepSeek API дешевле по московскому времени?

DeepSeek задаёт пик в UTC: с 01:00 до 04:00 и с 06:00 до 10:00, с понедельника по пятницу. Московское время равно UTC+3, поэтому пик по Москве длится с 04:00 до 07:00 и с 09:00 до 13:00 в будние дни. Половинная цена действует с 07:00 до 09:00, с 13:00 до 04:00 следующего утра, весь день в субботу и воскресенье и в государственные праздники Китая.

Можно ли оплатить DeepSeek API российской картой?

Главная страница документации DeepSeek API, страницы цен и лимитов способы оплаты не перечисляют, а страница пополнения находится в личном кабинете. Поэтому надёжный ответ есть только там: войдите на platform.deepseek.com и откройте раздел Top Up. Списки способов оплаты из статей посредников первоисточником не являются.

Какую версию dsh ставить?

На 13 октября 2026 года тег latest в npm указывал на 0.2.0-rc.2, и все релизы в GitHub помечены как pre-release. README предупреждает, что совместимость будет ломаться. Закрепляйте номер версии в команде, например npx @deepseek-ai/dsh@0.2.0-rc.2 web, и перед обновлением читайте список изменений.