Руководства DeepSeek Harness

Установка падает на старом Node

Сначала ответ: DeepSeek Harness нужен Node.js ^22.19.0 или >=24.0.0. Старые runtime падают на npx, иногда с предупреждением node-domexception.

1. Запуск node -v и подтвердите диапазон.
2. Поставьте актуальный 22.19+ или 24+ у того дистрибьютора Node, которым уже пользуетесь.
3. Откройте новый терминал, чтобы PATH обновился.
4. Повторить npx @deepseek-ai/[email protected] web.

0.1.2-rc.1 также чинит старт и HMR на Node 24.0-24.11.1. Пины версий — на странице загрузки.

dsh web падает с EACCES на порту 3080

Сначала ответ: в Windows порт чаще держит Hyper-V, WSL2 или Docker, а не ошибка прав на файл.

1. Прочитайте reserved-range на хосте. Если 3080 в этом диапазоне, chmod не поможет.
2. Остановите потребителя (коммутатор Hyper-V, WSL2, Docker) или выберите другой порт флагом текущей версии dsh.
3. Убедитесь, что напечатанный URL — loopback. Не вешайте UI на публичный интерфейс.
4. Если страница открывается, а API даёт 403, вы вне списка доверенных Host. Оставайтесь на 127.0.0.1.

Исправление ACL песочницы Windows

Сначала ответ: @deepseek-ai/dsh-sandbox-windows-acl может закрыть создателю TEMP под C:\Windows\Temp или упасть с SetNamedSecurityInfoW error 5 на workspace от BUILTIN\Administrators.

1. Проверьте, не стоит ли машинный TMP/TEMP в C:\Windows\Temp и не пуст ли пользовательский override.
2. Поставьте HKCU TMP и TEMP в папку, которой владеете, например в профиле. Перезапустите терминал.
3. Создайте workspace, владелец — ваш пользователь, не Administrators. Не берите корень диска вроде D:\.
4. Повторите вызов pwsh в песочнице. Если работает только danger-full-access, это ACL, не модель.

Очистка Windows Temp после выдачи прав может насовсем сломать workspace-write, пока не пересоздадите политику temp. См. политика sandbox and ограничения песочницы.

workspace-invalid-path на китайских именах папок

Сначала ответ: Win32-выбор папки может обрезать пути с символами вроде 开 или 一, и dsh видит ENOENT.

1. В 0.1.2-rc.1 есть фикс обрезки. Закрепите его, если ещё на 0.1.1-rc.2.
2. Если апгрейд пока нельзя — берите путь workspace из ASCII-имён.
3. Не выбирайте корень диска. session.create там падает с EPERM, New Session остаётся пустым.

ERR_MODULE_NOT_FOUND после pnpm install

Сначала ответ: установка опубликованного CLI через pnpm обычно даёт сбой loader entry ui-plan и отсутствие @deepseek-ai/cordis-plugin-group.

1. Для опубликованного пакета берите npx или npm.
2. pnpm — только внутри checkout исходников после pnpm install and pnpm run build.
3. Если plugin add подтянул latest 0.0.1-rc.1 при CLI 0.1.1-rc.2, закрепите версию плагина на линии CLI.

SEC_E_NO_CREDENTIALS внутри песочницы Windows

Сначала ответ: песочница может сломать Schannel HTTPS (curl, PowerShell, .NET), тогда как обычный HTTP и клиенты OpenSSL работают.

1. Воспроизведите вне песочницы. Если HTTPS там работает, хранилище сертификатов хоста в порядке.
2. Для шага в песочнице берите клиенты без Schannel или вынесите запрос из workspace-write после явного разрешения.
3. Это не доказательство, что файловая политика выключена. Сеть вне SandboxMode.

Апгрейд скрывает заголовки сессий или блокирует старт

Сначала ответ: 0.1.2-alpha.5 и 0.1.2-rc.1 чинят регрессию при апгрейде с 0.1.1-rc.2 или 0.1.2-alpha.3.

1. Закрепите 0.1.2-rc.1, если нужна линия 0.1.2.
2. Если нужно выгрузить SQLite-сессии — на сборке старше 0.1.2-alpha.3. Backend убрали, файлы не удаляли.
3. Держите DSH_HOME одноразовым, пока тестируете апгрейд.

Предупреждения антивируса

Сначала ответ: dsh — подписанный пакет npm, запускает Node и может порождать shell. Эвристики ловят этот шаблон.

1. Убедитесь, что запускали @deepseek-ai/dsh, а не похожее имя.
2. Сверьте shasum установленного tarball со значениями на Заметки по SHA и подписям.
3. Восстанавливайте изолированный Node или temp только после этой проверки.

Практики для первого запуска

1. Начинайте в пустой одноразовой папке, не в домашней и не в клиентском монорепо.
2. Держите workspace-write и ask. Не начинайте с danger-full-access.
3. Закрепите версию. npx без пина ставит latest, сейчас это всё ещё 0.1.1-rc.2.
4. Просматривайте plugins, MCP-серверы, Skills и Hooks до исполнения.
5. Не кладите секреты в workspace, если чтение тем же пользователем неприемлемо. Файловая песочница режет запись, не чтение.

Скачать DeepSeek Harness