Как установить DeepSeek Harness и начать работу

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

Что такое DeepSeek Harness

DeepSeek Harness, сокращённо DSH, — открытая агентная среда DeepSeek AI. Она связывает языковую модель с инструментами и организует последовательность действий: получить задачу, прочитать нужные данные, вызвать инструмент, оценить результат и продолжить работу. У программы есть официальный Desktop и локальный веб-интерфейс, который открывается в браузере.

Название Harness можно перевести как «обвязка». Модель составляет ответы и выбирает дальнейшие действия, а среда предоставляет ей рабочее окружение. Поэтому установка DSH сама по себе не устанавливает на компьютер веса нейросети и не делает работу полностью автономной от интернета. Для облачной модели всё равно требуется соединение с её сервисом.

Обычный чат DeepSeek удобен, когда нужно задать вопрос, обсудить идею или получить текст. В Harness задача может завершиться изменением файлов в выбранной папке или запуском команды. Например, чат объяснит, как проверить программу; агент при наличии инструментов и разрешений сможет открыть её исходники, предложить исправление и выполнить проверку. Общее знакомство с чат-сервисом есть в карточке DeepSeek, но возможности приложения DSH зависят ещё и от подключённых плагинов.

Сейчас продукт находится в предварительном публичном доступе. Репозиторий предупреждает об изменениях, которые могут нарушить совместимость. В npm версия по умолчанию — 0.2.0-rc.2, а 0.2.1-alpha.1 относится к отдельному экспериментальному каналу. Обозначения rc и alpha не являются маркировкой стабильного релиза.

Где скачать официальный DeepSeek Harness

Начинать стоит с страницы Harness на сайте DeepSeek. В меню загрузки доступны установщик для Windows 64-bit и образ для macOS на Apple silicon, то есть компьютеров Mac с чипами Apple. Ссылки ведут на домен download.deepseek.com. Это самый короткий путь к официальному настольному приложению.

Для Intel Mac отдельной кнопки в меню нет, но официальный установщик macOS x64 существует: ссылка приведена в README настольного приложения. Для Linux официальный Desktop не заявлен как поддерживаемая цель релиза; Web UI остаётся отдельным способом запуска среды.

Официальный GitHub — deepseek-ai/deepseek-harness, npm-пакет — @deepseek-ai/dsh. По этому названию встречаются и другие программы.

В частности, dsh-tauri/deepseek-harness-desktop — настольная обёртка сообщества. У неё свои сборки и версии, которые нельзя приписывать Desktop от DeepSeek. Пакет deepseek-harness на PyPI тоже относится к другому проекту, а официальный Python SDK среды называется deepseek-harness-sdk. Для установки официального приложения команда pip install deepseek-harness не подходит. Не стоит выбирать сторонний сайт только потому, что в его названии есть DeepSeek и слово official.

Как установить и запустить Harness

Официальный Desktop

Desktop подходит тем, кто хочет начать с обычного приложения. Скачайте файл для своей системы с официальной страницы, установите его и откройте программу. В настольном варианте среда выполнения уже входит в приложение: для первого знакомства не нужно отдельно собирать репозиторий через Node.js и pnpm.

На стартовом экране выберите Sign in для входа в DeepSeek либо Add API Key для ключа DeepSeek API. Других провайдеров подключают в Settings → Models. API — программный способ обращаться к модели: запросы отправляет Harness. Затем пройдите начальную настройку и выберите рабочую папку.

Для первой сессии положите копии нескольких несекретных файлов в отдельную папку. Не начинайте с домашнего каталога или рабочего диска компании. Проверьте режим доступа к файлам и команды, которые агенту разрешено выполнять.

Локальный Web UI

Web UI пригодится для запуска из терминала или работы в Linux. По официальному README сначала нужно установить Node.js, затем выполнить:

npx @deepseek-ai/dsh web

В корневом package.json проекта указаны Node.js 22.19.0 и выше в ветке 22 либо 24.0.0 и новее. Команда npx загружает и запускает npm-пакет; это запуск программы, а не переход на облачный сайт.

При локальном старте DSH по умолчанию открывает браузер с адресом http://127.0.0.1:3080. Сервер продолжает работать в процессе dsh. Если браузер не открылся, используйте адрес, который напечатан в терминале. Для запуска без автоматического открытия есть параметр --no-open. Не открывайте этот локальный сервер в интернет ради доступа с телефона без отдельной настройки защиты.

В руководстве первого запуска путь через API описан так: открыть Settings → Models, указать ключ DeepSeek API и сохранить настройки. Ключ открывает доступ к расходованию средств. Вводите его только в настройки доверенного приложения, не в запрос или публичный файл.

