Установка DeepSeek Harness
В этой главе представленытри способа установки: установка в один клик через npm, установка из исходного кода, Python SDK.
Подготовка перед установкой
Среда выполнения DeepSeek Harness основана на Node.js.Официально рекомендуемый способ установки в один клик не требует дополнительных зависимостей.
Для установки из исходного кода также требуются pnpm и Git.
Метод с Python SDK требует Python 3.10 или выше.
Операционная система:Linux, macOS или WindowsПодходят все
Python SDK поддерживает Linux x64 / arm64 и macOS 14+ (arm64).
| Требования к окружению | Установка npm в один клик | Установка из исходного кода | Python |
|---|---|---|---|
| Node.js | Обязательный | Обязательный | Не требуется (среда выполнения включена в SDK) |
| Git | Optional | Обязательный | Обязательный |
| pnpm | Не требуется | Обязательный | Не требуется |
| Python 3.10+ | Не требуется | Не требуется | Обязательный |
| Ключ API DeepSeek | Все три метода требуют (для настройки; используйте эндпоинты, совместимые с OpenAI) | ||
Сначала проверьте локальное окружение; требуется Node.js, например, v20+:
node -v
git требуется для установки из исходного кода:
git --version
Способ установки:
| Метод | Кому это подходит | Вывод |
|---|---|---|
| Установка npm в один клик Рекомендуется | Большинство пользователей: хотят как можно быстрее попробовать Web UI | Запустить Web UI, по умолчаниюhttp://127.0.0.1:3080 |
| Установка из исходного кода Разработка | Хотите разрабатывать плагины, читать исходный код или внести свой вклад | Локальный репозиторий + полные артефакты сборки, доступныpnpm dshНапрямую запустить точку входа TypeScript |
| Python SDK Программный | Хотите вызывать Agent в своей программе на Python | deepseek_harnessПакет + встроенная среда выполнения, системный Node.js не требуется |
Способ 1: установка npm в один клик (рекомендуется)
Можно использовать команду npm для глобальной установки:
npm install -g @deepseek-ai/dsh
Установка таким способом делает дальнейшее использование более удобнымdshкоманда. После завершения установки введите следующую команду для запуска:
dsh web

Вы также можете использовать команду npx, чтобы установить и быстро опробовать — выполните её в терминале:
npx @deepseek-ai/dsh web
Команда запустит веб-интерфейс, и при первом запуске он автоматически инициализируетсяwebШаблон конфигурации, затем выводит адрес доступа——По умолчаниюhttp://127.0.0.1:3080。

