SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Ошибки установки DeepSeek Harness: решение проблем

Текущие сборки DeepSeek Harness являются пререлизными. Чтобы избежать ошибок, зафиксируйте версию пакета, очистите кэш npx и проверьте корректность используемой версии npm.

Что на самом деле представляет собой установка DeepSeek Harness

Установка DeepSeek Harness выполняется одной командой: npx @deepseek-ai/dsh web. Здесь нет установщика и нет сервиса, который нужно настраивать. Большинство проблем, с которыми сталкиваются пользователи, не связаны с установкой. Это разрешение версий: какую именно сборку @deepseek-ai/dsh решил запустить npx сегодня и способна ли ваша версия Node.js её выполнить. Когда программа запускается, по умолчанию используется привязка к localhost; --host и --port переопределяют настройки прослушивателя, а выводимый адрес использует --public-url при соответствующей настройке. Привязка по умолчанию и почему веб-интерфейс отвечает только на 127.0.0.1:3080 — это отдельные проблемы, не относящиеся к данной странице.

Два факта определяют всё, что описано ниже. Во-первых, каждая версия @deepseek-ai/dsh, опубликованная в npm по состоянию на 27 октября 2026 года, была предварительным релизом. Большинство из них — релиз-кандидаты (-rc.N), а с 30 августа 2026 года появились и альфа-сборки (-alpha.N). Тег latest указывает на релиз-кандидат. По состоянию на 6 ноября 2026 года это 0.2.2-rc.1. Во-вторых, в README проекта указано, что harness находится в стадии developer preview, быстро развивается и будет содержать изменения, нарушающие обратную совместимость. Флаг, который работал на прошлой неделе, может исчезнуть на этой. Фиксируйте версию, прежде чем строить что-либо на её основе.

Сначала определимся с терминами. dsh — это инструмент командной строки DeepSeek Harness. Node.js — это среда выполнения JavaScript, необходимая для его работы. npx — это средство запуска пакетов, которое поставляется вместе с npm (node package manager); оно загружает пакет по требованию, вместо того чтобы устанавливать его постоянно. Если слово harness в этом предложении кажется вам непривычным, agent harness — это программа, обёрнутая вокруг модели, которая управляет циклом, инструментами, правами доступа и состоянием сессии. Именно поэтому версия, которую вы не выбирали, может изменить поведение вашего агента.

Какая версия Node.js требуется для dsh?

10 октября 2026 года, когда репозиторий находился на версии 0.2.1-alpha.2, в его корневом package.json был указан "engines": {"node": "^22.19.0 || >=24.0.0"}. Это требование больше не актуально. По состоянию на 27 октября 2026 года, при версии репозитория 0.2.1-rc.3, корневой package.json указывает "engines": {"node": ">=24.9.0"}, и исходный код CLI package.json теперь указывает то же самое. В заметке о решении по проекту от 15 октября 2026 года сказано, что установки Node 22 требуют обновления, а Node 24.0 недостаточно, так как точки входа зависят от import.meta.main, которого нет в 24.0. Таким образом, требуется Node 24.9.0 или новее. Node 20 и Node 22 исключены, как и любой релиз Node 24 до 24.9.0. При проверке 27 октября 2026 года теги релизов для 0.2.1-rc.2, а также сборка, на которую указывает latest, и 0.2.1-rc.3 всё ещё содержали старый диапазон, поэтому новое минимальное требование появилось позже них. В любом случае ориентируйтесь на 24.9.0, так как именно этот диапазон сейчас заявлен в проекте.

Прежде всего проверьте, что у вас установлено.

node -v
npm -v