Затем нажмите Choose workspace, добавьте папку проекта и выберите её. Свежий Web UI не считает рабочую папку выбранной автоматически: до выбора поле отправки задания недоступно. По умолчанию процесс dsh использует каталог, из которого его запустили, поэтому удобно сначала перейти в подготовленную тестовую папку.

Если запуск не удался, проверьте три вещи: подходящую версию Node, работающий процесс dsh и подключённую модель. Ошибка авторизации или отсутствие средств у провайдера не исправляется переустановкой интерфейса. Для корпоративной сети есть отдельное руководство по прокси.

С какой задачи начать

Для знакомства подойдёт маленькая таблица, где результат можно проверить вручную. Создайте в тестовой папке sales.csv с колонками «товар» и «выручка» и тремя строками: клавиатура — 10 000, мышь — 3 000, монитор — 20 000. Рядом положите notes.txt с примечанием: суммы указаны в рублях, возвратов нет.

Первое задание можно сформулировать так:

Прочитай sales.csv и notes.txt в выбранной папке. Ничего не изменяй и не устанавливай. Посчитай общую выручку, назови товар с наибольшей выручкой и перечисли файлы, на которые опирается ответ. Если данных не хватает, задай вопрос.

Для этого набора правильная сумма — 33 000 рублей, а наибольшая выручка относится к монитору. Сверьте ответ с исходной таблицей и посмотрите журнал действий. Агенту не требуется ни искать данные в интернете, ни скачивать дополнительную программу. Если он предлагает лишние действия, задачу лучше остановить и уточнить.

Когда чтение прошло нормально, можно отдельно разрешить создание summary.md с итогом и перечислением источников. Исходные файлы должны остаться прежними. Для контроля используйте реальный режим разрешений: фраза «ничего не изменяй» в запросе сама по себе не изолирует файловую систему.

В задаче с кодом результат нужно проверять по изменению конкретного файла и относящемуся к нему тесту. Чёткий критерий завершения помогает заметить лишние действия или недоделанную работу.

Как плагины меняют возможности агента

В основе Harness лежит Cordis с принципом «всё является плагином». Плагины добавляют функции и подключают их к общей среде. Cordis управляет их зависимостями и жизненным циклом, чтобы разные части приложения можно было менять и собирать в нужную конфигурацию.

Один набор расширений нужен для терминала и работы с кодом, другой — для документов или внешних сервисов. Прежде чем поручать задачу, посмотрите, какие инструменты доступны в текущей конфигурации.

Официальная продуктовая страница показывает работу с документами, таблицами и кодом, создание плагинов через Creator mode и задания по расписанию. В её списке расширений команды агентов, автоматическая проверка одобрений, расписание и голосовой ввод помечены как экспериментальные.

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

Бесплатен ли Harness и сколько стоят модели

Исходный код Harness распространяется по лицензии MIT. За право пользоваться самой открытой программой не требуется покупать подписку. Но модельный сервис оплачивается отдельно, и способ оплаты зависит от подключения.

Условия Harness разделяют два режима. В официальном пользователь входит в единую учётную запись DeepSeek и использует предоплаченный баланс модельного сервиса. Во втором самостоятельно подключает API выбранного провайдера; обслуживание модели и расчёты идут по правилам её провайдера. Бесплатный чат не даёт неограниченных вызовов модели в агенте.

Harness поддерживает провайдеров и пользовательские подключения по протоколам OpenAI Chat Completions, OpenAI Responses и Anthropic Messages. Совместимость с API означает подходящий формат запросов, а не возможность автоматически перенести любую чат-подписку в Harness. Например, OAuth-подключение Codex в руководстве по моделям пока не поддерживается.

При собственном DeepSeek API действуют тарифы API. Для deepseek-flash, которому соответствует DeepSeek-V4.1-Flash, миллион входных токенов без попадания в кэш стоит $0,15 вне пиковых часов и $0,30 в пиковые; миллион выходных — $0,60 и $1,20 соответственно. Вход из кэша дешевле: $0,003 и $0,006 за миллион токенов. Токен — небольшой фрагмент текста, поэтому он не равен одной странице или одному слову.

Пиковые интервалы — 01:00–04:00 и 06:00–10:00 UTC с понедельника по пятницу, кроме государственных праздников Китая. В остальное время, включая выходные, действует непиковая цена. Эти ставки относятся к API; отдельный баланс официального режима Harness нужно смотреть в самом приложении.