Проверьте, успешно ли прошла установка:
1. Откройте в браузере адрес, выведенный в терминале (по умолчаниюhttp://127.0.0.1:3080);
2. Установка успешна, когда вы видите веб-интерфейс DeepSeek Harness;
3. Примечание: новый веб-интерфейс не выберет ни одного рабочего пространства, пока не будет добавлено рабочее пространство——это нормально, оно будет настроено на следующем шаге.
Советы:dsh будет использоватькаталог вызовав качестве расположения файловой системы по умолчанию. Рекомендуется сначалаcdперейти в каталог вашего проекта и выполнить:npx @deepseek-ai/dsh web, так будет удобнее всего при выборе рабочего пространства позже.
Способ 2: Установка из исходного кода
Подходит для разработки плагинов, чтения исходного кода или участия в проекте. После клонирования репозитория выполните по порядку:
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install # 安装依赖(需要 pnpm,可用 npm install -g pnpm 安装) pnpm run build # 构建包与前端产物(生产运行需要) pnpm dsh web # 以源码方式启动 Web UI
Другие точки входа при запуске из исходного кода:
pnpm dsh --profile headless "run the tests"— выполнить задачу один раз и вывести окончательный ответ;
pnpm dsh --profile web --dump-config— Просмотреть полное дерево конфигурации фактического запуска (полезно при разработке плагинов).
Способ 3: установка Python SDK
Предварительные требования: Python 3.10+, Git, совместимая с DeepSeek конечная точка API и учётные данные, изолированное рабочее пространство, которое агент может изменять. Создайте виртуальное окружение и установите:
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness python -m venv .venv . .venv/bin/activate python -m pip install deepseek-harness-sdk
После настройки учётных данных его можно вызывать в программе (SDK поставляется со встроенной средой выполнения,Системный Node.js не требуется):
export DEEPSEEK_API_KEY=sk-your-key-here # 如果模型不是默认 DeepSeek 端点,而是 OpenAI 兼容代理,还需要: # export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1 # export DSH_MODEL=deepseek-v4-flash
Используйте его в собственной программе на Python:
from deepseek_harness import DeepSeekHarness— встроено в репозиторийexamples/jsonrpc-agent/minimal.pyявляется лёгкой обёрткой для вызовов SDK и на него можно ссылаться напрямую; после запуска он выведет окончательный ответ ассистента, а в каталог сессии поступят логи JSONL, содержащие запросы к модели и вызовы инструментов.
Первоначальная настройка и первая задача
Независимо от того, каким способом вы запускаете Web UI, при первом использовании требуется всего три шага:
| Шаги | Действие | Описание |
|---|---|---|
| 1Модель конфигурации | Настройки → Модель | Введите ключ API DeepSeek и сохраните его. Маршрутизация моделиСразу доступна, перезапуск сервера не требуется; также поддерживаются другие провайдеры и пользовательские конечные точки, совместимые с OpenAI |
| 2Выберите рабочую область | Нажмите "Выбрать рабочую область" | Добавьте каталог проекта, в котором был запущен dsh, и выберите его.Поле ввода сеанса недоступно, пока не выбрана рабочая область |
| 3Запустить задачу | Введите инструкции в сеансе | НапримерSummarize this repository and identify its main packages.— агент будет читать/записывать файлы рабочей области, выполнять команды, делегировать субагентам и поддерживать планы; операции, выходящие за рамки политики разрешений, сначала запросят ваше одобрение |
firstTaskSuggestionsfromLightweightDirectivestart:"Кратко опишите этот репозиторий и определите его основные пакеты."
Сначала дайте агенту освоиться в рабочей области, затем постепенно назначайте реальные задачи.— Рекомендация из официального руководства по быстрому старту
Краткий справочник по основным командам
| Команда | Функция |
|---|---|
npx @deepseek-ai/dsh web |
Запустить веб-интерфейс (эквивалентно--profile web) |
dsh --profile headless "任务描述" |
Запустить задачу один раз, вывести итоговый ответ, затем выйти (подходит для скриптов/CI) |
dsh plugin --profile <name> <pnpm 参数> |
Управление плагинами для профиля (перенаправляет в pnpm для выполнения в каталоге профиля) |
dsh --profile web --dump-config |
Просмотреть полное дерево конфигурации фактического запуска (без запуска сервера) |
dsh --profile web --dump-default-config |
Просмотреть дерево конфигурации по умолчанию (без пользовательских патчей) |
pip install deepseek-harness-sdk |
Установить Python SDK (со встроенной средой выполнения) |
О профиле:webиheadlessДва профиля будут автоматически инициализированы из встроенных шаблонов при первом использовании; остальные профили нужноdsh pluginсоздать. Аргументы запуска dsh идут первыми, аргументы приложения — после, напримерdsh --profile web --port 8080Средняя--portЭто веб-приложение.
Распространённые проблемы и устранение неполадок
Проблема 1: Браузер не может открыть http://127.0.0.1:3080
Убедитесь, что процесс dsh всё ещё выполняется в терминале и нет ошибок; если порт занят, можно использоватьdsh --profile web --port 8080Измените порт; проверьте, разрешает ли брандмауэр локальный порт.
Проблема 2: npx не находит @deepseek-ai/dsh или версия слишком старая
Сначала убедитесь, что Node.js установлен и версия достаточно новая (node -v); проект находится на стадии предварительной версии для разработчиков и быстро развивается. При необходимости очистите кэш npx и повторите попытку либо перейдите на установку из исходного кода.
Проблема 3: pnpm install / build завершается ошибкой при установке из исходного кода
Убедитесь, что pnpm установлен (npm install -g pnpm); при ограниченном доступе к сети можно настроить зеркало для npm/pnpm; для сборки требуется, чтобы версия Node.js соответствовала объявлению engines в package.json репозитория.
Проблема 4: поле ввода сеанса недоступно / агент не может читать или записывать файлы
Самая распространённая причина —рабочее пространство не выбрано— вернитесь в «Выбор рабочего пространства», чтобы добавить и выбрать каталог проекта; убедитесь, что действующий ключ API сохранён в «Настройки → Модели», и маршрутизация модели вступает в силу без перезапуска.
Проблема 5: среда выполнения Python SDK не находит Node.js
SDK поставляется со встроенной средой выполнения и обычно не требует системного Node.js; если он сообщает об отсутствующей среде выполнения, убедитесь, что вы установили полный пакет той же версии, что и SDK (python -m pip install deepseek-harness-sdk), и используйте Linux x64 / arm64 или macOS 14+ (arm64) согласно официальным требованиям.