Вот момент, который удивляет пользователей. По состоянию на 27 октября 2026 года опубликованный пакет @deepseek-ai/dsh всё ещё не содержал собственного поля engines ни в одной из 38 версий вплоть до 0.2.1-rc.4. Корневой файл монорепозитория объявляет его, но этот файл не публикуется в npm. В исходном коде CLI package.json это поле появилось в коммите от 15 октября 2026 года, но ни одна из опубликованных сборок, проверенных 27 октября, его не содержала. Поэтому такие сборки не передавали npm никаких специфичных для dsh требований к Node для проверки. По состоянию на 6 ноября 2026 года опубликованный пакет 0.2.2-rc.1 объявляет "engines": {"node": ">=24.9.0"}. npm рассматривает engines как рекомендацию, если вы не установите engine-strict, поэтому при настройках по умолчанию стоит ожидать максимум предупреждения. На неподдерживаемой версии Node установка выглядит успешной, а сбой происходит позже, когда загружаемый код обращается к синтаксису или API, отсутствующим в вашей среде выполнения. Не существует единой стабильной строки ошибки для поиска, так как то, какая строка вызовет сбой первой, зависит от порядка загрузки модулей. Читайте node -v вместо анализа текста ошибки.

Если ваша версия Node слишком старая, nvm (node version manager) — наименее инвазивный способ исправления на VPS, так как он устанавливается в ваш домашний каталог и не затрагивает системный Node.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
exec $SHELL -l
nvm install 24
nvm use 24
node -v

node -v теперь должен выводить версию, начинающуюся с v24.. Если оболочка всё ещё сообщает старую версию, выполните which node. Путь вне ~/.nvm обычно имеет две причины. Либо функция оболочки nvm не была загружена — откройте новую сессию входа и попробуйте снова, либо строка в профиле вашей оболочки изменяет PATH после строк, подключающих nvm, и помещает другой Node в начало — переместите эту строку выше строк nvm. Node 24 был активной LTS-веткой (long term support) на 10 октября 2026 года и перешёл в стадию поддержки 20 октября 2026 года. Его новейший релиз на 29 октября 2026 года — 24.22.2, что значительно выше минимального порога 24.9.0. Node 26, который также допускается диапазоном >=24.9.0, перешёл в активную LTS 28 октября 2026 года с версией 26.13.0. Любой из них соответствует минимальным требованиям, и оба включают версии npm с исправлением range-cache, описанным ниже. Официальные Linux-бинарные файлы Node 26 также требуют libatomic, которую, возможно, потребуется установить отдельно в вашем дистрибутиве.

Почему npx каждый день запускает разную версию?

npx @deepseek-ai/dsh web не указывает версию. Если в текущем каталоге проекта уже установлена @deepseek-ai/dsh, npx запустит именно эту копию. В противном случае npx запрашивает у реестра версию, на которую указывает тег latest. Этот тег перемещается, причем часто. Версия 0.1.0-rc.8 вышла 19 августа 2026 года, через два дня после 0.1.0-rc.7. К 10 октября 2026 года latest указывал на 0.2.0-rc.2, а к 27 октября 2026 года — на 0.2.1-rc.2. Каждый раз при смене версии команда из ваших заметок начинает выполнять другой код без предупреждения и без предоставления списка изменений.

Вы можете проверить каждый изменяемый компонент из командной строки.

npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --json

dist-tags показывает, на что в данный момент указывает latest. 10 октября 2026 года и latest, и next указывали на 0.2.0-rc.2, а третий тег, alpha, указывал на 0.2.1-alpha.2, опубликованный днем ранее. 27 октября 2026 года latest указывал на 0.2.1-rc.2, next на 0.2.1-rc.4, опубликованный днем ранее, а alpha на 0.2.1-alpha.5. По состоянию на 6 ноября 2026 года latest указывает на 0.2.2-rc.1. 4 ноября 2026 года next указывал на 0.2.1-rc.5, а alpha на 0.2.2-alpha.3. Тег latest по-прежнему выбирает предварительную версию. Список versions более интересен, так как в нем есть пропуски. 10 октября 2026 года он содержал 31 версию, от 0.0.1-rc.1 до 0.2.1-alpha.2, а к 27 октября 2026 года их стало 38, и каждая из них все еще была предварительной. Линия 0.0.1 перескакивает с -rc.2 на -rc.5, линия 0.1.0 — с -rc.3 на -rc.6, альфа-сборки начинаются с 0.1.2-alpha.2 и 0.1.3-alpha.2, а 0.1.4 отсутствует вовсе. В опубликованном списке отсутствуют номера, а альфа-сборки и релиз-кандидаты перемешаны в одном списке. Попытка угадать следующую -rc.N в скрипте развертывания приведет к ошибке, поэтому читайте список, а не пытайтесь считать версии по порядку.