У агента одна задача может потребовать несколько запросов: прочитать файл, построить план, вызвать инструмент, разобрать его ответ и исправить результат. Повторно передаваемый контекст тоже влияет на расход. Поэтому стоимость зависит от выбранной модели, объёма материалов и числа шагов, а не только от длины последнего ответа. Начинать разумно с небольшого бюджета и коротких задач, просматривая учёт расхода у провайдера.

Какие файлы и данные получает Harness

Рабочая папка не заменяет политику разрешений. В документации пресетов Workspace write сочетает запись в рабочее окружение с политикой запросов одобрения, а Danger full access допускает полный доступ без таких вопросов. Workspace write не означает, что агент может читать только выбранную папку. Запись внутри разрешённой области не обязательно требует отдельного подтверждения. Выбирайте режим осознанно и просматривайте действия агента.

В официальном предупреждении о безопасности прямо сказано, что продукт экспериментальный и не прошёл аудит безопасности. Он может выполнять сгенерированные моделью команды, загружать сторонние плагины и обращаться к доступным процессам, файлам, сети и учётным данным. Ошибка команды или вредоносная инструкция в прочитанном материале может привести к повреждению файлов или утечке.

Для знакомства лучше использовать отдельное окружение: виртуальную машину, контейнер или выделенный компьютер. Если запускаете приложение на основной машине, выделите тестовую папку, проверьте разрешения, сохраните резервные копии и не добавляйте секретные данные. Песочница и подтверждения уменьшают риск, но не гарантируют защиту ресурсов, которые вы сами разрешили агенту использовать.

Локальное приложение также не означает, что содержимое задач всегда остаётся на компьютере. Политика конфиденциальности Harness от 20 сентября 2026 различает режимы работы. В официальном сервисе DeepSeek описывает сбор сообщений, файлов, истории действий агента, вызовов инструментов и настроек плагинов. При собственном API вход и выход передаются напрямую выбранному провайдеру; политика говорит, что сервер Harness их не хранит. Регистрация DeepSeek для этого режима не требуется. У самого провайдера действуют собственные правила обработки данных.

Есть и конкретная настройка журналирования. В поставляемых профилях плагин session-log-deepseek по умолчанию включён: он прикрепляет журнал сессии к запросам официального DeepSeek API, в том числе при использовании собственного ключа DeepSeek. В Settings → General находится переключатель Upload Session Log when using the official model API. Отключение действует со следующего запроса; при повторном включении могут отправиться накопленные события. Этот переключатель не отменяет передачу модельного запроса, списка активных плагинов и другую телеметрию. Отдельная аналитика взаимодействий Desktop включена по умолчанию; обычный Web её не отправляет.

Перед работой с материалами клиента или внутренними документами компании проверьте не только права приложения, но и допустимость отправки данных выбранному модельному сервису. Для чувствительных файлов удобство локального интерфейса не является достаточным основанием для загрузки их в облачную модель.

Выбор между Harness и другими агентами

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

OpenCode стоит рассмотреть, когда основной предмет работы — программный проект: разобраться в коде, спланировать исправление, внести его и запустить проверки. В нашем разборе OpenCode разобраны режимы Plan и Build, подключение моделей и права инструментов.

Hermes Agent интересен для длительной работы с памятью, навыками и повторяющимися поручениями, в том числе через поддерживаемые мессенджеры. Подробности есть в разборе Hermes Agent.

Для обычного вопроса, перевода или обсуждения текста достаточно чата. Устанавливать локальную среду полезно тогда, когда нужен результат в файлах или последовательность действий с инструментами. Во всех случаях качество зависит от модели и постановки задачи, а безопасность — ещё и от того, что программе разрешено делать.

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

Harness полезен пользователю, который готов выделить рабочую папку, настроить модель и проверять действия агента. Официальный Desktop сокращает путь к началу работы, а Web UI даёт альтернативу для тех, кто предпочитает запуск из терминала.

Начните с копий простых файлов, одного понятного задания и ограниченного доступа. После понятного результата можно постепенно усложнять работу. Для важных проектов остаются необходимыми резервные копии, контроль изменений и проверка результата человеком.

Официальные источники

DeepSeek Harness и официальные загрузки

Репозиторий и команда запуска

Настольное приложение и сборки для macOS и Windows

Первый запуск Web UI

Подключение моделей

Тарифы DeepSeek API

Условия использования Harness

Политика конфиденциальности Harness

Предупреждение о безопасности

Права и режимы одобрения

Передача журнала сессии

Список активных плагинов в запросах

Аналитика Desktop

Официальный Python SDK