DeepSeek Harness: какво е това и как да инсталирате AI агент

DeepSeek Harness е отворена среда за стартиране на AI агенти на компютър. За разлика от обикновения чат с невронна мрежа, Harness може да работи с файловете на проекта, да изпълнява команди в терминала, да променя кода, да проверява резултата, да използва инструменти и да възлага отделни задачи на подагенти. Същевременно самият DeepSeek Harness не е езиков модел: към него трябва да свържете DeepSeek, OpenAI или друг поддържан доставчик.

Инсталацията е сравнително проста: инсталирайте Node.js, изпълнете една команда в терминала, отворете локалния уеб интерфейс, свържете API ключ и изберете работна папка. Но има важна уговорка: към 2 септември 2026 г. DeepSeek Harness официално има статут предварителна версия за разработчици. Разработчиците изрично предупреждават за възможни несъвместими промени и не наричат продукта готов за production.

Какво е DeepSeek Harness с прости думи

Терминът agent harness може да се преведе като „среда за изпълнение на AI агент“. Езиковият модел отговаря за разсъжденията и вземането на решения, а Harness му дава инструменти за изпълнението им.

Опростено процесът изглежда така:

  1. Избирате работна папка — Workspace.
  2. Задавате задача с обикновен текст.
  3. DeepSeek Harness я предава на избрания езиков модел.
  4. Моделът изучава файловете и решава кои инструменти да използва.
  5. Harness чете или променя файлове, изпълнява команди и получава резултатите.
  6. Моделът анализира резултата и при нужда продължава работа.
  7. Получавате не само текстов съвет, а фактически изпълнена задача.

Затова Harness е по-близо до Codex, Claude Code и други агентни среди, отколкото до обикновен уеб чат. Ако ви интересува самата концепция на такива системи, в блога на CenterAI има отделен раздел за AI агенти и асистенти.

Какво може DeepSeek Harness

В стандартната конфигурация агентът може да работи не само с диалог, но и директно с локален проект. Например, може да му се възложи:

  • да изучи структурата на хранилището;
  • да открие грешки в кода;
  • да промени няколко файла;
  • да стартира тестове или компилация;
  • да сравни конфигурационни файлове;
  • да анализира Markdown, JSON, CSV и други текстови данни;
  • да изготви план за работа;
  • да делегира части от голяма задача на подагенти;
  • да създава собствени разширения и конфигурации на Harness.

Архитектурата на DeepSeek Harness е изградена на принципа „everything is a plugin“: адаптерите за модели, инструментите, работата със сесии и много други компоненти се свързват като плъгини. Това прави Harness интересен не само като готов AI агент, но и като платформа за създаване на собствени агентни системи.

Какво е нужно за инсталиране на DeepSeek Harness

За обикновено стартиране от npm не е нужно сами да изтегляте изходния код от GitHub. Нужни са три неща:

  • компютър с Windows, macOS или Linux;
  • съвместима версия на Node.js;
  • API ключ от поне един доставчик на езиков модел.

Изходното хранилище на DeepSeek Harness посочва изискването Node.js 22.19 или по-нова версия от клона 22, или Node.js 24+. Към момента на проверката актуалната LTS версия на Node.js е 24.20.0, затова за нова инсталация е по-лесно да използвате именно Node.js 24 LTS.

Node.js може да се изтегли от официалния сайт: Изтегляне на Node.js.

Не е нужна отделна видеокарта, за да работи Harness с облачни API: самият модел се изпълнява на сървърите на DeepSeek, OpenAI или друг доставчик. Но би било неправилно да се твърди, че продуктът ще стартира „на абсолютно всеки компютър“. Локално все пак работят Node.js, терминалът, инструментите на агента, вашите тестове и приложения.

Как се инсталира DeepSeek Harness

Стъпка 1. Инсталирайте Node.js

Изтеглете актуалната LTS версия на Node.js от официалния сайт на Node.js и извършете обичайната инсталация за вашата операционна система.

След инсталацията отворете PowerShell, Windows Terminal, Terminal в macOS или терминал в Linux и проверете версията:

node -v

Препоръчително е да използвате Node.js 24 LTS.

Стъпка 2. Стартирайте DeepSeek Harness

Официалният начин за стартиране чрез npm се състои само от една команда:

npx @deepseek-ai/dsh web