Почему npx продолжает использовать старую версию?

Это противоположная жалоба, и оба утверждения верны в зависимости от спецификации пакета, локальной установки и версии npm, которую вы используете.

npx хранит собственный каталог пакетов, отдельный от кэша архивов, в папке под названием _npx внутри кэша npm. Выведите путь и проверьте его содержимое.

npm config get cache
ls "$(npm config get cache)/_npx"

npm 10.9.3 уже проверяет реестр при использовании простого имени пакета вне установки проекта. В npm 11.2.0 изменились проверки актуальности кэша для диапазонов версий. Когда указано простое имя, а пакет еще не установлен в текущем проекте, npx получает манифест с помощью preferOnline: true и повторно использует кэшированную копию из _npx только в том случае, если разрешенный архив совпадает с тем, что вернул реестр. Простое имя по-прежнему соответствует любой версии, установленной в текущем проекте, без обращения к реестру. Для диапазона версий npm 10.9.3 принимает совпадающую кэшированную версию; npm 11.2.0 и новее проверяют, разрешается ли диапазон в более новую версию.

Поведение зависит от того, какую версию npm вы запускаете. Если вы не обновили npm отдельно с помощью npm install -g npm, используется версия, поставляемая в составе вашего релиза Node:

  • Node 20.20.2 включает npm 10.8.2.
  • Node 22.19.0 включает npm 10.9.3.
  • Node 22.23.4, новейший релиз 22 на 27 октября 2026 года, включает npm 10.9.9.
  • Node 24.9.0, текущая минимальная версия для harness, включает npm 11.6.0.
  • Node 24.19.0 включает npm 11.17.0.
  • Node 24.22.2, новейший релиз 24 на 29 октября 2026 года, включает npm 11.19.1.
  • Node 26.13.0, новейший релиз 26 на 29 октября 2026 года, включает npm 11.20.0.

Таким образом, вся линейка Node 22 поставляется с версией npm старше 11.2.0. Harness поддерживал Node 22 до середины октября 2026 года и больше не поддерживает, но сервер, на котором ранее запускался dsh, может все еще использовать эту версию. Встроенный в Node 22.19.0 npm 10.9.3 уже выполняет повторную проверку простого имени npx @deepseek-ai/dsh web в реестре вне установки проекта, поэтому наличие старой записи _npx само по себе не объясняет использование старого релиз-кандидата. Каждый релиз Node, который теперь принимает harness, начиная с 24.9.0, включает npm 11.6.0 или новее, что также содержит исправление кэширования диапазонов. Установка в проекте все еще может иметь приоритет. Запросите у инструмента информацию о его версии:

npx @deepseek-ai/dsh --version

Очистка кэша npx

В npm 11.2.0 и новее существуют специальные подкоманды.

npm cache npx ls
npm cache npx rm --force

Без --force npm отказывается удалять все данные и выводит Please use --force to remove entire npx cache. Используйте npm cache npx ls, если хотите удалить одну запись по ключу, а не все сразу.

В npm 10 этих подкоманд нет, поэтому удалите каталог вручную.

rm -rf "$(npm config get cache)/_npx"

npm cache clean --force здесь не поможет. Она очищает _cacache, хранилище архивов, и не затрагивает _npx. Именно из-за этого разделения npm позже добавил подкоманды npm cache npx. Очистка _npx не несет никаких необратимых последствий: там хранятся загруженные пакеты, в то время как состояние вашего harness находится отдельно в $DSH_HOME, включая profiles/<name>, sessions, storages и .credentials.yaml, и остается нетронутым.

Как зафиксировать конкретный релиз-кандидат?

Укажите полную строку версии, включая часть -rc.N.

npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web

Примеры на этой странице используют 0.1.0-rc.7. Подставьте ту сборку, которую вы фактически протестировали. На 27 октября 2026 года тег latest указывал на 0.2.1-rc.2.

