Подписывайтесь:

Блог AST-SoftPro

DeepSeek Harness: обзор агентного рантайма, где всё — плагин

18.08.2026 23 мин чтения
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 (рекомендуется для первого знакомства)

  1. Установите Node.js 20 или новее.

  2. Выполните npx @deepseek-ai/dsh web.

  3. Откройте http://127.0.0.1:3080 в браузере.

  4. Добавьте 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 — это инструмент, который усиливает разработчика, но не заменяет экспертизу. Для критичных задач сочетание агента с опытным ревью, фиксацией версий плагинов и тестированием даёт лучший результат по соотношению скорости и качества.

Источники

AI-Помощник