DeepSeek Harness на русском

Установка DeepSeek Harness

Отдельного установщика у DeepSeek Harness нет, что поначалу сбивает с толку. Это пакет для Node.js: одна команда скачивает его и открывает веб-интерфейс. Ниже что понадобится, что случится при первом запуске и куда идти за инструкцией под свою систему.

Что понадобится

Node.js. Единственное, что нужно поставить руками. Скачайте актуальную LTS-версию с nodejs.org: установщик есть для Windows и macOS, на Linux удобнее менеджер версий. В корневом package.json репозитория для разработки указано node ^22.19.0 || >=24.0.0, так что если с прошлых проектов осталась старая версия (18, 20), обновите. Вместе с Node.js ставятся npm и команда npx, она и запускает DSH.

Ключ модели. Сам DSH бесплатен, но без языковой модели агент ничего не умеет. Проще всего взять ключ DeepSeek API; подойдут и другие провайдеры, и локальные модели. Об этом отдельные страницы: ключ API и оплата и локальные модели.

Операционная система. Windows, macOS или Linux, везде нативно, потому что это Node.js. На Windows WSL не нужен. Docker-образа у проекта нет, но в контейнере запустить можно, об этом страница Docker.

Компьютер или сервер. Для обычной работы хватает своего компьютера: агент живёт в папке проекта и заканчивает работу вместе с закрытым терминалом. Сервер нужен, когда агент должен работать без вас (задачи по cron) или быть под рукой с телефона: тогда DSH ставят на VPS с Linux, а интерфейс открывают через SSH-туннель. Подойдёт самый простой тариф с 2 ГБ памяти, например timeweb.cloud от 882 ₽/мес (промокод flutterflow удваивает первое пополнение). Как это устроено, на странице Linux и сервер.

Одной командой

Откройте терминал (на Windows — PowerShell), перейдите в папку проекта, с которым будете работать, и выполните:

npx · node.js $ npx @deepseek-ai/dsh web

npx скачает пакет @deepseek-ai/dsh в кэш npm (в первый раз это небыстро) и запустит подкоманду web, то есть веб-интерфейс. Сервер поднимется на http://127.0.0.1:3080, а в терминале появится строка dsh web: с адресом. В адресе одноразовый токен, поэтому открывать нужно именно напечатанную ссылку, а не набранный по памяти порт. Браузер по умолчанию откроется сам. По SSH не откроется, там адрес только печатается.

Два полезных флага (они относятся к веб-приложению и ставятся после web):

npx @deepseek-ai/dsh web --no-open       # не открывать браузер
npx @deepseek-ai/dsh web --port 8080     # другой порт вместо 3080

Полный список режимов запуска есть в README и в apps/cli/README.md репозитория. Для обычной работы из них нужен только web. Ещё headless пригодится для скриптов, о нём на странице Linux и сервер.

Что происходит при первом запуске

  1. Создаётся профиль DSH хранит настройки в домашней папке ($DSH_HOME, по умолчанию ~/.dsh). При первом запуске там появляется профиль web: набор базовых плагинов и веб-приложение. Другие профили появляются так же, когда к ним впервые обращаются.
  2. Открывается интерфейс без модели Страница загрузится, но агент пока бесполезен: ключа нет. Откройте Settings → Models, вставьте ключ DeepSeek API и сохраните. Лежать он будет в $DSH_HOME/.credentials.yaml, а не в настройках страницы в браузере. Перезапускать ничего не нужно.
  3. Выбирается рабочая папка Папка, из которой вы запустили команду, становится корнем по умолчанию, но в интерфейсе её всё равно надо подтвердить: Choose workspace → добавить папку → выбрать. Пока не подтвердите, поле для задачи останется неактивным. Агент работает только внутри этой папки: читать может что угодно, а писать и запускать команды только в ней и во временных каталогах (режим workspace-write).
  4. Первая задача Напишите что-нибудь простое, например «опиши структуру проекта». Если агенту понадобится сделать что-то за пределами текущих прав, интерфейс спросит разрешения. Дальше ведёт быстрый старт в переводе официального руководства.

Выберите свою систему

  • Windows Установщик Node.js, PowerShell, типовые ошибки (нет node в PATH, политика выполнения скриптов). WSL не нужен.
  • macOS Node.js через установщик или Homebrew, запуск из Terminal, смена порта.
  • Linux и сервер nvm, запуск на своём компьютере и на VPS по SSH с пробросом порта, режим headless для задач по cron.
  • Docker Официального образа нет — как запустить в контейнере на базе node и чем это ограничено.

«Скачать DeepSeek Harness» — а что скачивать?

Запрос популярный, а скачивать нечего: ни exe, ни dmg, ни apk у проекта нет. Программа живёт в реестре npm как пакет @deepseek-ai/dsh, и команда npx сама забирает нужную версию при запуске. Если где-то предлагают «скачать DeepSeek Harness для Windows» одним файлом, знайте: это чья-то сборка, не официальная. Что бывает у сторонних клиентов для десктопа и телефона, я разобрал на странице приложения.

Что есть на самом деле: исходники на GitHub (лицензия MIT) и страница Releases с историей версий. На 11 сентября 2026 в npm тег latest указывает на 0.1.5-rc.1, а next на 0.1.5-rc.2. Проект в статусе developer preview, авторы честно обещают ломающие изменения. Запустить конкретный тег можно так: 

npx @deepseek-ai/dsh@next web

Запуск из исходников

Это для тех, кто хочет править код или пробовать незавершённые изменения. Понадобятся git и pnpm (в репозитории закреплён pnpm@11.7.0). Команды из README: 

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build собирает пакеты и фронтенд, pnpm dsh web запускает уже собранное, без пересборки. Подтянули свежий код — повторите сборку, иначе запустится старое.

Дальше