--yes принимает подтверждение установки пакета через npx без интерактивного запроса.

Точная версия фиксирует пакет dsh, но не гарантирует запуск в офлайн-режиме. npx использует строку спецификации, которую вы ввели, в качестве ключа для своего кэша и может повторно использовать уже установленную там точную версию. Однако, если соответствующая локальная установка отсутствует, предшествующая проверка локального дерева загружает манифест с помощью preferOnline: true перед проверкой _npx. Соответствующая точная версия, установленная в локальном проекте, позволяет избежать этого обращения к манифесту. Запуск по простому имени вне проекта, в котором установлен dsh, также инициирует обращение к манифесту, в том числе в npm 10.9.3.

Глобальная установка фиксирует версию таким же образом и предоставляет короткую команду для запуска.

npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --version

Не найдена соответствующая версия для @deepseek-ai/dsh@^0.1.0

По состоянию на 27 октября 2026 года обычный диапазон с кареткой или тильдой не работал с этим пакетом. npm install -g @deepseek-ai/dsh@^0.1.0 отвечал кодом ошибки ETARGET и строкой No matching version found for @deepseek-ai/dsh@^0.1.0.. Реестр работает исправно. Это правило semver: диапазон версий не соответствует предварительной версии (prerelease), если один из компараторов диапазона сам не указывает на предварительную версию с теми же номерами major, minor и patch. Каждая опубликованная сборка этого пакета по состоянию на 27 октября 2026 года была предварительной версией, либо -rc.N, либо -alpha.N, а ^0.1.0 не указывал ни на одну из них, поэтому он не соответствовал ничему. Указывайте точную версию.

Это правило работает в обе стороны. Обычный диапазон никогда не переключится на новый релиз-кандидат, но диапазон, указывающий на предварительную версию, может. ^0.1.0-rc.7 означает >=0.1.0-rc.7 <0.2.0-0, поэтому он принимает 0.1.0-rc.8 и принял бы финальную версию 0.1.0, в то время как 0.1.1-rc.1 останется в стороне, так как номера отличаются. Это состояние частичной фиксации между точной версией и динамическим тегом, и оно меняет то, что запускается, без каких-либо действий с вашей стороны. Если вам нужна только та сборка, которую вы протестировали, указывайте точную версию.

Стоит ли использовать npx или установить dsh глобально?

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

Результаты работы этих способов могут различаться на одной машине, если вы использовали оба, поэтому сравнивайте их.

which dsh
dsh --version
npx @deepseek-ai/dsh --version

which dsh если команда не найдена сразу после успешной глобальной установки, это почти всегда означает, что глобальный каталог бинарных файлов npm отсутствует в вашем PATH. Выполните npm prefix -g, чтобы вывести корневой каталог; исполняемые файлы находятся в папке bin внутри него.

Замечание по безопасности. npx загружает и выполняет код из реестра при каждом разрешении новой зависимости, что на сервере является реальной угрозой, а не теоретической. Фиксация версий — это часть решения. Остальное описано в том, как атаки на цепочку поставок npm достигают сервера.

Что означает статус developer preview для воспроизводимости

0.1.0-rc.6 был опубликован 13 августа 2026 года, а 0.1.0-rc.7 — 17 августа 2026 года. Разница составляет четыре дня. С тех пор темп не снизился: в период с 19 августа по 9 октября 2026 года было выпущено еще 24 версии, включая 0.2.0-rc.1 от 28 сентября и 0.2.0-rc.2 на следующий день, а затем еще семь версий в период с 14 по 26 октября 2026 года, вплоть до 0.2.1-rc.4. При такой скорости инструкции, написанные месяц назад, могут описывать командную строку, которой больше не существует, и это касается в том числе данной страницы. Указывайте дату для каждого утверждения о версии, которое вы записываете, включая собственные заметки.

