DeepSeek Harness на Windows: без десктопного приложения — не проблема — официальный способ запуска

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

Если вы искали «deepseek harness windows», вы, вероятно, смотрите на страницу с этими репозиториями-обёртками и гадаете, какой из них установить. Эта статья отвечает на настоящий вопрос, стоящий за этим поиском: что такое DeepSeek Harness на самом деле, официальный способ запуска в Windows на сегодняшний день, альтернативы для терминала и честные предостережения о работе с инструментом на стадии предварительной версии. Это практическое руководство, а не анонс — о запуске и утечке рассказано в отдельных материалах.

Что такое DeepSeek Harness (и чем он не является)

DeepSeek Harness — это не модель, и он не проводит бенчмаркинг моделей. Это агентный рантайм: слой, который соединяет модель с инструментами, файлами, оболочкой и интернетом — читает ваш код, планирует изменения, выполняет команды и итерирует, пока задача не будет выполнена. Архитектура изложена в его слогане: «Всё — это плагин.» Модели, инструменты, навыки, сессии, песочницы, сам агентный цикл и даже веб-интерфейс — это плагины, собираемые при запуске на основе мета-фреймворка Cordis — того же ядра, что лежит в основе экосистемы чат-ботов Koishi. Стандартная установка содержит более 150 плагинов.

Это также решительно предварительная версия. dsh находится на версии 0.1.0-rc.6, README называет её предварительной версией для разработчиков и предупреждает заглавными буквами: «БУДУТ НЕСОВМЕСТИМЫЕ ИЗМЕНЕНИЯ». Тем не менее это не замедлило распространение: проект набрал примерно 50 000 звёзд на GitHub за первые 12 часов после публикации 2026-08-13 и составил около 126 000 по состоянию на 2026-08-16 — самый быстрый релиз с открытым исходным кодом, выпущенный DeepSeek.

Короткий ответ: официальный путь Windows — это две команды.

В официальном README DeepSeek путь запуска в Windows описан одной строкой: установите Node.js, затем выполните npx @deepseek-ai/dsh web. Если конкретно, шаги следующие:

• Установите Node.js 22.19+ или Node 24. Текущий релиз dsh требует Node 22.19 или новее; Node 24 LTS — более безопасный выбор на Windows, и причина прозаична: более новые версии Node включают встроенную поддержку декомпрессии zstd, которую dsh использует для чтения своих сжатых журналов сеансов. Проверьте установку с помощью node --version в PowerShell или cmd.

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• Откройте этот адрес в браузере. Веб-интерфейс — это локальное веб-приложение, поэтому нет настольного приложения; браузер и есть настольное приложение.

• Добавьте ключ модели один раз. В веб-интерфейсе откройте Настройки → Модели, вставьте API-ключ DeepSeek и сохраните. Он вступает в силу немедленно, без перезапуска сервера. dsh использует папку, из которой вы его запустили, в качестве расположения по умолчанию в файловой системе, а в интерфейсе «Выберите рабочую область» — шаг, который позволяет направить его на любой каталог проекта.

Это весь официальный путь. Если на машине уже установлен Node 22+, время от «ничего» до «работающего агента» — менее минуты.

Почему каждый репозиторий "DeepSeek Harness Desktop" — это обёртка?

Результаты на первой странице по этому запросу — все это созданные сообществом десктопные обёртки: оболочки Electron, Tauri и WebView2, которые включают среду выполнения Node и запускают официальный веб-интерфейс в окне с рамкой. Они не являются продуктами DeepSeek и не добавляют дополнительной функциональности; они добавляют лишь лаунчер. Что у них общего:

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

• Они не подписаны, поэтому Windows SmartScreen предупредит при установке — «Подробнее → Выполнить в любом случае» является частью процесса.

Они отслеживают официальный проект с разной скоростью: кто-то фиксирует 0.1.0-rc.5, кто-то 0.1.0-rc.6, кто-то следит за master, поэтому версии обёртки и харнесса со временем расходятся.

• Они хранят те же локальные данные, которые dsh всегда использует, в ~/.dsh, поэтому переключение между обёрткой и официальным CLI не сбрасывает ваши сеансы.

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

Терминальный путь: headless CLI и TUI-плагины

Если браузер — не то место, где вы работаете, то у dsh есть и терминальная история, разделённая на два режима.

Headless — это неинтерактивный профиль: dsh --profile headless "summarize this repository" выполняет одну задачу без пользовательского интерфейса, выводит результат и завершается — режим, удобный для CI. В Windows это также режим, который следует использовать сценариям и запланированным задачам, поскольку он не требует дисплея или активного сеанса пользователя.

TUI — это интерактивный терминальный фронтенд в стиле Claude Code, поставляемый в виде пакетов плагинов сообщества, а не в составе основного пакета. Пакеты вроде dsh-tui устанавливаются в профиль с помощью dsh plugin --profile tui add <package> и запускаются с помощью dsh --profile tui; по крайней мере один из них поставляется с лаунчером Windows .cmd. Подвох, о котором стоит знать заранее: для TUI требуется настоящий терминал как для ввода, так и для вывода — если ваша настройка использует конвейеры или перенаправление, dsh откажется и предложит вместо этого использовать headless.