При първото стартиране npx ще изтегли необходимите пакети. След стартирането DeepSeek Harness ще вдигне локален Web UI. По подразбиране той работи на адрес:

http://127.0.0.1:3080

При локално стартиране браузърът обикновено се отваря автоматично.

Официално хранилище на проекта: DeepSeek Harness в GitHub.

Официално ръководство за Web UI: DeepSeek Harness — Използване на Web UI.

Стъпка 3. Изберете работна папка

След първото стартиране трябва да създадете или изберете Workspace — директорията, с която ще работи агентът.

Например, това може да бъде:

  • папка на проект за сайт;
  • хранилище на Python приложение;
  • папка на Telegram бот;
  • отделна директория с документи и конфигурации;
  • тестово копие на проекта.

В новия Web UI въвеждането на съобщение не е достъпно, докато не бъде избран Workspace.

Как да свържете DeepSeek

Ако искате да използвате моделите на самия DeepSeek, отворете Settings → Models. В интерфейса вече има вграден доставчик DeepSeek — достатъчно е да поставите API ключа и да запазите настройките.

API ключът се създава в официалния портал: DeepSeek Platform — API Keys.

API документация: DeepSeek API Docs.

В стандартния каталог на Harness присъстват по-специално:

  • DeepSeek V4 Flash — по-евтин вариант за голям брой ежедневни задачи;
  • DeepSeek V4 Pro — по-скъп модел за задачи, при които се изискват по-сложни разсъждения.

И двата модела поддържат извикване на инструменти и са предназначени включително за агентни сценарии. Актуалните характеристики и цени е най-добре да се проверяват директно на страницата Models & Pricing, тъй като цените могат да се променят.

Как да свържете OpenAI към DeepSeek Harness

Не е задължително да използвате точно моделите на DeepSeek. Harness има каталог с други доставчици, включително OpenAI.

За да свържете OpenAI:

  1. Отворете Settings → Models.
  2. Натиснете Add provider.
  3. Изберете OpenAI.
  4. Въведете API ключа на OpenAI.
  5. Запазете настройките.
  6. Изберете нужния модел от превключвателя за модели на новата сесия.

За обикновен OpenAI не е нужно ръчно да задавате Base URL: Harness използва вградения каталог на доставчика, в който вече са определени endpoint, протоколът и моделите.

Можете да създадете API ключ в OpenAI Platform.

Важно: абонаментът за ChatGPT и OpenAI API се заплащат отделно. Наличието на ChatGPT Plus или Pro само по себе си не предоставя платен API баланс.

В актуалната гама на OpenAI за агентни и програмни задачи можете да се ориентирате към GPT-5.6 Luna като икономичен вариант, GPT-5.6 Terra като междинен и GPT-5.6 Sol за по-сложно програмиране и разсъждения. Конкретният списък в Harness зависи от инсталирания каталог и наличността на модели за вашия API акаунт.

Може ли да се свърже друг API

Да. В раздела с модели има отделен елемент Add a custom provider. Той е предназначен за корпоративни шлюзове, self-hosted модели и други OpenAI-съвместими услуги.

За такова свързване се задават:

  • Provider ID;
  • показвано име;
  • Base URL;
  • API протокол;
  • API ключ;
  • един или няколко модела.

Това е по-усъвършенстван сценарий. OpenAI и други доставчици, които вече присъстват в каталога на Harness, е по-добре да се добавят чрез обичайния Add provider, а не чрез Custom Provider.

Кой режим на достъп да изберете

Това е една от най-важните настройки на DeepSeek Harness. AI агентът може да изпълнява реални команди и да променя реални файлове.

На ниво sandbox Harness поддържа три режима на работа с файловата система:

  • read-only — забрана за промяна на файлове;
  • workspace-write — разрешение за запис в Workspace;
  • danger-full-access — премахване на файловото ограничение.

Същевременно стандартната конфигурация на Web UI по подразбиране използва preset Workspace Write. Именно него е добре да оставите за повечето обичайни задачи.

Workspace Write

Агентът може да променя файлове в избрания Workspace. За действия, изискващи по-широки разрешения, се използва механизъм за потвърждение.

Това е разумен вариант за разработка и ежедневна работа.

Danger Full Access

В този режим файловата изолация се изключва. В стандартния preset Harness той е свързан и с политика за изпълнение без постоянно искане за потвърждение.

