Плагины dsh: как работают и как проверить безопасность
Плагины dsh исполняют сторонний код с правами вашего агента. Узнайте, к каким системным ресурсам они получают доступ и как провести аудит кода перед установкой в DeepSeek Harness.
Что такое плагин dsh и что он может делать?
Плагины dsh — это пакеты Node, которые DeepSeek Harness загружает в свой собственный процесс. После загрузки плагин выполняет сторонний код с правами вашего агента на машине, к которой у агента уже есть доступ. Сам процесс установки защищен лучше. pnpm блокирует выполнение скриптов сборки зависимостей до тех пор, пока вы их не одобрите, а справочное руководство CLI рекомендует «перезапустить профиль после добавления, удаления или обновления пакета», поэтому плагин, добавленный с помощью dsh plugin, загружается при следующем перезапуске. Плагин, установленный через веб-страницу Plugins, может примениться немедленно. Ничто не ограничивает загруженный плагин в доступе к остальной части harness. Поэтому перед установкой стоит задаться вопросом, к чему этот код может получить доступ и как минимизировать эти риски.
dsh (DeepSeek Harness) — это агентская оболочка с открытым исходным кодом от DeepSeek AI, построенная на базе плагинной архитектуры под названием Cordis. Это ключевой момент, поскольку агентская оболочка — это программа, которая управляет моделью, циклом выполнения, инструментами и правами доступа, а плагин интегрируется в неё именно на этом уровне. В README самого проекта указано, что всё является плагином. Адаптер модели — это плагин. Веб-интерфейс, в котором вы вводите данные, — это плагин. Всё, что вы устанавливаете извне, попадает в ту же структуру и обладает тем же уровнем доверия, что и компоненты, поставляемые вместе с проектом. Если вы еще не развернули систему, начните с установки DeepSeek Harness на VPS и вернитесь к этому вопросу перед добавлением дополнительных компонентов.
В августе 2026 года в AGENTS.md репозитория был приведен список точек расширения, доступных плагину, который включал:
- LLM (большая языковая модель): провайдер, за которого вы платите через API key
- Shell: возможности bash с локальными провайдерами и провайдерами pwsh
- Filesystem: доступ к файлам, контролируемый политиками
- Web: провайдеры для поиска и получения данных
- Subprocess: провайдер для работы с деревом процессов
- Workflow: рабочие потоки
- Subagent: делегирование задач другим агентам
- Settings and credentials: ваши сохраненные конфигурации и переменные окружения
Этот список с тех пор исчез из AGENTS.md. По состоянию на 17 ноября 2026 года в docs/architecture.md проекта указаны точки расширения, к которым добавлены бэкенды песочниц, постоянные терминалы, фоновые задания, команды для человека и сессии, запускаемые вебхуками, в дополнение к интерфейсам модели, инструментов, оболочки, файловой системы и субагентов.
Плагин также регистрирует инструменты в ctx.tools, и в документации четко указано, что схема зарегистрированного инструмента включается в процесс формирования промпта. Эту вторую часть часто упускают из виду. Плагин может изменить решение агента, не выполняя при этом никаких подозрительных действий, так как описание, которое он предоставляет, становится текстом, который считывает модель. Это та же проблема, что и prompt injection против агентов для написания кода, с одним отличием: этот текст добавляется при установке и остается активным до тех пор, пока вы не удалите плагин.
Как dsh находит и загружает плагины?
Глобального каталога плагинов не существует. Запущенный dsh представляет собой дерево плагинов, которое формируется при загрузке из упорядоченных слоев, а единицей хранения ваших настроек является профиль. $DSH_HOME по умолчанию использует ~/.dsh, а каждый профиль находится в $DSH_HOME/profiles/<name>. Профили web и headless создаются автоматически при первом использовании на основе поставляемых шаблонов.
Каталог профиля содержит два файла, которые определяют всё:
package.json, содержащий внешние зависимости плагинов, а также манифестdsh.profileс упорядоченным спискомbundlescordis.patch.yml, ваш собственный слой исправлений поверх этих пакетов
ls ~/.dsh
ls ~/.dsh/profiles/webПри загрузке слои применяются в следующем порядке, при этом последующие слои имеют приоритет:
- пустой корень
- пакеты профиля в порядке, указанном в манифесте
cordis.patch.ymlпрофиля$DSH_HOME/cordis.patch.yml- любые наложения
--patch <path>, переданные через командную строку
Два флага позволяют вывести результат этой композиции без запуска каких-либо процессов:
dsh --profile web --dump-default-config
dsh --profile web --dump-config--dump-default-config выводит только слои пакетов. --dump-config добавляет слои профиля, домашние исправления и любые наложения --patch, поэтому это наиболее точный способ получить инвентаризацию того, что будет загружено при следующей загрузке. Проверяйте этот список, прежде чем доверять унаследованной машине.
Одно предупреждение относительно этих файлов исправлений. Конфигурация здесь не является инертными данными, так как формат позволяет использовать значения с тегом !!js в блоке config плагина. Фрагмент cordis.patch.yml, скопированный с форума, является кодом, поэтому относитесь к нему так же, как к shell-скрипту из того же источника.
Что на самом деле запускает dsh plugin add?
dsh plugin --profile <name> <args> передает свои аргументы утилите pnpm внутри директории этого профиля, поэтому pnpm должен присутствовать в PATH. Используются команды самого pnpm:
dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web updateТаким образом, модель безопасности при установке плагина dsh совпадает с моделью безопасности при установке любой зависимости в стиле npm, с добавлением одного шага, на котором результат загружается в ваш агент. Пакет приносит с собой собственное дерево зависимостей, и каждый пакет в этом дереве оказывается в одном и том же процессе. Всё, что описано в как атаки на цепочку поставок npm достигают сервера, применимо здесь без изменений.
Начиная с версии pnpm 10, скрипты сборки зависимостей по умолчанию не выполняются, а одобрение происходит для каждого пакета отдельно через pnpm approve-builds или настройку allowBuilds. В pnpm 11 старая настройка onlyBuiltDependencies была заменена на allowBuilds, поэтому руководство или старый конфигурационный файл, использующий onlyBuiltDependencies, ничего не одобряют в актуальной версии pnpm. Проверьте установленную у вас версию pnpm:
pnpm --versionПлагины, размещенные в Git, — это первое, с чем вы столкнетесь в этом контексте. Справочник CLI гласит, что Git-плагин, поставляющий исходный код, выполняет сборку во время установки через свой скрипт prepare, поэтому первый запуск add завершится ошибкой с подсказкой allowBuilds от pnpm. Вам нужно скопировать выведенный ключ в файл pnpm-workspace.yaml профиля и запустить команду снова. Одобрение этого ключа разрешает выполнение сборки репозитория с правами вашего пользователя. Для готовых архивов (tarballs) и локальных копий репозиториев разрешения не требуются.
Это поведение по умолчанию полезно, но это также самая часто игнорируемая функция безопасности в экосистеме. Блокировка скриптов сборки предотвращает выполнение кода во время установки. Она никак не ограничивает сам плагин, так как смысл плагина заключается в том, что среда выполнения импортирует его и вызывает после перезапуска профиля или сразу после применения установки, если вы использовали веб-страницу Plugins. Плагину не нужен хук postinstall. Он уже был допущен в систему.
Что нужно прочитать перед установкой плагина dsh
Скачайте опубликованный tarball и изучите его содержимое. Распаковка архива не приводит к выполнению кода.
npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.jsonЧетыре поля в файле package.json содержат основную информацию, которая вам потребуется. Проверьте scripts на наличие записей preinstall, install и postinstall. Изучите dependencies на предмет имен, которые вам незнакомы или отличаются от известных вам имен всего на один символ. Проверьте bin, чтобы узнать, какие пути пакет пытается добавить в ваш PATH. Изучите main или exports, чтобы найти точку входа, затем откройте этот файл и проанализируйте его содержимое.
После этого изучите код, который будет загружен. У плагина, заявленного как инструмент уведомлений, нет причин читать ~/.ssh, обращаться к неизвестному вам хосту или запускать оболочку (shell). Если пакет поставляется только в виде упакованного или минифицированного JavaScript, а исходный код отсутствует в публичном репозитории — это повод для отказа от установки. Отдавайте предпочтение плагинам с доступным для чтения исходным кодом и выбирайте наиболее компактные решения.
Вы также можете получить информацию из реестра, не устанавливая пакет:
pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versionsПакет, опубликованный на прошлой неделе, имеющий только одну версию, отсутствие поля с репозиторием и имя, имитирующее популярный продукт — это старейший трюк в любом реестре. Проверка загрузок по контрольным суммам — это обязательная привычка: вы должны точно знать, что именно вы скачали, прежде чем разрешить выполнение кода.
Фиксация версии и сохранение lock-файла
Плавающий диапазон версий означает, что код внутри процесса вашего агента может измениться при любой установке или обновлении без вашего участия. Зафиксируйте версию.
dsh plugin --profile web add --save-exact '<package-name>@<version>'Расположение флагов зависит от версии pnpm, поэтому проверяйте результат, а не полагайтесь на команду. Откройте package.json профиля после выполнения и убедитесь, что зависимость указана как чистая версия без символов ^ или ~ перед ней. Этот файл определяет, что именно будет установлено.
Затем сохраните lock-файл, который фиксирует всё дерево транзитивных зависимостей, а не только имя верхнего уровня:
find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'Скопируйте его в место, где вы храните резервные копии, вместе с package.json профиля. Эти два файла позволяют восстановить идентичное дерево на новом сервере. Запускайте dsh plugin --profile web update только тогда, когда вы решили обновить версии, а не в качестве рутинной очистки, и после этого обязательно просматривайте diff lock-файла.
Для плагина, установленного из git, а не из реестра, фиксируйте коммит, а не ветку. Спецификация вида github:owner/repo#<full commit sha> обеспечивает фиксированное дерево. Имя ветки при следующем разрешении зависимостей в pnpm вернет то, что находится в этой ветке на данный момент, — это решение, которое вы делегируете кому-то другому. Сама обвязка требует такой же дисциплины, поскольку релиз latest в npm является релиз-кандидатом, и установка без фиксации может в любой день разрешиться в другую версию; именно отсюда возникает большинство ошибок установки и версий dsh.
Рынок плагинов и ценность «курируемого» контента
У dsh есть маркетплейс, который устанавливается в виде плагина, что многое говорит об архитектуре системы:
dsh plugin --profile web add dshmarketПосле перезапуска он появляется в виде вкладки на странице Plugins рядом с разделом Installed в dsh версии 0.2.1 и новее; на старых хостах используйте Settings, а затем Plugin Market. В файле README прямо указаны ограничения. Установка разрешена только из источников, включенных в курируемый реестр, любые другие отклоняются. Скрипты сборки по умолчанию заблокированы, для включения каждого из них требуется отдельное подтверждение. Терминальные плагины помечаются специальными флагами перед тем, как попасть в веб-профиль. Самое важное утверждение заключается в том, что наличие в списке не является гарантией качества, так как плагины — это сторонний код. В том же README сказано, что большинство установленных через него плагинов начинают работать после обновления страницы без перезапуска, поэтому установка в один клик может привести к запуску кода внутри вашего агента уже через несколько секунд.
Курируемый список повышает базовый уровень безопасности. Он не проверяет код за вас и не может предсказать, что сделает следующая версия плагина после смены владельца учетной записи сопровождающего. Относитесь к установке в один клик так же, как вы отнеслись бы к curl | bash от того же автора. Стоит повторить еще одну строку из этого README: экспортированная резервная копия может содержать учетные данные из конфигурации вашего профиля, поэтому никогда не прикрепляйте ее к публичным тикетам или на сайты для обмена текстом. Если вам нужен готовый список, а не метод, плагины dsh, которые стоит установить — это дополнительная статья к данной.
Теперь у инструмента есть и собственный маршрут. Экспериментальный индекс пакетов Custom plugin, включаемый на странице Plugins, добавляет вкладку Discover, которая наполняется индексными файлами, добавленными вами вручную. dsh не поставляет никаких источников индексов, а в документации указано, что индексы являются сторонним контентом, и dsh проверяет только формат файла, но не то, что индекс утверждает о названии, авторе или источнике плагина.
Запуск dsh от имени отдельного пользователя, а не root
Проверка кода снижает вероятность проникновения вредоносных компонентов. Принцип наименьших привилегий определяет, к чему именно получит доступ злоумышленник в случае взлома. На VPS реализация этого принципа не требует больших затрат.
Создайте для инструмента отдельную учетную запись Unix с собственным домашним каталогом и никогда не запускайте его от имени root:
sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrunВ рамках этой сессии запустите инструмент, чтобы он записывал данные в домашний каталог этой учетной записи:
npx @deepseek-ai/dsh webВеб-интерфейс по умолчанию работает на http://127.0.0.1:3080. Оставьте этот параметр без изменений. Если вы переходили по выведенной ссылке с другого компьютера и не получали ответа, в пояснении к адресу, который выводит dsh описаны причины такого поведения. Поставляемая веб-компоновка проверяет заголовки Host и Origin, а также требует аутентификации браузера или API Peer для каждого метода Host RPC и потока WebSocket, при этом dsh web отклоняет --host 0.0.0.0. Клиенты API проходят аутентификацию через /connect и получают подписанный API-cookie. Рассматривайте этот вход как второй замок, а не как повод открывать доступ к 3080. За интерфейсом скрывается агент с доступом к оболочке, поэтому утечка токена сессии или ошибка в механизме входа на публичном порту предоставит постороннему лицу удаленную оболочку без прав root, но с удобным интерфейсом. Получайте доступ к нему со своего ноутбука через SSH-туннель:
ssh -L 3080:127.0.0.1:3080 you@your-vpsЗатем убедитесь, что ни один сервис не ожидает соединений на публичном адресе:
ss -lnt | grep 3080Локальный адрес должен иметь вид 127.0.0.1:3080. Если отображается 0.0.0.0:3080, значит, сервис использует настройки, отличные от стандартных dsh web, например, другую конфигурацию или измененные параметры, и эта конфигурация управляет собственной аутентификацией. В документации проекта указано, что базовый веб-сервер не имеет встроенной аутентификации или политики Origin, поэтому, пока вы не убедитесь в защищенности порта, считайте, что только межсетевой экран отделяет посторонних от вашего агента, и верните привязку к loopback. Принципы, описанные в статье безопасный запуск Claude Code на VPS, в полной мере применимы и к dsh. Выделите агенту один рабочий каталог, который ему разрешено изменять, и не храните на этой машине ничего, что вы не сможете восстановить. Еще лучше — рассматривайте сервер как одноразовую виртуальную машину для агентов разработки, так как переустановка VPS занимает час, а аудит безопасности — неделю.
Где хранятся ваши ключи и почему прав доступа к файлам недостаточно
dsh хранит API-ключи в $DSH_HOME/.credentials.yaml, а значения переменных окружения — в $DSH_HOME/.env; настройки моделей находятся в cordis.patch.yml активного профиля. Когда это руководство впервые проверялось в октябре 2026 года, $DSH_HOME/settings.yaml из более раннего релиза импортировался один раз и переименовывался в settings.yaml.imported. Какой ключ должен находиться в каждом из этих файлов и что именно покидает сервер в каждом режиме — тема раздела настройка API-ключей, моделей и эндпоинтов dsh. Разобраться с этим стоит до добавления плагина, так как каждый подключенный ключ — это еще одна сущность, которую плагин может прочитать. Ограничьте доступ к двум наиболее чувствительным файлам:
chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dshРежим 600 предоставляет владельцу права на чтение и запись, а всем остальным — никаких прав; это полезно знать в обоих обозначениях (числовые и символьные режимы chmod). Будьте реалистичны в отношении того, что это дает. Права доступа к файлам защищают их от других учетных записей на сервере. Они никак не защищают от плагина, так как плагин выполняется от имени владельца этих файлов, внутри процесса, который их читает. Именно поэтому ограничение доступа AI-агента к секретам подразумевает их полное отсутствие на машине. На сервере с dsh должен находиться только один ключ модели, необходимый для работы. Ваши облачные учетные данные и ключи подписи должны храниться в другом месте.
Почему плагин для чтения веб-страниц меняет модель угроз
Веб-интерфейс предоставляет плагинам инструменты для поиска и получения данных. Плагин, который загружает страницу в вашу сессию, извлекает текст, написанный злоумышленником. Модель промптов не разделяет инструкции и данные, поэтому загруженная страница может содержать строку, адресованную вашему агенту, а среда выполнения с доступом к shell находится всего в одном шаге от её исполнения.
Механизм контроля уже реализован в среде выполнения. dsh-base, общий базовый набор профилей web, headless, sdk и acp, включает в себя песочницу и политику подтверждения действий (профиль sdk-minimal намеренно исключает их). Используйте их. Сессия, которая может загружать недоверенные страницы, должна требовать подтверждения для любых операций записи или выполнения, чтобы загруженная инструкция не могла стать действием сама по себе. В разделе Ограничение действий агента через подтверждения описано, как определить границы этих проверок. Взаимосвязь работает в обоих направлениях: ваш собственный сервер — это страница, которую может загрузить чей-то агент, что рассматривается в разделе блокировка AI-краулеров на вашем сервере.
Как проверить, что изменил плагин?
Сделайте снимок до установки, установите плагин, сделайте снимок после, а затем изучите разницу.
dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txtDiff показывает, какие записи плагина были добавлены в составное дерево при установке. В дерево попадает только тот пакет, который объявляет патч для бандла; обычная зависимость ничего туда не добавляет, и dsh выдает по этому поводу однократное предупреждение. Если плагин, установленный ради одной небольшой функции, добавляет несколько записей, которые вы не можете объяснить, — это повод остановиться и изучить исходный код перед запуском. dsh plugin --profile web why <package-name> отвечает на другой вопрос: какая из ваших прямых зависимостей потянула за собой конкретный пакет.
Установленные пакеты попадают в собственный node_modules профиля, расположенный по пути $DSH_HOME/profiles/<name>/node_modules, поэтому вы также можете просмотреть дерево на диске:
ls ~/.dsh/profiles/web/node_modulesДержите второй профиль, в котором вы никогда не проводите эксперименты. Если установка ломает окружение, загрузка dsh --profile <clean-name> за секунды покажет, был ли причиной плагин.
Как удалить плагин dsh?
dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txtУдаление зависимости не всегда приводит к удалению конфигурации. Записи, внесенные в cordis.patch.yml профиля, остаются на месте, так как этот файл принадлежит вам, и инструментарий не будет перезаписывать его автоматически. Откройте файл и удалите все блоки, в которых упоминается удаленный пакет.
less ~/.dsh/profiles/web/cordis.patch.ymlЗатем перейдите к этапу, который не может исправить ни одна команда удаления. Если вы удалили плагин из-за потери доверия к нему, считайте, что все данные, к которым он имел доступ, уже скомпрометированы. Смените API-ключ DeepSeek в консоли провайдера и обновите все остальные секреты, которые хранились в $DSH_HOME. После этого проанализируйте, к каким ресурсам в вашей сети имел доступ системный аккаунт, под которым работал плагин.
Краткая версия
- Изучите опубликованный tarball перед установкой, начиная с
scriptsи файла входа. - Фиксируйте точную версию или конкретный commit для git-спецификации и сохраняйте lockfile.
- Выполняйте установку в один профиль и держите чистый профиль, который можно загрузить в случае сбоя.
- Сравнивайте
--dump-configдо и после каждой установки. - Запускайте harness от имени отдельного unix-пользователя, на loopback-интерфейсе, с доступом по SSH.
- Храните на сервере только один API key и обновляйте его в день удаления плагина, которому вы больше не доверяете.
Всё это не является поводом отказываться от плагинов. Модель плагинов — причина, по которой dsh полезен, а harness, который нельзя расширить, — это harness, который вы в итоге замените. Это повод знать, что именно вы установили, от кого, какой версии, и запускать всё это там, где вы сможете выполнить пересборку.
FAQ
Изолирует ли dsh плагины друг от друга?
Нет. Плагин загружается в процесс harness через Cordis и получает доступ к документированным интерфейсам взаимодействия, включая shell, файловую систему, web, подпроцессы, subagent и учетные данные. dsh-base, первый общий набор web, headless, sdk и acp профилей, поставляет песочницу и политику одобрения, которые определяют допустимые действия инструментов агента; именно эта политика обеспечивает вашу защиту. Границы прав доступа для каждого отдельного плагина отсутствуют, поэтому честная модель безопасности подразумевает, что установка плагина распространяет ваше доверие на его автора и на каждый пакет в дереве его зависимостей.
Можно ли установить плагин dsh без выполнения его скриптов установки?
pnpm 10 и более поздние версии блокируют скрипты сборки зависимостей по умолчанию, а dsh plugin ... add перенаправляет запросы в pnpm, поэтому в актуальной версии pnpm установка не запускает скрипты пакетов, если вы не одобрили этот пакет. Проверьте свою версию с помощью pnpm --version. Это не делает непроверенный плагин безопасным. Код самого плагина выполняется сразу после загрузки harness при следующем перезапуске профиля после установки через dsh plugin или часто сразу после установки со страницы Plugins в web-интерфейсе, и никакие ограничения времени установки на это не влияют.
Где фактически хранятся плагины dsh и их конфигурация?
$DSH_HOME по умолчанию использует ~/.dsh. Профили находятся в $DSH_HOME/profiles/<name>, каждый из них содержит package.json с зависимостями плагинов, манифест dsh.profile упорядоченных наборов и слой исправлений cordis.patch.yml. Установленные пакеты попадают в собственную директорию node_modules каждого профиля, расположенную по пути $DSH_HOME/profiles/<name>/node_modules. Ключи находятся в $DSH_HOME/.credentials.yaml, значения переменных окружения — в $DSH_HOME/.env, а файл $DSH_HOME/cordis.patch.yml на уровне домашней директории применяется ко всем профилям. Запустите dsh --profile web --dump-config, чтобы увидеть итоговую конфигурацию без запуска системы.
Безопасно ли устанавливать плагины из магазина dsh?
Магазин ограничивает установку источниками из проверенного реестра и блокирует скрипты сборки, пока вы не одобрите их для каждого пакета, что является реальным улучшением по сравнению с копированием имени пакета из чата. В его README по-прежнему указано, что размещение в магазине не является одобрением, так как плагины представляют собой сторонний код от других разработчиков. Изучайте исходный код и фиксируйте версии. Запускайте harness под учетной записью пользователя и, по возможности, на машине, потерю которой вы можете себе позволить.