DeepSeek Harness на русском

DeepSeek Harness на macOS

На Mac всё сводится к двум вещам: поставить Node.js и выполнить одну команду в Терминале. В App Store искать нечего, приложения там нет, да оно и не нужно: интерфейс открывается в браузере.

Шаг 1. Установите Node.js

Способа два, и для DSH разницы нет. Берите тот, что привычнее.

  • Установщик. На nodejs.org скачайте LTS-версию (файл .pkg) и пройдите мастер. Про процессор думать не надо: установщик сам поставит нужную сборку и на Apple Silicon (M1–M4), и на Intel.
  • Homebrew. Если он у вас уже стоит: 
    brew install node
    Homebrew поставит текущую версию Node.js, не LTS. Для LTS есть формула node@22, но DSH и с текущей работает.

Проверьте в Терминале:

node -v
npm -v

В репозитории проекта для разработки заявлен node ^22.19.0 || >=24.0.0. Если с прежних проектов осталась старая версия, обновите.

Шаг 2. Запустите из Терминала

Откройте Терминал (Программы → Утилиты, или Spotlight: ⌘+Space, «Terminal»). Перейдите в папку проекта, она и станет рабочей папкой агента: 

cd ~/Projects/my-project
terminal · npx $ npx @deepseek-ai/dsh web

При первом запуске npx предложит скачать пакет, ответьте y. Когда сервер поднимется, в терминале появится строка dsh web: с адресом вида http://127.0.0.1:3080/… (в нём одноразовый токен), и браузер по умолчанию откроет её сам. Окно Терминала не закрывайте, там работает сервер. Остановить его можно через Ctrl+C.

Порт и браузер

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

Флаги ставятся после web. Сервер слушает только 127.0.0.1, и открыть его другим устройствам в сети через --host 0.0.0.0 не получится: CLI отказывает намеренно, из соображений безопасности.

Шаг 3. Модель и рабочая папка

  1. Ключ модели Settings → Models → карточка DeepSeek → вставить ключ API и сохранить. Там же добавляются другие провайдеры и локальные модели; на Mac с Apple Silicon LM Studio и Ollama чувствуют себя особенно хорошо.
  2. Рабочая папка Choose workspace → добавить папку проекта → выбрать. Пока папка не выбрана, поле ввода неактивно.
  3. Первая задача Например, «опиши структуру проекта». Дальше ведёт быстрый старт из официального руководства.

Как ограничен агент на Mac

Команды агент выполняет через bash. По умолчанию действует режим workspace-write: читать можно всё, писать только в рабочую папку и во временные каталоги. На macOS за это отвечает системная песочница Seatbelt. Сеть и видимость процессов она не трогает. Если агенту нужно выйти за разрешённое, интерфейс спросит подтверждение. Песочница снижает риск, но здравый смысл не отменяет: у всего, до чего агент дотягивается, должна быть резервная копия.

Если что-то пошло не так

  • command not found: node. Терминал открыт раньше установки, или Homebrew не прописал свой путь в профиль оболочки. Откройте новое окно. Если стоит Homebrew на Apple Silicon, проверьте, что /opt/homebrew/bin есть в PATH.
  • Порт занят. Запустите с --port 8080.
  • Браузер не открылся. Сервер при этом работает. Скопируйте адрес из строки dsh web: в терминале и откройте руками.

Дальше