Не включвайте Full Access само за удобство. За експерименти с такъв режим е по-добре да използвате отделна виртуална машина, контейнер или друг изолиран компютър.

Има още един важен нюанс: sandbox-mode на Harness на първо място регулира промените във файловата система. Видимостта на мрежата и процесите не са част от този конкретен модел на ограничения. Повече за принципите на минималните права за AI агенти писахме в материала „Сигурност на AI агентите: как да ограничите достъпа до поща, CRM и данни“.

Standard и Creator: как се различават режимите на агента

Освен разрешенията за файлове, DeepSeek Harness използва agent presets — набори от инструменти и настройки на конкретен агент.

Standard

Това е основният режим за обичайна работа по проекта. Агентът получава инструменти за работа с файлове, терминал, планиране и делегиране на задачи.

Има смисъл да започнете запознаването с Harness именно със Standard.

Creator

Creator е предназначен за промяна и разширяване на самата агентна среда. Архитектурата на Harness позволява да се създават собствени agent presets и плъгини, а Creator предоставя на агента инструменти за работа с тази система.

Именно тук се проявява основната архитектурна разлика на Harness: вместо твърдо зададен набор от възможности, практически цялата система се изгражда от плъгини.

Ако ви интересува подобна концепция за разширяване на AI инструменти, можете да я сравните с подхода на OpenAI Codex в ръководството „Skills и Plugins в Codex: как да изберете, инсталирате и използвате в работата“.

Как да работите с DeepSeek Harness на практика

След свързване на модела и избиране на Workspace можете да давате на агента обичайни задачи на български език.

Например:

Проучи целия проект. Засега не променяй нищо. Открий архитектурни проблеми, потенциални грешки и дублиране на код. Създай списък със задачи по приоритет.

След анализа може да продължите:

Поправи първата задача. Не пипай останалите части на проекта. След промените стартирай съществуващите тестове и провери резултата.

Този подход обикновено е по-безопасен от командата „поправи всичко“, защото резултатът се контролира и връща по-лесно.

Какво представляват подагентите в DeepSeek Harness

Harness поддържа делегиране на работа към дъщерни агенти. Главният агент може да предаде отделна задача на подагент и след това да използва получения резултат.

Например, голяма проверка на приложение може да се раздели на:

  • одит на backend;
  • одит на frontend;
  • търсене на проблеми със сигурността;
  • проверка на тестовете;
  • анализ на документацията.

Но тук е важно да не приписвате на Harness нещо, което официалната архитектура не гарантира: подагентът не получава непременно автоматично отделно физическо копие на целия проект. Harness поддържа различни механизми за подагенти, а степента на файловата им изолация зависи от конкретния provider и конфигурацията.

Ако няколко агента трябва едновременно да редактират едно хранилище, по-безопасно е съзнателно да разделите работните им директории, Git worktree, контейнери или друг механизъм за изолация.

Какво представлява Trajectory

Trajectory — подробно представяне на събитията в сесията. То показва не само крайния отговор на модела, но и действията на агента: извиквания на инструменти, резултати от извикванията, стъпки и граници на отделните turn.

В интерфейса можете да разглеждате например:

  • кой инструмент е бил извикан;
  • неговите входни и изходни данни;
  • колко време е отнело действието;
  • информация за използването на токени;
  • последователността от действия на агента.

За отстраняване на грешки в агентни системи това е значително по-полезно от обикновената история на чата: можете да видите не само грешния резултат, но и мястото, където агентът е започнал да се движи по грешна траектория.

Как работи разклоняването на сесия

DeepSeek Harness поддържа fork на сесия. Новият клон получава историята на изходната сесия до избрана завършена точка, след което може да бъде продължен независимо.

Това е удобно, ако първата половина на сложна задача е изпълнена правилно, а след това агентът е избрал неудачно решение. Вместо да стартирате отново целия процес, можете да създадете клон от успешната точка и да дадете друго указание.

Но fork на сесия е преди всичко разклоняване на историята на агента. Не бива автоматично да се приема за създаване на отделно копие на файловете на проекта.

Могат ли да се инсталират плъгини

Да. DeepSeek Harness позволява свързване на допълнителни plugin bundles. В официалната документация за това се използва команда от вида:

dsh plugin –profile web add ИМЕ_НА_ПАКЕТА

Плъгините могат да добавят нови инструменти, интерфейсни компоненти и поведение на агента.

