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

DeepSeek Harness, команда dsh, это агентная оболочка от DeepSeek. Она читает и правит файлы проекта, запускает команды, ведёт план задачи и принимает плагины. Код открыт под MIT. Harness ставится приложением для macOS и Windows или запускается в браузере командой npx @deepseek-ai/dsh web. Дальше по порядку: устройство, установка, подключение моделей, плагины, MCP и безопасность.

Что такое DeepSeek Harness

В README репозитория deepseek-ai/deepseek-harness проект назван открытым «agent harness» от DeepSeek AI. Архитектура держится на принципе «всё есть плагин» и построена на фреймворке Cordis: адаптер модели и цикл агента тоже подключаются как плагины. На официальной странице Harness назван публичным превью, открытым для всего мира.

По тем же страницам агент умеет разбирать репозитории, чинить ошибки, запускать тесты, работать с документами, данными и слайдами, вести фоновые задачи. В интерфейсе есть субагенты и режим Creator, в котором плагины пишутся прямо в чате. Есть и экспериментальные блоки: команды агентов, автоматическая проверка запросов на одобрение, задачи по расписанию, голосовой ввод. Веб-интерфейс переведён на русский.

Цифры на 29 октября 2026:

Тег latest указывает на релиз-кандидат, а не на финальную версию, и это ещё один признак превью. В журнале обновлений DeepSeek рекомендует Harness 0.2.1-rc.1 или новее, чтобы выжать максимум из модели V4.1-Flash-1017.

Как установить DeepSeek Harness

Способов четыре. Выбирайте под свою задачу, а не по привычке.

Установщика для Linux на странице загрузки нет: там перечислены только macOS на чипах Apple и Windows 64-бит. Для Linux остаются npx и сборка из исходников.

Запуск через npm:

npx @deepseek-ai/dsh web

Команда поднимает веб-интерфейс на http://127.0.0.1:3080 и открывает браузер. Если сервер стартует там, где браузера нет, добавьте ключ --no-open: он отключает автооткрытие. Сборка из исходников:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Десктопное приложение может зарегистрировать команду dsh в терминале, для этого в меню есть пункт Manage dsh Command. Файлы берите только со страницы deepseek.com или из репозитория deepseek-ai на GitHub, а пакет для npm из области @deepseek-ai. По запросу «deepseek harness скачать» поиск выдаёт и сторонние сборки, а что в них, не гарантирует никто.

Первый запуск: ключ, рабочая папка, задача

Дальнейшее делается в интерфейсе, по руководству из документации проекта. Ключ DeepSeek выдают на platform.deepseek.com, а про нюансы оплаты из России мы писали в статье «DeepSeek API из России».

1. Откройте Settings, раздел Models, найдите карточку DeepSeek и вставьте API-ключ. Он сохраняется только на запись: интерфейс получает обратно маскированное значение, а сам ключ лежит в $DSH_HOME/.credentials.yaml. Перезапуск не нужен.
2. Нажмите Choose workspace и добавьте папку проекта. Без выбранной папки поле для задачи недоступно.
3. Начните сессию с безобидного запроса: «Опиши структуру репозитория и главные пакеты». Агент читает файлы, запускает команды и просит подтверждения там, где этого требует действующая политика прав.

В меню выбора модели есть переключатель Effort. Для моделей DeepSeek в нём доступны уровни off, low, high и max. Для запуска без интерфейса предусмотрен режим dsh --profile headless "задача": он проходит одну сессию, печатает итог и завершается.

Плагины и MCP в DeepSeek Harness

Плагины. Страница Plugins показывает официальные и экспериментальные плагины. Если включить экспериментальный пакет Custom plugin indexes, появится вкладка Discover. В ней вы добавляете адрес индекса (JSON-файл со списком плагинов), выбираете версию и подтверждаете установку. Индексы чужие, содержимое карточек Harness не проверяет, поэтому подключайте только те источники, которым доверяете. Чтобы плагин находили, автор добавляет в репозиторий тему dsh-plugin на GitHub. Из терминала плагины ставятся командой dsh plugin --profile <имя> <аргументы pnpm>.

MCP. За подключение внешних серверов отвечает пакет @deepseek-ai/dsh-mcp-client. По умолчанию не включён ни один сервер. Инструменты сервера попадают в список модели под именем mcp__<имя_сервера>__<инструмент>. Работают локальные программы через stdio и сервисы по Streamable HTTP. Минимальный оверлей для локального сервера выглядит так:

- insert:
    - id: memory-mcp
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: reference_memory
        transport: stdio
        command: mcp-server-memory

