DeepSeek Harness (dsh)

DeepSeek Harness (dsh): открытый агентный харнесс и как его запустить

DeepSeek Harness (сокращённо dsh) — открытый агентный харнесс от DeepSeek AI. Важно понимать сразу: это не модель, а обвязка вокруг модели — среда, которая даёт LLM инструменты, память сессии, управление задачами и плагины. Модель отвечает за «мышление», харнесс — за то, что агент реально может делать: читать файлы, запускать команды, писать код, выполнять задачи по расписанию.

Что такое агентный харнесс и почему это важно

Одна и та же модель в разных харнессах показывает разный результат. Харнесс определяет, какие инструменты доступны агенту, как строится контекст, как подтверждаются опасные действия и как отлаживается поведение. DeepSeek Harness — открытая реализация такой обвязки: её можно запустить локально, изучить исходники и расширить под свои задачи.

Ключевая идея: «everything is a plugin»

В основе dsh лежит принцип «всё — плагин». Ядро построено на Cordis — IoC-контейнере с dependency injection, обратимыми побочными эффектами и hot reload без утечек. Практический смысл для пользователя: возможности агента наращиваются плагинами, а не правками ядра, и поведение системы можно пересобрать под конкретный сценарий.

Технически это монорепозиторий на Node.js / TypeScript, сборка через pnpm, схемы валидируются на schemastery.

Что умеет

• Повседневные задачи — работа с файлами, данными, документами, презентациями.
• Разработка — работа с репозиторием, разбор багов, написание тестов.
• Ресёрч — исследование с цитированием источников.
• Фоновые задачи — длительные операции не блокируют работу.
• Плагины — расширение функциональности, в том числе сборка собственных пресетов в Creator mode.
• Задачи по расписанию — регулярные сценарии.
• Отладка — трейсы и рантайм для разбора поведения агента.

Режимы работы

| Режим | Что делает | | --- | --- | | Standard | Полноценный агент с полным набором инструментов. | | Code | Инструменты как Code Mode SDK: модель пишет одну TypeScript-программу вместо серии отдельных вызовов. | | Minimal | Минимальный набор — bash и str_replace_editor; удобен для бенчмарков и честных сравнений. | | Creator | Сборка собственных пресетов и плагинов. |

> Оговорка: официально подтверждён режим Creator (на сайте продукта). Остальные три режима описаны в разборе на Habr и в момент проверки в публичных README/guide не дублировались. Если для вас критична только официальная документация — считайте эту таблицу ориентировочной.

Установка и запуск

Самый быстрый способ — запустить готовый пакет из npm (`@deepseek-ai/dsh`):

```bash npx @deepseek-ai/dsh web ```

Поднимется Web UI на `http://127.0.0.1:3080`. Флаг `--no-open` отключает автоматическое открытие браузера. Есть также desktop-приложение.

Сборка из исходников:

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

Первичная настройка

1. Settings → Models — укажите ключ DeepSeek. Поддерживаются и другие провайдеры, включая OpenAI-совместимые эндпоинты. 2. Choose workspace — выберите рабочую папку, в которой агент будет работать с файлами. 3. Начать сессию — дальнейшая работа идёт в рамках сессии с её историей и контекстом.

Кому подойдёт

• Разработчикам, которым нужен локальный агент с доступом к репозиторию и терминалу.
• Командам, которые хотят расширять агента своими плагинами и пресетами.
• Тем, кто исследует агентные архитектуры и хочет читать исходники, а не только пользоваться чёрным ящиком.

Ограничения и что учесть

• Статус — public / developer preview. Команда прямо предупреждает о compatibility-breaking changes: обновления могут ломать совместимость.
• Нужен собственный API-ключ к модели — харнесс сам по себе не даёт доступа к LLM.
• Это инструмент для технических пользователей: запуск через npm или сборка из исходников предполагает знакомство с Node.js и терминалом.
• Осторожность с инструментами агента. Агент умеет изменять файлы и выполнять команды — политика подтверждений и изолированное workspace здесь не формальность.

Итог

DeepSeek Harness — аккуратный пример того, как вендор открывает не только модель, но и саму агентную обвязку: MIT-лицензия, npm-пакет, исходники на TypeScript и плагинная архитектура на Cordis. Для команд, которые строят свои агентные сценарии, это готовый каркас, который можно изучать и расширять. Единственное, что стоит держать в голове, — статус developer preview: API и поведение ещё будут меняться.

Ссылки

• Официальная страница: https://www.deepseek.com/en/harness/
• Репозиторий: https://github.com/deepseek-ai/deepseek-harness
• Quickstart: https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart
• Плагины: https://github.com/topics/dsh-plugin