Блог AST-SoftPro
DeepSeek Harness: обзор агентного рантайма, где всё — плагин
Введение
В августе 2026 года DeepSeek выпустила open-source агентный рантайм, который за несколько дней стал одним из самых быстрорастущих проектов на GitHub. Речь о DeepSeek Harness (командное имя dsh) — harness'е, в котором «всё является плагином»: модели, инструменты, сессии, песочницы, хранилище, даже сам агентный цикл и пользовательский интерфейс грузятся как заменяемые модули.
В этой статье мы разбираем DeepSeek Harness: его историю, архитектуру на ядре Cordis, девять категорий плагинов, четыре режима запуска и сравнение с аналогами — Claude Code, Grok Build, OpenClaw и Hermes Agent. Статья полезна разработчикам, которые хотят не просто пользоваться готовым агентом, а собрать собственный под свои требования: свою модель, свой sandbox, своё хранилище — без форка чужого репозитория.
Что такое DeepSeek Harness
DeepSeek Harness — это open-source агентный рантайм: программный слой, который оборачивает большую языковую модель и превращает её в работающего агента, способного читать файлы, запускать команды, использовать инструменты, искать в вебе и продолжать работу на длинных задачах. Формулировка DeepSeek лаконична: Agent = Model + Harness. Модель даёт рассуждения; harness даёт всё остальное — включая цикл, который решает, что происходит дальше.
Ключевое отличие от большинства harness'ов — архитектурная философия «всё является плагином». В типичном агенте кто-то заранее выбрал хранилище сессий, sandbox, модель планирования и UI, и эти решения зашиты в исходный код. Если ваша конфигурация с ними не согласна — вы форкаете репозиторий и вечно поддерживаете патч. Вы становитесь владельцем чужой архитектуры ради изменения одной строки.
DeepSeek Harness работает иначе. Здесь нет «привилегированного ядра», которое нужно обходить: модель-плагин и storage-плагин грузятся через одно и то же ядро, и каждая способность — объект одного типа. Это позволяет:
-
Указать другую модель (заменить model-плагин) — цикл продолжает работать.
-
Подставить собственный sandbox provider, если нельзя отправлять код или сессионные данные на endpoint вендора.
-
Заменить backend хранилища, не трогая исходники harness'а.
-
Перепрошить сам агентный цикл — потому что цикл тоже плагин.
💡 Практическая выгода: «всё является плагином» означает, что вы не привязаны к opinionated-решениям конкретного вендора. Команда может собрать harness под свои требования к безопасности (локальный sandbox), к стоимости (дешёвая модель) и к инфраструктуре (S3 вместо локального диска) — всё это меняется в конфиге, а не в коде.
История: релиз и взрывной рост
История DeepSeek Harness короткая, но показательная. Ключевые вехи:
| Дата | Событие |
|---|---|
| 13 августа 2026 | Релиз (developer preview v0.1), MIT license; одновременно GA DeepSeek-V4-Pro |
| Через ~90 минут | 22 000 звёзд GitHub — рекорд скорости роста на тот момент |
| 17 августа 2026 | Более 141 000 звёзд, 14 000 форков, 1200+ community-плагинов с тегом dsh-plugin |
13 августа 2026. DeepSeek выпустила Harness в статусе developer preview (v0.1) под лицензией MIT — в тот же день, что и GA модели DeepSeek-V4-Pro. Пара не случайна: harness использовался внутри компании для бенчмаркинга собственных моделей, и публикация кода означает, что команда, обучающая DeepSeek-V4, открыла, как именно она строила цикл вокруг модели.
Скорость набора звёзд стала главной новостью релиза: 22 000 звёзд за 90 минут — по данным KuCoin. Для сравнения, предыдущий рекордсмен xAI Grok-1 набрал 20 000 примерно за 1,2 дня. К 17 августа (через четыре дня) репозиторий перевалил за 141 000 звёзд и 14 000 форков, а число community-плагинов с тегом dsh-plugin превысило 1200.
⚠️ Важно: это developer preview. В README DeepSeek прямо предупреждает: впереди breaking changes совместимости. Запускайте для реальной работы на сервере, который можно пересобрать, а не как несущую конструкцию продакшн-системы, которую нельзя тронуть полгода.
Ядро Cordis: то, что все пропускают
DeepSeek Harness работает на Cordis — TypeScript meta-framework вокруг обратимой плагинной системы. Компоненты можно монтировать, размонтировать и горячо перезагружать в рантайме, при этом все побочные эффекты чисто откатываются при удалении. Дизайн формализован в опубликованной статье A Programming Paradigm for Spatiotemporal Composability, которая делит динамическую композицию на две оси:
-
Темпоральная композибельность — полное откатывание эффектов компонента.
-
Пространственная композибельность — декларация и реактивное управление зависимостями между компонентами.
Деталь, которую пропустили в хайпе недели релиза: Cordis — не изобретение DeepSeek. По данным Floatboat, Cordis четыре года питал open-source фреймворк чат-ботов Koishi (около 6000 звёзд GitHub), который строил агентов для Discord, Telegram и других платформ. Koishi требовал ровно то, что нужно агентным рантаймам: плагины, регистрирующие команды и сервисы, горячую перезагрузку в разработке и чистую уборку при отключении. Koishi работал на Cordis v3; DeepSeek Harness вышла на Cordis v4, а формальная статья за редизайном v4 была опубликована в тот же день, что harness стала публичной.
Таким образом, ядро — battle-tested, а вклад DeepSeek — это агентный продукт, собранный поверх него, плюс экосистемная игра: README просит авторов плагинов тегами dsh-plugin для обнаружения.
💡 Практическая выгода: обратимая плагинная система с hot-reload означает, что разработчик плагинов не перезапускает весь рантайм при изменении — компонент перемонтируется на лету, а его эффекты откатываются чисто. Это ускоряет цикл разработки экосистемы.
Девять категорий плагинов
Каждая способность агента живёт в плагине. Официальная документация выделяет девять заменяемых категорий:
| Категория | Что контролирует | Зачем заменять |
|---|---|---|
| Models | Какая LLM питает агента | Стоимость, возможности, data residency |
| Tools | Что агент может делать (bash, правки файлов, browse) | Добавить кастомные инструменты под свой стек |
| Skills | Переиспользуемые пакеты инструкций | Обучить доменные workflow'ы |
| Sessions | Состояние и история диалога | Кастомные правила персистентности |
| Sandboxes | Где исполняется код | Держать исполнение внутри своей сети |
| Storage | Где живут данные | Заменить локальный диск на S3 или БД |
| Loops | Цикл «думай-действуй» агента | Кастомная логика оркестрации |
| Scheduling | Когда и как выполняется работа | Долгие задачи без отдельного фреймворка |
| UI | С чем вы взаимодействуете | White-label или встраивание интерфейса |
Строка про scheduling заслуживает отдельного внимания. Поскольку loops и scheduling настраиваются, а не программируются, долгие задачи не требуют отдельного оркестрационного фреймворка поверх (cron, Temporal, n8n). Это убирает целый слой, который большинство агентных стеков прикручивают снаружи.
Четыре режима запуска
DeepSeek Harness поставляется с четырьмя пресетными режимами рантайма; в репозитории на диске ровно четыре каталога agent-preset, соответствующих им:
| Режим | Что делает | Для чего |
|---|---|---|
| Standard | Полный агент с полным набором инструментов и dispatch субагентов | Повседневный кодинг и автоматизация |
| Code (PTC) | Programmatic Tool Calling: модель пишет TypeScript для сложных control flow вместо вызова инструментов по одному | Многошаговые workflow'ы с ветвлением |
| Minimal | Только bash и str_replace_editor, ничего больше |
Чистые бенчмарки моделей |
| Creator | Тест Cordis-плагинов в памяти | Авторы плагинов для экосистемы |
Режим Minimal объясняет часть того, зачем этот проект существует вообще: DeepSeek использовала этот harness внутри для бенчмаркинга собственных моделей. Обезжиренный режим — это то, как выглядит честная оценка модели, когда harness не делает «тяжёлую работу» за неё.
Режим Code (PTC) — Programmatic Tool Calling — примечателен архитектурно: вместо того чтобы модель вызывала инструменты по одному (tool call → результат → следующий tool call), она генерирует TypeScript-код, выражающий сложный control flow. Это позволяет выразить ветвление и циклы в одном шаге, а не растягивать их на десятки ходов цикла.
Model-agnostic и append-only лог сессий
DeepSeek Harness по умолчанию model-agnostic: поддерживает DeepSeek, Anthropic, OpenAI, Amazon Bedrock, Google Vertex, Azure и любой OpenAI-совместимый endpoint «из коробки». Последняя оговорка покрывает OpenRouter, Ollama, vLLM и большинство self-hosted inference-серверов. Harness вышел вместе с DeepSeek-V4-Pro, и пара намеренна, но ничего не привязывает вас к моделям DeepSeek.
Каждый запуск записывается в append-only лог сессий — поток событий, к которому добавляются записи, но которые не перезаписываются. Resume, fork, поиск и replay работают поверх этого лога. Если агентный прогон пошёл не так на шаге 40, можно форкнуть сессию на шаге 39 и попробовать другой путь — с полным треком того, что модель видела на каждом шаге.
💡 Практическая выгода: append-only лог с fork/replay — это функция, которая больше всего меняет ежедневную работу для тех, кто отлаживал black-box провалы агентов. Она также делает prompt injection и вызовы инструментов полностью инспектируемыми постфактум — критично для аудита безопасности.
Установка и запуск
Самый быстрый путь от нуля до работающего агента занимает около двух минут на машине с Node.js 20+.
Вариант A: мгновенный запуск через npx (рекомендуется для первого знакомства)
-
Установите Node.js 20 или новее.
-
Выполните
npx @deepseek-ai/dsh web. -
Откройте
http://127.0.0.1:3080в браузере. -
Добавьте API-ключ вашего провайдера моделей (DeepSeek, Anthropic, OpenAI или любой OpenAI-совместимый endpoint).
Вариант B: headless CLI — для скриптов и серверов, без Web UI.
Вариант C: Python SDK — для встраивания агента в собственные приложения.
Локальный Web UI на 127.0.0.1:3080 означает, что агент работает на вашей машине, а данные не покидают её до тех пор, пока вы сами не укажете облачный endpoint. Для локальных моделей достаточно подставить OpenAI-совместимый адрес self-hosted сервера — например, Ollama как локальный ИИ-движок или один из открытых моделей вроде Qwen3.8-27B, которую мы рассматривали отдельно.
Сравнение с аналогами
DeepSeek Harness входит в поле, где уже есть Claude Code, Grok Build, OpenClaw и Hermes Agent. Ключевое отличие — архитектура: остальные это «готовые продукты с мнением», а DeepSeek Harness — «шасси».
| Критерий | DeepSeek Harness | Claude Code | Grok Build | OpenClaw |
|---|---|---|---|---|
| Лицензия | MIT (весь репозиторий) | Проприетарный | Apache 2.0 (source-available) | MIT |
| Архитектура | Плагинное ядро (Cordis) | Монолитный продукт | Rust harness, слои | Монолит + конфиг |
| Поддержка моделей | Любой провайдер | Модели Anthropic | xAI + локальный | Несколько провайдеров |
| Основной фокус | Компонуемый агентный рантайм | Coding-агент | Coding-агент (TUI) | Messaging-first агент |
| Replay сессий | Resume, fork, replay | Session resume | Ограниченно | Базовая история |
| Зрелость | Developer preview (v0.1) | Production | Production | Stable |
| Платформа | Node.js | Node.js | Rust (бинарник) | Node.js |
DeepSeek Harness против Claude Code
Claude Code — зрелый проприетарный агент от Anthropic с глубокой интеграцией в экосистему Anthropic. Его сильные стороны: production-зрелость, развитые skills и hooks, отработанная система разрешений. Слабая сторона для команд, которым нужна кастомизация — закрытость: нельзя заменить модель на произвольную или подставить свой sandbox без выхода за рамки продукта.
DeepSeek Harness выигрывает в композируемости (любой компонент заменяется плагином) и model-agnostic поддержке. Claude Code выигрывает в зрелости и накопленных интеграциях. Выбор зависит от приоритета: готовый проверенный продукт против шасси, которое можно пересобрать под себя.
DeepSeek Harness против Grok Build
Grok Build (xAI) — Rust harness с открытыми исходниками (Apache 2.0), полноэкранным TUI, plan mode и параллельными субагентами в worktrees. Мы разбирали его подробно в отдельной статье Grok Build: обзор, история и сравнение.
Оба проекта открыты, но с разными акцентами. Grok Build — это «заточенный» coding-агент с сильной TUI и локальным запуском; его слои (agent loop, tools, TUI, extensions) опубликованы как reference, но архитектура не позиционируется как плагинное шасси для произвольной пересборки. DeepSeek Harness — это именно шасси: девять категорий плагинов, включая сам цикл и UI, заменяются в конфиге. Если вам нужен готовый терминальный агент с хорошим TUI — Grok Build; если нужно собрать собственный рантайм из компонентов — DeepSeek Harness.
DeepSeek Harness против OpenClaw
OpenClaw — зрелый MIT-агент, messaging-first (Discord/Telegram и т.п.), со стабильной историей сессий. Как и Hermes Agent, это «готовый продукт с мнением». DeepSeek Harness — шасси: если мнения готовых продуктов совпадают с вашими потребностями, они запускаются быстрее; если вы когда-либо форкали один из них ради замены компонента, шасси — то, что вам на самом деле нужно.
⚠️ Важно о выборе: ни один harness не является универсально «лучшим». Критичные решения (какой рантайм встроить в продакшн, какой использовать для бенчмаркинга) стоит принимать после пилотного тестирования на реальных задачах. Поверхностное сравнение по маркетинговым характеристикам не учитывает edge-кейсы: как harness ведёт себя на вашем стеке, с вашими моделями и ограничениями безопасности. Для продакшн-решений рекомендуется привлечение специалистов с опытом — это снижает риски архитектурных просчётов и ошибок безопасности, которые обнаружатся только при росте нагрузки.
Риски developer preview и роль экспертизы
DeepSeek Harness — developer preview v0.1 с явным предупреждением о breaking changes. Это создаёт системные риски при внедрении:
-
Нестабильность API. Плагины, написанные сегодня, могут перестать работать после обновления ядра. Для продакшн это означает необходимость фиксировать версии и тестировать каждое обновление.
-
Безопасность. Модель-агент может сгенерировать код с SQL-инъекциями, XSS или неправильной аутентификацией. Append-only лог делает вызовы инструментов инспектируемыми постфактум, но это механизм аудита — он не предотвращает уязвимость, а позволяет её найти.
-
Масштабируемость. Архитектурные решения по выбору плагинов (sandbox, storage, loop) на раннем этапе обнаружатся только при росте нагрузки. Замена «на лету» возможна, но миграция данных между storage-плагинами — отдельная инженерная задача.
-
Поддерживаемость. Экосистема из 1200+ community-плагинов растёт быстро, но качество плагинов неравномерно. Подключение стороннего плагина без ревью его кода — это ввод чужого кода в ваш рантайм.
💡 Рекомендация: для продакшн-решений на базе DeepSeek Harness рекомендуется фиксировать версии плагинов, прогонять security-ревью сторонних плагинов и держать возможность пересобрать сервер. Команды, которые доверяют критичные задачи опытным разработчикам, экономят время и деньги на исправлении ошибок, которые могли быть предотвращены на этапе проектирования. Терминальный агент — мощный инструмент, но он не заменяет ревью и тестирование.
Рекомендации по внедрению
| Сценарий | Рекомендация |
|---|---|
| Первое знакомство | npx @deepseek-ai/dsh web, открыть 127.0.0.1:3080, подключить модель |
| Бенчмаркинг моделей | Режим Minimal (только bash + str_replace_editor) для честной оценки |
| Сложные workflow'ы с ветвлением | Режим Code (PTC) — модель пишет TypeScript control flow |
| Работа с локальными моделями | Укажите OpenAI-совместимый endpoint локального сервера (см. Ollama, Qwen3.8-27B) |
| Безопасность исполнения | Замените sandbox-плагин на локальный provider, чтобы код не покидал сеть |
| Долгие задачи | Используйте scheduling-плагин вместо внешнего cron/Temporal/n8n |
| Аудит и отладка | Опираться на append-only лог: fork сессии на шаге перед провалом, replay |
| Продакшн | Фиксировать версии плагинов, security-ревью сторонних плагинов, developer preview — не несущая конструкция |
⚠️ Типичная ошибка: использовать developer preview v0.1 как несущую конструкцию продакшн-системы. Breaking changes впереди. Запускайте на сервере, который можно пересобрать, и держите фиксированные версии плагинов.
Заключение
DeepSeek Harness — это open-source агентный рантайм от DeepSeek, где «всё является плагином»: девять категорий способностей (models, tools, skills, sessions, sandboxes, storage, loops, scheduling, UI) грузятся как заменяемые модули на ядре Cordis. Его ключевые отличия:
-
Композируемость — любой компонент, включая сам агентный цикл и UI, заменяется в конфиге без форка исходников.
-
Model-agnostic — DeepSeek, Anthropic, OpenAI, Bedrock, Vertex, Azure и любой OpenAI-совместимый endpoint из коробки.
-
Append-only лог сессий — resume, fork, replay для отладки и аудита.
-
Четыре режима — Standard, Code (PTC), Minimal, Creator.
-
Battle-tested ядро Cordis — четыре года питало Koishi, формализовано в статье о spatiotemporal composability.
-
Взрывной рост — 22 000 звёзд за 90 минут, 141 000+ к четвёртому дню, 1200+ community-плагинов.
При выборе между DeepSeek Harness, Claude Code, Grok Build и OpenClaw ориентируйтесь на приоритеты: композируемость и model-agnostic (DeepSeek Harness), зрелость закрытой экосистемы (Claude Code), заточенный терминальный агент с TUI (Grok Build) или готовый messaging-first продукт (OpenClaw). И помните: harness — это инструмент, который усиливает разработчика, но не заменяет экспертизу. Для критичных задач сочетание агента с опытным ревью, фиксацией версий плагинов и тестированием даёт лучший результат по соотношению скорости и качества.
Источники
-
DeepSeek Harness developer preview: Everything is a plugin (deepseek.com)
-
What Is DeepSeek Harness? Features, Architecture & Use Cases (xCloud, август 2026)
-
DeepSeek open sources an agent harness where everything is a plugin (The New Stack)
-
Grok Build: обзор, история и сравнение с аналогами (ast-softpro.ru)