Как использовать DeepSeek Harness? Установка и развёртывание dsh, архитектура плагинов Agent Harness, рабочий процесс AI Coding и практическое сравнение с Claude Code/Codex

На 21 сентября 2026 года DeepSeek Harness официально обозначен как developer preview, а не как стабильная производственная платформа; это подтверждается официальным репозиторием DeepSeek Harness. Поэтому на вопрос «как использовать DeepSeek Harness» ответ зависит от вашей цели: для исследования Agent Runtime, собственных инструментов и самохостинга его стоит запускать уже сейчас, а для стабильной ежедневной разработки — сохранить текущий Agent и провести ограниченное двутрековое испытание.

Кому подходит этот материал: техническим руководителям, которые выбирают удалённую среду разработки, а также разработчикам, тестирующим открытый Agent Harness. Особенно внимательно изучите разделы о правах, удалённом доступе, плагинах и восстановлении сессий, если dsh планируется запускать не на рабочем ноутбуке, а в облачной среде.

Последнее обновление: 21 сентября 2026 года. Факты сверены с официальным сайтом DeepSeek Harness, репозиторием GitHub, архитектурной документацией, руководством по провайдерам и описанием npm-пакета. Если официальный README, npm-документация и сторонний пример расходятся, приоритет у официальных материалов.

Начните с решения о миграции, а не с команды установки

У DeepSeek Harness есть три разумных сценария применения.

Немедленно пробуйте, если вы:

• исследуете модель «everything-is-a-plugin»;
• хотите заменить отдельные встроенные компоненты собственными;
• собираете самоуправляемую среду для инструментов, навыков и песочниц;
• готовы читать исходный код, проверять контракты и самостоятельно сопровождать обновления.

Запускайте двутрековое испытание, если вы:

• уже используете Claude Code или Codex в ежедневной работе;
• хотите проверить dsh на реальном исправлении ошибки, тестах и подготовке описания изменений;
• отвечаете за небольшую команду и не можете допустить остановку разработки;
• пока не знаете, как существующие навыки, разрешения и журналы перенесутся в новую архитектуру.

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

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

Проверьте установочную цепочку dsh до подключения репозитория

В официальных материалах предусмотрены два направления запуска: через npx и из исходного кода. Документация npm по npx объясняет общий принцип временного запуска пакетов, а официальная страница Node.js нужна для проверки установленной среды. Не подставляйте версию Node.js из случайного блога: перед запуском сверяйте требования текущего README и npm-описания.

Рабочая последовательность выглядит так:

1. Создайте отдельный каталог. Не запускайте preview-рантайм из домашней директории с личными ключами и не смешивайте его данные с существующей конфигурацией других Agent-инструментов.
2. Проверьте Node.js и npm. Выполните локальные команды проверки версий, затем сравните результат с актуальными требованиями официального репозитория. Если Node.js установлен через менеджер версий, зафиксируйте выбранное окружение, чтобы разные пользователи не запускали разные зависимости.
3. Выберите путь запуска. Для первичной проверки используйте команду npx, приведённую в официальном README. Для разработки самого Harness или изменения плагинов клонируйте репозиторий, установите зависимости и выполните команды сборки, указанные там же. Не переносите команду из старой статьи без повторной проверки.
4. Определите каталог данных. До первого запуска выясните, где будут находиться конфигурация, сессии, кэш, журналы и результаты работы. Если путь не зафиксировать, очистка временных файлов или смена пользователя может выглядеть как потеря истории.
5. Проверьте Web UI локально. Убедитесь, что интерфейс слушает только ожидаемый локальный адрес, если удалённый доступ ещё не настроен. Запишите адрес и порт в журнал развёртывания, но не публикуйте их в открытой сети без аутентификации и сетевого фильтра.
6. Настройте провайдера модели. Официальное руководство по провайдерам DeepSeek Harness нужно использовать для названия переменных, формата конфигурации и допустимых способов передачи ключей. Секреты не следует помещать в репозиторий или в команду, попадающую в историю оболочки.
7. Запустите минимальный сценарий. Сначала попросите систему прочитать небольшой тестовый файл и вернуть структурированный результат. Только после этого добавляйте редактирование файлов, Shell, сетевые инструменты и дочерние процессы.
8. Проверьте удалённый доступ. При запуске на сервере подключайтесь через SSH-туннель, а не через открытый порт Web UI. Руководство OpenSSH описывает параметры, которые позволяют перенаправить локальный порт к процессу на удалённой машине без публикации интерфейса для всего интернета.
9. Зафиксируйте права. Процесс dsh должен работать под отдельным непривилегированным пользователем. Отдельно проверьте права на исходный код, каталог сессий, ключи провайдера, журналы и временные файлы.
10. Сохраните воспроизводимый журнал. Запишите дату проверки, commit исходников или версию пакета, способ запуска, провайдера, включённые плагины и результат тестового запроса. Для preview-системы это важнее красивого первого запуска: иначе при следующем обновлении вы не поймёте, что именно изменилось.

