DEV Community

TechNotes
TechNotes

Posted on

DeepSeek Harness Desktop: приложение для Windows и Mac, установка и плагины

До 30 сентября DeepSeek Harness запускали командой npx @deepseek-ai/dsh web в терминале, интерфейс открывался в браузере на локальном адресе. Нужны были Node.js, терминал и pnpm для первой установки плагина. Для новичка это барьер. 30 сентября вышла десктопная версия: скачать установщик, поставить, войти в аккаунт.

Что это за программа

DeepSeek Harness, коротко dsh, — агентный харнесс. Он связывает языковую модель с инструментами: агент читает и правит файлы в папке, запускает команды, выходит в сеть, строит план и готовит отчёт.

Код открыт под лицензией MIT. Репозиторий создан 13 августа 2026 года, к началу октября у него 243 тысячи звёзд и 29 тысяч форков. Девиз — «Everything is a Plugin».

На фреймворке Cordis собраны модель, инструменты, песочница, хранилище сессий, интерфейс и цикл агента. Поэтому поведение меняется без правки исходников, и за полтора месяца вырос каталог сторонних дополнений.

Две официальные сборки и неофициальная третья

На странице deepseek.com/harness есть кнопки для macOS на Apple и Windows 64 бита. Размеры сняты запросом заголовков к серверу загрузок.

Сборка Файл Размер
Windows x64 dsh-latest-windows-x64.exe 289 МБ
macOS, Apple Silicon dsh-latest-macos-arm64.dmg 370 МБ
macOS, Intel dsh-latest-macos-x64.dmg 386 МБ

Все три файла датированы 29 сентября, выпуск — 0.2.0-rc.2. Сборки для Intel на странице загрузки нет, хотя файл лежит на сервере. В журнале выпуска для неё указана починка: неверная подпись встроенного Node, из-за чего при запуске падали офисные навыки. Эту сборку проверяют меньше.

Что лежит внутри установщика

Оболочка — Electron вокруг того же веб-интерфейса. README называет её тонкой и такой же по поведению, как веб-версия. Большой вес объясняется просто: внутрь упаковали всё сразу.

Схема: что входит в установщик DeepSeek Harness Desktop

Слоёв четыре:

  • dsh с полным деревом зависимостей в подписанном архиве приложения;
  • Node.js (исполняемый файл Electron) и pnpm для установки плагинов;
  • отдельный Python с numpy, pandas, python-docx, python-pptx, openpyxl, Pillow, lxml, XlsxWriter;
  • три офисных навыка по умолчанию: Word, презентации, Excel.

Установка на Windows

Мастер установки классический, в конце галочка «запустить после установки». Программа оказывается в AppData\Local\Programs\DeepSeek Harness. Запущенное приложение блокирует установку, выйти придётся через трей.

После старта в трее появляется значок: одиночный щелчок показывает окно, меню умеет открыть или выйти. Крестик окно не закрывает, а прячет, при первом закрытии будет подтверждение и объяснение, что задачи продолжаются. Alt+F4 и «Закрыть окно» на панели задач действуют так же.

Установка на Mac

Открываете образ и перетаскиваете значок в «Программы». В скриптах есть подпись и нотаризация Apple, поэтому предупреждения о неизвестном разработчике быть не должно. Красная кнопка и ⌘W прячут окно, приложение остаётся в Dock и работает. Значка в строке меню нет, окно возвращается щелчком по Dock, полный выход — ⌘Q.

Правка 0.2.0-rc.2 решила старую проблему: GUI-программы macOS не видели переменные из ~/.zshrc и ~/.zprofile, поэтому агент не находил инструменты Homebrew и настройки прокси. При старте запускается оболочка входа, забирает окружение и передаёт его агенту, терминалам и плагинам. Таймаут — десять секунд, дальше перебираются zsh, bash и sh. Правки в файлах оболочки подхватятся после полного перезапуска.

Первый запуск и рабочее окно

Войти можно в аккаунт DeepSeek через системный браузер или вставить ключ API с platform.deepseek.com. Третья кнопка — «настроить позже», но вопрос вернётся при следующем запуске. С версии 0.1.7-rc.2 после входа идёт знакомство: информация о лимите, вопрос о назначении, выбор подробности показа хода работы. Прерванное знакомство продолжают позже.

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

Внизу поле ввода с выбором модели, уровня рассуждения и режима агента. Режимов четыре: стандартный, «создатель» для разработки плагинов, PTC и минимальный с урезанным набором.

Окно закрыли, а агент работает

Закрытие окна работу не останавливает: страница и сервер продолжают жить, задачи выполняются. Вернувшись, вы получите ту же сессию, черновик и положение прокрутки. Если агент работает, ждёт подтверждения или очередь сообщений не пуста, выход спросит подтверждение и перечислит, что прервётся. Без работы приложение выходит молча.

Права: песочница и подтверждения

Это два независимых рычага. Режим песочницы задаёт, куда команды агента могут писать, а политика подтверждений — о чём агент обязан спросить. В интерфейсе всё собрано в один переключатель с готовыми наборами.

Первый набор разрешает запись только в рабочую папку и временный каталог, на остальное спрашивает разрешение. Второй снимает ограничения и вопросы, его название — danger-full-access.

Обновления идут своим чередом

Проверка запускается при старте и дальше примерно раз в десять минут, ничего не скачивает и окон не открывает. О новой версии сообщает строка аккаунта в левом нижнем углу.

Установка ручная: щелчок, загрузка с процентами, проверка файла, окно с кнопками установки и перезапуска. При работающих задачах появится предупреждение: остановиться и обновиться или отложить. На Windows программа закроется и откроется сама, вручную запускать не нужно.

Чего стоит опасаться

Плагин работает с правами пользователя. Каталог awesome-dsh-plugin предупреждает: плагин читает файлы, пользуется ключами, ходит в сеть. Подтверждения инструментов на код плагина не распространяются, а попадание в каталог не значит проверку безопасности.

Незнакомый плагин ставьте там, где нет ключей. Сборочные скрипты зависимостей подчиняются правилам pnpm, окна «разрешить ли» для них нет, и это записано в списке известных ограничений.

Кому ставить уже сейчас

Тем, кто останавливался на слове «терминал»: установщик снимает этот порог. Офисные навыки и предпросмотр документов полезны вне программирования: разобрать таблицу, собрать отчёт, свести папку документов в один файл. Вторая аудитория — те, кто уже работает с dsh из терминала: сессии общие, команда ставится из меню, а фоновые задачи без открытой вкладки браузера удобнее.

В полном материале есть разбор работы с командной строкой и общего дома, часть про сеть и прокси, а также про плагины и с чего начать.

Текст подготовлен с использованием искусственного интеллекта.

Top comments (0)