DeepSeek Harness: как запустить Developer Preview и выбрать режим работы
Что такое официальный DeepSeek Harness, как безопасно запустить его в тестовой папке, чем отличаются четыре режима и что проверить после первого запуска.
Коротко: DeepSeek Harness — это не очередной чат с режимом «агент», а открытая среда, в которой сам агент собирается из заменяемых частей: модели, инструментов, навыков, сессии, sandbox, хранилища, цикла работы и интерфейса. DeepSeek называет проект Developer Preview: начинать стоит не с рабочего репозитория и не с поиска «лучшего» плагина, а с изолированной папки, стандартного режима и одной проверяемой задачи.
Это важно, потому что слово harness часто используют слишком широко. В официальном описании DeepSeek Harness формула проще: Agent = Model + Harness. Модель отвечает за рассуждение и генерацию, а harness даёт ей контекст среды, доступ к инструментам и цикл, в котором работа продолжается после одного ответа. Если в задаче агент открыл не тот файл, не увидел вывод команды или применил правку не там, причина может быть не только в модели, но и в настройках этой среды.
Если вы собираетесь подключать к agent runtime модель через пользовательский API endpoint, до установки плагинов отдельно проверьте протокол, Base URL и способ аутентификации. BetterToken.ai предоставляет OpenAI-compatible и Anthropic-compatible интерфейсы для инструментов с пользовательским Base URL; это не означает совместимость с каждым плагином Harness. Сначала сверьте схему конкретного провайдера и настройку API Key в документации BetterToken, а затем выполните минимальную read-only задачу в тестовой папке.
Что именно открыла DeepSeek
DeepSeek выпустила Harness как открытый проект под лицензией MIT и прямо помечает его как Developer Preview. Его базовый механизм — Cordis: ядро загружает и выгружает плагины, управляет зависимостями, но не содержит «магических» агентных способностей само по себе.
Способности появляются из плагинов. В официальном списке указаны модель, tools, skills, сессия, sandbox, storage, agent loop, планирование, UI и другие части. Их можно выбирать, заменять и расширять в конфигурации, не меняя исходный код Harness. Это полезно не потому, что любой плагин автоматически улучшит результат, а потому, что вы можете изолировать изменение: например, отдельно проверить модель, инструменты или способ ведения сессии.
У такого подхода есть практическое следствие: Harness подходит разработчику, который хочет наблюдать и менять устройство агента. Если вам нужен лишь готовый coding-чат, сначала убедитесь, что эта дополнительная гибкость действительно окупает время на настройку.
Быстрый старт: первый запуск без риска для рабочего проекта
Официальная страница предлагает после установки Node.js запустить Web UI одной командой:
Полную инструкцию и вариант установки из исходников DeepSeek поддерживает в документации Harness и репозитории проекта. Перед запуском проверьте версию Node.js по требованиям именно этой документации: Developer Preview меняется быстрее, чем случайный гайд в поиске.
Для первого сеанса я бы использовал такой порядок:
- Создайте пустую тестовую папку или клон репозитория без секретов и без незакоммиченных рабочих изменений.
- Запустите Web UI командой выше и выберите стандартный режим.
- Дайте агенту маленькую read-only задачу: объяснить структуру проекта, найти точку входа или составить план изменения — без записи файлов и запуска миграций.
- Сверьте ответ с файлами вручную, затем посмотрите журнал выполнения и только после этого разрешайте правки.
Первые и четвёртый пункты — не обещание особой защиты со стороны Harness, а обычная инженерная дисциплина для любого агента с доступом к shell и файловой системе. Она позволяет отделить проблему конфигурации от риска для репозитория.
Как выбрать один из четырёх режимов
Не включайте самый сложный режим «на всякий случай». Официальная страница описывает четыре режима с разными целями.
Для первой реальной задачи берите Standard. Он показывает, как выглядит полный цикл агента, но не требует сразу разбираться в кодовой оркестрации или писать собственный preset.
PTC имеет смысл только тогда, когда вам нужна именно композиция нескольких инструментальных шагов. В этом режиме модель использует Code Mode SDK и формирует TypeScript-программу для цепочки вызовов. Это не гарантия более качественного результата: ценность режима в том, что логику последовательности можно прочитать, проверить и воспроизвести.
Minimal — не «облегчённый Standard для повседневной работы». DeepSeek описывает его как двухинструментального coding-агента для минимальной среды и benchmark-сценариев. Он помогает понять, какую роль в результате сыграли дополнительные skills, поиск, UI и orchestration.
Creation нужен для разработки собственной сборки. Это место для экспериментов с Cordis и preset, а не обязательный шаг после установки.
Зачем нужен Trajectory и как по нему проверять агента
DeepSeek пишет, что модельный контекст и ход запуска попадают в append-only журнал сессии: системный prompt, вызовы tools и результаты, расписание subagents, инъекции контекста и другие события. В Trajectory их можно смотреть по источнику; восстановление, ветвление, поиск и replay используют тот же поток событий.
Не воспринимайте этот журнал как декоративную «историю чата». После первого задания он отвечает на вполне конкретные вопросы:
- Какие файлы и команды агент действительно увидел, а какие лишь предположил?
- Где появился лишний контекст или неожиданный вызов инструмента?
- Почему агент остановился: не хватило инструмента, доступа, инструкции или контекста?
- Можно ли воспроизвести удачную траекторию без повторного запуска с нуля?
Практический мини-тест: попросите агент найти место, где формируется конфигурация, но запретите менять файлы. Затем сопоставьте его вывод с Trajectory. Если путь к файлу, команда и вывод команды совпадают с реальностью, можно усложнять задачу. Если нет — не пытайтесь лечить это новым prompt: сначала выясните, был ли у агента доступ к нужному инструменту и корректный контекст.
Плагины: где гибкость превращается в ответственность
Главное достоинство Harness — возможность собрать runtime под задачу. Но плагин — не галочка в интерфейсе, а код и набор возможностей, которые влияют на данные, инструменты и поведение агента.
Перед добавлением плагина ответьте на три вопроса:
- Какую конкретную нехватку он устраняет: поиск по репозиторию, sandbox, планирование, UI или другое?
- Какие разрешения, данные и внешние сервисы он затрагивает?
- Как вы заметите регрессию и как вернётесь к предыдущей конфигурации?
Для исследований плагинов DeepSeek указывает тему сообщества DSH Plugin. Начните с чтения исходного кода и зависимостей, а не с установки целой подборки. В Developer Preview особенно полезно менять за раз только один компонент: тогда журнал даёт шанс понять, что именно изменило поведение.
Когда Harness уже полезен, а когда лучше отложить
Попробуйте Harness сейчас, если вы хотите:
- проверить влияние инструментов и контекста отдельно от модели;
- отладить многошаговый агентный процесс по журналу событий;
- собрать воспроизводимый тестовый preset;
- экспериментировать с модульной агентной средой, понимая, что это Developer Preview.
Отложите внедрение в рабочий поток, если вам нужен только быстрый ответ в IDE, у вас нет тестовой среды или вы пока не готовы проверять действия агента по логам и diff. В таком случае стандартный CLI или IDE-агент с понятным набором инструментов обычно даст более короткий путь к результату.
Итог: начните с наблюдаемости, а не с кастомизации
DeepSeek Harness ценен не числом переключателей, а тем, что делает состав агента и его траекторию предметом инженерной проверки. Первая цель — не создать идеальный preset, а получить один прозрачный запуск: Standard mode, тестовая папка, маленькая read-only задача и сверка с Trajectory. После этого уже можно обоснованно решать, нужны ли PTC, Minimal, собственные плагины или Creation.
Перед использованием в проекте с реальными данными ещё раз проверьте статус Developer Preview, требования к установке и актуальные ограничения в официальной документации DeepSeek Harness. Внешние плагины и команды shell не становятся безопасными автоматически только потому, что они запущены через Harness.