Но трябва да се отнасяте към тях приблизително както към инсталиране на обикновена програма от неизвестен източник. Официалната документация отделно предупреждава: инсталирането на някои пакети може да разреши изпълнението на техния код на самия компютър и извън sandbox на агента.

Затова преди инсталиране на външен плъгин е желателно:

  • да проверите изходния код;
  • да проверите автора и хранилището;
  • да разгледате актуалните issues;
  • да не стартирате непроверен код на машина с работни тайни;
  • за експерименти да използвате отделна среда.

Колко безопасен е DeepSeek Harness

Самият DeepSeek формулира това достатъчно еднозначно: Harness е експериментален developer-preview продукт, не е преминал security audit и не бива да се счита за production-ready.

Той може да изпълнява генерирани от модела команди, да осъществява достъп до мрежата, да работи с процеси, файлове и предоставени му credentials. Грешка на модела, неправилна конфигурация или злонамерен плъгин потенциално могат да доведат до промяна на файлове или изтичане на данни.

Минимални правила:

  • да оставяте Workspace Write вместо Full Access;
  • да правите резервни копия;
  • да не давате на агента излишни тайни;
  • да не му отваряте цялата домашна директория без необходимост;
  • да не инсталирате неизвестни плъгини;
  • за рискови експерименти използвайте VM или контейнер.

Кой трябва да изпробва DeepSeek Harness

В сегашния си вид Harness е особено интересен за разработчици и технически специалисти, които искат не просто да разговарят с модела, а да му предоставят контролиран набор от реални инструменти.

Типични сценарии:

  • разработка и рефакториране на код;
  • диагностика на съществуващи проекти;
  • автоматизация на повтарящи се технически операции;
  • експерименти с мултиагентни системи;
  • създаване на собствени инструменти за AI агент;
  • изследване на архитектурата на agent harness.

За критични production процеси засега е по-разумно продуктът да се разглежда като експериментална платформа, а не като готов автономен изпълнител.

Накратко: инсталиране на DeepSeek Harness от нулата

  1. Инсталирайте Node.js 24 LTS.
  2. Отворете терминала.
  3. Изпълнете npx @deepseek-ai/dsh web.
  4. Отворете Web UI, ако браузърът не се е отворил автоматично.
  5. В Settings → Models добавете DeepSeek или например OpenAI.
  6. Изберете Workspace.
  7. Оставете Workspace Write за обичайна работа.
  8. Изберете модел.
  9. Започнете нова сесия и задайте първата задача.

За първия тест е по-добре да използвате копие на малък реален проект: помолете Harness първо само да го анализира, след това да поправи един конкретен проблем и да провери резултата. Така по-бързо става ясно къде агентът действително спестява време и какви права са му нужни.

Ако задачата не е експеримент с Harness, а създаване на работещ AI агент за конкретен бизнес процес, можете да обсъдите архитектурата и MVP с CenterAI.

FAQ

DeepSeek Harness безплатен ли е?

Самият проект е публикуван като open-source под лиценз MIT. Но заявките към DeepSeek, OpenAI и повечето облачни модели се заплащат според тарифите на съответния API.

Задължително ли е да използвате DeepSeek?

Не. Harness поддържа други доставчици. В официалната документация изрично са посочени OpenAI и Anthropic, а също е предвидено свързване на custom provider.

Нужна ли е мощна видеокарта?

За работа с облачен API — не. Моделът се изпълнява на сървъра на доставчика. Но командите, тестовете, компилирането на проекта и други локални процеси се изпълняват на вашия компютър.

Може ли DeepSeek Harness да се инсталира на Windows?

Да. Архитектурата на Harness предвижда локални sandbox механизми за Linux, macOS и Windows. Разработчиците обаче отбелязват разлики в нивото на изолация между платформите, затова sandbox не бива да се счита за абсолютна защита.

Може ли да се свърже OpenAI?

Да. Отворете Settings → Models → Add provider → OpenAI и добавете API ключ. Не е необходимо да създавате Custom Provider за стандартния OpenAI.

Заменя ли Harness разработчика?

Не. Той може самостоятелно да изпълнява многостъпкови технически действия, но резултатът все пак изисква задаване на задача, контрол на разрешенията и проверка на критичните промени от човек.

Източници и проверка

Дата на последната проверка: 02.09.2026

Leave a Reply

Вашият имейл адрес няма да бъде публикуван. Задължителните полета са отбелязани с *