Две привычки позволяют пережить стадию preview. Фиксируйте точную версию в каждой команде и каждом скрипте, чтобы при пересборке сервера выбирался тот же релиз dsh. Это само по себе не гарантирует воспроизводимость зависимостей: опубликованный пакет 0.2.2-rc.1 использует диапазоны, такие как js-yaml: ^4.3.2 и commander: ^15.0.0, и поставляется без npm shrinkwrap. Для повторяемой установки зависимостей храните dsh в локальном проекте с зафиксированным в репозитории package-lock.json и выполняйте пересборку с помощью npm ci. Затем читайте вывод справки из зафиксированной сборки, а не из какого-либо руководства.

npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 web --dump-config

Вторая составляющая воспроизводимости — это профиль. dsh --profile <name> загружает профиль, хранящийся в $DSH_HOME/profiles/<name>, а профили web и headless создаются из поставляемых шаблонов при первом использовании. Патч профиля может содержать настройки модели и эндпоинта, но сохраненные API-ключи находятся в $DSH_HOME/.credentials.yaml, в то время как настройки сохраняют ссылки на учетные данные, поэтому зафиксированная версия и рабочая конфигурация — это две разные вещи, которые нужно настроить правильно. Патчи на уровне домашней директории и командной строки могут переопределять настройки профиля. Встроенные пакеты (bundles) разрешаются из текущей установки dsh, а это значит, что изменение зафиксированной версии меняет и эти пакеты. Внешние плагины ведут себя иначе. Они находятся в директории профиля, и dsh plugin --profile <name> add <package> передает свои аргументы в pnpm для их установки. Поэтому pnpm должен быть в вашем PATH, и dsh прямо сообщает об этом, если его нет. Каждый добавляемый вами плагин запускается с теми же правами, что и ваш агент, поэтому стоит проверить, к чему имеет доступ плагин, прежде чем устанавливать его. Собственный файл package.json профиля объявляет эти плагины; сохраняйте его pnpm-lock.yaml и используйте pnpm install --frozen-lockfile, чтобы воспроизвести и их версии зависимостей.

Это разделение покажется знакомым, если вы привыкли держать инструменты Python в изолированных окружениях на сервере: инструмент и дополнения к нему фиксируются в разных местах. Как только обвязка запущена, следующий вопрос обычно касается сети, а не версий, и здесь на помощь приходят доступ к веб-интерфейсу dsh на удаленном VPS и подробное руководство по установке DeepSeek Harness на VPS.

Ошибки аргументов, с которыми вы столкнетесь

Эти ошибки генерируются собственным парсером CLI, и каждая из них указывает на конкретную проблему. Формулировки в основном остаются неизменными на протяжении разных сборок, но не всегда, поэтому приведенные ниже сообщения были проверены на соответствие 0.2.0-rc.2 от 6 октября 2026 года.

error: --profile <name> is required

Вы запустили npx @deepseek-ai/dsh без подкоманды и без указания профиля. Базовая команда загружает профиль, поэтому ей требуется имя. dsh web работает без --profile, так как парсер считывает первое слово как имя профиля и автоматически загружает для вас встроенный профиль web.

error: --patch needs a path

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

error: --dump-config and --dump-default-config are mutually exclusive

Выберите что-то одно. В 0.2.0-rc.2, сборке latest, актуальной на 6 октября 2026 года, сообщение упоминает третий флаг и выглядит как error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive, поскольку к двум другим добавился --dump-config-schema, который выводит JSON Schema для записей профиля и патчей. --dump-default-config выводит встроенные слои пакета и не принимает --patch. --dump-config выводит сформированную конфигурацию для профиля. Все три команды не запускают основную среду, однако сбор схемы импортирует модули плагинов и может вызывать геттеры и ленивые сборщики; проверяйте только доверенные плагины и принудительно устанавливайте внешний таймаут в скриптах.

error: plugin needs pnpm arguments to forward (e.g. add <package>)

Команде dsh plugin --profile <name> не было передано аргументов для пересылки. Эта подкоманда инициализирует профиль, если он отсутствует, а затем передает остаток командной строки в pnpm, поэтому ей требуются аргументы, такие как add @scope/dsh-plugin-example.

FAQ

Какая версия Node.js требуется для DeepSeek Harness?

