Установка 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) согласно официальным требованиям.

Другие расширения