Четыре пресета: какой для какой задачи?

dsh поставляется с четырьмя встроенными пресетами агентов, и они не являются уровнями сложности — это четыре разные инструментальные поверхности. Значение по умолчанию задаётся в ~/.dsh/settings.yaml в параметре agent-presets.default.

• Standard — это значение по умолчанию: полноценный повседневный агент — редактирование файлов, оболочка, поиск по файлам и в интернете, навыки, субагенты, планирование. Именно с него следует начинать большинству пользователей Windows.

• PTC (также называемый Code mode) сохраняет всё, что есть в Standard, но меняет способ представления инструментов: вместо длинной последовательности изолированных вызовов инструментов модель пишет программу на TypeScript, которая объединяет многошаговые операции — циклы, фильтры, условные ветвления. Для сложных, повторяющихся или многошаговых рабочих процессов.

• Minimal намеренно сводит агента к двум инструментам — постоянной оболочке и файловому редактору — и предназначен для оценки и бенчмаркинга, а не для повседневной работы. Именно на этом пресете работают собственные агентные оценки DeepSeek.

• Creation (Cordis) предназначен для создания пользовательских пресетов: он включает проверку во время выполнения, эксперименты с плагинами в памяти и рекомендации по созданию пресетов. Для возни с самой обвязкой.

MCP и воспроизведение траекторий: зачем это вообще стоит запускать

Две функции оправдывают использование dsh вместо обычного чат-клиента. Во-первых, встроен клиент Model Context Protocol (MCP) — команда /mcp и вкладка Settings MCP подключают внешние MCP-серверы к среде, так что те же инструменты, которыми пользуются ваши другие агенты, работают в dsh. Во-вторых, каждый запуск записывается в журнал сеанса в режиме append-only, а представление Trajectory позволяет просмотреть запуск по источнику, возобновить его, разветвить, найти и воспроизвести. В этом разница между отладкой агента, глядя на его итоговый ответ, и пошаговым разбором того, почему он выполнил каждый вызов.

Когда официальный путь — это неправильный ответ

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

• Ваш компьютер с Windows устарел или заблокирован. dsh требует Node 22.19+ (или Node 24). На управляемой машине это означает установку среды выполнения и, возможно, разрешение, которого у вас нет.

• Это превью, и оно ломается. 0.1.0-rc.6 поставляется с предупреждением, что грядут ломающие изменения; между rc-сборками плагины и профили могут перестать работать. Закрепите версию для всего, что автоматизировано.

• Счёт за модель — на вас. dsh бесплатен; каждая задача сжигает токены на том ключе, который вы настроили. Агентный цикл перечитывает файлы и повторяет попытки, а многословная модель при решении сложной задачи может потратить удивительно большой бюджет за один день. Именно здесь выбор модели, а не выбор обвязки, определяет стоимость.

• Плоская подписка может оказаться выгоднее, чем маршрутизация по токенам. Если вы находитесь в рамках одного тарифного плана лаборатории и не превышаете его лимиты, плоская подписка часто дешевле любого варианта с оплатой за токены. Маршрутизация выигрывает, когда вы смешиваете модели или нуждаетесь в резервировании — но не по умолчанию.

Пропустите модель через обвязку.

Родной путь — это собственный API DeepSeek: вставьте ключ в Settings → Models и готово. Но dsh также принимает OpenAI-совместимый базовый URL — укажите DEEPSEEK_BASE_URL в переменных окружения или настройте LLM-провайдера в settings.yaml — это означает, что модель, стоящая за обвязкой, может быть заменена без изменения самой обвязки. Вы можете запускать DeepSeek V4 Pro для сложного рефакторинга и DeepSeek V4 Flash для дешёвых механических правок на одной и той же локальной установке dsh.

Это слой, который занимает OrcaRouter. Один совместимый с OpenAI базовый URL, 200+ моделей, нулевая наценка — цена провайдера передаётся как есть — и автоматический failover, когда провайдер ограничивает скорость или деградирует. Направьте dsh на него — и харнесс останется на вашей машине, а каталог моделей станет решением о маршрутизации, а не покупкой. Две честные оговорки: мы не хостим dsh — он работает локально на вашей Windows-машине, и мы являемся лишь слоем доступа к моделям, если вам нужны модели за пределами собственного API DeepSeek. А для одной тяжёлой модели в пределах лимитов плана фиксированная подписка часто оказывается более выгодным решением, независимо от роутера.

Краткая версия

DeepSeek Harness на Windows устанавливается двумя командами, а не через магазин приложений: Node 22.19+ (или Node 24), затем npx @deepseek-ai/dsh web, и после этого ваш браузер на http://127.0.0.1:3080. Репозитории «desktop» на GitHub — это неофициальные обёртки вокруг того же локального сервера. Для терминалов: в headless-режиме запускаются разовые задачи для CI, а TUI-плагины дают интерфейс в стиле Claude Code. Четыре пресета — Standard, PTC, Minimal, Creation — определяют набор инструментов, а MCP и воспроизведение траекторий делают его по-настоящему полезным. Он бесплатный, с открытым исходным кодом и находится на стадии превью: фиксируйте версию, следите за расходами на модель и маршрутизируйте модель отдельно от Harness.