Node.js 24.9.0 или новее. По состоянию на 27 октября 2026 года, при версии репозитория 0.2.1-rc.3, в корневом файле package.json указано >=24.9.0. 10 октября 2026 года там было указано ^22.19.0 || >=24.0.0, но согласно решению по проекту от 15 октября 2026 года поддержка Node 22 была прекращена, а минимальная версия поднята выше 24.0. Node 20 и Node 22 работать не будут, как и любой релиз Node 24 старше 24.9.0. На 27 октября 2026 года ни одна опубликованная сборка npm не содержала собственного поля engines, поэтому npm не мог выдать предупреждение или заблокировать запуск на основе требований dsh, и неподдерживаемая среда выполнения приводила к ошибке на более позднем этапе. Опубликованный пакет 0.2.2-rc.1, проверенный 6 ноября 2026 года, теперь содержит >=24.9.0 в engines.node; npm выдает предупреждение по умолчанию и отказывается запускать несовместимую среду выполнения, если включен engine-strict. Сначала проверьте node -v. Каждый релиз Node, соответствующий минимальным требованиям, включает npm 11 или новее, что содержит исправление npx range-cache, внедренное в npm 11.2.0.

Как заставить npx использовать новейшую версию dsh вместо кэшированной?

npm 10.9.3 и текущие версии npm уже выполняют повторную проверку реестра для имени пакета, если только текущая директория не является проектом с установленным dsh — в этом случае npx запускает локальную копию. Используйте npx @deepseek-ai/dsh@latest --version, чтобы явно запросить тег latest из реестра. В npm 11.2.0 были изменены проверки актуальности для диапазонов версий, а не для простых имен. Очистите кэш npx с помощью npm cache npx rm --force в npm 11.2.0 и новее или удалите папку с помощью rm -rf "$(npm config get cache)/_npx" в npm 10. Затем подтвердите выполнение с помощью npx @deepseek-ai/dsh --version. Учтите, что npm cache clean --force очищает другую директорию и не решит эту проблему.

Почему установка @deepseek-ai/dsh@^0.1.0 завершается ошибкой?

По состоянию на 27 октября 2026 года npm возвращал код ошибки ETARGET со строкой No matching version found for @deepseek-ai/dsh@^0.1.0.. Каждая опубликованная на тот момент сборка была предварительным релизом, например 0.2.0-rc.2 или 0.2.1-alpha.2, а диапазон semver не соответствует предварительным версиям, если только сам диапазон не указывает предварительную версию с теми же номерами major, minor и patch. Устанавливайте точную версию, включая суффикс. Запустите npm view @deepseek-ai/dsh versions --json, чтобы увидеть существующие версии, так как в последовательности есть пропуски.

Стоит ли устанавливать dsh глобально или запускать через npx?

npx подходит для первого знакомства, так как пакет остается в директории кэша; harness также создает постоянное состояние профиля. Закрепленная глобальная установка, такая как npm install -g @deepseek-ai/dsh@0.1.0-rc.7, подходит для всего, что должно работать стабильно, так как версия меняется только тогда, когда вы меняете её сами. Если команда dsh не найдена после глобальной установки, значит, глобальная директория bin npm отсутствует в вашем PATH, а npm prefix -g выводит путь к корню, в котором она находится.

Достаточно ли стабилен DeepSeek Harness для разработки на его основе?

Пока нет, согласно описанию самого проекта. В README указано, что проект находится на стадии developer preview, быстро развивается и будет содержать изменения, нарушающие обратную совместимость. Релиз-кандидаты 0.1.0-rc.6 и 0.1.0-rc.7 были опубликованы с разницей в четыре дня в августе 2026 года, 0.2.0-rc.1 и 0.2.0-rc.2 — с разницей в один день в сентябре 2026 года, а 0.2.1-rc.1 и 0.2.1-rc.2 — в один и тот же день в октябре 2026 года. Поддерживаемый диапазон Node также изменился в октябре 2026 года. Закрепляйте точную версию и читайте --help из этой закрепленной сборки, а не из сторонних руководств. Ставьте даты на своих заметках, чтобы понимать, насколько они устарели.

Была ли эта статья полезной?