Локальный запуск и удалённая эксплуатация — не одно и то же. На ноутбуке достаточно проверить процесс, каталог и Web UI. В облачной среде добавляются SSH, постоянное хранилище, управление пользователями, резервное копирование, ротация журналов и восстановление после перезапуска. Если вам нужна готовая удалённая машина для временного эксперимента, предварительно изучите варианты аренды Mac mini для удалённой разработки, но не смешивайте наличие вычислительной среды с готовой безопасной конфигурацией Agent.

Разберите плагинную модель по слоям

DeepSeek Harness интересен не тем, что добавляет ещё один чат для работы с кодом, а тем, что рассматривает основные части рантайма как плагины. В документации по основным подсистемам эта логика разделяет модель, инструменты, навыки, сессии, песочницу, хранилище, циклы выполнения и UI.

Для вас это означает следующее:

• Модель отвечает за запросы и ответы провайдера, но не должна автоматически получать права на файловую систему.
• Инструменты описывают конкретные действия: чтение, редактирование, поиск, выполнение команд или обращение к внешнему сервису.
• Навыки собирают повторяемые инструкции и процедуры, например проверку миграций или подготовку release notes.
• Сессия хранит контекст текущей работы и определяет, что именно должен видеть следующий шаг.
• Песочница ограничивает файловую систему, команды, сеть и доступ к секретам.
• Хранилище отвечает за сохранность состояния, журналов и промежуточных результатов.
• Цикл координирует последовательность действий, включая повторную проверку и остановку при ошибке.
• UI предоставляет интерфейс, но не должен быть единственным уровнем защиты.

Такой подход полезен, когда вам нужно заменить один компонент без переписывания остальных. Например, собственный инструмент поиска по монорепозиторию можно подключить к стандартному циклу, а отдельный провайдер модели — заменить без изменения интерфейса. Обратная сторона — каждый контракт становится частью сопровождения. Обновление preview-компонента может изменить ожидаемые параметры, порядок вызова или формат результата.

Проверяйте режимы не по названию, а по задаче:

• Minimal подходит для первого запуска, диагностики провайдера и проверки базового цикла;
• Standard — для сценария, где нужны типовые инструменты и более полный набор подсистем;
• Code — для задач чтения и изменения проекта, запуска тестов и подготовки результата;
• Creator — для разработки и проверки собственных плагинов.

Эти режимы не следует воспринимать как независимые продукты или готовые уровни надёжности. Перед выбором прочитайте актуальное описание в официальном репозитории, потому что состав и границы режимов могут меняться вместе с developer preview.

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

Сопоставьте варианты до подключения команды

Ниже — не рейтинг производительности. Это матрица выбора по тем измерениям, которые можно проверить без неподтверждённых обещаний.

Сравнивайте не скорость ответа, которую легко исказить моделью, промптом и размером проекта, а состав проверяемого результата: изменился ли только разрешённый файл, прошли ли тесты, сохранился ли журнал, можно ли повторить сессию и понятно ли команде, почему Agent выполнил конкретную команду.

Для облачной среды полезно отдельно изучить условия аренды и состав удалённой конфигурации Mac. Это не заменяет настройку песочницы dsh, но помогает отделить стоимость вычислительной среды от затрат на сопровождение Agent, хранилище, доступы и резервные копии.

Проведите AI Coding-тест на одном репозитории

Хороший AI Coding workflow для Harness не начинается с просьбы «исправь всё». Разделите проверку на небольшие этапы:

