Что такое DeepSeek Harness
Компания DeepSeek открыла исходный код агентского рантайма DeepSeek Harness: версия v0.1 вышла в режиме developer preview и доступна под лицензией MIT. Проект распространяется как пакет dsh в репозитории deepseek-ai/deepseek-harness.
По замыслу авторов, Harness — это прослойка между моделью и окружением, в котором она действует. В неё входят инструменты, файловая система, песочницы и управляющий цикл. Формула простая: Agent = Model + Harness. То есть это не готовый ассистент, а каркас, из которого такой ассистент собирается.
Важно понимать: v0.1 — это именно разработческая инфраструктура. Для production-нагрузок она пока не предназначена, зато даёт возможность проверить архитектурные идеи проекта на ранней стадии и заложить под них собственные решения.
Архитектура: всё является плагином
Главное отличие от большинства харнессов с фиксированным слоем — позиция, заявленная буквально в первых строках README: всё является плагином. Модели, инструменты, навыки, сессии, песочницы, хранилища, циклы выполнения, планировщики и даже UI вынесены за границы плагинов Cordis.
Cordis — это мета-фреймворк, дизайн которого описан в работе «A Programming Paradigm for Spatiotemporal Composability». Его ядро отвечает только за монтирование и размонтирование плагинов и управление их зависимостями. Все возможности живут в плагинах, а не в привилегированном ядре — это ключевое архитектурное решение.
Практическое следствие: любой компонент можно выбрать, заменить или расширить прямо в конфигурации, не трогая исходный код самого DeepSeek Harness. Фактически это конструктор агентных рантаймов под конкретную задачу, а не фиксированный coding assistant.
Четыре режима рантайма
Проект предлагает четыре предустановленных режима:
- Standard — полноценный coding-агент: редактирование файлов, shell, поиск по файлам и вебу, навыки, планирование, цели, субагенты и workflows.
- Code — те же инструменты, но доступные через Code Mode SDK: модель собирает многошаговые операции в одну TypeScript-программу.
- Minimal — «голая» среда всего с двумя инструментами (persistent bash и str_replace_editor), предназначенная для бенчмаркинга моделей.
- Creator — режим для инспекции рантайма, экспериментов с плагинами в памяти и подсказок по созданию пресетов.
Такой набор режимов позволяет применять один и тот же рантайм и для продуктовых агентов, и для оценки моделей, и для отладки собственных плагинов — без переключения на отдельные фреймворки.
Полная трассируемость запусков
Каждый запуск в DeepSeek Harness полностью трассируем. В append-only лог сессии записывается всё, что видит модель: системные промпты, рассуждения, вызовы инструментов и их результаты, планирование субагентов и каждая инъекция контекста. Последнее — заметно более сильное обещание, чем обычное логирование вызовов инструментов.
На основе этого потока событий работают trajectory view для просмотра записей по источникам, а также resume, fork, search и replay. Любую сессию можно вернуть, разветвить, найти по содержимому и воспроизвести — что критично для отладки и для аудита агентных действий.
Модели и провайдеры
Маршрутизация моделей — тоже плагин, и это логичное продолжение общей архитектуры. В Settings → Models ключ DeepSeek API вступает в силу уже со следующего запроса, без перезапуска сервера. Установленный каталог провайдеров добавляет Anthropic и OpenAI по API-ключу.
Для корпоративных облачных сервисов нужны нативные учётные данные: для Bedrock — AWS-креды и регион, для Vertex — проект с ADC, для Azure — api-version, для Codex — OAuth. Кроме того, поддерживаются кастомные провайдеры: достаточно указать любой OpenAI-совместимый base URL и протокол.
Ключи хранятся с пометкой write-only в файле $DSH_HOME/.credentials.yaml; в настройках остаётся только ссылка на учётные данные, а не сами секреты. Это удобно и с точки зрения безопасности, и при работе в команде.
Как запустить и подключить SDK
Web UI
Самый простой способ попробовать рантайм — команда npx @deepseek-ai/dsh web, которая поднимает Web UI по адресу http://127.0.0.1:3080. Если хочется собрать из исходников: git clone, затем pnpm install, pnpm run build и pnpm dsh web.
Python SDK
Для программной интеграции предусмотрен пакет deepseek-harness-sdk. Ему нужен Python 3.10 или новее, а в качестве платформ поддерживаются Linux x64, Linux arm64 и macOS 14+ на arm64. Приятная деталь: встроенный рантайм не требует системного Node.js, так что окружение для запуска агентов не придётся дополнительно настраивать.
Кому это может пригодиться
Целевая аудитория проекта — AI-native стартапы и платформенные и developer-experience команды в средних и крупных компаниях. Регулируемые предприятия могут пилотировать DeepSeek Harness локально: он распространяется под MIT и является self-hosted, а значит, чувствительные данные не покидают контур.
Среди отраслей, где такой рантайм выглядит уместно: разработка ПО и devtools, финансовые услуги и страхование с их потребностью в аудируемых агентных запусках, здравоохранение и фармацевтические R&D, облачные и полупроводниковые вендоры, академические и промышленные исследовательские лаборатории.
Типичные сценарии применения — внутренние coding-агенты для приватных репозиториев, оценка моделей в контролируемой среде, observability агентов с replay запусков, кастомные политики песочниц и одобрений, а также упаковка внутренних инструментов в переиспользуемые плагины. Всё это укладывается в общую идею: не брать готового ассистента, а собрать рантайм под себя.
