TLDR DeepSeek Harness (dsh) — это открытый рантайм агента от DeepSeek AI, выпущенный в виде developer preview примерно 13 августа 2026 года по лицензии MIT. Он следует принципу «Model + Harness = Agent», при котором каждая возможность (модели, инструменты, сессии, песочницы, циклы, UI) реализована как взаимозаменяемые плагины Cordis.
Самый быстрый способ запустить локально — npx @deepseek-ai/dsh web (требуется Node.js ^22.19 или ≥24), что запускает Web UI по адресу http://127.0.0.1:3080. Вы указываете ключ API DeepSeek (или совместимый с OpenAI) и рабочее пространство. Доступны также сборка из исходников, настольные приложения, Docker, Python SDK и интеграции с Ollama. Для промышленного уровня многомодельного доступа, надежности и контроля затрат при использовании обвязки направляйте запросы через унифицированную совместимую с OpenAI конечную точку CometAPI.
Ключевые моменты
- DeepSeek Harness — это не модель, а локальный рантайм/оркестратор, позволяющий моделям работать с файлами, оболочкой, инструментами и сессиями.
- Официальный однострочник:
npx @deepseek-ai/dsh web→ открывает локальный Web UI на порту 3080. - Требование к Node.js строгое: ^22.19.0 или ≥24.x.
- Поддерживает официальные модели DeepSeek (deepseek-v4-flash, deepseek-v4-pro), пользовательские шлюзы, совместимые с OpenAI, и локальные модели через плагины/Ollama.
- Архитектура полностью плагинная (ядро Cordis); режимы включают Standard, Minimal, Code и Creator.
- Быстрое распространение: от десятков тысяч до более 100 тыс. звёзд на GitHub в течение нескольких дней после запуска.
- Рекомендация для продвинутых пользователей: сочетать с CometAPI (https://www.cometapi.com/) как с кастомным провайдером для доступа к 500+ моделям, экономии 20–40% и единого API‑ключа.
- Всегда используйте изолированное рабочее пространство; агент может менять файлы и выполнять команды.
- Статус developer preview означает возможные ломающие изменения — закрепляйте версии для экспериментов, приближенных к продакшену.
Что такое DeepSeek Harness и почему это важно в 2026 году
DeepSeek Harness (dsh) — это открытый рантайм агента, разработанный DeepSeek AI. Выпущенный под лицензией MIT в статусе developer preview, он делает упор на композицию: каждая возможность — адаптеры моделей, инструменты, навыки, сессии, песочницы, хранилище, агентные циклы, планирование и UI — существует как плагин Cordis, который можно подключать, отключать, менять местами или перекомпоновывать через конфигурацию. По сути, нет привилегированного ядра, требующего патчинга.
Ключевые принципы проектирования:
- Агент = Модель + обвязка.
- Отслеживаемые потоки событий с поддержкой возобновления, форка, поиска и воспроизведения.
- Несколько режимов рантайма (стандартный с полным набором инструментов, код/оркестрация, минимальный для бенчмарков, creator/экспериментальные режимы).
- Local-first Web UI для интерактивной работы, а также безголовые варианты и SDK для автоматизации.
Официальные ресурсы:
- GitHub: https://github.com/deepseek-ai/deepseek-harness
- Продукт/лендинг: https://www.deepseek.com/harness/en/ (и китайская версия)
- Страницы с инструкциями по установке и зеркала сообщества подтверждают те же базовые команды.
Важно: терминология. «Локальное развёртывание» может означать две разные вещи. Рассматриваемый в этом руководстве DeepSeek Harness запускается локально на вашем компьютере, но стандартный проект
deepseek-harnessподключается к DeepSeek V4-Pro или V4-Flash через API. Это означает, что обвязка, конфигурация, сессии, валидация и клиентская логика могут быть локальными, тогда как инференс модели обычно выполняется через API DeepSeek. Если вам нужен полностью офлайн‑инференс с весами модели на вашем GPU, это другая архитектура развёртывания.
Предварительные требования и системные требования
Перед установкой проверьте следующее:
- Операционные системы: Windows 10+, macOS 10.15+, основные дистрибутивы Linux (x64 или arm64). Для Python SDK действуют дополнительные ограничения (Linux x64/arm64 или macOS 14+ arm64).
- Node.js: требуется для основного пути через Web UI. Целевой диапазон: ^22.19.0 || ≥24.0.0. Проверьте с помощью node --version. Промежуточные версии с нечетными номерами вне этого диапазона не поддерживаются.
- Менеджеры пакетов: npm/npx (поставляются с Node). Сборка из исходников требует pnpm (установите через npm install -g pnpm).
- Git: требуется для клонирования исходников.
- Python (опционально): 3.10+ для официального Python SDK.
- Ключ API / конечная точка: ключ API DeepSeek с platform.deepseek.com или любая совместимая с OpenAI конечная точка + ключ + имя модели.
- Аппаратное обеспечение: для самой обвязки GPU не требуется — инференс модели выполняется удалённо (или через локального провайдера, которого вы настроите). Обычного ноутбука достаточно для Web UI и оркестрации.
- Сеть: требуется при первом запуске для загрузки пакетов; затем UI может работать, выполняя только вызовы к API модели.
- Рабочее пространство: подготовьте изолированный каталог. Агент может читать, писать и выполнять команды внутри настроенного рабочего пространства — никогда не указывайте на продакшен или личные данные без мер защиты.
Источники требований: официальный README и несколько независимых руководств по установке, опубликованных вскоре после запуска.
Метод 1: официальный однострочник с npx (рекомендуется большинству)
Это самый быстрый и официально продвигаемый путь.
- Убедитесь, что версия Node.js удовлетворяет требованиям.
- Откройте терминал и выполните:
Bash
npx @deepseek-ai/dsh web
- Пакет загрузится (или возьмётся из кэша), запустит профиль Web UI и выведет адрес — по умолчанию http://127.0.0.1:3080.
- Откройте этот URL в браузере. Примите уведомление о статусе developer preview, если оно показано.
- При первом запуске настройте провайдера модели (Settings → Models), вставив свой ключ API и выбрав модель, например deepseek-v4-flash или deepseek-v4-pro.
- Выберите или создайте каталог рабочего пространства.
- Начните выполнять задачи.
Чтобы использовать другой порт:
Bash
npx @deepseek-ai/dsh web --port 8080
Платформозависимые однострочники , которые также проверяют наличие Node, доступны на сайтах сообщества (PowerShell в Windows с winget, Homebrew в macOS, NodeSource в Debian/Ubuntu и т. д.).
Плюсы: нулевой постоянный след установки сверх кэша npm; всегда подтягивает свежую опубликованную версию; простейший онбординг. Минусы: зависит от сети для первоначальной загрузки пакета; менее удобно для глубокого изучения исходников или кастомных сборок.
Метод 2: установка и запуск из исходников
Используйте, когда хотите изучать плагины Cordis, закреплять коммит, разрабатывать собственные пресеты или контрибьютить.
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
Появится тот же Web UI на порту по умолчанию. В версиях developer preview возможны ломающие изменения между коммитами, поэтому рассматривайте это как экспериментальный путь.
Метод 3: настольные приложения (без установки Node)
Сообщество и сторонние обёртки для десктопа упаковывают рантайм, чтобы пользователям не нужно было ставить Node/pnpm:
- Лёгкие клиенты на Tauri, которые подтягивают встроенный рантайм Node и при запуске синхронизируют актуальный upstream‑вариант harness. Они работают на 127.0.0.1:3080, хранят данные локально и регистрируют команды dsh.
- Пакеты на Electron с закреплёнными зависимостями.
Загружайте установщики со страниц GitHub Releases соответствующих проектов (ищите «deepseek-harness-desktop»). При первом запуске скачиваются основные компоненты (несколько сотен МБ). Удобно для неспециалистов, но это не официальные продукты DeepSeek — изучайте репозиторий и SHA‑чек-суммы.
Метод 4: развёртывание в Docker/контейнере
Существуют образы и docker‑compose‑файлы сообщества для запуска Web UI в контейнере, часто с HTTPS‑терминацией через nginx и поддержкой произвольных шлюзов, совместимых с OpenAI. Типичный процесс:
Bash
git clone <docker-repo>
cd <docker-repo>
cp .env.example .env # set API key / public host
docker compose up -d --build
Полезно для доступа в пределах LAN, серверов или сред, где не хотят ставить Node на хост. Некоторые конфигурации поддерживают custom settings.yaml для провайдеров, отличных от DeepSeek.
Метод 5: Python SDK для программного / безголового использования
Для автономных агентов или интеграции в Python‑пайплайны:
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
python -m pip install deepseek-harness-sdk
Задайте переменные окружения:
Bash
export DEEPSEEK_API_KEY=sk-your-key-here
# optional: export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1
# optional: export DSH_MODEL=deepseek-v4-flash
Затем запустите примеры из репозитория или используйте класс DeepSeekHarness в своём коде с изолированным рабочим пространством и каталогом сессий. SDK включает собственный рантайм и не требует системного Node.js.
Метод 6: интеграция с Ollama
Ollama предоставляет удобный лаунчер:
Bash
ollama launch dsh
# or with a specific model
ollama launch dsh --model deepseek-v4-flash:cloud
Поддержка веб‑поиска и инструментов зависит от выбранной модели и доступа к облаку Ollama.
Настройка моделей и провайдеров (включая CometAPI)
В Web UI перейдите в Settings → Models.
- Для официального DeepSeek: вставьте ключ с platform.deepseek.com. Типичные модели — deepseek-v4-flash и deepseek-v4-pro.
- Для каталогов провайдеров (Anthropic, OpenAI и т. п.): используйте процесс «Add provider».
- Для кастомных / само‑хостимых / агрегирующих конечных точек: выберите «Add a custom provider». Укажите постоянный ID провайдера, базовый URL, протокол (обычно openai-completions), ссылку на ключ API из окружения или значение, и как минимум один ID модели.
Рекомендация по CometAPI (настоятельно рекомендуется для многих сценариев, близких к продакшену) CometAPI — это унифицированная платформа AI‑инфраструктуры, предоставляющая доступ к 500+ моделям (включая варианты DeepSeek, GPT, Claude, Gemini, Grok и многие другие) через единую совместимую с OpenAI конечную точку: https://api.cometapi.com/v1.
Преимущества при использовании с DeepSeek Harness:
- Один ключ API вместо управления множеством учётных данных провайдеров.
- Конкурентные цены (сообщается об экономии 20–40% по сравнению с прямыми тарифами многих вендоров).
- Высокая доступность (целевой SLA 99,9%), низкая медианная задержка и оплата по факту.
- Лёгкая смена моделей для A/B‑тестов или оптимизации затрат без изменений конфигурации обвязки, кроме ID модели.
- Совместимость «подстановкой»: существующие паттерны SDK OpenAI работают после замены только base_url и ключа.
В форме кастомного провайдера обвязки:
- Base URL:
https://api.cometapi.com/v1 - Protocol: openai-completions (или эквивалентная поддерживаемая опция)
- API key: ваш ключ CometAPI
- Model ID: любая поддерживаемая строка модели из каталога CometAPI
Эта комбинация сохраняет мощный локальный рантайм агента, предоставляя гибкий, экономичный, мультивендорный доступ к моделям. Новые пользователи обычно получают бесплатные тестовые кредиты. Документация: https://apidoc.cometapi.com/.
Ключи хранятся только на запись (например, в $DSH_HOME/.credentials.yaml); в UI отображаются только редактированные дескрипторы.
Устранение неполадок DeepSeek Harness
DEEPSEEK_API_KEY not found
Проверьте:
echo $DEEPSEEK_API_KEY
В Windows:
echo $env:DEEPSEEK_API_KEY
Если пусто — задайте переменную снова.
400 reasoning_content error
Обычно указывает на некорректную обработку жизненного цикла рассуждений.
Убедитесь, что ваше приложение сохраняет соответствующую информацию о рассуждениях ассистента между несколькими ходами с thinking/tool‑call.
Это одна из базовых проблем, с которой обвязка специально помогает справляться.
Ошибка длины контекста
Проверьте:
input tokens + max_tokens
Документированный жёсткий потолок:
1,048,576 tokens
Уменьшите входной контекст или запрошенный размер завершения.
Вызовы инструментов искажаются при стриминге
Не предполагайте, что части потока приходят в порядке инструментов.
Агрегируйте дельты вызовов инструментов по tool_call.index, как рекомендовано контрактом обвязки.
Запросы неожиданно дорогие
Проверьте:
- режим рассуждений (thinking)
- длину вывода
- долю попаданий в кэш
- стабильность префикса промпта
- выбор модели
- текущие цены API
Простое улучшение — перенести рутинные задачи с Pro на Flash.
Сравнение методов установки и развёртывания
| Метод | Простота | Нужен Node | Лучшее применение | Сохранность / Контроль | Типичный порт / Доступ | Примечания |
|---|---|---|---|---|---|---|
| однострочник npx | Наивысшая | Да | Быстрые пробы, большинство пользователей | Эфемерно (только кэш) | 3080 (настраиваемо) | Официально рекомендовано |
| Исходники (pnpm) | Средняя | Да | Разработка, плагины, фиксация | Полный контроль исходников | 3080 | Нужны pnpm + сборка |
| Настольные (Tauri/Electron) | Высокая | Нет (встроен) | Неспециалисты | Локальные профили и автообновление | 3080 (внутренний) | Пакеты сообщества |
| Docker | Средняя | Нет (в контейнере) | Серверы, LAN, HTTPS | Томa контейнера | Произвольный / 443 | Образы сообщества |
| Python SDK | Средняя | Нет (встроен) | Безголовые сценарии, автоматизация, пайплайны | Программные сессии | N/A (по умолчанию без UI) | Официальный SDK |
| Запуск через Ollama | Высокая | Опционально | Эксперименты с локальными моделями | Настройки Ollama | 3080 | Интегрируется с Ollama |
Данные синтезированы из официальной документации и руководств, опубликованных после запуска (август 2026).
Заключение и дальнейшие шаги
DeepSeek Harness приносит на локальные машины аккуратно спроектированный, полностью плагинный рантайм агента с почти нулевым трением через однострочник npx. В сочетании с гибкой маршрутизацией моделей — особенно через унифицированную платформу CometAPI — вы получаете и мощь современных агентных рабочих процессов, и реальный контроль над стоимостью, выбором моделей и локальностью данных.
Начните уже сегодня:
npx @deepseek-ai/dsh web
Настройте ключ DeepSeek или CometAPI, укажите безопасное рабочее пространство и изучите режим Standard. Затем поэкспериментируйте с режимом Minimal для бенчмарков, кастомными провайдерами для оптимизации затрат или Python SDK для автоматизации.
Для последних официальных инструкций всегда обращайтесь к репозиторию GitHub и документации. Для многомодельной надёжности и ценовых преимуществ при работе обвязки изучите CometAPI и его документацию на https://apidoc.cometapi.com/.


