DeepSeek Harness: установка на Windows, macOS и Linux, настройка и плагины

DeepSeek Harness — ИИ-агент DeepSeek AI с открытым кодом под MIT, команда запуска — dsh. Агент читает и правит файлы в рабочей папке, запускает команды, раздаёт части задачи субагентам и ведёт план: пишет код и тесты, разбирает таблицы, собирает документы Word и Excel.

Всё в Harness собрано из плагинов на фреймворке Cordis: модель, инструменты, цикл агента и интерфейс можно выключить, заменить своими или дополнить. Проект в стадии developer preview: на 13.11.2026 последний выпуск — dsh-v0.2.2-rc.3, и между версиями ломается совместимость настроек и плагинов.

На Windows и macOS проще всего поставить Desktop: приложение везёт свои Node.js, pnpm и Python. На Linux Harness запускается из терминала через npx, нужен Node.js 24.9 или новее, версию покажет node --version. На 13.11.2026 npx ставит 0.2.2-rc.1 с меткой latest, свежая 0.2.2-rc.3 лежит под меткой next.

DeepSeek Harness Desktop — оболочка Electron вокруг того же Web UI, при первом запуске она просит ключ DeepSeek API. Сессии, настройки, ключи и рабочие папки Desktop хранит в ~/.dsh вместе с dsh из терминала, плагины у него свои. Канал обновлений выбирается в Settings → General → Update channel: Stable или Development.

Web UI запускает dsh web на http://127.0.0.1:3080, и с другого компьютера страница не откроется. Для доступа извне поставьте обратный прокси с HTTPS и передайте адрес флагами --public-url и --trusted-host. В ссылке, которую печатает запуск, лежит ключ доступа к процессу, не пересылайте её посторонним.

npx @deepseek-ai/dsh web --no-open --port 8080   # сервер без браузера на порту 8080

# доступ с другой машины через обратный прокси с HTTPS
dsh --profile web --public-url https://app.example/ui/ --trusted-host app.example

Ключ API создайте на platform.deepseek.com на странице API Keys и вставьте в Harness в Settings → Models, карточка DeepSeek: модель заработает без перезапуска. Затем нажмите Choose workspace и выберите папку проекта, без рабочей папки поле ввода не работает. Для проверки подойдёт запрос Summarize this repository and identify its main packages.

Моделей DeepSeek две, deepseek-flash и deepseek-v4-pro, уровень размышлений выбирается в меню Effort: off, low, high или max. Кнопка Add model provider подключает Anthropic, OpenAI, Kimi, GLM и других провайдеров. Режим Custom model API принимает свой адрес с протоколом OpenAI Chat Completions, OpenAI Responses, Anthropic Messages или Gemini API.

# ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-deepseek
  config:
    reasoningEffort: max          # уровень размышлений по умолчанию

- id: llm-pi-ai
  config:
    providers:
      my-gateway:                 # свой OpenAI-совместимый адрес
        apiKeyEnv: GATEWAY_API_KEY
        api: openai-completions
        baseURL: https://gateway.example/v1
        models:
          - id: my-model

Да: код Harness открыт под MIT, Desktop скачивается бесплатно, а платите вы за токены модели с баланса ключа DeepSeek API или у другого провайдера. Цены ниже — на 13.11.2026 за 1 млн токенов, вне пика они вдвое ниже. Пик — 01:00–04:00 и 06:00–10:00 UTC по будням, по Москве 04:00–07:00 и 09:00–13:00.

Баланс пополняется на platform.deepseek.com на странице Top Up: PayPal, банковская карта, Alipay или WeChat Pay, зачисление видно на странице Billing. Пополненный баланс не сгорает. Если деньги не видны, проверьте способ входа: вход через Google и через почту — два разных аккаунта.

Плагинами в Web UI и Desktop управляет раздел Plugins в боковой панели: там включаются встроенные наборы, а кнопка Add plugin ставит пакет npm или репозиторий Git. Harness сначала читает, что лежит по адресу, потом запускает pnpm и показывает его вывод, удаление спрашивает подтверждение.

Сторонний плагин работает с правами процесса Harness: видит файлы, ключи и сеть. Перед установкой проверьте автора и исходный код, ставьте пакеты только из каталогов, которым доверяете.

# профиль web: поставить, посмотреть и удалить плагин
npx @deepseek-ai/dsh plugin --profile web add <пакет>
npx @deepseek-ai/dsh plugin --profile web list
npx @deepseek-ai/dsh plugin --profile web remove <пакет>

# Desktop: запустите приложение один раз, полностью закройте его, затем
dsh plugin --profile desktop add <пакет>

MCP-серверы подключает плагин @deepseek-ai/dsh-mcp-client: локальную программу через stdio, удалённый сервис через Streamable HTTP. В Web UI и Desktop серверы добавляют в Settings, вручную — в cordis.patch.yml. Примеры конфигов и Claude Code, OpenCode, Codex на моделях DeepSeek разобраны на странице /mcp/deepseek/.

Скиллы Harness ищет в .dsh/skills и .agents/skills проекта, затем в ~/.dsh/skills и ~/.agents/skills, правила проекта берёт из AGENTS.md и CLAUDE.md. Скилл агент подгружает сам, когда тот нужен, а вы вызываете его в чате командой /имя. Готовые скиллы собраны в разделе /mcp/skills/, что писать в AGENTS.md — на странице /mcp/agents-md/.

my-project/
├── AGENTS.md                  # правила проекта
├── .agents/skills/
│   └── release-notes/
│       └── SKILL.md           # вызов в чате: /release-notes
└── .dsh/skills/               # скиллы только для Harness

~/.dsh/AGENTS.md               # ваши правила для всех проектов
~/.dsh/skills/                 # личные скиллы

Аудита безопасности у Harness не было, и для рабочих систем он пока не готов: агент выполняет команды модели, грузит сторонние плагины, ходит в сеть и видит доступные ему ключи и файлы. Запускайте его с минимумом прав, в отдельной виртуальной машине или контейнере, и держите копии файлов, к которым у агента есть доступ.

Песочница ограничивает запись в файлы: на Linux через bwrap и Landlock, на macOS через Seatbelt, на Windows через ограниченный токен и ACL. Сеть и чужие процессы она не закрывает, на Windows и старых ядрах Linux защита частичная. В режиме headless пресет и подтверждения задают флаги --permission-mode и --approval-policy.

Harness, OpenCode и Hermes Agent распространяются бесплатно под MIT и подключают модели разных провайдеров, Claude Code работает на моделях Claude по подписке. Модели DeepSeek подключаются ко всем четырём: в Claude Code через адрес https://api.deepseek.com/anthropic, в OpenCode командой /connect, в Hermes Agent через hermes model. Подробнее о Hermes — на странице /mcp/hermes-agent/.