Сохраните оверлей как memory.cordis.yml. Сам сервер нужно поставить заранее, Harness его только запускает, а файл подхватывается при старте флагом --patch:

npm install --global @modelcontextprotocol/server-memory@2026.7.4
npx @deepseek-ai/dsh web --patch "$PWD/memory.cordis.yml"

Что такое MCP и как написать свой сервер, описано в статье «MCP-сервер: что это», а о подключении MCP к Claude есть отдельный гайд.

Harness с ключом codexkey: OpenAI-совместимый адрес

Модели в Harness можно брать у любого провайдера. В карточке Add model provider есть режим Custom model API: вы задаёте идентификатор провайдера, base URL, протокол (OpenAI Chat Completions, OpenAI Responses или Anthropic Messages), ключ и хотя бы одну модель. Кнопка Fetch available models вызывает GET /models и подтягивает список.

Для codexkey настройки такие: base URL https://api.codexkey.ru/v1, протокол OpenAI Chat Completions, ключ sk_cdx_..., модель deepseek-v4.1-flash-1017 или deepseek-v4-pro. То же самое можно записать в $DSH_HOME/profiles/web/cordis.patch.yml по схеме из документации Harness:

- id: llm-pi-ai
  config:
    providers:
      codexkey:
        apiKeyEnv: CODEXKEY_API_KEY
        api: openai-completions
        baseURL: https://api.codexkey.ru/v1
        models:
          - id: deepseek-v4.1-flash-1017
          - id: deepseek-v4-pro

Ключ кладите в переменную окружения CODEXKEY_API_KEY, а не в файл. Если Effort в положении off не выключает рассуждение, документация Harness советует добавить в запись модели compat.thinkingFormat: deepseek. Как шлюз передаёт такие параметры, зависит от самого шлюза и от модели, так что проверьте поведение на небольшом запросе.

Прайс codexkey на 29 октября 2026, цены за 1 млн токенов, актуальные цифры лежат на странице моделей:

Для сравнения: на своей странице тарифов DeepSeek берёт за deepseek-flash $0,15 за вход и $0,6 за выход вне пиковых часов, в пик вдвое больше. Модели подробнее разобраны в обзоре DeepSeek 4.1 Flash. Как создать ключ, описано в быстром старте.

Бесплатно ли это и безопасно ли

Сам Harness бесплатный: лицензия MIT, ни подписки, ни лицензионных платежей. Платить придётся за токены модели. В прайсе DeepSeek есть одно исключение: вызовы поиска и загрузки страниц через Harness, Claude Code или Codex бесплатны до 00:00 по пекинскому времени 1 ноября 2026, затем тарифицируются по $0,75 за 1000 запросов. Бесплатная модель из каталога codexkey, deepseek-v4.1-flash-1017-free, подойдёт, чтобы проверить конфигурацию; условия смотрите на странице модели. Другие варианты собраны в статье «DeepSeek бесплатно: лимиты и статус».

С безопасностью строже, чем с ценой. SAFETY.md говорит прямо: проект экспериментальный, аудит безопасности не проходил и не должен считаться безопасным или готовым к продакшену. Агент исполняет код и команды, которые сгенерировала модель, и загружает сторонние плагины. Мы бы запускали его так:

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

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

FAQ

Что такое DeepSeek Harness простыми словами?

Это программа-агент от DeepSeek. Вы указываете папку с проектом и задачу, а она читает файлы, правит их, запускает команды и показывает результат. Модель подключается по ключу, возможности расширяются плагинами.

Как скачать DeepSeek Harness на Windows?

Откройте deepseek.com/harness и нажмите Download Desktop: на странице есть сборка для Windows 64-бит. Есть и другой путь: поставьте Node.js 24.9 или новее и выполните npx @deepseek-ai/dsh web. Файлы с посторонних сайтов не берите.

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

Да, сам инструмент бесплатный и открыт под MIT. Модели оплачиваются отдельно: через API DeepSeek по токенам или через шлюз вроде codexkey. Поиск и загрузка страниц через Harness у DeepSeek бесплатны только до 1 ноября 2026 года.

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

Да. Через Custom model API подключается любой адрес, совместимый с OpenAI Chat Completions, OpenAI Responses или Anthropic Messages. В каталоге провайдеров есть anthropic, openai, moonshotai для Kimi и zai для GLM.

Поддерживает ли DeepSeek Harness MCP и плагины?

Да. MCP работает через пакет @deepseek-ai/dsh-mcp-client, серверы подключаются по stdio или Streamable HTTP. Плагины ставятся со страницы Plugins или командой dsh plugin, а в режиме Creator их можно написать прямо в чате.

Безопасно ли давать DeepSeek Harness доступ к проекту?

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