DeepSeek Harness: что это и как установить

DeepSeek Harness — это официальный агент DeepSeek с открытым кодом: он не только отвечает текстом, но и читает ваши файлы, правит код, запускает команды, собирает презентации и работает по расписанию. Запускается двумя способами — как десктопное приложение или как веб-интерфейс из терминала. Разбираем, что это такое, чем отличается от обычного чата и как поставить за десять минут.

Что такое DeepSeek Harness

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

Ключевые свойства:

• Открытый код. Репозиторий deepseek-ai/deepseek-harness на GitHub, лицензия позволяет форкнуть и встроить в свой продукт.
• Архитектура «всё есть плагин» на фреймворке Cordis: интерфейс, инструменты и рабочие сценарии собираются из подключаемых модулей.
• Две формы запуска: desktop-приложение для Windows и macOS и веб-интерфейс, который поднимается одной командой.
• Плагины ставятся из интерфейса по имени npm-пакета, без командной строки.
• Автоматизация. Задачи можно ставить на расписание и смотреть историю прогонов.

Статус: публичная preview, версия 0.2 вышла 29 сентября 2026 года вместе с установщиками. DeepSeek прямо предупреждает, что будут ломающие совместимость изменения — это инструмент для ранних пользователей, а не корпоративная платформа.

Чем Harness отличается от чата и от сторонних агентов

Критерий	Веб-чат	DeepSeek Harness	Сторонние агенты (Claude Code, OpenCode)
Работа с файлами на вашем диске	нет	да	да
Запуск команд и тестов	нет	да	да
Плагины	нет	да, из npm	зависит от агента
Задачи по расписанию	нет	да, плагин автоматизации	редко
Кто разработчик	DeepSeek	DeepSeek	сообщество
Порог входа	нулевой	средний	средний

Главное отличие от чата: у агента есть доступ к вашей файловой системе. Это и сила, и риск — про права ниже.

Вариант 1: десктопное приложение

1. Скачайте установщик с официального сайта DeepSeek (раздел Harness) или со страницы релизов в репозитории. Для Windows — .exe, для macOS — .dmg.
2. Установите и запустите. Приложение само поднимет локальный экземпляр Harness и откроет интерфейс — отдельно настраивать сервер не нужно.
3. В настройках укажите ключ DeepSeek API. Модели подхватятся автоматически.
4. Выберите рабочую папку — без этого поле ввода задач неактивно.

Данные и сессии хранятся вне каталога установки, поэтому обновление не затирает настройки.

Вариант 2: веб-версия через npx

Подходит, если вы работаете в Linux, на сервере или хотите видеть процесс в терминале.

# нужен Node.js 20+
npx @deepseek-ai/dsh web

Команда поднимает веб-интерфейс на http://127.0.0.1:3080 и открывает браузер. Флаг --no-open запускает сервер без открытия окна — удобно на удалённой машине.

Дальше:

1. В интерфейсе откройте Настройки → Модели, вставьте ключ DeepSeek API и сохраните. Маршрутизация включается сразу, перезапуск не нужен.
2. Нажмите «Выбрать рабочую папку» и добавьте каталог проекта, из которого запускали команду.
3. Создайте сессию и отправьте первую задачу.

Если ключа нет — его можно получить на platform.deepseek.com; порядок действий и цены разобраны в статье DeepSeek API.

Первые задачи, которые стоит попробовать

• Разбор проекта: «Опиши структуру этого репозитория, назначение пакетов и точку входа».
• Документы: «Прочитай файлы в папке reports за октябрь, сведи в одну таблицу и найди расхождения».
• Презентация: «Сделай 10 слайдов по этому отчёту, по одному тезису на слайд».
• Код: «Найди, почему падает тест test_orders, исправь и запусти тесты заново».
• Рутина: «Каждое утро собирай сводку изменений в папке inbox в один markdown-файл».

