DeepSeek Harness (DSH) - это просто оболочка: она даёт модели инструменты, а модель вы подключаете отдельно. Начать можно с npx @deepseek-ai/dsh web в отдельной среде без рабочих секретов. Первая задача - собрать таблицу из тестовых заметок и руками сверить файл. Производитель предупреждает: проект экспериментальный, изоляция не гарантирована.
До запуска разберитесь, к чему у агента будет доступ: он сможет выполнять команды и менять доступные ему файлы.
Начните со страницы DeepSeek Harness и репозитория DeepSeek. Нужно руководить агентом, быть спереди агента, а не за агентом.
Это просто оболочка. А модель тогда где?
Модель по факту получает нашу задачу. Дальше понимает, какие инструменты ей задействовать и какой навык применить. Схема такая: задача → модель → инструменты оболочки → результат.
В DSH агент может читать и менять файлы, выполнять команды, поручать работу другим агентам и вести план. В нашей пробе ему нужно прочитать заметки и записать таблицу в отдельный файл.
Если с агентами пока не работали, разницу между ответом в чате и действием через инструменты я разбираю в отдельной статье.
DSH построен на Cordis. Плагины добавляют инструменты и расширяют интерфейс, а Creator mode позволяет создавать плагины через чат. Для тестового файла дополнительные расширения не нужны.
Поддерживаются и другие провайдеры: anthropic, openai, moonshotai, zai. Перед подключением проверьте доступность сервиса для вашего аккаунта и условия оплаты, затем оцените качество на своей задаче.
Разборы задач, инструментов и проверки ИИ-агентов я выкладываю в канале:
Какие права давать агенту, чтобы не отдать рабочие секреты?
До запуска подготовьте одноразовую виртуальную машину, контейнер или отдельную среду с минимальными правами. Это рекомендация DeepSeek из SAFETY.md. Не подключайте рабочие диски, домашний каталог и рабочие учётные данные. Сохраните резервную копию доступных процессу файлов.
Пустой тестовой папки недостаточно. Если процессу доступны домашний каталог или рабочая сеть, выбор другой папки в интерфейсе этот доступ не закрывает.
Для пробы ограничьте доступы по таблице. Это ограничения, которые нужно задать самим, а не готовый режим DSH.
| Объект | Что разрешаем | Что не даём | Как проверяем |
|---|---|---|---|
| Файлы | Читать тестовые заметки, создать таблицу | Рабочие документы, домашний каталог, секреты | До запуска смотрим подключённые каталоги, после - изменения в тестовой папке |
| Команды | Только необходимые команды, которые заранее просмотрели | Изменять основную машину, использовать её учётные данные | Читаем команды до согласия, после смотрим записи действий |
| Сеть | Подключение модели к её сервису | Рабочие сервисы, посторонние подключения | Проверяем, какие подключения доступны среде |
| Плагины и MCP | Только необходимые компоненты запуска | Непроверенные расширения | Смотрим, какие расширения подключены |
В предупреждении DeepSeek прямо сказано: проект может обращаться к предоставленным ему сети, процессам, учётным данным и файлам. Песочницы, запросы согласия и ограничения прав уменьшают риск, но не гарантируют изоляцию.
Просмотрите настройки, расширения и предлагаемые команды до согласия на выполнение. Будет ли запрос согласия, зависит от действующих правил разрешений: вопрос перед каждым действием не обещан.
Если не понимаете, к чему у процесса есть доступ, остановитесь до запуска. Просьба агенту быть аккуратным эту подготовку не заменяет.
Как запустить интерфейс, подключить модель и выбрать папку?
Источники инструкции проверены 05.11.2026. Порядок такой: запустить DSH через npm, открыть интерфейс в браузере и подключить модель своим DeepSeek API-ключом. Команды выполняйте в подготовленной отдельной среде.
Сверьте требования Node.js для выбранной сборки. В исходниках ветки master на эту дату указаны версия 0.2.2-rc.1 и engines.node: >=24.9.0. Команда npx без закреплённой версии может получить другую сборку из npm. Требования к ней проверяйте отдельно.
Запишите установленную у вас версию. Если возникнет ошибка, сможете сверить её с требованиями и инструкцией для этой сборки.
Шаг 1. Запустите интерфейс из тестовой папки
Установите Node.js по требованиям выбранной сборки. Создайте отдельную папку для пробы внутри подготовленной среды, перейдите в неё и выполните:
npx @deepseek-ai/dsh webПо README адрес по умолчанию - http://127.0.0.1:3080. При локальном запуске открывается браузер, при SSH команда выводит адрес сервера. Смотрите адрес в выводе вашей команды: при SSH он относится к удалённой машине. Не выставляйте интерфейс публично ради первой пробы.
Проверка шага: сервер сообщил адрес, интерфейс доступен.
Команда запускает профиль Web. Ещё есть headless, sdk, sdk-minimal и acp; для этой пробы оставьте Web. Профиль определяет, какие компоненты запускаются, но не изолирует процесс. Creator mode нужен для создания расширений, здесь его не используем.
Шаг 2. Подключите модель своим ключом
Получите свой DeepSeek API-ключ на platform.deepseek.com. Откройте Settings → Models, введите ключ и сохраните. Затем выберите настроенную модель в списке model picker. Перезапуск сервера не требуется.
Для другого поддерживаемого провайдера: Add model provider → встроенный провайдер → свои официальные учётные данные → сохранение → model picker. Дальше задача и проверка файла остаются теми же.
Для выбора между инструментами есть отдельное сравнение DeepSeek и Claude Code; здесь продолжаем настройку оболочки DSH.
Проверка шага: нужная модель выбрана. Соединение проверим при отправке тестовой задачи, когда выберем папку и разберёмся с разрешениями. Цену и условия доступа проверьте на платформе выбранного сервиса.
Шаг 3. Выберите рабочую папку в интерфейсе
Нажмите Choose workspace, добавьте отдельную тестовую папку и выберите её. Каталог запуска dsh используется для работы с файлами по умолчанию, но в новом интерфейсе рабочая папка ещё не выбрана.
До выбора workspace поле отправки недоступно. Проверьте папку в интерфейсе, даже если запустили команду из нужного места.
Проверка шага: выбрана тестовая папка, поле отправки доступно. В этой папке создавайте файл с заметками и ищите таблицу.
Шаг 4. Проверьте разрешения перед отправкой
Сверьте доступы процесса с таблицей: подключённые каталоги, доступные учётные данные, сетевые подключения и расширения. Ему должны быть доступны только ресурсы для пробы.
Проверка шага: вы просмотрели разрешения и понимаете, к чему у процесса есть доступ. Если подтвердить это не получается, задачу не отправляйте.
Какую первую задачу дать: входной файл → понятный результат
Возьмите задачу, результат которой можно целиком сверить руками. Подойдёт таблица из заметок: каждую строку можно сравнить с исходником. Рабочий проект, новые подключения и расширения для этого не нужны.
Создайте в выбранной тестовой папке start-notes.txt:
Команда запуска: npx @deepseek-ai/dsh web
Подключение модели: Settings → Models → API-ключ → сохранить
Рабочая папка: Choose workspace → добавить каталог → выбрать каталогКлючей и рабочих документов в файле быть не должно. Откройте его сами и проверьте, что сохранили в выбранной папке. С ним будете сравнивать таблицу.
Шаг 5. Отправьте задачу и откройте созданный файл
Начните сессию и отправьте запрос:
Прочитай только start-notes.txt в выбранной рабочей папке. Создай рядом launch-check.md с таблицей из 2 колонок: «Действие» и «Что сделать». Для каждой строки исходного файла перенеси текст до двоеточия в первую колонку, после двоеточия - во вторую. Сохрани команду и названия кнопок без изменений. Не добавляй пояснений или сведений от себя. Не обращайся к сети, не устанавливай программы и не меняй другие файлы. Если задача требует дополнительных разрешений, остановись и объясни, каких. В ответе укажи имя созданного файла и что изменено.Просьбы в запросе не ограничивают доступы процесса. Их нужно настроить в самой среде.
Ожидаемый результат в launch-check.md:
| Действие | Что сделать |
|---|---|
| Команда запуска | npx @deepseek-ai/dsh web |
| Подключение модели | Settings → Models → API-ключ → сохранить |
| Рабочая папка | Choose workspace → добавить каталог → выбрать каталог |
Найдите файл и откройте руками. Сверяйте его с start-notes.txt по строкам:
- «Команда запуска»: должна остаться вся команда
npx @deepseek-ai/dsh web, включаяwebв конце. Здесь агент переносит текст, запускать её повторно ему не поручали. - «Подключение модели»: Settings → Models → API-ключ → сохранить. Самого ключа в заметках нет, в таблице он тоже не нужен.
- «Рабочая папка»: Choose workspace → добавить каталог → выбрать каталог. Добавить папку и выбрать её - отдельные действия, ни одно не должно пропасть.
В результате должны быть только заданные колонки и строки, без пояснений от модели. Посмотрите, не изменилось ли что-то ещё в папке. Вызовы инструментов разберём отдельно.
Если агент попросил дополнительные права, прочитайте, для какой операции. Ему нужно только прочитать заметки и создать таблицу. Не увеличивайте доступы автоматически: сначала разберитесь, на чём он остановился.
Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
«Готово» - это ещё не проверка. Что смотреть после задачи?
Мы всегда должны в конце проверять его работу. Здесь таблицу можно сверить руками, другой агент не нужен.
Почему одного ответа агента недостаточно, я разбираю в отдельной статье.
Кстати, я снял полный гайд про инструменты и навыки первого агента в Hermes Agent, обязательно посмотрите.
В нём показал, какие права давать агенту, как не поставить вредный MCP и как проверять работу на разных моделях. Это видео про Hermes, не про установку DSH. Посмотрите, как выбирать инструменты и выстраивать проверку; дополнительные подключения для нашей пробы не нужны.
Теперь посмотрите записи своей сессии: что агент прочитал, какие инструменты вызвал, что передал им и какой ответ получил. На странице DSH показаны Developer tools - средства просмотра хода выполнения задачи: входные данные, инструменты, результаты и подробности вызовов.
В нашем запросе запрещена установка программ. Если в записях есть команда установки, одной правильной таблицы мало. Разберите, что выполнялось и почему агент вышел за условия задания.
Сообщение с именем файла не подтверждает, что файл создан. Неизменённые тестовые файлы не доказывают, что агент не обращался к сети или другим ресурсам. Отсутствие сетевого инструмента в диалоге тоже не доказывает отсутствия трафика.
Чтобы принять пробу, сверьте с заданием и файл, и доступные записи действий. Это проверка конкретной работы; по ней нельзя судить об изоляции всей среды.
Интерфейс не открылся, модель не отвечает или файл не появился - что проверить?
Интерфейс не открылся. Найдите адрес сервера в выводе команды. При локальном запуске README обещает открыть браузер, при SSH - вывести адрес. Параметр --no-open отключает открытие браузера. Если вкладка не появилась, сервер всё равно может работать.
Нельзя отправить запрос. Проверьте, выбрана ли рабочая папка. Затем посмотрите на модель: если её сохранённый провайдер удалён, появляется Select model и ввод блокируется. Выберите другую настроенную модель.
Модель не отвечает. Даже сохранённый ключ или ключ из переменной среды может оказаться неправильным. Посмотрите ошибку и настройки провайдера. После исправления дождитесь ответа модели: повторное сохранение ключа ещё не означает, что соединение заработало.
Файл не появился. Откройте выбранную папку, сверьте имя launch-check.md и вызовы инструментов. Прочитал ли агент start-notes.txt, пытался ли записать результат, что ответил инструмент? Пока не откроете и не проверите файл, «готово» не принимайте.
DSH находится в предварительном доступе, возможны несовместимые изменения. Производитель предупреждает: проект не прошёл аудит безопасности и не готов для работы с производственными системами. Удачная проба с заметками не означает, что ему уже можно доверить рабочий проект.
Какую небольшую задачу вы дали бы DeepSeek Harness, чтобы целиком проверить результат? Напишите в комментариях в канале, какой файл хотите получить и как будете его проверять.
Источники
- DeepSeek: Harness - архитектура Cordis, плагины, Creator mode и Developer tools.
- DeepSeek: README - команда запуска, адрес интерфейса, поведение при SSH и предварительный статус проекта.
- DeepSeek: Web UI guide - подключение ключа, выбор workspace, инструменты и подтверждение операций.
- DeepSeek: Model providers - другие провайдеры, выбор модели и условия блокировки ввода.
- DeepSeek: SAFETY - риски, минимальные права, отдельная среда и ограничения изоляции.
- DeepSeek: package.json - версия и требование Node.js в исходном дереве master на дату проверки.
- DeepSeek: CLI - профиль Web и другие профили запуска.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.
