[позже] Установка Node/DSH с нуля

Глава 2. Что нужно установить и настроить до первого запуска

Эта глава — самая техническая во всём учебнике. Если вы справитесь с ней, дальше будет намного проще. Но будьте готовы: это не установка мобильного приложения. Вам придётся работать с командной строкой (терминалом).

Важное предупреждение: если вы никогда не открывали терминал и не вводили команды, рекомендую сначала попрактиковаться на простых вещах (например, создать папку через mkdir). Или попросите знакомого программиста помочь вам на этом этапе. Установка DSH требует внимательности, и ошибки на этом шаге могут привести к тому, что ничего не заработает.

2.1. Что вам понадобится

Компьютер с Windows, macOS или Linux.
Интернет (для скачивания и регистрации).
Банковская карта или PayPal (для оплаты токенов API — да, понадобится, так как бесплатного доступа к моделям DeepSeek нет).
Терпение и готовность разбираться.

2.2. Регистрация на платформе DeepSeek и получение API-ключа

DeepSeek Harness — это фреймворк, который сам по себе бесплатен, но для работы ему нужна модель, которая платная. Вы можете использовать модели DeepSeek, OpenAI, Anthropic и другие. Мы будем использовать родную модель DeepSeek, так как она дешевле и хорошо интегрируется.

Пошаговая инструкция:

Перейдите на сайт platform.deepseek.com.
Нажмите «Sign Up» (Регистрация). Введите email, придумайте пароль и подтвердите почту.
После входа в аккаунт перейдите в раздел «API Keys» (обычно в левом меню).
Нажмите «Create API Key», дайте ему имя (например, «dsh-test») и скопируйте полученный ключ. Сохраните его в надёжном месте — этот ключ даёт доступ к платным ресурсам, и его нельзя никому показывать.
Пополните баланс. Для тестов достаточно внести $5–10. Цены API меняются — следите за расходом и поставьте лимит в кабинете, если есть.

Альтернатива: если у вас уже есть ключ OpenAI, вы можете использовать его, но тогда в настройках DSH нужно будет указать другого провайдера. Для простоты мы будем использовать DeepSeek.

2.3. Установка Node.js

DSH работает на платформе Node.js. Это среда, которая позволяет запускать JavaScript не только в браузере, но и на компьютере.

Жёсткое требование пакета @deepseek-ai/dsh:

Node.js ^22.19.0 (то есть 22.19 или новее на ветке 22), или
Node.js >=24.0.0
Ветка 23.x не поддерживается
Node 18 и 20 не подойдут — установка или запуск часто ломаются без понятного сообщения

Проверьте версию:

node -v

Для Windows:

Зайдите на nodejs.org.
Скачайте LTS 22.x (не Current 23 и не старый 20). Убедитесь, что после установки node -v показывает 22.19+ или 24+.
Запустите скачанный .msi-файл.
В мастере установки нажимайте «Next» везде, ничего не меняя. Согласитесь с лицензией.
После установки откройте новый терминал (или перезагрузите ПК) и снова выполните node -v.

Для macOS:

Зайдите на nodejs.org.
Скачайте LTS 22.x для macOS (файл .pkg).
Запустите скачанный файл и следуйте инструкциям установщика.
После установки перезапустите терминал и проверьте node -v (≥22.19 или ≥24).

Для Linux (Ubuntu/Debian):

Откройте терминал и выполните команды (ветка 22, не 20):

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v

Если версия ниже 22.19 — обновите Node, иначе npx @deepseek-ai/dsh может не завестись.

2.4. Установка и быстрый запуск DSH

Самый простой способ — без глобальной установки:

npx @deepseek-ai/dsh web

Веб-интерфейс по умолчанию: http://127.0.0.1:3080.

Если будете пользоваться часто:

npm install -g @deepseek-ai/dsh
dsh web

На Windows после глобальной установки перезапустите терминал, если команда dsh «не найдена».

API-ключ вставляйте в Settings → Models в Web UI (не в публичные промпты и не в README).

2.5. Итоговый чек-лист

[x] Есть аккаунт и API-ключ на platform.deepseek.com.
[x] node -v показывает ≥22.19 (ветка 22) или ≥24.
[x] Команда npx @deepseek-ai/dsh web запускает интерфейс.
[x] Ключ сохранён как секрет, не светится в чатах и репозиториях.

Дальше — глава 3: первый запуск только в тестовой папке, не на боевом проекте.