1. Создайте отдельную ветку и сохраните исходное состояние рабочего дерева.
2. Попросите Agent прочитать структуру проекта и назвать файлы, которые он собирается использовать.
3. Разрешите только чтение и поиск, пока план не будет проверен человеком.
4. Включите редактирование конкретных файлов, ограничив рабочий каталог песочницей.
5. Запустите существующий тестовый набор без разрешения на удаление артефактов или изменение секретов.
6. Попросите объяснить каждое изменение и сопоставьте описание с фактическим diff.
7. Сохраните журнал сессии, команду запуска, конфигурацию инструментов и результат тестов.
8. Повторите тот же тикет в текущем Agent-компаньоне, не меняя критерии приёмки.
9. Сравните не только итоговый код, но и количество ручных вмешательств, понятность разрешений и возможность восстановить сессию.
10. Удалите тестовую конфигурацию и временные ключи после завершения проверки.

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

Описание инструментальной подсистемы Harness стоит использовать как карту возможностей, а не как разрешение включить всё сразу. Каждое дополнительное действие увеличивает поверхность риска. Для команды это также означает новые правила ревью: нужно проверять не только diff, но и список доступных инструментов, права процесса и содержимое журналов.

Не называйте результат такого эксперимента «официальной производительностью». Сообщество может публиковать удачные или неудачные примеры, однако они зависят от модели, промпта, репозитория, тестов и конфигурации. В этой статье нет основания ранжировать Harness, Claude Code и Codex по скорости или качеству.

Отдельно измерьте изоляцию и стоимость сопровождения

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

Перед передачей среды другому разработчику отметьте:

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

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

Закройте двутрековую проверку чек-листом

• [ ] Зафиксирована дата, commit или версия пакета, на которой проходил тест.
• [ ] Проверены Node.js, npm, команда npx и путь сборки из исходников.
• [ ] Web UI протестирован локально до удалённого доступа.
• [ ] Каталог проекта, состояние сессий и журналы разделены.
• [ ] Провайдер модели настроен по официальной документации.
• [ ] Секреты не попали в репозиторий, историю оболочки и журналы.
• [ ] Тест выполнен в отдельной ветке с сохранённым исходным состоянием.
• [ ] Сначала проверены чтение и поиск, затем отдельно включены редактирование и Shell.
• [ ] Песочница ограничивает рабочий каталог и сетевые операции.
• [ ] Тот же сценарий выполнен в текущем Agent для контрольного сравнения.
• [ ] Сравнены diff, тесты, журналы, ручные подтверждения и восстановление сессии.
• [ ] Команда назначила владельца обновлений и отката плагинов.
• [ ] Решение о миграции принято только после проверки реального репозитория.

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

Ответьте на частые вопросы перед развёртыванием

Как установить dsh и открыть Web UI?

Начните с официального README и проверьте Node.js, npm и каталог запуска. Для первого теста используйте путь через npx, а для разработки плагинов — сборку из исходников. После запуска определите адрес Web UI, каталог состояния и пользователя процесса. Удалённый доступ организуйте через SSH-туннель; открывать интерфейс в интернет без сетевой защиты не следует.

Из чего состоит плагинная архитектура DeepSeek Harness?

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

Можно ли заменить Claude Code или Codex?

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

Как настроить модель, инструменты и песочницу?

Сначала настройте провайдера по официальному руководству, затем включите минимальный набор инструментов. Разделяйте права на чтение, редактирование, Shell и сеть, а конфигурацию храните отдельно от исходного кода. После каждого расширения запускайте тестовый сценарий и проверяйте журнал. Такой порядок помогает понять, какой именно компонент изменил поведение Agent и не создал ли он лишний доступ.

Как развернуть Harness в удалённой облачной среде?

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

Выберите среду, не смешивая эксперимент с производством

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

Если вам нужно временно проверить DeepSeek Harness, сравнить его с Claude Code или Codex и не менять основной ноутбук, аренда Mac через ZavCloud может быть практичнее покупки оборудования: вы получаете отдельную среду для двутрекового теста без обязательства сразу строить постоянную инфраструктуру. Сначала сверяйте результаты чек-листа и требования к изоляции, а уже затем решайте, оставлять ли dsh в долгосрочном контуре.