Агент покажет план, выполнит шаги и вернёт файлы. Если для действия нужны дополнительные права, интерфейс спросит подтверждение.

Плагины и автоматизация

В версии 0.2 появилась страница управления плагинами: вводите имя npm-пакета — плагин ставится, там же его можно отключить, удалить и посмотреть источник. Встроенный плагин автоматизации позволяет превратить повторяющуюся задачу в расписание с историей прогонов и настройкой частоты.

Плагин может добавлять инструменты (например, доступ к базе или API), элементы интерфейса и целые рабочие сценарии. Поэтому Harness — не «чат с файлами», а среда, которую вы достраиваете под свой процесс.

Права и безопасность: главное

• DeepSeek Harness работает с реальными файлами. Перед первым запуском сделайте коммит или бэкап каталога.
• Ограничьте рабочую папку. Не указывайте домашний каталог целиком и тем более корень диска.
• Проверяйте, что запрашивает подтверждение. Запрос прав на удаление или запуск скрипта — нормальный сигнал, а не помеха.
• Не давайте доступ к секретам. Ключи и .env лучше держать вне рабочей папки.
• Ставьте только проверенные плагины. Плагин — это код, который получит доступ к вашим файлам и ключу API.

Ограничения preview-версии

• Интерфейс может меняться между версиями без предупреждения.
• Часть функций работает в экспериментальном режиме и может вести себя непредсказуемо на длинных задачах.
• Документация местами на китайском: основные гайды переведены, детали — нет.
• Публичный доступ к веб-интерфейсу требует настройки обратного прокси и защиты — «просто открыть порт в интернет» не стоит.

Нужен ли вам Harness

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

Сколько это стоит в реальной работе

Harness сам бесплатен, но каждая задача — это токены. Агентная сессия устроена дороже обычного чата: модель несколько раз перечитывает контекст, вызывает инструменты и получает их вывод обратно в диалог.

Сценарий	Токенов за сессию	Стоимость flash
Разбор небольшого проекта (30 файлов)	~150 тыс.	≈ $0,03–0,06
Правка с запуском тестов (10 шагов)	~500 тыс.	≈ $0,1–0,2
Многочасовая работа с репозиторием	2–5 млн	≈ $0,4–1,0

Кэш префикса здесь критичен: Harness переиспользует один и тот же системный контекст и историю инструментов, поэтому повторные шаги считаются по цене кэш-попадания — $0,006 за миллион вместо $0,30. Без кэша те же сессии стоили бы в несколько раз дороже.

Практический совет: длинные задачи запускайте вне пиковых часов. Пик — 01:00–04:00 и 06:00–10:00 UTC по будням, то есть по Москве это утро и ранний день; вечер и ночь идут по половинному тарифу.

Развёртывание для команды

Веб-версию можно поднять на сервере, чтобы коллеги работали с одного экземпляра. Что нужно предусмотреть:

• Обратный прокси и HTTPS. Не открывайте порт 3080 напрямую в интернет: у Harness нет встроенной корпоративной авторизации.
• Права на файловую систему. Агент работает в выбранных каталогах с правами процесса — запускайте его под отдельным пользователем, а не под root.
• Свой ключ на команду. Один ключ API на всех означает общий счёт и общий лимит параллельных запросов (2500 для Flash, 500 для Pro).
• Резервные копии. Учитывая статус preview, обновляйте версию осознанно: между релизами возможны ломающие изменения.

Python SDK

Если нужно встроить Harness в свой пайплайн, у проекта есть Python SDK: агент запускается как библиотека, а не как отдельное приложение. Это удобно для сценариев «раз в сутки обработать папку и записать отчёт» — не нужно держать окно открытым.

Порог входа выше, чем у обычного API: придётся разобраться с рабочими каталогами и правами. Если задача — просто получить ответ модели, SDK не нужен, хватит OpenAI-совместимого клиента из статьи DeepSeek API.