DeepSeek Harness (dsh)
Официальный фреймворк с открытым исходным кодом от DeepSeek AI, спроектированный для сборки, запуска и тонкой настройки автономных ИИ-агентов.
Превратите любую языковую модель в полноценного разработчика по фундаментальной формуле:
Агент = Модель + Среда (Harness)
npx @deepseek-ai/dsh webЗапустите локальный Web-интерфейс одной командой (требуется Node.js ^22.19 или >= 24).
01 · philosophy
Философия: Модель — это разум, Harness — это тело
Большинство разработчиков привыкли оценивать ИИ только по весам его моделей. Но языковая модель сама по себе способна лишь предсказывать следующий токен. Чтобы решать реальные задачи, ИИ-агенту необходима надежная инфраструктурная обвязка — Harness.
DeepSeek Harness (dsh) берёт на себя всю инженерную работу, которую модель не может выполнить в одиночку:
- Управление контекстом: интеллектуальное усечение, сжатие и фокус на важных фрагментах кода в длинных сессиях.
- Интеграция с системой: контролируемый доступ к локальной файловой системе и выполнение команд в терминале Bash.
- Работа с инструментами: вызов API, интеллектуальный поиск информации в веб-пространстве и запуск тестов.
- Безопасность: жёсткое разграничение прав доступа и запуск кода в изолированных песочницах.
02 · trajectory
Каждое действие агента — в журнале
В dsh действует принцип «Model-visible means logged»: всё, что видит модель, гарантированно фиксируется в журнале сессии, и любое состояние можно восстановить из лога со 100% точностью.
12:04:01sessioncreate(standard)ok12:04:02modelreason: chain-of-thoughtvisible12:04:05toolbash("ls src/")exit 012:04:09modeledit(src/main.ts)visible12:04:12actionresume · fork · replayready
03 · plugins
Всё является плагином
В отличие от традиционных монолитных фреймворков, где логика работы агента намертво вшита в ядро, в dsh абсолютно любой компонент является сменным плагином.
Система построена на базе микроядерного мета-фреймворка Cordis, реализующего парадигму пространственно-временной компонуемости (spatiotemporal composability):
- Компонуемость в пространстве: плагины объявляют зависимости друг от друга через механизм инъекции (
inject) и автоматически активируются только при наличии необходимых сервисов. - Компонуемость во времени (обратимые эффекты): Cordis помнит каждое изменение, внесённое плагином в runtime. При отключении плагина система гарантированно и чисто «откатывает» все зарегистрированные слушатели событий, открытые сетевые порты и таймеры.
Адаптеры моделей, хранилища сессий, наборы инструментов разработки, песочницы безопасности и даже сам главный цикл рассуждений (Agent Loop) являются модулями, которые можно заменить в один клик в конфигурационном файле, не меняя ни единой строчки кода самого фреймворка.
04 · features
Ключевые возможности платформы
Четыре режима работы под любые сценарии
При переключении режимов на лету меняется состав активного дерева плагинов и доступных инструментов: Standard Mode для полноценной разработки, PTC Mode для программного вызова инструментов, Minimal Mode для чистого бенчмаркинга и Creator Mode для конструирования агентов.
Trajectory View: конец «чёрного ящика»
Каждое действие агента прозрачно: системные промпты, скрытые рассуждения (Chain of Thought), вызовы инструментов и их результаты непрерывно записываются в последовательный защищённый лог сессии. Благодаря этому можно в один клик продолжить сессию с любого места (Resume), проиграть её заново (Replay) или ответвить траекторию (Fork).
Безопасность и гибкие песочницы
dsh разделяет понятия авторизации и песочницы и поддерживает несколько уровней разрешений (Permission Tiers): от строго изолированного режима работы только внутри проектной папки с ручным подтверждением каждого шага (Supervised) до полной свободы действий.
Полная свобода в выборе моделей (Model-Agnostic)
Фреймворк не ограничивает вас экосистемой DeepSeek. По умолчанию поддерживаются DeepSeek V4 Pro и Flash, однако dsh умеет работать с Anthropic, OpenAI, AWS Bedrock, Google Vertex, Azure, а также с любыми локально развёрнутыми моделями через Ollama или vLLM.
05 · quick-start
Быстрый старт за 3 шага
-
Проверьте окружение: убедитесь, что на вашем компьютере установлен Node.js версии
^22.19или>=24.0.0. -
Запустите dsh: выполните в терминале команду:
npx @deepseek-ai/dsh web -
Начните работу: перейдите по адресу http://127.0.0.1:3080, укажите свой API-ключ, выберите безопасную рабочую директорию на вашем ПК и создайте первую сессию в Standard Mode.
06 · community
Сообщество и экосистема
DeepSeek Harness — это не просто инструмент, это динамично развивающаяся платформа. С момента запуска в августе 2026 года dsh стал одним из самых быстрорастущих проектов в истории GitHub. Разработчики со всего мира уже создали сотни плагинов, включая TUI-интерфейсы, системы визуализации схем Mermaid, модули долгосрочной памяти и интеграции с Obsidian и JetBrains IDE.
Присоединяйтесь к созданию стандартов будущего агентного ИИ.